dsh-search-tavily
v0.2.0
Published
Tavily-backed search provider for the DeepSeek Harness web seam (ctx.web), with the bundled Web-search settings page (self-hosted settings channel, bypassing the apiproxy namespace whitelist).
Maintainers
Readme
dsh-web-search-tavily — Tavily 网页搜索 provider + 设置页
DSH web seam(ctx.web)的 Tavily 搜索 provider,自带设置页(Settings 里的 "Web search" 分区,可编辑 provider 配置和 API key)。自 v0.2.0 起一个包装两半区:host 半区(lib/index.js)+ client 半区(lib/client.js,经 package.json 的 dsh.client 声明加载)——原先独立的 dsh-client-ui-settings-web-search 包已并入并删除。
npm 包名为
dsh-search-tavily(自然名dsh-web-search-tavily/dsh-tavily-search已被两个第三方独立实现占用,本包是自带设置页 + 自托管 settings 通道的这个实现)。
安装
dsh plugin --profile web add dsh-search-tavily配置
行注册(cordis.patch.yml):
- id: web-search-tavily
config:
apiKeyEnv: TAVILY_API_KEY # 环境变量名;key 本体放启动环境,不进配置
- id: web # 选定 provider(或用环境变量 DSH_WEB_SEARCH_PROVIDER=tavily)
config:
searchProvider: tavilyAPI key 三级回落:config 字面 apiKey(不推荐)→ 凭据引用(web Models 页可写)→ 启动环境变量。内置的 web-search-deepseek 行无 DEEPSEEK_API_KEY 时建议 disable,避免两个 provider 抢注册。
host 半区:搜索 provider
- 调用 Tavily Search API(
POST https://api.tavily.com/search),把results[]归一化成 seam 的WebSearchSource形状 - provider id:
tavily。选定方式:web行配置searchProvider: tavily(本部署用这个),或环境变量$DSH_WEB_SEARCH_PROVIDER=tavily - 凭据走 seam 约定:config 里字面
apiKey,或凭据引用(apiKeyEnv,默认TAVILY_API_KEY)经 credentials 服务解析(web Models 页可写),最后回落启动环境 - 自托管 settings 通道(绕开 apiproxy namespace 白名单,通用说明见根目录 AGENTS.md 通用坑第 1 条):host 半区经
ctx.webServer.register挂/api/web-search-tavily/describe|mutate两条 exact 路由,内部直调settings.describe/settings.mutate,describe 时 API key 脱敏(redactSecrets)
client 半区:设置页
- 注册进
settings.section槽(ctx.slots.inject('settings.section', ...),order: 12) - 自实现 settings scope(
subscribe/getSnapshot/set/unset),fetch 上面的自托管路由(完整 envelope,settings.mutate带expectedRevision,冲突 409) - API key 写入走 credentials 服务,凭据失效事件(
credentials/updated)会刷新表单
开发
本插件直接维护 lib/ 产物(无构建步骤);仓库的开发与部署流程见根目录 AGENTS.md。
