前言¶
在 DSH Go 裏做手機橋接時,常見需求是「屏幕上有題,希望不必逐題手查」。自己寫 OCR、切題檢測和通知鏈路,開發和維護成本都不低。下面介紹社區插件 dsh-go-exam-helper(維護者 aishenkiki):它盯住考試頁面,識別題目後把選項字母和答案文案推到頂部通知;可選本地 bank.json 優先查表,未命中再走你配置的讀圖模型。插件分類爲客戶端,僅在有 DSH Go 宿主且開啓手機操控時纔有實際行爲;在非 DSH Go 環境安裝後不會執行上述邏輯。
這是什麼¶
答題助手(Exam helper) 是 DeepSeek Harness 的 DSH Go 插件(package.json 中 engines.dsh 要求 >=0.2.1-rc.2 <0.3.0-0,當前包版本 1.0.0,許可 MIT)。一句話定位:讀屏識別「題幹 + A/B/C/D」類題目,切題時在客戶端彈出形如「第 N 題 · B」的通知;命中自建題庫時通知會帶 📚 前綴並附帶選項原文摘要。
核心功能¶
盯屏與通知¶
插件依賴 DSH Go 的手機橋接讀屏。用戶在瀏覽器 H5、小程序或原生 App 等任意呈現「題 + 選項」的頁面上操作時,切題後會收到頂部通知,例如 第 7 題 · 📚 B 與 題庫:35週歲(題庫命中);未命中題庫時爲 第 7 題 · B。README 說明:有 bank.json 時查表約 1 秒,無題庫走模型約 2 秒。
可選本地題庫¶
把包內示例 bank.json.example 複製爲 bank.json,按同樣結構填寫題幹、選項與標準答案。命中題庫的題在通知中帶 📚;未命中則交給視覺模型,置信度低時答案會標 ?。
題型與模型¶
需要 DSH Go 並開啓手機操控,以及一個支持讀圖的模型(README 寫明 DeepSeek 賬號默認配置即可)。支持單選、多選、判斷;圖形推理題 README 標明正確率約 40%,仍會給出答案但不保證準確。
隱私與日誌¶
截圖僅用於識別題目,只發往用戶自行配置的模型,不經第三方。日誌記錄題目摘要與答案;失敗現場截圖最多保留 200 張,可通過 ctl.sh clean 清空。包內不含第三方題庫。
安裝與啓用¶
官方安裝方式如下(勿使用未在文檔中出現的 github:owner/repo 形式):
dsh plugin add dsh-go-exam-helper
也可在 DSH Go 的 插件 → 插件市場 中安裝。裝好後引擎重啓會把腳本部署到 ~/.dsh/dsh-go/exam-helper;目錄可通過環境變量 DSH_EXAM_DIR 修改。
安裝前建議瀏覽 GitHub 倉庫 源碼並確認 MIT 許可;插件以當前 DSH 進程權限運行,與任何 DSH 插件一樣,應自行評估信任邊界。
典型用法¶
經過上面的安裝步驟後,可按 README 流程使用:
- 打開考試頁面(只要是「題 + A/B/C/D」形態即可)。
- 點輸入框上方的 答題助手 · 未開始(英文界面爲 Exam · idle),在面板裏點「開始」。
- 切換題目時觀察頂部通知中的題號、選項字母與(可選)題庫摘要。
如需自建題庫,在運行目錄放置 bank.json,結構示例:
{ "items": [
{ "q": "題幹文字", "options": [
{ "letter": "A", "text": "選項一" },
{ "letter": "B", "text": "選項二" }
], "answer": "B", "source": "分類" }
] }
適用場景與注意¶
適合已在用 DSH Go 做手機讀屏、希望在答題/刷題場景減少手動查表操作的開發者或個人使用者。不適合期望「開箱即用海量題庫」的場景——官方明確不捆綁第三方題庫,命中率取決於自填 bank.json 或模型能力。
DeepSeek Harness 生態主張「一切皆插件」;SkillHub 目錄頁 爲社區收錄站點,與 DeepSeek / 幻方無官方從屬關係。查閱說明與 issue 請以 GitHub README 爲準。
結尾¶
dsh-go-exam-helper 把「讀屏 → 識題 → 通知」收成 DSH Go 裏的一條工作流:可選本地題庫提速,其餘交給自有視覺模型,並寫明隱私與日誌策略。進一步細節見目錄頁與倉庫: