前言¶
在 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
