WODE25500/dsh-wsl

README 摘要

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 本地 patch 临时加载 然后问 agent："用 wsl status 查看 WSL 状态，wsl run 跑 python3 --version"。 工具 工具 行为 wsl run 在 WSL 跑 Linux 命令（ wsl -e sh -lc " " ） 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 正文），插件做了双重解码兜底 目录结构 许可 MIT。

分类