SuperAPI AI 工具集

docx-processing-superdoc

办公与效率

查看项目

更新于 10-15 23:49

技能介绍

用途:SuperDoc CLI(v1)用于处理 DOCX 文档,可读取、搜索、修改、批注和审阅 Word 文件。优先使用 v1 命令(规范操作及其辅助封装),除非明确需要 v0 式批量工作流,否则不要默认使用旧命令。已安装则用 superdoc,否则回退到 npx @superdoc-dev/cli@latest。

主要能力:查询与检查(find、query match、blocks list、get-node、get-text、get-markdown、get-html);修改(replace、insert、delete、blocks delete、mutations apply、create paragraph、create heading);格式(format apply、format bold/italic/underline/strikethrough);列表(lists list/get/insert/indent/outdent/set-level/set-type/convert-to-text);批注(comments add/reply/get/list/edit/resolve/move/set-internal/delete);修订跟踪(track-changes list/get/accept/reject/accept-all/reject-all);历史(history get/undo/redo);底层调用(call <operationId> --input-json)。

使用方式:未知命令或参数先用 superdoc describe、superdoc describe command find 等查看运行时元数据。有状态多步编辑推荐:superdoc open ./contract.docx,再用 query match 定位修改目标(返回精确地址与基数保证),replace 修改,save --in-place,close。省略 <doc> 时命令作用于活动/默认会话,可用 session list|set-default|save|close 控制;脏状态 close 需 --discard 或先保存。无状态一次性读取用 get-text/get-markdown/info;无状态修改需提供 --out(除非 --dry-run)。修改前可用 --dry-run 预览,有状态修改可用 --expected-revision 做乐观并发检查。

限制:并非所有命令都支持 --*-file 变体,需用 describe command <name> 确认;--target-json 无对应 --target-file,可用 --block-id、--start、--end 等扁平参数替代。默认输出 JSON 信封,--pretty 不支持 call。旧版 v0.x 桥接命令(search、replace-legacy、read)仅在需要 v0 行为时使用。其他细节暂未提供。