diff --git a/app/server/templates/env-local.txt b/app/server/templates/env-local.txt index 69e8a74..3ce24ef 100644 --- a/app/server/templates/env-local.txt +++ b/app/server/templates/env-local.txt @@ -2,4 +2,5 @@ conversations share it and `/tmp` is the system temp dir. Work inside the working directory; treat everything outside it as the user's. - `python3` may be missing. Install what a task needs; Python packages go into - `$AGENT_SKILLS_DEPS`. + `$AGENT_SKILLS_DEPS`. If a skill fails, read its own `AGENTS.md` + (`"$(dirname "$AGENT_SKILLS_DEPS")//AGENTS.md"`) and follow it. diff --git a/docs/local-mode.md b/docs/local-mode.md index 7b772b8..570a94d 100644 --- a/docs/local-mode.md +++ b/docs/local-mode.md @@ -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 ` 即命中。报错文案指向 `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(原来钉在内网镜像,外部机器必失败) | diff --git a/local/README.md b/local/README.md index 6217e06..33d00c9 100644 --- a/local/README.md +++ b/local/README.md @@ -66,7 +66,7 @@ cd agent |---|---|---| | 语音输入 | `ffmpeg` + 设置页给 `asr` 填上游(`X-ASR-Base-Url` / `X-ASR-Model`) | 麦克风入口自动隐藏(`/api/asr/status` 返回 `enabled:false`),`mcp_asr` 子进程也不启动 | | 技能 | `python3`(仅 Python 类技能需要) | 技能清单照常显示;调 `run.py` 类技能报「入口启动失败」,`office` 这类非 Python 技能不受影响 | -| Office 文档(docx/xlsx/pptx) | 首次用到时下载一次 officecli 二进制(约 34MB) | `office` 命令报「binary missing」并给出同目录 `INSTALL.md` 的路径,按它下载即可(不需 root、不需重启) | +| Office 文档(docx/xlsx/pptx) | 首次用到时下载一次 officecli 二进制(约 34MB) | `office` 报 `binary missing` 并给出该技能 `AGENTS.md` 的路径,按它下载即可(不需 root、不需重启) | | 网页搜索 | 无 | 装了 Node 就有(内置免费后端) | | 图片 / 视频生成 | 设置页给对应 MCP 填上游 key | 调用时报明确的缺参错误 | diff --git a/local/start.sh b/local/start.sh index 0120f18..32f8499 100755 --- a/local/start.sh +++ b/local/start.sh @@ -417,7 +417,7 @@ EOF # ---------- 技能目录:软链到仓库 skills,不动配置 ---------- # 为什么不再按 python3 有无切换成空目录:技能不一定是 Python 的。office 就是 -# SKILL.md + scripts/office,模型在 terminal 里调 `office `,跟 python3 无关; +# SKILL.md + scripts/office(Node)+ 二进制,跟 python3 无关; # 一刀切会把这类技能一并藏起来。而 Python 技能缺解释器时,skills.js 的 runEntry 对 # spawn 的 error 有处理,模型拿到的是「技能入口启动失败:spawn python3 ENOENT」, # 干净可读,不会崩也不会挂住——没必要靠藏清单来避险。 @@ -820,11 +820,8 @@ check_mcp() { start_core() { # PYTHONPATH 把技能共享依赖层 skills/deps 放进 python 的搜索路径(与服务器上 executor 容器 # 的 PYTHONPATH 对齐,那边由 compose 注入)。本地没有 agent-executor-init 替我们装包, - # 所以另外把目录路径作为 AGENT_SKILLS_DEPS 传下去:模型在 terminal 里发现技能缺包时, - # 按提示词里的写法 pip install --target "$AGENT_SKILLS_DEPS" 即可,技能下次运行就能 import。 - # PATH 前面加 skills/office/scripts:office 技能的唯一入口就是那个 Node 封装层。 - # 服务器上靠镜像里的 /usr/local/bin/office 软链进 PATH,本地没 root 写不了系统目录, - # 所以直接把目录塞进 PATH(脚本自身可执行,不复制、不装软链)。二进制缺时封装层会报 install.sh 路径。 + # 所以另外把目录路径作为 AGENT_SKILLS_DEPS 传下去:技能缺什么时,模型按该技能目录的 + # AGENTS.md 自行安装(提示词里只给这一句指路),启动器不认识任何具体技能。 ( cd "$ROOT/app" && exec env \ PORT="$PORT" \ HOST="$HOST_ADDR" \ @@ -834,7 +831,6 @@ start_core() { ASR_URL="$ASR_URL" \ PYTHONPATH="$ROOT/skills/deps" \ AGENT_SKILLS_DEPS="$ROOT/skills/deps" \ - PATH="$ROOT/skills/office/scripts:$PATH" \ node server/server.js >>"$LOG" 2>&1 ) & CORE_PID=$! } diff --git a/skills/document-photo-to-pdf/AGENTS.md b/skills/document-photo-to-pdf/AGENTS.md new file mode 100644 index 0000000..cb42850 --- /dev/null +++ b/skills/document-photo-to-pdf/AGENTS.md @@ -0,0 +1,16 @@ +# document-photo-to-pdf:本机环境 + +```sh +SK="$(dirname "$AGENT_SKILLS_DEPS")/document-photo-to-pdf" +``` + +缺依赖时(`ModuleNotFoundError`,最先撞到的是 `numpy`): + +```sh +python3 -m pip install --target "$AGENT_SKILLS_DEPS" -r "$SK/requirements.txt" +python3 -c "import numpy, PIL, fitz" +``` + +- `fitz` 是 `pymupdf` 的 import 名 +- `pypdfium2` 不必装:只在 `pymupdf` 也缺失时才用得上 +- 自检渲染优先系统 `pdftoppm`(poppler,可选) diff --git a/skills/document-photo-to-pdf/INSTALL.md b/skills/document-photo-to-pdf/INSTALL.md deleted file mode 100644 index 59ea3b2..0000000 --- a/skills/document-photo-to-pdf/INSTALL.md +++ /dev/null @@ -1,29 +0,0 @@ -# 本机安装 Python 依赖(document-photo-to-pdf 技能) - -依赖由同目录 `requirements.txt` 声明(服务器 init 按它装;本机自己装)。纯 wheel,无编译、无系统库。 -下文「技能目录」= `$(dirname "$AGENT_SKILLS_DEPS")/document-photo-to-pdf`。 - -```bash -python3 -m pip install --target "$AGENT_SKILLS_DEPS" \ - -r "$(dirname "$AGENT_SKILLS_DEPS")/document-photo-to-pdf/requirements.txt" -``` - -## 依赖说明 - -| 包 | 用途 | -|---|---| -| `numpy` | 透视校正、统计与阈值计算 | -| `Pillow` | 图片读写、缩放、调色 | -| `pymupdf` | 生成 PDF(import 名是 `fitz`)与自检渲染 | - -自检渲染优先用系统 `pdftoppm`(poppler,可选);没有就用 `pymupdf`;再不行才落到 `pypdfium2`。 -`pypdfium2` **不必装**,只在 `pymupdf` 也缺失时才有意义。 - -## 验证 - -```bash -python3 -c "import numpy, PIL, fitz" -``` - -缺依赖时技能会抛 `ModuleNotFoundError`(最先撞到的是 `numpy`)。装完不需要重启 agent: -每次 `skill run` 都是新进程,`$AGENT_SKILLS_DEPS` 已在 `PYTHONPATH` 里。 diff --git a/skills/document-photo-to-pdf/SKILL.md b/skills/document-photo-to-pdf/SKILL.md index 52619ad..e7f5338 100644 --- a/skills/document-photo-to-pdf/SKILL.md +++ b/skills/document-photo-to-pdf/SKILL.md @@ -59,7 +59,3 @@ input_schema: - 一图一纸;同框多纸只取最大。 - 建议 ≤20 页;更多或 300dpi 可能超 120s,可分批。 - `out/` 里的原图是自然尺寸(不缩放、不调色),页与页尺寸可能不同;PDF 仍按纸张/批次统一。 - -## 环境 - -缺 Python 依赖时按同目录 `INSTALL.md` 自己装(服务器由镜像 + `requirements.txt` 提供)。 diff --git a/skills/image-process/AGENTS.md b/skills/image-process/AGENTS.md new file mode 100644 index 0000000..f506063 --- /dev/null +++ b/skills/image-process/AGENTS.md @@ -0,0 +1,26 @@ +# image-process:本机环境 + +```sh +SK="$(dirname "$AGENT_SKILLS_DEPS")/image-process" +``` + +## Pillow + +```sh +python3 -m pip install --target "$AGENT_SKILLS_DEPS" -r "$SK/requirements.txt" +python3 -c "import PIL" +``` + +## 中文水印缺字体 + +技能不内置字体,也不跨平台查找。报「中文水印缺少字体」时传 `font` 参数: + +- macOS:`/System/Library/Fonts/Hiragino Sans GB.ttc`(简体)、`/System/Library/Fonts/PingFang.ttc` +- Linux:`/usr/share/fonts/truetype/wqy/wqy-zenhei.ttc` +- Windows:`C:\Windows\Fonts\msyh.ttc` + +```json +{"action":"watermark","input":"a.jpg","text":"机密","font":"/System/Library/Fonts/Hiragino Sans GB.ttc"} +``` + +英文/数字水印不需要字体;其余动作只依赖 Pillow。 diff --git a/skills/image-process/INSTALL.md b/skills/image-process/INSTALL.md deleted file mode 100644 index 2a46c68..0000000 --- a/skills/image-process/INSTALL.md +++ /dev/null @@ -1,30 +0,0 @@ -# 本机安装依赖与字体(image-process 技能) - -下文「技能目录」= `$(dirname "$AGENT_SKILLS_DEPS")/image-process`。 - -## Python 包:Pillow - -```bash -python3 -m pip install --target "$AGENT_SKILLS_DEPS" \ - -r "$(dirname "$AGENT_SKILLS_DEPS")/image-process/requirements.txt" -python3 -c "import PIL" # 验证 -``` - -## 中文字体:只在 `watermark` 且文字含中文时需要 - -技能不内置字体,也不做跨平台查找,只认两条 Linux 路径(镜像里预装文泉驿)。 -本机缺字体时报「中文水印缺少字体」,这时**传 `font` 参数**指向任意中文字体即可: - -| 平台 | 常见字体路径 | -|---|---| -| macOS | `/System/Library/Fonts/Hiragino Sans GB.ttc`(简体,推荐)、`/System/Library/Fonts/PingFang.ttc` | -| Linux | `/usr/share/fonts/truetype/wqy/wqy-zenhei.ttc` | -| Windows | `C:\Windows\Fonts\msyh.ttc` | - -```json -{"action":"watermark","input":"a.jpg","text":"机密", - "font":"/System/Library/Fonts/Hiragino Sans GB.ttc"} -``` - -英文/数字水印不需要字体(走 Pillow 内置默认字体)。其余动作(info / convert / resize / crop / -compress / slice / grid)只依赖 Pillow。 diff --git a/skills/image-process/SKILL.md b/skills/image-process/SKILL.md index 3bef6c6..5d7a512 100644 --- a/skills/image-process/SKILL.md +++ b/skills/image-process/SKILL.md @@ -106,5 +106,5 @@ output_schema: - 本技能**只做确定性图像处理**(转换/缩放/裁剪/压缩/水印/拼图),不含 AI 生成、抠图、换脸、扩图、修复等生成式/语义编辑能力。 - 若用户的需求属于"文生图 / AI 修图"等生成式范畴,不要用本技能硬凑,应说明能力边界并推荐第三方工具(豆包、即梦、可灵、Photoshop 等)。 - 任何操作都不会覆盖输入原图;输出目录不存在时自动创建。 -- 中文水印需要字体:优先用 `font` 参数指定;否则依赖系统字体(镜像预装文泉驿)。 -- 输入依赖 Pillow;本机缺 Pillow 或字体时按同目录 `INSTALL.md` 自己装(服务器由镜像 + `requirements.txt` 提供)。 +- 中文水印需要字体:优先用 `font` 参数指定;否则依赖系统字体(镜像预装文泉驿,install.sh 会兑底安装)。 +- 输入依赖预装的 Pillow,无需额外 Python 依赖;系统级字体依赖见 install.sh。 diff --git a/skills/image-process/run.py b/skills/image-process/run.py index e113976..0fe19ef 100644 --- a/skills/image-process/run.py +++ b/skills/image-process/run.py @@ -249,8 +249,8 @@ def action_watermark(img, fmt, args): if font_path: font = ImageFont.truetype(font_path, font_size) elif need_cjk: - raise ValueError('中文水印缺少字体:传 font 参数(TTF/TTC 路径);各平台常见字体路径见 %s' - % (Path(__file__).resolve().parent / 'INSTALL.md')) + raise ValueError('中文水印缺少字体:传 font 参数(TTF/TTC 路径);本机环境见 %s' + % (Path(__file__).resolve().parent / 'AGENTS.md')) else: try: font = ImageFont.load_default(size=font_size) diff --git a/skills/office/AGENTS.md b/skills/office/AGENTS.md new file mode 100644 index 0000000..08c0a4d --- /dev/null +++ b/skills/office/AGENTS.md @@ -0,0 +1,27 @@ +# office:本机环境 + +服务器由镜像与 `agent-executor-init` 准备(跑同目录 `install.sh`)。本机不要跑它,按下面装,装完不需要重启。 + +```sh +SK="$(dirname "$AGENT_SKILLS_DEPS")/office" +``` + +## 缺二进制(报 `office.core binary missing`) + +```sh +mkdir -p "$SK/bin" +curl -fL --progress-bar -o "$SK/bin/officecli" \ + https://github.com/iOfficeAI/OfficeCLI/releases/latest/download/officecli-mac-x64 +chmod +x "$SK/bin/officecli" && "$SK/bin/officecli" --version +``` + +资产名:mac Intel `officecli-mac-x64`、Apple Silicon `officecli-mac-arm64`、Linux `officecli-linux-x64` / `officecli-linux-arm64`。 +GitHub 慢时加 `https://gh-proxy.com/` 前缀。用 `latest` 即可,不必对齐服务器的 pin。 + +## `office` 命令不在 PATH + +本机启动器不注入 PATH。按次指定目录: + +```sh +PATH="$SK/scripts:$PATH" office help +``` diff --git a/skills/office/INSTALL.md b/skills/office/INSTALL.md deleted file mode 100644 index 483ef35..0000000 --- a/skills/office/INSTALL.md +++ /dev/null @@ -1,46 +0,0 @@ -# 本机安装 officecli(office 技能) - -技能三件套:本文件同目录的 `SKILL.md`(用法)、`scripts/office`(Node 封装层,已在 `PATH` 里)、 -`bin/officecli`(.NET 单文件二进制,**不入库**)。 - -服务器上由镜像构建 / `agent-executor-init` 跑同目录的 `install.sh`(只处理 linux-x64)。 -**本机不要跑 `install.sh`**,按下面自己下:先装才用,不需要重启 agent(封装层每次执行时才解析二进制路径)。 - -下文「技能目录」= `$(dirname "$AGENT_SKILLS_DEPS")/office`(本地形态 `AGENT_SKILLS_DEPS` 指向 `<仓库>/skills/deps`)。 - -## 1. 下载对应平台的资产 - -| 平台 | 资产名 | -|---|---| -| macOS Apple Silicon | `officecli-mac-arm64` | -| macOS Intel | `officecli-mac-x64` | -| Linux x64 | `officecli-linux-x64` | -| Linux arm64 | `officecli-linux-arm64` | - -```bash -mkdir -p "$(dirname "$AGENT_SKILLS_DEPS")/office/bin" -curl -fL --progress-bar \ - -o "$(dirname "$AGENT_SKILLS_DEPS")/office/bin/officecli" \ - https://github.com/iOfficeAI/OfficeCLI/releases/latest/download/officecli-mac-x64 -``` - -- 用 `latest` 就够(officecli 首次运行也会把自己更新到 latest),不用对齐服务器 pin 的版本。 -- 国内慢就换源:`https://gh-proxy.com/https://github.com/iOfficeAI/OfficeCLI/releases/latest/download/<资产>`。 -- 约 34MB,超时/断流就重试;`curl -fL` 失败时不会留下半截文件可用。 - -## 2. 赋可执行位并验证 - -```bash -chmod +x "$(dirname "$AGENT_SKILLS_DEPS")/office/bin/officecli" -office --version # 或 office help -``` - -`office` 命令由本地启动器注入 `PATH` 提供(`skills/office/scripts` 目录),不需要建软链、不需要 root。 -如果 `office` 不在 PATH(例如手工起 core 没带启动器),可以直接跑 -`node "$(dirname "$AGENT_SKILLS_DEPS")/office/scripts/office" help`。 - -## 3. 装不上怎么办 - -封装层会报 `office.core binary missing: <路径>`,说明二进制没到位;文档的创建/编辑/读取全部依赖它, -没有它就用别的路子(例如要 PDF 用 `x2pdf` 技能)。**不要**为此改系统目录或去装 .NET 运行时—— -该二进制是自包含的。 diff --git a/skills/office/SKILL.md b/skills/office/SKILL.md index a69c15e..30a908f 100644 --- a/skills/office/SKILL.md +++ b/skills/office/SKILL.md @@ -34,5 +34,4 @@ create/open 成功后,用户可自行查看该文档的实时预览(预览 ## 注意 - 所有操作文档在任务目录里。 -- 缺 `bin/officecli`(报 `binary missing`)时:按同目录 `INSTALL.md` 自己装;服务器端由镜像构建 / `agent-executor-init` 提供,本机不要跑 `install.sh`。 - `view` 的渲染族(html/screenshot/pdf 等)本环境不可用;要 PDF 用 x2pdf 技能。 diff --git a/skills/office/scripts/office b/skills/office/scripts/office index c1812d4..1f1baf0 100755 --- a/skills/office/scripts/office +++ b/skills/office/scripts/office @@ -92,7 +92,7 @@ try { } if (r.error) { if (r.error.code === 'ENOENT') { - err('office.core binary missing: ' + BIN + '\nLocal install steps: ' + path.resolve(__dirname, '..', 'INSTALL.md') + err('office.core binary missing: ' + BIN + '\nLocal env: ' + path.resolve(__dirname, '..', 'AGENTS.md') + ' (server: docker compose up -d agent-executor-init)'); } err(String(r.error.message || r.error)); diff --git a/skills/x2pdf/AGENTS.md b/skills/x2pdf/AGENTS.md new file mode 100644 index 0000000..351932b --- /dev/null +++ b/skills/x2pdf/AGENTS.md @@ -0,0 +1,30 @@ +# x2pdf:本机环境 + +```sh +SK="$(dirname "$AGENT_SKILLS_DEPS")/x2pdf" +``` + +## 文本类 md / txt / html + +```sh +python3 -m pip install --target "$AGENT_SKILLS_DEPS" -r "$SK/requirements.txt" +brew install pango # macOS;Linux 的系统库见 install.sh +``` + +不装 pango 也能用:技能在 WeasyPrint 不可用时回落 LibreOffice,代价是 `page` 的边距/页码与部分 CSS 不生效。 + +## Office 类 docx / xlsx / pptx / odt / ods / odp + +必须有 LibreOffice(文本类也可用它渲染): + +```sh +brew install --cask libreoffice # macOS:soffice 在 app bundle 内,技能会自己找到 +apt-get install libreoffice-writer libreoffice-calc libreoffice-impress # Linux(镜像已预装) +``` + +## 验证 + +```sh +python3 -c "import weasyprint, markdown" +/Applications/LibreOffice.app/Contents/MacOS/soffice --version +``` diff --git a/skills/x2pdf/INSTALL.md b/skills/x2pdf/INSTALL.md deleted file mode 100644 index 8f78e89..0000000 --- a/skills/x2pdf/INSTALL.md +++ /dev/null @@ -1,33 +0,0 @@ -# 本机安装渲染后端(x2pdf 技能) - -两条渲染路径,依赖各不相同。`requirements.txt` 列的是 Python 包(服务器 init 也按它装)。 -下文「技能目录」= `$(dirname "$AGENT_SKILLS_DEPS")/x2pdf`。 - -## 文本类(md / txt / html):默认 WeasyPrint - -```bash -python3 -m pip install --target "$AGENT_SKILLS_DEPS" -r "$(dirname "$AGENT_SKILLS_DEPS")/x2pdf/requirements.txt" -``` - -WeasyPrint 除了 Python 包,还要系统库 pango/cairo: - -- macOS:`brew install pango` -- Linux:见同目录 `install.sh`(apt 装 那串 `libpango*` / `libcairo2` / 字体) - -**不想装 pango 也行**:装 LibreOffice(见下),技能在 WeasyPrint 不可用时(缺包或缺 pango 符号) -会自动回落到 LibreOffice 渲染文本。代价是 `page` 的边距/页码与大部分 CSS 不生效——够看,不够精确。 - -## Office 类(docx / xlsx / pptx / odt / ods / odp):必须 LibreOffice - -- macOS:`brew install --cask libreoffice` - 装完**不需要**把 `soffice` 加进 `PATH`,技能会自己找 `/Applications/LibreOffice.app/Contents/MacOS/soffice`。 -- Linux:`apt-get install libreoffice-writer libreoffice-calc libreoffice-impress`(服务器镜像已预装)。 - -## 验证 - -```bash -python3 -c "import weasyprint, markdown" # 文本类(走 WeasyPrint) -/Applications/LibreOffice.app/Contents/MacOS/soffice --version # LibreOffice -``` - -两者都没有时,技能会报「这台机器没有可用的 PDF 渲染后端」。装完不需要重启 agent。 diff --git a/skills/x2pdf/SKILL.md b/skills/x2pdf/SKILL.md index a5f9079..b32e560 100644 --- a/skills/x2pdf/SKILL.md +++ b/skills/x2pdf/SKILL.md @@ -90,8 +90,3 @@ output_schema: ```json {"input": "layout.html", "css": "print-override.css"} ``` - -## 环境 - -缺渲染后端时按同目录 `INSTALL.md` 自己装(文本类 WeasyPrint/或 LibreOffice;Office 类必须 LibreOffice)。 -服务器由镜像 + `requirements.txt` / `install.sh` 提供,本机不要跑 `install.sh`。 diff --git a/skills/x2pdf/run.py b/skills/x2pdf/run.py index 975a018..1529829 100644 --- a/skills/x2pdf/run.py +++ b/skills/x2pdf/run.py @@ -51,7 +51,7 @@ def find_soffice(): def req_hint(): - return '安装步骤: %s(依赖清单 requirements.txt)' % (SKILL_DIR / 'INSTALL.md') + return '本机环境: %s' % (SKILL_DIR / 'AGENTS.md') # 默认样式:黑白友好、打印向。字号用 em 相对值,整体缩放只依赖 html font-size # (由 page.font_size 参数注入),因此压单页只需调小字号/边距。