按三条原则收紧: 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 参数即通过。
4.0 KiB
4.0 KiB
name, description, required, input_schema, output_schema
| name | description | required | input_schema | output_schema | |||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| x2pdf | 通用 PDF 转换。把 Markdown / HTML / txt / Word / Excel / PPT 转为 PDF | true |
|
|
功能说明
统一 PDF 转换入口,按扩展名自动分派两条渲染路径:
- md / txt / html → WeasyPrint(CSS 排版,字体走 fontconfig,中文用系统文泉驿/Noto,无需字体文件);
本机没有 WeasyPrint(缺包,或缺它依赖的 pango/cairo)时自动回落 LibreOffice——
能出件,但
page/css只部分生效,不适合精确排版 - docx / xlsx / pptx / odt / ods / odp → LibreOffice headless(忠于原文档版式,
page/css参数不生效)
Markdown 输入(.md / .markdown)
- 标准语法之外,支持表格(管道语法)、围栏代码块(```/~~~)、脚注、定义列表、
标题锚点、属性列表、HTML 内联(Markdown
extra全家桶); - 文首 YAML front matter 当元数据剔除,不渲染;
- 图片:相对路径按 输入文件所在目录 解析,也支持绝对路径与 http(s) 图片;
- 自动套用默认 CSS(见下)。
txt 输入(.txt)
- 不解析,按原文转义后整篇以等宽
<pre>渲染(保换行,超长行自动折行)。
HTML 输入(.html / .htm)
- 文档原样渲染,不套默认 CSS——自带
<style>/外链样式即所见即所得; page参数仅在显式传入对应字段时生效(默认不注入@page,避免干扰文档自带版式);css文件作为外部样式表追加在文档自带样式之后,同优先级声明可覆盖文档内样式(用于强制微调);- 渲染媒体默认为
print:文档里只写给screen的样式不生效,请把打印样式写进css文件或@media print。
默认 CSS(md/txt 自动套用)
- 黑白友好:字号分明、浅灰底代码块/表头、隔行底纹表格,不依赖颜色传达信息;
- A4 页脚自动页码(
当前页 / 总页数);标题break-after: avoid不落页尾。
样式优先级(md/txt)
默认 CSS < page 参数(生成 CSS)< css 文件。压单页的常用手法:
page.font_size 调小(如 9pt)+ page.margin 收窄(如 12mm)。
调用方式
通过 skill 的 {"op":"run","name":"x2pdf","args":{...}} 调用,参数:
input:输入文件路径(必填)output:PDF 输出路径(可选,默认与输入同名)css:自定义 CSS 文件路径(可选,仅 md/html/txt)page:{size, margin, font_size}(可选,仅 md/html/txt)
选择建议:简单文档直接写 Markdown 交给本技能,默认样式即可;需要精确控版面 (分页、边距、多栏、黑白打印细节)再写 HTML + CSS。
示例
{"input": "report.md"}
{"input": "cheatsheet.md", "page": {"font_size": "9pt", "margin": "12mm"}}
{"input": "layout.html", "css": "print-override.css"}
环境
缺渲染后端时按同目录 INSTALL.md 自己装(文本类 WeasyPrint/或 LibreOffice;Office 类必须 LibreOffice)。
服务器由镜像 + requirements.txt / install.sh 提供,本机不要跑 install.sh。