用于为Word文档开启并调整修订模式，添加、删除批注等功能

Word 文档处理 (修订模式 + 批注) 概述

Word 文档基于 OOXML 标准，内部结构为 ZIP 包，主要 XML 文件：

word/document.xml - 文档正文内容 word/comments.xml - 批注内容存储 word/设置tings.xml - 文档设置（包含修订模式开关） 快速开始 使用脚本添加修订/批注 手动操作流程 解压文档：unzip -o document.docx -d docx_temp 编辑 XML 文件 重新打包：cd docx_temp && zip -r ../输出.docx . && cd .. && rm -rf docx_temp 功能一：修订模式 (追踪 Changes) 启用修订模式

在 word/设置tings.xml 中添加：

true

添加插入修订 from scripts.追踪_changes 导入 添加_insertion 添加_insertion(doc, "要插入的新内容", author="何大拿")

XML 原理：使用 标签包裹插入内容（绿色下划线）

添加删除修订 from scripts.追踪_changes 导入 添加_deletion 添加_deletion(doc, "要删除的原文", author="何大拿")

XML 原理：使用 标签包裹删除内容（红色删除线）

功能二：批注操作 批注结构

批注涉及两个文件：

word/comments.xml - 存储批注内容 word/document.xml - 存储批注引用位置 快速查看批注 cd /path/to/inbound unzip -o document.docx -d docx_temp cat docx_temp/word/comments.xml

添加批注（XML 级别） Step 1: 解压文档 cd /Users/hansel/.OpenClaw/media/inbound unzip -o document.docx -d docx_temp

Step 2: 编辑 XML

需要修改两个文件：

2.1 修改 comments.xml

找到下一个可用的 comment ID：

grep -o 'w:id="[0-9]*"' docx_temp/word/comments.xml | sed 's/w:id="//;s/"//' | 排序 -n | tAIl -1

假设下一个 ID 是 1，添加新批注：

批注内容

XML 实体转义：& → &，< → <，> → >

2.2 修改 document.xml

在需要添加批注的文本位置添加标记：

这里是正文内容

⚠️ 重要：

和 是 的同级兄弟元素 需要包裹在 中 Step 3: 重新打包 cd docx_temp && zip -r ../输出.docx . && cd .. rm -rf docx_temp

删除批注 从 comments.xml 中删除对应的 元素 从 document.xml 中删除三处标记： 包含 的整个 元素 重新打包 接受批注（将批注内容合并到正文） 从 document.xml 中删除三处批注标记 保留 comments.xml 中的批注内容（可选） 重新打包 批注 XML 详解 comments.xml 结构 批注内容

document.xml 中的批注引用 被批注的文本

注意事项 作者名称：建议使用英文或拼音 日期格式：ISO 8601 格式，如 2026-03-17T14:00:00Z ID 唯一性：每个批注的 ID 必须唯一，且在两个 XML 文件中保持一致 initials：作者名缩写，2个字符为宜