@taontech/dsh-git —— DeepSeek Harness 的 Git tab 插件

在 DSH 的会话界面（chat / Trajectory 之后）新增一个 Git tab，展示当前 项目路径的 Git 信息：仓库概况、文件修改状态、提交历史、分支与提交图、 贡献日历（最近一年每日提交热力图），以及暂存/提交/推送/拉取/切换分支等 操作；非 Git 目录则显示文件列表并支持一键 git init。此外还内置「快速打开」 栏：在 macOS 上于宿主机终端（Terminal / iTerm）中打开仓库，或启动交互式 代理 app（OpenCode / Claude / Codex / Antigravity）。

git 命令执行全部委托给 gmc （gmc/lib/git.js 的 runGit），本插件只做解析、组合与展示。

架构（一个包，双面）

@taontech/dsh-git (npm 包)
├── cordis.patch.yml    # bundle patch：插入 server 插件行（id: dsh-git）
├── lib/index.js        # server 插件：注册 webServer 路由 /dsh-git/*（JSON API）
├── lib/git-data.js     # 数据层：gmc 封装 + status/log/branch/init/贡献日历 解析
├── lib/launch.js       # macOS 终端 / iTerm + 代理 app 启动器（移植自 gmc web.js）
└── lib/client.js       # client bundle：注册 conversation.view 的 Git tab
                        #   （含贡献日历 + 快速打开按钮；手写 ModuleLoader 格式）

面	机制	职责
Server（bundle）	dsh.bundle.patch + inject: ["webServer"]	`/dsh-git/info
Client	dsh.client 声明 + ./client 入口	1. ctx.slots.inject("conversation.view") 注册 id: "git" 完整管理标签页 2. ctx.slots.inject("conversation.input.dock") 注册空白会话首页 Hero 概况卡片（分支、热力图、快捷启动、一键跳转完整管理页）

安装（装进某个 profile）

本地开发（link:）：

dsh plugin --profile <name> add /path/to/this/package

发布后（registry）：

dsh plugin --profile <name> add @taontech/dsh-git
dsh --profile <name> --dump-config   # 确认 dsh-git 行与 bundles 生效

两种方式 pnpm 都会自动安装 gmc 依赖。web profile 的 client-modules 会自动 扫描 dsh.client 声明，把 lib/client.js 注入浏览器 boot graph —— 装完 重启该 profile 的 GUI 即可看到 Git tab。

API（同源 JSON，浏览器直接 fetch）

端点	说明
GET /dsh-git/info?cwd=	仓库概况：root / branch / remote / ahead-behind / lastCommit / isDirty
GET /dsh-git/status?cwd=	文件 + 修改标记（porcelain）；非 repo 时返回 fs 文件列表
GET /dsh-git/log?cwd=	提交历史（hash / 作者 / 日期 / subject）
GET /dsh-git/branches?cwd=	分支列表 + git log --graph ASCII 提交图
GET /dsh-git/contributions?cwd=	贡献日历：最近一年每日提交次数（date -> count）
POST /dsh-git/init {cwd}	git init（非 repo 目录的初始化按钮）
POST /dsh-git/open-terminal {cwd}	在宿主机 Terminal / iTerm 中打开仓库（仅 macOS + 回环地址）
POST /dsh-git/open-agent {cwd, agent}	在终端启动交互式代理（codex / claude / antigravity / opencode，仅 macOS + 回环地址）
POST /dsh-git/stage {cwd, paths}	暂存文件（路径必须来自当前 status，防止任意参数）
POST /dsh-git/unstage {cwd, paths}	取消暂存（只允许已暂存文件）
POST /dsh-git/commit {cwd, message}	提交已暂存内容（消息非空校验）
POST /dsh-git/push {cwd}	git push
POST /dsh-git/pull {cwd}	git pull
POST /dsh-git/checkout {cwd, branch}	git switch（分支必须存在于分支列表）

验证

node test/verify-server.mjs   # 数据层单测（repo / 非 repo / init / git 操作场景，31 项）

常见问题

• 路径显示为 /private/var/...：macOS 上 /var 是 /private/var 的符号 链接，git 返回真实路径，属正常现象。
• 看不到 tab：确认装进了 web profile 且重启了 GUI；--dump-config 里应 有 dsh-git 行。