wode25500/dsh-wsl：WSL 桥接插件介绍

DeepSeek Harness（DSH）的理念是“一切皆插件”。在 Windows 环境下，智能体需要调用 WSL 执行 Linux 命令、管理发行版或转换路径。下面介绍一个桥接插件，它将 WSL 的能力直接暴露为 DSH 原生工具。

这是一个 WSL (Windows Subsystem for Linux) 的 DeepSeek Harness (dsh) 桥接插件，由 WODE25500 维护。它允许智能体在 WSL 中运行 Linux 命令、管理发行版、转换 Windows ↔ WSL 路径，并实现跨系统复制文件。

核心功能¶

插件提供 5 个原生 DSH 工具：

• wsl_run：在 WSL 中执行 Linux 命令。
• wsl_distro_list：列出已安装的发行版及其状态。
• wsl_status：检查 WSL 系统状态与警告信息。
• wsl_path_convert：在 Windows 和 WSL 路径之间进行转换。
• wsl_copy：跨系统复制文件。

其他特性包括：

• 自动编码处理：自动处理 WSL 的 UTF-16LE 输出编码，解决管道输出乱码问题。
• 发行版管理：支持发行版指定与默认发行版配置。
• 路径转换：封装 wslpath，提供可靠的路径转换能力。
• 配置与兼容性：支持 Schemastery 配置 + bundle patch 层，以及明确的错误处理。

安装与启用¶

在 DSH 的 bundle profile 中添加以下配置：

- insert:
    - id: wsl
      name: './src/index.js'
      config:
        wslPath: wsl
        defaultDistro: Ubuntu
        timeoutMs: 120000

典型用法¶

安装后，可以直接调用上述工具。例如：

1. 使用 wsl_status 查看 WSL 状态。
2. 使用 wsl_run 跑 python3 --version。

注意事项¶

• 环境依赖：如果虚拟化未启用，WSL2 无法启动，命令会返回 HCS_E_SERVICE_NOT_AVAILABLE。这是环境问题，非插件 bug。
• 命令语义：wsl_run 使用 sh -lc 语义，不适用于交互式输入或 TUI 程序。
• 编码兼容：WSL 输出编码混合（UTF-8 中文错误 + UTF-16 正文），插件已做双重解码兜底。

该插件为 DSH 提供了与 WSL 交互的标准化入口。欲了解更多细节，请查看插件目录或 GitHub 仓库。