Wiselfx/dsh-freeweb

dsh-freeweb

面向 DeepSeek Harness 的免密钥网页搜索。
无需 API 密钥。无需注册。无需配额所有者。

它是什么

一个 WebSearchProvider 插件，用于 dsh 的 Web 能力接缝
（ctx.web）。它原样保留 dsh 内置的 web_search 工具、引用卡片和 UI，
只替换它们背后的引擎。查询会分发到三个独立的免密钥引擎——外加一个可选的第四个——并以一个共识排名的答案返回。

| 引擎 | 类型 | 需求 |
| --- | --- | --- |
| DuckDuckGo（html.duckduckgo.com） | HTML 抓取器；POST 并自动回退到 GET | 无 |
| Startpage（startpage.com/sp/search） | 隐私代理背后的 Google 索引；在纯 Node 中解算其 Anubis SHA-256 工作量证明 | 无 |
| Perplexity（perplexity.ai/rest/sse/perplexity_ask，匿名） | 通过 SSE 返回的合成答案 + 引用来源 | 无 |
| Firecrawl（api.firecrawl.dev/v2/search，可选） | 基于 SERP 的结果，原生 Google 操作符 | API 密钥（环境变量 FIRECRAWL_API_KEY）或自托管端点；没有时自动跳过 |

安装

需要 Node.js ≥ 20.3 和 dsh。别无其他。

直接从 GitHub 安装——无需 npm 账号：

npx -y @deepseek-ai/dsh plugin --profile web add wiselfx/dsh-freeweb

dsh plugin 会将安装规格原样转发给 pnpm，因此 owner/repo、完整的
https://github.com/…​.git URL 以及固定引用（owner/repo#v0.1.0）都可以
使用——该包会从 GitHub 获取并激活，因为它声明了一个 dsh bundle。

本地检出：

npx -y @deepseek-ai/dsh plugin --profile web add /path/to/dsh-freeweb

npm（如果曾发布）：

npx -y @deepseek-ai/dsh plugin --profile web add dsh-freeweb

重启 dsh，然后在不花费任何成本的情况下验证组合：

npx -y @deepseek-ai/dsh --profile web --dump-config   # expect searchProvider: freeweb

有关全部三种路径的详细信息、卸载步骤和故障排除，请参阅 docs/install.md。

配置

默认值位于插件条目上；每个值都是可选的：

- id: freeweb
name: 'dsh-freeweb'
config:
engines:
duckduckgo: true
startpage: true
perplexity: true
firecrawl: auto      # auto = only when a key/endpoint exists; true|false also accepted
firecrawlApiKey: ''    # or env FIRECRAWL_API_KEY; free tier at firecrawl.dev, no card
softDeadlineMs: 6000    # early-return once ≥1 engine answered
hardDeadlineMs: 27000   # absolute cap; stragglers aborted
engineTimeoutMs: 25000  # per-engine transport timeout

截止时间会约束每次调用：每个引擎单独获得 25 秒，整个
分发过程在 6 秒时一旦有结果返回就提前返回，且任何内容都不会超过
27 秒。配置更改在 dsh 重启后生效。

工作原理

该提供程序会并发触发每个已启用的引擎，并合并所有返回的内容
由跨引擎一致性支持：URL 会先按规范键去重，然后按返回它们的引擎数量排序，再按各引擎中的最佳位置排序。一个被阻断或缓慢的引擎绝不会导致搜索失败——单引擎的障碍会被静默吸收——只有所有引擎同时失败才是错误。完整设计，包括失败语义以及如何添加引擎，见
docs/architecture.md。

测试

node test/integration.mjs

实时端到端测试套件：通过网络调用真实引擎，并使用模拟的测试框架上下文检查插件接线。测试通过。可选参数可运行你自己的查询：

node test/integration.mjs "your query here"

⚠️ 此插件由 AI 制作

此插件由人工智能——Lantern（ox-alpha），一个 AI 编码代理——在少量人工监督下完成设计、移植和端到端测试。没有任何人类编写搜索逻辑。

引擎、共识合并、截止时间控制器以及本文档，全部由该模型在实时网络环境下生成。
请据此评判代码：它经过了异常充分的测试，且完全没有自我。
状态：个人作品 / 概念验证。 它的存在是因为作者想要在 dsh 中进行无密钥搜索，而现在它做到了。它可能会也可能不会收到更新。按原样提供。如果你想要一个维护中的版本，请 fork 它——欢迎 fork，PR 也会在生活允许时阅读。

致谢与感谢

- oh-my-pi（MIT）——本包的大部分内容移植自其网页搜索子系统，文件映射见
NOTICE。它帮助了非常多。
- DeepSeek Harness——一个
优秀、对插件友好的测试框架；扩展起来确实令人愉快。既然说到这里，也顺便温和地建议一句：内置的无密钥网页搜索会让它更好。
- Lantern（ox-alpha），编写此内容的 AI——其作者的痕迹存在于每一个正则表达式中。
- Cinder（hy3），另一个 AI——在全新容器中进行独立 QA。发现了本包发布时遗漏的那一行 manifest，端到端证明了 GitHub 安装路径，并让最初三座城市（NYC · Boise · Seattle）通过了扇出流程。灯笼建造；余烬验证。
- wiselfx——拨动了每一个开关，推送了每一个修复，保持了氛围不变。
这个作品之所以存在，是因为他们希望它存在。

许可证

MIT。大部分内容移植自 oh-my-pi 的 MIT 许可网页搜索子系统；版权行和逐文件映射见 NOTICE。