以标准和证据为骨架，以四种 DOCX 交付路径为输出，把项目源码、学校模板、往届样文、文献和截图整合成可追溯、可续写、可检查的中文本科论文交付工作台。

chinese-thesis-workbench 不是一键生成论文的工具。它是一套论文标准化交付工作台，把毕业论文拆成可审查、可回退的步骤——收集材料 → 选择交付路径 → 构建证据 → 确认大纲 → 分章写作 → 生成/填充/编辑 DOCX → 质量检查。

核心原则：能复制/编辑就保留原 DOCX 格式，不能复制时再生成结构清晰的默认格式文档。

• 有真实项目（软件系统、实验、调研等）需要写成毕业论文的学生
• 需要控制章节字数、管理图表截图、核验参考文献的用户
• 需要严格匹配学校模板格式的用户
• 导师批注后需要系统化修订、且不能丢失已有排版格式的用户
• 素材不足、需要联网检索同领域文献或头脑风暴写作思路的用户

• 没有真实项目或数据、希望凭空生成论文的用户
• 纯文科论文可参考流程但需重配证据链

v1.0.0 起提供四种路径，用户 intake 阶段选择并记录到 user-decisions.md：

M3 是格式要求严格的学校的推荐路径——它复制模板后只做文本替换和插入，模板的 styles.xml、页眉页脚、分节符全部原封不动。M2 是轻量近似，不承诺模板复刻。

# 1. 安装 Python 依赖
pip install -r requirements.txt

# 2. 初始化论文工作区
python scripts/workspace/init_thesis_workspace.py <你的论文项目目录>

# 3. 编辑模板
#    <项目目录>/thesis-ai-standard/templates/standard-profile.yaml

# 4. 在 Claude Code 中加载本 skill，告诉 AI：
#    "帮我把这个项目整理成一篇结构完整的毕业论文"

# 先用 analyze_docx.py 分析模板结构（可选但推荐）
python scripts/docx/analyze_docx.py 学校模板.docx --json-out result.json

# 从 markdown 论文 + 学校模板生成填充好的 docx
python scripts/docx/apply_textual_edits.py --from-template 学校模板.docx \
  --thesis-md paper-output/<论文标题>.md \
  --spec thesis-ai-standard/templates/thesis-ai-spec.yaml \
  --out paper-output/<论文标题>.docx

模板原文件不被修改。输出报告 paper-output/<论文标题>-template-fill-report.md 列出已替换的占位、未匹配字段和章节插入位置。

python scripts/docx/analyze_docx.py 样文.docx --json-out paper-context/workflow/sample-docx-analysis.json
python scripts/docx/generate_thesis_docx.py thesis.md output/thesis.docx \
  --sample-analysis paper-context/workflow/sample-docx-analysis.json

高置信度（sample_count ≥ 3）的样式值会被合并进默认 profile。低频出现但高置信的类别（如标题、摘要标题）降为 sample_count ≥ 1 即可采用。

python scripts/docx/apply_textual_edits.py draft.docx draft-edited.docx \
  --replace "原文锚点" "新文本" \
  --insert-after "锚点段落" "新增段落" \
  --delete "要删除的段落锚点"

只改段落文本，不重建样式。锚点命中 0 次或多于 1 次时报错退出。

python scripts/docx/analyze_docx.py 学校模板.docx --json-out result.json
python scripts/workspace/build_sample_template_outputs.py result.json --target <项目目录>

工作流初始化后在 paper-context/workflow/ 下生成五类控制文件：

详细规则和工作流见 SKILL.md。

当材料摄入后发现素材过少（两个以上必需材料缺失、文献池为空、或证据仅停留在 README 级别），工作台不会直接阻断，而是走 material-gap-handoff 流程：

