术语解释器 Midnight-1991/dsh-term-explainer

dsh-term-explainer

给 DeepSeek Harness 已完成的助手回答加一个 术语 操作：识别回复里的计算机术语，弹出面板，展示中文解释、出现次数和高亮上下文。解释本身也认术语——点击任意解释里的虚线下划线术语，就能钻到它自己的解释，再逐级返回。

为 DeepSeek Harness Web 界面增加「术语」入口：自动识别每条已完成回答中的计算机领域专有名词，一键弹出中文解释面板。

- 纯前端：只注册 UI 槽位，不改宿主 DOM，不挂第二个 React 根节点。
- 离线词典：内置 330 条术语（11 个分类），不调用模型、不发起网络请求、不产生 token 费用。
- 次级解释：解释文本里的其他术语会自动变成可点击链接，点开继续查看下一层；支持多层钻取、逐级返回，并防止同一术语自我循环。
- 零干扰：没有识别到术语时不渲染任何按钮；解释面板仅在你点击时打开。
- 主题与语言：只用 Harness 主题令牌，深浅色自适应；界面文案跟随 zh / en。
- 可访问：role="dialog" + aria-labelledby、焦点随视图移动（进入下一层聚焦返回按钮，退回时聚焦来源术语）、Tab 焦点循环、Esc 逐级返回/关闭、尊重 prefers-reduced-motion。

使用

1. 在一条已完成的技术回答的操作条里出现 术语 N 胶囊按钮（N = 唯一术语数）。
2. 点击打开面板：每个术语展示名称、英文全称、分类、提及次数、中文解释，以及最多 3 处可展开的原文上下文（术语高亮）。
3. 解释中的其他术语带虚线下划线：点击它会把面板切到该术语的解释（标题换成它、左侧出现返回按钮），可以继续往下点，形成多层钻取。
4. Esc 或左上角返回按钮退回上一层；在术语列表页按 Esc、点击遮罩或关闭按钮关闭面板。

入口只出现在已完成的 Assistant 消息上，行为与官方反馈按钮一致。

安装

方式一：插件市场（上架后）搜索 “Term Explainer” 安装。

方式二：从 npm 安装：

dsh plugin --profile web add dsh-term-explainer

方式三：从 GitHub 安装（需要本机已安装 dsh）：

dsh plugin --profile web add github:Midnight-1991/dsh-term-explainer

方式四：本地开发时直接用目录安装：

dsh plugin --profile web add /path/to/dsh-term-explainer

安装后刷新 Harness 页面即生效，插件管理页可随时禁用或卸载。

词典

内置 330 条计算机术语，分 11 类：编程语言与范式、前端与 Web、后端与架构、数据库与存储、网络与协议、云原生与 DevOps、安全与加密、AI 与大模型、系统与底层、工程实践、DeepSeek Harness。

扩展词条只需在 client.js 的 GLOSSARY 数组里加一行：

// [规范名称, 英文全称, 分类, 中文解释, { aliases: ['别名'], cs: true }?]
['MCP', 'Model Context Protocol', 'ai', '模型上下文协议：让模型以标准方式调用外部工具与数据源。'],

匹配规则：

- 拉丁术语按词边界匹配（API 不会命中 OpenAI），默认大小写不敏感；cs: true 表示大小写敏感（React 不会命中小写 react）。
- 中文术语按子串匹配；同一位置重叠时长词优先（缓存穿透 优先于 缓存），不重复计数。
- 匹配器惰性构建并带小写预筛，40 KB 文本扫描约 25–40 ms；结果按消息文本缓存，聊天流更新不会重复扫描未变化的消息。

开发与测试

npm test # node scripts/smoke.mjs

冒烟测试在 Node vm 中加载真实的 client.js，用极小的 React / Cordis 替身驱动两个组件，覆盖：locale 注册、槽位注册、词边界与大小写、重叠长词、Markdown 上下文清理、aria-labelledby、释义内术语链接（含自我引用排除）、两层钻取、返回按钮、Esc 逐级退栈、关闭逻辑、40 KB 文本性能。

目录：

| 文件 | 说明 |
| package.json | Bundle 清单（dsh.bundle + dsh.client.platform = web） |
| cordis.patch.yml | 向 Profile 插入插件行的组合补丁 |
| index.js | Host 半：空实现（能力全部在浏览器端） |
| client.js | Client 半：词典 + 扫描器 + 消息入口 + 解释面板（自包含，无构建步骤） |
| PROMPT.md | 驱动本实现的需求提示词（保留以便溯源） |
| scripts/smoke.mjs | 离线冒烟测试 |

更新日志

- 1.1.0：解释文本中的术语可点击，支持多层次级解释与逐级返回。
- 1.0.0：首个版本：术语识别、消息入口、解释面板、330 条离线词典。

隐私

插件不读取文件、不发起网络请求、不写本地存储，所有解释来自打包在 client.js 内的词典；扫描只处理当前消息的正文文本，并在内存中完成。

License

MIT