thesis-docx

学位论文 DOCX

概述

在处理注重内容质量和格式保真的学位论文 .docx 文件时，请使用此技能。如果任务涉及批量格式设置、样式、题注、分页、目录或交叉引用，请优先使用 Microsoft Word 桌面版自动化，而不是类似 WPS 的替代方案。

此技能旨在避免学位论文编辑中最常见的失败模式：Agent 过早进行大范围格式调整，引入新的版式问题，最后让用户逐一发现。因此，默认操作应当是：

1. 先审查，
2. 区分明确的学校要求与未指定的格式，
3. 只修正有充分依据的问题，
4. 逐页复查后再声称已完成。

工作流

1. 首先检查 Microsoft Word 和 COM/DOM 自动化。
   • 在 Windows 上运行：

   powershell -ExecutionPolicy Bypass -File scripts/check_word_com.ps1 -Json
   

   • 如果缺少 Word、COM 不可用或 DOM 访问失败：
     • 停止自动化程度较高的方案。
     • 告知用户安装桌面版 Microsoft Word。
     • 简要说明，WPS 或类似工具可能会降低论文排版的布局保真度。
2. 编辑前先了解用户的实际约束。
   • 收集论文模板、学校格式指南、截图、现有文档、示例页面以及任何明确的章节规则。
   • 如果用户提供了正式要求，严格遵循。
   • 如果用户没有提供要求，不要臆造学校特定标准。采用保守的学术默认规范，并说明这些是默认规范。
   • 编辑前明确将要求分为两类：
     • must enforce：学校指南、模板、用户确认的样式规则
     • preserve current state：学校指南未规定的任何内容
3. 在进行有风险的大规模编辑之前，审查 DOCX / OOXML。
   • 大规模格式调整前，优先使用 scripts/audit_docx_ooxml.py。
   • 使用该脚本检测隐藏缩进、节错位、过时的 REF 显示文本和样式 ID 不匹配，再决定修复方案。
4. 使用样式进行统一，而不是零散地直接设置格式。
   • 尽可能复用并修复现有样式。
   • 仅在不存在匹配样式时创建新样式。
   • 正文、标题、图题、表题、参考文献、摘要和附录的样式应彼此区分且保持一致。
   • 全局更改任何样式前，检查文档是否包含会在样式更改后仍然保留的段落直接格式设置或 OOXML 覆盖。
5. 仅依据用户提供的事实编辑内容。
   • 仅在用户的主题、证据、代码库、笔记或源材料范围内扩写、润色或重组论文文本。
   • 不要臆造实验数据、系统结构、实体或结果。
   • 不要在论文正文中暴露 Agent 的推理过程或数据输入背景。禁止使用如下论文表述：
     • “根据已有工程”
     • “根据现有代码”
     • “将任务书和代码喂给模型后”
     • “通过分析用户提供的代码”
     • 任何听起来像 AI 工作流备注，而非论文正文的措辞
   • 使用正常的论文语气，而非提示词工程语气、评审语气或思维链语气。
   • 优先采用中性的学术叙述，读起来像学生撰写的内容，例如：“本文设计并实现了……”“系统采用了……”“在该模块中……”
   • 避免对文本如何生成、推断或整理做一阶元解释。
6. 仅在源材料充分时生成图表。
   • 使用 Mermaid 绘制架构图、E-R 图、流程图、状态图及类似的论文插图。
   • 每个节点、字段、关系和依赖都必须以用户提供的真实材料为依据，例如代码、SQL 架构、API 文档、项目文档或论文草稿本身。
   • 如果材料不足，应拒绝臆造图表，并询问缺少的源信息。
7. 需要在论文中摘录代码时，按照 LaTeX 规范排版代码。
   • 仅保留与论述相关的代码。
   • 保留用户代码或设计中的真实标识符。
   • 避免仅为显得完整而编写合成的填充代码。
8. 在宣称完成前进行审查。
   • 先进行结构审查：样式、节、题注、参考文献、页码方案、交叉引用、隐藏的段落覆盖。
   • 然后从 Word 导出文档为 PDF，并逐页检查。
   • 只有在 PDF 级审查通过，或明确说明仍需进行的人工视觉检查后，才能表示任务已完成。

样式策略

• 将样式视为格式设置的唯一依据。
• 优先使用以下逻辑样式类别：
  • Body Text
  • Heading 1 / Heading 2 / Heading 3
  • Figure Caption
  • Table Caption
  • References
  • Abstract
  • Keywords
  • Appendix Title
• 如果文档已有对应样式，请将其映射到这些样式，并统一其字体、间距、缩进和编号行为。
• 如果直接格式设置与样式冲突，请减少直接格式设置，让文档重新由样式控制。
• 不要全局统一学校指南未规定的部分。以下是越界操作的高风险示例：
  • 用户只要求调整标题时，却重新设计页眉或页脚
  • 任务只涉及参考文献时，却更改代码框的外观
  • 学校指南未对表格内部格式作出规定时，却统一调整表格内部格式
