前言¶
DeepSeek Harness (DSH) 在运行时依赖网络进行 LLM 调用、网页搜索和 HTTP MCP 交互。在受限网络环境下，直接修改系统环境变量既繁琐又容易出错。本插件提供了一个图形化的配置入口，允许用户在 DSH 的设置界面中定义全局出站代理，并将配置持久化到 ~/.dsh/.env 文件中。
插件定位¶
这是一个 DeepSeek Harness (DSH) 插件，由 naitoupi 维护。它解决了在 DSH 界面中集中管理代理配置的需求，确保 LLM、网页搜索和 HTTP MCP 流量遵循统一的网络策略。
核心功能¶
- 设置 → 出站代理：在设置界面输入
http(s)://格式的代理地址并保存。 - 恢复默认：点击恢复默认按钮将清空代理配置，恢复直连。
- 持久化写入：配置会合并式写入
~/.dsh/.env，保留文件中原有的其他行。 - 协议与路由限制：
- 仅支持
http(s)://协议，拒绝 SOCKS 代理。 - 本地地址（
localhost/127.0.0.1）强制直连，不走代理。
安装与启用¶
- 添加依赖：将插件包添加到 web profile 的依赖中。
dsh plugin --profile web add github:naitoupi/dsh-outbound-proxy
- 配置 Bundle：编辑
~/.dsh/profiles/web/package.json，在dsh.profile.bundles字段中添加"dsh-outbound-proxy"。 - 安装并重启：执行安装命令并重启 DSH。
dsh plugin --profile web install
典型用法¶
- 打开 DSH 设置面板。
- 找到「出站代理」选项。
- 输入代理地址（例如
http://127.0.0.1:7890）。 - 保存配置并重启 DSH。重启后，代理将对所有网络请求生效。
适用场景与注意¶
- 适用场景：需要在受限网络环境（如公司内网、防火墙后）访问外部 API 的 DSH 用户。
- 生效机制：DSH 内置了
@deepseek-ai/dsh-http-proxy，启动时会读取环境变量或~/.dsh/.env中的http_proxy/https_proxy。修改配置后必须重启 DSH 才能生效。 - 生态规范：DSH 理念是「一切皆插件」。本插件遵循这一生态规范，由社区维护，不属于官方组件。安装前建议检查源码与许可证（MIT）。
