dsh-branch-worktree

DSH PLUGIN开发与运行时

仓库 elfgzp/dsh-branch-worktree · npm dsh-branch-worktree

开发与运行时 L5 · 运行验证通过 安全审查:低风险 可信度:金 可安装插件
安装这个插件

这款 DSH plugin 在新会话界面加入 Git 分支选择器,可新建分支并自动创建 worktree,让对话在独立检出中开始,不打扰主工作区未提交的改动。

一句话选型结论

按资料字段整理

dsh-branch-worktree 是开发与运行时类的 DSH 可安装插件,验证等级 L5 · 运行验证通过,安全审查为低风险,列出 5 项功能,有可直接复制的安装命令。验证通过不等于安全:插件会读写文件、执行命令或联网,装前先到仓库确认它做了什么;涉及密钥或系统权限的,建议先在隔离环境试装。

分类开发与运行时 收录类型可安装插件 验证等级L5 · 运行验证通过 安全审查低风险
验证等级 L5 L5 · 运行验证通过
GitHub 星标 1 复刻 0 · 未关闭 issue 0
最近更新 2026-11-11 创建于 2026-10-30
README 15.8 KB 正文体量,越大说明说明书写得越细

安装

可安装插件
在 DSH 里执行,装完用 dsh plugin list 确认已挂上;标了 L4 / L5 的命令已在沙盒里真实跑通
dsh plugin --profile web add github:elfgzp/dsh-branch-worktree
  1. 1
    确认版本与运行环境

    兼容的 DSH 版本为 0.2.2-rc.1 等 3 个;版本不匹配时安装会报错。

  2. 2
    执行安装命令

    在 DSH 里执行上面的命令;多包仓库要注意区分具体子包名,别装错包。

  3. 3
    确认已挂载

    用 dsh plugin list 查看列表里是否出现这个插件,出现即挂载成功。

  4. 4
    试跑并检查权限

    加载后跑一个最小用例,确认它能正常工作;同时看它申请了哪些文件、命令或网络权限。

兼容 DSH 版本0.2.2-rc.1 等 3 个版本版本不匹配时安装会报错
Node.js 要求未标注来自仓库 package.json 的 engines 字段
前置依赖无需要同时安装的同级依赖
npm 包名dsh-branch-worktree可用 npm view 查看包信息

能做什么

5 项功能
字段来自项目仓库与公开索引,中文说明由本站标注

dsh-branch-worktree:为 DeepSeek Harness 新建会话加上分支与 worktree 选择

  • 新会话界面选择或新建分支
  • 自动创建独立 Git worktree
  • 支持原地切换分支模式
  • 脏工作区时拒绝切换
  • 草稿随会话迁移

适用场景

GitHub 集成

上游标签

cordisdeepseek-harnessdshdsh-plugingitgit-worktreeplugin

验证等级与安全审查

L5 · 运行验证通过
自动化流程结论,不是人工审核
验证等级L5 · 运行验证通过在 dsh 沙盒中完成安装与运行冒烟——装得上、跑得起来
安全审查低风险静态分析结论,未标注不代表已通过审查
仓库健康度活跃按仓库活跃度与最近更新时间给出
可信度金综合仓库活跃度与验证结果

上面的结论来自上游最近一次自动化验证(2026-11-12): 同一套检查会在插件发新版后重跑,页面显示的是最新一次的逐项结果。

逐项检查结果

L1 · 已找到 ✓ 通过
  • L1.0_DEFAULTED_FROM_L3 由 L3 推定 默认通过——L3 安装规范已通过(全库 L3 扫描策略)
L2 · 结构化 ✓ 通过
  • L2.0_DEFAULTED_FROM_L3 由 L3 推定 默认通过——L3 安装规范已通过(全库 L3 扫描策略)
L3 · 安装规范 ✓ 通过
  • L3.1_INSTALL_COMMAND_PARSED 安装命令已解析 方式:安装规范解析
  • L3.2_DSH_VERSION_DECLARED DSH 版本已声明 方式:DSH 版本声明
