Git 提交与 PR 胶囊 ls-open/dsh-git-composer

dsh-plugin-git-composer

DeepSeek Harness (DSH) 桌面客户端与 Web 端的 Git 工作区状态感知与 PR 协同胶囊插件。

在输入框上方常驻显示 Git 分支名、真实代码增删行数（+X -Y）、一键点击审查行级 Diff，并无缝联动 GitHub PR 与 Actions CI 流水线状态。

🖥️ 界面效果一览

挂载于 DSH 桌面端 / Web 端对话输入框（Composer）正上方：

🎯 核心功能特性

全面打通本地代码修改感知、差异审查与 GitHub 云端流水线协同：

| 交互模块 | 功能细节 | 行为表现 |
| 工作区胶囊 | 分支与仓库常驻 | 毫秒级提取当前所在仓库名与分支名（如 my-repo main） |
| 一键快速切分支 | 零 Token 快捷检出 | 点击分支名下拉展开本地分支列表，毫秒级本地切换，无需额外向 AI 发送指令 |
| 真实增删统计 | 动态 +X -Y | 底层调用 git diff --numstat，随着模型每次修改文件实时动态刷新，非静态伪造 |
| 行级 Diff 审查 | 点击胶囊看改动 | 点击 +X -Y 徽章，自动调用 DSH 官方内置的 Diff 审查抽屉，逐行高亮查看改动细节 |
| 自适应按钮 | 本地提交 vs 提 PR | • 无 Remote（纯本地仓库）：自适应为 Commit changes，点击即让 AI 自动写提交信息并在本地 commit• 有 Remote（GitHub 仓库）：自适应为 Create PR ▾ 下拉菜单 |
| PR 发起菜单 | 3 种提交模式 | 点击下拉可选：Create PR（直接提审）、Create draft PR（草稿 PR）、Manually create PR...（网页打开） |
| PR 状态感知 | 自动状态升级 | 当分支已关联 PR 时，自动渲染第二条独立卡片：显示 ⑂ #PR号 及该 PR 的增删统计 |
| CI 流水线指示灯 | ⚬ CI ▾ 实时状态 | 轮询 GitHub Actions Checks：通过显示绿色点、构建中显示旋转动画、失败显示红色点，点击下拉可看每项 Job 结果 |
| 风琴折叠堆叠 | Show more / less | 存在多条卡片时自动收折，绝不遮挡或挤占主对话输入框 |
| 卡片独立关闭 | 右侧 × 按钮 | 点击可临时隐藏单条胶囊卡片 |

🚀 安装与启用指南（支持多种灵活方式）

DSH 原生支持从内置市场、GitHub 远程直装、npm 镜像、本地目录等多种途径安装插件，你可以按自己的使用习惯选择最便捷的方式：

方式 1：DSH 客户端「插件市场」一键安装（最便捷）

1. 打开 DSH 桌面客户端，点击左侧菜单栏 Plugins（插件市场）；
2. 在搜索框输入 dsh-plugin-git-composer；
3. 点击 Install（安装），安装完成后在列表中确保勾选为 Enabled（启用） 即可。

方式 2：GitHub 远程直链安装（无需手动下载文件）

如果你不想手动下载 zip 或源码，可以直接通过 GitHub 仓库地址远程安装：
- GUI 界面操作：进入 DSH 客户端 Settings（设置） → Plugins（插件） → 点击 Install from URL，输入 GitHub 仓库地址： https://github.com/ls-open/dsh-git-composer

- 或者通过终端命令直装：
dsh plugin --profile web add github:ls-open/dsh-git-composer
或默认 profile:
dsh plugin add github:ls-open/dsh-git-composer

方式 3：npm / 包管理器一键安装

对于通过包管理运行 DSH 的开发者，可通过标准 npm 方式加载：
dsh plugin --profile web add dsh-plugin-git-composer

方式 4：本地源码 / 离线目录安装（开发者调试推荐）

如果你需要二次开发或处于离线内网环境：
1. 下载或克隆源码至本地目录（例如 ~/Downloads/dsh-git-composer）；
2. 运行构建：
cd ~/Downloads/dsh-git-composer && npm install && npm run build

3. 在 DSH 客户端的 Settings → Plugins 中点击 Install Local Plugin，选择该文件夹即可。

⚠️ 注意事项与前置说明

1. GUI 客户端完全兼容：
- DSH 桌面客户端基于 Electron 构建，其前端渲染层与 Web 端共用一套 Cordis 插件插槽体系（composer:header）。包含 cordis.patch.yml 自动配置 Host 与 Client 端，两端完全通用。
2. Git 环境要求：
- 宿主机需安装基础 git 工具；
- 打开非 Git 文件夹时，插件会自动保持静默，绝不占用任何界面空间或弹错。
3. GitHub PR / CI 特性依赖：
- 「一键创建 PR」与「CI 流水线监控」通过本地官方 GitHub CLI（gh）完成；
- 若未安装或未登录 gh，插件会自动优雅降级为本地模式（只显示 Commit changes 和行级 Diff 审查），不影响正常使用。

📂 项目结构

dsh-git-composer/
├── cordis.patch.yml # DSH 插件自动挂载声明（Host 端与 WebUI Client 端） ├── src/ │ ├── core/ │ │ ├── git.ts # 高性能 Git 状态、动态增删行数与 Diff 提取 (<15ms) │ │ └── github.ts # GitHub CLI 交互与 Actions CI 状态解析 │ ├── ui/ │ │ └── ComposerGitBar.tsx # 输入框上方高保真胶囊组件（动态行数、Diff 触发、PR 状态灯） │ ├── client.ts # 浏览器端插件入口（挂载 composer:header 插槽） │ └── index.ts # Cordis 宿主端插件入口（apply(ctx) 及工作区监听） ├── assets/ │ ├── preview.png # 真实 DSH 对话框效果预览图 │ └── preview.svg # 矢量设计源文件 ├── package.json # 双模导出（ESM/CJS、./client）与类型定义 ├── tsup.config.ts # 现代化打包配置 ├── tsconfig.json └── README.md

📄 授权协议

MIT License