🔍 dsh-free-search-builder

给 DeepSeek Harness (DSH) 装上免费、无需 API key 的联网搜索。 搜网页、搜新闻、搜资料，不花一分钱。

---

🎯 解决什么问题

DeepSeek Harness（简称 DSH）的官方联网搜索功能依赖官方 API key： key 缺失或失效时，web_search 工具就完全用不了（报 api key invalid）。

这个项目提供一个替代搜索插件（dsh-web-search-bing）： 抓取公开的 Bing 搜索页面，解析出规范的搜索结果。

• 🆓 零成本：不需要官方 key、不需要付费 API、不需要注册
• 🔌 一句话安装：对 DSH 说"帮我装免费搜索插件"，AI 自动搞定
• 📦 Bundle 自包含：装完零配置，重启即用

---

🚀 一句话安装

在 DSH 对话里直接说：

"帮我装免费搜索插件"

AI 会自动执行一条命令：

dsh plugin --profile web add 'github:SUJIElearning/dsh-free-search-builder&path:/scripts/dsh-web-search-bing'

装完重启 DSH，搜索就能用了。不用手动复制文件、不用手改配置——插件自带 bundle patch，自动注册 + 自动指定搜索 provider。

---

🧪 确认装好了

重启后问 DSH 几个不同的问题，看结果是否随之变化：

问题	应该看到
"北京天气怎么样"	天气网站（中国天气网、2345 等）
"DeepSeek 最新动态"	科技新闻、知乎、百科

每次返回不同的真实网站 = ✅ 工作正常。

---

🔧 常见问题

现象	原因	解决
报 provider bing is not registered	bundle 没装配	确认 dsh.profile.bundles 里有这个包
报 Cannot read properties of undefined	配置空	确认 config ?? {} 兜底（源码已修复）
结果永远一样	缓存	重启 DSH，换不同问题测试

---

📚 进阶

• 搭建手册：接口规范、解析逻辑、部署原理
• 验证报告：陌生用户视角的完整测试记录
• 源码：可直接运行的插件代码（含 bundle patch）
• SKILL.md：DSH 技能入口（AI 加载后自动会用）

---

🗺️ 项目结构

dsh-free-search-builder/
├── SKILL.md                          # DSH 技能入口
├── README.md                         # 本说明
├── VERIFICATION.md                   # 验证报告
├── references/
│   └── build-guide.md                # 技术搭建手册
├── scripts/
│   └── dsh-web-search-bing/          # 可运行的搜索插件（含 bundle patch）
│       ├── package.json              # 声明 dsh.bundle.patch
│       ├── cordis.patch.yml          # 自注册 + 自指定 searchProvider
│       └── lib/                      # 插件源码
└── evals/
    └── trigger_cases.json            # 技能触发测试

---

📄 开源协议

MIT · 自由使用、修改、分发，保留版权声明即可。

Made with ❤️ for the DSH community