npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2026 – Pkg Stats / Ryan Hefner

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).

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: tavily

API 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。