dsh-netassist

Part of the dsh-toolkit family: dsh-mcp-bridge · dsh-win-toolkit · dsh-netassist · dsh-driftwatch

面向 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: https://www.npmjs.com/package/dsh-netassist
• GitHub: https://github.com/Edge-Echo/dsh-netassist
• License: MIT