前言¶
在 DeepSeek Harness（DSH）裏和 agent 聊架構、讀技術回覆，常會遇到一串縮寫、標識符寫法或項目專有名詞。查完解釋往往就散在聊天記錄裏，下次遇到同一個詞還要重新問。手工記筆記可以，但和「對話即工作流」的節奏不太合拍。
下面介紹維護者 lakerian 發佈的 術語詞典（npm 包名 dsh-plugin-term-dictionary，當前版本 1.1.4，MIT 許可證）。它在 agent 回覆渲染完成後掃描文本，按規則自動收錄生僻術語；已進個人詞典的詞在對話裏可懸停看解釋、點擊進入詞條；也可以選中詞句一鍵建條。術語檢測與內置詞庫查詢在瀏覽器本地完成，不爲此髮網絡請求；需要模型補全解釋時，才走 host 側的 llm 服務。
這是什麼¶
術語詞典是 DSH 的 Web 客戶端插件：左側插件區出現「術語詞典」入口，中間主區域是詞典面板；同時在對話區對詞條做標註與交互。它面向長期在 DSH 裏做技術對話、希望把「剛搞懂的詞」沉澱成可檢索條目的用戶。
社區目錄 SkillHub 與 GitHub 倉庫 lakerian/dsh-plugin-term-dictionary 是獨立信息源，與 DeepSeek / 幻方無官方從屬關係；DSH 本身遵循「一切皆插件」的擴展方式。
核心功能¶
自動收錄與標註¶
agent 回覆渲染完成時，插件掃描英文技術詞、縮寫、標識符風格命名（如 camelCase、snake_case）以及內置詞庫中的中文行業術語，爲置信度最高的若干條建立詞條。已收錄進個人詞典的詞在回覆中會以虛線下劃線和輕微底色標出（依賴 CSS Custom Highlight API；不支持時靜默降級，懸停與點擊仍可用）。
自動收錄不是「全文搬運」。README 歸納的三條門檻如下：
- 須有術語證據（縮寫或標識符寫法等）；普通英文散文、常用詞不會自動建條。
- 內置詞庫已能解釋的詞（如
quorum、idempotent）不再自動收錄，但仍可懸停/點擊查看解釋，也可手動加入詞典。 - 用戶曾刪除過的詞，自動通道不再收錄，除非手動加回。
示例（來自倉庫說明）：WriteAheadLog、DSN 會建條；quorum / Kubernetes 不會自動建條；the 等常用詞不會建條。
詞典面板¶
點擊左側「術語詞典」後，可在面板中搜索，並按「全部 / 待補充 / 已釘選 / 已標記 / 已刪除」五個視圖瀏覽。支持編輯、釘選、刪除、撤回刪除，以及把詞條放進分組。二級頁包括設置、導入 / 導出、詞條包。
設置頁頂部有三個開關：自動收錄、劃出術語、自動解釋（關閉後的行爲見 README「三個功能開關」一節）。
對話區交互¶
對已收錄或內置詞庫命中的詞，README 約定三種手勢：
| 手勢 | 行爲 |
|---|---|
| 鼠標靠近（默認約 110ms，設置頁可調 0–200ms） | 浮出簡短解釋卡片 |
| 點擊 | 個人詞典詞條：進入面板並定位；內置詞庫詞：彈出解釋氣泡；未收錄詞：可創建或用模型生成解釋 |
| 選中詞句 | 出現「添加詞條」，打開編輯器並預填 |
來源字段 source === "dictionary" 表示個人詞條；source === "glossary" 表示內置詞庫（約 860 條英文技術詞與 240 條中文行業詞）。
解釋與數據¶
解釋來自內置詞庫、用戶編輯，或點擊「用模型生成解釋」時 host 調用當前 profile 的 llm 服務（路由選擇順序見 README）。詞典權威文件位於 $DSH_HOME/dsh-plugin-term-dictionary/dictionary.json；瀏覽器側有 localStorage 副本，並與 host 路由 /dsh-term-dictionary/* 同步。用戶自行編寫的解釋不會被自動收錄或模型結果覆蓋。
安裝與啓用¶
環境要求（來自 package.json）：DSH >=0.2.0-rc.2。
從插件市場安裝（README 推薦）：設置 → 插件市場 → 搜索「術語詞典」 → 一鍵安裝。
也可以直接安裝 npm 包（將 <你的 profile> 換成實際 profile 名）：
dsh plugin --profile <你的 profile> add dsh-plugin-term-dictionary
裝完後重啓 Host（host 與瀏覽器客戶端均在運行中的進程里加載）。包不攜帶 npm 依賴，也無需執行構建腳本。SkillHub 目錄頁顯示該插件當前爲可安裝狀態，版本 1.1.4。
典型用法¶
- 安裝並重啓 Host 後，在設置裏確認插件 bundle 與插件行均已啓用（README 開發說明中提到：bundle 被選中不等於行
enabled: true）。 - 與 agent 進行技術對話，觀察回覆中的自動建條與劃線；對內置詞庫已覆蓋的詞，靠近或點擊即可讀解釋，無需重複收錄。
- 遇到項目專有名詞，在回覆中選中詞或短語，點「添加詞條」，在面板中補全譯名與解釋；需要時可點「用模型生成解釋」（依賴 profile 已配置可用的
llm路由）。 - 在面板中使用導入 / 導出或詞條包，在多環境或備份場景下遷移詞條；用分組與釘選整理長期積累的條目。
適用場景與注意¶
適合誰：頻繁在 DSH 中閱讀英文技術回覆、需要個人術語表與上下文片段（單條約 240 字符上下文規則）的研發與運維人員。
權限與安全：插件以當前 DSH 進程權限運行。安裝前應閱讀 GitHub 源碼 與 LICENSE，自行判斷是否信任維護者 lakerian。README 明確說明 host 半側 /dsh-term-dictionary/* 路由沒有鑑權，僅監聽本機迴環；若部署形態變化（多用戶、遠程訪問），需先評估該設計是否仍適用。
其他限制（README 摘錄）：每條消息自動收錄上限爲 3 個新詞條；代碼塊整體不參與收錄與標註（正文段落中的行內代碼對已收錄詞仍可懸停/點擊）；模型解釋依賴 profile 掛載 llm 服務，不可用時其餘功能仍可用。
結尾¶
術語詞典把「對話裏出現的生僻詞」變成可搜索、可編輯、可導入導出的本地詞典，並在回覆區提供懸停解釋與一鍵建條，減少重複查詞的成本。如需安裝或查看更新說明，可訪問 SkillHub 目錄頁 與 GitHub 倉庫 README。
