@lim324/dsh-worktree-panel

源自 HeathHe/dsh-worktree-panel，scoped 为 @lim324。

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

---

使用

安装

优先：从 npm 安装（推荐）

dsh plugin --profile web add @lim324/dsh-worktree-panel
# 指定安装版本
dsh plugin --profile web add @lim324/dsh-worktree-panel@<版本>

装完重启 dsh web，工作区侧边栏即出现 worktree 维度。

升级

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

GitHub 源码安装（需要先 build）

本项目是 patch 式构建：lib/client.js 由 lib/build.mjs 在官方 @deepseek-ai/dsh-client-ui-workspace bundle 上打补丁生成，因此从源码安装前必须先 build。

git clone https://github.com/Limsanity/dsh-worktree-panel.git
cd dsh-worktree-panel
npm run build     # 生成 lib/client.js（需要本机已装 DSH，用于定位官方 ui-workspace bundle）
dsh plugin --profile web add link:/绝对路径/到/dsh-worktree-panel

源码开发

用 link: 方式安装后，改动 lib/build.mjs 的 patch 点，或重新 npm run build，才会反映到 lib/。

---

功能

• 主工作树 + 分支 worktree — 项目组内展示主工作树（当前分支 + 干净/有改动状态）与各分支 worktree
• 会话管理 — 在 worktree 内开新会话、删除 worktree、切换主工作树分支
• 一键创建 — 底部「＋ 分支 → 创建 worktree」为未建 worktree 的分支一键创建（可选新建分支）
• 落盘位置可配置 — 默认项目内 .dsh/workspaces/，或改为全局目录；更改时自动检测并批量迁移已有 worktree（跳过有未提交改动 / 活跃会话的）
• 零侵入 — 非 git 工作区保持官方原样，不显示任何 worktree UI

---

AI 工具

插件向 DSH 智能体（agent）注册两个可直接调用的工具，让它能在一次对话里自动创建 / 清理「独立分支上的新会话」，无需你手动建 worktree、再开新会话、再重述任务。

worktree_task

{ "repo": "项目名", "task": "在该 worktree 新会话中要完成的任务",
  "branch": "可选，英文连字符命名", "kind": "可选，fix | feature", "base": "可选，基于的分支" }

• 为 repo 创建分支 + git worktree，把该目录注册为工作区，并在其下新建一个 DSH 会话、注入 task 让其开始工作（后台运行，用默认模型/预设）。
• 分支名自动生成英文小写、连字符（kebab）命名：修复类 fix/<name>，功能类 feature/<name>（如「修复登录页偶发崩溃」→ fix/login-page-crash）。传了 branch 则优先沿用。

worktree_remove

{ "repo": "项目名", "branch": "要删除的分支名", "force": "可选，是否强制" }

• 删除该分支的 git worktree（git worktree remove + prune）并注销其工作区；该目录有运行中会话且未传 force 会被拒绝。

---

Slash 命令

在 Web 输入框直接敲，避免重复输入「创建 worktree」。

输入	输入框变成	效果
/wtfix + 空格	创建 worktree 修复：	接着输入问题 → agent 调 worktree_task → fix/<kebab> 分支 + 新会话
/wtfeat + 空格	创建 worktree 实现：	接着输入功能 → agent 调 worktree_task → feature/<kebab> 分支 + 新会话

也可以输入 / 从候选菜单里选 wtfix / wtfeat，或直接 /wtfix <任务> 回车（前缀会自动替换成 创建 worktree 修复：）。

---

许可

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