Lzh3070/dsh-search-hub

dsh-search-hub

DeepSeek Harness 的联网搜索多入口管理中枢 · Multi-entry web search hub for DeepSeek Harness

English · 简体中文

设置预览

English

DeepSeek Harness 内置的联网搜索是单一固定通道（deepseek-official，即一次兼容 Anthropic 的 Messages 调用，并使用服务端 web_search 工具）。dsh-search-hub 将该通道转变为一个可配置的中枢：

- 多个搜索入口，且恰好只有一个处于激活状态。 每个入口 = 标签 + 协议厂商 + baseURL + 模型 + API-key 环境变量名。在设置页面中一键切换——无需重启，provider 会为每次搜索快照配置。
- 两个协议适配器：
- anthropic —— Anthropic Messages + 原生 web_search_20250305 工具（覆盖 DeepSeek 官方；待验证后可支持 Kimi Coding 端点）；
- zai —— 智谱独立的 Web Search API（POST {base}/web_search）：确定性检索，无模型轮次、无工具调用裁量——每次调用就是一次搜索。可与 GLM Coding Plan 密钥配合使用。
- dsh 设置对话框中的顶层「搜索」标签页：每个入口的卡片列表、单选式激活、通过模板（DeepSeek / GLM / Kimi 占位）添加/编辑/删除。内置入口不可删除。
- 干净的降级。 bundle 补丁将 web 能力指向该中枢；移除 bundle 后，组合会自动回退到你之前的 provider。

测试环境

| | |
|---|---|
| DeepSeek Harness | 0.1.1-rc.2（web profile） |
| GLM Coding Plan（zai 适配器） | 已针对 https://api.z.ai/api/paas/v4（以及 /api/coding/paas/v4 变体）验证真实搜索，返回结构化来源 |
| DeepSeek 官方（anthropic 适配器） | 与内置 provider 相同的传输格式 |
| Kimi Coding（anthropic 模板） | 仅模板——尚未探测端点对 web_search_20250305 的支持 |

安装（dsh web profile）

仓库在 lib/ 下附带预构建产物，因此安装机器上无需构建工具链。

1. 在 /profiles/web/package.json 中添加依赖和 bundle 行：

"dependencies": {
"dsh-search-hub": "git+https://github.com/Lzh3070/dsh-search-hub.git"
// 或本地检出：
// "dsh-search-hub": "link:D:/path/to/dsh-search-hub"
},
"dsh": { "profile": { "bundles": [
// ... 现有行 ...
"dsh-search-hub"
] } }

2. 安装：

npx -y @deepseek-ai/dsh plugin --profile web install

3. 重启 Harness，打开 设置 → 搜索，选择激活的搜索模型。

工作原理

chat session ── web_search tool ──▶ ctx.web seam ──▶ search-hub provider
│ active entry
┌───────────────┴────────────────┐
vendor: anthropic                  vendor: zai
POST {base}/messages             POST {base}/web_search
tools:[web_search_20250305]       { search_query, search_engine }
→ web_search_tool_result blocks   → search_result[] items

设置持久化在 /settings.yaml 的 search-hub: 命名空间下。只存储环境变量名（例如 ZAI_API_KEY）；实际的密钥保留在凭据存储中（在「设置 → 模型」页面管理）。每次搜索都会对该配置节做快照，因此编辑会在下次调用时生效，无需重新注册任何内容。

安全说明

- 搜索是从 Harness 宿主进程到你配置的任意 baseURL 的普通 HTTPS 调用——请像对待原厂 provider 的 base-URL 覆盖一样谨慎对待条目配置。
- anthropic 适配器会按相应套餐计为一次完整的模型轮次（服务端搜索在 Messages 调用内运行）。zai 适配器是确定性的按次调用搜索 API——不消耗模型轮次——但仍会按请求计入你的智谱/GLM 配额。
- 智谱搜索结果可能不带 URL；带有 allowLinkless: true 的条目会将其映射为 zhipu-websearch:// 占位 URL，以便标题和摘要仍能传递给模型。

