前言¶
在使用 DeepSeek Harness (DSH) 进行开发时，如果你在 WSL (Windows Subsystem for Linux) 环境下运行，可能会遇到 DNS 解析问题。Windows 和 WSL 的 DNS 行为存在差异，这会导致访问 GitHub、DeepSeek 或 npm 等服务时出现连接异常。dsh-wsl-dns 插件旨在解决这一问题，通过对比 WSL 与 Windows 的 DNS 解析结果，帮助开发者定位解析不匹配的端点。
插件简介¶
dsh-wsl-dns 是一个 DSH 插件，核心功能是“dns_doctor”。它通过对比 WSL 的 resolv.conf 与 Windows DNS 的解析行为，标记出两者不一致的端点。
核心功能¶
- DNS 对比：针对 DeepSeek、GitHub 和 npm 等常用端点，对比 WSL 与 Windows 的 DNS 解析结果。
- 差异标记：当 WSL 和 Windows 的解析结果不一致时，插件会进行标记，便于排查网络问题。
安装与启用¶
使用以下命令安装该插件：
dsh plugin --profile web add github:173787247/dsh-wsl-dns
安装完成后，插件即随 DSH 运行环境生效。
典型用法¶
安装插件后，在 DSH 交互环境中执行常规命令即可触发 DNS 对比逻辑。例如：
npm test
执行上述命令时，插件会自动介入并对比解析结果。
适用场景与注意事项¶
该插件适合在 WSL 环境下使用，特别是当你遇到网络连接异常且怀疑是 DNS 解析问题时。
- 权限说明：插件以当前 DSH 进程的权限运行，请确保已阅读源码。
- 代理设置：注意，该插件不会修改代理设置。
- 依赖要求：需确保 DSH 版本 >= 0.1.2，且 Node.js 版本 >= 18。
结语¶
dsh-wsl-dns 提供了一种在 WSL 环境下快速排查 DNS 解析差异的方法。如果你正在处理 WSL 网络连接问题，可以通过该工具验证解析结果的一致性。