L4 · 安装已测 ✓ 通过
  • L4.1_INSTALL_EXECUTED_CONFINED 受限沙盒内执行安装 方式:沙盒安装执行
  • L4.2_INSTALL_SUCCESS 沙盒安装成功 方式:沙盒安装执行
  • L4.3_ARTIFACT_CONFIRMED 安装产物已确认 方式:沙盒安装执行
L5 · 运行已测 ✓ 通过
  • L5.1_INSTALL_PASSED_SANDBOXED 沙盒安装通过 方式:沙盒安装执行
  • L5.2_WEB_BOOT_READY Web 启动就绪 方式:Web 启动
  • L5.3_HTTP_SERVED HTTP 服务响应 方式:HTTP 请求
  • L5.4_PLUGIN_INVENTORY_ACTIVE 插件清单中已激活 方式:插件清单查询

风险详情

  • 结论说明 静态扫描 低;动态审计无结论(以下以静态为准)→ 总评级 低。
  • 风险计数 严重 0 / 高 0

选择建议

装之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 验证等级 L5:安装和运行都在沙盒里跑通过,装完能直接用的概率高。
  • 静态安全审查为低风险,没有发现明显可疑行为。
  • 有可直接复制的安装命令,不用自己翻文档找入口。
  • 标注了兼容的 DSH 版本(0.2.2-rc.1 等 3 个),按版本装不容易报错。
  • 列出了 5 项功能,能直接看出它解决什么问题。

先想清楚的地方

  • 没有声明 Node.js 版本要求,版本不匹配可能装不上。
  • 验证通过不等于安全:插件会读写文件、执行命令或联网,装前先到仓库确认它做了什么。

更适合

  • 需要在开发与运行时场景里给 DSH 补能力的人。
  • 想装完就能用、不想自己排依赖的人。
  • 能接受在本地装依赖、愿意自己确认权限的人。

不太适合

  • 只使用 DSH 官方内置能力、不接受第三方插件的人。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
插件验证等级安全审查星标兼容版本安装命令
dsh-branch-worktree当前 L5 · 运行验证通过 低风险 1 0.2.2-rc.1 等 3 个 有
deepseek-harness L3 · 安装规范通过 低风险 24.6 万 未标注 无
rea L4 · 沙盒安装通过 低风险 2.6 万 0.1.1-rc.2 有
dsh-TUI L4 · 沙盒安装通过 中风险 4,292 0.1.7-rc.2 等 5 个 有
mirage L3 · 安装规范通过 低风险 3,681 未标注 无
dashi-taskboard L4 · 沙盒安装通过 低风险 3,311 0.1.1-rc.2 有

仓库档案

开发与运行时
字段来自项目仓库与公开索引,中文说明由本站标注
作者 / 维护方elfgzp仓库 dsh-branch-worktree · 默认分支 main
分类开发与运行时dev
收录类型可安装插件声明了 dsh.bundle、可用 dsh plugin add 安装的条目
开发语言JavaScript仓库主语言
许可证MIT商用或二次分发前请确认条款原文
星标 / 复刻 / issue1 / 0 / 0收录时的数值,非实时
创建 / 更新2026-10-30 · 2026-11-11最后推送 2026-11-11
本站收录2026-10-30首次进入本站目录的时间

README 全文

15.8 KB
作者原文,中文版优先;只做安全转义,不改内容

dsh-branch-worktree

English | 简体中文

一个 DeepSeek Harness(DSH)Web UI 插件,在新会话界面增加分支选择 + 自动创建 Git worktree。

选项目、选模式之后,再多选一个分支(或直接输入新分支名),DSH 会为它建一份独立检出,会话直接在那个目录里开始——你当前工作区里改到一半的文件完全不受影响。

为什么需要它

新会话界面本来可以选工作区和Agent 模式,但会话永远从工作区目录、以「当前检出的那个分支」开始。于是并行开多个 Agent 任务,就得反复切分支、stash 改动,或者每次开新会话前手动建 worktree。

这个插件补上这一格:

