Skip to content

dsh-plugin-git-worktrees

Verified

dsh-plugin-git-worktrees · v1.0.1 · MIT · Web UI

DSH plugin: lists every Git repository, linked worktree and submodule of the current workspace in a right-sidebar tab, with live status, inline diffs and workspace references.

Install

dsh plugin add dsh-plugin-git-worktrees

Confirm the layer applied with dsh --profile default --dump-config — see the install guide.

Source

Published to npm without a public repository. Inspect the package contents before installing.

Tags

Creators

Readme

dsh-plugin-git-worktrees

English · 简体中文

DeepSeek Harness(DSH)右侧栏插件:把当前工作区里的 Git 仓库、linked worktree、子模块 汇到一个面板里, 带实时状态、行内 / 浮窗 diff,以及「工作区引用」快照——一条 prompt 把多个仓库和分支交给 agent。

插件包名 dsh-plugin-git-worktrees,右栏标签类型 gitworktrees。 界面是中英双语的:文案跟随 DSH 的界面语言,而 DSH 默认按系统语言自动选择,所以在中文系统上是中文、英文系统上是英文; 插件列表里的名称与简介同样按语言取自 locale/zh.json、locale/en.json。


功能

  • 仓库 / Worktrees / 已隐藏 三个手风琴区块:仓库行带状态点、分支、领先落后、改动数;子模块以缩进层级挂在仓库下面。
  • 实时状态:监听每个 checkout 的目录变化,保存文件只刷新那一个仓库(约 40 ms 的一次 git status), 切分支 / 提交 / 增删 worktree 才整库重扫;另有 10 秒轮询兜底。
  • 查看改动:点行内箭头就地展开,点名称打开可拖动浮窗;支持全文件视图、行号、目录 / 列表切换、 上一个 / 下一个改动、全屏。
  • 语法高亮:自带轻量分词器,覆盖 JS/TS/JSX/JSON、CSS、HTML/Vue/Markdown、Python/Shell/YAML、 C/Go/Rust/Java、SQL。
  • 关注 / 隐藏:星标只关注几个仓库,眼睛按钮把仓库收进「已隐藏」,都按工作区持久化。
  • 引用到输入框:任何一行都能一键把 @相对路径/ 插进当前会话。
  • 工作区引用:勾选仓库 / worktree / 子模块、为每个 checkout 选分支(本地 + 远程,可搜索), 保存成一条引用;点一下就把「建新 worktree 或直接改当前仓」的 prompt 写进输入框。

安装

前置:DSH Desktop 或 dsh web(任何提供 Web GUI 的形态),Node.js ≥ 20。

从 npm 安装(推荐)

npm i -g dsh-plugin-git-worktrees

然后在 DSH 的插件管理里用包名安装这个 bundle:

plugin_manager install_bundle → dsh-plugin-git-worktrees

从本地目录安装

plugin_manager install_bundle → /绝对路径/到/plugins/git-worktrees

安装返回 application: applied 后刷新一次页面:右栏展开 → 引导页出现 Git 仓库与 Worktree 卡片, 点开就是面板。卸载用 plugin_manager remove_bundle dsh-plugin-git-worktrees。

使用

入口

  1. 会话右上角展开右栏。
  2. 右栏「开始」引导页里的 Git 仓库与 Worktree 卡片。
  3. 其他插件也可以 ctx.sidebarRight.openTab('gitworktrees') 打开它。

面板

  • 顶部两个 tab:仓库(主视图)与 工作区引用(快照)。
  • 仓库行:星标(关注)、隐藏、VS Code、@ 引用、复制路径;点最左箭头行内展开改动,点名称开浮窗。
  • Worktrees 区块按所属仓库分组,每个 linked worktree 一行,可复制路径、@ 引用、删除。
  • 子模块缩进挂在父仓库下面,各自的改动数、分支、同步状态徽标。
  • 底部是本次扫描耗时、是否命中缓存、是否触达上限。

变更窗口

  • 左侧文件列表默认目录树,可切「列表」;右侧是选中文件的全文件 diff,改动行带底色。
  • 工具条可在「全文件 / 补丁」之间切换,用 ‹ n/m › 在改动块之间跳转;打开文件时自动定位到第一个改动。
  • 标题栏可拖动、双击回正、全屏;内容只读,不提供暂存 / 提交 / 回滚。

工作区引用

  1. 「工作区引用」tab → 创建工作区引用,勾选仓库 / worktree / 子模块。

  2. 每个勾选项右侧选分支(可输入过滤,含本地与远程分支),再分别选择两个互不冲突的维度:

    • 工作位置:新 worktree 或 当前仓
    • 开发方式:新 MR(从选定分支拉新分支,完成后合并到新分支并面向它发起 MR)或 直接修改(就在选定分支上改)

    两者可以任意组合,例如「新 worktree + 新 MR」「新 worktree + 直接修改」「当前仓 + 新 MR」「当前仓 + 直接修改」。

  3. 填名字 → 保存引用;之后点这条引用即可把 prompt 插入输入框。

  4. 已保存的引用支持:一键把全部 checkout 切成某个工作位置或某种开发方式、编辑、重命名、删除。

生成的 prompt 形如:

以新 MR 方式开发:
- @repoA/ (基于分支 feature/x 新建分支;在新建 worktree 中)
- @repoB/ (基于分支 origin/main 新建分支;在当前 checkout 中)
请为以上 checkout 从指定分支新建分支,在新分支上完成修改并提交,完成后把改动合并到该新分支
并发起 MR;不要直接修改指定分支。「在新建 worktree 中」的项请新建 worktree 后在其中操作,
「在当前 checkout 中」的项请直接在对应 checkout 中操作。

直接在指定分支上开发:
- @repoC/ (分支 dev;在当前 checkout 中)
以上 checkout 直接在指定分支上修改并提交,不要新建分支。
  • 新 MR:从选定分支拉一个新分支,改动提交在这个新分支上,之后合并 / 发起 MR;不直接动选定分支。
  • 直接修改:就在选定分支上改并提交,不新建分支。
  • 新 worktree / 当前仓 与上面两项正交,决定改动落在哪份工作区。

Host 路由

全部路由都走 DSH 的浏览器鉴权栅栏(未登录 401,跨源 403)。

方法 路径 用途
GET /git-worktrees/repos 扫描工作区(root、refresh=1、status=0、depth)
GET /git-worktrees/changes 一个 checkout 的未提交改动
GET /git-worktrees/diff 一个文件的 unified diff
GET /git-worktrees/file 全文件视图的文件内容(2 MB 上限,二进制检测)
GET /git-worktrees/branches 一个 checkout 的本地 + 远程分支
GET /git-worktrees/events SSE:checkout(计数刷新)与 changed(结构变化)
POST /git-worktrees/remove 删除一个 linked worktree(唯一写操作)

安全边界:根路径必须属于已注册工作区;文件读取必须落在 checkout 内;删除只接受 linked worktree, 脏工作区需要显式 force,当前会话 cwd 在其中时拒绝。

数据与隐私

  • 关注、隐藏、工作区引用只写在浏览器 localStorage,按工作区根路径分键,不发送到任何第三方。
  • git 命令只在本地执行(GIT_OPTIONAL_LOCKS=0),不发网络请求;不修改分支、不提交、不暂存。
  • 唯一的磁盘写操作是删除用户明确确认的 linked worktree。

开发

node test/smoke.mjs   # 客户端注册、字典键对齐
node test/host.mjs    # 路由、扫描、删除、SSE、文件读取

许可

MIT