@junjiangao/dsh-web-search-tavily

LIMITATIONS

已知限制

- **仅实现 `search`**——未实现 Tavily `extract`/crawl/map/research；keyless 本来也只允许 search/extract。 - **keyless 受服务端限流**，参数可能被降级；插件不做本地假设。 - **已移除 `includeImages` / `includeImageDescriptions` / `includeFavicon` / `includeUsage`**——seam 无对应展示面，此前只是改变请求体；升级后旧 patch 若仍设置这些键，会被 schema 忽略/拒绝，请一并删除。 - **必然 400 的组合已在提供方侧兜底**——`include_domains_mode` 无 `include_domains`、`filter_by_language` 无 `language` 时，对应参数被丢弃（实测 Tavily 分别返回 400）。 - **`safe_search` 与 `fast`/`ultra-fast` 互斥**——该组合由 Tavily 返回 400（`Safe search parameter is not supported for fast or ultra-fast search_depth.`），插件不拦截，错误消息原样呈现。 - **选择归用户所有**：安装只注册提供方；通过卡片开关并保存，可一次切换搜索和抓取提供方（见上文）。 - **中止按 signal 分类**：fetch 中止或已中止的 signal 映射为 `WEB_ABORTED`。 - **只有一个入口：bundle 自己的页面**——`plugins.bundle.config`，键取 **profile 声明的 bundle 名**，client 从插件管理器的 bundle 列表解析它，因此「依赖键是改名前旧名」的别名安装也能对上；只用包名做键会什么都不渲染。刻意不注册 `plugins.row.config`，该行因此没有自己的配置入口；也不注册 `plugins.item`，否则会给 Official 分组加一张默认图形的卡片。 - **本 bundle 里名为 `ref` 的 prop 是陷阱**：React 独占每个元素上的 `ref`，字符串值根本到不了函数组件，而是抛 error #290；shell 记为 `slot entry crashed` 并什么都不渲染。`jsx-runtime` 测试替身现在复现了这条规则，因此测试会先失败。