dsh-teacher-kit:面向中学教师的本地文档工作流

前言

在 DeepSeek Harness(DSH)里做教学相关智能体时,常见需求是「把卷子、教案、课件做成学校认得的 Word/PPT/PDF」,而不是在对话里堆一段 Markdown。学校往往已有空白卷模板、固定教案表头;印前要查页码域、题号、分值。若每次靠手工排版或另开 Office 宏,重复劳动多,且容易把班级、模板路径混在上一次任务里。

下面介绍的 教师助手(GitHub:LeonhardJY/dsh-teacher-kit)是 DSH 工作流类插件:在对话输入框下方增加「教师助手」入口,用本机 Python 与 DSH 内置 LibreOffice 生成 .docx / .pdf(及 .pptx、.html 等),不联网、不上传。它只做「把文件做出来」,不涉及学生评价、成绩分析、评语等人际环节。

这是什么

  • 维护者:LeonhardJY(仓库 LeonhardJY/dsh-teacher-kit)
  • 分类:工作流
  • 当前包版本(package.json):0.18.0,许可证 MIT
  • 运行环境:Windows 上的 DSH 桌面版或 dsh web,DSH 版本要求 >= 0.2.1-rc.2
  • 目录页:skillhub.cn 插件条目

装好插件后,点「教师助手」会弹出功能卡片;从 0.15 起默认推荐 对话式:选一项后面板关闭,对话里补全本次参数后直接出文件。面板底部仍保留 老方式(填表就出),与对话式共用同一套排版引擎。

核心功能

以下能力均来自项目 README 功能表,产物格式以说明为准。

能力 简要说明 典型产出
出试卷 粘贴题干或从 Word 读题;可选学校空白模板;8 开两栏等版式;答题卡、答案卷、印前检查;可 A/B 卷、教师卷(最多一次四份) .docx + .pdf
题库组卷 选 Excel/Word 题库,按题型挑题或全库组卷,可多套、A/B、教师卷 .docx + .pdf
听写单 词表文件或粘贴 → 双栏听写纸,可选答案页与听写 wav .docx + .pdf
教案 草稿按字段识别,表格式或流程版 .docx + .pdf
做课件 粘贴课时内容,可选学校 PPT 模板;备注写「讲:」行;可出网页课件 .pptx / .html
整套 一节课多选:试卷 / 听写 / 教案 / 课件,缺哪件只报哪件 各自格式
文件加工 Word 净化、批量净化、合并、抽文字、检查一份卷子 .docx / 文字
公众号推文 活动稿结构化 → 可粘贴排版(不联网发布) .html + .docx
公文流转 来文登记、拟办、流转单、回复稿等 .docx
模板 旧卷转空白学校模板(老方式入口) .docx

本地与依赖:全程本机运行;使用 DSH 自带 Python 与内置 LibreOffice,不必另装 Microsoft Office;生成的 Word/PPT 可在 WPS 中打开。第一次走对话式时,插件会询问并记住学校模板、版式等习惯(README「学校画像」章节)。

安装与启用

插件以当前 DSH 进程权限运行;安装前建议浏览仓库源码与 MIT 许可证。社区目录站点(如 skillhub.cn)与 DeepSeek / 幻方无官方从属关系,索引源由维护者提供。

办法 A:插件市场(索引源)

DSH:设置 → 插件市场 → 发现,在索引源中填入:

https://fastly.jsdelivr.net/gh/LeonhardJY/dsh-teacher-kit@main/market/index.json

保存并刷新后出现「教师助手」卡片,安装后 重启 DSH。README 说明:国内直连 raw.githubusercontent.com 可能失败,故推荐 jsDelivr;备用原始地址为 https://raw.githubusercontent.com/LeonhardJY/dsh-teacher-kit/main/market/index.json。

办法 B:本地 zip 安装

从仓库 dist/ 取当前最大版本包(资料中示例为 dsh-teacher-kit-0.18.0.zip),解压后在目录内执行:

node scripts/install-local.mjs --profile desktop

