前言¶
在使用 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 網絡連接問題，可以通過該工具驗證解析結果的一致性。
