前言¶
在 DeepSeek Harness（DSH）裏讀長對話時，模型和用戶消息裏常出現縮寫、推理框架名或領域術語。若每次都要切到搜索引擎或自建文檔，會打斷閱讀節奏。社區裏也有在側欄掛詞庫、或通過模型工具查釋義的做法，往往伴隨額外 UI 或請求鏈路。
下面介紹維護者 AlyceStocking 發佈的客戶端插件 hover-glossary：鼠標停在用戶或助手已發送的聊天正文詞語上，在瀏覽器內展示該詞的 1..N 條釋義，不發送模型請求、不註冊模型工具、也不改系統提示詞。
這是什麼¶
hover-glossary 是 DSH 的可持久安裝瀏覽器插件（Cordis 動態插件），分類爲客戶端。npm 包名與倉庫名均爲 hover-glossary，當前版本 1.1.0（MIT 許可證）。
詞庫與查詢完全在瀏覽器內完成；沒有額外的詞庫面板或啓動診斷卡片。倉庫內附帶 glossary-mapping 技能（.dsh/skills/glossary-mapping/SKILL.md），用於維護詞庫與構建流程。
核心功能¶
懸停釋義¶
例如懸停 WHO 可看到類似「1. 世衛組織（縮寫）；2. 誰（代詞）」的多條聯想，條數由詞庫登記決定。
詞庫內容¶
當前詞庫包含 GLM-5.3-Flash、vLLM Ascend 等推理相關術語；具體條目以安裝包內構建產物爲準。
匹配規則（摘要）¶
- 英文大小寫與全角形式歸一：
who、Who、ＷＨＯ視爲同一詞；WHOLE不會誤匹配WHO。 - 連續中文正文按最長詞匹配，例如「即世界衛生組織發佈報告」可匹配「世界衛生組織」。
- 英文短語目前從第一個詞命中，例如懸停
United Nations時以United爲查詢起點。 - 作用範圍限於用戶/助手聊天正文，跳過側欄、設置、按鈕、鏈接和編輯中的輸入框。
- 查詢限定單個 DOM 文本節點；跨多個樣式節點拆開的詞或短語不會拼接查詢。
與模型、UI 的邊界¶
插件不發送模型請求、不註冊模型工具、不添加系統提示詞。調試時可在控制台查看 globalThis.__hoverGlossaryDiag__，用於詞庫數量與取字 API 檢查結果。
安裝與啓用¶
用 DSH 自帶的插件管理命令安裝；包裝完成後可在「設置 → 插件」中啓停、移除。
Desktop：
# 從 npm 安裝
dsh plugin --profile desktop add hover-glossary@1.1.0
# GitHub 源碼安裝（當前可用）
dsh plugin --profile desktop add github:AlyceStocking/hover-glossary
安裝後完全退出並重新打開 Desktop 應用。
Web： 將命令中的 desktop 換成 web，然後重啓 dsh web，通過啓動時打印的認證 URL 打開頁面。
僅更新瀏覽器 bundle 時通常刷新即可；若變更 manifest 或裝配邏輯，應重啓並驗證。包與詞庫在磁盤上，重啓後會重新裝載。
維護者說明：不要用手動複製到 node_modules 並編輯 cordis.patch.yml 的方式安裝——插件可能能運行，但不會出現在 profile 的插件管理 UI 中；也不要用只駐留進程內存的 cordis_define / cordis_run 代替 profile 安裝。
典型用法與詞庫更新¶
日常使用無需配置：在已有對話消息的正文詞語上懸停即可查看釋義。
若要擴展或修改詞庫，唯一源文件爲 src/seed-data.mjs，條目格式如下：
TERM: [
{ text: '第一解釋', kind: '縮寫', weight: 100 },
{ text: '第二解釋', kind: '代詞', weight: 10 },
],
weight 越大排序越靠前；相同權重保留登記順序。改動後運行：
node scripts/build-client.mjs
node test/run.mjs
然後重新安裝插件並刷新驗證。完整流程見倉庫內 glossary-mapping skill。
版本兼容與驗證情況¶
README 記載：已完成 DSH Desktop 0.2.0-rc.2 的包安裝、註冊和入口檢查，桌面懸停效果尚未驗收。原有真實瀏覽器驗證環境爲 Harness CLI 0.1.5-rc.1 / 客戶端組件 0.1.5-rc.2（含 Edge）。其他 DSH 版本需自行覈對聊天 DOM 標記與 Slot 契約。
倉庫提供 16 個 Node 用例及真實瀏覽器腳本；維護者發佈 npm 包前會運行 npm test、npm pack --dry-run，確認 lib/client.js 與詞庫已同步。
適用場景與注意¶
適合： 經常在 DSH 客戶端/Web 界面閱讀對話、希望就地消歧縮寫與術語的開發者或使用者；需要離線式、無模型開銷的輕量 glossary 時。
注意：
- 插件隨當前 DSH 進程與客戶端注入邏輯運行，安裝前應閱讀源碼與 MIT 許可證，確認符合你的安全與合規要求。
- 英文多詞短語、跨節點排版等邊界見上文「匹配規則」；行爲以倉庫 README 爲準。
- 社區目錄 SkillHub 插件頁 與 GitHub 爲獨立收錄渠道；DSH 生態強調「一切皆插件」，目錄站點與 DeepSeek / 幻方無官方從屬關係。
