dsh-free-web-search

DSH PLUGIN记忆与知识

仓库 natgurlain/dsh-free-web-search · npm @natgurlain/dsh-free-web-search

记忆与知识 L4 · 沙盒安装通过 安全审查:低风险 可信度:银 可安装插件
安装这个插件

为 DeepSeek Harness 的 ctx.web 注册免费搜索提供方 free,让内置 web_search 无需付费 API 即可用 Tavily、Brave、SearXNG 及无密钥兜底。

一句话选型结论

按资料字段整理

dsh-free-web-search 是记忆与知识类的 DSH 可安装插件,验证等级 L4 · 沙盒安装通过,安全审查为低风险,列出 5 项功能,有可直接复制的安装命令。验证通过不等于安全:插件会读写文件、执行命令或联网,装前先到仓库确认它做了什么;涉及密钥或系统权限的,建议先在隔离环境试装。

分类记忆与知识 收录类型可安装插件 验证等级L4 · 沙盒安装通过 安全审查低风险
验证等级 L4 L4 · 沙盒安装通过
GitHub 星标 0 复刻 0 · 未关闭 issue 0
最近更新 2026-11-11 创建于 2026-11-11
README 8.8 KB 正文体量,越大说明说明书写得越细

安装

可安装插件
在 DSH 里执行,装完用 dsh plugin list 确认已挂上;标了 L4 / L5 的命令已在沙盒里真实跑通
dsh plugin --profile web add github:natgurlain/dsh-free-web-search#v0.1.1
  1. 1
    确认版本与运行环境

    仓库没有标注兼容版本与 Node.js 要求,先确认你的 DSH 版本能装,再继续。

  2. 2
    执行安装命令

    在 DSH 里执行上面的命令;多包仓库要注意区分具体子包名,别装错包。

  3. 3
    确认已挂载

    用 dsh plugin list 查看列表里是否出现这个插件,出现即挂载成功。

  4. 4
    试跑并检查权限

    加载后跑一个最小用例,确认它能正常工作;同时看它申请了哪些文件、命令或网络权限。

兼容 DSH 版本未标注版本不匹配时安装会报错
Node.js 要求未标注来自仓库 package.json 的 engines 字段
前置依赖无需要同时安装的同级依赖
npm 包名@natgurlain/dsh-free-web-search可用 npm view 查看包信息

能做什么

5 项功能
字段来自项目仓库与公开索引,中文说明由本站标注

dsh-free-web-search:为 DeepSeek Harness 提供免密钥联网搜索

  • 注册 free 搜索提供方
  • Tavily 无密钥开箱可用
  • Brave 与 SearXNG 可接入
  • 维基与 HN 无密钥兜底
  • 零依赖,仅用全局 fetch

适用场景

联网搜索

上游标签

ai-agentsdeepseek-harnessdsh-pluginsearxngtavilyweb-search

验证等级与安全审查

L4 · 沙盒安装通过
自动化流程结论,不是人工审核
验证等级L4 · 沙盒安装通过安装命令在隔离沙盒内真实执行成功,无依赖错误
安全审查低风险静态分析结论,未标注不代表已通过审查
仓库健康度活跃按仓库活跃度与最近更新时间给出
可信度银综合仓库活跃度与验证结果

上面的结论来自上游最近一次自动化验证(2026-11-13): 同一套检查会在插件发新版后重跑,页面显示的是最新一次的逐项结果。

逐项检查结果

L1 · 已找到 ✓ 通过
  • L1.0_DEFAULTED_FROM_L3 由 L3 推定 默认通过——L3 安装规范已通过(全库 L3 扫描策略)
L2 · 结构化 ✓ 通过
  • L2.0_DEFAULTED_FROM_L3 由 L3 推定 默认通过——L3 安装规范已通过(全库 L3 扫描策略)
L3 · 安装规范 ✓ 通过
  • L3.1_INSTALL_COMMAND_PARSED 安装命令已解析 方式:安装规范解析
  • L3.2_DSH_VERSION_DECLARED DSH 版本已声明 方式:DSH 版本声明
L4 · 安装已测 ✓ 通过
  • L4.1_INSTALL_EXECUTED_CONFINED 受限沙盒内执行安装 方式:沙盒安装执行
  • L4.2_INSTALL_SUCCESS 沙盒安装成功 方式:沙盒安装执行
  • L4.3_ARTIFACT_CONFIRMED 安装产物已确认 方式:沙盒安装执行