使用 dsh web 时将 --profile desktop 改为 --profile web。脚本会把插件复制到对应 profile 的 node_modules 并在 cordis.patch.yml 中启用。可选 --dry-run 预览、--uninstall 卸载。完成后 重启 DSH,对话输入框下方应出现「教师助手」。

办法 C:离线一键包(无 Node)

使用 dist/dsh-teacher-kit-<版本>-offline-win.zip:解压到文件夹(勿在压缩包内直接运行),双击 一键安装.cmd,提示装好后完全退出 DSH 再打开。脚本为 PowerShell(offline-installer/install.ps1),不依赖 Node、不联网。

验证:设置 → 插件市场 → 已安装中可见 dsh-teacher-kit;或在对话中让助手调用 teacher_kit_status,应返回 Python 与 LibreOffice 版本信息。

典型用法

对话式出卷(推荐首次使用)

  1. 点「教师助手」→「出试卷」。
  2. 在对话中说明卷子名称、是否套学校 .docx 模板、纸型(默认 8 开横向两栏)、是否要答题卡 / 参考答案 / A/B / 教师卷等。
  3. 将题干粘贴进对话;支持大题小题、选项、【答案】/【解析】 及卷尾集中答案段。可选粘贴听力录音稿并勾选生成 wav(Windows 自带语音,离线)。
  4. 完成后结果给出路径与预览;印前检查不通过时会阻止导出 PDF,Word 仍可拿到修改后再导。

题干格式示例(README 摘录):

一、听力(20 分)
1. What does the boy want to buy?
A. A book  B. A pen  C. A bag  D. A cup
2. 下列字音正确的是( )
A. zhān  B. zhǎn  C. zhàn  D. zhàn
【答案】B
【解析】zhǎn 是上声。

题库组卷

  1. 「教师助手」→「题库组卷」→ 浏览选择题库(.xlsx / .xls / .csv / .docx)。
  2. 表头识别题号、题型、材料、题干、选项、答案、解析、分值等列;阅读/完形材料放「材料」列。
  3. 可先「看看题库里有什么」;在「挑题」行写如 单项选择 10,或留空用全库。
  4. 与出卷相同可套模板、答题卡、A/B、教师卷;「分成几套」可一次出 2–4 套平行卷。

听写单与教案

  • 听写单:选英→中 / 中→英 / 混排;词表来自文件或粘贴;可勾「同时生成听写音频」并设置每条停顿秒数。
  • 教案:粘贴含 教学目标、教学过程 等字段的草稿;选表格式或流程版,表格式可识别导入/新授等环节列。

老方式快速出成品

面板底部 直接出成品(老方式:填表就出,不经过对话):表单填完点「开始做」,一次返回结果卡。与对话式产物一致,适合已熟悉字段的老师。

适用场景与注意

适合谁:中国大陆中学教师或教务,需要在本地批量产出符合本校版式的试卷、听写、教案、课件,并做 Word 净化、公文流转等重复文档工作;希望数据不出本机、不依赖云端 Office。

不适合当作什么:它不替代教学设计决策,也不处理与学生直接相关的评价与数据分析。

权限与安全:插件代码随 DSH 加载执行,安装前应自行审阅 GitHub 仓库。README 明确不联网、不收集数据;听力/听写音频依赖 Windows 系统语音包,缺失时仅提示,不阻断文档生成。

设置记忆:纸型、时长、学校模板、听写栏数、教案版式等「选择类」项会记在本机;题干、词表、勾选框(答题卡/A-B 等)默认不记住,避免误带上次内容。

结尾

dsh-teacher-kit 把中学日常里高频的「出卷、组卷、听写、教案、课件、整节课文档包」收进 DSH 对话旁的一条工作流,排版可对齐学校空白模板,印前有检查项,全程本地 LibreOffice 链路完成 PDF。若你在 DSH 生态里找 工作流 类教学文档工具,可从目录页或仓库 README 的安装节任选市场索引、本地脚本或离线包一种方式启用。

  • 目录页:https://www.skillhub.cn/plugins/LeonhardJY/dsh-teacher-kit
  • GitHub:https://github.com/LeonhardJY/dsh-teacher-kit
羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