dsh-english-search

在 DeepSeek Harness（DSH）会话区域最上方提供 vocabtool.com 风格搜索框的插件：查词 / 词源 / 问答三种模式，查词由 DSH 自身的 LLM 服务完成——不访问任何外部站点、不需要数据库、不需要本地后端。


安装

dsh plugin --profile web add dsh-english-search

安装后需重启 dsh web 服务生效。

卸载

dsh plugin --profile web remove dsh-english-search

功能

• 固定在会话区域最上方、独立于消息滚动区的搜索栏，使用 DSH WebUI 原生设计令牌（--dsw-alias-*），与输入框卡片同表面、同描边、同圆角、同阴影：查词/词源/问答文字切换 + 紧凑原生「查询」小胶囊，明暗主题自动跟随，无玻璃拟态、无渐变按钮；搜索栏宽度收窄为 520px（--es-bar-max-width）
• DSH 0.1.0-rc.6 尚无 conversation.top；插件通过官方 conversation.input.dock 管理生命周期，并用 React Portal 挂到会话根节点顶部
• 三种模式：查词 / 词源 / 问答（输入框无内置占位提示文案）
• 快捷前缀：!arena 直接词源、?lie 和 lay 的区别 直接问答
• 结果面板样式与落地页一致（loading / error / 同款结果卡片 + 关闭按钮），内容渲染 Markdown（加粗 / 列表 / 标题 / 引用 / 行内代码）
• 查词走 DSH 当前会话默认模型（agentDefaultModel），与对话共用模型配额

架构

浏览器 (Client)                            DSH Host
┌──────────────────────────┐  fetch   ┌──────────────────────────┐
│ input.dock + React Portal │ ───────► │ webServer 路由            │
│ 会话区域顶部搜索栏         │ POST     │ /api/plugins/english-search│
│ React + 手写 bundle      │  ◄────── │  → ctx.llm.stream()       │
└──────────────────────────┘  JSON    │  (当前默认模型, effort=off │
                                      │   失败自动回退无 effort)   │
                                      └──────────────────────────┘

• Host（[lib/index.js](lib/index.js)）：注册 webServer 路由，经 ctx.get('llm') + ctx.get('agentDefaultModel') 调用 DSH 模型；三套系统提示词与 vocabtool.com 后端一致（源自 MIT 项目 kami-mura/vocabtool-web）
• Client（[lib/client.js](lib/client.js)）：手写 CJS bundle（与 tsdown clientBundle 产物同格式：window.__ModuleLoader__.load({ id, factory })），注册在 conversation.input.dock 插槽（id english-search），再通过 React Portal 固定到会话根节点顶部；同源 fetch 调用 Host 路由；样式全部使用 DSH WebUI 设计令牌（--dsw-alias-* / --dsw-specific-input-major / --dsw-shadow-lv2 / --dsw-font-family）并复用 --dsh-composer-* 宽度轴，与输入框卡片视觉一致、明暗主题自动跟随
• 无外部 HTTP 调用、无 Cookie、无数据库、无本地服务、无构建步骤

安装说明

该包是标准 dsh bundle（dsh.bundle.patch），dsh plugin add 会自动把它加入 profile 的层栈（dsh.profile.bundles），无需手改任何配置文件。

从 GitHub 安装：

dsh plugin --profile web add github:kami-mura/dsh-English-search

> 依赖 DSH 运行时能力：Host llm / agentDefaultModel / webServer 服务；Client slots 服务与 react 平台模块（DSH 内置）。包名 dsh-english-search（npm 命名规范，全小写）。

安装（动态插件，快速体验）

不安装部署时，也可在任意 DSH 会话中通过 cordis_define 动态运行：

1. cordis_define：plugin.kind: "new"，idPrefix: "vocab" - code.host ← 粘贴 [plugin.host.js](plugin.host.js) - code.client ← 粘贴 [plugin.client.js](plugin.client.js) 2. cordis_run 激活（Client 包首次需批准一次）

动态插件运行环境不提供 react-dom，所以动态版显示在输入框上方；通过 npm/GitHub 安装的原生插件才固定在会话区域最上方。

常见问题

安装后看不到搜索框？

按顺序排查：

1. 确认版本 ≥ 0.4.2：运行 dsh plugin --profile web list 查看已安装版本。0.4.0 及更早版本使用 conversation.top 插槽，而 DSH 0.1.0-rc.6 不存在该插槽，搜索框不会渲染——这是 0.4.2 修复的兼容问题，请升级：

``bash dsh plugin --profile web add dsh-english-search@latest ``

2. 重启 dsh web 服务：安装/升级插件后需重启服务进程（不是刷新浏览器页面）。按 Ctrl+C 停止当前 dsh web，再重新运行 dsh web。

3. 如果仍不显示，查看浏览器开发者控制台是否有 english-search 相关报错，并确认服务启动日志中无插件报错。

动态版与原生版显示位置不同？

动态版（cordis_define 方式）运行环境不提供 react-dom，搜索框显示在输入框上方；通过 npm/GitHub 安装的原生插件才固定在会话区域最上方。

文件

License

[MIT](LICENSE)