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:
@@ -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,可选)
|
||||
@@ -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` 里。
|
||||
@@ -59,7 +59,3 @@ input_schema:
|
||||
- 一图一纸;同框多纸只取最大。
|
||||
- 建议 ≤20 页;更多或 300dpi 可能超 120s,可分批。
|
||||
- `out/` 里的原图是自然尺寸(不缩放、不调色),页与页尺寸可能不同;PDF 仍按纸张/批次统一。
|
||||
|
||||
## 环境
|
||||
|
||||
缺 Python 依赖时按同目录 `INSTALL.md` 自己装(服务器由镜像 + `requirements.txt` 提供)。
|
||||
|
||||
Reference in New Issue
Block a user