前言¶
在 DeepSeek Harness（DSH）裏讀英文對話、文檔或工具輸出時，常見做法是切到瀏覽器查詞，或複製整段去翻譯。上下文一斷，查完還要找回到原來的消息。DSH 社區把能力拆成插件；hulibuld/dsh-hover-dict 是客戶端插件，在對話正文裏單擊或劃選英文即可查釋義或翻譯，詞庫隨包離線，不改動正文 DOM。下面介紹它做什麼、怎麼用，以及安裝前需要注意的事項。
這是什麼¶
dsh-hover-dict（GitHub：hulibuld/dsh-hover-dict）由維護者 hulibuld 發佈，分類爲客戶端插件。當前目錄頁與倉庫 package.json 均爲 v1.2.0，許可證 MIT。
一句話定位：在 Harness 對話正文（含代碼塊、行內代碼、工具調用卡片裏的英文）裏，通過點擊或劃選觸發查詞與純英文段落翻譯；支持生詞本、詞根詞綴與同根詞標註，核心詞庫離線加載。沒有音標與發音。
宿主兼容性（來自 package.json）：DSH >=0.2.0-rc.1 <0.3.0-0。
核心功能¶
查詞與翻譯¶
| 操作 | 結果 |
|---|---|
| 單擊 / 雙擊 / 左鍵劃選一個英文單詞 | 小浮層：詞性、中文釋義、考綱標籤 |
| 左鍵劃選一段純英文 | 中文翻譯 |
| 左鍵劃選中英混排內容 | 不翻譯，給出提示 |
| 點小浮層 | 展開大卡片：全部義項、英英釋義、詞形變化、同根詞、詞根詞綴、雙語例句 |
| 點卡片上的 ☆ | 加入生詞本（再點取消） |
作用範圍只限對話正文；輸入框、模型選擇器、側欄、設置頁內不響應，避免干擾光標與菜單。
純英文才翻譯：選中內容裏漢字超過 10% 時不翻譯（中英混排多爲複製或引用場景）。
浮層不會自動消失；關閉方式：點浮層外、按 Esc、或重新選擇其他內容。選中詞不加底色或邊框，避免深色主題下遮擋文字。
生詞本與同根標註¶
浮層與卡片右上角星標表示是否已收藏。生詞本寫入 DSH 本地 KV（落磁盤），換瀏覽器或清站點緩存通常不會丟。
文檔中的標註含義：
| 顏色 | 含義 |
|---|---|
| 紅 | 詞本身在生詞本中（含變位，如收藏 run 則 ran / running / runs 標紅） |
| 藍 | 語義詞族內但未收藏（如查 care 時 careful / careless / carer 標藍） |
同根關係用派生規則判斷，而非字符串相似（例如 care 與 career 不會因前綴相同而關聯）。
設置裏可粘貼單詞表導入（一行一詞），支持識別有道、歐路、百詞斬等導出格式中每行第一個英文片段。
詞根詞綴¶
大卡片內展示拆解示例（README 摘錄）：
biography bio[詞根] 生命 · graph[詞根] 寫
telephone tele[詞根] 遠 · phon[詞根] 聲音
careless -less[形容詞後綴] 沒有
rewrite re-[前綴] 再
詞根詞綴庫覆蓋 6,374 個詞（約佔詞庫 31%）；策略是寧可漏拆也不誤判（詞幹存在、語義重疊等閘門，排除表過濾 understand、uncle 等假拆分）。
設置入口¶
在 DSH 設置 左側導航會多出 「英語翻譯」（排在「技能」與「費用」之間），含兩個標籤：
- 生詞本：收藏列表、搜索、單個移出
- 設置：翻譯接口、詞庫管理、生詞本導入導出、顯示參數
插件不另掛詳情頁或側邊欄圖標。
離線詞庫¶
隨包分發、完全離線：
| 包 | 內容 |
|---|---|
| 核心詞庫 | 20,499 個考綱核心詞（中考/高考/四六級/考研/託福/雅思/GRE） |
| 詞根詞綴庫 | 6,374 個詞的拆解 |
| 雙語例句庫 | 8,960 個詞的中英對照例句 |
宿主側 index.js 爲詞庫文件提供靜態路由（帶 ETag 與 gzip）；客戶端爲構建產物 client.js，運行期依賴爲零。
安裝與啓用¶
SkillHub 目錄頁（https://www.skillhub.cn/plugins/hulibuld/dsh-hover-dict）標註該插件可安裝、分類爲客戶端，並與 GitHub README 內容一致。已抓取資料中未給出 dsh plugin add … 一類 CLI 安裝命令，此處不憑倉庫名拼接命令。
建議做法：
- 在 SkillHub 打開上述目錄頁，按頁面提供的安裝方式安裝到當前 DSH 環境。
- 安裝前確認 DSH 版本滿足
>=0.2.0-rc.1 <0.3.0-0，並閱讀倉庫 LICENSE 與源碼。 - 插件以當前 DSH 進程權限運行；安裝第三方插件前應自行審查代碼與許可證，社區目錄與 DeepSeek / 幻方無官方從屬關係。
啓用後無需單獨打開插件頁；在對話正文裏直接使用查詞即可。生詞本與詞庫管理走設置 → 英語翻譯。
典型用法¶
閱讀對話與代碼塊中的英文¶
- 在助手回覆正文裏單擊某個英文單詞，查看浮層釋義與考綱標籤。
- 需要完整義項、例句或詞根時，點擊浮層展開大卡片。
- 閱讀報錯或命令說明時，可在代碼塊或行內代碼裏同樣單擊查詞（插件明確包含這些區域）。
翻譯一段純英文¶
左鍵劃選連續純英文（漢字佔比不超過 10%），得到中文翻譯。若選中了中英混排段落，會看到提示而非誤譯。
擴展詞庫¶
將自定義詞庫文件放入插件包內 data/packs/，重啓 DSH 後自動加載。
支持 ECDICT 格式 CSV（至少 word、translation 列）：
word,translation,definition,tag
serendipity,"n. 意外發現, 僥倖",luck,cet6
blockchain,n. 區塊鏈,a distributed ledger,
或與 dict.dat 同構的 JSON（數據契約見倉庫 docs/架構.md）。文件名僅允許小寫字母、數字、連字符，擴展名爲 .dat 或 .csv。
自行重建內置詞庫（維護者 / 進階）¶
若需更換語料或篩選口徑，在倉庫根目錄執行（README 原文）：
node scripts/build-data.mjs --src <原始數據目錄> --out data
腳本讀取該目錄下的 ecdict.csv 與三個 Tatoeba 文件，產出 data/dict.dat 與 data/meta.json。
適用場景與注意¶
適合：在 DSH 里長期讀英文對話、API 文檔片段、工具輸出與代碼標識符，希望少切換窗口、且接受離線考綱向詞庫的用戶。
注意：
- 無音標、無發音；翻譯接口可在設置中配置，但查詞主路徑依賴離線包。
- 不修改正文 DOM，也不給選區加高亮，浮層定位在詞旁。
- 星標爲 0 僅表示 GitHub 公開星標數，不代表功能完整度；問題可提 Issues。
結尾¶
dsh-hover-dict 把「讀 Harness 裏的英文」收成同一界面內的點選查詞、純英文劃選翻譯、生詞本與詞根輔助，並強調對話正文與代碼區域可用、離線詞庫隨包分發。目錄與版本信息見 SkillHub 插件頁，源碼與完整說明見 GitHub 倉庫。
