dsh-wsl

WSL (Windows Subsystem for Linux) 的 DeepSeek Harness (dsh) 桥接插件 —— 让 dsh 智能体在 WSL 里运行 Linux 命令、管理发行版、转换 Windows↔WSL 路径、跨系统复制文件。

独立社区项目，非官方。基于微软 WSL（MIT）。

特性

• 5 个原生 dsh 工具：wsl_run / wsl_distro_list / wsl_status / wsl_path_convert / wsl_copy
• 自动处理 WSL 的 UTF-16LE 输出编码（WSL 管道输出是 UTF-16，插件统一转 UTF-8——这是最容易踩的坑）
• 发行版指定（distro 参数）、默认发行版配置
• wslpath 封装（路径转换可靠，不用手写 /mnt/c 映射）
• Schemastery 配置 + bundle patch 层
• 明确的错误处理（虚拟化未启用等 WSL 常见故障如实返回）

前置要求

• DeepSeek Harness（dsh）
• Windows 10 2004+ / Windows 11，WSL 已安装（wsl --version）
• WSL2 需启用"虚拟机平台"（wsl --install --no-distribution 可启用；未启用时命令会报错）

安装

作为 bundle 加入 profile

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

本地 patch 临时加载

pnpm dsh web --patch ./dsh-wsl/cordis.patch.yml

然后问 agent："用 wsl_status 查看 WSL 状态，wsl_run 跑 python3 --version"。

工具

工具	行为
wsl_run	在 WSL 跑 Linux 命令（wsl -e sh -lc "<cmd>"）
wsl_distro_list	列出发行版（状态/版本）
wsl_status	WSL 状态与警告
wsl_path_convert	Windows ↔ WSL 路径转换（wslpath -u/-w/-r）
wsl_copy	跨系统复制（WSL 侧 cp + wslpath）

配置项

键	默认	说明
wslPath	wsl	wsl.exe 路径
defaultDistro	—	默认发行版（多发行版时建议设置）
timeoutMs	120000	单次调用超时

已知限制

• 虚拟化未启用时 WSL2 无法启动，命令返回 HCS_E_SERVICE_NOT_AVAILABLE——这是环境问题，非插件 bug
• wsl_run 是 sh -lc 语义：交互输入、TUI 程序不适用
• WSL 输出编码混合（UTF-8 中文错误 + UTF-16 正文），插件做了双重解码兜底

目录结构

dsh-wsl/
  src/index.js            # 插件入口：5 个工具 + 编码处理 + 配置
  skills/wsl/SKILL.md     # agent 技能
  docs/                   # 文档
  cordis.patch.yml        # bundle patch 层

许可

MIT。