在 DeepSeek Harness（DSH）的對話中，遇到專業術語或縮寫時，直接中斷上下文去搜索定義往往不夠高效。dsh-term-glossary 插件旨在解決這一問題：它允許在對話中選中術語後，通過旁路模型調用即時獲取解釋，而不佔用當前會話的上下文和輪次。

核心功能¶

該插件聚焦於提升閱讀效率，主要能力如下：

• 就地解釋：選中對話中的術語後，就地彈出解釋框，顯示基本含義、用途和常見用法。
• Token 可視化：解釋框底部會顯示本次回答消耗的 Token（輸入/緩存/輸出/合計）。
• 旁路調用：解釋通過獨立的模型調用完成，不佔用當前會話的輪次與上下文，也不寫入會話日誌。
• 領域適配：插件會讀取當前會話的標題和最近用戶消息，判斷術語所屬領域（如計算機、醫學等），並使用該領域的通用說法進行解釋。
• 多選支持：支持連續選中多個術語並分別發起解釋。
• 限流保護：限制同時 2 個查詢，每分鐘 20 次，防止腳本循環調用。

安裝與啓用¶

前置條件：需要使用帶 Web 界面的 DSH（Desktop 應用或 dsh web 命令啓動），且宿主依賴 webServer 和 llm。

安裝命令如下：

dsh plugin --profile <profile 名稱> add dsh-term-glossary

安裝完成後，按 Ctrl + R 刷新頁面即可使用。

使用方法¶

1. 在 DSH 對話的正文區域選中一個術語，選區旁會出現“搜索”按鈕（此時不會發起任何請求）。
2. 點擊該按鈕，就地彈出解釋框並顯示加載進度。
3. 解釋框底部會列出本次消耗的 token（輸入/緩存/輸出/合計）與使用的模型。
4. 關閉方式：按下 Esc、點擊右上角 × 或點擊框外任意位置。

配置與限制¶

配置示例¶

在 profile 配置文件中添加 term-glossary 行進行配置：

- id: term-glossary
  name: dsh-term-glossary
  config:
    provider: deepseek-official
    model: deepseek-flash

兩項均省略時，使用 profile 的默認模型選擇。

行爲邊界¶

• 觸發區域：僅在正文選區觸發，輸入框或文本域不觸發。
• 交互限制：不支持框內追問，需在對話中繼續提問。
• 輸出限制：輸出上限爲 2400 token，隱藏推理 token 也計入上限。
• 安全邊界：路由僅監聽迴環地址（127.0.0.1），無額外鑑權。不要將 DSH Web 端點暴露到不可信網絡。

結尾¶

dsh-term-glossary 通過旁路查詢和領域適配，幫助開發者在閱讀長對話時快速理解術語，保持上下文連貫。安裝與使用無需複雜的配置，適合在需要頻繁查閱技術定義的場景下使用。