免密联网检索 arialp/dsh-fullweb

dsh-fullweb

给 DeepSeek Harness 提供免密钥的联网能力（用 npx @deepseek-ai/dsh web 启动）：

- web_search —— 匿名调用 DuckDuckGo HTML 搜索，失败时回退到 Bing。不需要 API key，也不走任何厂商计费端点。
- web_fetch —— 抓取公开的 HTTP(S) 资源，带 SSRF 防护（屏蔽 loopback、私有网段、link-local 和 file://；每一次重定向都会重新校验），限制大小与字符数，HTML→markdown 交给 dsh 自己处理。
- 「Code + full web」智能体预设（code-fullweb）—— 在自带的 code 预设基础上启用 web_fetch。首次启动时它会把自己装进你的预设根目录（~/.dsh/.agent-presets/），你更新本包时它也会跟着同步（受管副本带版本戳标记）。

所有请求都通过 Node 的 fetch 在本地完成。部署自带的搜索服务商（比如 DeepSeek）仍然注册着，但永远不会被选中，所以不会有任何网络流量打到付费端点。

环境要求

- Node 20+ 并带 npx，且 harness 能以 npx @deepseek-ai/dsh 调用（任何启动方式都行：web、TUI、headless）。
- PATH 里有 pnpm（npm install -g pnpm）—— 插件安装会转交给它。

安装

想在哪一个配置档里联网，就执行一次对应命令（通常只有浏览器 UI 用的 web）：

from npm:
npx @deepseek-ai/dsh plugin --profile web add dsh-fullweb

or straight from git (no registry needed):
npx @deepseek-ai/dsh plugin --profile web add git+https://github.com/arialp/dsh-fullweb.git#main

背后发生的事：pnpm 把包装进你的配置档，dsh 自动把它追加到该配置档的 bundle 栈里 —— 它的补丁层随后在宿主 web 行上选中本地服务商。下次启动时，插件还会把自带的预设复制到 ~/.dsh/.agent-presets/code-fullweb/（幂等操作；.dsh-fullweb-version 版本戳把它标记为受管）。

如果只想保留 web 工具、完全不让预设安装，就创建一个退出标记：touch ~/.dsh/.agent-presets/.dsh-fullweb-absent。

启用预设

服务商这一侧对整个配置档立即生效。面向模型的工具则出现在运行了启用 web_fetch 预设的会话里：

- 新对话： Settings → General → agent preset → 选 「Code + full web」，或者把它设为默认，这样每个新对话都能拿到这两个工具。
- 或者按用户文档设置（~/.dsh/settings.yaml）：

agent-presets:
default: code-fullweb

已有会话保留创建时用的预设；还没产出任何内容的会话，可以从自己的控制项里切换预设。

卸载 / 更新

npx @deepseek-ai/dsh plugin --profile web remove dsh-fullweb # or <git spec> if installed from git
npx @deepseek-ai/dsh plugin --profile web update # bump to the newest published version
remove 会把服务商和配置档层从该配置档里移除。~/.dsh/.agent-presets/ 里的预设副本会留下（现在归你了）；想删掉就删掉整个目录 —— 只要包还装着，先加上 .dsh-fullweb-absent，这样下次启动时引导流程不会把它恢复回来。如果你把 code-fullweb 设成了默认预设，先清掉这个设置（或者换一个），再执行移除。

配置

服务商条目（id: web-local）接受可选配置；在 ~/.dsh/profiles/web/cordis.patch.yml 里用自己的补丁层覆盖它：

- id: web-local
config:
userAgent: "MyAgent/1.0" # browser-like UA is the default (engines 403 the Node client)
fetchTimeoutMs: 45000 # per-request backstop; the tool layer's own budget still applies
maxRedirects: 5 # redirect hops allowed before WEB_LOCAL_TOO_MANY_REDIRECTS
downloadCapBytes: 25000000 # stop downloading past this (result is flagged truncated)
bodyCapChars: 100000 # decoded-body cap handed to the tool layer (truncated flag set)

所有键都是可选的；默认值适合常规网页使用。

说明与限制

- 搜索会抓取公开的 HTML 端点，所以结果好坏取决于 DuckDuckGo/Bing 的匿名档位，而且两个引擎都会对高频使用限流（DDG 失败时，服务商会自动改用 Bing）。
- 预设是 code（Code Mode）预设：它期望配置档里组合了 TypeScript 运行时（dsh-web-app 就是如此）。只有其他配置档也提供运行时，才装进去。
- 抓取防护会在连接前校验目标，并在每次重定向时校验，但 DNS 仍可能在检查与连接之间发生变化；把它当作本地工具的护栏，而不是安全边界。

许可证

MIT —— 见 LICENSE。