控件 来源
工作区 / 项目 DSH 内置
Agent 模式(如创造模式) DSH 内置
分支,或新分支 + 基于哪个分支 本插件
自动创建 worktree 本插件

功能

  • 位置在「项目」和「创造模式」之间 — 新会话行从左到右就是:项目 → 分支 → 模式,正好是决定「在哪、做什么、怎么做」的顺序。
  • 点开是下拉面板,不弹模态框,不打断输入区。
  • 可选已有分支,也可直接输入新分支名 — 新分支从你指定的 base 分支拉出(默认取仓库自身的默认分支);分支已存在时则复用,不会重复创建。
  • 两种模式可切换:
  • 自动创建 worktree(默认)— 在 <仓库>/.worktrees/<分支> 下 git worktree add,把该目录注册成 DSH 工作区并在其中开会话。当前检出完全不动,未提交的改动原样保留。
  • 原地切换 — 在当前检出里 git checkout 该分支。工作区有未提交改动时会直接拒绝,绝不会覆盖你的改动。
  • 已在别处检出的分支只显示不提供选择 — 在选择器里标记为「已在别处检出」并置灰,因为 Git 不允许同一分支被检出两次。
  • worktree 池不污染 git status — 首次运行会把 .worktrees/ 追加进 .git/info/exclude。
  • 未发送的草稿会带过去 — 已经输入的提示词会跟着进入新会话。
  • 不是 Git 仓库时 chip 直接不显示,而不是弹一个什么也做不了的对话框;切回 Git 仓库的工作区时会自动恢复显示。(非 Git 目录返回的是精简的 isRepo: false 响应,客户端把它当作「隐藏 chip」,绝不当作一个可渲染的仓库。)

生成的目录结构:

my-repo/
├── .git/
├── .worktrees/
│   ├── feature-login/      ← 分支 feature/login
│   └── fix-crash/          ← 分支 fix/crash
└── ... 你的主检出,保持原样

安装

需要 DSH >= 0.2.0,以及 PATH 里有 git。

方式一:Web 界面(推荐)

  1. 侧边栏 → 插件 → 添加插件 → 安装第三方插件(支持 npm 包、Git 仓库和本地目录)。
  2. 填入 Git 仓库地址:
https://github.com/elfgzp/dsh-branch-worktree
  1. 确认安装后,在「已安装插件」里打开 分支与 Worktree 开关;如果界面没有立刻生效,重启 DSH。

方式二:让 Agent 帮你装

在开启了插件管理工具的 DSH 会话里(创造模式默认开启),直接说:

> 从 https://github.com/elfgzp/dsh-branch-worktree 安装这个插件并启用

Agent 会调用 plugin_manager 的 install_bundle,自动写入依赖、把 bundle 追加到 dsh.profile.bundles 并激活。

方式三:本地开发

git clone https://github.com/elfgzp/dsh-branch-worktree
cd dsh-branch-worktree

然后用 插件 → 添加插件 → 安装第三方插件 选择这个本地目录的绝对路径。profile 会把它记成 link: 依赖,之后改代码只需重启(浏览器半区只需刷新页面)。

> 不要手改 profile 的 package.json 或 cordis.patch.yml。这两个文件归插件管理器所有,直接改会让 bundle 列表和实际状态脱节。

使用

  1. 点 新建会话。
  2. 照常选工作区,然后点中间的分支 chip。
  3. 直接点 从这里开始 就行——默认已经开了 自动命名 + 创建 worktree,分支名和 worktree 名都由插件生成。
  4. 想自己指定名字时,关掉 自动命名,然后在「分支」里选已有分支,或在「新建分支」里输入新名字(此时会多出「基于」选择器)。
  5. 点 从这里开始(或在输入框里按 Enter)。

会话在生成的目录里打开,侧边栏会以分支名出现一个新工作区分组。

自动命名

