DeepSeek Harness 插件

dsh-free-search-zhouzhen

Free multi-source web search provider for DeepSeek Harness (dsh): Tavily keyless + keyless fallbacks, wired into the native web seam(英文原文)

跳到安装方式

来源信息

GitHub 仓库
zhouzhencheng07/dsh-free-search
最近更新
2026年8月15日
分类
工具与能力
GitHub stars
4
载体类型
plugin
目录证据
上游声明已找到 dsh.bundle
证据路径
package.json#dsh.bundle
核对版本
0.1.0-rc.8
上游核对日期
2026-08-20

该证据由上游目录提供。本站没有安装、运行或安全审核这个插件。

安装

默认先复制一段 Prompt,让 Agent 读 GitHub 仓库和源码;需要自己装时再切到命令。

复制这段 Prompt,发给 DSH、Codex 或其他 Agent,让它先读 GitHub 仓库和源码。

请先不要安装或执行任何命令。阅读这个插件的 GitHub 仓库、README 和关键源码,然后用清楚、直接的方式回答以下问题,帮助我判断它是否适合我的需求:

1. 这个插件是什么,解决什么问题;
2. 适合哪些用户和典型使用场景;
3. 安装后如何使用,并给出一个最小使用示例;
4. 有哪些已知限制,以及隐私、安全、兼容性或维护风险;
5. 给出“推荐 / 有条件推荐 / 不推荐”的明确建议和理由。

请区分仓库明确说明、根据源码推断和未知信息。证据不足时请明确说明,不要猜测或照抄 README。

GitHub:https://github.com/zhouzhencheng07/dsh-free-search
插件名:dsh-free-search-zhouzhen
作者:zhouzhencheng07

检查来源文件

安装前先看这个插件目录里的 README 和其他文件。

文件资源管理器4 个文件
README.md来源说明 · 只读预览
README 语言

English | 中文

dsh-free-search

面向 DeepSeek Harness (dsh) 的免费多源网页搜索插件

注册为 dsh 原生 web seam 的 search provider:内置 web_search 工具直接走本插件的免费引擎链, 保留引用卡片 UI,并且不再消耗 DeepSeek API 额度(替换了 base 层默认的付费 deepseek-official 路由——那是一次模型调用/次搜索)。

引擎链(全部免费,自动故障转移)

引擎类型触发条件备注
GitHub Search API无 key查询含 repo/仓库/owner/repo 或 github.com 链接代码/仓库检索
arXiv API无 key查询含 arxiv/预印本/preprint 或 arXiv ID(如 arxiv 1706.03762)论文直达/检索
StackExchange API无 key查询含 stackoverflow 等编程问答
Hacker News (Algolia)无 key查询含 hacker news 等科技新闻
Tavilykeyless 免注册;有 key 用 key始终参与(主引擎)key 模式解锁 answer 摘要
Sogou 网页搜索无 key(HTML)始终参与(兜底)中文搜索兜底,自动解析跳转链接

优先级:命中的专用引擎优先,随后 Tavily keyless → Sogou;某个引擎失败自动切下一个, 全部失败时报出逐个尝试明细。可选环境变量:TAVILY_API_KEY(有则用 key 模式)。

> 说明:Baidu 新版 SERP 是 JS 渲染(静态 HTML 无结果),无法程序化抓取,故未纳入; > Exa/Brave/Google 等免费 API 在当前网络不可达,亦未纳入。

安装

dsh plugin --profile web add "github:zhouzhencheng07/dsh-free-search"

本包声明了 dsh.bundle.patch,因此会被激活为 profile 的 bundle 层(而不是仅仅装成 一个不生效的普通依赖)。安装后重启 dsh web,内置 web_search 即走免费引擎链。

本地开发安装

# 本地开发安装:把路径换成你自己的本地检出目录
dsh plugin --profile web add "file:/path/to/dsh-free-search"

> 如果你之前是用 --patch ./scratch-plugin/... 参数加载本插件的,请从启动命令中 > 去掉该参数——现在由 bundle 持有 free-search 行,重复 insert 会导致启动失败。

工作原理

  • src/web-search.js:ctx.web.registerSearchProvider({ id: 'free-search', ... })
  • src/engine-chain.js:引擎优先级、查询路由(专用引擎按查询特征参与)、故障转移、

超时与取消(AbortSignal 透传)。

  • src/engines/*.js:各引擎的请求与输出规范化,统一为

{ url, title?, snippet?, publishedAt? } 列表。

  • cordis.patch.yml:把 websearchProviderdeepseek-official 改为

free-search(该行 config 仅此一个 base key,整体替换安全;profile 层 patch 可改回)。

环境要求

  • Node.js ≥ 22(dsh 自身要求)
  • 无任何 API key 要求;纯 ESM、零依赖、零构建

许可证

MIT