前言¶
在 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 仓库。
