前言¶
在 DeepSeek Harness（DSH）里用智能体写讲义、课件或教案，常见问题是：结论没有绑到一手来源、页与页之间口径不一致、导出物难以复现。手工在对话里拼 Markdown，也很难系统化做版权审计和门禁检查。
下面介绍社区插件 dsh-teaching-material-workbench（维护者 Golden2002，分类：工作流）。它在案例目录里搭脚手架、登记来源与主张、跑分层门禁，并提供 Web 端「教学物料」工作台，把「有证据的教学物料生产」收成一套可重复的流程。核心与学科、学段、场景无关；学科内容只放在你指定的案例目录中。
这是什么¶
一句话：Evidence-gated（证据门禁）教学物料生产插件——建立案例、绑定一手材料、跑 E1/E2/E3 三层门禁、审计版权、记录产物 SHA-256，并支持逐页编辑与多格式导出。
- 仓库：Golden2002/dsh-teaching-material-workbench
- 社区目录页：skillhub.cn 插件页
- 当前包版本（
package.json）：0.6.0 - 许可证：MIT
- 运行时技能名：
teaching-material-workbench（教智能体工作流与证据规则）
插件以 Host-only bundle 形式发布，声明 engines.dsh >= 0.2.2-rc.1、node >= 20，无 install 脚本、无构建步骤、无运行时 npm 依赖，且不做网络请求；案例数据留在你选择的目录里。
核心能力¶
智能体工具（Tools）¶
| 工具 | 作用 |
|---|---|
teaching_material_init |
创建案例脚手架：情境画像、课时数据、来源/主张登记表、对齐、量规、时间轴、术语表、误区、调色板、教师包、校验模板等 |
teaching_material_gate |
运行 E1（自洽）、E2（外部标准）、E3（实证）门禁，写出 gate-report.md |
teaching_material_ground |
主张级接地审计：每条主张需有来源与 locator；未支撑主张失败；教师包需 [Sxx] 标记；写 verification/grounding-report.md |
teaching_material_outline |
从案例数据确定性生成逐页 Markdown 大纲，写 build/outline.md |
teaching_material_pages |
读/写/保存页模型 pages.json；保存会重建大纲并写入 .history/ |
teaching_material_export |
导出讲义、课件、分镜、逐页 Manim 脚本；本机有 python-docx/python-pptx 时可导出 DOCX/PPTX，缺依赖时在报告中说明，不伪造 |
teaching_language_check |
按 PAEG 教学语言规则检查文本或 language.md，返回违例位置与机械替换预览 |
teaching_material_audit |
审计来源登记与版权，写 verification/rights-report.md |
teaching_material_repro |
对 build 产物做 SHA-256，写 verification/repro.json |
teaching_material_standards |
返回外部标准登记表及 verified / partial / not-obtained 状态 |
Web UI「教学物料」页签¶
安装 bundle 并刷新 Web 后，对话视图旁会出现 教学物料 页签，仅读写你传入的案例目录内允许的文本文件；预览为近似预览，版式以导出文件为准。
主要能力包括：
- 逐页：按时间轴编辑页草稿；中间栏改标题、时长、要点、讲义、讲稿与来源编号；右侧 16:9 课件卡与讲义卡；未接地句子可补
[Sxx]；图示可走figures.json或assets/。 - 新建案例：向导填写标题、学科、学段、学习者、场景、时长、评估、来源与时间轴。
- 来源：以卡片编辑
sources.csv，区分已核验一手、未核验、受限。 - 导出：生成
build/handout.md、deck.md、storyboard.md、script.md、subtitles.srt与animations/Scene*.py；条件允许时同时生成 DOCX/PPTX。 - 检查中心：聚合门禁三态、语言违例、claims 接地与来源审计。
- 版本回退：基于
.history/恢复或与当前pages.json并排对比。
门禁分层¶
| 层级 | 含义 | 示例 |
|---|---|---|
| E1 | 自洽：结构、算术、跨文件引用 | schema、时间轴合计、量规总分、来源 id 存在性 |
| E2 | 外部标准与文档 | 来源登记规则、考纲、WCAG 2.2、GB/T 15834、许可条款 |
| E3 | 外部实证 | 独立同行评议、学习者试点数据 |
每条检查带层级与依据；skip 表示未运行，不计为通过。空试点模板会导致门禁失败；有试点数据但没有书面试验设计也会失败。
中文教学文本的语言检查依赖上游 paeg-teaching-language-skill（MIT）；可枚举问题（禁用措辞、标点、数字格式、人称等）由工具覆盖，修辞与术语仍须人工审阅。
安装与启用¶
插件是 Host-only bundle，不要手工改 profile 文件。
从本机包目录安装（Web UI：Plugins → Install，指向包目录；或在 agent 会话中）：
plugin_manager action=install_bundle target=<absolute package directory>
CLI 等价形式：
dsh plugin --profile <name> add <absolute package directory>
从公开仓库按 commit 固定安装：
plugin_manager action=install_bundle target=git+https://github.com/Golden2002/dsh-teaching-material-workbench.git#7b805288da07a1985157948f35feb940179bb384
运行环境要求：带 Host tools 服务的 DeepSeek Harness（当前 profile）、Node.js ≥ 20。DOCX/PPTX 导出为可选项，依赖宿主机 Python 与 python-docx/python-pptx。
安装前建议在仓库中自行查阅源码与 LICENSE；插件以当前 DSH 进程权限运行，只应在你信任的环境中安装。
典型用法¶
README 给出的 Quick start 可概括为以下顺序。
1、初始化案例
在 agent 中调用（路径与字段按你的环境填写）：
teaching_material_init directory=D:\work\case-001 title=... subject=... level=... audience=... setting=...
2、填写配置与登记表
编辑 profile.yml（权威机构、阈值等）与各 CSV。每个来源需有出版社、日期、 locator、访问方式、许可与核验状态；二手材料只能定位一手材料。claims.csv 每行一条实质主张（claim、source_id、locator、supported|partial|unsupported）；可选 knowledge.csv 将概念映射到同一来源与 locator。
3、接地与大纲
运行 teaching_material_ground，删除或修正未支撑主张。用 teaching_material_outline 生成 build/outline.md；再用任意工具生成 build/deck.pptx / build/handout.docx，并在 teacher-pack.md 中写 [Sxx] 引用。
4、门禁、版权与可复现
运行 teaching_material_gate——只修数据，不要放宽门禁。再运行 teaching_material_audit 与 teaching_material_repro。
5、人工与试点证据（如有）
在填写 pilot.csv 前先写 verification/trial-design.md；未执行时两者保持「未执行」标记。
适用场景与边界¶
适合谁：需要在 DSH 里把教案/讲义/课件当成可审计制品来做的开发者或教研流程设计者——尤其在意来源登记、主张接地、版权与产物哈希、以及分层 QA 门禁，而不是一次性对话出稿。
边界（README 已声明）：
- 门禁主要在数据层；生成 deck/handout 的版式、溢出等仍要用外部工具（例如 LibreOffice 渲染）检查，插件不包揽。
- E3 只检查证据是否存在，不评判质量。
- 无网络、无遥测、不采集学生数据。
- 标准登记中无法取得的条款标为
not-obtained，不应被引用为已核验条文。
上游自测：node --test tests/*.test.js（资料记载当前为 38 tests，0 failures）。
结尾¶
dsh-teaching-material-workbench 把教学物料生产收进「案例目录 + 登记表 + 三层门禁 + 检查中心 + 导出与复现哈希」的工作流，并与 Web 逐页编辑配合，减少无来源主张和不可复现导出。
- 目录页：https://www.skillhub.cn/plugins/Golden2002/dsh-teaching-material-workbench
- 源码与文档：https://github.com/Golden2002/dsh-teaching-material-workbench
社区目录 skillhub.cn 为独立站点，与 DeepSeek / 幻方无官方从属关系；安装与使用请以仓库 README 与许可证为准。