L5 · 运行已测 ✕ 未通过
  • L5.1_INSTALL_PASSED_SANDBOXED 沙盒安装通过 方式:沙盒安装执行
  • L5.2_WEB_BOOT_READY Web 启动就绪 方式:Web 启动
  • L5.3_HTTP_SERVED HTTP 服务响应 方式:HTTP 请求
  • L5.4_PLUGIN_INVENTORY_ACTIVE 插件清单中已激活 方式:插件清单查询

风险详情

  • 结论说明 静态扫描 低;动态审计无结论(以下以静态为准)→ 总评级 低。
  • 风险计数 严重 0 / 高 0

选择建议

装之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 验证等级 L4:在沙盒里真实装过,依赖能装上,不是纸面声明。
  • 静态安全审查为低风险,没有发现明显可疑行为。
  • 有可直接复制的安装命令,不用自己翻文档找入口。
  • 列出了 5 项功能,能直接看出它解决什么问题。

先想清楚的地方

  • 没有声明 Node.js 版本要求,版本不匹配可能装不上。
  • 验证通过不等于安全:插件会读写文件、执行命令或联网,装前先到仓库确认它做了什么。

更适合

  • 需要在记忆与知识场景里给 DSH 补能力的人。
  • 想装完就能用、不想自己排依赖的人。
  • 能接受在本地装依赖、愿意自己确认权限的人。

不太适合

  • 只使用 DSH 官方内置能力、不接受第三方插件的人。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
插件验证等级安全审查星标兼容版本安装命令
dsh-free-web-search当前 L4 · 沙盒安装通过 低风险 0 未标注 有
ruflo L3 · 安装规范通过 低风险 7.4 万 未标注 无
OpenViking L3 · 安装规范通过 低风险 3.9 万 未标注 无
WeKnora L4 · 沙盒安装通过 低风险 3.3 万 未标注 有
distilly L4 · 沙盒安装通过 低风险 2.5 万 未标注 有
EverOS L4 · 沙盒安装通过 低风险 1.3 万 未标注 有

仓库档案

记忆与知识
字段来自项目仓库与公开索引,中文说明由本站标注
作者 / 维护方natgurlain仓库 dsh-free-web-search · 默认分支 main
分类记忆与知识knowledge
收录类型可安装插件声明了 dsh.bundle、可用 dsh plugin add 安装的条目
开发语言JavaScript仓库主语言
许可证MIT商用或二次分发前请确认条款原文
星标 / 复刻 / issue0 / 0 / 0收录时的数值,非实时
创建 / 更新2026-11-11 · 2026-11-11最后推送 2026-11-11
本站收录2026-11-12首次进入本站目录的时间

README 全文

8.8 KB
作者原文,中文版优先;只做安全转义,不改内容

dsh-free-web-search


A free web-search provider for the DeepSeek Harness
web capability seam (ctx.web). It registers the search provider id free,
so the built-in web_search tool works without paying for a search API —
including with no API key at all.

  • General web first: Tavily's keyless access mode works out of the box; a
    free Tavily API key (1,000 credits/month, no card) raises the limits.
  • Free upgrades: Brave Search API ($5 of free credits per month) and a
    self-hosted SearXNG instance slot into the same chain when configured.
  • DuckDuckGo fallback: when no sanctioned backend answers, a best-effort
    DuckDuckGo HTML backend is tried (see the caveat below).
  • Keyless floor: the Wikipedia Action API and Hacker News Algolia API keep
    web_search returning something when every general backend is unavailable.
  • No dependencies: Node's global fetch is the only network client.

Requirements

  • DeepSeek Harness 0.2.2-rc.1 up to (but excluding) 0.3.0.
  • No other runtime dependencies; Node's global fetch supplies networking.

Install

From npm (published package)

In DeepSeek Harness open Plugins → Add plugin, enter:

@natgurlain/dsh-free-web-search

and install. Enabling the bundle is enough: its patch inserts the provider row
and pins the web service to it, so the model-facing web_search tool starts
using it.

From this repository (local checkout)

Install the bundle from the package directory:

pnpm install

or let the plugin manager install the directory directly by passing its
absolute path as the bundle target. Then verify the plugin row is live in
Plugins and call web_search once in a chat.

Backends

