前言¶
在 DeepSeek Harness (DSH) 的開發場景中，若需在 WSL (Windows Subsystem for Linux) 環境下複用 Windows 的 OpenSSH 代理，通常需要依賴 npiperelay 進行橋接。這類配置涉及文件路徑、權限和連接狀態，排查較爲繁瑣。dsh-wsl-ssh-agent 插件提供了一種診斷方案，幫助在不泄露密鑰的前提下確認轉發鏈路是否正常。
插件介紹¶
這是一個 DeepSeek Harness 插件，隸屬於 dsh-wsl-kit 套件。它的核心功能是診斷 WSL 中的 SSH 代理套接字以及 npiperelay 橋接狀態。與直接查看密鑰材料不同，該工具專注於檢查連接鏈路的可用性，確保配置的正確性。
核心功能¶
-
診斷 WSL SSH 代理套接字
檢查 WSL 內部的 SSH 代理套接字是否存在且可訪問。 -
檢查 npiperelay 橋接
驗證 Windows 端的npiperelay橋接是否正常工作，確保 Windows 代理能通過管道正確轉發到 WSL。 -
安全診斷
整個診斷過程不會打印密鑰材料，保障安全性。
安裝與啓用¶
執行以下命令安裝插件：
dsh plugin --profile web add github:173787247/dsh-wsl-ssh-agent
安裝完成後，重啓 dsh web 並打開一個新的會話，即可使用對應的工具。
典型用法¶
在新會話中，調用工具 ssh_agent_hint。該工具會輸出 WSL SSH 代理和 npiperelay 的診斷信息，幫助判斷配置是否正確。
兼容性與注意¶
- 插件版本：
0.2.0 - 最低 DSH 版本：
>= 0.1.2 - 許可證：MIT
結語¶
該插件爲在 WSL 環境下調試 SSH 代理轉發提供了標準化的診斷手段。通過非侵入式的檢查機制，避免了敏感信息的暴露。更多技術細節和故障排查路徑，可參考 dsh-wsl-kit 倉庫。
