ch1bug/dsh-wsl-bridge

Name: ch1bug/dsh-wsl-bridge
Author: ch1bug

插件Plugin 原生Native ⭐ 2 MIT

WSL 代理的 Windows 访问工具：win_ls/win_read/win_write/win_run/win_open/win_path/win_drives，作为 DeepSeek Harness 捆绑包提供。

项目介绍Project Overview

由知微Agent(zhiwei)编辑Edited by Zhiwei Agent (zhiwei)

wsl-bridge 是 DSH Cordis 插件，让运行在 WSL 内的代理访问 Windows 侧文件与程序。提供 win_ls、win_read、win_write、win_run、win_open、win_path、win_drives 等工具，支持读写 C 盘文件、运行 exe、资源管理器打开、路径转换与盘符列举；安装 codebase-memory-mcp 后还可做代码图谱搜索。适用于代理在 WSL 中却需操作 Windows 主机的场景。注意：需启用 WSL 互操作，且每次调用受会话沙箱策略约束。

wsl-bridge is a DSH Cordis plugin that lets an agent running inside WSL access Windows-side files and programs. It provides tools to list and read/write Windows files, run .exe programs via cmd or PowerShell, open items in Explorer, convert between C:\ and /mnt/c paths, and list drives; optional codebase-memory tools add code-graph search. Use it when an agent in WSL must operate on the Windows host. It requires WSL interop enabled and each call is subject to the session sandbox policy.

在 GitHub 查看View on GitHub

发给你的 DSH 安装Send to your DSH

请帮我了解并安装插件：【dsh-wsl-bridge】【https://github.com/ch1bug/dsh-wsl-bridge】

把上面这条消息直接发给当前会话里的 DSH，让它帮你了解并安装。安装命令不一定准确，发给 DSH 更稳。Send this message to DSH in your current session. CLI install commands may not be accurate across systems — DSH will figure it out for you.

或使用命令行安装（适合开发者）Or use CLI install (for developers)

命令行安装CLI Install

dsh plugin --profile web add github:ch1bug/dsh-wsl-bridge

把 ch1bug/dsh-wsl-bridge 加入你的 DSH 配置（web profile）即可启用。

READMEREADME

2.2 KB · 缓存于 2026-08-27 05:42:08 · 2.2 KB

wsl-bridge

DSH (DeepSeek Harness) Cordis plugin that lets an agent running inside WSL (Windows Subsystem for Linux) access and invoke Windows-side files and programs.

Built for agents that live in WSL but need the Windows host: read/write files on C:\, run .exe programs, open things in Explorer, list drives, convert paths.

Tools

Tool	Purpose
`win_ls`	List a Windows directory (accepts `C:\...` or `/mnt/c/...`)
`win_read`	Read a Windows text file (utf8/gbk, line offset/limit)
`win_write`	Write UTF-8 text to a Windows file (creates parent dirs)
`win_run`	Run a Windows program (`cmd` / `powershell` / `direct` interop)
`win_open`	Open a file/folder with the default Windows handler
`win_path`	Convert between `C:\...` and `/mnt/c/...` (wslpath)
`win_drives`	List mounted Windows drives

Optional (when codebase-memory-mcp is installed): codebase_search, codebase_arch — knowledge-graph code search.

How it works

Everything runs through the host shell service (the same seam the built-in bash tool uses) with the calling session's sandbox policy applied per call. Path normalization handles both C:\Users\me and /mnt/c/Users/me forms. win_run writes temp .bat/.ps1 files to C:\Windows\Temp and cleans up after itself; PowerShell output is forced to UTF-8 console encoding.

Install (DSH bundle)

Standard DSH bundle — install with the official plugin command (auto-inits the profile, pnpm-installs, and appends the bundle layer per dsh.bundle.patch):

dsh plugin --profile web add /path/to/dsh-wsl-bridge
# or: dsh plugin --profile web add github:you/dsh-wsl-bridge
# Restart dsh web; the tools mount automatically.

Dependencies are declared as peerDependencies (ecosystem convention — @deepseek-ai/dsh-tools is already loaded in the DSH process). Optional env vars at apply time: CODEBASE_MEMORY_BIN for the codebase-memory tools (default /usr/local/bin/codebase-memory-mcp; they error if absent).

Requirements

WSL with Windows interop enabled (cmd.exe, powershell.exe, wslpath, explorer.exe reachable — standard on WSL1/WSL2)
DSH host with the shell and sandboxPolicy services

License

MIT

渲染基于仓库 ch1bug/dsh-wsl-bridge 的 README.md。在 GitHub 查看原文 →

命令行安装CLI Install 复制安装命令Copy Install