这是默认行为:打开面板什么都不用填,直接开始。

  • 生成的分支名统一放在 wt/ 命名空间下,一眼能和你自己起的分支区分开。
  • 名字是随机但可读的:一个形容词 + 一个名词 + 一个短码,例如 wt/brave-otter-7f3a。
  • 名字不取自你的聊天内容。 worktree 名是一个长期存在的 Git ref,会比当时输入框里那句话活得久:用它命名等于把提示词原文漏进分支名、git log,以及分支被推送到的任何地方;而且两件互不相干的事只要恰好写了同一句话就会撞名。草稿依然会跟着你进新会话,只是不参与命名。
  • 撞名会自动重试,同时检查已有分支和 .worktrees/ 下的目录名,包括那些把斜杠拍平之后才撞上的情况(wt/a-b 和 wt/a/b 都会映射到 wt-a-b)。
  • 生成前会实时预览面板里的「将创建」一栏,显示最终分支名和磁盘路径——自动不等于黑盒,看清楚再点开始。
  • 生成什么就创建什么:预览显示的名字会被原样传给 Host 执行,不会出现「预览一个、实际建另一个」。

关掉 自动命名 就回到手动模式,规则和以前完全一致。

把正在进行的对话搬到新 worktree

新会话页的那个 chip 只在你还没开始对话时存在。对话已经在跑之后,还有第二个入口:窗口最底部的一条状态栏会显示当前工作目录,并且当这个目录是 Git 仓库、且还不是 worktree 时,右侧会出现 新建 worktree 按钮。

点一下就新建 wt/… worktree、把它注册成工作区、并在里面开会话,于是文件树、Git 面板、变更列表全都指向新目录。同时会自动给模型发一条提示:把未提交的改动搬过来,之后交给团队成员/子智能体的任务都要指向新路径。

为什么要建工作区,而不是只改会话目录? DSH 在会话创建时就把 cwd 冻在 header 里,而所有右侧面板都以这个 header 为根——只改 agent 的工作目录,整个右侧仍然显示旧路径。只有「工作区路径 = 这个检出」这一种形态,UI 才会真的跟着走。

当前目录一旦已经在 .worktrees/ 下,这条横条会自动隐藏。

勾选 worktree 之后到底做了什么

这是最容易被误解的一步:勾选 worktree 不等于一定新建分支。实际规则是:

你输入的分支名 执行的动作
自动命名(默认) 生成一个不存在的 wt/... 分支,git worktree add -b 新建并检出到新 worktree
不存在 git worktree add -b <分支> <路径> — 新建分支并检出到新 worktree
已存在 git worktree add <路径> <分支> — 复用已有分支,不新建
已在别的 worktree 检出 直接报错,因为 Git 不允许同一分支被检出两次
就在主工作区检出 直接报错,不会把主工作区当成 worktree 交回给你

最后一行是重点:过去选当前分支并开着 worktree 开关时,插件会把主检出目录直接返回(reusedWorktree: true),开关看起来生效、实际完全没隔离。现在这种组合会明确报错,让你换分支——开关说要做隔离,就真的做隔离。

所以:起个新名字就是开新分支,选个已有分支就是复用;绝不会悄悄给你造一个同名分支,也不会悄悄跳过 worktree。下拉面板里也会实时提示当前会走哪条路径。

磁盘上发生了什么

在 /work/my-repo 里对分支 feature/login 走 worktree 模式:

# 1. 建池目录并加入排除
mkdir -p /work/my-repo/.worktrees
echo '.worktrees/' >> /work/my-repo/.git/info/exclude

# 2. 新分支从指定 base 拉出,或复用已有分支
git worktree add -b feature/login /work/my-repo/.worktrees/feature-login

# 3. DSH 把 /work/my-repo/.worktrees/feature-login 注册成工作区

本插件不会删除任何东西。要回收一个 worktree:

git worktree remove .worktrees/feature-login
git branch -d feature/login

清理已完成的 worktree

设置 → 清理 worktree 会列出当前工作区所属仓库里的所有 worktree,并把已经完成的那部分提供删除。

