SeerableOfficial/dsh-web-search-toggle

dsh-web-search-toggle

一个 DeepSeek Harness (DSH)
插件，在聊天输入框的工具行中添加一个 “Web Search” 切换按钮。
当它开启时，会指示智能体在回答之前必须搜索网络——与 DeepSeek Web Chat
UI 中的“Web Search”切换按钮一致。该切换是按会话（按对话）生效的，就像 DeepSeek 自身的
按对话切换一样。

功能特性

- 在输入框工具行中添加一个紧凑的胶囊形 “Web Search” 按钮。
未激活 = 中性轮廓；激活 = DeepSeek 品牌蓝，并带有一个小的绿色
“开启”圆点。
- 当开启时，注入一条强制性的系统提示指令，告诉智能体在
该会话的每一轮回答之前调用 web_search。
- 按会话保存状态，在重新加载和宿主重启后仍然保留。
- 遵循 DSH 的插件约定（dsh.bundle.patch + dsh.client），因此它
像任何其他 DSH web-profile 插件一样安装。

工作原理

- 客户端部分（lib/client.js）：将切换按钮注册到输入框的
工具行（conversation.input.left，即常驻的访问模式
/ 计划 / 附件控件旁边的位置）。切换时，它通过
客户端↔宿主 RPC 通道调用宿主。
- 宿主部分（index.js）：
- 提供一个 RPC 通道（/dsh-web-search），包含 websearch.get-state /
websearch.set-state，按会话存储该标志，并将其持久化到
~/.dsh/dsh-web-search-toggle.json。
- 注册一个系统提示区段（dsh-web-search:force），其文本在
每次提示组装时求值。当当前会话的标志为开启时，
它向系统提示中注入一条强制性的“你必须先调用 web_search”指令；
当关闭时，它渲染为空（空区段会消失）。

web_search 工具本身由 DSH 自己的 dsh-tool-web 包注册
（通过自动选择的 DeepSeek 搜索提供方接缝）；此插件只强制使用它。

为什么“强制”是一条指令，而不是硬性阻断

DSH 没有“模型必须在每一轮调用工具 X”的原语。因此，
强制执行的方式是一条强有力的、始终存在的系统提示指令——在这个 harness 中，
这是引导模型的最权威、最可靠的方式。模型会遵循它，
但遵从性是概率性的，而非有保证的（就像
DeepSeek 网页聊天 UI 本身一样）。

要求

- 带有 web profile 的 DeepSeek Harness（dsh --profile web）。
- 已配置的网络搜索提供方（内置的 DeepSeek 搜索提供方，或
任何提供 web_search 的提供方）。该插件强制使用该工具；它并不
安装该工具。

安装

该插件已发布到 npm。在 DSH web profile 中：

via the dsh plugin command (recommended — reconciles the bundle list)
dsh plugin --profile web add dsh-web-search-toggle
或者直接用 pnpm（跳过 bundle-list 协调）：

cd
npx pnpm add dsh-web-search-toggle
then add "dsh-web-search-toggle" to dsh.profile.bundles in package.json

然后重启 DSH，以便 bundle 补丁在启动时组合：

dsh --profile web restart          # or your normal restart path

用法

1. 在 DSH Web UI 中打开一个对话。
2. 点击编辑器工具栏中的 Web Search 胶囊按钮将其开启。
3. 提出一个问题——agent 会先调用 web_search 并引用来源。
4. 将其关闭以恢复正常行为。

开/关状态按会话记忆。

文件

| 路径 | 用途 |
|---|---|
| package.json | 包 + dsh.bundle.patch + dsh.client 声明 |
| index.js | 宿主插件：RPC 通道 + 系统提示强制区段 |
| lib/client.js | 客户端插件：编辑器“Web Search”开关 |
| cordis.patch.yml | 挂载宿主部分的 bundle 补丁 |
| LICENSE | MIT 许可证 |
| README.md | 本文件 |

许可证

MIT