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