前言¶
在 DeepSeek Harness（DSH）裏寫智能體、調模型，往往佔滿整塊時間；想練口語表達，又要單獨開 App 或網頁，和當前工作環境脫節。社區插件 dsh-english-break（界面名「英語空檔」）把短時段英語練習嵌進 DSH 原生側欄與右側面板：日常口語、工作場景、造句反饋與間隔複習都在本地進度裏完成，模型調用走 DSH 已配置的 LLM，不混入工作會話。
下面介紹插件定位、能力、安裝方式與典型用法；事實均來自項目 README 與 package 聲明。
這是什麼¶
dsh-english-break 是 qiufengsir 獨立維護的開源 DSH 社區插件，MIT 許可。定位是：在休息空檔做日常對話與工作英語練習，含 AI 隨機話題預覽、造句反饋、連續對話與糾錯追問、表達收藏與間隔複習、草稿與 JSON 導入導出。
分類上屬於模型推理類插件：提交反饋、追問或生成隨機話題時會調用所選模型，可能產生服務用量。插件不讀取工作對話、源碼或剪貼板；學習數據保存在 DSH home 的 storages/dsh-english-break（默認 state.json）。
兼容 DSH 0.2.1-rc.3（package.json 中 engines.dsh 與 peer 依賴一致）；其他 DSH 版本尚未在資料中驗證。
核心功能¶
練習內容與模式¶
- 練習頁「全部 / 日常口語 / 工作英語」決定下一個話題類型，不會切換當前正在做的練習。
- 內置場景：資料寫明側欄入口包含 6 個日常、6 個工作場景，漸進提示、造句反饋、再次表達、收藏與到期複習；未配置模型時仍可用參考句練習。
- 「AI 隨機話題」由所選模型即時生成情境與開場白，不是聯網新聞檢索；生成前需已選模型。換題兩步：先生成預覽，再點「開始這個話題」；可「返回上一話題」在最近一對話題間切換，預覽與上一話題隨學習記錄持久化。
對話與反饋¶
- 對話不再在第 3 次回應後強制結束；由用戶點擊「結束本輪」。完整歷史在本地；模型側只帶最近 6 次回應，避免單次請求無限膨脹。
- 每條造句反饋下可「追問這條反饋」（可用中文質疑、要原因或例子），連續追問，不佔造句輪次；每條反饋最多追問 20 次。追問走後臺任務與進度查詢，支持取消；重新表達會替換該次反饋及討論。
- 收藏句子保留當前對話，可繼續輸入；首次收藏次日複習。收藏不代表已掌握。
模型與界面¶
- 默認「跟隨 DSH 系統默認模型」，每次請求讀取
agentDefaultModel.currentSelection()（含思考檔位）；系統默認變更在下一次練習生效。設置裏可手動選插件專用模型。 - 單次輸出預算上限 16384 tokens，服務端最多等待 180 秒；追問正文最多保存 32000 字符。
- 原生主面板與右側面板，適配小窗口滾動。左側「英語空檔」或會話右側「英語空檔」均可打開；設置裏選好 DSH 已配置的模型後，可點「練兩分鐘」。
當前僅支持文字表達，不提供語音識別或發音評分。
安裝與啓用¶
這是非官方社區插件，安裝前建議自行查看 GitHub 源碼與 LICENSE。插件以當前 DSH 進程權限運行。
預構建包（推薦）¶
從 Releases 下載最新 .tgz，在 DSH 插件安裝入口選文件，或完全退出桌面版後執行：
dsh plugin --profile desktop add ./dsh-english-break-0.3.0-alpha.2.tgz
預構建包無需授權源碼構建腳本。資料中示例版本爲 0.3.0-alpha.2；安裝請以 Releases 頁最新包名爲準。
從 GitHub 源碼安裝¶
dsh plugin --profile desktop add github:qiufengsir/dsh-english-break#v0.3.0-alpha.2
包內 prepare 會執行構建。pnpm 10+ 首次可能拒絕構建；按終端提示，將打印的確切包鍵寫入該 profile 的 pnpm-workspace.yaml，例如：
allowBuilds:
dsh-english-break: true
只爲可信源碼授權；建議將版本標籤換成本次發佈的固定提交 SHA。無需改 DSH 安裝目錄，dsh.bundle.patch 會註冊插件。
插件市場索引（可選）¶
在 DSH 啓用「實驗性插件 → 自定義插件市場」，於「插件 → 發現 → 添加索引源」填寫：
https://qiufengsir.github.io/dsh-english-break/index.json
此爲項目自維護源，非 DSH 官方默認收錄。Pages 不可用時可用：
https://raw.githubusercontent.com/qiufengsir/dsh-english-break/main/docs/index.json
Git 來源安裝仍可能需要上述 allowBuilds 授權。
首次啓用後，在側欄打開「英語空檔」即可。打包安裝與本地開發補丁（node scripts/desktop-local.mjs install）不要同時啓用。
典型用法¶
- 在插件設置中選擇 DSH 已配置的模型（或保持跟隨系統默認）。
- 從左側「英語空檔」或會話右側入口打開面板，點擊「練兩分鐘」開始。
- 按情境用英語回應，查看造句反饋；需要時對某條反饋「追問」，或「再次表達」替換該輪反饋。
- 滿意表達可收藏；到期條目會進入複習流程。草稿約 400ms 防抖保存，切換面板後仍保留。
- 想換情境：選分類後使用「AI 隨機話題」或內置換題流程，預覽確認後再「開始這個話題」。
- 備份與遷移：在設置中 JSON 導出；導入會替換當前進度，操作前請先導出備份。
模型調用會將練習內容發給 DSH 所配置的模型服務；費用與速度取決於所選服務，資料中的自動化測試未測量真實服務用量。
適用場景與注意¶
適合：已在 DSH 桌面版（profile desktop）工作、希望把 English break 留在同一客戶端裏的開發者或知識工作者；需要結構化反饋、收藏與間隔複習而非單純背詞 App 的用戶。
注意：
- 僅驗證與 0.2.1-rc.3 的兼容；升級 DSH 前請對照倉庫
engines與 issue。 - 所有 LLM 相關操作可能計費；無模型時僅能參考句靜態練習。
- 學習記錄位於用戶 DSH home，卸載插件前請導出 JSON。
- 真實模型反饋質量、Electron 全量交互與 README 中的固定響應測試不等同；自行評估是否滿足學習目標。
結尾¶
dsh-english-break 把日常與工作英語練習做成 DSH 內的原生面板：短會話、可追問的反饋、本地進度與可選市場索引安裝，適合在寫 Harness 的間隙練表達。社區目錄與 GitHub 如下，安裝命令以 README 爲準。
- 目錄頁：https://www.skillhub.cn/plugins/qiufengsir/dsh-english-break
- 倉庫：https://github.com/qiufengsir/dsh-english-break
