办公文档
办公文档由四个独立插件提供，各有各的约束与失败态：Word 文档
profy-docx — docx-js 生成、拆包改 XML、跨 run 文本替换、修订与批注Excel 表格
profy-xlsx — 公式而非硬编码值、零公式错误、财务模型配色规范PDF 文档
profy-pdf — WeasyPrint 生成（强制）+ pypdf/qpdf 处理，含 kami 精排引擎演示文稿
profy-pptx — 原生 .pptx（SVG → DrawingML）与 HTML Deck 两条互斥管线四个插件的共同点
「没有 tools」这一点值得说明：这四个插件不提供”生成 Word 的工具”这类按钮式接口，它们提供的是方法与脚本。好处是能力上限等于沙箱里能跑的一切，而不是被工具签名框死。
选型速查
三条容易走错的岔路
- 要 PDF 却做成了 HTML Deck：HTML Deck 不能导出 PDF（Tailwind + WebGL 渲染不了），需要 PDF 从一开始走 kami。
- 要可编辑 PPT 却自写了转换脚本：自写脚本产出的是图片幻灯片且中文破损，必须走
svg_to_pptx.py。 - 要活表格却拿到了数字快照：Excel 里所有计算都必须留公式，硬编码的结果改一个输入就全错。
一句话把路选对
选型的分歧点不在「什么格式」，而在交付物之后要被谁拿去做什么。把这句写进需求，专家就不会走错管线：共同约束
- 沙箱镜像已预装全部依赖，不要在运行时跑
pip install。import 失败是镜像问题。 - 涉及 LibreOffice 的操作（xlsx 公式重算、doc→docx 转换、接受修订）依赖沙箱内的 LibreOffice。
- 修改已有文件时，原文件的既有约定优先于任何默认规范——你不知道下游依赖了什么。
失败与对策
四个插件各自的细节失败态在各自页面，这里只列跨格式共有的：计费
文档处理的积分消耗来自对话中的模型 Token 使用。文档的生成与下载本身不额外收费。核对日期 2026-08-11。来源：
services/agent-runtime/src/plugins/builtin/{docx,xlsx,pdf,pptx}/plugin.json 及各自 skills/。