Z.AI 网页搜索 Canary-Builds/dsh-web-search-zai

DSH Web Search Z.AI

为模型路由为 Z.AI / GLM 的 DeepSeek Harness（DSH）安装提供原生体验的 web_search，以单个无依赖的 Cordis 插件形式交付，用于宿主 web 接缝（ctx.web）。

随附的 harness 选择 deepseek-official 作为其搜索提供方，这需要一个真实的 DeepSeek API 密钥。在通过 zai 提供方运行 GLM 的安装中，只存在 ZAI_API_KEY——因此每次 web_search 都会以 HTTP 401 失败。本包注册了一个 zai-official 搜索提供方，它通过 Z.AI 的 Anthropic 兼容 Messages API 使用原生 web_search_20250305 服务器工具（glm-5.3）执行搜索，并使用你已有的 ZAI_API_KEY 凭据进行认证，同时将 web 接缝的选择切换为它。Profile Bundle 补丁同时携带这两行；全新安装无需手动编辑组合配置。

工作原理

- 每次搜索发送一个 Messages 请求：模型 glm-5.3、web_search_20250305 服务器工具（max_uses: 3）、max_tokens: 512——来源来自工具结果块，因此补全预算保持很小，并处于 web 工具 60 秒超时之内。
- Z.AI 的 Anthropic 方言将工具结果返回为 tool_result 块，其内容是字符串化的 Python-repr/JSON 混合体，而非标准的 web_search_tool_result 块（这正是随附的 web-search-deepseek 提供方无法简单地重新指向 Z.AI 的原因）。一个引号感知的扫描器从两种形态中提取 title / link / content 记录，也包括标准块以保持向前兼容。
- 瞬态上游故障（Internal Network Failure、5xx、超时）最多重试 3 次；永久性错误会原样呈现，并附带 HTTP 状态。
- 每个请求都会作为 web/zai-search-llm-request 追加到发起会话日志中以便观测，与随附提供方保持一致。
- 注册通过 web.registerSearchProvider 进行，其 disposer 由 fiber 拥有——移除插件行会干净地注销该提供方，并且（在重新应用基础配置时）恢复先前的选择。

要求

- 带有 web 接缝的 DeepSeek Harness（标准 web profile；任何基于 base 的 profile 均可）。
- 一个存储为 ZAI_API_KEY 凭据的 Z.AI API 密钥——web Models 页面会写入它，或直接使用你的凭据存储。无需其他凭据、环境变量或 npm 依赖。

成本说明： 每次搜索都是一次带服务器端搜索的 GLM 模型回合。它的计费类似一次小型模型调用，而不是一次免费的搜索 API 命中。

安装

安装到你的 web profile 中（该包自带其 Profile Bundle 补丁——无需手动添加组合行）：

dsh plugin --profile web add @canary-builds/dsh-web-search-zai

重启 DSH。要更新，请再次运行同一命令并重启。
如果你的配置文件的 cordis.patch.yml 已经覆盖了 web 行（任何手动选择的 searchProvider），请移除该覆盖——配置文件补丁在 bundle 补丁之后应用，因此会胜出。同样，在切换到 bundle 安装之前，请移除任何手动插入的 web-search-zai 行；两行具有相同 id 会冲突。

从 git 检出安装（预发布版）

在首次 npm 发布之前，请从克隆安装：

git clone https://github.com/Canary-Builds/dsh-web-search-zai \
~/.dsh/profiles/web/plugins/dsh-web-search-zai
ln -sfn ../plugins/dsh-web-search-zai \
~/.dsh/profiles/web/node_modules/dsh-web-search-zai

然后将这些行添加到 ~/.dsh/profiles/web/cordis.patch.yml（内容与本包的 cordis.patch.yml 相同，行名 dsh-web-search-zai 与未加作用域的符号链接匹配）：

- insert:
- id: web-search-zai
name: dsh-web-search-zai

- id: web
name: '@deepseek-ai/dsh-web'
config:
searchProvider: zai-official
fetchProvider: http

使用 patchReload: live 的配置文件无需重启即可应用更改；否则请重启 DSH。

切换回 DeepSeek

将真实的 DeepSeek 密钥存储为 DEEPSEEK_API_KEY，移除此包（dsh plugin --profile web remove @canary-builds/dsh-web-search-zai），并在 web 行中恢复 searchProvider: deepseek-official。在安装期间，此 bundle 的补丁永远不会触及随附的 provider 行——但移除该 bundle 后，基础配置将在下次启动时恢复。

配置

没有设置卡片，也没有 schema 依赖——这是有意为之，以便让该包在零 npm 依赖的情况下可安装。可调项是 index.js 顶部的常量：

| 常量 | 默认值 | 含义 |
| MODEL | glm-5.3 | 执行搜索轮次的模型 |
| MAX_USES | 3 | 每个请求的服务器工具搜索轮数 |
| MAX_TOKENS | 512 | 补全预算（来源在工具块中返回） |
| MAX_ATTEMPTS / RETRY_DELAY_MS | 3 / 700 | 瞬时失败重试策略 |
| REQUEST_TIMEOUT_MS | 45000 | 每次尝试的超时，在 web 工具的预算内 |
| API_KEY_REF | ZAI_API_KEY | 凭据存储引用 |

兼容性

- 面向 0.1.x 中随附的 DSH web 接缝契约（registerSearchProvider / WebSearchProvider）；该接缝是稳定的，但未来若 DSH 更改 provider 契约，则需要重新测试。
- Z.AI 工具结果方言以宽容方式解析（Python-repr 和 JSON 形式，嵌套或扁平）。如果 Z.AI 完全更改了结构，搜索将失败并抛出描述性的 WEB_PROVIDER_ERROR，其中指明端点——请提交 issue。

行为说明

- 仅当凭据服务存在时，provider 才会报告 available()；当 ZAI_API_KEY 未设置时，搜索会抛出 WEB_PROVIDER_CREDENTIAL_MISSING 并附带设置说明。
- 在一次请求中的多次搜索遍历之间，URL 会被去重；摘要片段上限为 400 个字符；接缝的 maxResults 截断会在下游生效。
- 取消操作会端到端地得到响应（WEB_ABORTED），包括在抓取过程中。

许可证

MIT

开发

单文件 ESM 插件，无构建步骤，无依赖：编辑 index.js，重启 DSH（或在修改 cordis.patch.yml 后依赖实时 profile 补丁重载）。功能冒烟测试：导入 apply，将其挂载到暴露 web.registerSearchProvider 和凭据接缝的模拟 ctx 上，然后调用 provider.search({ query })。报告问题 · Canary Builds