前言¶
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
