MrElysium / dsh-md-quiz

dsh-md-quiz — DeepSeek Harness「答题式阅读」插件（真·插件 + Web UI）

把 每日学习协议.md（先诊断后带练）做成一个可安装进 dsh web profile 的双半区插件：

• 服务端半区（lib/index.js）：向 DSH 注册 md-quiz-read 技能（模型侧协议）、/mdquiz 命令（UI 命令面）、GET /mdquiz/read?path=… 文件读取路由（供阅读区显示原文，仅限 .md/.markdown/.txt/.rst，≤512KB）。
• 客户端半区（lib/client.js）：Web 侧边栏底部「🎮 答题式阅读」闯关面板（阶段流程条 / 开始闯关 / 只测我 / 抽查我 / 结算打卡 / 闯关规则），以及对话区 「阅读区」tab（聊天 | 轨迹 | 阅读区，显示 Markdown 原文，自动识别会话里的闯关消息）。

通用性：不绑定任何项目。任何目录里的 .md 都能用——面板里填路径即可，相对路径按会话工作目录解析。

安装

前置：装有 pnpm（dsh plugin 通过 pnpm 安装）。

方式一：从 GitHub 装（推荐，公开分享即用）

dsh plugin --profile web add github:<你的账号>/dsh-md-quiz
# 重启 dsh web，浏览器刷新

方式二:本地开发装

dsh plugin --profile web add link:./path/to/dsh-md-quiz

两种方式都会自动把插件注册进 dsh.profile.bundles（因为本包声明了 dsh.bundle.patch），无需手改补丁。

验证

• 重启后访问 http://127.0.0.1:3080/plugins/dsh-md-quiz/client.js 返回 200；页面源码 window.__DSH_BOOT__ 里出现 dsh-md-quiz 条目。
• 侧边栏底部出现「🎮 答题式阅读」；对话区上方出现「阅读区」tab（聊天 | 轨迹 | 阅读区）。
• 会话里说「答题式阅读 <任意 md 路径>」即触发 5 阶段阅读；输入框 /mdquiz 命令可见。

使用

操作	效果
侧边栏「答题式阅读」→ 填路径 → 「🚀 开始闯关」	向当前会话发送 答题式阅读 <路径>，陪练按 5 阶段带读
「📝 只测我」	发送 只测我 <路径>，只出 3 题诊断不教学
「🎯 抽查我」	发送 抽查我 <路径>，从已学章节随机出题
「💰 结算打卡」	发送 结算，输出结算框并写打卡日志
对话区「阅读区」tab	显示当前文档原文（自动识别会话里的闯关消息，或手动输路径加载）
输入框 /mdquiz <路径>	命令面提示，同样可发起

进度默认记在 <文档目录>/.md-quiz-read-progress.md（XP / 连击 / 等级，规则同 每日学习协议.md）。

卸载

dsh plugin --profile web remove dsh-md-quiz
# 重启 dsh web

结构

dsh-md-quiz/
├── package.json        # dsh.bundle.patch + dsh.client 声明、exports、files
├── cordis.patch.yml    # bundle 补丁：挂载本插件 + 目录选择器固定 browse
├── lib/
│   ├── index.js        # 服务端：技能注册 + /mdquiz 命令 + /mdquiz/read 路由
│   ├── client.js       # 客户端 bundle：侧边栏面板 + 阅读区 tab
│   └── types/index.d.ts
├── README.md           # 本说明
├── PUBLISH.md          # 发布到 DSH 生态的步骤
├── NOTES.md            # 开发经验总结（DSH 客户端插件踩坑记录）
└── LICENSE             # MIT

注意

• 目录选择器：本插件把全局目录选择器固定为 browse（应用内浏览器），否则 本机（win32 + 回环）会解析成 native 导致面板「浏览目录」报错。若想保留系统 原生目录对话框，删掉 cordis.patch.yml 里目录选择器的 4 行。
• 服务端改动需重启，客户端改动刷新即可（详见 NOTES.md）。
• 在 rc.7 上开发与验证