refactor(skills): 本机环境说明改放技能目录的 AGENTS.md,启动器不再特判任何技能
上一版把安装说明写成 INSTALL.md 并在 SKILL.md 里加段落,两处都不对:SKILL.md 是用法说明, 不该塞安装内容;启动器为 office 单独注入 PATH 也不成立,再加技能就得逐条改 start.sh。 - 删除 4 个 INSTALL.md,改为各技能目录下的 AGENTS.md(只写命令:下载/安装/验证、 平台资产名、字体路径),SKILL.md 恢复原样 - start.sh 去掉 office 的 PATH 注入;技能要命令入口时由 AGENTS.md 指导按次前缀 (PATH="$SK/scripts:$PATH" office ...)。启动器只保留 AGENT_SKILLS_DEPS 这个路径变量 - 找不到依赖时的指路不放在 core 里做特征匹配,而是各自报错带自己 AGENTS.md 的绝对路径 (office 封装层 ENOENT / x2pdf 缺包或无后端 / image-process 缺字体) - env-local 提示词加一句:技能失败就读其目录下的 AGENTS.md 实测:无 PATH 时 office 报 command not found,按 AGENTS.md 加前缀后 --version 正常; 三条缺依赖报错均给出 AGENTS.md 绝对路径。
This commit is contained in:
+19
-21
@@ -277,33 +277,31 @@ health 只作为「端口上有服务但不是本启动器拉起的」兜底提
|
||||
需要系统库的包(`weasyprint` → pango/cairo)pip 装不了,仍需用户 `brew install`;这类不在
|
||||
自动修复范围内,模型只报结论。
|
||||
|
||||
### 4.14 本地安装:`install.sh` / `requirements.txt` 归服务器,本机走 `INSTALL.md`
|
||||
### 4.14 技能自洽:本机环境写在技能目录的 `AGENTS.md`
|
||||
|
||||
原则:**不为了本地去改安装脚本**。`install.sh`(系统依赖/资产)与 `requirements.txt`(Python 包)
|
||||
是服务器工件:镜像构建与 `agent-executor-init` 读它们,行为保持不变;`install.sh` 里只有 apt 与
|
||||
linux-x64 资产,本来也不该在 mac 上跑。
|
||||
`install.sh` / `requirements.txt` 是服务器工件(镜像构建与 `agent-executor-init` 读它们),本机不跑、
|
||||
不改。启动器也不认识任何具体技能:不注入 PATH、不预装、不做特判。新增技能不需要动 `local/`。
|
||||
|
||||
本机「真要用到却缺东西」时,由技能自己的 `INSTALL.md` 告诉模型怎么装(`SKILL.md` 里各加一行
|
||||
指向它)。写法是具体命令 + 平台表(哪些包、什么 URL、字体在哪),**不写兼容代码**:没有平台矩阵、
|
||||
没有自动探测多套运行时。“不要尝试兼容所有环境”就是这个意思。
|
||||
本机缺东西时只有一条入口:技能自己目录下的 `AGENTS.md`(下载/安装/验证命令、平台资产名、字体路径)。
|
||||
起点是 `env-local` 提示词的一句话:技能失败就读
|
||||
`"$(dirname "$AGENT_SKILLS_DEPS")/<技能>/AGENTS.md"`。装完不需要重启,旧进程不影响。
|
||||
|
||||
只有两处代码级的必要钩子,都不是环境探测:
|
||||
代价明写:`office` 的命令入口在本地不在 PATH 上,按次 `PATH="$SK/scripts:$PATH" office ...` 即可
|
||||
(这是它 `AGENTS.md` 的第一条)。
|
||||
|
||||
- **`office` 的 PATH**:服务器靠镜像里的 `/usr/local/bin/office` 软链;本地没 root 写不了系统目录,
|
||||
`start.sh` 起 core 时把 `skills/office/scripts` 直接塞进 `PATH`(脚本自身可执行,不复制、不装软链)。
|
||||
`terminal` 继承 core 的 env,模型调 `office <cmd>` 即命中。报错文案指向 `INSTALL.md` 绝对路径。
|
||||
- **`x2pdf` 的 `find_soffice()`**:`brew install --cask libreoffice` 后 `soffice` 不在 `PATH`
|
||||
(在 `/Applications/LibreOffice.app/Contents/MacOS/`),不探这几个默认位置,`INSTALL.md`
|
||||
里写的“装 LibreOffice 即可”就是假的。同理保留了 WeasyPrint 不可用时回落 LibreOffice:
|
||||
这让本地只需一个后端,而不是 pango + WeasyPrint 两套链。
|
||||
报错指向各自文档,不在 core 里做全局特征匹配(那种正则既脆又不可移植):
|
||||
|
||||
`officecli` 会把自己更新到上游 latest(实测 1.0.157 跑一次变 1.0.160),所以 `INSTALL.md` 直接
|
||||
指向 `releases/latest`,不要求与服务器 pin 的版本对齐。
|
||||
| 位置 | 报错附带 |
|
||||
|---|---|
|
||||
| `office` 封装层 ENOENT | 本技能 `AGENTS.md` 绝对路径 |
|
||||
| `x2pdf` 缺包 / 无渲染后端 | 同上 |
|
||||
| `image-process` 缺中文字体 | 同上(并提示传 `font`) |
|
||||
|
||||
没做的是预览:预览卡片要 executor 的 `:3100` 网关,本地没有。要补就相当于把
|
||||
`executor/preview.js` 的槽位管理搬进 core,不值得。
|
||||
唯一保留的环境相关代码是 `x2pdf` 的 `find_soffice()`:`brew install --cask libreoffice` 后
|
||||
`soffice` 不在 PATH(在 app bundle 内),不探这几个默认位置,“装 LibreOffice 即可”就是假的。
|
||||
另保留了 WeasyPrint 不可用时回落 LibreOffice,让本地只需一个后端而不是 pango + WeasyPrint 两套链。
|
||||
|
||||
没做的是预览:预览卡片要 executor 的 `:3100` 网关,本地没有。要补就相当于把
|
||||
没做的是预览:预览卡片要 executor 的 `:3100` 网关,本地没有。要补相当于把
|
||||
`executor/preview.js` 的槽位管理搬进 core,不值得。
|
||||
|
||||
## 5. 验证结果(macOS 12.7.6 / x86_64 / Node 22.21 / python3 3.10 / 本机无 ffmpeg)
|
||||
@@ -377,7 +375,7 @@ tail -f local/.runtime/core.log # 以及 npm-install.log / mcp-*.log
|
||||
| Windows 不支持 | `spawn('/bin/sh')`、`process.kill(-pid)`、模型写的 bash 语法都是 POSIX 语义 |
|
||||
| `mint_public_link` 不可用 | 本地 `public_link.base_url` 为空,工具会回明确的「未配置」错误 |
|
||||
| 技能依赖 | 本地不预装:缺包时模型会把包装进 `skills/deps`(`$AGENT_SKILLS_DEPS`,已在该进程 `PYTHONPATH` 里,装完下次运行即生效);连 `python3` 都没有时也由它自己装。怎么装由模型自己决定。需要系统库的包(`weasyprint`→pango/cairo)pip 装不了,仍需手工 `brew install`。服务器上由 `agent-executor-init` 处理 |
|
||||
| `office` 二进制 | 不入库、也不预装:首次用到时封装层报 `binary missing` 并给出同目录 `INSTALL.md` 的绝对路径,模型按它自己下载(`releases/latest`,mac/linux 资产表,~34MB,GitHub 慢就用 gh-proxy)。不需要 root、不需重启。officecli 会自更新到 latest,版本比服务器 pin 的新属正常 |
|
||||
| `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(原来钉在内网镜像,外部机器必失败) |
|
||||
|
||||
|
||||
Reference in New Issue
Block a user