插件目录 / Automation / dsh-wsl-bridge
dsh-wsl-bridge
已验证 · 实测可装 ch1bug
功能简介
WSL代理的Windows访问工具集
可用 — 实测通过,早期项目
WSL代理的Windows访问工具集 实测能干净安装、正常启动。早期项目,但功能可用。
「已验证」表示我们的自动化 CI 在干净 profile 里实际执行了 dsh plugin add 并启动成功——仅此而已。功能描述与版本兼容性均为作者声明。这不是安全审计,也不代表对第三方代码的背书。
README
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-inbash 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 perdsh.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.exereachable — standard on WSL1/WSL2) - DSH host with the
shellandsandboxPolicyservices
License
MIT
安装
装一次目录插件,之后本站所有插件都能让 DeepSeek Harness 自动找、自动装:
dsh plugin add dshbase-catalog 然后对 agent 说「帮我装 dsh-wsl-bridge」,它会在目录里找到并自动安装。文档:dshbase-catalog · 已验证场景包。
该插件是 GitHub 源码(未发 npm)——直接从仓库装:
Web profile:
dsh plugin --profile web add github:ch1bug/dsh-wsl-bridge Headless(CLI)profile:
dsh plugin --profile headless add github:ch1bug/dsh-wsl-bridge 实测报告
验证通过:从 GitHub 源码完成 L1 安装 + L2 加载 + L3 运行(dsh 0.1.0-rc.6)。
使用场景
自动化一项重复工作——调度、串联任务或响应事件——不用你亲手启动。
适合谁
有周期性工作、想 cron 式无人值守而非手动触发的人。
二次开发建议
触发器和任务模板是缝——加事件驱动或文件监听触发,以及更丰富的流程编排。