在终端或 TUI 环境中,手动切换上下文以打开文件或浏览器链接通常需要额外的操作。dsh-open-path 插件通过扩展 /open 命令,将文件系统访问和网络链接处理整合到 dsh-TUI 的操作流中,直接调用系统的默认程序。

dsh-open-path 是一个 dsh-TUI 生态插件,由 VviLliAm-qwq 维护。它解决了在 TUI 界面中直接访问文件系统和 HTTP(S) 网络资源的需求,支持 Windows、macOS、Linux(含 WSL)以及模糊搜索工作区内容。

核心功能

该插件提供以下操作能力:

  1. 打开工作目录:输入 /open 且不带参数时,直接打开当前会话的工作目录。
  2. HTTP(S) 链接:支持大小写不敏感的 HTTP(S) 链接,并直接调用默认浏览器打开。
  3. 裸域名处理:对于 github.com 这类裸域名,会自动补充 https:// 协议前缀。
  4. 文件与路径:支持相对路径、绝对路径,以及 ~(home)目录的展开。
  5. 模糊搜索:在当前工作区中进行模糊匹配;输入 /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,并根据需要检查源码。