From 8effba36dd5650f383f8631d3842e8d53836782b Mon Sep 17 00:00:00 2001 From: kicer Date: Wed, 11 Nov 2026 21:31:14 +0800 Subject: [PATCH] =?UTF-8?q?feat(local):=20=E5=B7=A5=E4=BD=9C=E7=9B=AE?= =?UTF-8?q?=E5=BD=95=E6=8B=86=E6=88=90=20data/skills/tasks=EF=BC=8C?= =?UTF-8?q?=E6=8A=80=E8=83=BD=E5=A4=8D=E5=88=B6=E5=88=B0=E7=94=A8=E6=88=B7?= =?UTF-8?q?=E7=9B=AE=E5=BD=95?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 启动器不再把技能软链回仓库,改为首次启动把内置技能复制到 <工作目录>/skills, 之后每次启动只补缺不覆盖(用户/AI 改过的不会被冲掉)。deps 不复制,只建空目录, pip 装进 <工作目录>/skills/deps,PYTHONPATH 与 AGENT_SKILLS_DEPS 都指过去。 工作目录据此变成三件套:tasks=会话工作区(AI 的文件根,与服务器 /workspace/tasks 同语义)、data=SQLite 与 prompt dump、skills=技能。仓库里不再有用户数据。 配置仍只由首次启动生成:workspace_root=/tasks、data_root=/data、 skills_root=/skills。新增 cfg_get/skills_dir 从配置读技能根,不自己发明路径。 --- docs/local-mode.md | 64 +++++++++++++++------------ local/README.md | 39 +++++++++++------ local/config.example.yml | 16 ++++--- local/start.sh | 94 ++++++++++++++++++++++++++-------------- 4 files changed, 133 insertions(+), 80 deletions(-) diff --git a/docs/local-mode.md b/docs/local-mode.md index d192e7a..96e92dc 100644 --- a/docs/local-mode.md +++ b/docs/local-mode.md @@ -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:/p/` | 复用 `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 `,完全不需要 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:/...`,只能在这台机器上打开(这正是本地形态的预期)。要真正对外暴露才需在设置页填 `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. 新建会话手选工作目录(本地端) diff --git a/local/README.md b/local/README.md index 11f1e6b..30f32ef 100644 --- a/local/README.md +++ b/local/README.md @@ -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`。 diff --git a/local/config.example.yml b/local/config.example.yml index bb139e0..4998f56 100644 --- a/local/config.example.yml +++ b/local/config.example.yml @@ -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: [] diff --git a/local/start.sh b/local/start.sh index 46ba9a1..7aad70e 100755 --- a/local/start.sh +++ b/local/start.sh @@ -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" </dev/null || true - # 万一上次留下了真目录(老版本行为),先挪走再建软链 - if [ -d "$link" ] && [ ! -L "$link" ]; then rm -rf "$link"; fi - ln -s "$dest" "$link" || { warn "技能目录软链创建失败:$link"; return 1; } +# ---------- 技能目录:内置技能复制到工作目录,之后只补缺 ---------- +# 技能根在用户选的工作目录里(/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 在就启用,两条线都靠同一个开关: