前言¶

在 DSH 里读 Markdown 文档，常见做法是把文件路径或文档内容直接丢进会话，再靠提示词让模型解释、提问、总结。这种方式缺少一个稳定的阅读流程：先判断读者已经会什么，再进入对应关卡，再带读，再检查，再结算。

dsh-md-quiz 是 DeepSeek Harness 的一个 Web 插件，把任意 Markdown 文档的阅读过程拆成一套可操作的“答题式阅读”流程，并在 DSH Web 界面里提供侧边栏面板和阅读区。

这是什么¶

dsh-md-quiz 是一个面向 DSH web profile 的插件，仓库地址为：

https://github.com/MrElysium/dsh-md-quiz

它解决的问题是：不绑定具体项目，把任意目录里的 .md 文件变成可以“闯关”阅读的对象。插件会向 DSH 注册技能、命令和文件读取路由，并在 Web 端提供答题式阅读面板与阅读区。

资料未明确声明 maintainer / author 字段；可确认的仓库链接指向 GitHub 的 MrElysium/dsh-md-quiz。

核心能力¶

五阶段阅读¶

插件把阅读流程拆成 5 个阶段：

diagnose → level → guided reading → checkpoint → settle

对应中文流程可理解为：诊断、关卡、引导阅读、检查点、结算。

服务端注册¶

插件向 DSH 注册以下能力：

• md-quiz-read 技能
• /mdquiz 命令
• GET /mdquiz/read?path=… 文件读取路由

文件读取路由只允许以下扩展名，且文件大小不超过 512KB：

.md
.markdown
.txt
.rst

Web 界面¶

插件在 Web 端提供两处主要入口：

• 侧边栏底部的「答题式阅读」闯关面板，包含阶段流程条、开始闯关、只测我、抽查我、结算打卡、闯关规则。
• 对话区的「阅读区」tab，与「聊天」「轨迹」并列，用于显示 Markdown 原文，并能自动识别会话里的闯关消息。

安装与启用¶

前置条件¶

资料说明 dsh plugin 通过 pnpm 安装，因此需要本机已安装：

pnpm

安装¶

README 与 package.json 给出的安装命令使用占位账号：

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

安装时应将 <你的账号> 替换为你实际使用的安装来源账号。资料中仓库页面指向 MrElysium/dsh-md-quiz，但 package.json 的 repository 字段使用 <your-account>，未确认安装命令中必须替换为哪个真实账号。

安装前建议检查仓库源码、依赖和 MIT 许可证。

验证¶

重启 dsh web 后，访问：

http://127.0.0.1:3080/plugins/dsh-md-quiz/client.js

应返回 200。

在页面源码中检查 window.__DSH_BOOT__，里面应出现：

dsh-md-quiz

界面上应看到：

• 侧边栏底部出现「答题式阅读」面板。
• 对话区上方出现「阅读区」tab。
• 输入框中可见 /mdquiz 命令提示。

典型用法¶

开始闯关¶

在侧边栏「答题式阅读」面板里填写文档路径，然后选择「开始闯关」。

插件会向当前会话发送：

答题式阅读 <路径>

随后按 5 阶段进行带读。相对路径按当前会话工作目录解析。

只测我¶

选择「只测我」后，插件发送：

只测我 <路径>

效果是只出 3 题诊断，不做教学。

抽查我¶

选择「抽查我」后，插件发送：

抽查我 <路径>

效果是从已学章节随机出题。

结算打卡¶

选择「结算打卡」后，插件发送：

结算

效果是输出结算框，并写打卡日志。

阅读区¶

打开对话区的「阅读区」tab，可以查看当前文档原文。

阅读区可以自动识别会话里的闯关消息，也可以手动输入路径加载文档。

命令面¶

也可以在输入框中使用：

/mdquiz <路径>

这是命令面入口，同样可以发起流程。

适用场景与注意¶

适合这类场景：

• 你想把 Markdown 文档从一次性问答变成“诊断、带读、抽查、结算”的流程。
• 你希望在 DSH Web 里保留一个文档原文区，而不是只看聊天消息。
• 你需要把阅读进度记录在文档目录旁边，方便后续复盘。

注意事项：

• 插件会注册 DSH 技能、命令和文件读取路由，并以当前 dsh 进程权限运行。安装前应检查源码、依赖、许可证。
• 文件读取路由仅支持 .md、.markdown、.txt、.rst，且文件大小不超过 512KB。
• 进度默认记在：

<文档目录>/.md-quiz-read-progress.md

资料说明其中记录 XP、连击、等级，规则同 每日学习协议.md。

• 本插件把目录选择器固定为 browse，即应用内浏览器。若想保留系统原生目录对话框，需要删掉 cordis.patch.yml 里目录选择器的 4 行。
• 服务端改动需要重启，客户端改动刷新即可。
• 资料标明该插件在 rc.7 上开发与验证。

链接¶

• GitHub：https://github.com/MrElysium/dsh-md-quiz
• 社区目录线索（未确认）：https://www.skillhub.cn/plugins/MrElysium/dsh-md-quiz