feat(local): 工作目录拆成 data/skills/tasks,技能复制到用户目录

启动器不再把技能软链回仓库,改为首次启动把内置技能复制到 <工作目录>/skills,
之后每次启动只补缺不覆盖(用户/AI 改过的不会被冲掉)。deps 不复制,只建空目录,
pip 装进 <工作目录>/skills/deps,PYTHONPATH 与 AGENT_SKILLS_DEPS 都指过去。

工作目录据此变成三件套:tasks=会话工作区(AI 的文件根,与服务器 /workspace/tasks
同语义)、data=SQLite 与 prompt dump、skills=技能。仓库里不再有用户数据。

配置仍只由首次启动生成:workspace_root=<ws>/tasks、data_root=<ws>/data、
skills_root=<ws>/skills。新增 cfg_get/skills_dir 从配置读技能根,不自己发明路径。
This commit is contained in:
2026-11-11 21:31:14 +08:00
parent 77ef1ec11c
commit 8effba36dd
4 changed files with 133 additions and 80 deletions
+37 -27
View File
@@ -8,7 +8,8 @@
## 1. 目标
把同一个 `agent-core` 直接跑在本机(macOS / Linux),**不装 Docker、不起 executor**,形态类似
桌面 agent:给它一个工作目录,它在这个目录里放开手脚干活。
桌面 agent:给它一个工作目录,它在这个目录下的 `tasks/` 里放开手脚干活(`data/`、`skills/` 是兄弟目录,
归启动器和技能自己管)。
明确的设计约束(都来自讨论):
@@ -25,7 +26,7 @@
| 差异 | 服务器 | 本地 | 由谁注入 |
|---|---|---|---|
| 命令在哪跑 | `agent-executor` 容器(mount/pid namespace 隔离) | 本机 `spawn`(**无沙箱**) | `EXECUTOR_URL` 留空 → 现成分支,未改代码 |
| 文件工具的根 | 会话目录 `tasks/<会话id>/` | 指定的工作目录 | `AGENT_FILE_SCOPE=workspace` |
| 文件工具的根 | 会话目录 `tasks/<会话id>/` | 工作目录下的 `tasks/`(`data/`、`skills/` 是兄弟目录,越界) | `AGENT_FILE_SCOPE=workspace` |
| 监听地址 | `0.0.0.0` | `127.0.0.1` | `HOST=127.0.0.1` |
| 对外链接(`mint_public_link` / `visit_url`) | `public_link.base_url` 拼公网短链 | 没有公网前缀时改拼 `http://127.0.0.1:<PORT>/p/<id>` | 复用 `localOrigin()`,靠 `HOST` 判断形态,不写配置 |
| 读图回传给模型 | 签公网短链,上游服务器来拉 | 上游拉不到回环地址,改为内联 base64 `data:` URL | `AGENT_IMAGE_INLINE=1` |
@@ -108,7 +109,7 @@
`config.local.yml` 里既有启动器生成的字段(`workspace_root` / `skills_root`),也有用户在网页里
配的东西(`platforms`、API Key、MCP headers)。每次启动重写会直接冲掉后者。
推论:**能力变化不能靠改配置实现**,只能靠 env / 起不起子进程 / 软链(见 4.3、4.4)。
推论:**能力变化不能靠改配置实现**,只能靠 env / 起不起子进程 / 首次复制(见 4.3、4.4)。
### 4.3 ffmpeg 是运行时能力,与配置解耦
@@ -120,21 +121,31 @@
装完 ffmpeg 后**重跑脚本**即生效,配置文件一个字不用改。
### 4.4 技能目录用软链固定指向仓库,不再按 python3 有无切换
### 4.4 技能是工作目录里的副本,不再软链仓库并随 python3 有无切换
配置里永远写 `skills_root: <仓库>/local/.runtime/skills`(首次生成后不覆盖),启动器每次都重建这个
软链,恒指向 `<仓库>/skills`。
用户选的工作目录被拆成三个兄弟目录:
早期版本在「没有 python3」时把它指向一个空目录,想的是“别让模型看到跑不了的工具”。两个问题:
```
<工作目录>/tasks/ 会话工作区(AI 的文件根)
<工作目录>/data/ SQLite、prompt dump
<工作目录>/skills/ 技能 + deps/
```
1. **技能不一定是 Python 的**。`office` 只有 `SKILL.md` + `scripts/office`,模型在 `terminal` 里调
`office <cmd>`,完全不需要 python3——一刀切会把这类技能一并藏掉。
2. **没必要防**。`skills.js` 的 `runEntry` 对 `spawn` 的 `error` 有处理,缺解释器时模型拿到的是
「技能入口启动失败:spawn python3 ENOENT」,干净可读、不崩不挂。模型据此自己装解释器或模块,
装完继续跑即可。
`skills_root` 写死 `<工作目录>/skills`(首次生成后不覆盖)。首次启动时把仓库 `skills/` 里的
**内置技能逐个复制**过去,之后每次启动**只补缺、不覆盖**:
所以现在只有一种行为:技能总是可见;python3 缺失只影响 `run.py` 类技能能否执行。装好 python3 后
(若在 core 启动时 `PATH` 已有的目录里,如 brew 的 `/opt/homebrew/bin`)无需重启即生效,否则重跑脚本。
- 只复制目录,`deps` 不复制(仓库那份是服务器构建期产物,平台/版本都不该跟着走)
- 目标已存在就跳过——用户改过的、AI 自己新建的技能都靠这条保住
- 要拿仓库里的新版:删掉对应子目录再跑一次脚本
这样三个东西同时在位:仓库永远干净(`git status` 无未跟踪用户数据);用户数据一目录备份、
一目录卸载;AI 真能“自己长技能”(新增目录即被发现,`skill list` 实时可见)。
早期版本把 `.runtime/skills` 软链到仓库,导致技能只能写回版本库(与仓库更新抢地盘)。
更早还按 python3 有无切到空目录,想“别让模型看到跑不了的工具”——但技能不一定是 Python 的
(`office` 只要 Node + 二进制),一刀切会把它们一并藏掉;而且 `skills.js` 的 `runEntry` 对
`spawn` 的 `error` 有处理,缺解释器时模型拿到的是「技能入口启动失败:spawn python3 ENOENT」,
干净可读,自己装完继续跑即可。
**没有改 `skills.js` 一行代码。**
@@ -171,11 +182,11 @@
「terminal 写真实 /tmp、file 工具读会话 .tmp」的错位——这正是 `AGENT_FILE_SCOPE=workspace`
要关掉重定向的原因。
### 4.8 `skills_root` 的默认值陷阱
### 4.8 `skills_root` 的默认值
`skills.skills_root` 留空时默认取 `workspace_root` 的**同级** `skills` 目录。本地把
`workspace_root` 指到用户选的目录后,默认值会变成不存在的 `<用户目录>/../skills`。
因此生成的配置必须显式写死 `skills_root`。
`skills.skills_root` 留空时默认取 `workspace_root` 的**同级** `skills` 目录。新的目录布局正好也是
`tasks/` 与 `skills/` 同级,所以留空也能算对;但生成的配置仍然显式写死它——一个字段就能看出
技能到底在哪,不依赖目录推导。
### 4.9 状态页:静态文件 + `meta refresh`,不起 HTTP 服务
@@ -260,8 +271,8 @@ health 只作为「端口上有服务但不是本启动器拉起的」兜底提
`PYTHONPATH`)。本地没有这套东西,`start.sh` 也不去跑 pip——安装时机、镜像源、半成品清理
是另一整套逻辑,收益不抵成本。做法改成「缺了再装」:
- `start.sh` 起 core 时注入 `PYTHONPATH=<仓库>/skills/deps`(**原本就有**)与
`AGENT_SKILLS_DEPS=<仓库>/skills/deps`(新增,只为把路径交给模型)。
- `start.sh` 起 core 时注入 `PYTHONPATH=<工作目录>/skills/deps` 与
`AGENT_SKILLS_DEPS=<工作目录>/skills/deps`(后者只为把路径交给模型)。
`terminal` 与技能子进程都继承 core 的 env,所以装进去的东西**下次运行就能 import**,不用重启。
- `templates/env-local.txt` 把原来的「永远不要自己装任何东西」改成「缺模块就装进
`$AGENT_SKILLS_DEPS` 再重试」——**只给路径,不给命令**,怎么装由模型自己决定。
@@ -320,10 +331,10 @@ health 只作为「端口上有服务但不是本启动器拉起的」兜底提
| 项 | 结果 |
|---|---|
| 首次启动:生成配置 → 装依赖(app 134 包,image_task / video_task 各 127 包)→ 起 MCP + core → 打开状态页(停在「已启动」,等点击) | 通过 |
| 配置内容:`workspace_root` 是选的目录、`data_root` 指仓库 `data/`、`skills_root` 指 `local/.runtime/skills`、`platforms: []`、MCP 端口 8091~8094 | 通过 |
| 配置内容:`workspace_root` = `<选定目录>/tasks`、`data_root` = `<选定目录>/data`、`skills_root` = `<选定目录>/skills`(内置技能已复制)、`platforms: []`、MCP 端口 8091~8094 | 通过 |
| 绑定地址:`lsof` 只有 `127.0.0.1:8090` | 通过 |
| 设置页「重启」→ 守护拉起:PID 变化,2 秒内 `/api/health` 恢复 | 通过 |
| 文件工具越出会话目录:工作目录根的 `probe.txt` 可读 | 通过 |
| 文件工具限定在 `<工作目录>/tasks/` 下:放进 `tasks/` 的 `probe.txt` 可读,`<工作目录>/data/` 报路径越界 | 待复测 |
| 越界保护:`read_file ~/.ssh/config`、`terminal cd /etc` 均报「路径越界」 | 通过 |
| `/tmp` 一致性:`write_file /tmp/x` → `terminal cat /tmp/x` 与 `read_file /tmp/x` 内容一致 | 通过 |
| 无 ffmpeg:`/api/asr/status` = `enabled:false`(麦克风隐藏),asr 子进程不启动,8094 不监听 | 通过 |
@@ -383,7 +394,7 @@ tail -f local/.runtime/core.log # 以及 npm-install.log / mcp-*.log
| `mcp_asr` 监听 `0.0.0.0` | 它只认 `PORT` 环境变量、`listen` 不带 host(已启动时才是问题)。不存密钥(上游参数随请求带入),暴露面有限;要收紧需给 `mcp/asr` 加 `--host` 支持 |
| Windows 不支持 | `spawn('/bin/sh')`、`process.kill(-pid)`、模型写的 bash 语法都是 POSIX 语义 |
| 链接只在本机可达 | 本地没有公网前缀:`mint_public_link` / 页面访问地址都签成 `http://127.0.0.1:<PORT>/...`,只能在这台机器上打开(这正是本地形态的预期)。要真正对外暴露才需在设置页填 `public_link.base_url` |
| 技能依赖 | 本地不预装:缺包时模型会把包装进 `skills/deps`(`$AGENT_SKILLS_DEPS`,已在该进程 `PYTHONPATH` 里,装完下次运行即生效);连 `python3` 都没有时也由它自己装。怎么装由模型自己决定。需要系统库的包(`weasyprint`→pango/cairo)pip 装不了,仍需手工 `brew install`。服务器上由 `agent-executor-init` 处理 |
| 技能依赖 | 本地不预装:缺包时模型会把包装进 `<工作目录>/skills/deps`(`$AGENT_SKILLS_DEPS`,已在该进程 `PYTHONPATH` 里,装完下次运行即生效);连 `python3` 都没有时也由它自己装。怎么装由模型自己决定。需要系统库的包(`weasyprint`→pango/cairo)pip 装不了,仍需手工 `brew install`。服务器上由 `agent-executor-init` 处理 |
| `office` 二进制 | 不入库、也不预装:首次用到时报 `binary missing` 并给出该技能 `AGENTS.md` 的绝对路径,模型按它自己下载(`releases/latest`,~34MB,GitHub 慢就用 gh-proxy)。不需要 root、不需重启。officecli 会自更新到 latest,版本比服务器 pin 的新属正常 |
| `office` 预览 | 预览卡片走 core → executor 的 `:3100` 网关,本地没有这个网关 → 点开打不开。文档创建/编辑/读取不受影响 |
| 首个 `npm install` 要联网 | 支持 `NPM_REGISTRY` 覆盖源;`app/package-lock.json` 的 `resolved` 已改指向公共 registry(原来钉在内网镜像,外部机器必失败) |
@@ -401,10 +412,9 @@ rm -rf local/ # 或保留脚本、只是不用
## 9. 记录:测试残留(都不入库)
跑过启动器之后本机会多出:`local/.runtime/`(日志、状态页、技能软链)、
`local/config.local.yml`、`~/AgentWork/`、`app/node_modules/`、`mcp/image_task|video_task/node_modules/`。
全部在 gitignore 内,不影响仓库;想彻底重来就把它们删掉再跑脚本(会话产出在 `data/` 与
工作目录下的 `task-*` 里,不会被清)。
跑过启动器之后本机会多出:`local/.runtime/`(日志、状态页)、`local/config.local.yml`、
你选的工作目录(`data/` `skills/` `tasks/`)、`app/node_modules/`、`mcp/image_task|video_task/node_modules/`。
仓库里只有前两项,且都在 gitignore 内;用户数据全在工作目录里,删掉它等于彻底重置。
## 10. 新建会话手选工作目录(本地端)
+26 -13
View File
@@ -7,7 +7,7 @@
| 差异 | 服务器 | 本地 |
|---|---|---|
| 命令在哪跑 | `agent-executor` 容器(mount/pid namespace 隔离) | 直接在本机 `spawn`(无沙箱) |
| 文件工具的根 | 会话目录 `tasks/<会话id>/` | 你指定的工作目录 `workspace_root` |
| 文件工具的根 | 会话目录 `tasks/<会话id>/` | 你选的工作目录下的 `tasks/` |
| 监听地址 | `0.0.0.0`(靠宿主机端口映射对外) | `127.0.0.1`(只有本机能访问) |
后两项分别由环境变量 `AGENT_FILE_SCOPE=workspace` 和 `HOST=127.0.0.1` 控制,容器部署不设置,
@@ -24,16 +24,19 @@ cd agent
首次运行会:
1. 自检环境(Node 20+ 必需;ffmpeg / python3 可选),并打开一个**启动状态页**
2. 弹窗让你选一个**工作目录**(AI 会在这个目录里干活)
3. 生成 `local/config.local.yml`
4. 装一次 Node 依赖(`app/` 与带依赖的 MCP,需要联网)
5. 起 core + MCP 子进程(没 ffmpeg 时 asr 不启动)
6. 停在那儿守护:core 退出就自动拉起
2. 弹窗让你选一个**工作目录**,在里面建 `data/`、`skills/`、`tasks/` 三个子目录
3. 把仓库 `skills/` 里的内置技能复制到 `<工作目录>/skills/`
4. 生成 `local/config.local.yml`
5. 装一次 Node 依赖(`app/` 与带依赖的 MCP,需要联网)
6. 起 core + MCP 子进程(没 ffmpeg 时 asr 不启动)
7. 停在那儿守护:core 退出就自动拉起
工作目录是你的:数据库、会话、技能都在里面,仓库里不存任何运行数据。
浏览器里首次使用:**左下角「用户区」→ 设置 → 模型池**,添加平台和 API Key,然后点「重启」。
新建会话时,欢迎页「随时开始吧」下方可以**手选一个工作目录**:选了之后这个会话的 AI 一切操作
都在那个目录里(不再建 `task-*` 子目录);不选就沿用默认(系统工作目录下的独立会话目录)。
都在那个目录里(不再建 `task-*` 子目录);不选就沿用默认(`<工作目录>/tasks/<会话id>`)。
删会话不会删你选的目录。
没有 Node 20+ 时不会让你白选目录:脚本在入口就停下,终端打出安装方式,自检结果(哪项缺、怎么装)写到状态页。
@@ -76,11 +79,21 @@ cd agent
## 配置放哪
- 生成的配置:`local/config.local.yml`(**首次生成,之后永不覆盖**,避免冲掉你在网页里配的模型与密钥)
- 会话数据:`data/`(SQLite + prompt dump)与工作目录下的 `task-YYYYMMDD-NNN/`
- 运行期产物:`local/.runtime/`(`status.html` 状态页、`core.log`、`npm-install.log`、各 MCP 日志、技能软链)
你选的工作目录下:
想彻底重来:删掉 `local/config.local.yml`(以及可选的 `data/`)再启动。会话目录里的产出不会被删。
| 路径 | 内容 |
|---|---|
| `<工作目录>/data/` | SQLite(`.agent.db`)、启动时的 prompt dump |
| `<工作目录>/tasks/` | 会话工作区,一个会话一个 `task-YYYYMMDD-NNN/` |
| `<工作目录>/skills/` | 技能;内置技能首次启动时复制过来,以后只补缺不覆盖。依赖装在 `skills/deps/` |
仓库里只有:
- 生成的配置:`local/config.local.yml`(**首次生成,之后永不覆盖**,避免冲掉你在网页里配的模型与密钥)
- 运行期产物:`local/.runtime/`(`status.html` 状态页、`core.log`、`npm-install.log`、各 MCP 日志)
想彻底重来:删掉 `local/config.local.yml` 再启动(工作目录里的数据不会动,重选一个目录就换一套)。
技能要跟着仓库更新:删掉 `<工作目录>/skills/<技能名>` 再启动,脚本会把新版补回来(你自建的技能不受影响)。
## 常用环境变量
@@ -144,8 +157,8 @@ git pull
base64(`AGENT_IMAGE_INLINE=1`,启动器已注入)。
- **`office` 文档没有预览**:预览卡片走 core → executor 的 `:3100` 网关,本地没有这个网关,
点开得不到可用页面;文档本身的创建/编辑/读取完全正常。
- **技能依赖不预装**:本地没有 `agent-executor-init`,`skills/*/requirements.txt` 不会在启动时
自动安装。技能缺包时会报 `ModuleNotFoundError`,模型会把缺的包装进 `skills/deps`
- **技能依赖不预装**:本地没有 `agent-executor-init`,技能自带的 `requirements.txt` 不会在启动时
自动安装。缺包时会报 `ModuleNotFoundError`,模型会把缺的包装进 `<工作目录>/skills/deps`
(`AGENT_SKILLS_DEPS` 指向它,且已在该进程的 `PYTHONPATH` 里,装完下次运行即生效)。
连 `python3` 都没有时技能清单依旧完整,模型会自己把它装上再继续。
需要系统库的包(如 `weasyprint` 依赖 pango/cairo)pip 装不了,得自己 `brew install`。
+9 -7
View File
@@ -8,16 +8,18 @@
port: 8090
# AI 的工作根。local 模式注入 AGENT_FILE_SCOPE=workspace 后,文件工具可读写这个目录下任何位置。
workspace_root: /Users/you/AgentWork
# 你选的工作目录下的三个子目录:tasks(会话工作区)、data(数据库等)、skills(技能)。
# SQLite(.agent.db)与启动 prompt dump。默认指到仓库里的 data/(已在 .gitignore)。
data_root: /path/to/agent/data
# AI 的工作根:文件工具的根就是它,AI 看不到同级的 data/ 与 skills/。
workspace_root: /Users/you/AgentWork/tasks
# SQLite(.agent.db)与启动 prompt dump。
data_root: /Users/you/AgentWork/data
skills:
# 指向 local/.runtime/skills —— 启动脚本按「python3 是否可用」把它软链到真技能目录或空目录,
# 因此装不装 python3 都不需要改这里,改完重跑启动脚本即生效。
skills_root: /path/to/agent/local/.runtime/skills
# 技能根。首次启动时从仓库 skills/ 复制内置技能过来,之后只补缺不覆盖;
# pip 装的依赖落在同级的 deps/。
skills_root: /Users/you/AgentWork/skills
# 留空:启动后到设置页添加平台与 API Key,再点「重启」(启动器负责把进程拉起来)。
platforms: []
+61 -33
View File
@@ -49,7 +49,7 @@ for p in "$MCP_WEB_PORT" "$MCP_IMAGE_PORT" "$MCP_VIDEO_PORT" "$MCP_ASR_PORT"; do
[ "$p" = "$PORT" ] && PORT_COLLIDE=1
done
mkdir -p "$RUNTIME" "$ROOT/data"
mkdir -p "$RUNTIME"
printf '\n==== %s 启动 ====\n' "$(date '+%Y-%m-%d %H:%M:%S')" >> "$LOG"
if [ -t 1 ]; then
@@ -365,10 +365,10 @@ ui_checks() {
choose_workspace() {
ws=''
if [ "$(uname -s)" = 'Darwin' ] && command -v osascript >/dev/null 2>&1; then
ws=$(osascript -e 'POSIX path of (choose folder with prompt "选择 Agent 的工作目录:AI 会在这个目录里干活")' 2>/dev/null) || ws=''
ws=$(osascript -e 'POSIX path of (choose folder with prompt "选择 Agent 的工作目录:会在里面创建 data、skills、tasks 三个子目录")' 2>/dev/null) || ws=''
fi
if [ -z "$ws" ] && [ -t 0 ]; then
printf '工作目录(AI 会在这里干活)[%s/AgentWork]: ' "$HOME"
printf '工作目录(会在里面创建 data、skills、tasks)[%s/AgentWork]: ' "$HOME"
read -r ans || ans=''
if [ -n "${ans:-}" ]; then ws=$ans; else ws="$HOME/AgentWork"; fi
fi
@@ -378,21 +378,24 @@ choose_workspace() {
generate_config() {
ws=$1
mkdir -p "$ws" 2>/dev/null || { say "无法创建工作目录:$ws"; exit 1; }
mkdir -p "$ws/tasks" "$ws/data" "$ws/skills" 2>/dev/null || { say "无法创建工作目录:$ws"; exit 1; }
cat > "$CONFIG" <<EOF
# 本机 local 模式配置 —— 由 local/start.sh 首次启动时生成,之后不再覆盖。
# 改模型 / 密钥 / MCP:浏览器打开 http://$HOST_ADDR:$PORT → 左下角用户区 → 设置。
# 想彻底重来:删掉本文件再跑一次 ./local/start.sh(会话记录在 data/ 和工作目录里,不会被删)。
# 想彻底重来:删掉本文件再跑一次 ./local/start.sh(会话、技能、数据库都在工作目录里,不会被删)。
port: $PORT
# AI 的工作根。启动器注入 AGENT_FILE_SCOPE=workspace,文件工具可读写这个目录下的任意位置,
# 不再像服务器那样被限制在单个会话子目录里。路径一律加引号:用户选的目录带空格/':'/'#' 时
# 不加引号会被 YAML 当成注释或键值分隔符。
workspace_root: "$ws"
data_root: "$ROOT/data"
# 工作目录下的三个子目录分工:tasks=会话工作区(AI 的地盘)、data=数据库与调试产物、
# skills=技能(内置技能首次运行时复制过来,之后可自行增删改)。
# 路径一律加引号:用户选的目录带空格/':'/'#' 时,不加引号会被 YAML 当成注释或键值分隔符。
#
# AI 的工作根。启动器注入 AGENT_FILE_SCOPE=workspace,文件工具的根就是这个目录:
# AI 能在这里面任意读写,但看不到同级的 data/ 和 skills/。
workspace_root: "$ws/tasks"
data_root: "$ws/data"
skills:
# 指向 local/.runtime/skills:启动脚本按「有没有可用的 python3」把它软链到真技能目录或空目录。
# 这样装不装 python3 都不用改这份配置(改完重跑脚本即生效)。
skills_root: "$ROOT/local/.runtime/skills"
# 技能根。首次启动时把仓库 skills/ 里的内置技能复制到这里,之后只补缺不覆盖;
# pip 装的依赖落在同级的 deps/(AGENT_SKILLS_DEPS 指向它,已在 PYTHONPATH 里)。
skills_root: "$ws/skills"
# 故意留空:启动后在设置页添加平台与 API Key,再点「重启」——启动器会自动拉起。
platforms: []
log_level: info
@@ -415,19 +418,42 @@ EOF
say "工作目录:$ws"
}
# ---------- 技能目录:软链到仓库 skills,不动配置 ----------
# 为什么不再按 python3 有无切换成空目录:技能不一定是 Python 的。office 就是
# SKILL.md + scripts/office(Node)+ 二进制,跟 python3 无关;
# 一刀切会把这类技能一并藏起来。而 Python 技能缺解释器时,skills.js 的 runEntry 对
# spawn 的 error 有处理,模型拿到的是「技能入口启动失败:spawn python3 ENOENT」,
# 干净可读,不会崩也不会挂住——没必要靠藏清单来避险。
link_skills() {
link="$RUNTIME/skills"
dest="$ROOT/skills"
rm -f "$link" 2>/dev/null || true
# 万一上次留下了真目录(老版本行为),先挪走再建软链
if [ -d "$link" ] && [ ! -L "$link" ]; then rm -rf "$link"; fi
ln -s "$dest" "$link" || { warn "技能目录软链创建失败:$link"; return 1; }
# ---------- 技能目录:内置技能复制到工作目录,之后只补缺 ----------
# 技能根在用户选的工作目录里(<ws>/skills),与 data/、tasks/ 同级。仓库 skills/ 只是出厂副本:
# 这里只补缺——工作目录里没有的内置技能才复制,已存在的一律不动,所以用户改过的、
# AI 自己新建的技能都不会被覆盖。要拿仓库里的新版技能:删掉对应子目录再重跑本脚本。
# deps 不复制:仓库那份是服务器构建期产物,平台和版本都不该跟着走;本地 pip 自己装。
# 取配置里一个标量值(去掉引号)。不试图当 YAML 解析器用:配置是本脚本生成的,格式稳定。
cfg_get() {
sed -n "s/^[[:space:]]*$1:[[:space:]]*[\"']\{0,1\}\([^\"']*\)[\"']\{0,1\}[[:space:]]*$/\1/p" \
"$CONFIG" 2>/dev/null | head -n 1
}
# 技能根:配置里的 skills_root;留空则取 workspace_root 的同级 skills(与 core 的默认一致)。
skills_dir() {
d=$(cfg_get skills_root)
if [ -z "$d" ]; then
w=$(cfg_get workspace_root)
[ -n "$w" ] && d="$(dirname "$w")/skills"
fi
printf '%s' "$d"
}
sync_skills() {
dest=$1
[ -n "$dest" ] || { warn '配置里既没有 skills_root 也没有 workspace_root,技能不可用'; return 1; }
mkdir -p "$dest/deps" 2>/dev/null || { warn "无法创建技能目录:$dest"; return 1; }
added=0
for s in "$ROOT/skills"/*; do
[ -d "$s" ] || continue
name=${s##*/}
[ "$name" = 'deps' ] && continue
[ -e "$dest/$name" ] && continue
cp -R "$s" "$dest/$name" 2>/dev/null && added=$((added + 1))
done
[ "$added" -gt 0 ] && say "技能:复制 $added 个内置技能到 $dest"
return 0
}
# 依赖是否装全:0 = 齐全,非 0 = 缺(npm install 中途失败、被手工删过等)。
@@ -818,7 +844,7 @@ check_mcp() {
}
start_core() {
# PYTHONPATH 把技能共享依赖层 skills/deps 放进 python 的搜索路径(与服务器上 executor 容器
# PYTHONPATH 把技能依赖层 <工作目录>/skills/deps 放进 python 搜索路径(与服务器上 executor 容器
# 的 PYTHONPATH 对齐,那边由 compose 注入)。本地没有 agent-executor-init 替我们装包,
# 所以另外把目录路径作为 AGENT_SKILLS_DEPS 传下去:技能缺什么时,模型按该技能目录的
# AGENTS.md 自行安装(提示词里只给这一句指路),启动器不认识任何具体技能。
@@ -832,8 +858,8 @@ start_core() {
AGENT_LOCAL_PICK=1 \
AGENT_IMAGE_INLINE=1 \
ASR_URL="$ASR_URL" \
PYTHONPATH="$ROOT/skills/deps" \
AGENT_SKILLS_DEPS="$ROOT/skills/deps" \
PYTHONPATH="$SKILLS_DIR/deps" \
AGENT_SKILLS_DEPS="$SKILLS_DIR/deps" \
node server/server.js >>"$LOG" 2>&1 ) &
CORE_PID=$!
}
@@ -963,11 +989,13 @@ if ! ensure_deps; then
exit 1
fi
if link_skills; then
if [ "$PY_OK" = 1 ]; then ui_step '技能:已启用' ok
else ui_step '技能:python3 未安装(Python 技能会失败)' warn; fi
SKILLS_DIR=$(skills_dir)
[ -n "$SKILLS_DIR" ] || SKILLS_DIR="$ROOT/skills" # 配置里两个键都被删掉时的兼底
if sync_skills "$SKILLS_DIR"; then
if [ "$PY_OK" = 1 ]; then ui_step "技能:$SKILLS_DIR" ok
else ui_step "技能:$SKILLS_DIR(python3 未安装,Python 技能会失败)" warn; fi
else
ui_step '技能目录软链创建失败,技能不可用' warn
ui_step '技能目录不可用(检查配置里的 skills_root)' warn
fi
# 语音:ffmpeg 在就启用,两条线都靠同一个开关: