refactor(skills): 本地安装改成「README 式说明」,install.sh/requirements.txt 归服务器
按三条原则收紧: 1) 线上零影响:office/install.sh 回退成原来的 linux-only 版本(本地本来就不该跑它); image-process 的字体候选表撤回(那是在代码里写环境兼容,方向错了)。 2) install.sh / requirements.txt 只做服务器工件:镜像构建与 agent-executor-init 读它们, 行为一字未变。 3) 本机缺东西时由 .md 指路,模型自己去装:四个技能各加 INSTALL.md(具体命令 + 平台 资产/字体表 + 验证方式),并在 SKILL.md 里各加一行指向它(skill get 就能看到)。 报错文案带上 INSTALL.md 的绝对路径,所以「撞到缺依赖」的那一刻就能拿到说明书。 保留的两处代码钩子都不是环境探测,而是「说明书里写的安装方式得真能生效」: - office: start.sh 把 skills/office/scripts 塞进 PATH(本地没 root 写 /usr/local/bin); 封装层 ENOENT 指向 INSTALL.md。 - x2pdf: find_soffice() 探 macOS app bundle(brew cask 装的 soffice 不在 PATH); WeasyPrint 不可用时回落 LibreOffice,让本地只需一个后端而不是 pango+WeasyPrint 两条链。 INSTALL.md 里 officecli 指向 releases/latest(它会自更新,实测 1.0.157 跑一次变 1.0.160), 不要求与服务器 pin 对齐。 实测:office --version / office create / office view outline 正常;x2pdf 缺 markdown 与 image-process 缺字体两条报错都给出 INSTALL.md 绝对路径,按 font 参数即通过。
This commit is contained in:
@@ -0,0 +1,30 @@
|
||||
# 本机安装依赖与字体(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。
|
||||
Reference in New Issue
Block a user