Git 工作树面板：左侧标题与说明，右侧主干与分支的拓扑示意
在一个侧栏里读完 Git 的分支、工作树和改动。
只读查看：不 checkout、不切目录、不提交。
面板
面板三层结构：顶部当前工作树信息条，中部分支拓扑，底部节点详情与工作树、改动、文件列表
- 顶部 · 当前工作树：路径、分支（detached 时显示
detached @ <sha>）、↑ahead ↓behind、clean / dirty / conflict，以及 本地分支 · 远程分支 · Worktree 计数。
- 中部 · 分支拓扑：主干永远是一条直线，分支向右生长，合并收回主干；点一条线高亮整条路径。
- 底部 · 详情与列表：点提交 / 分支 / 工作树看详情；其余工作树、CHANGES、FILES 都在这里，文件行可直接点开预览。
安装（DSH）
从插件市场（推荐）
打开 插件 → 实验性插件 → 更多 → 自定义插件市场，添加索引源：
https://leonz666.github.io/dsh-gitworktree-gui/market/index.json
然后在 发现 里搜索「Git 工作树面板」点安装。
从 npm 安装
插件已发布到 npm：dsh-gitworktree-gui。终端里用 DSH CLI 装进指定 profile（需要本机有 dsh 与 pnpm，命令会把参数转发给 profile 目录里的 pnpm，从 npm 解析包）：
npm view dsh-gitworktree-gui version # 查看最新版本，可选
dsh plugin --profile <profile> add dsh-gitworktree-gui
dsh plugin --profile <profile> add dsh-gitworktree-gui@<版本> # 固定版本
桌面端 profile 由 Electron 管理，请用下面的插件页 / plugin_manager；CLI 的插件管理请求不作用于它。
在 DSH 里直接安装
在插件页或 plugin_manager 工具里：
plugin_manager action=install_bundle target=dsh-gitworktree-gui
target 也可以是下面几种形式：
git+https://github.com/LeonZ666/dsh-gitworktree-gui.git — 直接装当前 main（不要用 github: 简写，匿名用户会走 SSH）/绝对路径/dsh-gitworktree-gui-<版本>.tgz — 离线包，仓库根执行 npm pack 得到/绝对路径/dsh-gitworktree-gui — 本地源码，link: 安装，改代码即时生效
engines.dsh 要求 >=0.2.1-rc.2，不满足时安装会被拒绝并回滚。装好后刷新 Web 页面；改过宿主入口 index.js / lib/ 需要重开 DSH。
更新与卸载
用新 spec 再执行一次 install_bundle；同名包已安装时先卸载再装。
plugin_manager action=set_bundle target=dsh-gitworktree-gui enabled=false
plugin_manager action=remove_bundle target=dsh-gitworktree-gui
使用
- 点会话头部右上角的 Git 图标，面板作为右栏标签打开。
- 默认读取当前会话目录；顶部条始终显示正在查看的 worktree 的路径、分支与状态。
- 在 WORKTREES 里点其他工作树，只切换「看哪棵树」，不执行 checkout，也不改变聊天的工作目录；「返回会话工作区」回到默认目录。
- 点提交看完整消息、改动文件和 diff；点分支线段选路径；点工作树看 HEAD、上游和 dirty 文件数。
- CHANGES / FILES 里的文件行点开，会在侧边栏新开一个 tab 显示文件内容；关闭 Git 面板标签页即停止轮询。
- 目录还没
git init 时，面板会给出提示；初始化后点「已初始化，重新读取」。插件不会替你初始化或修改仓库。
提交详情：完整提交消息、改动文件列表与单文件 diff
点开提交：完整消息、改动文件与单文件 diff 在同一栏展开。
只读与边界
只读：不提交、不切分支、不合并、不删除工作树、不初始化仓库。Git 用固定参数的 execFile，不拼 shell；DSH 路由只接受 loopback，显式路径受 allowedRoots 限制。采集上限为 120 个提交 / 700 个文件（提交详情 300 个文件，单文件 diff 128 KiB / 1200 行），读取失败会保留旧快照并标记过期，而不是显示成干净。
License
MIT · 开发：npm ci && npm run verify · 发布见 RELEASING.md
在 Codex 和 Claude 上也能安装，适配入口见 codex/ 与 hooks/。
