前言¶
在 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 / 幻方无官方从属关系。
