dsh-plugin-git-worktrees
Verifieddsh-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。
使用
入口
- 会话右上角展开右栏。
- 右栏「开始」引导页里的 Git 仓库与 Worktree 卡片。
- 其他插件也可以
ctx.sidebarRight.openTab('gitworktrees')打开它。
面板
- 顶部两个 tab:仓库(主视图)与 工作区引用(快照)。
- 仓库行:星标(关注)、隐藏、VS Code、@ 引用、复制路径;点最左箭头行内展开改动,点名称开浮窗。
- Worktrees 区块按所属仓库分组,每个 linked worktree 一行,可复制路径、@ 引用、删除。
- 子模块缩进挂在父仓库下面,各自的改动数、分支、同步状态徽标。
- 底部是本次扫描耗时、是否命中缓存、是否触达上限。
变更窗口
- 左侧文件列表默认目录树,可切「列表」;右侧是选中文件的全文件 diff,改动行带底色。
- 工具条可在「全文件 / 补丁」之间切换,用
‹ n/m ›在改动块之间跳转;打开文件时自动定位到第一个改动。 - 标题栏可拖动、双击回正、全屏;内容只读,不提供暂存 / 提交 / 回滚。
工作区引用
「工作区引用」tab → 创建工作区引用,勾选仓库 / worktree / 子模块。
每个勾选项右侧选分支(可输入过滤,含本地与远程分支),再分别选择两个互不冲突的维度:
- 工作位置:
新 worktree或当前仓 - 开发方式:
新 MR(从选定分支拉新分支,完成后合并到新分支并面向它发起 MR)或直接修改(就在选定分支上改)
两者可以任意组合,例如「新 worktree + 新 MR」「新 worktree + 直接修改」「当前仓 + 新 MR」「当前仓 + 直接修改」。
- 工作位置:
填名字 → 保存引用;之后点这条引用即可把 prompt 插入输入框。
已保存的引用支持:一键把全部 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