前言¶
在 DeepSeek Harness（DSH）Web UI 中，一次問答往往只停留在當前上下文裏。閱讀完一段技術解釋後，如果缺少即時檢查，內容很快會混進聊天記錄，不容易回頭驗證是否真正理解。
dsh-quiz 針對這個問題：它面向 DSH Web UI，把已完成的 AI 回答轉換爲單選題、多選題或判斷題，讓用戶即時作答、查看解析，並按自己的意願決定是否加入個人題庫與複習列表。
這是什麼¶
dsh-quiz 是面向 DeepSeek Harness（DSH）Web UI 的對話式題庫插件，由 cungphammanh590-star 維護，許可證爲 MIT。
它解決的問題是：對話式 AI 回答適合解釋概念，但缺少一種輕量方式把回答變成可檢驗的材料。使用該插件後，用戶可以在不離開當前 DSH Web 會話的情況下，對某條 AI 回答出題、作答、查看解析，並將需要保留的題目保存到個人題庫。
核心功能¶
下面介紹 dsh-quiz 已提供的能力：
- 在每條已完成的 AI 回答下方顯示“出題”按鈕。
- 點擊後在右側抽屜後臺生成並展示題目，不向當前對話追加消息，也不創建新的可見會話。
- 出題期間可以繼續當前話題；關閉抽屜會取消仍在運行的生成請求。
- 支持單選題、多選題、判斷題和混合題。
- 可選擇題目數量與難度。
- 使用原生單選框和複選框作答，提交後即時判題並顯示解析。
- 題目默認只是臨時草稿，只有用戶明確操作後纔會加入題庫。
- “加入題庫”和“加入複習”相互獨立，不會自動安排複習。
- 左側題庫入口支持關鍵詞搜索、待複習篩選和歷史作答統計。
- 每道題保留來源會話及回答摘錄，方便回到知識上下文。
- 題目數據寫入 DSH domain storage；未保存草稿不會長期佔用存儲。
- Web UI 的“出題”按鈕直接使用插件 Host 的輔助模型調用，不經過對話工具。
- 提供
quiz_create_draft、quiz_answer、quiz_save、quiz_list等模型工具，用於自然語言出題、判題、保存和查詢。
安裝與啓用¶
使用插件前需要滿足以下條件：
- DeepSeek Harness
0.1.xWeb profile - Node.js
^22.19或>=24 pnpm- 已在 DSH 中配置可用的模型服務
當前插件版本基於 DSH 0.1.0-rc.6 API 構建。DSH 尚處於預發佈階段，升級 DSH 後如遇兼容問題，請先重新安裝插件並查看倉庫 Issues。
推薦從 GitHub 安裝。進入任意目錄後運行：
npx @deepseek-ai/dsh plugin --profile web add github:cungphammanh590-star/dsh-quiz
npx @deepseek-ai/dsh web
安裝完成後，刷新 DSH Web 頁面。左側出現“題庫”入口，並且 AI 回答下方出現“出題”按鈕，即表示插件已啓用。
GitHub 安裝會執行倉庫的 prepare 構建腳本。pnpm 10 及更高版本默認可能阻止 Git 依賴執行構建；首次安裝失敗時，請按照 DSH 在終端給出的提示，把 dsh-quiz 加入對應 Web profile 的 pnpm-workspace.yaml 中的 allowBuilds，然後重新運行安裝命令。只應爲你信任的插件源碼授予構建權限。
由於插件會以當前 dsh 進程擁有的權限運行，安裝前應檢查插件源碼、許可證和構建腳本是否符合預期。
典型用法¶
按鈕方式使用步驟如下：
- 在 DSH Web 中提問並等待 AI 完成回答。
- 點擊回答下方的“出題”。
- 選擇題型、題量和難度，然後點擊“開始出題”；右側抽屜立即打開，原對話不新增消息。
- 可以繼續當前對話，也可以等待題目在抽屜中生成，然後使用單選框或複選框作答。
- 查看判題結果和解析。
- 需要保留時，可勾選“加入複習”，再點擊“加入題庫”。
- 點擊左側“題庫”瀏覽、搜索或篩選已保存題目。
也可以直接通過對話調用插件能力，例如：
根據剛纔關於 JavaScript 閉包的回答，給我出兩道單選題，先不要顯示答案。
第一題選 B。把這道題加入題庫，但暫時不要加入複習。
模型工具¶
插件提供以下模型工具，用於用戶在自然語言中明確要求出題、判題、保存或查詢時調用：
quiz_create_draft：創建 1–10 道尚未保存的題目，並關聯當前 DSH 會話。quiz_answer：按選項索引判題，並更新作答統計。quiz_save：保存指定草稿，並獨立設置是否加入複習。quiz_list：按主題或複習狀態查詢已保存題目。
Web UI 的“出題”按鈕不經過這些對話工具，它直接使用插件 Host 的輔助模型調用。quiz_create_draft 等工具保留給用戶明確通過自然語言要求出題的場景。
數據、權限與限制¶
與數據相關的行爲如下：
- 已保存題目使用當前 Web profile 配置的 DSH domain storage。
- 未保存題目是有數量上限的進程內草稿；重啓 DSH 後會被丟棄。
- 題目會記錄生成所依據的 AI 回答摘錄和來源會話 ID。
- 按鈕出題只把所點回答發送給當前會話使用的模型路由，不發送整個聊天曆史。
- 輔助出題請求不寫入聊天消息序列，也不會成爲後續對話上下文。
- 插件本身不提供外部同步、遙測或獨立賬號系統。
- 生成內容仍由當前 DSH 模型提供商處理，適用其現有配置與隱私政策。
使用限制如下：
- 已記錄複習意願，但尚未實現間隔重複或自動複習提醒。
- 出題質量依賴當前模型；保存前應檢查題目與解析是否可靠。
- 已保存題目暫不支持編輯和版本歷史。
- 題庫目前跟隨單個 DSH storage 配置，不提供跨設備同步界面。
插件 bundle 默認配置如下，可在 DSH profile patch 中覆蓋：
maxDrafts: 50
maxQuestionsPerBatch: 10
maxSourceChars: 16000
maxGenerationTokens: 4096
generationTimeoutMs: 60000
generationTimeoutMs 同時約束模型請求；關閉題庫抽屜也會主動取消當前請求。
鏈接¶
- GitHub：https://github.com/cungphammanh590-star/dsh-quiz
- 目錄頁：如使用 DeepSeek Harness 插件目錄，可按名稱
dsh-quiz查找；本頁未提供具體目錄 URL。