只有同时满足以下条件才算可清理,而且 Host 在真正删除的那一刻会重新校验一遍(所以页面开着一小时也不会误删这段时间里新产生的工作):

  • 不是主工作区;
  • 检出的是分支(不是游离头);
  • 该分支已经合入主干(提交已在 main/master 里);
  • 检出目录干净(没有未提交、未跟踪的文件)。

其余的一律列在 不可清理 里并说明原因,目录保持原样。删除会移除 worktree 目录,并用 git branch -d 一并删掉分支。

一个必须说清楚的局限:这里只读本地 Git。它无法知道该分支是否走过合并请求、以及那个请求是否勾选了「删除源分支」——它只知道提交已经在主干里。本地直接合并的分支和走 MR 合并的分支会被同等对待。

可能遇到的报错

提示 含义
这个工作区不在 Git 仓库内。 所选工作区没有 .git;正常情况下提前探知的话 chip 不会显示。
分支名只能包含字母、数字和 . _ / -。 输入的分支名不是合法 Git ref。
该分支已经在另一个 worktree 中检出。 Git 不允许同一分支检出两次。换一个分支,或新建分支。
该分支就在主工作区里检出。 主检出不等于 worktree,无法隔离。换一个分支,或打开自动命名。
同名的 worktree 目录已存在。 .worktrees/<分支> 位置有残留目录挡着,用 git worktree prune 或手动清掉。
当前工作区有未提交改动。 你在工作区不干净时关掉了 worktree 开关。重新打开开关,或先提交/stash。
Git 拒绝了这个操作。 其它 Git 失败,具体 Git 报错会显示在对话框里。

实现原理

┌──────────────────────── 浏览器(client.js)────────────────────────┐
│  conversation.hero.options 槽的占位组件                            │
│    button  ──► Modal:分支选择 / 新建分支 / worktree 开关           │
│                        │                                            │
│                        │  POST /branch-worktree/create               │
└────────────────────────┼────────────────────────────────────────────┘
▼
┌──────────────────────── Host(index.js)───────────────────────────┐
│  connection.requestRejection()  ← 信任栅栏,先于一切                │
│  /branch-worktree/inspect  → 仓库、分支、现有 worktree、脏状态       │
│  /branch-worktree/suggest  → 自动模式下将被创建的 branch 与路径      │
│  /branch-worktree/create   → git worktree add | git checkout        │
│                            → workspaceRegistry.create(path)         │
└─────────────────────────────────────────────────────────────────────┘
│
▼   浏览器侧调用 uiWorkspace.startSession(id)
会话以 header.cwd = 新检出目录 创建

两个关键点:

  • 会话必须在 worktree 里「创建」,而不是「移动」进去。 DSH 会话的 header.cwd 是冻结的创建元信息:系统提示里的 cwd、shell 工具的默认工作目录、沙箱的 workspaceRoot 全都由它派生。所以插件把 worktree 注册成工作区、在其中新开一个空白会话,而不是去改已有会话。
  • 所有 Git 操作都在 Host 侧,且只通过 execFile 传字面量 argv,分支名不经过 shell 拼接。每条路由第一步都先过连接信任栅栏,别的源的页面无法驱动你机器上的 Git。

注册位置

半区 位置
Host webServer exact 路由 /branch-worktree/inspect、/branch-worktree/suggest、/branch-worktree/create
Client conversation.hero.options(list 槽),id branch-worktree,order -10

关于「插到项目和模式中间」:DSH 在新会话行里没有提供这两个 chip 之间的插槽——conversation.hero.workspace 和 conversation.hero.agentPreset 都是 display: contents 的包装层,而唯一给额外控件用的 conversation.hero.options 是整行右对齐的。插件因此注入一小段受限 CSS:把该容器设为 display: contents,用 order 把本插件排在两个内置 chip 之间。选择器用 :has() 限定在仅新会话行,不影响会话视图,也没有挪动其它插件的节点;如果将来 DSH 在该位置提供了正式插槽,这段 CSS 会自动失去意义。

只依赖内置的 @deepseek-ai/dsh-client-ui-conversation,用到的都是公开服务:webServer、connection、workspaceRegistry、slots、locale、uiWorkspace。

