kicer
|
25f9e157ad
|
docs(skills): 排错清单统一成「报错 → 怎么办 → 命令」,office 改为建软链
技能目录的 AGENTS.md 只在报错时被读,所以只写「报错原文 → 怎么办 → 命令」,一节一个
现象,不写背景。命令块前统一声明「仅为示例,具体以本机平台实际情况为准」——路径分隔符、
可执行名、包管理器交给模型按本机情况自愈,不逐平台列出。
office:`command not found` 从按次拼 PATH 前缀改成建一次 $HOME/.local/bin/office 软链。
每条 terminal 命令都是新 shell,前缀不跨命令生效,按次拼的写法容易被反复踩。
image-process:PIL 缺包与「中文水印缺字体」拆成两节。
x2pdf:后端代价表压成三条列表,四个现象(ModuleNotFoundError / 没有可用排版能力 /
could not import some external libraries / 排版降级)各自成节。
document-photo-to-pdf:单节化,保留 fitz 是 pymupdf 的 import 名这条坑。
data-page 只用标准库,不需要 AGENTS.md。
|
2026-11-12 10:05:46 +08:00 |
|
kicer
|
77ef1ec11c
|
feat(skills): office 本地放行 watch、x2pdf 加浏览器后端
office 封装层:本地直跑(AGENT_LOCAL_PICK)没有预览网关,不发 ui_card、
不 POST __pv-touch;watch/unwatch 与 mark/goto 族放行,watch 改后台拉起 +
等端口就绪后报地址退出(前台透传会卡到 terminal 超时)。
x2pdf:文本类分派改为 WeasyPrint → 无头浏览器 → LibreOffice,浏览器后端只需
装了 Chrome 系,不要求用户为转 PDF 现编 pango;CSS/base 注入到 head,无 @page 时
补 A4(浏览器默认 Letter)。吞掉 WeasyPrint 导入失败时裸 print 到 stdout 的告警。
对外文案只讲结果(排版降级/无可用排版能力),实现细节留在 AGENTS.md。
|
2026-11-11 20:50:18 +08:00 |
|
kicer
|
0234bc85e5
|
feat(local): 技能通用规则进提示词,移除 skills/AGENTS.md 中转
- env-local 加两条:长任务后台写日志+10 秒轮询;国内 pip/npm/GitHub/brew 换源
- 4 个技能 AGENTS.md 删掉指向根文档的指针行;pip 命令补 --upgrade
- document-photo-to-pdf:自检未能执行时单独给摘要,不再伪装成「建议确认」
- SKILL.md 示例去掉真实域名,改成 <站点地址>
- 删除 skills/AGENTS.md(根级中转文档,靠出错时翻文件拉不动)
|
2026-11-11 20:15:52 +08:00 |
|
kicer
|
d03d8ba95b
|
docs(skills): AGENTS.md 平台中立化,国内网络换源抽到技能根目录一份
|
2026-11-11 19:38:21 +08:00 |
|
kicer
|
5959b4a674
|
docs(skills): AGENTS.md 改成「现象 → 命令」排错清单
删掉服务器背景、agent-executor-init、SKILL.md 说明之类的旁白。只保留:
报什么错 → 敲什么命令。四份都在 20 行内。
|
2026-11-11 19:13:34 +08:00 |
|
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
|
69e44c27ae
|
feat(x2pdf): 本地可用——LibreOffice 探测覆盖 mac/win 路径,WeasyPrint 缺失时回落
本地形态原先 docx/xlsx/pptx 必失败,原因不是没装 LibreOffice,而是它的可执行文件
不在 PATH 里(macOS 在 app bundle 内、Windows 在 Program Files 内,正常安装都如此),
只用 shutil.which() 会把「装了」误判成「没装」。
- find_soffice(): PATH → macOS 两个 app bundle → Windows 两个默认目录
- 文本分支:WeasyPrint 不可用(ImportError 或缺 libpango 的 OSError)时回落 LibreOffice,
先把文档写成临时 HTML 再走同一个转换函数;返回值带一行后端提示,说明 @page/CSS 只部分生效
- 缺 markdown 包时报错点明依赖清单路径,交给模型按 requirements 自行补装
- requirements.txt:markdown 去掉版本 pin(3.x API 稳定,pin 了反而会在服务端 init
探测失败时往 skills/deps 塞一份遮蔽系统包);weasyprint==65.1 保留,那个 pin 编码的是
pydyf 兼容约束
线上不变:WeasyPrint 在 → 主路径照旧;仅多了一次 fallback 与更宽的 soffice 探测。
本机实测:html/txt 走回落出件正常,md 在缺 markdown 时给出可执行报错。
|
2026-11-11 17:20:45 +08:00 |
|
kicer
|
29e46692fc
|
fix(skill): 参数改回 op/name/args 的扁平结构,压缩描述并修正调用示例
|
2026-10-21 20:53:33 +08:00 |
|
kicer
|
76a0e9ad86
|
refactor(skill): 参数改为动词作键,去掉 op/name/input_args
形状:{"list":"all"} / {"get":"<名>"} / {"run":"<名>","args":{...}},三者恰好给一个。
- 互斥无法用 required 表达,校验与报错回显放在 toolSkill
- list 取值是字符串范围而非布尔,为将来的技能分类留扩展位;今天只认 all
- list/get 带非空 args 一律报错,不静默丢弃
- 旧形状 {op,name,input_args} 仍由 toolSkill 兜底翻译,只为兼容存量技能文档,不再对外文档化
- README/AGENTS/skills 文档与内置技能调用示例同步为新形态
|
2026-10-21 09:25:25 +08:00 |
|
kicer
|
81025a7929
|
优化skills的提示
|
2026-09-29 17:09:01 +08:00 |
|
kicer
|
511c884e2b
|
md2pdf重构为x2pdf:渲染层reportlab→WeasyPrint(md/txt/html)+LibreOffice(docx/xlsx/pptx/odt*),md/txt套默认黑白CSS并页码、html不套仅显式page生效,page/css参数化版式(默认CSS<page<css文件),依赖自带声明(requirements锁weasyprint==65.1/markdown==3.6——62.x对pydyf≥0.11无上界致transform崩,63+已适配;install.sh自检pango/cairo与CJK字体),删md2pdf整目录与cjk.ttf提取逻辑,img-utils改认系统wqy,README范例改指img-utils/x2pdf,system-prompt加PDF一律走x2pdf,技能清单段落格式改为名字:描述(listSkills已排序不动)
|
2026-09-25 16:59:11 +08:00 |
|