用途:该插件是处理 Office 与 PDF 文档的主方法。对 .docx/.doc/.dotx/.xlsx/.xls/.xlsm/.pptx/.ppt/.pdf 及常见图片格式的每次读取与操作(创建、编辑、接受、撤销、历史、回退、评论、修订)都必须经由 officecli,插件会屏蔽对这些扩展名的原生读写工具,绕过会报错。
主要能力:read 可将任意 Office/PDF/图片提取为 markdown 以便先检查再编辑;create/edit 以 markdown 创建或打开既有文件的草稿;diff 生成草稿与真实文件的统一差异;preview 把草稿渲染为 HTML 供人工检查;undo 丢弃草稿且不改动真实文件;list 列出所有活跃草稿;comment、suggestedText、metadata、watermark 等可在草稿上迭代。所有写入都先进入草稿,只有 accept 才落盘并记录版本快照、释放锁。
L1 路径(markdown,约 80% 任务):create 新文件或 edit 打开既有草稿,迭代后 accept 落盘。对非本次会话创建的文档遵循“先建议”规则:从刚读到的 markdown 用 edit 初始化草稿,再以评论加建议文本的方式提出修改;是否采用建议模式不明确时应先询问用户。
L3 路径(保 100% 格式,克隆加替换):clone 源参考文件到目标文件,substitute 以 JSON 映射在文本节点内做保留运行的替换,accept 将草稿 ZIP 原样复制为真实文件,verify-l3 可选校验仅文本节点不同。适用于采购档案等需要格式完全一致的任务。
使用方式:通过 officecli 动作调用;同一机器上的实时 Word 内容可用 read 加 live=true。锁按首次变更惰性获取,accept/undo 释放;默认 24 小时视为过期锁,可 lock-status 查看、force-release 强制释放。
附带格式技能:docx、xlsx、pptx、pdf 四个技能来自 anthropics/skills,含各格式的常见陷阱与辅助脚本;简单标题与管道表格用 officecli 默认样式即可,需要精确版式、公式重算、模板填充或 PDF 表单时应改用对应格式技能。
限制:office/PDF/图片只能走 officecli,原生 read/edit/write 被拦截;直接编辑与本会话无关的草稿仅在用户明确选择该模式时允许;草稿丢失会使文件保持锁定且变更不可见。面向最终用户的报告需用其语言、固定格式,不得粘贴工具输出或内部术语。