零密钥联网搜索 AllenCoderBug/dsh-web-search-zerokey

dsh-web-search-zerokey

给 DeepSeek Harness（DSH）的零 key 联网搜索。

不填任何 API key · 不启任何本地服务 · 不消耗模型积分。

它解决什么问题

给 AI 装上「联网搜索」，通常要先过一道坎：

| 常见方案 | 你要付出的代价 |
| DSH 官方搜索 | 每次搜索 = 一次完整模型 turn，直接扣积分 |
| Google / Bing 官方 API | 要申请 key（Bing 的还已于 2025-08-11 退役） |
| SearXNG | 要自己跑一个 Docker 实例并长期维护 |
| Tavily / Brave 等 | 要 key，免费额度会耗尽 |

这个插件不需要任何 key，装完就能搜。

因为它走的是「抓公开网页 + 调公开接口」——公开信息本来就不需要授权。

安装

DSH 桌面版（推荐 —— 装完即用）

侧栏点 插件 → 搜索框输入 zerokey → 安装。

装完 Cmd+Q 完全退出 DSH 再重开即可，不需要任何额外配置。

命令行 / Web 版

从 npm 装：

dsh plugin --profile web add dsh-web-search-zerokey

从 GitHub 装（npm 尚未发布新版本时）：

dsh plugin --profile web add github:AllenCoderBug/dsh-web-search-zerokey

桌面版手工装（GUI 市场不可用时）

三步，缺一不可（只改声明不装包 = 插件加载失败）。

1. 改 ~/.dsh/profiles/desktop/package.json

{
"dependencies": {
"dsh-web-search-zerokey": "^1.0.4" // 用最新版本号 },
"dsh": {
"profile": {
"bundles": [
"dsh-web-search-zerokey" // 追加到已有列表末尾 ] } } }

2. 装包（在 profile 目录执行）

cd ~/.dsh/profiles/desktop
pnpm install

桌面版自带 pnpm，但它不在你的 PATH 里。
若提示 pnpm: command not found，用 App 内置的那个：
node "/Applications/DeepSeek Harness.app/Contents/Resources/runtime/pnpm/bin/pnpm.cjs" install

3. Cmd+Q 完全退出 DSH 再重开

⚠️ 桌面版的 profile 叫 desktop，但不能用 dsh plugin 装，会报： error: profile "desktop" is managed exclusively by the Electron application 这是 @deepseek-ai/dsh 的 lib/bin.js 里的硬性限制。

验证是否生效

重启后跑一次自检：

node ~/.dsh/profiles/desktop/node_modules/dsh-web-search-zerokey/scripts/verify.mjs

它会逐项确认：安装完整性 / pin 护栏 / 进程是否真的加载了新代码 / 功能冒烟。
全部通过会打印 插件已生效 ✅。

⚠️ 关窗口 ≠ 退出进程。macOS 上必须 Cmd+Q。

关于 provider 绑定

装完即用，因为插件自带绑定 —— 它会把自己的 patch 层写进组合，把 web 的搜索 provider 指向自己。

层序是「插件的 patch → 你自己的 cordis.patch.yml」，你的配置在后、会覆盖它，所以随时可以改。

这一步为什么关键：DSH 官方的搜索 provider 每次搜索消耗 一次完整模型 turn，直接扣积分；而它默认就在列表里。
不显式指定就可能 fallback 到它。

想换回官方搜索，在你自己的 cordis.patch.yml 里覆写：

- id: web
config:
searchProvider: deepseek-official

本仓库有 test/pin-guard.test.mjs 锁死默认值，防止误改导致意外扣费。

它会搜出什么

7 个数据源并行，结果自动去重合并：

| 源 | 类型 | 特点 |
| Bing | 抓页 | 主源，覆盖最广 |
| Hacker News | 公开 API | 真人技术讨论，带热度与评论数 |
| GitHub | 公开 API | 仓库检索 |
| arXiv | 公开 API | 论文 |
| npm | 公开 API | 包元数据 |
| 掘金 / CSDN | 公开 API | 中文技术 |

中英文自动路由：中文技术查询走掘金/CSDN，生活类查询只走 Bing（不混入英文源）。

实际效果（查 mcp server typescript）：

Bing 6 条 + Hacker News 2 条 + GitHub 2 条

带热度信号的条目长这样——这是普通搜索结果页给不出的：

Show HN: Kreuzberg – Modern async Python library... Hacker News · 197 分 · 75 评论 · 2025-02-15 LeonHartley/Coerce-rs ★752 · Rust · 更新 6 天前

配置项（都可选）

| 键 | 默认 | 说明 |
| multiSource | true | 关掉则只走 Bing |
| includeContent | false | 抓正文片段（实测延迟 +466%，谨慎开） |
| maxSnippetChars | 500 | 单条摘要上限 |
| cacheTtlMs | 300000 | 缓存 TTL（5 分钟） |
| timeoutMs | 12000 | 总超时 |

已知限制

- bing 源是抓页，该路径位于其 robots.txt 的 Disallow 列表内。
其余 6 个源是公开 API，无此问题。使用者请自行确认所在司法辖区的合规性。
- arXiv 需严守 3 秒/次（官方 ToU 硬性要求），插件已强制，请勿调低。
- GitHub 匿名限流 10 次/小时，撞限时会自动冷却该源。

开发

git clone https://github.com/AllenCoderBug/dsh-web-search-zerokey.git
cd dsh-web-search-zerokey
npm test # 162 个用例

设计与实现细节见 CONTRIBUTING.md 与 UPGRADE-PLAN.md（含每条决策的依据分级）。

致谢

Provider 接口形态参考了 dsh-web-search-searxng （MIT，by chinng_inta）。实现（HTML 抓取解析、多源聚合、路由、自适应、TLS CA 注入）为独立开发。

许可

MIT