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
