按 YAML 规范检查 .docx 和 .doc 毕业论文的格式,包括字体、行距、页边距、标题编号、图表题注和参考文献。内置蚌埠工商学院的一份规范,也可使用自定义规范。
安装
# npm 包(预构建)
dsh plugin --profile web add dsh-plugin-thesis-format
# GitHub 源码(首次需按提示配置 allowBuilds 构建授权后重试)
dsh plugin --profile web add github:zx310610/dsh-plugin-thesis-format#path:/packages/dsh-plugin
装任何插件都等于在你的机器上跑第三方代码,权限和你本人一样大——能读你的文件、用你的凭据、访问网络,工具审批管不到它。GitHub 来源的插件还会在安装时执行构建脚本——pnpm 默认拦截,所以安装可能停在 ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED 或 ERR_PNPM_IGNORED_BUILDS;dsh 会打印出需要添加的确切键名,把它加进该 profile 的 pnpm-workspace.yaml 的 allowBuilds 下,重跑一次即可装上。放行构建本身就是一次信任判断:请只安装可信来源,并尽量锁定 commit(github:owner/repo#sha)。
README
让 DeepSeek Harness 按学校的格式规范,自动检查本科毕业论文(.docx / .doc)的排版。 检查完全在本机进行,论文不会上传到任何地方。
对模型说一句“检查一下 D:\论文\张三-毕业论文.docx 的格式”,它会调用本插件,返回一份按问题分组的报告:
- 结果:105 个错误,30 个警告,0 个提示(相同问题已合并)
## 中文摘要与关键词
- [错误] 摘要正文行距应为固定值 20 磅,实际为1.5 倍行距
- 第 38 段:摘 要:随着互联网技术的发展,在线考试已成为…
## 正文各级标题
- [错误] 一级标题首行缩进应为2 字符,实际为0 字符(共 7 处)
- 第 116 段:一、引言
- 第 125 段:二、 系统关键技术
- …其余 5 处略
- [错误] 二级标题序号后面不空格(共 7 处)
- 第 120 段:(二) 开发现状
- …
能检查什么
| 规则 | 内容 |
|---|---|
| 页面设置 | 纸张大小、上下左右页边距、装订线 |
| 题目与署名 | 中英文题目字体字号、署名行与指导教师行的格式 |
| 中英文摘要 | 标签写法、字体字号行距缩进、字数;关键词个数、分隔符、英文关键词大小写 |
| 目录 | 是否自动生成、级数、是否包含参考文献与致谢 |
| 各级标题 | 字体字号加粗、缩进、段前段后、末尾标点、序号格式与连续性 |
| 正文 | 中西文字体、字号、行距、首行缩进(能识别用空格冒充的缩进)、总字数 |
| 图表题注 | 字体字号对齐、编号连续、表题在表上、图题在图下、正文是否引用 |
| 参考文献 | 篇数、英文篇数、编号、文献类型标识、期刊页码、结尾标点、正文引用顺序 |
| 数字与标点 | 全角数字、用“--”代替破折号、千分位逗号等 |
段落字体字号按 Word 的样式继承规则计算(文档默认 → 样式链 → 自动编号 → 直接格式),与在 Word 里看到的一致。
插件同时提供 thesis_read_section 工具,把摘要、正文、参考文献等部分的纯文本交给模型,让它审阅不适合写成固定规则的内容,例如摘要是否交代了背景与技术路线、参考文献是否过旧。
安装
在 DeepSeek Harness 的 插件 页面按包名
dsh-plugin-thesis-format安装,或用命令行安装:dsh plugin --profile <你的 profile 名> add dsh-plugin-thesis-format重启 dsh(开启热重载时立即生效)。
需要 Node.js 24 及以上(dsh 自带)。检查 .doc 文件时,插件会先把它临时转换成 .docx,不改动原文件。转换需要本机安装 Microsoft Word(Windows)或 LibreOffice;只检查 .docx 则不需要。
内置规范
目前内置一份:蚌埠工商学院 计算机科学与技术专业 毕业设计(论文),适用于 2025、2026 届,id 为 bbctb-cs。它是根据学校的 Word 模板逐条整理的,每一项都注明了模板原文。
用于其他学校或专业
各校的格式要求大同小异,差别主要在字体字号、页边距、标题编号方式和参考文献数量等。为本校写一份规范的步骤如下:
- 复制插件目录
specs/bbctb-cs.yaml,改名为本校规范,例如D:\规范\my-school.yaml。 - 对照学校模板修改与内置规范不同的项目。文件里每一项都附有模板原文注释,照着改即可:
- 字号可写“小四”“五号”,也可写磅值;
- 字体可写中文名或英文名(宋体 = SimSun);
- 不需要的检查写进
disabledRules,例如disabledRules: [text-hygiene]。
- 选一种方式使用这份规范:
- 对模型说明:“按 D:\规范\my-school.yaml 检查这篇论文”;
- 或把本插件的
spec配置改为该文件的绝对路径(见下方“配置”),以后默认使用它。
标题编号方式(“一、”“(一)”“1.”“(1)”)和摘要、目录、致谢、参考文献等部分的识别目前按常见的中文本科论文写法实现。如果你们学校的结构差别较大,欢迎到仓库提 issue,并附上模板,去掉个人信息即可。
暂不检查
页码位置、页眉页脚、脚注、表格三线边框、分页。这些信息需要 Word 的排版引擎才能拿到。
配置
| 配置项 | 默认值 | 说明 |
|---|---|---|
spec |
bbctb-cs |
默认使用的规范:内置 id,或 YAML 文件的绝对路径 |
在 profile 的 cordis.patch.yml 里按 id 覆盖本插件的配置:
- id: thesis-format-check
name: dsh-plugin-thesis-format
config:
spec: D:/规范/my-school.yaml
作者
周翔,蚌埠工商学院计算机与人工智能学院
- 邮箱:120230021@bctb.edu.cn
- GitHub:zx310610
许可
MIT。插件打包了 jszip、fast-xml-parser、yaml 等开源库(jszip 按其 MIT 许可使用),它们的版权与许可声明见包内的 THIRD_PARTY_LICENSES.txt。
链接
同类插件
tt-a1i/archify#integrations/deepseek-harness★ 92724
从仓库或系统描述生成经过校验的自包含交互式架构图、流程图、时序图、数据流图和生命周期图。
dream-num/dsh-univer-office★ 657
为 DeepSeek Harness 打造一个真正的办公环境。Univer Office 插件将电子表格、文档、幻灯片、画布、多维表格等汇聚到同一个运行时——数据互联、修改经过校验、变更按版本管理,并以隔离工作树支持多 Agent 协作。
ECNU/EduWork#dsh-knowledge-studio★ 275
基于工作区资料的 Studio,复用 DSH 模型与共享成果服务,制作报告、演示文稿、表格、思维导图、测验、闪卡及音视频。Office 生成需 Python 3.12+ 及相关依赖,并配置 DSH_OFFICE_PYTHON;媒体渲染需 Chromium;本地语音转写另需 whisper.cpp 和模型。
PerryLink/dsh-industry-research★ 215
面向 DeepSeek Harness 的确定性行业研究报告:公司与行业研究流程基于分阶段证据产出结构化、可核验的报告。
HuanLinOTO/dsh-plugin-mineru★ 51
向模型暴露 MineRU 文档解析工具。
PolinniZhong/dsh-knit★ 48
把会话工作区里已有的 Markdown 文档、源码、图片与视频列进 DSH 侧边栏,按与当前对话的相关性排序。默认的词法模式用最近几条消息在本地与标题、摘要、正文做带 IDF 加权的匹配(BM25)—— 不调用模型、没有网络出口,内容不出本机。列表来自工作区扫描,而不是「最近打开记录」,所以重启 DSH 或新开会话都不会变空。排序结果组织成主要 / 辅助 / 相关三层的阅读顺序,每一条都写明可核验的理由(命中了哪个字段、被哪一篇引用),点一行即可就地预览:Markdown 按渲染后的样子显示、相对路径图片真实渲染、源码走宿主自带的语法高亮、视频走 HTTP Range 流式播放。同一份 Context Pack 也作为 knit_docs 工具交给 agent。后续版本陆续补上读取证据与生命周期(归因在读那一刻冻结)、固定 / 排除(排除先于检索生效,且可恢复)、关系证据(引用 / 导入 / 测试,带行号)与增量索引(重启后复用)。v0.23 起还多一条可选的混合检索:默认关闭,只有你自己配好 Ollama 或 OpenAI 兼容的 embedding 服务才会生效。它生效时,发出去的是你这句查询原话加上每篇候选文件的标题与摘要 —— Markdown 的摘要取自正文首段(不超过 60 字),代码的摘要是它所在的工作区相对目录,图片 / 视频贡献的是文件名;完整正文与绝对路径都不发送,指向本机服务(loopback)时内容不出这台机器。v0.24 起还能做变更关联:用一条只读的 git status(固定 argv、不走 shell、子进程环境白名单),配合同一套引用 / 导入 / 测试 / 提及证据,指出这次改动大概率该一起看哪些文件 —— 默认关闭。语义检索的收益仍待真 provider 实测,因此不承诺召回提升。
社区评论
评论公开保存在 GitHub Discussions。加载评论会连接 GitHub 和 Giscus;发表内容需要 GitHub 账号。