HeathHe/dsh-worktree-panel

为 DeepSeek Harness Web 界面增加 Git worktree 维度的分支管理面板：在官方工作区/会话侧边栏上展示 项目 → 主工作树 / 分支 worktree → 会话，同时保留官方列表的原有交互。

---

使用

安装

dsh plugin --profile web add dsh-worktree-panel

安装完成后重启 dsh web，工作区侧边栏中将出现 worktree 层级。

安装指定版本：

dsh plugin --profile web add dsh-worktree-panel@0.1.6

升级

dsh plugin --profile web add dsh-worktree-panel@<版本>
# 然后重启 dsh web。

本地开发

dsh plugin --profile web add link:/到/dsh-worktree-panel/的绝对路径

---

功能

• 主工作树 + 分支 worktree — 在项目组中展示主工作树、当前分支、干净/有改动状态和各分支 worktree。
• 会话管理 — 在 worktree 中开启会话、删除 worktree，以及切换主工作树分支。
• 一键创建 — 为已有分支创建 worktree，或新建分支并同时创建 worktree。
• 非 Git 目录会话优先 — 项目行「＋」默认直接开启对话；「初始化 Git 并启用 Worktree」位于项目的更多操作菜单中。
• 落盘位置可配置 — 默认存放在 <项目>/.dsh/workspaces/，也可以改为自定义全局目录。
• 安全迁移 — 更改存放位置时检测并迁移已有 worktree，自动跳过存在未提交改动或活跃会话的目录。
• 渐进增强 — 非 Git 工作区保留默认会话流程，只额外提供可选的 Git/worktree 初始化入口。

---

兼容性

• 已适配并测试 DSH Desktop 2.0.3 / DeepSeek Harness 0.1.1-rc.2。
• DSH peerDependencies 范围：>=0.1.1-rc.2 <0.2.0。
• 通过 settings.section 注册独立的 Worktree 设置页。
• 兼容当前 Host 描述数据源和用户主目录路径缩写。

生成客户端 bundle

lib/client.js 由 lib/build.mjs 从官方 @deepseek-ai/dsh-client-ui-workspace 浏览器 bundle 生成。构建过程会验证官方包版本，并在生成文件头部记录来源版本。

构建还会根据客户端实际引用的模块，同步 package.json 中的 dsh.client.external，确保 DSH 在启动插件前加载依赖代码。inject 是服务注入声明，不能替代这份模块加载声明。

需要时可以显式指定官方 bundle：

DSH_WORKSPACE_BUNDLE=/到/client.js/的绝对路径 npm run build

---

许可证

MIT。lib/client.js 衍生自 @deepseek-ai/dsh-client-ui-workspace，详见 NOTICE 和 LICENSE。