前言¶
在 DeepSeek Harness (DSH) 的开发工作流中，经常需要在侧边栏同时打开多个文件。当需要查看某个文件在本地磁盘的具体位置（例如复制路径、检查文件树结构）时，往往需要右键点击或打开新窗口，操作不够直接。dsh-sidebar-enhancement-folder 插件通过向编辑器标签页注入按钮，解决了这一痛点。
插件介绍¶
这是一个为 dsh-better-sidebar 设计的增强插件。它会在每个打开的文件编辑器标签页的工具栏中插入一个「打开所在文件夹」按钮。点击按钮，系统资源管理器会打开该文件所在的目录，并自动选中该文件。
该插件由用户 mastereal 维护，目前处于纯自用阶段，未经过大规模测试。
核心功能¶
-
按钮内嵌
按钮位于标签页自身的工具栏行内。对于 Markdown/HTML 文件，按钮出现在「预览」与「编辑」按钮旁边；对于 PDF、图片或二进制文件，按钮出现在标题栏。按钮始终跟随该标签页。 -
标签页独立性
每个标签页拥有独立的按钮，不依赖哪个窗格处于激活状态。即使切换到非活动标签页，按钮依然存在且可用。 -
布局兼容
按钮是宿主 DOM 结构的一部分，因此它支持窗口布局的任何变化，包括拖拽、拆分窗格以及调整宽度。 -
Windows 定位可靠
插件使用explorer.exe /select命令打开文件。代码中处理了windowsVerbatimArguments和引号，能够可靠处理包含空格或中文字符的文件名。 -
自愈机制
插件内置了清理逻辑，能够识别并移除重复或残留的按钮，保持工具栏整洁。 -
路径解析
插件运行在宿主侧（浏览器端），负责剥离file://前缀，并将相对路径按会话工作目录进行解析。
安装与启用¶
使用官方安装命令从 GitHub Release 下载安装：
dsh plugin --profile web add https://github.com/mastereal/dsh-sidebar-enhancement-folder/archive/refs/tags/v1.0.7.tar.gz
安装完成后，需要执行以下步骤以确保生效：
- 重启
dsh web服务。 - 在浏览器中硬刷新页面（Windows/Linux:
Ctrl + Shift + R）。 - 关闭所有旧的 DSH 窗口和标签页。
注意：旧实例可能会残留旧代码，导致按钮重复，必须彻底关闭旧窗口。
使用方法¶
- 在 DSH 的侧边栏中打开任意文件。
- 在对应的编辑器标签页工具栏中，会看到一个文件夹图标（带放大镜）的按钮。
- 点击该按钮，系统资源管理器将弹出并定位到该文件所在的文件夹，同时选中该文件。
注意事项¶
- 系统限制：目前仅支持 Windows 系统。
- 依赖版本：需要 dsh-better-sidebar v0.14+。该插件通过操作 DOM 注入按钮，如果 better-sidebar 升级导致 DOM 结构变化，插件可能会失效。
- 风险提示：作者未经过大规模测试，安装与使用有风险，请自行评估。
- 旧实例残留：如遇按钮错位或重复，请务必执行上述安装步骤中的「关闭旧窗口」操作。
结尾¶
该插件通过极小的体积和直接的操作逻辑，优化了在 DSH Web 环境下管理文件路径的体验。如果你主要在 Windows 环境下工作，且对 better-sidebar 的 DOM 结构有一定了解，这是一个值得尝试的实用工具。
- 插件目录: dsh-sidebar-enhancement-folder
- 源代码: GitHub