The provider tries backends in configuration order and returns the first
non-empty general-web answer. Keyless domain sources are merged and interleaved
only when no general-web backend answers.

Backend id Service Credential Cost / limits
tavily Tavily Search (api.tavily.com/search) none — keyless access mode; optional free key (TAVILY_API_KEY) for higher limits keyless is shared and rate-limited; a free key gives 1,000 credits/month with no card
brave Brave Search API (/res/v1/web/search) BRAVE_SEARCH_API_KEY or braveApiKey no free plan; each plan includes $5/month free credits ≈ 1,000 queries; a card is required to activate; no result retention and no AI training on results
searxng A SearXNG instance with JSON enabled searxngBaseURL free and keyless when self-hosted; public instances usually disable JSON; can include the DuckDuckGo engine
duckduckgo DuckDuckGo consumer HTML endpoint (html.duckduckgo.com/html/) none best-effort fallback; not an official API, automated access is not authorized and may be answered with a CAPTCHA; see below
wikipedia Wikipedia Action API none keyless, encyclopedic results only
hackernews Hacker News (Algolia) none keyless, tech/community results only

Nothing is cached or stored by this plugin.

Default behavior

  • With no configuration, tavily answers first (keyless general web search).
  • If Tavily is rate-limited or fails, the configured sanctioned backends
    (brave, searxng) are tried, then the DuckDuckGo HTML fallback.
  • If all general-web backends fail, wikipedia and hackernews are merged as
    a keyless floor, and the tool result carries a note naming the failed
    general-web backend.
  • brave and searxng are skipped until their key or base URL is configured.

> Observed 2026-11-11: Tavily's keyless mode reached its
> daily_cap_reached limit after a single successful search from one machine
> (it returns 429 with a Retry-After header). Treat keyless as evaluation
> traffic; for regular use, create the free Tavily API key (1,000
> credits/month, no credit card) and export TAVILY_API_KEY, or configure
> Brave or a SearXNG instance.

DuckDuckGo caveat (read before relying on it)

DuckDuckGo has no official API that returns web results. Its only documented
machine endpoint is the deprecated Instant Answer API, which returns entity
cards, not search results. The consumer HTML endpoints are not a sanctioned
search API: DuckDuckGo's acceptable-use policy does not authorize automated
access, and the service responds to many automated clients with an HTTP 202
"anomaly" CAPTCHA page.

This plugin includes a duckduckgo backend anyway because it can work from some
networks: on 2026-11-11 the same machine received CAPTCHA pages from curl but
real results from Node's fetch (which presents a different TLS fingerprint).
That is inherently fragile and can break or be blocked at any time. Consequences:

  • The backend stays after the sanctioned backends in the default order.
  • A CAPTCHA or blocked response is reported as an error, so the chain falls
    through to the keyless floor instead of hanging.
  • If you need a compliant, stable DuckDuckGo-backed path, run SearXNG with
    its DuckDuckGo engine enabled
    and use the searxng backend: SearXNG owns
    the upstream access instead of this plugin.
  • To keep the plugin to sanctioned APIs only, remove "duckduckgo" from
    backends. You are responsible for how the endpoint is used.

Configuration

Override the plugin row from the profile's cordis.patch.yml (or pass the same
object as the row's config):

- id: free-web-search
name: '@natgurlain/dsh-free-web-search'
config:
backends: ['tavily', 'brave', 'searxng', 'duckduckgo', 'wikipedia', 'hackernews']
tavilyApiKeyEnv: TAVILY_API_KEY
braveApiKeyEnv: BRAVE_SEARCH_API_KEY
searxngBaseURL: http://127.0.0.1:8888
wikipediaLanguage: en
timeoutMs: 15000

All fields are optional. tavilyApiKey and braveApiKey also accept a literal
key, but prefer the environment variables so no secret enters configuration.

To use brave first, move it before tavily in backends. To disable a
backend, remove it from the list; an empty list makes the provider unavailable
and web_search reports a configuration error.

SearXNG setup

Self-hosted SearXNG serves JSON once settings.yml includes it:

search:
formats:
- html
- json

Public instances commonly disable JSON and answer 403, so point
searxngBaseURL at an instance you control or trust. SearXNG's default engine
set includes DuckDuckGo, which makes this the recommended way to get
DuckDuckGo results without direct scraping.

Wiring

