dsh-wsl-wslconfig：解析 .wslconfig 并建议使用 DSH :3081 中继

前言¶

在 DeepSeek Harness (DSH) 环境下开发智能体时，网络配置往往是基础但容易出错的地方。Windows 的 .wslconfig 文件决定了 WSL2 的网络模式（Mirrored 或 NAT）。如果该配置与 DSH 的中继服务（:3081）不匹配，可能导致连接异常或无法启动。dsh-wsl-wslconfig 插件旨在解决这一对齐问题，它通过只读解析配置并给出建议，帮助开发者确保网络环境正确。

插件介绍¶

这是 DeepSeek Harness 的工具 wslconfig_hint，属于 dsh-wsl-kit 套件的一部分。插件版本为 0.2.0。它的核心职责是读取 Windows 侧的 .wslconfig 文件，判断当前的镜像网络或内存设置，并验证这些设置是否适合 DSH 的 :3081 中继服务。

核心功能¶

插件主要提供以下能力：
1. 只读解析：读取 Windows 的 .wslconfig 文件，提取镜像网络和内存相关的配置项。
2. 中继建议：建议使用 DSH 的 :3081 端口进行中继，避免直接使用 dsh --host 0.0.0.0。
3. 模式匹配检查：检查当前的 Mirrored 或 NAT 网络模式是否与 :3081 中继的要求一致。

安装与依赖¶

安装前请确保 DSH 版本满足要求。

检查 DSH 版本：

   dsh --version

要求 dsh 版本 ≥ 0.1.2。

安装插件：

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

使用说明¶

安装完成后，插件会在运行时介入。它会读取当前的 .wslconfig 配置，并告知用户网络模式是否适用于 DSH 的 :3081 中继。如果配置不匹配，它将提示相应的调整方向。该工具要求在 Windows relay :3081 上使用 Web UI 的 one-shot ?token= 模式。

注意事项¶

只读权限：插件仅读取配置，不会写入文件，因此是安全的。
环境依赖：必须在 Windows 环境下运行，且 dsh 版本需满足 ≥ 0.1.2。
Cloud Flash 配置：若需使用 Cloud Flash 模型，需在 ~/.dsh/settings.yaml 或 llm-deepseek 中使用 deepseek-flash (V4.1 Flash) 模型 ID，此插件不负责该配置。
套件归属：它是 dsh-wsl-kit 套件的一部分。

总结¶

dsh-wsl-wslconfig 专注于 WSL 环境下的网络配置对齐。通过仅读解析 .wslconfig 并建议使用标准的中继端口，它帮助开发者规避常见的网络连接问题。更多细节和故障排查路径可参考 dsh-wsl-kit。