Git 面板 EasyTZ/dsh-git

dsh-git
在 DeepSeek Harness 里完成日常 Git 操作，不离开当前会话。
查看改动 · 逐文件暂存 · 提交与推送 · 切换分支 · 浏览历史

面向 DeepSeek Harness 的可视化 Git 面板：无需离开当前会话即可暂存、提交、推送、切换分支并查看历史。

前置要求

- dsh >= 0.1.1-rc.2
- 机器上装了 git 且在 PATH 里
- pnpm 可用（dsh plugin 底层转发给 pnpm）

安装

最省事的办法是用插件市场：打开「发现」，搜 dsh-git，点「安装」。

命令行：

dsh plugin --profile add @easytz/dsh-git

是必填的 profile 名，不能省略——桌面版通常是 web，TUI 是 tui；不确定就看 $DSH_HOME/profiles/ 下的目录名。想钉死版本就写 @easytz/dsh-git@0.5.6。

插件自带 dsh.bundle 层（cordis.patch.yml），dsh plugin add 会同时完成「装进去」和「注册激活」，不需要手写 patch。

装完重启 dsh，侧边栏底部出现 Git 按钮。

用法

点侧边栏底部的 Git 按钮打开面板。

选仓库. 有多个工作区时，顶部「工作区」下拉切换。工作区根目录自己不是仓库、但下面的子目录各自是仓库时，会多出一个「仓库」下拉（见下面「一个工作区装了多个仓库？」）。

提交. 提交框就在分支行下面，是面板里最顺手的位置：

1. 在「变更」里点文件右边的 + 把要提交的文件暂存；已暂存的点 − 撤回。
2. 在框里写提交信息。
3. 点 提交。

未跟踪的新文件不会被自动带上，必须逐个点 + 明确选择——这是刻意设计，避免误提交。

推送. 点 推送 ↑n，n 是本地领先远端的提交数。没有待推送的提交时这个按钮是灰的。

切分支. 分支行的下拉，选一个就切过去。旁边的 ↑n ↓n 是相对上游的领先 / 落后数。

看历史. 「最近提交」按时间倒序列出提交，每条标着 ○ 未推送 / ● 已推送。点任意一条弹出提交详情：完整提交信息、改动了哪些文件、每个文件各增删多少行。底部「展开更早的 n 条」看更多。

撤销最近一次提交. 只有最新那一条右侧有撤销按钮。点一下变红进入二次确认，三秒内再点才真的执行：未推送走 reset --mixed（改动退回工作区，不会丢），已推送走 revert（生成一条反向提交，别忘了推送）。

刷新. 标题栏的刷新图标重新读一遍仓库状态。

卸载

dsh plugin --profile remove @easytz/dsh-git

与安装时一致。remove 会把包从 profile 依赖里移除，dsh 随后会把它从激活清单（dsh.profile.bundles）里撤掉。重启 dsh 后按钮消失。

如果你按旧版 README 手动往 $DSH_HOME/profiles//cordis.patch.yml 或 $DSH_HOME/cordis.patch.yml 里加过 - insert: 条目，卸载时把那段 YAML 一起删掉。

一个工作区装了多个仓库？

工作区根目录自己不是仓库、但下面的子目录各自是独立仓库（比如一个 projects/ 下并排放着好几个 repo）时，面板会往下扫一层，把找到的仓库列在一个「仓库」下拉里，选中哪个就操作哪个。选择按工作区记住，下次打开还停在上次那个。

- 工作区根自己在某个仓库里（是仓库根，或者是仓库的子目录）时不显示这个下拉，行为跟单仓库完全一样。
- 只扫一层，且跳过 node_modules、dist、build 与点开头的目录 —— 否则 vendored 依赖里自带的 .git 会把列表淹掉。
- 默认停在 .git 最近被动过的那个仓库。

已知限制

- 撤销提交只支持最新一条（未推送走 reset --mixed 保留改动，已推送走 revert 生成反向提交）。
- 推送被远端拒绝（需要先 pull）时面板不代劳，会提示去终端执行 git pull。
- 未跟踪的新文件不会被「提交」按钮自动暂存——必须逐个点「+」明确选择，这是刻意设计。

平台支持

已在 Windows 与 macOS 上验证；插件代码没有平台分支，Linux 使用同一套 Git 命令接口。

一个用于 DeepSeek Harness（dsh）的第三方插件，在侧边栏中添加一个可视化 Git 面板——无需离开 dsh，也无需记住命令，即可完成日常 Git 操作。

环境要求

- dsh >= 0.1.1-rc.2
- 已安装 git 并位于 PATH 中
- 可使用 pnpm（dsh plugin 会调用 pnpm）

安装

最简便的方式是通过插件市场：打开 Discover，搜索 dsh-git，点击 Install。

通过命令行：

dsh plugin --profile add @easytz/dsh-git

是必填项——你的 dsh 配置文件（桌面/网页 UI 通常为 web，TUI 为 tui）。如需可复现性，可用 @easytz/dsh-git@0.5.6 固定版本。该包自带 dsh.bundle 层，因此 dsh plugin add 会同时安装并激活它；无需手写补丁。

重启 dsh——侧边栏底部会出现一个 Git 按钮。

使用方法

点击 Git 按钮打开面板。

- 选择仓库。 当你有多个工作区时，会出现工作区下拉菜单。如果工作区根目录不是仓库，但其直接子目录是，则会出现第二个“仓库”下拉菜单列出它们。
- 提交。 在 Changes 下，用每个条目旁的 + 暂存文件（− 取消暂存），输入提交信息，点击 Commit。未跟踪的文件绝不会被自动暂存——这是有意为之。
- 推送。 点击 Push ↑n，其中 n 表示你领先远程的提交数。
- 切换分支。 使用分支行上的分支下拉菜单；旁边的 ↑n ↓n 表示领先/落后数。
- 历史。 Recent commits 按从新到旧列出提交，每个标记为 ○ 未推送或 ● 已推送。点击任意行可查看完整提交信息、更改的文件，以及每个文件的插入/删除数。
- 撤销上一次提交。 只有最新的提交提供此功能。点击一次进入待命状态（变红），在三秒内再次点击执行：未推送时执行 reset --mixed（更改回到工作区），已推送时执行 revert。

卸载

dsh plugin --profile remove @easytz/dsh-git

限制

- 撤销仅适用于最近的提交。
- 被拒绝的推送（远程领先）会被报告，但不会自动解决——请在终端中运行 git pull。
- 未跟踪的文件必须显式暂存。
- 仅在 Windows 上验证过；代码没有平台特定的分支，因此 macOS/Linux 应该也能正常工作。欢迎反馈。

许可证 / License

MIT