任务级 git worktree:per-repo manifest 持久保存;Worktree 模式在首条消息注入创建指引并统一 worktree/ 分支前缀,头部徽标替代工作区注册,支持带回主目录或强制删除收尾。
安装
# npm 包(预构建)
dsh plugin --profile web add dsh-task-worktree
# GitHub 源码(首次需按提示配置 allowBuilds 构建授权后重试)
dsh plugin --profile web add github:Letter2025/dsh-task-worktree
装任何插件都等于在你的机器上跑第三方代码,权限和你本人一样大——能读你的文件、用你的凭据、访问网络,工具审批管不到它。GitHub 来源的插件还会在安装时执行构建脚本——pnpm 默认拦截,所以安装可能停在 ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED 或 ERR_PNPM_IGNORED_BUILDS;dsh 会打印出需要添加的确切键名,把它加进该 profile 的 pnpm-workspace.yaml 的 allowBuilds 下,重跑一次即可装上。放行构建本身就是一次信任判断:请只安装可信来源,并尽量锁定 commit(github:owner/repo#sha)。
README
为 DeepSeek Harness 提供完整的 Git worktree 能力。
一个社区插件:给 DSH 带来 Qoder / Codex / Claude Code 同款的任务级 worktree 工作流。每个任务拥有一个独立的 git worktree checkout(独立分支),记录在 per-repo manifest 中,跨会话、跨重启永久保存。主工作区保持干净;使用 worktree 的对话会在会话头部显示分支徽标(不再注册工作区、不打乱侧边栏),干完后带回到主目录(Move to local)或直接提交在 worktree 分支上——一切收尾都由你(人)显式决定。
设计参考:Qoder 的 Worktree 执行环境、Codex 的 codex worktree create --permanent、Claude Code 的 --worktree 会话,并适配 DSH 的会话/工作区模型。
设计对照
| 本插件概念 | Qoder | Codex | Claude Code |
|---|---|---|---|
| 任务级隔离 checkout | Worktree 执行环境 | codex worktree create --permanent |
claude --worktree <名称> |
worktree 位于 <仓库>/.dsh-worktrees/ |
后台 worktree checkout | .codex/worktrees/ |
.claude/worktrees/ |
| 注册表跨重启持久 | 按会话 | 全局索引 | 会话绑定 |
| 每任务独立分支 | 分支选择器 | — | worktree-<名称> |
| 从 GUI 打开(注册为 DSH 工作区) | 面板选择器 | codex worktree open |
直接进入 worktree |
| 会话头部徽标标识对话所用 worktree | 会话标识 | — | — |
| 把改动带回主目录 | Move to local | — | 退出/清理询问 |
| 直接在 worktree 分支提交 | Review & commit 面板 | worktree 会话内提交 | worktree 内提交 |
| 携带主目录未提交改动 | Include uncommitted changes | — | .worktreeinclude |
| 自动忽略 worktree 目录 | — | — | .gitignore 建议 |
工作流
空白对话:输入框上方的模式选择器跟随「默认模式」设置(设置 → 插件 → 任务 Worktree),
也可以自己选「Worktree模式」(分支名可选,自动加 worktree/ 前缀)
│ 发送第一条消息 → 宿主注入一条「上下文注入」instructions 块
▼ 模型在同一轮调用 worktree_create
│ git worktree add -b worktree/<名称> <仓库>/.dsh-worktrees/worktree/worktree/<名称>
│ 不注册工作区、不切换对话;会话头部徽标标记该对话使用的 worktree
▼ 对话原地继续,模型在 checkout 路径(绝对路径)内干活;完成后模型提醒收尾
│
├─ /worktree bring-back worktree/<名称> → 合并分支回主分支(要求主目录干净)
├─ /worktree finish worktree/<名称> <消息> → 提交到 worktree 分支并保留
└─ /worktree remove worktree/<名称> --force → 删除 worktree 与分支
(--force 连未提交改动一起删)
- 以 Worktree 模式开始:空白对话、发送前,dock 选择器显示「分支名:」——选「Worktree模式」即武装会话;分支名可选(输入的会自动加
worktree/前缀,留空由模型拟定)。对话开始后选择器自动隐藏,由会话头部徽标接管指示。在设置 → 插件 → 任务 Worktree里把默认模式设为 Worktree,之后每个新对话都直接以该模式开始。 - 发送第一条消息 → 宿主在你消息前注入一条
instructions上下文块(界面显示为「上下文注入」):创建worktree/前缀分支、在 checkout 路径内干活、任务结束时给出可复制的收尾命令(bring-back或remove --force)。 - 或跳过模式,直接让 agent 隔离任务:"用 worktree 隔离干活,任务叫 xxx" —— 模型调用
worktree_create,name 同时作分支名与路径(支持斜杠)。 - 不注册任何工作区,侧边栏保持干净;worktree 模式下会话头部显示分支徽标。
- 干完后收尾:
bring-back/finish/remove(均仅人工可触发);/worktree list/status/prune查看与清理(prune顺带清理已消失 checkout 的工作区注册)。
安装
dsh plugin --profile web add dsh-task-worktree
要求:DeepSeek Harness 0.2.2-rc.1+(已在 0.2.2-rc.3 验证)、Git 2.31+、Node 20+。
设置
插件声明易变(volatile)Config,DeepSeek Harness 以本插件的 profile 条目 id
dsh-task-worktree 为命名空间提供设置表单。卡片位于侧边栏插件 → dsh-task-worktree
页面(插件包配置区);设置服务自动生成的页面已关闭,同一组字段只保留一个入口。
只有一项设置——新对话的默认模式——三个选项(本来就只有这三种状态;拆成「模式 + 记住上次选择」开关会多出一个毫无意义的组合):
| 面板选项 | 存储在 dsh-task-worktree |
含义 |
|---|---|---|
| 本地模式 | defaultMode: local、rememberLastChoice: false |
每个新对话都直接在主工作区开始。 |
| Worktree模式 | defaultMode: worktree、rememberLastChoice: false |
每个新对话都隔离:宿主在第一条真人消息到达时自动注入创建指引,不必再动手选。 |
| 记住上次选择 | rememberLastChoice: true |
以你在输入框上方最后选定的模式为准,defaultMode 保存该选择。 |
默认是本地模式。从未打开过这张卡片的安装,行为与本设置存在之前完全一致:新对话从主工作区开始,输入框上方的选择只作用于当前对话。
所选模式只作用于「从空白开始」的对话。在输入框上方选本地模式即是对该对话的明确表态:无论设置是什么,宿主都不会为它自动武装。
设置值就在本插件的 profile patch 条目里,也可以直接手改并即时生效:
- id: dsh-task-worktree
config:
defaultMode: worktree
rememberLastChoice: false
宿主没有设置服务时,插件继续用组合默认值(本地模式)工作,卡片不会出现。
模型工具
| 工具 | 作用 |
|---|---|
worktree_create {name, baseCommit?, includeUncommitted?} |
创建任务 worktree(name=分支名与相对路径,支持斜杠分层);可选把主工作区未提交改动带进去 |
worktree_list |
列出当前仓库所有受管理 worktree(状态 / dirty / 分支) |
worktree_status {name?} |
查看单个 worktree 或当前会话所在 worktree 的状态 |
收尾与清理动作(finish / bring-back / remove)只有人工可触发,模型永远够不到。
人工命令
/worktree mode-on [<名称>] 武装 worktree 模式(下条消息随之注入指引)
/worktree mode-off 关闭 worktree 模式
/worktree create <名称> [<base>] [--carry]
/worktree list
/worktree status [<名称>]
/worktree finish <名称> <消息>
/worktree bring-back <名称> [<消息>]
/worktree remove <名称> [--force]
/worktree prune
安全模型
@deepseek-ai/*只作为 peerDependencies——由宿主提供;插件绝不向 profile 安装基础设施副本(双实例会破坏TOOL_RUNTIME_SCHEDULER的 unique symbol,导致工具全部失效)。bring-back要求主工作区干净(MAIN_DIRTY),且拒绝在 worktree 内执行。remove拒绝删除当前会话所在的 worktree(IN_USE)。- 所有 git 操作经
ctx.subprocess(harness-managed);测试路径用 child_process runner。 - Manifest 原子写入(tmp + rename);
prune清理 checkout 已不存在的记录。
本地开发
npm test # 冒烟(worktree 全生命周期)+ 宿主半 + 浏览器偏好
npm run typecheck # 客户端 TypeScript 类型检查
npm run build:client # 重新构建 client/client.js(tsdown + lightningcss)
npm pack --dry-run # 发布前检查包内容
三个测试:test/smoke.mjs(临时仓库上的 git 全生命周期)、
test/host.mjs(在假 cordis 上下文里跑真实 apply():设置配置与页面策略、武装策略、注入)、
test/prefs.mjs(浏览器偏好 store;需 Node 22.6+,更低版本自动跳过)。
License
MIT — see LICENSE
链接
同类插件
zhu1090093659/dsh-web#packages/dsh-git-graph★ 10461
输入框上方提供 Git 分支选择器,并把分支泳道与提交历史画成图谱,沿着时间线找到任意变更。作者已将其退役并改用官方 workspace-changes 插件;已发布的 npm 包仍可安装,但不再开发。
Akimiya-z/codex-guard#dsh★ 132
在 DeepSeek Harness 内做提交前的 Pull Request 卫生检查:扫描当前改动中的 TODO 残留、硬编码密钥与非规范提交信息。
xbzbing/dsh-git-panel★ 53
DSH Web GUI 里的 IDE 风格 Git 面板:常驻标签页含三栏总览(分支/标签列表、可搜索的提交历史图、含变更文件树与提交信息的提交详情)与变更记录页(统计条、带逐文件暂存/取消/丢弃的未提交列表、含 amend 的提交框);并排差异带懒加载 highlight.js 语法高亮、块间上下文按需展开与词级行内高亮,图片文件以变更前/后双图对照;另在输入框提供 zsh 风格分支标记。所有 git 命令以 argv 数组经宿主 subprocess 执行、cwd 锁定仓库根。
Cerbur/clutch-dsh#clutch-dsh-worktree★ 46
为 DSH Web UI 增加按 Git Worktree 组织 Session 的视角,同时继续由 DSH 管理原始 Project 和 Session 数据。
Lenonss/DSH_VsCodeMode★ 33
为 DeepSeek Harness 提供类 VSCode 编码体验:基于 Monaco 的中央文件编辑器(文件页签、Ctrl+P 快速打开、状态栏),并对 Agent 的 edit/write 结果进行交互式差异审查(逐处采纳/拒绝、回滚、归档),状态跨重启持久化。
DamonKoy/dsh-web-ui#dsh-git-graph★ 32
dsh web GUI 会话头部栏的 Git 分支选择器与提交图。
社区评论
评论公开保存在 GitHub Discussions。加载评论会连接 GitHub 和 Giscus;发表内容需要 GitHub 账号。