概览
dsh-tavily
README / ZH
插件文档
目录摘要
dsh.pub 核对固定版本的组合包契约、运行时事实与分发语义；完整 README 请查看源仓库。
在 GitHub 阅读完整 READMELIMITATIONS
已知限制
- **未做真实 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 里注册了提供方也没有工具去调它。