免密钥网页搜索 white-sparrow/dsh-rustxng-web-search

dsh-rustxng-web-search

为 DeepSeek Harness 提供免密钥的网页搜索。插件把 RustXNG 跑成本地子进程，再把它注册为 Harness web 服务的搜索服务商，于是 web_search 和 web_fetch 无需 API key，也不依赖任何外部服务。RustXNG 是用 Rust 写的 SearXNG 风格元搜索服务器。

RustXNG 采用 AGPL-3.0-or-later 协议。它的二进制文件不随本包或本仓库分发：安装时（或首次搜索时）从上游 GitHub releases 下载，用官方公布的 sha256 校验，存到 bin/。

你能得到什么

- 输入框工具行左侧的 Web search 开关。点一下，当前会话关闭网页搜索；再点一下重新打开。默认开启；恢复或分叉的会话重新从默认值开始。关闭后，该会话的工具里不再出现 web_search 和 web_fetch，模型也就够不到它们。
- 搜索结果带真实来源 URL，由 127.0.0.1:<port> 提供。
- 开关上的提示框，显示引擎版本、是否在运行，以及有待安装的新版本。

安装

打开 Plugin Manager（在 Harness 界面里，或在会话中用 plugin_manager 工具），安装下面任一项。仓库是公开的，不需要 npm：

| 来源 | 安装标识 |
| npm 包（待 stage 审核通过后） | dsh-rustxng-web-search |
| 本仓库 v1.0.1 标签 | dsh-rustxng-web-search@github:white-sparrow/dsh-rustxng-web-search#v1.0.1 |
| 打包好的 tarball —— release 里的附件 | <path>/dsh-rustxng-web-search-1.0.1.tgz |
| 本地 checkout，用于开发 | <path>/rustxng-web-search（pnpm 会链接它） |

本包不运行安装脚本，安装只是复制文件：首次搜索会把引擎下载到安装副本旁边的 bin/，并校验 sha256。想提前拿到二进制，运行 npm run engine（--force 重新下载，--latest 取最新 release）；RUSTXNG_ENGINE=skip 完全跳过这个脚本。

引擎供给

| 步骤 | 行为 |
| 资产 | <asset> = Windows 上为 rustxng-v<tag>-<arch>-pc-windows-msvc.exe，macOS 上为 …-apple-darwin，Linux 上为 …-unknown-linux-gnu（否则 -musl）。上游不发布 aarch64-pc-windows-msvc.exe，所以 ARM 上的 Windows 没有可下载的资产。 |
| 校验 | 对照 release 摘要校验 sha256，再核对精确字节数。 |
| 落盘 | 先写入 bin/rustxng.part-<pid>-<random>，再重命名到位。Windows 上替换自身文件前会先停掉正在运行的引擎。 |
| 续传 | 中断的下载用 Range 请求续传（最多 8 轮）。 |
| 更新 | 每隔 updateIntervalMs 检查上游；激活时若已安装副本超过 10 分钟也会检查。有更新的资产就替换二进制，下次搜索启动新引擎。检查失败不影响搜索。 |
安装后的元数据放在 bin/rustxng.json。bin/ 里的内容不会提交，也不会发布。

配置

所有键都可选；cordis.patch.yml 里的补丁默认带 config: {}。

binaryPath、bindAddress（127.0.0.1）、port（8888）、searchTimeoutMs （30000）、defaultEnabled（true）、engineRepo（sahenjp/RustXNG）、 engineVersion（固定为 0.4.1）、autoDownload（true）、autoUpdate（true）、 updateIntervalMs（21600000，即 6 小时）、downloadTimeoutMs（180000）、 checkTimeoutMs（15000）。

加载时遇到未知键会直接拒绝，并给出期望的键列表。

控制路由

插件在 Harness 端口上挂了一小片 HTTP 接口，路径前缀 /rustxng-web-search，供 Client 上的开关和排查问题使用：GET engine（返回内容与提示框一致）、GET version、GET state?session=<id>、GET tools、GET probe?query=…、 GET debug、POST set / POST clear（开关）、POST update。写路由只接受看起来不像外部来源的请求——页面自己的传输，或本地进程——因为这种传输不带 Origin 或 Sec-Fetch-Site。

排查

- RustXNG exited early (code N) → 端口冲突；改 port。
- 引擎连不上但搜索照常可用 → 正常；已安装的二进制会继续使用，GET engine 会在 note / error 里显示错误。
- 你的平台/架构没有对应资源 → GET engine 会在 target 里说明；把 binaryPath 指向你自己提供的二进制。
- 安装时报 ERR_PNPM_IGNORED_BUILDS → 你装的是 npm 上的 1.0.0，它带安装脚本；改用 1.0.1，或从本仓库的 tag 安装。

发布

插件有两种发布方式：npm 包（先暂存，再批准）和这个公开仓库——当前 tag v1.0.1，外加一个 GitHub release，附带 dsh-rustxng-web-search-1.0.1.tgz，也就是 npm pack 的产物。1.0.0 已经在 npm 上线；它的 tag 标记了当时发布的提交。

发布暂存用的是一枚仅限暂存的 Granular Access Token，放在被 gitignore 的 .env 里（NPM_TOKEN=<token>，见 .env.example）。

npm run stage # stage publish → prints the stage id
npm run stage:list # what is waiting
npm run stage:approve <stage-id> # needs your 2FA code: run this yourself

scripts/npm-auth.mjs 会在被 gitignore 的 .npm-tools/ 下装 npm 11.21.1（本机的 npm 10.x 没有 stage 命令），再把 token 从 .env 挪进一个临时的、仅属主可读的 .npmrc，命令结束就删掉。token 不会出现在任何命令行、日志、提交或 tarball 里。

已验证

关闭开关会隐藏该会话的两个工具，打开则恢复（对照实时 Agent 工具列表检查过）；冷启动后搜索能返回真实来源；从 GitHub 下载的引擎与上游公布的 sha256 一致；更新器通过一次真实 release 把 0.4.0 换成了 0.4.1。未检查：下载续传路径端到端跑通（中途没有长到需要中断的停顿），以及 chip 的 tooltip 在浏览器里长什么样。