@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|status|log|branches|contributions|init|open-terminal|open-agent | | Client | dsh.client 声明 + ./client 入口 | 1. ctx.slots.inject("conversation.view") 注册 id: "git" 完整管理标签页<br>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 行。