网络代理诊断助手Edge-Echo/dsh-netassist

dsh-netassist

dsh-netassist

npm version
npm downloads
license
GitHub stars

面向 DeepSeek Harness (dsh) 的网络与代理助手。

源自真实的大陆网络痛点：GitHub 时通时断、到处是代理、hosts 冲突、TUN 模式和系统代理分不清。这个插件让 agent 一键回答「GitHub 通不通？」「系统代理是什么？」「代理端口活着吗？」，外加完整诊断链——全部只读、全部防注入。

English docs: README.md.

工具

| 工具 | 回答什么问题 |
|---|---|
| net_github_status | GitHub 现在通不通？（DNS + TCP 443） |
| net_proxy_status | 系统代理配置：注册表 ProxyEnable/ProxyServer/ProxyOverride + 代理环境变量 |
| net_proxy_probe | 哪些常见本地代理端口活着？（默认 10808/10809/7890/7897/8888/1080） |
| net_diag | 任意主机完整诊断链：DNS → TCP → HTTPS 状态码 |
| net_hosts_check | hosts 里钉了哪些 GitHub 条目（代理冲突扫描） |

安装

dsh plugin --profile web add dsh-netassist
dsh web   # 重启

然后直接问 agent：
- 「检查 github.com 通不通」→ net_github_status
- 「我的系统代理是什么？」→ net_proxy_status
- 「我的代理在跑吗？」→ net_proxy_probe
- 「为什么访问不了 api.example.com:8443？」→ net_diag host=api.example.com port=8443
- 「hosts 里有 github 条目吗？」→ net_hosts_check

工作原理

每个工具通过 powershell.exe -NoProfile -NonInteractive 执行一段只读 PowerShell 脚本。所有用户输入以 Base64 形式跨脚本边界——从结构上杜绝注入。不写文件、不需要管理员权限、零依赖。

- 配置：psTimeoutMs（默认 25000）——单次调用超时，可在 profile 的 cordis.patch.yml 的 netassist 条目下设置。
- 仅 Windows：非 Windows 平台明确报错。

真实示例（本机实测）

net_github_status → DNS: 20.205.243.166, TCP 443: OPEN
net_proxy_status  → ProxyEnable: 1, ProxyServer: 127.0.0.1:10808
net_proxy_probe   → 10808 OPEN, 10809/7890/7897/8888/1080 CLOSED
net_hosts_check   → no github entries in hosts (clean)

排错

- 报 "PowerShell failed"：多半是执行策略或杀软干扰。插件已用 -NoProfile -NonInteractive；可查 Get-ExecutionPolicy——不要求 RemoteSigned。
- 端口探测每个 5 秒连接超时，完整探测最坏约 5-10 秒。

链接

- npm:
- GitHub:
- License: MIT