Chuyển đến nội dung chính

dsh-netassist

Đã xác minh

dsh-netassist · v0.2.1 · MIT

Network & proxy assistant for DeepSeek Harness (dsh): one-shot GitHub connectivity check, system proxy status, proxy port probing, full diag chain (DNS/TCP/HTTP) and hosts-file conflict scan — built from real-world China-network experience.

Cài đặt

dsh plugin add dsh-netassist

Xác nhận layer đã áp bằng dsh --profile default --dump-config — xem hướng dẫn cài plugin.

Mã nguồn

Thẻ

Readme

dsh-netassist

dsh-netassist

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

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 秒。

链接