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,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。
|
||||
@@ -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。
|
||||
@@ -106,5 +106,5 @@ output_schema:
|
||||
- 本技能**只做确定性图像处理**(转换/缩放/裁剪/压缩/水印/拼图),不含 AI 生成、抠图、换脸、扩图、修复等生成式/语义编辑能力。
|
||||
- 若用户的需求属于"文生图 / AI 修图"等生成式范畴,不要用本技能硬凑,应说明能力边界并推荐第三方工具(豆包、即梦、可灵、Photoshop 等)。
|
||||
- 任何操作都不会覆盖输入原图;输出目录不存在时自动创建。
|
||||
- 中文水印需要字体:优先用 `font` 参数指定;否则依赖系统字体(镜像预装文泉驿)。
|
||||
- 输入依赖 Pillow;本机缺 Pillow 或字体时按同目录 `INSTALL.md` 自己装(服务器由镜像 + `requirements.txt` 提供)。
|
||||
- 中文水印需要字体:优先用 `font` 参数指定;否则依赖系统字体(镜像预装文泉驿,install.sh 会兑底安装)。
|
||||
- 输入依赖预装的 Pillow,无需额外 Python 依赖;系统级字体依赖见 install.sh。
|
||||
|
||||
@@ -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)
|
||||
|
||||
Reference in New Issue
Block a user