X-C1811/dsh-web-search-plugin

README 摘要

dsh-web-search-plugin 面向 DeepSeek Harness web 能力接缝（ ctx.web ）的统一网页搜索插件，内置 DeepSeek（官方）/ Tavily / Brave Search 三个后端 。本包只向接缝注册 一个 WebSearchProvider ，稳定 id 为 dsh-web-search 。在 设置 → 网页搜索 里切换引擎即可，不必再改 web.searchProvider 。 - DeepSeek（官方） — 走 DeepSeek 的 Anthropic 兼容 Messages API（原生 web search 20250305 工具，凭据名 DEEPSEEK API KEY ），一次搜索消耗一个模型轮次。 - Tavily（默认） — keyless （免费、限流、无需账号）或 keyed （ TAVILY API KEY ，Bearer token）。keyed 会在设置卡显示额度进度条。 - Brave Search — GET https://api.search.brave.com/res/v1/web/search ，请求头 X-Subscription-Token （凭据名 BRAVE API KEY ）。一次搜索就是一次 HTTP 请求，不走模型轮次；设置卡按响应头展示 Capacity / 月配额。 - 不写自定义 session 事件 — 工具结果已经走接缝自己的事件，无需多余信封。 特性 - 与官方 @deepseek-ai/dsh-web-search-deepseek 相同的提供方约定： inject: ['web'] + installSettingsSection + ctx.web.registerSearchProvider 。 - 顶层 设置 → 网页搜索 分区：两列布局、未保存草稿、保存 toast；结果数量为 1–20 下拉。 - Tavily keyless 无需密钥即可用；Brave 需要订阅 token（若本机已有 BRAVE API KEY 凭据，可直接复用）。 - Tavily keyed / Brave 在设置卡展示额度进度条（DeepSeek 官方与 Tavily keyless 不展示）。 - 各引擎结果都规范化为接缝的 WebSearchResult （可选 content + sources[] ），按 URL 去重。 - 设置段 dsh-web-search-plugin 通过 rc.7 的 settings.describe() 动态暴露，不需要宿主白名单补丁，也不需要自建回环 settings 桥。 - 错误映射为 WEB PROVIDER ERROR / WEB ABORTED / WEB PROVIDER CREDENTIAL MIS…

分类