1. 联网检索：征得用户同意后，检索近五年同领域文献，写入 paper-context/literature/web-suggested.md（标记 needs_check），不直接加入参考文献。
2. 头脑风暴：征得用户同意后启动头脑风暴，写作思路只写入 content-decisions.md 的候选区，供用户审批取舍。
3. 用户确认的进入大纲和正文；拒绝的标记 discarded，论文正文、spec、图表注册表都不会引用。
4. 用户拒绝联网检索和头脑风暴的，记录到 blocker-report.md，在可见限制下继续推进。

治理侧 paper-context/
  workflow/         用户仪表盘、材料清单、内容取舍、阻断报告、用户决策、进度日志
  evidence/         项目证据、技术栈、数据库 Schema、API 列表
  literature/       参考文献抽取、交叉引用、联网检索建议
  standards/        标准解析、样式提取
  aigc/             AIGC 风格报告
  word-comments/    导师批注待办和修订记录

交付侧 paper-output/
  <论文标题>.md                       Markdown 源稿
  <论文标题>.docx                     主论文（默认格式 / 样文贴近 / 模板填充）
  <论文标题>-附件.docx               附件（图源码等）
  <论文标题>-template-fill-report.md 模板填充报告（仅 M3）
  <论文标题>-image-map.json          图片映射
  <论文标题>-文献核验清单.json       参考文献核验
  figures/                            图表
  screenshots/                        截图

chinese-thesis-workbench/
  SKILL.md                  Skill 路由入口
  README.md                 本文件
  requirements.txt          Python 依赖
  package.json              Node.js 依赖（截图）

  references/              按需加载的参考文档
    workflow/              工作流、状态管理、阻断、质量门禁、素材稀缺交接
    standards/             标准解析、样式提取、默认格式
    evidence/              源码证据、文献治理、事实提取
    writing/               样文分析、章节写作、参考文献选择、AIGC 治理
    delivery/              DOCX 成稿（含四种路径）、最终检查、Word 批注修订

  scripts/                 可执行脚本
    workspace/             工作区初始化、工作流日志、分析结果归并
    evidence/              项目证据构建
    literature/            PDF 参考文献抽取、交叉引用、候选池
    docx/                  DOCX 分析、生成、模板填充、文本编辑、批注抽取
    figures/               Mermaid 渲染、图表资产检查、图片映射
    screenshots/           截图占位提取、截图计划、浏览器截图
    review/                章节字数统计、AIGC 风格分析

  assets/thesis-ai-standard/
    templates/             结构化配置模板（YAML）
    drawio/                图表模板（6 张）

  tests/                   核心合约测试（9 个）

• 新增 scripts/docx/apply_textual_edits.py（466 行）—— M3 + M4 文本编辑内核
• 新增 references/workflow/material-gap-handoff.md（9 行）—— 素材稀缺流程
• 修改 scripts/docx/generate_thesis_docx.py —— 新增 sample_style_override + --sample-analysis 参数
• 修改 SKILL.md —— 4 处更新（交付路径、格式例外、硬规则、资源映射）
• 修改 references/workflow/intake.md —— 新增四选一交付路径问题
• 修改 references/delivery/docx-delivery.md —— 四种模式说明和命令示例
• 修改 references/delivery/word-comment-revision-workflow.md —— 追加 M4 文本编辑模式一节
• 修改 tests/test_core_contracts.py —— 新增 4 个测试

• M1 默认路径代码零改动，build_doc() 一行未变
• load_style_profile() 无参调用行为与 v2.x 完全一致
• v2.x 所有 5 个测试在新版中全部通过
• 无新增 Python 依赖（pyyaml 已在 requirements.txt 中）

Node.js 和 Playwright 仅自动截图功能需要：

npm install && npm run install:browsers

# Python 编译检查
python -m compileall scripts tests

# 单元测试（当前 9 个）
python -m unittest discover tests

# 工作区模板校验
python scripts/workspace/check_thesis_workspace.py assets/thesis-ai-standard

本 skill 参考了以下两个项目：

MIT License

• xiaou61/thesis-skills — 提供标准与证据骨架
• Doryoku1223/lunwen-skill — 提供中文论文成稿引擎

感谢两个项目的作者为中文毕业论文标准化写作做出的贡献。