Gorilla-Kevv/scnu-thesis-formatter 预览 preview

Gorilla-Kevv/scnu-thesis-formatter

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

catalog descriptioncatalog 简介 / catalog description:华南师范大学本科毕业论文格式改写 + matplotlib 数据可视化(DeepSeek Harness 技能)

Project Overview项目介绍

It is a native skill plugin built exclusively for DeepSeek Harness, designed to reformat Chinese docx documents to meet the strict thesis formatting requirements of South China Normal University (SCNU) undergraduate students. It can scan the input document for tabular data and percentage values scattered throughout the text, generate clear visualization charts including pie charts, bar charts, and grouped bar charts with matplotlib, then embed the properly numbered charts and three-line tables back into the output document. The plugin follows all of SCNU’s official formatting rules for theses, from cover page to acknowledgments section.

This plugin is intended for undergraduate students at SCNU who need to format their theses, course reports, or graduation design documents. To use it, you just upload your original docx file to the DSH agent and add a prompt describing your formatting need, such as asking to reformat the report per SCNU’s official template. The plugin will automatically handle all required formatting adjustments, including section breaks, page numbering, title hierarchy, and reference list formatting per the GB/T 7714 standard. It also generates an updatable table of contents, so when you open the output in Word, page numbers update automatically without manual action.

Before you can use this plugin, you need to install two Python dependencies via the pip package manager: python-docx and matplotlib. For Chinese characters to display correctly on generated charts, you need to have a Chinese system font installed, such as Microsoft YaHei, SimHei, or SimSun. The plugin includes built-in fallback font handling, so it will still work correctly even if your preferred font is not available on your local machine. There are two easy installation methods available for DSH: copy the folder directly to your skills directory, or package it to a .skill file with the included script. It is released under the open source MIT license, free to use, modify, and distribute.

这是一个专为DeepSeek Harness开发的原生技能插件,功能是将用户提供的中文docx格式报告、论文或实践报告,严格排版为华南师范大学本科毕业论文(设计)的规定格式。同时它可以提取原文档内的表格数据和散落在正文中的百分比数据,用matplotlib生成高清可视化图表,按章节编号后嵌入回修正后的正文文档。

该插件面向华南师范大学需要完成本科毕业论文、课程实践报告格式排版的学生使用。使用时只需要将待处理的docx文档上传给代理,同时说明排版需求即可触发插件工作,不需要手动调用技能。它还会自动生成可更新的目录域,打开生成后的Word文档时目录会自动更新页码,省去了大量重复的格式调整工作。

使用该插件需要提前通过pip安装python-docx和matplotlib两个Python依赖包。生成的图表要正确显示中文需要本机安装有中文字体(如微软雅黑、黑体、宋体),不过插件代码中已经做了字体回退处理,即使没有对应字体也能正常显示。整个项目采用MIT许可协议开源,完全免费供用户使用和修改。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 warning1 项注意
  • Only 2 stars - very few users, little community feedback星标只有 2,几乎没人在用,遇到问题缺少社区反馈
DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

  • DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
  • External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时(Electron / Python / Docker 等)是否齐备
  • Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突:命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

  • Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致,是否归档或长期停更
  • Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
  • curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
  • Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
  • Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需(filesystem / network / shell / clipboard)
  • Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限,以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照,不能替代安全审计。

Or use CLI install (for developers)或使用命令行安装(适合开发者)

CLI Install命令行安装

dsh plugin --profile web add github:Gorilla-Kevv/scnu-thesis-formatter

把 Gorilla-Kevv/scnu-thesis-formatter 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

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

← 上一个 Prev orchestral 下一个 Next Hermeslike-Mixagent-MoA →