前言¶

DSH 的插件扩展方式可以把不同提供方接入到 Web 运行时。对于已经准备 Codex Web Search 接口、并希望在 DSH 中通过插件方式使用它的场景，下面介绍 dsh-web-search-codex。

这个插件为 DeepSeek Harness（DSH）提供 Codex Web Search 能力，会把搜索请求发送到配置好的 /alpha/search 兼容接口。社区插件目录中的条目只是插件来源，不等同于官方应用商店。

插件是什么¶

dsh-web-search-codex 是面向 DSH 的 Web 搜索提供方插件。

它的主要职责是：

• 注册 codex 搜索提供方。
• 将搜索请求发送到配置好的 /alpha/search 兼容接口。
• 支持复用 OpenAI 配置，或使用独立 Key 填写完整接口地址和 API Key。

仓库地址：

https://github.com/Cora093/dsh-web-search-codex

核心功能¶

下面是插件已核实的几项能力。

1、注册 codex 搜索提供方。

2、将搜索请求发送到配置好的 /alpha/search 兼容接口。

3、支持复用 OpenAI 配置生成 /alpha/search 接口地址，并使用已有 API Key。

4、支持使用独立 Key，填写完整的 /alpha/search 接口地址和 API Key。

5、模型留空时，搜索跟随当前会话模型。

6、支持 HTTP 和 HTTPS。

7、只发送当前搜索词，不读取或发送对话历史。

8、拒绝所有 HTTP 重定向。

安装与启用¶

先确认版本要求：0.1.2 要求 DSH 0.1.2-rc.1 或更高的 0.1.x 版本，不兼容 DSH 0.1.1 及更早版本。

运行环境要求：

node >=22.19

安装插件：

dsh plugin --profile web add dsh-web-search-codex@latest --registry=https://registry.npmjs.org/

启动 DSH：

dsh --profile web --port 3080

经过上面的步骤后，打开：

设置 -> 插件 -> 插件配置 -> Codex 搜索提供方

选择一种配置方式：

• 复用 OpenAI
• 使用独立 Key

确认配置后保存。

需要注意：安装插件后，Web Runtime 会使用 codex 作为搜索提供方，默认网页搜索将失效。

典型用法¶

复用 OpenAI 配置¶

如果模型设置中已经配置 OpenAI 提供方，可以在插件配置中选择“OpenAI”。

选择后，插件会根据已有 baseURL 生成 /alpha/search 接口地址，并使用已有的 API Key。密钥不会被复制。

模型为可选项。模型留空时，搜索会跟随当前会话模型。

保存前请确认自动生成的接口地址可用。

使用独立 Key¶

如果接口和 Key 是单独维护的，可以在插件配置中选择“独立 Key”。

选择后，需要填写：

完整的 /alpha/search 接口地址
API Key

这里的接口地址必须包含 /alpha/search。插件不会自动改写接口地址。

模型同样可以留空。留空时，搜索会跟随当前会话模型。

适用场景与注意¶

这个插件适合希望把 DSH Web Runtime 的搜索请求指向 Codex /alpha/search 兼容接口的场景。使用前建议重点看下面几点。

• /alpha/search 是 Codex 内部 alpha 协议，不是稳定的公开 API。
• 接口地址必须是包含 /alpha/search 的完整 URL，插件不会自动改写。
• 支持 HTTP 和 HTTPS；使用 HTTP 时会显示未加密警告。
• 插件拒绝所有 HTTP 重定向，避免 API Key 被发送到其他地址。
• 请求失败时，插件不会自动回退到 DeepSeek 搜索提供方。
• 插件不限制模型名称，也不会替换服务端不支持的模型。
• 插件只发送当前搜索词，不读取或发送对话历史。
• 0.1.2 要求 DSH 0.1.2-rc.1 或更高的 0.1.x 版本，不兼容 DSH 0.1.1 及更早版本。
• engines 要求 node >=22.19。
• 许可证为 MIT。
• 插件以当前 DSH 进程权限运行，安装前应检查源码、依赖和许可证。

结尾¶

dsh-web-search-codex 的价值在于把 Codex Web Search 以 DSH 插件形式接入。配置完成后，DSH Web Runtime 会使用 codex 作为搜索提供方，并按配置将搜索请求发送到 /alpha/search 兼容接口。

目录页：

https://www.skillhub.cn/plugins/Cora093/dsh-web-search-codex

GitHub：

https://github.com/Cora093/dsh-web-search-codex