Skip to content
Back to search

dsh-network-settings

DSH网络设置插件 | DeepSeek Harness network diagnostics, proxy detection and repair for Windows/WSL/MacOS

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/kanneiren--dsh-network-settings/badge.svg)](/listings/kanneiren--dsh-network-settings)

HTML

<a href="/listings/kanneiren--dsh-network-settings"><img src="/api/listings/kanneiren--dsh-network-settings/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

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

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

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

打开 **设置 → 插件 → 网络**。

<details> <summary>直接从 GitHub 安装(备选)</summary>

dsh plugin --profile web add github:kanneiren/dsh-network-settings

从 GitHub 安装时需要在安装现场构建(`prepare` 脚本),而 pnpm 默认会 拦截 git 来源包的构建脚本,需要先放行。如果安装报 `ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED`,把报错信息中打印的完整 `allowBuilds` 键复制进 `%UserProfile%\.dsh\profiles\<profile>\pnpm-workspace.yaml`,再重新执行 安装命令。键的格式如下:

allowBuilds:
  dsh-network-settings@https://codeload.github.com/kanneiren/dsh-network-settings/tar.gz/<commit>: true

键中固定了解析出的 commit 哈希,所以每个新版本都要重新放行一次 (pnpm 不支持对 git 来源的包使用通配符)。上面的 npm 仓库安装没有 这一步。