• 如果样式统一后仍存在视觉问题，请检查隐藏的 OOXML 状态，例如 firstLineChars、编号缩进、titlePg、differentFirstPageHeaderFooter、REF 字段显示文本以及直接运行格式设置。

审核优先原则

批量编辑前，先拟定并在整个过程中遵循如下检查清单：

1. 学校指南明确规定了哪些部分？
2. 用户自定义了哪些规范？
3. 当前哪些部分符合要求，必须保留？
4. 哪些问题属于结构性问题，哪些仅属于视觉问题？
5. 哪些修复可以通过样式安全完成？
6. 哪些修复需要通过 Word COM 或 OOXML 层面进行处理？

不要仅因结构审核结果良好就宣称“已完成”。对于论文工作，分页和页面级渲染也是正确性的一部分。

高风险陷阱

大规模格式调整前，请阅读 references/failure-patterns-and-quality-gates.md。尤其要注意避免以下问题：

• 样式名称看似正确，实际却映射到了错误的样式 ID
• 段落级直接格式设置覆盖了预期样式
• firstLineChars 或编号缩进造成不可见的额外缩进
• 目录字段或交叉引用字段显示过时的文本
• 节级首页设置导致页眉或页码缺失
• Word 与 WPS 在表格行高、垂直对齐和代码框标题裁切方面存在差异
• 标点规范化意外改写 DOI、URL、代码或英文参考文献

视觉审核规则

对于对学校格式要求敏感的论文工作，最终验证应优先按以下顺序进行：

1. 使用 Word COM/DOM 检查结构
2. 使用 Word 导出为 PDF
3. 逐页检查 PDF
4. 然后再撰写最终交付说明

如果无法验证页面渲染情况，请明确说明，而不要暗示格式已得到全面验证。

插图规则

• 如果论文需要插图，且图示结构能够追溯到真实来源材料，请使用 Mermaid。
• 图示应保持学术中立且简洁。
• 避免使用装饰性标签、聊天式标注和推测性实体。
• 除非用户使用的术语与实际材料冲突，否则应沿用用户的术语。
• 生成图示前，请阅读 references/figure-and-code-rules.md。

论文文风规则

生成或改写正文前，请阅读 references/thesis-voice-and-style.md。尤其要注意：

• 论文正文应具有论文文风，而不是关于 AI 如何推理的笔记
• 优先采用面向学生的学术叙述，而非审稿式的元评论
• 不要在最终论文文本中透露资料输入、代码导入或分析步骤的存在

定稿论文正文前，请快速自查：

1. 段落描述的是系统或研究本身，而不是助手如何推断出结论吗？
2. 段落听起来像论文叙述，而不是提示词备注吗？
3. 段落是否避免了“根据现有代码”“根据已有工程”“通过分析用户提供的代码”等类似工作流表述？
4. 即使读者不知道有 AI 参与起草，这句话依然通顺吗？

代码清单规则

• 如果论文包含代码清单，优先采用面向 LaTeX 的代码呈现方式。
• 确保清单忠实于实际代码。
• 如果非必要样板代码无助于支撑论文论点，则将其删减。
• 如果用户指定了 LaTeX 软件包或清单样式，请遵照要求。

资源指南

• scripts/check_word_com.ps1
  • 检测 Microsoft Word 桌面版以及 COM/DOM 自动化是否可用。
• scripts/audit_docx_ooxml.py
  • 在进行高风险格式更改前，审查 DOCX 样式、直接缩进、分节设置、编号和 REF 字段行为。
• scripts/normalize_word_styles.ps1
  • 通过 Word COM 自动化，批量规范论文正文、标题 1-3、图题和表题。
• scripts/export_word_pdf.ps1
  • 通过 Word COM 将当前论文文档导出为 PDF，以便逐页审阅。
• scripts/render_mermaid_figure.ps1
  • 将 Mermaid 源码渲染为适用于论文的 SVG、PNG 或 PDF 图表素材。
• references/paper-format-workflow.md
  • 阅读此文件，了解标准的 Word 论文格式工作流。
• references/figure-and-code-rules.md
  • 在生成 Mermaid 图表或 LaTeX 代码清单前阅读此文件。
• references/thesis-voice-and-style.md
  • 在生成或改写论文正文前阅读此文件。
• references/failure-patterns-and-quality-gates.md
  • 在进行大规模格式调整或声称论文已完成全面检查前阅读此文件。
• references/script-usage.md
  • 阅读此文件，了解命令示例和配置文件约定。

最终检查

• 确认编辑后文档仍由样式驱动。
• 确认题注、编号、分页符和目录协调一致。
• 确认交叉引用显示的是当前目标标签，而非过时的字段文本。
• 确认分节设置不会在无提示的情况下移除首页页眉或页码。
• 确认参考文献格式符合学校要求，且标点规范化没有损坏 DOI 或英文参考文献。
• 确认每张图表和每段代码都以用户提供的材料为依据。
• 导出为 PDF 并检查每一页，然后再声明格式已完成。
• 如果无法使用 Word 自动化或进行 PDF 验证，请明确警告版式保真度无法保证。