dsh-reveal-explorer

前置要求

• dsh >= 0.1.1-rc.2
• pnpm 可用（dsh plugin 底层转发给 pnpm）

安装

最省事的办法是用插件市场：打开「发现」，搜 explorer，点「安装」。

命令行：

dsh plugin --profile <name> add @easytz/dsh-reveal-explorer

<name> 是必填的 profile 名，不能省略——桌面版通常是 web，TUI 是 tui；不确定就看 $DSH_HOME/profiles/ 下的目录名。想钉死版本就写 @easytz/dsh-reveal-explorer@0.2.4。

插件自带 dsh.bundle 层（cordis.patch.yml），dsh plugin add 会同时完成「装进去」和「注册激活」，不需要手写 patch。

装完重启 dsh，会话头部的工具区出现「在资源管理器中打开」按钮。

用法

点会话头部工具区的在资源管理器中打开按钮，就用系统自带的文件管理器打开当前会话的工作区目录：

• Windows → 资源管理器（explorer.exe）
• macOS → 访达（open）
• Linux → 默认文件管理器（xdg-open）

打开的是当前会话绑定的那个工作区——切到别的会话再点，开的就是那个会话的目录。目录在注册之后被移动或删除时，按钮会明确提示目录不存在，而不是假装打开成功。

卸载

dsh plugin --profile <name> remove @easytz/dsh-reveal-explorer

<name> 与安装时一致。remove 会把包从 profile 依赖里移除，dsh 随后会把它从激活清单（dsh.profile.bundles）里撤掉。重启 dsh 后按钮消失。

如果你按旧版 README 手动往 $DSH_HOME/profiles/<name>/cordis.patch.yml 或 $DSH_HOME/cordis.patch.yml 里加过 - insert: 条目，卸载时把那段 YAML 一起删掉。

已知限制

• 工作区目录在注册之后被移动 / 删除时，插件会在调用前检测并提示目录不存在，而不是对着错误弹「已打开」。
• Windows 上 explorer.exe 有「窗口确实打开了却返回非零退出码」的怪癖，插件对此做了容错（只有进程起不来才算失败）。

平台支持

已在 Windows（explorer.exe）与 macOS（open）上验证；Linux 使用标准 xdg-open 路径。

A third-party plugin for DeepSeek Harness (dsh): adds a button to the session header that opens the current workspace directory in your system file manager.

Requirements

• dsh >= 0.1.1-rc.2
• pnpm available (dsh plugin shells out to pnpm)

Install

Easiest path is the plugin market: open Discover, search explorer, hit Install.

From the command line:

dsh plugin --profile <name> add @easytz/dsh-reveal-explorer

<name> is required — your dsh profile (usually web for the desktop/web UI, tui for the TUI). The package ships its own dsh.bundle layer, so dsh plugin add both installs and activates it.

Restart dsh — an "open in file manager" button appears in the session header toolbar.

Usage

Click the button to open the current session's workspace directory: Explorer on Windows, Finder on macOS (open), your default file manager on Linux (xdg-open). Switch sessions and the button follows — it always opens the directory bound to the session you're looking at. If that directory has been moved or deleted, you get a clear "directory does not exist" message rather than a fake success.

Uninstall

dsh plugin --profile <name> remove @easytz/dsh-reveal-explorer

Limitations

• If the workspace directory is moved or deleted after registration, the plugin detects it up front and says so.
• On Windows explorer.exe can return a non-zero exit code even when the window did open; the plugin tolerates that (only a failure to spawn counts as an error).
• Verified on Windows and macOS; Linux uses the standard xdg-open path.