cnChenKai/dsh-web-search-brave 预览 preview

cnChenKai/dsh-web-search-brave

基于Brave Search的WebSearchProvider,适用于DeepSeek Harness(ctx.web)

Project Overview项目介绍

This is a DSH-native plugin built exclusively for DeepSeek Harness that replaces the default web search endpoint of DSH’s built-in ctx.web capability seam with fresh results from the Brave Search Web API. To install the plugin from the public NPM registry, users run the official DSH CLI command dsh plugin --profile web add dsh-web-search-brave which pulls and installs the latest published version automatically. After installation completes, users must add their unique Brave Search API key to DSH’s local credential store at ~/.dsh/.credentials.yaml or export it as an environment variable before starting the DSH process.

The plugin is intended for DSH users who prefer Brave Search’s independent, unbiased search results over DSH’s default bundled search provider. While the plugin automatically sets Brave as the active search provider immediately after installation finishes, users can manually switch or revert back to the original provider by editing the cordis.patch.yml file in their personal DSH profile directory. This manual configuration edit is only needed if the automatic patching step fails to apply correctly, so most first-time users will never need to take this extra step.

Brave Search does not support unauthenticated, keyless access to its public API, so a valid API key from Brave is strictly required for the plugin to function at all. The free tier of the Brave Search API allows up to 2,000 search queries per calendar month, which is more than sufficient for most casual personal use of the plugin. The plugin defaults to disabling text decorations in returned search results, removing <b> HTML highlight markers from result snippets, and automatically maps Brave’s ISO 8601 page age metadata to DSH’s required publishedAt date output field. The entire plugin codebase is released under the permissive open-source MIT license.

这是一个专门为 DeepSeek Harness(DSH)开发的原生插件,作用是替换 DSH 内置 ctx.web 网络能力接口的默认网页搜索路由,改为通过 Brave Search Web API 提供公开网页搜索服务。用户可以通过 DSH 官方提供的插件命令行工具,执行 dsh plugin --profile web add dsh-web-search-brave 完成安装,使用前需要先获取有效的 Brave Search API 密钥。

该插件适合需要使用 Brave Search 替代 DSH 默认搜索服务的 DSH 用户,Brave Search 以更中立的搜索结果著称,不受主流搜索引擎的商业排名算法偏向影响。安装完成后,插件会自动修改配置切换搜索提供者,用户也可以手动修改个人配置目录下的 cordis.patch.yml 调整配置,整个配置流程十分简便。

该插件要求用户必须拥有 Brave Search API 密钥,Brave Search 不提供无密钥访问方式,免费配额为每月 2000 次查询。插件默认关闭文本装饰,搜索结果片段不会保留 <b> 这类 HTML 高亮标记,同时会自动将 Brave 返回的 ISO 8601 格式日期映射到 DSH 要求的发布日期字段,代码采用 MIT 许可证开源。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 warning1 项注意
  • Only 6 stars - very few users, little community feedback星标只有 6,几乎没人在用,遇到问题缺少社区反馈
DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

  • DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
  • External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时(Electron / Python / Docker 等)是否齐备
  • Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突:命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

  • Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致,是否归档或长期停更
  • Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
  • curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
  • Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
  • Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需(filesystem / network / shell / clipboard)
  • Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限,以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照,不能替代安全审计。

Or use CLI install (for developers)或使用命令行安装(适合开发者)

CLI Install命令行安装

dsh plugin --profile web add dsh-web-search-brave

把 cnChenKai/dsh-web-search-brave 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

dsh-web-search-brave

npm version npm downloads GitHub stars License

English | 中文

A Brave Search-backed search provider for the DeepSeek Harness web capability seam (ctx.web): it makes the built-in web_search tool run on Brave's Search Web API instead of the shipped DeepSeek route.

DSH compatibility: validated with 0.2.0-rc.2.

Features

  • Clean snippets - text_decorations defaults to false so snippets stay free of <b> highlight markers.
  • Dates - page_age (ISO 8601) maps to the seam's publishedAt; human-readable age is ignored.
  • Keyed only - Brave has no keyless mode; free tier: 2,000 queries/month at api.search.brave.com.

Install

dsh plugin --profile web add dsh-web-search-brave

Set your API key in DSH's credential store (recommended) or export it in the environment that starts dsh web:

# ~/.dsh/.credentials.yaml
BRAVE_API_KEY: BSA...

Select the provider (the bundle patch does this automatically; to switch manually):

# your profile's cordis.patch.yml
- id: web
  name: '@deepseek-ai/dsh-web'
  config:
    searchProvider: brave

License

MIT

← 上一个 Prev sprites-deepseek-plugin 下一个 Next dsh-skills-anywhere →