Overview
dsh-tavily
README / EN
Package documentation
Registry summary
dsh.pub verifies the pinned bundle contract, runtime facts, and distribution semantics. The complete README remains in the source repository.
Read the full README on GitHubLIMITATIONS
Known limitations
- **未做真实 API 联调**：创建这个插件时，本机 DNS 把 `api.tavily.com` / `docs.tavily.com` 解析到 `198.18.0.0/15`（代理 fake-IP 段），DSH 自带的 `web_fetch` 会以「解析到非公网 IP」拒绝； 插件的 `fetch` 走 Node 原生实现、通常会经系统代理，但**没有真实 key 就没有验证过**。 安装后第一次调用请按 [7.2](#72-在-dsh-里验证) 现场确认。 - **字段与错误码来源**：Tavily 请求/响应字段（`search_depth`、`include_answer`、`raw_content`、 `failed_results` 等）与 `401/429/432/433` 语义按公开文档与官方 SDK 行为实现；文档站不可达时 无法二次核对。 - **可用性是乐观的**：配置了凭据引用（默认 `TAVILY_API_KEY`）后 `available()` 就为 true， 真正的 key 在每次请求时解析；缺 key 时由 `WEB_PROVIDER_CREDENTIAL_MISSING` 报出，而不是 让 seam 报 `WEB_PROVIDER_CONFIGURED_UNAVAILABLE`。这是为了支持凭据库/环境变量在运行时变化。 - **设置页依赖 DSH 客户端 primitives**：`SettingsFormModel` / `SettingsForm` / `SettingsValueField` / `SettingsSecretField` 是 `0.2.1-rc.3` 的基线模块 API；DSH 升级后 可能需要按新版本调整 `client.js`（与 `dsh-cloud-control` 的浏览器半边同类风险）。 - **设置页对所有启用本 bundle 的 profile 可见**：它是 profile 级设置，不做“只有用 Tavily 的人 才显示”的额外门控；不想看到它就把 bundle 从 profile 移除。 - **字面 `apiKey` 优先**：保留兼容；页面检测到后会禁用凭据输入并提示，避免“保存了 key 却不生效”。 - Web/桌面 surface 的 `web_search` / `web_fetch` 工具来自 agent preset（`tool-web`）； 若某个 preset 没挂 `tool-web`，seam 里注册了提供方也没有工具去调它。