Gorilla-Kevv/scnu-thesis-formatter

scnu-thesis-formatter

将中文报告/论文/实践报告的 .docx 严格改写为华南师范大学本科毕业论文（设计）格式，并把文档里的表格与百分比数据用 matplotlib 生成高清可视化图表（三线表 + 按章编号的图）嵌入正文。

数据可视化效果示例

它能做什么

- 套用华师论文格式：封面、摘要、英文摘要、目录、章/节/小节三级标题、正文、三线表、图题表题、参考文献（GB/T 7714）、附录、致谢
- 正确分节与页码：封面无页码、摘要/目录罗马数字、正文阿拉伯数字从 1 起
- 把表内数据和散落在文字里的百分比自动变成 matplotlib 图表（饼图/柱状图/横向条形图/分组柱状图）
- 自动目录域 + 打开 Word 自动更新页码

安装

方式一：直接把本仓库目录复制到用户技能目录

Windows，用户级（所有项目可用）
Copy-Item .\scnu-thesis-formatter "$env:USERPROFILE\.dsh\skills\scnu-thesis-formatter" -Recurse

方式二：用本仓库自带脚本打包成 .skill 文件后导入

python scripts/package_skill.py
生成 dist/scnu-thesis-formatter.skill

依赖

pip install python-docx matplotlib

图表中文需要本机有中文字体（微软雅黑 / 黑体 / 宋体），scripts/charts.py 会自动回退。

使用

直接给 Claude 一份报告 .docx 并说明意图即可，例如：

- “把这份实践报告按华南师范大学的毕业论文格式模板排版，并把表格和百分比数据做成 matplotlib 图表。”
- “严格按附件4格式模板修改订正这份报告，数据优化为可视化图表。”

触发信息完整写在 SKILL.md 的 description 里，无需手动点名技能名。

目录结构

scnu-thesis-formatter/
├── SKILL.md                      # 技能定义 + 工作流 + 质量自检清单
├── references/
│   └── scnu-format-rules.md      # 硬编码的华师格式规范（页面/字号/标题/图表/参考文献/页码）
├── scripts/
│   ├── docx_helpers.py           # 可复用 python-docx 辅助库（三线表/页码/目录域/封面等）
│   ├── charts.py                 # matplotlib 图表库（中文字体 + 饼/柱/横条/分组柱图）
│   └── package_skill.py          # 打包 .skill 的独立脚本（CI 也用它）
├── docs/
│   └── demo.png                  # 效果示意图
└── .github/workflows/release.yml # 打 v* 标签自动打包并发布 Release

许可

MIT © 2026 Gorilla-Kevv