#1733·skills

docx validate.py: comments.xml 中存在的注释但没有锚定到任何内容,仍然被视为有效

作者: Dmitry-Kov创建于 2026年9月6日更新于 2026年9月6日

`scripts/office/validate.py` 只检查一个方向的注释标记: 如果 `document.xml` 中的标记引用了不存在的注释,就会报告此情况,并且报告未成对的 `commentRangeStart`/`commentRangeEnd`。相反的情况不会被检查 - `comments.xml` 中的 `<w:comment>` 如果没有 `commentRangeStart`、`commentRangeEnd` 或 `commentReference` 在文档中的任何位置,则会通过。Word 会打开此类文件,而不会发出警告,并且不会显示此注释。这就是 Python-docx 产生的缺陷,当代理分配 `paragraph.text` 时:段落的运行被替换为一个新的运行,注释锚点(位于运行之间)也随之而来。注释存活在 `comments.xml` 中,锚定到没有任何内容。

内容来源: anthropics/skills