在终端或 TUI 环境中,手动切换上下文以打开文件或浏览器链接通常需要额外的操作。dsh-open-path 插件通过扩展 /open 命令,将文件系统访问和网络链接处理整合到 dsh-TUI 的操作流中,直接调用系统的默认程序。
dsh-open-path 是一个 dsh-TUI 生态插件,由 VviLliAm-qwq 维护。它解决了在 TUI 界面中直接访问文件系统和 HTTP(S) 网络资源的需求,支持 Windows、macOS、Linux(含 WSL)以及模糊搜索工作区内容。
核心功能¶
该插件提供以下操作能力:
- 打开工作目录:输入
/open且不带参数时,直接打开当前会话的工作目录。 - HTTP(S) 链接:支持大小写不敏感的 HTTP(S) 链接,并直接调用默认浏览器打开。
- 裸域名处理:对于
github.com这类裸域名,会自动补充https://协议前缀。 - 文件与路径:支持相对路径、绝对路径,以及
~(home)目录的展开。 - 模糊搜索:在当前工作区中进行模糊匹配;输入
/open readme即可快速定位文件或文件夹。
安装与启用¶
通过插件管理器安装该插件:
dsh plugin --profile dsh-tui add dsh-open-path
安装完成后,需要在 TUI 界面中运行 /restart,或重新打开窗口,插件才会生效。
典型用法¶
/open # 打开当前工作目录
/open https://example.com # 打开网页
/open src/index.ts # 打开文件
/open readme # 模糊搜索工作区
/open ~/docs # 打开 home 目录
配置与注意¶
- 依赖环境:要求
@deepseek-harness-tui/dsh-tui的版本不低于0.10.0-beta.5。 - 日志记录:操作日志会写入
~/.dsh-tui/dsh-open-path.log。 - 配置项:
maxCandidates默认为 0,表示不限制模糊搜索的候选数量。 - 语言支持:提示文本和错误信息会跟随 dsh-TUI 的语言设置(
DSH_TUI_LANG),支持中文、英文或系统本地化语言。 - 许可证:MIT。
该插件遵循 MIT 许可证。在使用前,请确保已安装满足版本要求的 dsh-TUI,并根据需要检查源码。