开发

npm install                 # tsdown + typescript + pinned @deepseek-ai type deps
npm run typecheck
npm run build               # lib/index.js (Node ESM) + lib/client.js (browser CJS)
DSH_HOME= node scripts/test-zai-adapter.mjs "query"   # live zai adapter test

需要 Node.js ≥ 22。

许可证

MIT

中文

DeepSeek Harness 自带的联网搜索是单一固定通道（deepseek-official，Anthropic 兼容 Messages 请求挂服务端 web_search 工具）。dsh-search-hub 把这条通道变成可配置的搜索中枢：

- 多条目、唯一生效：每条 = 名称 + 协议（vendor）+ baseURL + 模型名 + key 环境变量名；设置页一键切换，配置按次快照，即时生效不重启；
- 两种协议适配器：
- anthropic —— Anthropic Messages + 原生 web_search_20250305（覆盖 DeepSeek 官方；Kimi Coding 端点验证通过后直接可用）；
- zai —— 智谱独立 Web Search API（POST {base}/web_search）：确定性检索，不消耗模型轮次、模型无权跳过——每次调用必是一次搜索。GLM Coding Plan 的 key 可直接用；
- 设置对话框顶层「搜索」标签页：条目卡片列表、单选激活、新增（内置 DeepSeek/GLM/Kimi 模板）/编辑/删除，内置条目锁删；
- 卸载即回落：bundle patch 把 ctx.web 的 searchProvider 接管到本插件，移除 bundle 后自动回落原通道，无需手工改配置。

已验证环境

| | |
|---|---|
| DeepSeek Harness | 0.1.1-rc.2（web profile） |
| GLM Coding Plan（zai 适配器） | 已对 https://api.z.ai/api/paas/v4（及 /api/coding/paas/v4 变体）实测真实搜索，返回结构化来源 |
| DeepSeek 官方（anthropic 适配器） | 与官方 provider 同 wire 格式 |
| Kimi Coding（anthropic 模板） | 仅模板占位——端点对 web_search_20250305 的支持尚未探针验证 |

安装（dsh web profile）

仓库内含预构建产物 lib/，安装机器无需任何构建工具链。

1. 在 /profiles/web/package.json 加入依赖与 bundle 行：

"dependencies": {
"dsh-search-hub": "git+https://github.com/Lzh3070/dsh-search-hub.git"
// 本地开发调试可用：
// "dsh-search-hub": "link:D:/path/to/dsh-search-hub"
},
"dsh": { "profile": { "bundles": [
// ...原有行...
"dsh-search-hub"
] } }

2. 安装：

npx -y @deepseek-ai/dsh plugin --profile web install

3. 重启 Harness，打开 设置 → 搜索，选择生效的搜索模型。

工作原理

会话里的 web_search 工具经 ctx.web seam 进入本插件的统一入口，按当前生效条目分发到对应协议适配器。配置持久化在 /settings.yaml 的 search-hub: 命名空间下；只保存 key 的环境变量名（如 ZAI_API_KEY），明文密钥仍在凭据体系（设置 → 模型）里管理。

安全说明

- 搜索是从宿主进程向你配置的 baseURL 发起的普通 HTTPS 请求，请像对待官方通道的地址覆盖一样谨慎填写；
- anthropic 适配器按一整轮模型调用计费（服务端搜索跑在 Messages 请求里）；zai 适配器是确定性的按次检索 API——不走模型轮次——但每次请求仍计智谱/GLM 额度；
- 智谱结果可能不带 URL；开启 allowLinkless 的条目会映射成 zhipu-websearch:// 占位链接，标题与摘要照常传给模型。

开发

npm install
npm run typecheck
npm run build
DSH_HOME= node scripts/test-zai-adapter.mjs "query"   # 直调 zai 适配器真实搜索

需要 Node.js ≥ 22。

许可证

MIT