在使用 DeepSeek Harness (DSH) 的 Web 界面时,如果同时打开多个工作区,它们的标题可能相同。这种情况下,仅凭标题难以区分具体是哪个目录。该插件通过在侧边栏的工作区标题下方显示完整的目录路径,解决了这一识别问题。
这是一个 DSH Web 侧边栏插件。它会在每个工作区标题下方插入并显示完整的目录路径,支持自动换行。插件由 code4lala 维护,采用 MIT 许可证。
安装与启用¶
安装插件:
dsh plugin --profile web add @code4lala/dsh-plugin-workspace-path
插件通过 dsh.bundle 声明自动注册。若要在已运行的 Web 服务中热加载,需编辑配置文件 ~/.dsh/profiles/web/cordis.patch.yml,添加以下内容:
- insert:
- id: workspace-path
name: '@code4lala/dsh-plugin-workspace-path'
核心功能¶
- 路径显示:在 Web 侧边栏每个工作区标题下方显示完整目录路径。
- 自动换行:路径过长时自动换行显示。
- 热加载:支持配置修改后的热加载,无需重启服务。
- 位置匹配:通过侧边栏顺序匹配工作区,防止同名工作区路径混淆。
- 实时同步:重命名或排序工作区时,路径显示实时更新。
工作原理¶
插件通过读取 workspaces 客户端服务获取路径信息,并注入 wkpath-subtitle 元素。为确保同名工作区不混淆,插件基于侧边栏的顺序(位置)进行匹配,而非仅依赖标题。通过 MutationObserver 和订阅机制保持显示与数据同步。
适用场景与注意¶
该插件适用于需要通过完整路径快速定位工作区目录的场景。使用前需确认 workspaces 客户端服务已启用。插件以当前 DSH 进程权限运行,建议在安装前检查源码。
该插件将目录路径信息直接呈现于侧边栏,降低了多工作区环境下的辨识成本。更多细节请查看 GitHub 仓库 或 SkillHub 插件目录。