前言¶
在 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 仓库。