cordis.patch.yml inserts the provider row and pins the web service:

- insert:
- id: free-web-search
name: '@natgurlain/dsh-free-web-search'
config: {}
- id: web
config:
searchProvider: free
fetchProvider: http

The profile layer applies after this bundle, so a selection saved from the Web
search settings page (or a profile-level web row) wins over this pin.
web_fetch keeps using the shipped anonymous HTTP fetch provider.

Notes and limits

  • Vendor fragility is expected. Free tiers, keyless modes, and consumer
    endpoints change; the fallback chain and per-backend error messages exist so
    one vendor cannot break the tool completely.
  • Bounded output. Snippets are whitespace-collapsed and capped at 480
    characters before the web_search tool applies its own summary cap. Result
    counts are bounded per backend; the web service enforces the tool's final
    source cap.
  • User agent. All requests send a descriptive User-Agent identifying the
    plugin; the DuckDuckGo backend additionally sends a browser User-Agent because
    the endpoint fingerprints clients.
  • Not included: You.com/Exa remote MCP backends (they speak MCP rather than
    plain REST and can be mounted through DSH's MCP client), and paid providers
    such as xAI Grok search.

Development

There is no build step; the package ships plain ESM.

  • Validate the module and run one live search with Node:
node --input-type=module -e "
const mod = await import('./index.js')
let provider
mod.apply({ web: { registerSearchProvider: (p) => { provider = p } } }, {})
console.log(await provider.search({ query: 'deepseek harness', maxResults: 3 }))
"
  • Install the directory into a profile with the plugin manager's bundle
    installation, then confirm the row with the live config inspection and one
    web_search call.
  • License and publication: MIT, published as
    @natgurlain/dsh-free-web-search.

License

MIT © 2026 Nat Gurlain

常见问题

7 问
答案由本站依据条目字段整理,不引用上游原文
dsh-free-web-search 怎么安装?

在 DSH 里执行 `dsh plugin --profile web add github:natgurlain/dsh-free-web-search#v0.1.1` 即可。对应的 npm 包名是 `@natgurlain/dsh-free-web-search`。

dsh-free-web-search 的验证等级是什么意思?

L4 · 沙盒安装通过。安装命令在隔离沙盒内真实执行成功,无依赖错误

dsh-free-web-search 安全吗?

低风险。静态扫描 低;动态审计无结论(以下以静态为准)→ 总评级 低。

dsh-free-web-search 装之前要先确认什么?

先看它会读写哪些文件、执行哪些命令、连接哪些网络地址;验证等级只说明装得上、跑得起来,不等于安全。涉及密钥或系统权限的,建议先在隔离环境试装。

dsh-free-web-search 用的是什么许可证?

上游标注为 MIT。商用或二次分发前请到仓库确认许可证原文。

dsh-free-web-search 有哪些功能?

注册 free 搜索提供方、Tavily 无密钥开箱可用、Brave 与 SearXNG 可接入、维基与 HN 无密钥兜底、零依赖,仅用全局 fetch。

这条记录的数据可靠吗?

本站按仓库名去重后合并整理,字段以作者仓库与 npm 元数据为准;安装命令、仓库地址与 README 保持原文,带 L4 / L5 标记的安装命令已在隔离沙盒里真实跑通。

同名或近似条目

4 条
不同作者的仓库分开列,请确认你要装的是哪一个
记忆与知识
按星标排序,可作替代方案

ruflo

ruflo

L3 · 安装规范通过 7.4 万 星

OpenViking

OpenViking

面向 DeepSeek Harness 的 OpenViking 记忆与上下文插件:pre-step 自动召回与画像注入、会话捕获、`vik

L3 · 安装规范通过 3.9 万 星

WeKnora

WeKnora

把 WeKnora 知识库接入 dsh 的四个只读工具:列出知识库、混合检索原文片段、按顺序还原单篇文档,以及直接取用 WeKnora 自己

L4 · 沙盒安装通过 3.3 万 星

distilly

distilly

Distilly — Distill how they think into reusable Skills for any Agent o

L4 · 沙盒安装通过 2.5 万 星

EverOS

EverOS

L4 · 沙盒安装通过 1.3 万 星

MemOS

MemOS

L4 · 沙盒安装通过 1.2 万 星

插件的元信息来自作者仓库;分类、验证等级与安全结论的中文说明为中文整理,最近核验 2026-11-13。