前言¶
DeepSeek Harness（DSH）把「觸網」收成可選能力：模型側仍通過統一的 web_search 等工具發起請求，底層則由 ctx.web 接縫選擇具體的搜索 Provider。內置路徑通常綁定官方或固定後端；若你已經在公司或自建環境裏部署了帶 web_search 能力的 API 網關——例如走 Anthropic Messages 或 OpenAI Responses——更常見的需求是：搜索流量走自己的 base URL 和密鑰（BYOK），而不是把 Key 交給某一固定託管方。
下面介紹社區插件 elliotsu1107/dsh-web-search-byok（SkillHub 分類：聯網工具）。它面向「已有兼容網關、希望把 ctx.web 搜索路由過去」的用法。撰寫時對照了任務線索與公開頁面；截至 2026-11-10，GitHub 倉庫返回 404、README 未能抓取，npm 上的 dsh-web-search-byok 亦已下架，因此正文不寫入未經原文覈實的安裝命令與配置字段。
這是什麼¶
dsh-web-search-byok 由維護者 elliotsu1107 發佈，目錄條目位於 SkillHub（見文末鏈接）。簡介原文爲：
BYOK web-search provider for DeepSeek Harness: route ctx.web searches through your own API gateway (Anthropic Messages / OpenAI Responses web_search).
用一句話概括：它是一個 BYOK 型聯網搜索 Provider，意圖讓 DSH 的 ctx.web 搜索經由你自管的 API 網關完成，並依賴網關所實現的 Anthropic Messages 或 OpenAI Responses 體系中的 web_search 能力，而不是替換整套 Harness 的模型供應商插件。
SkillHub 上該條目的 GitHub 星標爲 0（以目錄展示爲準）。
核心功能（已覈實範圍）¶
結合上述簡介，可以確認的設計取向如下（更細的字段、探活邏輯等須以恢復可用的 README 爲準）：
-
接入
ctx.web搜索接縫
與 DSH 其它聯網插件相同，它工作在 Web 能力層：對上不改變模型看到的工具契約，對下替換或補充搜索後端。 -
BYOK
強調使用你自己的 API 網關與憑據，把搜索請求發到你可控的端點，而不是默認綁定某一公共服務賬號。 -
雙協議面的網關類型
簡介點名兩類網關能力：Anthropic Messages 與 OpenAI Responses 中的 web_search。換言之，插件假設你的網關已經以其中一種（或兼容）方式暴露服務端搜索，而不是在插件內再實現一套獨立搜索引擎爬蟲。
若你熟悉同類插件 dsh-web-search-provider（走模型供應商服務端搜索）或各類 dsh-web-search-* Provider，差別主要在於：本插件名稱與簡介突出 BYOK + 自有網關，而不是內置 DeepSeek 官方搜索或單一第三方搜索 API。
安裝與啓用¶
DSH 生態裏插件通常通過 dsh plugin add …、profile 的 bundle 列表或 cordis.patch.yml 掛載；具體命令必須以插件 README 或 SkillHub 安裝指引爲準。任務提供的 GitHub README 抓取失敗，且當前訪問 https://github.com/elliotsu1107/dsh-web-search-byok 得到 404，維護者公開倉庫列表中也未出現該名稱，因此本文不列出任何安裝命令，避免憑插件名拼寫指令。
補充可覈對事實：npm registry 記錄顯示包名 dsh-web-search-byok 曾於 2026-11-07 短暫存在（含 0.0.0-stage、0.1.1），同日被 unpublished；當下無法從 npm 拉取 tarball 或 README。
建議安裝前按順序做：
- 打開 SkillHub 目錄頁，查看是否更新了安裝說明或鏡像來源。
- 若 GitHub 恢復，先閱讀倉庫 LICENSE 與源碼，再執行文檔中的安裝步驟。
- 安裝完成後用
dsh --dump-config（或你當前 profile 的等價命令）確認 bundle 已加載，並在日誌中檢查 Provider 是否註冊成功。
SkillHub 是社區維護的插件索引站點，與 DeepSeek / 幻方並無從屬關係；DSH 本身奉行「一切皆插件」，但目錄站上的條目仍需你自行審閱後再裝入運行環境。
典型用法（按簡介推演的工作流）¶
在缺少 README 的前提下，只能根據簡介描述可預期的使用路徑；不能給出可複製粘貼的配置片段。
- 準備網關：你的中轉或自建服務需以 Anthropic Messages 或 OpenAI Responses 方式提供 web_search，並持有你可下發的 API Key / 訪問策略。
- 安裝並啓用插件後，將
ctx.web的搜索後端指向該 Provider（具體配置項名稱以文檔爲準）。 - 在會話中觸發 Harness 的聯網搜索工具；請求應經插件轉發到網關，由網關完成搜索並返回 Harness 統一的搜索結果結構。
若網關未實現對應協議的 web_search，或密鑰未配置，行爲應以插件文檔中的失敗提示爲準（本文無法覈實具體錯誤碼與 UI）。
適用場景與注意¶
更適合誰
- 已有兼容 Anthropic Messages / OpenAI Responses web_search 的企業網關、私有中轉或實驗室環境。
- 希望在 DSH 裏統一使用
web_search工具，但搜索算力與合規邊界停留在自管基礎設施內的團隊。
務必注意
- 源碼與可用性：當前公開 GitHub 倉庫不可用、npm 包已下架，安裝前請確認你能獲得可信來源；不要對不可審閱的構件直接授予生產 profile 權限。
- 進程權限：DSH 插件與當前
dsh進程同權運行，網關 URL 與 Key 一旦配置錯誤，可能導致密鑰泄露或請求打到非預期主機；安裝前閱讀源碼中的網絡出口與日誌行爲。 - 費用與配額：經網關觸發的
web_search通常按網關所屬服務商計費，與 DSH 內置搜索的計費模型可能不同。 - 與官方內置 Provider 的關係：切換搜索 Provider 只改變
ctx.web後端；模型供應商、會話數據等仍由其它插件與配置決定。
結尾¶
dsh-web-search-byok 在社區目錄中的定位，是把 DSH ctx.web 聯網搜索接到 BYOK 的自建 API 網關，並依賴 Anthropic Messages 或 OpenAI Responses 的 web_search 能力。在 README 與倉庫恢復之前，請以 SkillHub 與將來發布的官方文檔爲唯一安裝依據，並在本機審閱源碼與許可證後再啓用。
- SkillHub：https://www.skillhub.cn/plugins/elliotsu1107/dsh-web-search-byok
- GitHub（當前 404，以維護者後續恢復爲準）：https://github.com/elliotsu1107/dsh-web-search-byok
