dsh-env-switcher
English · 简体中文
A DeepSeek Harness plugin that lets you switch between a Windows DSH instance
and a WSL2 (Linux) DSH instance from the web UI — both running at the same
time (coexistence model).
v1.2.0 — the sidebar switcher moved to the main column (between the
quick entries and the Workspace block) and now hides when the sidebar is
collapsed.
How it works
| Environment | URL | Port |
|---|
| Windows DSH | http://127.0.0.1:3080 | 3080 |
| WSL DSH | http://127.0.0.1:3081 | 3081 |
- Both servers run simultaneously; nothing is ever killed.
- The web UI gets an 「环境」 tab (above the conversation) and a
「运行环境」 entry in the sidebar main column (
| Windows | WSL |),
placed above the Workspace block (i.e. between the quick entries and
Workspace).
- Collapse-aware: when the sidebar is collapsed, the「运行环境」entry is
hidden; it reappears when the sidebar is expanded.
- Clicking a target ensures that environment's server is running, then the
current tab navigates to its URL.
- Each environment keeps its own session history.
Host API
GET /env/api/state → { env, ownUrl, peerUrl }GET /env/api/switch?target=windows|wsl → ensures the target server is up
(no kill, no browser opening — the client navigates itself)
Install
dsh plugin --profile web add dsh-env-switcher
For a local checkout:
dsh plugin --profile web add file:/path/to/dsh-env-switcher
Restart the server, then hard-refresh the browser.
Configuration
All values are optional; defaults match a typical Windows + WSL2 machine:
# cordis.patch.yml
- insert:
- id: dsh-env-switcher
name: dsh-env-switcher
config:
winPort: 3080 # Windows DSH port
wslPort: 3081 # WSL DSH port
wslDistro: Ubuntu-24.04
wslNodeBin: /home/fsc/node-v24.17.0-linux-x64/bin
wslLog: /home/fsc/dsh-web.log
winLog: D:\deepseek-harness\logs\dsh-web-win.log
winWorkingDir: C:\Users\61468
Requirements
- Windows with WSL2 and a Linux distro (e.g. Ubuntu 24.04)
- A DSH installation in both environments (Windows + inside WSL)
- The WSL instance is started with
dsh web --port 3081 (the plugin does this
automatically when needed)
Changelog
See CHANGELOG.md.
