Commit Graph
4 Commits
Author SHA1 Message Date
kicer 4e1c1f36d0 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 绝对路径。
2026-11-11 19:12:01 +08:00
kicer a52b227d8b 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 参数即通过。
2026-11-11 17:34:30 +08:00
kicer 0f9cc241bb feat(image-process): 中文字体候选补 macOS/Windows 路径
原来只认 /usr/share/fonts 下的文泉驿与 Noto,本地端(mac/win)这些路径都不存在,
中文水印直接报「缺少字体」,而英文水印走 load_default 看不出问题。

只扩候选表:Linux 路径仍排前,服务端行为不变;mac 用 Hiragino Sans GB(索引 0 是简体
W3,PingFang.ttc 索引 0 是 HK 字形,Songti 是 Black,依次作为次选),Windows 用雅黑/宋体。
报错文案改成平台中立(传 font 参数指定 TTF/TTC)。

本机实测 info/convert/resize/watermark(en)/slice/grid 均正常,中文水印补装后出图。
2026-11-11 17:23:28 +08:00
kicer 69a1ee0bdf refactor(skills): img-utils 改名 image-process;office 标记 required
- image-process:原名 img-utils 的 "utils" 没有边界,且和 image_task(AI 生成)
  只差一个语义,容易让模型把确定性处理当成生成能力。目录名即技能名
  (listSkills 取 e.name、skillDir 按名解析),同步 SKILL.md、run.py 注释与
  skills/README.md 的两处引用。
- office:加 required: true,避免模型绕过技能自己拼 libreoffice 命令。
2026-10-21 17:22:07 +08:00