kanneiren/dsh-network-settings 预览 preview

kanneiren/dsh-network-settings

Plugin插件 Native原生 ⭐ 105 MIT Dev Workflow开发与代码工作流

DSH网络设置:Windows / WSL网络路径诊断及DeepSeek Harness的安全修复。

Project Overview项目介绍

This is a native plugin built exclusively for DeepSeek Harness (DSH), designed to diagnose network issues and deliver safe fixes for DSH running on Windows native, WSL distributions, and macOS. It automatically detects the real network path of the DSH process, DNS configuration, and the first point of failure, and can map the physical exit and real gateway behind TUN/VPN virtual network adapters. The recommended installation method is via DSH's built-in plugin command from the npm registry, which includes pre-built assets and requires no extra manual configuration. After installation, the plugin can be accessed directly from the DSH settings menu under the plugins tab.

The plugin offers two detection modes, single-run detection and stability detection, with DeepSeek services set as the default target that can be changed at any time. After a scan completes, users can one-click copy a standardized Markdown network report formatted to be machine-readable for AI agents. For faults diagnosed with high confidence, the plugin suggests low-risk fixes, and all persistent configuration changes follow a snapshot-preview-confirm-apply-rollback workflow to prevent accidental misconfiguration. This tool is intended for users who experience DSH network connection issues, as well as developers debugging DSH network problems. It also identifies configuration drift without issuing unnecessary warnings when the network is still functional.

This plugin is released under the open-source MIT license, and collects no telemetry data from users. All locally saved data like reports and snapshots are automatically desensitized to protect user privacy. It requires DSH version 0.1.0-rc.6 or newer, and currently only supports the DSH Web profile. All detection operations are read-only by default, and configuration changes are only made after explicit user confirmation. The macOS platform has been validated via CI but not yet tested on physical devices, and all configuration changes support rollback to minimize user risk. Users can also update the plugin to the latest version by re-running the original install command.

这是一个专为DeepSeek Harness(DSH)开发的原生插件,为运行在Windows原生、WSL发行版和macOS平台上的DSH提供网络链路诊断和安全修复功能。它会自动识别DSH进程的真实网络路径、DNS配置和故障点,还能在TUN/VPN虚拟网卡后补出物理出口和真实网关信息。用户可通过DSH内置的插件管理命令从npm源直接安装,不需要额外的手动配置。

它支持单次检测和稳定性检测两种模式,默认检测DeepSeek服务,也可随时切换目标。检测完成后可以一键复制适合Agent读取的标准化Markdown网络报告,高置信度故障会推荐低风险修复操作,所有持久化修改都遵循快照→预览→确认→应用→可回滚的流程,避免误操作。这个插件主要面向遇到DSH网络连接问题的用户和相关开发调试人员。

该插件遵循MIT许可协议开源,无任何遥测采集,所有本地数据都会自动脱敏,保护用户隐私。它要求DSH版本不低于0.1.0-rc.6,目前仅支持Web profile,所有检测默认只读,只有用户明确确认后才会修改配置。macOS平台已通过CI验证,暂未完成真机验收,所有修改操作都支持回滚,降低使用风险。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 no risk signal found未发现风险信号
  • This site's static screen found no obvious risk signal (stars, license, activity, manifest)本站静态筛查没发现明显风险信号(星标、许可证、更新活跃度、清单完整度)
DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

  • DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
  • External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时(Electron / Python / Docker 等)是否齐备
  • Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突:命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

  • Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致,是否归档或长期停更
  • Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
  • curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
  • Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
  • Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需(filesystem / network / shell / clipboard)
  • Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限,以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照,不能替代安全审计。

Or use CLI install (for developers)或使用命令行安装(适合开发者)

CLI Install命令行安装

dsh plugin --profile web add dsh-network-settings

把 kanneiren/dsh-network-settings 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

dsh-network-settings

简体中文 | English

DSH 网络设置:为 DeepSeek Harness 提供 Windows / WSL / macOS 网络链路诊断与安全修复。

特性

  • 自动检测 Windows 原生、WSL 发行版 与 macOS 三种运行模型。
  • 展示当前 DSH 进程 的真实网络路径、DNS 侧支和第一个失败点;TUN/VPN 虚拟网卡后面自动补出物理出口与真实网关。
  • 识别 配置漂移:配置不同但网络正常时只提示,不警告。
  • 支持 单次检测 与 稳定性检测,默认目标 DeepSeek、可随时切换;每层探测与整次检测都有超时上限,网络故障也不会长时间无响应。
  • 一键复制 适合 Agent 的 Markdown 网络报告:固定英文小节标题与 report-version、TL;DR 摘要先行、机器可读的诊断码与分层探测延迟。
  • 推荐修复 只在高置信度诊断映射到常用低风险操作时出现(如清理代理残余环境变量、关闭系统代理、刷新 DNS 缓存);管理员级与高风险操作仅保留在手动目录。
  • 持久化修改遵循:快照 → 预览 → 确认 → 应用 → 重新检测 → 可回滚。
  • UI 使用 DSH 原生组件与 --dsw-* token,不建立独立主题。

界面

插件位于 DSH 设置 → 插件 → 网络(点击图片可放大)

插件在 DSH 设置界面中的位置

WSL 中的 DSH 网络链路

WSL 发行版中的 DSH 链路:DSH → 发行版 → WSL NAT → Windows Host → 代理 TUN → 物理网卡 → 网关 → 目标

Windows 中的 DSH 网络链路

Windows 原生 DSH 链路:TUN/VPN 虚拟网卡后自动接出物理出口与真实网关

网络配置

网络配置分组视图

网络配置按来源分组,每个配置项可溯源:

  • Windows 代理:WinINet / WinHTTP 状态、三个作用域的代理环境变量(含大小写)
  • DSH 进程环境:运行时模型、出口方式(直连 / 经代理 + 地址)、代理端口的监听进程实测、进程代理变量
  • WSL:发行版环境变量、网络模式(NAT / mirrored)、/etc/wsl.conf 与 .wslconfig
  • 高级网络:DNS 缓存、接口路由、Hosts、系统急救操作

修改类操作全部遵循 快照 → 预览 → 确认 → 应用 → 可回滚。

安装

从 npm 仓库安装(推荐,自带预构建产物,无需额外配置):

dsh plugin --profile web add dsh-network-settings

再次执行同一条命令即可更新到最新版。刚发布不久的版本可能被 pnpm 的 minimumReleaseAge 供应链策略暂缓——用显式版本号安装 (dsh plugin --profile web add dsh-network-settings@<版本号>)或稍后重试。

打开 设置 → 插件 → 网络。

Showing the opening section of the README — the full document lives in the repository以上为 README 开头摘要,完整文档在仓库内 · View the full README on GitHub →在 GitHub 查看完整 README →

← 上一个 Prev tokenbank 下一个 Next dsh-codex-desktop →