</details>

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 140 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # dsh-network-settings
  2. <p align="center">
  3. <a href="README.md">简体中文</a> | <a href="README.en.md">English</a>
  4. </p>
  5. DSH 网络设置:为 DeepSeek Harness 提供 Windows / WSL / macOS 网络链路诊断与安全修复。
  6. ## 特性
  7. - 自动检测 **Windows 原生**、**WSL 发行版** 与 **macOS** 三种运行模型。
  8. - 展示当前 **DSH 进程** 的真实网络路径、DNS 侧支和第一个失败点;TUN/VPN 虚拟网卡后面自动补出物理出口与真实网关。
  9. - 识别 **配置漂移**:配置不同但网络正常时只提示,不警告。
  10. - 支持 **单次检测** 与 **稳定性检测**,默认目标 DeepSeek、可随时切换;每层探测与整次检测都有超时上限,网络故障也不会长时间无响应。
  11. - 一键复制 **适合 Agent 的 Markdown 网络报告**:固定英文小节标题与 `report-version`、TL;DR 摘要先行、机器可读的诊断码与分层探测延迟。
  12. - **推荐修复** 只在高置信度诊断映射到常用低风险操作时出现(如清理代理残余环境变量、关闭系统代理、刷新 DNS 缓存);管理员级与高风险操作仅保留在手动目录。
  13. - 持久化修改遵循:**快照 → 预览 → 确认 → 应用 → 重新检测 → 可回滚**。
  14. - UI 使用 DSH 原生组件与 `--dsw-*` token,不建立独立主题。
  15. ## 界面
  16. <table>
  17. <tr><td colspan="2" align="center">
  18. 插件位于 **DSH 设置 → 插件 → 网络**(点击图片可放大)
  19. <a href="docs/images/wsl-in-dsh.png"><img src="docs/images/wsl-in-dsh.png" width="720" alt="插件在 DSH 设置界面中的位置"></a>
  20. </td></tr>
  21. <tr>
  22. <td width="50%" align="center">
  23. <a href="docs/images/wsl-path-graph.png"><img src="docs/images/wsl-path-graph.png" width="380" alt="WSL 中的 DSH 网络链路"></a>
  24. <sub>WSL 发行版中的 DSH 链路:DSH → 发行版 → WSL NAT → Windows Host → 代理 TUN → 物理网卡 → 网关 → 目标</sub>
  25. </td>
  26. <td width="50%" align="center">
  27. <a href="docs/images/win-path-graph.png"><img src="docs/images/win-path-graph.png" width="380" alt="Windows 中的 DSH 网络链路"></a>
  28. <sub>Windows 原生 DSH 链路:TUN/VPN 虚拟网卡后自动接出物理出口与真实网关</sub>
  29. </td>
  30. </tr>
  31. <tr>
  32. <td width="42%" align="center" valign="top">
  33. <a href="docs/images/win-network-config.png"><img src="docs/images/win-network-config.png" width="300" alt="网络配置"></a>
  34. <sub>网络配置分组视图</sub>
  35. </td>
  36. <td width="58%" valign="top">
  37. **网络配置**按来源分组,每个配置项可溯源:
  38. - **Windows 代理**:WinINet / WinHTTP 状态、三个作用域的代理环境变量(含大小写)
  39. - **DSH 进程环境**:运行时模型、出口方式(直连 / 经代理 + 地址)、代理端口的**监听进程实测**、进程代理变量
  40. - **WSL**:发行版环境变量、网络模式(NAT / mirrored)、`/etc/wsl.conf` 与 `.wslconfig`
  41. - **高级网络**:DNS 缓存、接口路由、Hosts、系统急救操作
  42. 修改类操作全部遵循 快照 → 预览 → 确认 → 应用 → 可回滚。
  43. </td>
  44. </tr>
  45. </table>
  46. ## 安装
  47. 从 npm 仓库安装(推荐,自带预构建产物,无需额外配置):
  48. ```powershell
  49. dsh plugin --profile web add dsh-network-settings
  50. ```
  51. 再次执行同一条命令即可更新到最新版。刚发布不久的版本可能被 pnpm
  52. 的 `minimumReleaseAge` 供应链策略暂缓——用显式版本号安装
  53. (`dsh plugin --profile web add dsh-network-settings@<版本号>`)或稍后重试。
  54. 打开 **设置 → 插件 → 网络**。
  55. <details>
  56. <summary>直接从 GitHub 安装(备选)</summary>
  57. ```powershell
  58. dsh plugin --profile web add github:kanneiren/dsh-network-settings
  59. ```
  60. 从 GitHub 安装时需要在安装现场构建(`prepare` 脚本),而 pnpm 默认会
  61. 拦截 git 来源包的构建脚本,需要先放行。如果安装报
  62. `ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED`,把报错信息中打印的完整
  63. `allowBuilds` 键复制进
  64. `%UserProfile%\.dsh\profiles\<profile>\pnpm-workspace.yaml`,再重新执行
  65. 安装命令。键的格式如下:
  66. ```yaml
  67. allowBuilds:
  68. dsh-network-settings@https://codeload.github.com/kanneiren/dsh-network-settings/tar.gz/<commit>: true
  69. ```
  70. 键中固定了解析出的 commit 哈希,所以每个新版本都要重新放行一次
  71. (pnpm 不支持对 git 来源的包使用通配符)。上面的 npm 仓库安装没有
  72. 这一步。
  73. </details>
  74. ## 使用
  75. ```text
  76. 打开页面 → 只显示缓存摘要,不执行探测
  77. [单次检测] → 采集 + 当前目标探测 + DSH 链路图
  78. [稳定性检测] → TCP/HTTP 重复采样
  79. [复制网络报告] → 生成 Agent 可用的 Markdown 报告
  80. ```
  81. ## 文档
  82. | 文档 | 内容 |
  83. |---|---|
  84. | [架构](docs/architecture.md) | 模块、运行模型、探测、修复保证 |
  85. | [诊断流程](docs/diagnostics.md) | 诊断结果如何产生与展示 |
  86. | [网络急救](docs/network-first-aid.md) | 操作、风险、可靠性 |
  87. | [Agent 指南](docs/agent-guide.md) | 开发命令与扩展点 |
  88. | [发布检查清单](docs/release-checklist.md) | 发布步骤 |
  89. | [网络路径图与漂移](docs/network-path-graph.md) | 图与 UI 行为细节 |
  90. ## 支持
  91. - DSH:`@deepseek-ai/dsh >= 0.1.0-rc.6`(实测 0.1.0-rc.7 – 0.1.1-rc.2;Web profile)
  92. - 平台:Windows 10/11 + WSL;macOS(CI 已验证,真机验收待做)
  93. - 所有检测默认只读,只有用户明确确认后才修改配置
  94. ## 隐私
  95. 无遥测。报告与快照在写入本地前自动脱敏。
  96. ## License
  97. [MIT](LICENSE)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.