scnu-thesis-formatter

Readme

# scnu-thesis-formatter

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

![数据可视化效果示例](docs/demo.png)

## 它能做什么

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

## 安装

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

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

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

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

## 依赖

```bash
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](./LICENSE) © 2026 Gorilla-Kevv