dsh-reveal-explorer
会话头部一个按钮,用系统文件管理器打开当前工作区目录。
One button in the session header to open the current workspace in your system file manager.
DeepSeek Harness(下称 dsh)的第三方插件。聊到一半想去看看文件、拖个东西进去、或者在编辑器里打开某个文件时,不用再去翻路径手动 cd。
中文
前置要求
- 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 路径。
English
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.
许可证 / License
MIT