功能:executor 镜像分层(基础 M + 技能系统层派生镜像)+ 启动前 skills 初始化

- executor/Dockerfile 改多阶段:base 为基础镜像 M(长期不变,系统工具 + 预烘 Python 包);skills 阶段 = M + 技能系统层依赖(构建期跑各 install.sh,apt 等系统包持久且对命令只读)。build context 改为仓库根,用 .dockerignore 只放行 executor/ 与 skills/。

- 新增 agent-executor-init 一次性服务(executor/init-skills.js,与 core ensureDeps 同 hash/marker 格式):启动前把 requirements.txt(pip --target 共享 deps)与 install.sh 资产落到宿主 ./skills;只挂 ./skills、无特权、read_only,跑完退出;executor depends_on service_completed_successfully。

- 运行期 skills 仍 :ro;M 不变、skills 可变、命令写不了共享系统层,会话隔离保持。

- 实测:构建 stage 两个 install.sh 正常;init 幂等跳过/按需重跑(install.sh 与 pip 分支各验一次);executor 重建后 ReadonlyRootfs=true、/run tmpfs、core 到 executor 健康、run_skill 端到端正常。docs/ARCHITECTURE.md 与 skills/README.md 同步。
This commit is contained in:
2026-09-11 23:35:17 +08:00
parent 2f96414c49
commit dbc1783b3e
6 changed files with 181 additions and 9 deletions
+8 -4
View File
@@ -128,7 +128,7 @@ def main():
### 5.1 Python 依赖
在技能目录下放置 `requirements.txt` 文件,列出所有需要的第三方包。Skill Manager 会**自动安装**这些依赖到共享的 `deps` 目录(位于技能根目录下的 `deps/`),并通过 `PYTHONPATH` 注入运行环境。
在技能目录下放置 `requirements.txt` 文件,列出所有需要的第三方包。服务启动前,`agent-executor-init`(`executor/init-skills.js`)会**自动安装**这些依赖到共享的 `deps` 目录(技能根目录下的 `deps/`),运行期通过 `PYTHONPATH` 注入;结果按 `requirements.txt` 的 hash 缓存(`.deps_installed`),未变化则跳过。
示例 `requirements.txt`:
@@ -139,10 +139,14 @@ beautifulsoup4==4.11.1
- 依赖安装使用 `pip install --target`,不会污染系统全局。
- 所有技能**共享**同一个 `deps` 目录,请注意版本冲突(后装的覆盖先装的)。建议锁定精确版本。
- 运行期 skills 目录只读;若上线后经 UI 改了 `requirements.txt`,需重启(`docker compose up -d`)触发重新 init,否则该技能会因依赖未就绪而失败。
### 5.2 系统级依赖
如果技能需要系统库或字体等,可以提供一个 `install.sh` 脚本。Skill Manager 会在首次运行或脚本内容变化时执行它,并缓存结果。
如果需要系统库或字体等,提供一个 `install.sh` 脚本。它在两处执行:
- **镜像构建**(`executor/Dockerfile` 的 `skills` 阶段,`build.target: skills`):此处安装的系统包(`apt-get` 等)会烘进派生镜像 M',持久且对命令只读——**系统包必须走这里**。
- **服务启动前的 init**(`executor/init-skills.js`):用于生成技能自带资产(如从系统字体提取 `fonts/cjk.ttf`)。init 容器根文件系统只读,`apt-get install` 在这里不生效,不要依赖它。
示例 `install.sh`:
@@ -154,8 +158,8 @@ apt-get install -y -qq some-package
```
- `install.sh` 必须可执行(`chmod +x install.sh`)。
- 脚本中的操作应尽量幂等,以避免重复执行时出错。
- 如果安装耗时较长,请耐心等待;Skill Manager 会设置超时(默认 10 分钟)。
- 请保持幂等:两处都以内容 hash 为缓存,仅在变化时执行。
- 改动 `install.sh` 后:系统包需 `docker compose build agent-executor`,资产需 `docker compose up -d`(或两者一起 `build && up`)。
### 5.3 缓存机制