dsh-wsl-open

dsh-wsl-open

Install set: part of dsh-wsl-kit. Prefer KIT_SET=daily | llm | github | full (see kit README). Fault tree: TROUBLESHOOTING.md.

DeepSeek Harness plugin: click a WSL Linux path in chat to open it on Windows (default app, or Explorer for folders).

Part of dsh-wsl-kit.

中文说明 → README.zh.md

Where it sits

Opens a Linux path in Windows Explorer or the default Windows app.

flowchart LR
  agent["dsh chat"] --> open["dsh-wsl-open"] --> win["Explorer or default app"]

Suite diagram and version snapshot: dsh-wsl-kit. This plugin is 0.2.0 (daily; also in llm). Do not copy that matrix into this README.

---

Compatibility

Field	Value
Plugin	dsh-wsl-open 0.2.0
Minimum dsh	≥ 0.1.2 (web UI one-shot ?token= on Windows relay :3081)
Latest verified	See dsh-wsl-kit Compatibility (currently 0.1.5-rc.1) — single source of truth for the suite
Kit set	daily (also in github / full; fetch+net also in llm)
Cloud Flash	Use model id deepseek-flash (V4.1 Flash) in ~/.dsh/settings.yaml / llm-deepseek — not configured by this plugin
Agent Teams	Upstream experimental; not required here

Suite floor versions: kit check-plugin-versions.sh. Fault tree: TROUBLESHOOTING.md.

Why

Chat does not turn /home/.../deck.pptx into a useful link. Generic “open path” plugins often call Linux xdg-open, which cannot launch Windows Office / WPS.

What it does

1. Highlights absolute Linux paths in assistant text (CSS Highlight; does not rewrite React DOM)
2. Maps with wslpath -w (or a fallback) to \\wsl$\<distro>\... or C:\...
3. Files → cmd.exe /c start (Windows default app); folders → explorer.exe

Only opens real paths under home, the session workspace, and /mnt/c/Users (and /mnt/d/Users). Non-WSL hosts skip open.

Prefer this for files/folders. Use dsh-wsl-launch for apps, and dsh-wsl-browser for http(s) URLs.

Install

dsh plugin --profile web add github:173787247/dsh-wsl-open

Restart dsh web, refresh the page. Click a dotted-underline path in a new or re-rendered assistant message.

Verify

1. Ask the agent to write a file under /home/<you>/... (e.g. .pptx).
2. The absolute path should be dotted-underlined.
3. Click it — Windows opens with the default app.

Debug: browser console [dsh-wsl-open]; host log dsh-wsl-open: loaded distro=....

Config

- id: dsh-wsl-open
  name: dsh-wsl-open
  config:
    enabled: true

Key	Default	Meaning
enabled	true	Set false to disable

Test

npm test

License

MIT