dsh-smart-proxy
English | 中文
为 DeepSeek Harness 桌面版提供可切换的代理模式、连通性自检和 SSE 超时保护，专治 Transport Failed 与 TLS 证书拦截。
解决什么问题
国内网络环境下，DSH 桌面版经常出现以下症状：
- 对话请求报
Transport Failed，但浏览器/curl 访问同一域名正常；
- 公司网络或杀毒软件做 HTTPS 中间人，导致 TLS 证书校验失败；
- 深度思考模型流式输出中途断连，前功尽弃。
本插件把「代理选择 → 连通性验证 → 长连接保活」串成一条链路，并把当前网络状态暴露成 Agent 工具，出问题时能直接问出来。
功能
- 三种代理模式：
system（跟随系统） / manual（手动指定） / direct（强制直连）
- 启动自检：启动时探测 DeepSeek API 连通性，失败时在日志中给出明确原因
- 超时保护：单独放大 SSE 流式超时（默认 10 分钟），避免长回答被截断
- 热重载：修改配置后即时生效，无需重启 DSH
- 诊断工具：在对话中调用
smart-proxy.status / smart-proxy.switch-mode
安装
dsh plugin --profile web add dsh-smart-proxy # Web / 插件中心
dsh plugin --profile desktop add dsh-smart-proxy # 桌面版
安装后重启 dsh web，在「设置 → 插件」中确认 smart-proxy 已启用。
本地开发时也可以直接从目录安装：
git clone https://github.com/Jack-jiang421/dsh-smart-proxy.git
dsh plugin add /absolute/path/to/dsh-smart-proxy
配置
在 ~/.dsh/profiles/<profile>/cordis.patch.yml 中覆盖 smart-proxy 的配置：
- id: smart-proxy
config:
mode: manual
proxyUrl: "http://127.0.0.1:7890"
| 参数 | 类型 | 默认值 | 说明 |
|---|
mode | string | system | 代理模式：system / manual / direct |
proxyUrl | string | http://127.0.0.1:7890 | manual 模式使用的代理地址 |
streamTimeout | number | 600000 | SSE 流式超时（毫秒） |
connectTimeout | number | 30000 | TCP 连接超时（毫秒） |
keepAlive | boolean | true | 启用 TCP Keep-Alive |
retryOnTransportError | boolean | true | 传输层错误自动重试 |
maxRetries | number | 3 | 最大重试次数 |
ignoreTlsErrors | boolean | false | 忽略 TLS 证书错误（仅在自签/中间人环境开启） |
bypassDomains | string[] | ["localhost", "127.0.0.1", "::1"] | 不走代理的域名 |
autoTest | boolean | true | 启动时自动测试连通性 |
ignoreTlsErrors 会降低安全性，只在明确知道证书被拦截时临时开启。
在对话中使用
插件注册了三个 Agent 工具，直接用自然语言触发即可：
| 说法 | 工具 |
|---|
| 「看一下当前代理状态，顺便测下连通性」 | smart-proxy.status |
| 「切换到直连模式」 | smart-proxy.switch-mode |
status 返回当前模式、代理地址、TLS 豁免状态、连通性结果与延迟；switch-mode 支持 direct / manual / system，可同时传入新的 proxyUrl。
排查 Transport Failed
- 先把
mode 改为 direct，确认问题是否由代理引起；
- 核对
proxyUrl 端口与本机代理软件一致（Clash 常见 7890，V2Ray 常见 10809）；
- 在代理规则里把
api.deepseek.com 设为 DIRECT，排除规则误判；
- 临时关闭杀毒软件的 HTTPS 流量扫描（卡巴斯基、火绒等）；
- 日志中搜索
[dsh-smart-proxy] 获取完整诊断。
兼容性
- DSH
>=0.2.0（engines.dsh）
- Cordis
^4.0.1
License
MIT
