ch1bug/dsh-wsl-bridge

wsl-bridge

DSH（DeepSeek Harness）Cordis 插件，让运行在 WSL（Windows Subsystem for Linux，适用于 Linux 的 Windows 子系统）内的 agent 能够访问并调用 Windows 侧的文件和程序。

专为身处 WSL 但需要访问 Windows 主机的 agent 打造：读写 C:\ 上的文件、运行 .exe 程序、在资源管理器中打开内容、列出驱动器、转换路径。

工具

| 工具 | 用途 |
|---|---|
| win_ls | 列出 Windows 目录（接受 C:\... 或 /mnt/c/...） |
| win_read | 读取 Windows 文本文件（utf8/gbk，行偏移/行数限制） |
| win_write | 将 UTF-8 文本写入 Windows 文件（自动创建父目录） |
| win_run | 运行 Windows 程序（cmd / powershell / direct 互操作） |
| win_open | 用 Windows 默认处理程序打开文件/文件夹 |
| win_path | 在 C:\... 和 /mnt/c/... 之间转换（wslpath） |
| win_drives | 列出已挂载的 Windows 驱动器 |

可选（当安装了 codebase-memory-mcp 时）：
codebase_search、codebase_arch —— 知识图谱代码搜索。

工作原理

一切都通过宿主 shell 服务运行（与内置 bash 工具使用的是同一接缝），并在每次调用时应用调用会话的沙箱策略。路径规范化同时处理 C:\Users\me 和 /mnt/c/Users/me 两种形式。
win_run 会将临时 .bat/.ps1 文件写入 C:\Windows\Temp，并在完成后自行清理；PowerShell 输出被强制为 UTF-8 控制台编码。

安装（DSH bundle）

标准 DSH bundle —— 使用官方插件命令安装（会自动初始化 profile、执行 pnpm 安装，并根据
dsh.bundle.patch 追加 bundle 层）：

dsh plugin --profile web add /path/to/dsh-wsl-bridge
或：dsh plugin --profile web add github:you/dsh-wsl-bridge
重启 dsh web；工具会自动挂载。

依赖声明为 peerDependencies（生态惯例 ——
@deepseek-ai/dsh-tools 已在 DSH 进程中加载）。应用时可设置的可选环境变量：CODEBASE_MEMORY_BIN 用于 codebase-memory 工具
（默认 /usr/local/bin/codebase-memory-mcp；若不存在则这些工具会报错）。

要求

- 启用了 Windows 互操作的 WSL（cmd.exe、powershell.exe、wslpath、
explorer.exe 可访问 —— 在 WSL1/WSL2 上均为标准配置）
- 带有 shell 和 sandboxPolicy 服务的 DSH 宿主

许可证

MIT