@zx06/tavily
为 DeepSeek Harness 提供 Tavily 网页搜索：包括 ctx.web 搜索提供程序，以及 tavily_search/extract/crawl/map/research 工具，并提供用于 API 密钥、配额和审计日志的设置页面
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:zx06/dsh-tavily#2eecbb293babbdafdb515600ae2b848f20bf1f75Tavily 以 @zx06/tavily 发布，当前版本为 0.1.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
点击下方 Badge 复制 Markdown，粘贴到 README 即可。
验证 package.json 声明的 GitHub 仓库，即可管理这个公开页面。认领后，Hub 会优先安排当前版本的安全扫描，并在通过后公开展示结果。
认领这个 Plugin →DeepSeek Harness 的 Tavily 联网搜索插件。它同时提供两种接入方式：
ctx.web 搜索 provider（id tavily）——注册进 DSH 的 web 能力 seam，
于是壳自带的 web_search 工具也能返回 Tavily 结果。外加一个设置页（API Key、搜索选项、额度卡片、审计日志）。
# npm 通道（推荐）
dsh plugin --profile web add @zx06/tavily
# GitHub 通道
dsh plugin --profile web add github:zx06/dsh-tavily
两个通道安装的都是同一份构建产物。装好后重启 profile，在 设置 → Tavily 搜索 里填 API Key 即可（也可先用免密模式）。
| 工具 | 说明 | 需要 Key |
|---|---|---|
tavily_search | 联网搜索（query/topic/depth/结果数/域名过滤/时间窗），返回标题、链接、摘要、评分与可选 AI answer | 否（免密可用） |
tavily_extract | 按 URL 抽取正文 | 否（免密可用） |
tavily_crawl | 从入口 URL 爬取相关页面 | 是 |
tavily_map | 列出站点 URL 结构 | 是 |
tavily_research | 深度研究任务，返回带引用的报告；异步，单工具双模式 | 是 |
tavily_research 的两种模式
input：创建任务并在工具内轮询到完成（受 researchTimeoutMs 限制）。
若超时仍在运行，会返回 requestId 与提示，不会丢失任务。request_id：只查询一次状态，用于继续轮询已有任务。设置页包含：API Key 表单（密文，保存时自动校验）、搜索选项（默认结果数/深度/超时/
是否允许免密）、额度卡片（Tavily /usage）、本月用量统计、审计日志表。
pnpm install && pnpm build
然后用 install_bundle 安装本仓库根目录（本地路径通道）。
优先级从高到低：
/usage 校验有效性，通过后写入 DSH 凭据服务（$DSH_HOME/.credentials.yaml）。TAVILY_API_KEY。注意：继承的环境变量只读且遮蔽写入——
若它已设置，设置页会拒绝保存并提示你取消该环境变量。apiKey 字段（role('secret')，不会出现在任何响应里）。凭据引用名可通过 apiKeyEnv 改（默认 TAVILY_API_KEY）。
Key 申请地址：https://app.tavily.com。
Tavily 允许无 Key 使用 search 与 extract（共享限速）。本插件默认开启
（allowKeyless: true）：
tavily_search / tavily_extract 仍可用；crawl / map / research 会给出明确提示，而不是上游报错；关闭 allowKeyless 后，未配置 Key 时所有工具直接报错。
ctx.web插件会注册一个 id 为 tavily 的搜索 provider。DSH 的 provider 选择规则是：
web.searchProvider 且只有一个可用 provider → 自动选中；web.searchProvider: tavily → 选中 Tavily；available() 返回 false，不会参与选择——
这样单 provider 部署不会因为 Tavily 未配置而变成 WEB_PROVIDER_AMBIGUOUS。当前 profile 若把 web.searchProvider 钉为 deepseek-official，Tavily provider
不会被选中；此时直接用 tavily_* 工具即可。
~/.dsh/tavily/audit-YYYYMM.jsonl，每行一次调用：时间、工具、目标、耗时、结果数、
状态/错误码、调用方、本次消耗的 credits。Key 永不写入（目标里形如 tvly-... 的字符串
也会被脱敏）。可在设置页查看，也可直接读文件。
@dsh-plugins/search-tavily 的差异（破坏性变更）search-tavily → tavily。设置命名空间、ctx.web
provider id 同步变更。~/.dsh/tavily.key，也不再通过 configEditor 改写
profile patch；统一走 DSH 凭据服务。旧的 key 文件会被忽略，请在设置页重新填写。~/.dsh/search-tavily/ → ~/.dsh/tavily/。ctx.web provider、tavily_research、免密模式、credits 记录、
map 的审计归类修正（此前被误记为 crawl）。pnpm install # 安装依赖（含私有的 @dsh-plugins/plugin-kit workspace 包）
pnpm build # 先 tsc 构建 kit，再出类型声明，最后 esbuild 打包 dist/host.js
pnpm typecheck # 类型检查
pnpm lint # 语法检查（node --check）
pnpm test # 单测（84 个：插件 68 + kit 16，全部离线，不打真网）
dist/host.js 是提交进仓库的插件直接从 GitHub 安装（github:zx06/dsh-tavily）时，消费端不会跑构建，
所以入口文件必须在检出里就存在。
scripts/bundle.mjs 用 esbuild 把私有的 @dsh-plugins/plugin-kit 内联进
dist/host.js——它是 devDependencies 里的 workspace 包，消费端解析不到。
@deepseek-ai/*（宿主运行时）与 @tavily/core（真实 npm 包）保持 external：
前者必须绑定宿主自己的 cordis / 工具注册表实例，后者让消费端正常去重。