@xbzbing/dsh-git-panel
DeepSeek Harness (dsh) 插件：Web GUI 中的 IDE 风格 Git 面板——分支/历史概览、支持提交和修订提交的未提交更改、差异统计，以及输入栏中的 zsh 风格分支标记。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add @xbzbing/dsh-git-panel@0.2.0
Git Panel 以 @xbzbing/dsh-git-panel 发布，当前版本为 0.2.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
English | 简体中文
dsh-git-panel 是一个 DSH Web GUI 插件，在对话工作区里提供 IDE 风格的 Git 面板。它把分支列表、提交历史图、未提交变更的提交与 amend、语法高亮的差异对照集中到一个常驻标签页，并在输入框左侧放一个 zsh 风格的分支标记，让你在对话过程中随手查看仓库状态、提交改动，不必切到终端或另开 IDE。
面板只读取当前会话工作目录所在的 Git 仓库，所有 git 命令都以 argv 数组经宿主的 subprocess 服务执行，不拼接 shell 字符串，工作目录锁定在仓库根，并带超时与输出上限。插件不改动 git 配置，写操作（提交、amend、暂存、丢弃）都有明确入口。
# npm（默认）
dsh plugin --profile web add @xbzbing/dsh-git-panel@latest
# 或从 GitHub 仓库安装（仓库已提交构建产物，无需本地构建）
dsh plugin --profile web add github:xbzbing/dsh-git-panel
安装后重启或刷新 Web GUI，工作区标签栏（「对话」「轨迹」之后）就会出现 Git 面板。
<仓库名> (<分支>) 标记，仓库名青色，(分支) 在已同步时为绿色、有未提交变更时为橙色；悬停显示完整仓库路径，点击跳转面板（有未提交变更进入变更记录，否则进入 Git 总览）；当前目录不是 Git 仓库时只显示目录名，不报错。| Git 总览 | 文件差异 modal |
|---|---|
| Git 总览：分支、提交历史图、提交详情与 hover 卡片 | 文件差异 modal：语法高亮的 side-by-side 对照、块间按需展开与词级高亮 |
| 变更记录 | |
| 变更记录：统计条、未提交变更列表、提交框与差异对照 |
插件分 host / client 两半，通过 typert Remote 网关通信。
lib/host/）：gitPanel 命名空间上的 Cordis + typert GitPanelService，暴露 snapshot / run / query / version 四个端点，仅做端点委托与生命周期接线；git 命令经宿主 subprocess 服务执行（argv 数组、无 shell、cwd 锁仓库根、超时 + 输出上限）。lib/client.js）：一个 React 包，注册 conversation.view 面板和 conversation.input.left 标记。每会话一个快照控制器（轮询 + turn 完成后刷新 + 连接重置重拉），标记、变更记录页和统计条共用同一份快照，避免重复 git 命令。node build.mjs # tsc（host d.ts）+ esbuild（host bundle + client bundle + testkit）
npm run typecheck # 类型检查
npm run test:unit # 纯算法与 host 端点单测（node --test）
npm run test:e2e # 隔离的 file:// 无头浏览器 e2e（不碰任何运行中的实例）
npm test # 单测 + e2e
host bundle 不做压缩：typert 网关靠方法参数名做参数校验，压缩会改名并破坏 wire 契约。client 改动没有热重载，需重新构建并刷新页面。lib/ 作为构建产物随 git 提交入库，改动 src/ 后必须重新构建并提交，否则从 GitHub 安装会加载到过期入口；测试期生成的 lib/testkit.mjs 不入库。本地联调：把插件加入 dsh web profile 的 dsh.profile.bundles，用 file: 依赖指向本目录，构建后即生效。
src/
host/
types.ts wire 数据模型的唯一权威源（client 直接复用）
index.ts GitPanelService：端点委托与生命周期接线
git.ts subprocess → 带超时的 GitRunner
core.ts workspace 解析 + snapshotForSession
actions.ts GitAction → git 命令序列（commit / amend / stage 等）
queries.ts history / diff / image-diff / show / branches / tags / worktree-stats
parser.ts git 输出解析为结构化数据
version.ts 本包版本 + GitHub release 更新检查
client/
rpc.ts gitPanel 端点的 client 面
controller.ts 每会话快照控制器
Panel.tsx 主面板壳：子 tab 路由 + 版本条
OverviewTab.tsx Git 总览三栏 + hover 卡片
ChangesTab.tsx 变更记录页
DiffView.tsx 并排差异视图
GitPill.tsx 输入框标记
highlight.ts diff 语法高亮的懒加载门面
git-graph.ts 提交图车道布局
file-tree.ts 路径折树
diff.ts unified diff → 并排行 + 统计
本项目采用 MIT License。