前言¶

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