网络设置 dsh-plugins/dsh-network-settings

@dsh-plugin/dsh-network-settings

一个 DeepSeek Harness 插件，打包了三项网络能力——User-Agent 改写（来自 @dsh-plugin/dsh-user-agent）、HTTP / HTTPS-CONNECT / SOCKS5 代理（来自 dsh-net-proxy），以及可配置的请求自动重试——全部在 Web 设置里的单个网络设置 (Network) 标签页中操作。

功能

- User-Agent 改写——对所有走全局 fetch 的出站请求（dsh-llm-deepseek 发起的 LLM API 调用、网页搜索、HTTP 工具……）强制使用自定义 User-Agent，覆盖调用方自己的请求头。可开关、可编辑字符串，下一个请求立即生效。
- 网络代理——让智能体的网络请求走 HTTP（CONNECT 隧道）或 SOCKS5 代理，支持可选的用户名/密码、NO_PROXY 直连列表（host / 后缀 / host:port / IPv4 CIDR / * / <local>），以及请求超时。测试连接 (Test connection) 按钮会在设置页发起一次真实的连通性 + 延迟探测（代理 TCP 握手、总往返耗时、目标 HTTP 状态）。
- 请求自动重试——配置最大请求重试次数（0 = 关闭）：出站请求因网络层错误（undici 的 connect/timeout/reset 错误码）或可重试状态码（429、500、502、503、504）失败时，自动重试，采用有上限的指数退避（基数 500 ms，上限 10 s）+ 10% 抖动。中止（用户取消）和不可重放的流式请求体永不重试；只有请求体可重放时（string / URLSearchParams / ArrayBuffer / Blob / FormData）才会重放。
- 一个设置标签页，三个独立分区——UA、代理、重试三个分区各有自己的保存 (Save) 按钮；改动在下一个请求即时生效，无需重启。所有值都存放在标准的 dsh-network-settings 用户设置命名空间中。
- 干净的生命周期——globalThis.fetch 只在插件运行时被包装；原始 fetch 只捕获一次，在停止 / 更新 / 移除时还原。
- 同源探测路由——/_dsh/dsh-network-settings/probe 执行代理连通性测试（只读，绝不写入配置）。

安装

本包是 dsh bundle 插件（dsh.bundle.patch），用标准的 dsh plugin add 命令安装：

dsh plugin add @dsh-plugin/dsh-network-settings
or, with a specific profile
dsh plugin --profile web add @dsh-plugin/dsh-network-settings

然后在 Web GUI 中打开 Settings → 网络设置：编辑三个分区中的任意一个，点它自己的保存按钮。

替换旧插件

本插件取代 @dsh-plugin/dsh-user-agent 和 dsh-net-proxy（它实现了二者的全部功能）。安装后从配置档中移除它们：

dsh plugin remove @dsh-plugin/dsh-user-agent
dsh plugin remove net-proxy
已有数据会自动迁移：如果旧的 ~/.dsh/net-proxy.json（或 $DSH_HOME/net-proxy.json）存在，启动时会把它里面的代理字段合并到插件的基础层（你在网络设置标签页保存的值始终优先）。

配置

插件入口（cordis.patch.yml / profile override）——这些值充当组合的 base 层，会和用户设置部分合并：

| 字段 | 类型 | 默认值 | 含义 |
| uaEnabled | boolean | true | UA 改写总开关；关闭时调用方的 User-Agent 直接透传。 |
| userAgent | string | DeepSeek-Harness/0.1 (+https://github.com/deepseek-ai/dsh) | 应用到每个改写请求的 User-Agent。 |
| proxyEnabled | boolean | false | 代理总开关；关闭时请求直连。 |
| proxyProtocol | string | http | 代理协议：http（CONNECT 隧道）或 socks5。 |
| proxyHost | string | 127.0.0.1 | 代理地址。 |
| proxyPort | number | 7890 | 代理端口。 |
| proxyUsername | string | '' | 可选的代理用户名。 |
| proxyPassword | string | '' | 可选的代理密码。 |
| proxyNoProxy | string[] | ['127.0.0.1','localhost','::1'] | 直连主机列表；命中的请求绕过代理。 |
| proxyTimeoutMs | number | 60000 | 代理请求超时，单位 ms。 |
| retryEnabled | boolean | true | 自动重试总开关。 |
| maxRetries | number | 2 | 请求最大重试次数（0 = 不重试）。 |

工作原理

- 宿主部分安装 dsh-network-settings 设置命名空间（installSettingsSection），并用三层栈包装一次 globalThis.fetch，每次请求都读取： retry → User-Agent rewrite → proxy → original fetch。重试请求的每一次尝试都会重新读取最新的已解析配置，所以保存的改动会立刻作用于下一次请求。
- 代理引擎是移植过来的 dsh-net-proxy 实现（HTTP 绝对 URL 转发、HTTPS 走 CONNECT、SOCKS5 协商并支持 RFC 1929 认证、流式响应体并解码 gzip / br / deflate、通过 ALPN 支持 HTTP/2、跟随重定向、NO_PROXY 匹配）。
- 浏览器部分注册 settings.section 标签页，并通过连接的 ApiProxy（api.settings.describe / update）读写命名空间，这和 aux/mainline DSH 插件用的是同一个接缝；代理连通性测试走同源探测路由。

开发

npm install # dev deps + auto-installed peers
npm run build # tsc (host + client) + strip client module-ification artifact
npm test # node --test (TypeScript tests run natively on Node ≥ 23.6)
npm pack --dry-run # inspect published contents

所有源码——宿主、代理引擎、设置 UI 和测试——都是 TypeScript。

许可证

MIT