出题流水线haozheou/dsh-exam-expert

dsh-exam-expert · 出题专家

📖 使用手册：docs/使用手册.md —— 从选目录到拿 Word 的四步图文指南

DeepSeek Harness 插件 · 出题流程值守流水线 · English below

把《出题专家提示词 V1.0》的整套出题流程，固化成 DeepSeek Harness 的值守流水线插件。
你只给三样东西：专家角色、参照目录、（可选的）特殊要求——AI 通读你目录里的讲义/练习/题库，把后面要确认的内容全部预填成清单，你勾选、点确定，剩下六道工序由状态机盯着走完。

工作流程

顶栏「📝 出题」标签（对话/轨迹/自动化 之后）→ 面板（角色下拉 + 参照目录 + 特殊要求）
↓
exam_start        锁定角色、验证目录，返回全套流程规范（模型必读必守）
↓ 后台通读目录内全部 md
exam_submit_analysis   题型/模块/难度汇总 → 编号清单呈现给你勾选（「1,3,5,7」或「全选」）
↓ 你勾选 + 确认卷名/难度/结构
exam_confirm      生成命题确认单 + 写入 看板-流程.md / 看板-验收.md
↓
exam_stage        六分身状态机：出题员→评题员→答案员‖排版员→转换员→校验员
前置未完成直接拒绝；返工只打回被点名环节；全程状态写进看板
↓
交付：参照目录内 学生版/教师版 MD + Word + 双看板

四个模型工具

| 工具 | 作用 |
|---|---|
| exam_start | 绑定角色 + 验证参照目录存在可写，返回流程规范 |
| exam_submit_analysis | 收通读分析结果，指示模型出编号清单供勾选 |
| exam_confirm | 锁定命题确认单，写双看板，流水线开始 |
| exam_stage | 分身汇报：前置校验（跳步拒绝）+ 看板更新 + 终结验收 |

另有写盘守卫（tools/pre-execute）：流水线进行中，写/编辑类工具指向参照目录之外直接拒绝——产出只可能落在你指定的目录里。

安装（web profile）

方式 A · 从 GitHub 安装（推荐）

在 ~/.dsh/profiles/web/package.json 的 dependencies 加一行：

"dsh-exam-expert": "github:haozheou/dsh-exam-expert",

然后在同一文件的 dsh.profile.bundles 数组加一行 "dsh-exam-expert"，cd ~/.dsh/profiles/web && pnpm install，重启 DSH。

方式 B · 本地目录安装

1. 把本目录放入 profile 的插件目录：

ln -s "$PWD/dsh-exam-expert" ~/.dsh/profiles/web/plugins/dsh-exam-expert

2. 在 ~/.dsh/profiles/web/package.json 的 dependencies 加一行：

"dsh-exam-expert": "workspace:*",

3. 在同一文件的 dsh.profile.bundles 数组加一行：

"dsh-exam-expert"

4. cd ~/.dsh/profiles/web && pnpm install，重启 DSH。

设置（Settings → 出题专家）

- enabled — 总开关
- guardEnabled — 写盘守卫（默认开）
- roles — 专家角色清单（启动对话框下拉的数据源，可增删）
- ratioTruthPct / ratioLecturePct / ratioOriginalPct — 默认来源比例（和必须为 100）
- kanbanEnabled — 双看板写入开关

v1.0 已知边界

- 单活动任务：一次宿主进程内跟踪一场出题，重新发起即重开新任务。
- 出题面板是整页视图（conversation.view，order 50 排在「自动化」后）；点确定后切回「对话」标签看进度。
- bash 命令不做路径强拦（v1.0 靠流程纪律）；写/编辑类已强拦。
- 勾选清单在对话里呈现（回「1,3,5,7」即可）；带勾选框的动态表单 UI 列入 v1.1。
- Word 转换仍按提示词 V1.0 规则：转换前先问有无样本，无样本用默认版式。
- 源依据：《出题专家提示词 V1.0》（Obsidian 09 提示词）。提示词升级时需同步本插件的 specText。

License

MIT