兼容性

DSH 状态
0.2.1-rc.3 已实测
>= 0.2.0 预期可用

插件内置 en 和 zh 两套文案,跟随 DSH 的语言设置。

卸载

插件 → 分支与 Worktree → 移除。插件创建的 worktree 和分支会留在磁盘上,按上面 git worktree remove 的命令清理即可。

同类插件调研

动手前先找过现成的。目前存在的这些:

仓库 Star 为什么不够用
frederico-kluser/dsh-worktree-jump 2 只做 worktree 跳转,没有会话创建时的分支选择
Letter2025/dsh-task-worktree 2 只做任务隔离,没有和项目/模式整合的控件
YS-BW/dsh-plugins 1 杂项插件集合
zhang-guo-wen/dsh-worktree 0 功能不完整
epik7th/dsh-task-worktree 0 功能不完整
d0nj/dsh-plugins 0 杂项插件集合

没有一个把「项目 + Agent 模式 + 分支 + 自动 worktree」组合进新会话行,所以这个插件只做这件事。

另外,DSH 本身已有一个非 GUI 的 worktree 能力——@deepseek-ai/dsh-experimental-worktree 及其 create_worktree 模型工具——但它在所有出厂 profile 里都是默认关闭的,且由模型驱动而非新会话流程的一部分。本插件与它互补,不冲突。

许可证

MIT

常见问题

8 问
答案由本站依据条目字段整理,不引用上游原文
dsh-branch-worktree 怎么安装?

在 DSH 里执行 `dsh plugin --profile web add github:elfgzp/dsh-branch-worktree` 即可。对应的 npm 包名是 `dsh-branch-worktree`。

dsh-branch-worktree 的验证等级是什么意思?

L5 · 运行验证通过。在 dsh 沙盒中完成安装与运行冒烟——装得上、跑得起来

dsh-branch-worktree 安全吗?

低风险。静态扫描 低;动态审计无结论(以下以静态为准)→ 总评级 低。

dsh-branch-worktree 装之前要先确认什么?

先看它会读写哪些文件、执行哪些命令、连接哪些网络地址;验证等级只说明装得上、跑得起来,不等于安全。涉及密钥或系统权限的,建议先在隔离环境试装。

dsh-branch-worktree 支持哪些 DSH 版本?

上游记录的兼容版本包括 0.2.2-rc.1、0.2.1-rc.5、0.2.1-rc.3。

dsh-branch-worktree 用的是什么许可证?

上游标注为 MIT。商用或二次分发前请到仓库确认许可证原文。

dsh-branch-worktree 有哪些功能?

新会话界面选择或新建分支、自动创建独立 Git worktree、支持原地切换分支模式、脏工作区时拒绝切换、草稿随会话迁移。

这条记录的数据可靠吗?

本站按仓库名去重后合并整理,字段以作者仓库与 npm 元数据为准;安装命令、仓库地址与 README 保持原文,带 L4 / L5 标记的安装命令已在隔离沙盒里真实跑通。

同名或近似条目

1 条
不同作者的仓库分开列,请确认你要装的是哪一个
开发与运行时
按星标排序,可作替代方案

rea

rea

L4 · 沙盒安装通过 2.6 万 星

dsh-TUI

dsh-TUI

Claude Code 风格全屏终端 UI:像素鲸鱼顶栏、实时工作状态行、思考流式展开。

L4 · 沙盒安装通过 4,292 星

mirage

mirage

把文件系统与 bash 提供者换成 mirage 虚拟工作区:文件工具与 shell 命令作用于挂载的资源(RAM、S3、Redis、Sla

L3 · 安装规范通过 3,681 星

dashi-taskboard

dashi-taskboard

把当前已安装并运行中的 Codex Taskboard 嵌入 DeepSeek Harness 侧边栏,并通过 Launcher 运行时描述

L4 · 沙盒安装通过 3,311 星

elfgzp 的其它插件

6 个

插件的元信息来自作者仓库;分类、验证等级与安全结论的中文说明为中文整理,最近核验 2026-11-12。