在 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 通过旁路查询和领域适配，帮助开发者在阅读长对话时快速理解术语，保持上下文连贯。安装与使用无需复杂的配置，适合在需要频繁查阅技术定义的场景下使用。