前言¶
在 DSH Web 里处理 Git 仓库时，常见操作不止聊天：还需要切换分支、查看提交图谱、审核 Diff，并把当前改动交给 Agent 分析。dsh-git-panel 把这些 Git 操作放进 Web GUI 的右侧面板，减少在终端、浏览器和对话窗口之间来回切换。
下面介绍它的定位、核心功能、安装方式和典型用法。
这是什么¶
dsh-git-panel 是 DSH Web GUI 的 Git 面板插件。它提供分支管理：切换、拉取、抓取、重命名、删除、合并，以及 GitLens 风格的提交图谱。
资料中给出的仓库 owner 为 a792883583；package.json 的 author 字段为 Jaden Tang <jaden.tang@sjfood.com>。许可证为 MIT。
核心功能¶
分支面板¶
分支面板出现在聊天区右侧。它显示本地分支和远程分支，当前分支高亮，并显示相对上游的 ahead/behind。
分支列表顶部有实时搜索，可以按分支名或提交信息快速过滤。
常用操作包括：
- 双击本地分支切换分支；当前分支双击执行拉取。
- 双击远程分支检出，并自动创建本地跟踪分支。
- 右键分支可复制分支名、重命名、删除，或合并至当前分支；远程分支为删除远程分支。
- 一键拉取当前分支。
- 一键全部抓取，对应命令为：
git fetch --all --prune
分支胶囊¶
输入框上方有分支胶囊，显示当前分支；点击后展开本地分支列表，可快速切换。
提交图谱¶
提交图谱使用 GitLens 风格的提交 DAG 泳道图，带三栏标题，列宽可拖拽；渲染使用虚拟化，只绘制可视区域。
点击提交节点可以查看提交详情，并执行：
- cherry-pick 到当前分支
- 撤销该提交，对应命令为：
git revert --no-edit
写操作条¶
写操作条支持以下操作：
- 提交：输入提交信息后回车，执行：
git add -A && git commit -m
- 推送：一键执行当前分支推送，对应命令为：
git push
- 暂存：
git stash push
可带说明。
- 恢复暂存：
git stash pop
- 状态：显示当前工作区变更文件数。
变更文件与 Diff¶
面板会列出未提交的变更文件，点击文件可查看与 HEAD 的行内着色 Diff，便于提交前审核改动。
它也支持将改动列表或单个文件 Diff 一键带入对话输入框，方便让 Agent 分析当前修改或差异。
语言、主题与工作目录¶
- 自动跟随 DSH Web 界面语言，默认简体中文。
- 明暗主题跟随 DSH Web GUI。
- 跟随当前会话工作目录；切换项目会话时自动重新绑定。
安装与启用¶
先安装插件：
dsh plugin --profile web add dsh-git-panel
然后重启 dsh web，打开绑定 Git 仓库的项目会话。聊天区右侧会出现「Git 面板」。
本地开发时，可以用链接方式安装：
dsh plugin --profile web add link:/path/to/dsh-git-panel
修改源码后，构建并刷新页面：
npm run build
典型用法¶
下面按常见流程列出可复现操作：
1、进入绑定 Git 仓库的项目会话，查看右侧分支面板。
2、双击本地分支切换分支；如果当前分支需要拉取，双击当前分支。
3、需要新建本地跟踪分支时，双击远程分支。
4、提交前，点击变更文件查看与 HEAD 的 Diff。
5、在提交栏输入提交信息并回车，执行提交。
6、推送当前分支。
7、需要临时保存改动时，使用暂存；需要取回时，恢复暂存。
8、点击图谱中的提交节点，执行 cherry-pick 或撤销该提交。
9、需要 Agent 分析时，将改动列表或单个 Diff 带入对话输入框。
适用场景与注意¶
适合在 DSH Web 中处理 Git 仓库，并且需要把分支、提交、Diff 和会话上下文放在同一界面处理的开发者。
使用前需要注意：
- 安装后需重启
dsh web，并在绑定 Git 仓库的项目会话中使用。 - 资料未提供星标数、权限边界、网络调用范围等额外限制信息。
- 插件以当前
dsh进程权限运行；安装前应检查源码与许可证。 - 许可证为
MIT。 package.json声明dsh client platform为web，需注入@deepseek-ai/dsh-client-runtime与@deepseek-ai/dsh-client-locale。package.json的peerDependencies要求@deepseek-ai/dsh-*在>=0.1.0-rc.6 <0.3.0，React在>=16.8.0 <20.0.0。
链接¶
- GitHub：https://github.com/a792883583/dsh-git-panel
- 目录页：已核实资料未提供目录页 URL。
