thesis-docx.skill

语言 / Language：中文 | English

thesis-docx 是一个面向毕业论文 / 学位论文场景的 skill。

它的重点不是“批量改 Word”，而是让 AI 在论文文档上按更稳的顺序工作：

1. 先检查 Word 自动化环境
2. 先审计，再决定怎么改
3. 学校明确规定的格式严格执行
4. 学校没规定的格式默认保留现状
5. 最后导出 PDF 逐页复核

功能

• 修订 thesis / dissertation Word 文档
• 统一正文、标题、图题注、表题注、参考文献等样式
• 修复目录、页码、分节、交叉引用、图表编号
• 生成基于真实材料的 Mermaid 图
• 生成适合论文使用的代码片段或伪代码，LaTex排版
• 控制论文口吻，避免把 AI 工作过程或元话语写进正文
• 审计 OOXML 隐藏问题，例如：
  • styleId
  • firstLineChars
  • titlePg
  • REF 域显示值
  • section 级页眉页脚引用

运行前提

• Windows 下建议安装桌面版 Microsoft Word
• Python 脚本建议环境具备：
  • python-docx
  • lxml
• Mermaid 渲染建议具备：
  • Node.js
  • mmdc 或可用的 npx

快速开始

# 1) 检查 Word COM/DOM 是否可用
powershell -ExecutionPolicy Bypass -File scripts/check_word_com.ps1 -Json

# 2) 先做 OOXML 审计
python scripts/audit_docx_ooxml.py .\draft.docx --output_json .\draft.audit.json --output_txt .\draft.audit.txt

# 3) 如有需要，先 dry-run 审计样式归一化
powershell -ExecutionPolicy Bypass -File scripts/normalize_word_styles.ps1 -InputPath .\draft.docx -AuditOnly

# 4) 真正修完后导出 PDF，逐页复核
powershell -ExecutionPolicy Bypass -File scripts/export_word_pdf.ps1 -DocPath .\draft.docx -PdfPath .\draft.audit.pdf

使用原则

• 先审计，再修复
• 先修学校明确要求，再处理用户自定义要求
• 不对未规定区域做“全局统一美化”
• 图、代码、架构、流程都必须基于真实材料
• 没做 PDF 逐页复核时，不应直接说“格式已全部完成”

仓库结构

.
├── agents/
├── SKILL.md
├── scripts/
├── references/
├── examples/
├── README.md
├── README_EN.md
└── LICENSE

关键文件

• SKILL.md：主说明
• agents/openai.yaml：界面集成元数据
• scripts/check_word_com.ps1：检查 Word COM/DOM
• scripts/audit_docx_ooxml.py：审计 DOCX / OOXML 隐藏问题
• scripts/normalize_word_styles.ps1：批量样式归一化
• scripts/export_word_pdf.ps1：导出 PDF 做逐页审计
• scripts/render_mermaid_figure.ps1：渲染 Mermaid 图
• references/paper-format-workflow.md：论文格式工作流
• references/failure-patterns-and-quality-gates.md：高风险坑与质量门槛
• references/script-usage.md：脚本使用说明

安装

git clone https://github.com/the-shy123456/thesis-docx.git

保持仓库目录完整即可，不需要拆文件。

Star History

License

MIT

社区

• LINUX DO 社区