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