[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-11258":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":9,"language":10,"languages":9,"totalLinesOfCode":9,"stars":11,"forks":12,"watchers":13,"openIssues":14,"contributorsCount":15,"subscribersCount":15,"size":15,"stars1d":16,"stars7d":17,"stars30d":18,"stars90d":15,"forks30d":15,"starsTrendScore":19,"compositeScore":20,"rankGlobal":9,"rankLanguage":9,"license":21,"archived":22,"fork":22,"defaultBranch":23,"hasWiki":24,"hasPages":22,"topics":25,"createdAt":9,"pushedAt":9,"updatedAt":26,"readmeContent":27,"aiSummary":28,"trendingCount":15,"starSnapshotCount":15,"syncStatus":29,"lastSyncTime":30,"discoverSource":31},11258,"chinese-thesis-workbench-skill","ZyhSechub\u002Fchinese-thesis-workbench-skill","ZyhSechub","本科毕业论文skill：会把你的项目的源码、数据库、截图和文献，按学校模板与样文风格，工程化地写成整合成可追溯、可续写、可审查的本科毕业论文",null,"Python",457,21,42,1,0,16,51,289,48,94.03,"MIT License",false,"main",true,[],"2026-06-12 04:00:54","# chinese-thesis-workbench\n\n> 以标准和证据为骨架，以四种 DOCX 交付路径为输出，把项目源码、学校模板、往届样文、文献和截图整合成可追溯、可续写、可检查的中文本科论文交付工作台。\n\n[![Skill Type](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FCodex-Skill-blue)](https:\u002F\u002Fcodex.claude.ai)\n[![Language](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FLanguage-中文-red)]()\n\n---\n\n## 定位\n\n**chinese-thesis-workbench** 不是一键生成论文的工具。它是一套论文标准化交付工作台，把毕业论文拆成可审查、可回退的步骤——收集材料 → 选择交付路径 → 构建证据 → 确认大纲 → 分章写作 → 生成\u002F填充\u002F编辑 DOCX → 质量检查。\n\n核心原则：**能复制\u002F编辑就保留原 DOCX 格式，不能复制时再生成结构清晰的默认格式文档**。\n\n### 适合\n\n- 有真实项目（软件系统、实验、调研等）需要写成毕业论文的学生\n- 需要控制章节字数、管理图表截图、核验参考文献的用户\n- 需要严格匹配学校模板格式的用户\n- 导师批注后需要系统化修订、且不能丢失已有排版格式的用户\n- 素材不足、需要联网检索同领域文献或头脑风暴写作思路的用户\n\n### 不适合\n\n- 没有真实项目或数据、希望凭空生成论文的用户\n- 纯文科论文可参考流程但需重配证据链\n\n---\n\n## 四种 DOCX 交付路径\n\nv1.0.0 起提供四种路径，用户 intake 阶段选择并记录到 `user-decisions.md`：\n\n| 路径            | 输入                                  | 输出          | 格式策略                                |\n| ------------- | ----------------------------------- | ----------- | ----------------------------------- |\n| **M1** 默认样式生成 | Markdown                            | 全新 `.docx`  | 内置默认格式（宋体小四正文、黑体标题）                 |\n| **M2** 样文版式贴近 | Markdown + 样文分析 JSON                | 全新 `.docx`  | 从样文提取高置信度字号\u002F字体\u002F缩进，deep_merge 进默认值   |\n| **M3** 模板副本填充 | Markdown + 学校模板 `.docx` + spec YAML | 模板副本被填充     | 复制模板 OOXML 底座，仅替换占位文本 + 插入章节正文，不动样式 |\n| **M4** 已有稿编辑  | 初稿 `.docx` + 编辑指令                   | 同一份 `.docx` | 只改段落文本，不动 pPr\u002FrPr\u002FsectPr\u002F批注         |\n\n**M3 是格式要求严格的学校的推荐路径**——它复制模板后只做文本替换和插入，模板的 styles.xml、页眉页脚、分节符全部原封不动。M2 是轻量近似，不承诺模板复刻。\n\n---\n\n## 快速开始\n\n```powershell\n# 1. 安装 Python 依赖\npip install -r requirements.txt\n\n# 2. 初始化论文工作区\npython scripts\u002Fworkspace\u002Finit_thesis_workspace.py \u003C你的论文项目目录>\n\n# 3. 编辑模板\n#    \u003C项目目录>\u002Fthesis-ai-standard\u002Ftemplates\u002Fstandard-profile.yaml\n\n# 4. 在 Claude Code 中加载本 skill，告诉 AI：\n#    \"帮我把这个项目整理成一篇结构完整的毕业论文\"\n```\n\n### M3 学校模板副本填充\n\n```powershell\n# 先用 analyze_docx.py 分析模板结构（可选但推荐）\npython scripts\u002Fdocx\u002Fanalyze_docx.py 学校模板.docx --json-out result.json\n\n# 从 markdown 论文 + 学校模板生成填充好的 docx\npython scripts\u002Fdocx\u002Fapply_textual_edits.py --from-template 学校模板.docx \\\n  --thesis-md paper-output\u002F\u003C论文标题>.md \\\n  --spec thesis-ai-standard\u002Ftemplates\u002Fthesis-ai-spec.yaml \\\n  --out paper-output\u002F\u003C论文标题>.docx\n```\n\n模板原文件不被修改。输出报告 `paper-output\u002F\u003C论文标题>-template-fill-report.md` 列出已替换的占位、未匹配字段和章节插入位置。\n\n### M2 样文版式贴近\n\n```powershell\npython scripts\u002Fdocx\u002Fanalyze_docx.py 样文.docx --json-out paper-context\u002Fworkflow\u002Fsample-docx-analysis.json\npython scripts\u002Fdocx\u002Fgenerate_thesis_docx.py thesis.md output\u002Fthesis.docx \\\n  --sample-analysis paper-context\u002Fworkflow\u002Fsample-docx-analysis.json\n```\n\n高置信度（sample_count ≥ 3）的样式值会被合并进默认 profile。低频出现但高置信的类别（如标题、摘要标题）降为 sample_count ≥ 1 即可采用。\n\n### M4 已有初稿编辑\n\n```powershell\npython scripts\u002Fdocx\u002Fapply_textual_edits.py draft.docx draft-edited.docx \\\n  --replace \"原文锚点\" \"新文本\" \\\n  --insert-after \"锚点段落\" \"新增段落\" \\\n  --delete \"要删除的段落锚点\"\n```\n\n只改段落文本，不重建样式。锚点命中 0 次或多于 1 次时报错退出。\n\n### 样文\u002F模板分析（所有路径通用）\n\n```powershell\npython scripts\u002Fdocx\u002Fanalyze_docx.py 学校模板.docx --json-out result.json\npython scripts\u002Fworkspace\u002Fbuild_sample_template_outputs.py result.json --target \u003C项目目录>\n```\n\n---\n\n## 核心能力\n\n### 标准与证据\n\n| 能力        | 说明                                 |\n| --------- | ---------------------------------- |\n| 材料摄入      | 按必需\u002F建议\u002F可选分级，说明缺失影响和是否可继续           |\n| 项目证据提取    | 按论文类型从源码、数据库、API、测试、实验数据中生成证据索引    |\n| 文献治理      | PDF 参考文献抽取 → 候选池 → 核验 → 格式化 → 核验清单 |\n| 素材稀缺处置    | 素材不足时征得用户同意，联网检索同领域文献或头脑风暴写作思路     |\n| AIGC 风格治理 | 减少空泛表达，不伪造事实                       |\n| Word 批注修订 | 抽取导师批注，逐条修订并记录变更日志                 |\n\n### 论文成稿\n\n| 能力      | 说明                                                   |\n| ------- | ---------------------------------------------------- |\n| 样文分析    | 提取往届样文的目录结构、章级字数、图表节奏和段落样式                           |\n| 模板分析    | 提取学校模板的页面设置、样式定义和段落格式特征                              |\n| 章节控字    | 写作前定预算，写完统计，超出自动压缩                                   |\n| 图表      | 支持 Mermaid \u002F PlantUML \u002F draw.io 三种图源；Playwright 自动截图 |\n| DOCX 成稿 | 四种交付路径：默认生成 \u002F 样文贴近 \u002F 模板填充 \u002F 初稿编辑                     |\n| 模板填充报告  | M3 输出已替换占位、未匹配字段、章节配对方法、需人工核对项                       |\n| 公式      | 支持 LaTeX 文本保留或图片插入两种模式                               |\n| 文件命名    | 所有交付物使用论文标题命名                                        |\n\n### 用户可见性\n\n工作流初始化后在 `paper-context\u002Fworkflow\u002F` 下生成五类控制文件：\n\n| 文件                      | 作用                       |\n| ----------------------- | ------------------------ |\n| `user-dashboard.md`     | 当前进度、待确认事项、下一步建议         |\n| `material-inventory.md` | 材料等级、缺失影响、是否可继续          |\n| `content-decisions.md`  | 候选内容的取舍：正文重点\u002F简写\u002F附录\u002F暂缓\u002F不写 |\n| `blocker-report.md`     | 阻断原因、影响范围、可选路径、是否可有限继续   |\n| `user-decisions.md`     | 用户已确认的关键选择归档（含交付路径选择）    |\n\n详细规则和工作流见 [SKILL.md](SKILL.md)。\n\n### 素材稀缺与头脑风暴\n\n当材料摄入后发现素材过少（两个以上必需材料缺失、文献池为空、或证据仅停留在 README 级别），工作台不会直接阻断，而是走 `material-gap-handoff` 流程：\n\n1. **联网检索**：征得用户同意后，检索近五年同领域文献，写入 `paper-context\u002Fliterature\u002Fweb-suggested.md`（标记 `needs_check`），不直接加入参考文献。\n2. **头脑风暴**：征得用户同意后启动头脑风暴，写作思路只写入 `content-decisions.md` 的候选区，供用户审批取舍。\n3. 用户确认的进入大纲和正文；拒绝的标记 `discarded`，论文正文、spec、图表注册表都不会引用。\n4. 用户拒绝联网检索和头脑风暴的，记录到 `blocker-report.md`，在可见限制下继续推进。\n\n---\n\n## 架构\n\n```\n治理侧 paper-context\u002F\n  workflow\u002F         用户仪表盘、材料清单、内容取舍、阻断报告、用户决策、进度日志\n  evidence\u002F         项目证据、技术栈、数据库 Schema、API 列表\n  literature\u002F       参考文献抽取、交叉引用、联网检索建议\n  standards\u002F        标准解析、样式提取\n  aigc\u002F             AIGC 风格报告\n  word-comments\u002F    导师批注待办和修订记录\n\n交付侧 paper-output\u002F\n  \u003C论文标题>.md                       Markdown 源稿\n  \u003C论文标题>.docx                     主论文（默认格式 \u002F 样文贴近 \u002F 模板填充）\n  \u003C论文标题>-附件.docx               附件（图源码等）\n  \u003C论文标题>-template-fill-report.md 模板填充报告（仅 M3）\n  \u003C论文标题>-image-map.json          图片映射\n  \u003C论文标题>-文献核验清单.json       参考文献核验\n  figures\u002F                            图表\n  screenshots\u002F                        截图\n```\n\n---\n\n## 目录\n\n```\nchinese-thesis-workbench\u002F\n  SKILL.md                  Skill 路由入口\n  README.md                 本文件\n  requirements.txt          Python 依赖\n  package.json              Node.js 依赖（截图）\n\n  references\u002F              按需加载的参考文档\n    workflow\u002F              工作流、状态管理、阻断、质量门禁、素材稀缺交接\n    standards\u002F             标准解析、样式提取、默认格式\n    evidence\u002F              源码证据、文献治理、事实提取\n    writing\u002F               样文分析、章节写作、参考文献选择、AIGC 治理\n    delivery\u002F              DOCX 成稿（含四种路径）、最终检查、Word 批注修订\n\n  scripts\u002F                 可执行脚本\n    workspace\u002F             工作区初始化、工作流日志、分析结果归并\n    evidence\u002F              项目证据构建\n    literature\u002F            PDF 参考文献抽取、交叉引用、候选池\n    docx\u002F                  DOCX 分析、生成、模板填充、文本编辑、批注抽取\n    figures\u002F               Mermaid 渲染、图表资产检查、图片映射\n    screenshots\u002F           截图占位提取、截图计划、浏览器截图\n    review\u002F                章节字数统计、AIGC 风格分析\n\n  assets\u002Fthesis-ai-standard\u002F\n    templates\u002F             结构化配置模板（YAML）\n    drawio\u002F                图表模板（6 张）\n\n  tests\u002F                   核心合约测试（9 个）\n```\n\n---\n\n## 与上一版本（v0.1.0）的比较\n\n### 功能差异\n\n| 功能                     | v0.1.0               | v1.0.0                                   |\n| ---------------------- | -------------------- | ---------------------------------------- |\n| DOCX 生成                | 仅默认样式                | 四种路径（M1\u002FM2\u002FM3\u002FM4）                        |\n| 学校模板处理                 | 只能分析，格式靠用户手动贴        | M3 复制模板底座直接填充文本                          |\n| 样文样式利用                 | 分析后不进生成器             | M2 `--sample-analysis` 直通生成器             |\n| 已有初稿编辑                 | 不支持                  | M4 `--replace\u002F--insert\u002F--delete`         |\n| 素材稀缺场景                 | `stop_and_report` 阻断 | 可征得同意后联网检索 \u002F 头脑风暴                        |\n| `load_style_profile()` | 无参数，只返回默认值           | 可选 `sample_analysis` 参数，deep_merge 高置信样式 |\n| 测试数量                   | 5 个                  | 9 个                                      |\n\n### 改动范围\n\n- **新增** `scripts\u002Fdocx\u002Fapply_textual_edits.py`（466 行）—— M3 + M4 文本编辑内核\n- **新增** `references\u002Fworkflow\u002Fmaterial-gap-handoff.md`（9 行）—— 素材稀缺流程\n- **修改** `scripts\u002Fdocx\u002Fgenerate_thesis_docx.py` —— 新增 `sample_style_override` + `--sample-analysis` 参数\n- **修改** `SKILL.md` —— 4 处更新（交付路径、格式例外、硬规则、资源映射）\n- **修改** `references\u002Fworkflow\u002Fintake.md` —— 新增四选一交付路径问题\n- **修改** `references\u002Fdelivery\u002Fdocx-delivery.md` —— 四种模式说明和命令示例\n- **修改** `references\u002Fdelivery\u002Fword-comment-revision-workflow.md` —— 追加 M4 文本编辑模式一节\n- **修改** `tests\u002Ftest_core_contracts.py` —— 新增 4 个测试\n\n### 向后兼容\n\n- M1 默认路径代码零改动，`build_doc()` 一行未变\n- `load_style_profile()` 无参调用行为与 v2.x 完全一致\n- v2.x 所有 5 个测试在新版中全部通过\n- 无新增 Python 依赖（`pyyaml` 已在 requirements.txt 中）\n\n---\n\n## 依赖\n\n| 包                      | 用途            |\n| ---------------------- | ------------- |\n| `python-docx`          | DOCX 生成、分析、编辑 |\n| `PyYAML`               | YAML 配置读写     |\n| `pypdf` \u002F `pdfplumber` | PDF 解析        |\n\nNode.js 和 Playwright 仅自动截图功能需要：\n\n```powershell\nnpm install && npm run install:browsers\n```\n\n---\n\n## 验证\n\n```powershell\n# Python 编译检查\npython -m compileall scripts tests\n\n# 单元测试（当前 9 个）\npython -m unittest discover tests\n\n# 工作区模板校验\npython scripts\u002Fworkspace\u002Fcheck_thesis_workspace.py assets\u002Fthesis-ai-standard\n```\n\n---\n\n## 参考项目\n\n本 skill 参考了以下两个项目：\n\n| skill                        | 角色                                               |\n| ---------------------------- | ------------------------------------------------ |\n| **xiaou61\u002Fthesis-skills**    | 标准与证据骨架：标准解析、证据构建、质量门禁、AIGC 治理、Word 批注、状态管理      |\n| **Doryoku1223\u002Flunwen-skill** | 中文论文成稿引擎：样文分析、章节控字、图表截图、Mermaid\u002FPlantUML、DOCX 成稿 |\n\n---\n\n## 许可\n\nMIT License\n\n---\n\n## 致谢\n\n- **[xiaou61\u002Fthesis-skills](https:\u002F\u002Fgithub.com\u002Fxiaou61\u002Fthesis-skills)** — 提供标准与证据骨架\n- **[Doryoku1223\u002Flunwen-skill](https:\u002F\u002Fgithub.com\u002FDoryoku1223\u002Flunwen-skill)** — 提供中文论文成稿引擎\n\n感谢两个项目的作者为中文毕业论文标准化写作做出的贡献。\n","chinese-thesis-workbench 是一个帮助学生将项目源码、数据库、截图和文献整合成符合学校模板与样文风格的本科毕业论文的工具。其核心功能包括四种 DOCX 交付路径，支持从收集材料到生成最终文档的全流程，并确保整个过程可追溯、可续写、可审查。该项目使用 Python 编写，能够保留原始 DOCX 格式或生成结构清晰的新文档，特别适用于有真实项目需要撰写毕业论文的学生，以及需要严格匹配学校模板格式、控制章节字数、管理图表和参考文献的用户。此外，对于导师批注后需系统化修订且不能丢失已有排版格式的情况也非常适用。",2,"2026-06-11 03:31:34","CREATED_QUERY"]