前言¶

在使用 DeepSeek Harness (DSH) 开发或调试时，若遇到 Web UI 界面空白或连接错误，通常与 WSL 网络配置有关。服务绑定在 WSL 中，从 Windows 访问时可能需要特定的 IP 地址、防火墙规则，或者需要重启 WSL。本插件通过检查 hostname -I 和 ss 监听状态，诊断端口归属并给出 Windows localhost 转发建议。

是什么¶

dsh-wsl-port 是 DeepSeek Harness 的联网工具插件，隶属于 dsh-wsl-kit 套件。它提供了一个名为 port_doctor 的诊断工具，用于报告 WSL 的 IP 地址以及 TCP 端口是否处于监听状态，并针对 Windows 端的 Localhost 转发提供操作建议。

核心功能¶

• 诊断 WSL 中哪个进程占用了特定端口。
• 报告 WSL 的 IP 地址以及 TCP 端口是否处于监听状态。
• 提供关于 Windows localhost 转发的具体建议。
• 检查 hostname -I 输出和 ss 的监听状态。

安装与启用¶

使用 DSH 的插件管理命令安装：

dsh plugin --profile web add github:173787247/dsh-wsl-port

配置¶

插件支持配置超时时间和默认端口：

- id: dsh-wsl-port
  name: dsh-wsl-port
  config:
    timeoutMs: 15000
    defaultPort: 3080

使用说明¶

• 默认端口：工具默认检查端口 3080，可通过参数覆盖。
• 端口区分：DSH Web UI 使用 3080 (WSL 内部) 和 3081 (Windows 转发，需带 ?token=)。若 Windows 端访问 :3080 出现空白或认证错误，应检查 :3081/?token=。
• 运行建议：不要在 Windows 端绑定 dsh web --host 0.0.0.0。推荐在出现问题时先运行套件中的 restart-dsh-web.sh 和 check-dsh-health.sh。

环境要求与注意¶

• 依赖：需要安装 DSH 版本 ≥ 0.1.2。
• 所属套件：属于 dsh-wsl-kit 套件的一部分，推荐使用 KIT_SET=daily、llm 或 full 套件。
• 许可：采用 MIT 许可证。

结语¶

port_doctor 是解决 DSH 在 WSL 环境下端口映射和连接问题的实用工具。更多细节可参考 GitHub 仓库。