- Startseite
- Plugins
- Git & Code-Review
- dsh-git-panel
dsh-git-panel
lcx19970714/dsh-git-panel
Git panel for viewing diffs, editing files, staging and committing changes, and generating commit messages using models configured in DSH.
Installation
dsh plugin --profile web add github:lcx19970714/dsh-git-panelREADME
dsh-git-panel
DeepSeek Harness 的 Git 面板插件:在会话右侧栏里看变更、读 diff、编辑文件、暂存与提交,提交说明可以直接用 DSH 里已配置的模型生成。
深度审阅的日志
每次深度审阅都会在 ~/.dsh/dsh-git-panel/review.log 追加完整步骤(时间戳、级别、耗时、仓库#PR),
面板结果里的「执行步骤」也会列出每一步做了什么、耗时多少、哪一步失败。
常见耗时来自:拉取/切换分支(本地已在该提交上时会跳过)、读取完整文件、调用审阅模型。
深度审阅报 Authentication failed / Unauthorized
- 深度审阅审的是真实本地目录,所以会把你本地的仓库切到 PR 对应的分支(同仓库 PR 直接切 PR 分支,
fork PR 切到
dsh-review/pr-<n>)。审完面板的「储存库」与变更列表会跟着刷新到那个分支; 想回到原来的分支,用「储存库」行尾的分支菜单切回去即可。 - Gitee 的 fork PR:Gitee 没有
refs/pull,深度审阅必须能从 fork 仓库拉代码。若当前账号读不到 该 fork(例如 fork 是私有的、或你只有 base 仓库权限),会明确提示fork-no-access。 处理:换成对 fork 有权限的账号,或让作者把分支推到主仓库。 - 同仓库 PR:确认令牌包含仓库读写(Gitee 的 projects / GitHub 的 repo)权限。
- 插件拉代码时会禁用本机凭据管理器,只用插件里配的令牌,所以
git命令行里能克隆不代表这里一定行 (命令行可能用了凭据管理器里另一份凭据)。
安装
在线安装(推荐)
DSH → 侧边栏「插件」→「安装第三方插件」,填入:
github:lcx19970714/dsh-git-panel
点安装即可。装完重启一次 DSH(或在「插件」页随便关开一个插件触发重组),会话标题栏右侧就会出现「变更」按钮。
命令行安装
dsh plugin add github:lcx19970714/dsh-git-panel
更新已安装的插件
工具条右侧的版本号只负责检查 GitHub Release 并打开 release 页,不会自己替换已安装文件。
- 新电脑:按上面的方式安装,直接取到默认分支最新代码。
- 已安装:在「插件」页对
dsh-git-panel重新安装(或再执行一次dsh plugin add github:lcx19970714/dsh-git-panel)。 - 更新后如果包含宿主端改动(例如新增的
roots/stats),重启一次 DSH;客户端 bundle 会热更新,不需要重启。
本地开发
git clone https://github.com/lcx19970714/dsh-git-panel.git
cd dsh-git-panel
node scripts/install-profile.mjs # 建目录联接装进 default profile
这条路径下改 src/ 后跑 node build/build-client.mjs 立即生效(客户端热替换,约 1s)。
能做什么
| 功能 | 说明 |
|---|---|
| 变更列表 | 列表 / 树形两种显示,可在设置里切换;支持筛选与键盘导航 |
| 查看 diff | 统一 / 并排视图、上下文行数、忽略空白、词级高亮 |
| 编辑并保存 | 文件模式直接改,Ctrl/Cmd+S 保存;带内容哈希校验,冲突时二选一 |
| 暂存 / 取消暂存 | 文件行尾 + / −,分组头可整组操作 |
| 退回改动 | 未暂存 / 未跟踪的文件行尾 ↶:二次确认后把这个文件的改动退回(与 VS Code 的 Discard Changes 一致)。已跟踪文件只退工作区那一半(回到暂存区,已暂存的不动);未跟踪文件退回 = 删除它 |
| 提交 | smart commit:有暂存只提交暂存;没有暂存则先全部暂存再提交 |
| 生成提交说明 | 用 DSH 里配好的模型生成,优先用暂存内容;生成中显示进度。说明为空时右上角只有生成图标;生成完成后同一位置出现「重新生成 + 提交」两个图标,点完生成可以直接提交,不用把鼠标移到底部 |
| 多仓库 | 项目内仓库、子目录仓库、外部仓库都列在「储存库」里,点选切换;有改动的仓库行尾直接显示改动文件数与 +N/−N 行数 |
| 隐藏仓库 | 用不上的仓库(测试夹具、vendor)在行尾隐藏,只从「储存库」收起、不动仓库;标题行眼睛按钮展开「已隐藏」再取消隐藏 |
| 分支列表 | 一个分支一行,后面两个小标签 本地 / 远程:亮 = 有,暗 = 没有;有上游时显示 ↑n ↓m。点「只有远程」的行会在本地建跟踪分支并切过去 |
| 获取远程更新 | 分支菜单顶部「获取远程更新」执行 git fetch 并重读列表——别人新推的分支就在这一步出现 |
| 切换 / 新建分支 | 当前分支贴在「储存库」行的最右侧;只有点它才打开菜单。可切到已有分支,也可输入名字新建:能选创建基准(当前分支 / 本地分支 / origin/*)和「创建后切换」;工作区脏时先显示改动计数,从当前分支建就原样跟随、不自动提交;跨基准撞车时摊开重叠文件,给两个零风险出口(改为从当前分支创建 / 只建分支不切换)。建完「变更」页签会按分支与远端的关系给提示:没推过或本地领先时给「推送到远端」按钮(也可照抄 git push -u origin <分支>);远端分支已被删除时给的是「收尾」而不是推送——先取远程更新、切回默认分支,再删掉这条本地分支(合并后删分支是常态,再推一次会把已合并的分支重新建出来) |
| 远端仓库 | 第三个页签「远端」:列出账号下的仓库,选中后右侧显示代码概况、Issues 与 PR(含未关闭数量与最近条目);点「拉取」克隆到项目根下的子文件夹;没账号时直接在页签里添加。登录多个账号时,每个工作区分别记住自己选中的账号:切到别的工作区再回来、或重新打开面板都还是上次那个,不会退回第一个 |
| 远端分支 | 选中仓库后右侧多一个「分支」区:列出这个仓库在远端的所有分支,每行标明本地有没有 / 远端有没有(亮/暗两个标签,远端读不到时是第三种「未知」状态)、当前分支、默认分支、受保护分支、↑n ↓m、上游是否已被删、远端是否已有本地还没 fetch 的新提交。行上可直接切换、给仅远端的分支建本地跟踪分支、复制分支名、打开网页;也能删除本地分支 / 删除远端分支——都是二次确认,本地分支有未合并提交时只额外露出「强制删除」,不默认 force。本地没克隆时仍能看/删远端分支,并提示先拉取才能切换 |
| PR 红点 | 远端仓库列表里,有未合并 PR 的仓库带红色数字角标;数量用每个仓库一次轻量请求取(批量、并发上限 6、单仓库失败不影响其它) |
| AI 审阅 PR | PR 详情里点「AI 审阅」:读 PR 的文件 patch,让模型给出总评 + 编号问题清单(严重度 / 文件:行 / 问题 / 怎么改),超长改动会明确标注"只审了一部分" |
| 左侧栏入口 | 侧栏底部「代码坞」(彩色图标):展开时图标 + 名称,收起成图标条时只有图标;点一下打开当前会话的 Git 面板 |
| 仓库行 | 每行是一个整体:仓库名 + 右侧分支按钮;隐藏/取消隐藏/从项目移除都在分支按钮的下拉菜单里,行内不再放动作按钮 |
| 分支菜单 | 「获取远程更新」只做 git fetch(刷新远端分支与领先/落后,不改工作区文件);「拉取当前分支最新代码」才真的拉代码(fetch + 只允许快进,分叉/冲突/无上游都明确报错,不自动产生合并提交) |
| 插件更新 | 工具条右侧版本号显示插件版本(vX.Y.Z),点击检查 GitHub 最新 release:已是最新 / 有新版本(可点开下载)/ 失败原因;仓库上游(origin)的领先/落后在分支菜单的「获取远程更新」里看 |
| 我的 PR 状态 | 变更页签顶部卡片:当前分支关联的 PR(#编号 / 状态 / 未读反馈数 / 最近评论),点「查看 PR」直达详情;没有 PR、没配账号、origin 不是平台仓库都直说原因 |
| 评论交给 AI | PR 详情每条评论有「让 AI 处理」:新建会话先判断这条意见是否成立(不成立就说明理由、不改),成立才改且只改该评论涉及范围,跑相关测试,不自动 commit / push |
| 创建 PR | 变更页签提交框右侧「创建 PR」:自动认 origin(GitHub/Gitee)、带出源分支与远端目标分支,目标分支默认 dev→main→master,并记住上次选择;可用模型生成标题与描述后自己改,分支与远端没同步时会阻断,并按状态说清原因(从没推送 / 本地领先 → 先推送;远端已删除 → 先「收尾」;落后 / 分叉 → 先拉取),推送按钮就在同一屏的左侧提示条里,同步后创建按钮自动可用;创建成功给「打开 PR」 |
| 提交列表 | PR 详情里列出本次包含的提交(短 SHA / 首行标题 / 作者 / 时间),审阅时能先看这次改了几笔 |
| PR 变动文件 | PR 详情里按文件列出这次改动(状态字母 + 文件名 + +N −M);点一行就地展开该文件的 diff,折叠再展开不重复请求;平台没给某个文件的 diff(二进制 / 过大)时如实说明,文件超过平台上限时标注只拿到一部分 |
| 关闭 / 重新打开 | PR 详情右上角:关闭是两步确认(防误点),重新打开直接执行;两家都是 PATCH /pulls/{n} + state |
| 评论区 | PR 详情里有常驻评论区:能看到已有对话(作者 / 时间 / 正文),随时写留言发给对方(Markdown);AI 审阅的草稿点「填入评论框」即可编辑后发送 |
| 评论草稿 | AI 同时起草一段给作者的评论(按 1. 2. 3. 讲清问题与调整方式);草稿在面板里可编辑,只有点「提交评论」才发到 PR |
| 审阅模型 | 设置页里「AI 审阅模型」与提交说明模型各自独立配置,互不影响 |
| 门禁状态 | PR 详情顶部并排显示「审查 / 测试 / 合并状态」;审查按人取最新结论聚合,测试状态平台没接口就如实写「平台未提供」 |
| 一键通过 | 一个按钮按平台能力执行:GitHub 只做审查(测试由 CI 决定),Gitee 审查 + 标记测试一起做;某一步失败会照实列出。PR 与目标分支有冲突时(Gitee 会用 403 表达),提示会说清「先解决冲突」,并给一条「到网页上解决冲突」的出口,不再误报成令牌失效 |
| Gitee 合并门禁 | 仓库要求「测试通过」才能合并时,PR 详情里有「标记测试通过」按钮,不用回 Gitee 网页 |
| PR 详情与合并 | 点开某个 PR 就在面板里读详情、审查(通过 / 请求修改 / 评论)并合并(可选方法与删源分支),不用跳浏览器 |
| 检测更新 | 点版本号检查插件自身是否有新 release(不碰仓库、不执行 git fetch);仓库的领先/落后看分支菜单 |
| 设置 | 模型、列表/树形、未跟踪文件分组、提交后自动推送 |
三种仓库形态
| 形态 | 面板行为 |
|---|---|
| 项目根就是一个仓库 | 「储存库」里一行,直接用 |
| 项目下有多个仓库 | 自动发现(最深 4 层、跟随目录联接),各占一行 |
| 粘贴路径 | Windows 资源管理器「复制为路径」会带引号("H:\repo"):添加目录与新建分支的输入框会自动去掉首尾成对的引号,直接粘贴即可 |
| 仓库不在项目里 | 「储存库」标题行 + 添加本机目录(该目录自身必须含 .git);只识别这一个目录,不向上找上级仓库也不扫描子目录,行尾可移除 |
项目根只是仓库子目录时,变更列表展示整个仓库的变更(与 VS Code 一致)。
配置
设置入口在工具条右侧的齿轮:
- 生成提交说明的模型 — 列出 DSH 当前可用的模型,选中即保存;未配置时生成会提示
- 变更文件的显示方式 — 列表 / 树形
- 未跟踪文件的分组 — 并进「未暂存」(与 VS Code 一致)或单列一组
- 提交后自动推送 — 提交成功后自动把当前分支推到 origin(默认开);推送失败不影响这次提交,失败原因显示在变更页签的提示条里。它是客户端偏好,不写进
settings.json - 代码托管账号 — 添加 GitHub / Gitee 账号。设置页与「远端」页签里都有跟着平台走的引导和「获取令牌」按钮(GitHub 会预填
reposcope,被浏览器拦截时直接把地址显示出来供复制),复制令牌粘进去即可;插件先用它调一次/user验证,通过后才存进 DSH 凭据服务(credentialKey('dsh-git-panel', '<provider>')的 grant 记录)。插件不读明文配置;令牌只在用户点「显示令牌」时按需取回,列表接口永远不含它。账号可以随时改备注名、换令牌(会重新校验),也可以显示并复制令牌
第一次添加账号(GitHub 例)
- 设置 → 最下面「代码托管账号」,平台选 GitHub
- 点「打开令牌页面」→ 浏览器打开 GitHub 新建令牌页,
reposcope 已预填、描述写着 dsh-git-panel → 拉到最下面点 Generate token - 复制那串
ghp_…(只显示一次)→ 回到面板粘贴 → 「添加账号」 - 成功会显示「已连接:<你的登录名>」,切到「远端」页签就能看到全部仓库
Gitee 同理,第三步勾 projects 即可,其余一致。
限制
- 分支:变更页签可切换 / 新建本地分支(删除本地分支在远端页签的分支区,未合并时只露「强制删除」),远端页签可删除远端分支;可以推送当前分支到 origin(
git push --set-upstream origin <当前分支>,用本机 git 凭据,只推当前分支、只推 origin),但不 force push;提交后自动推送默认开,可在设置里关掉,推送失败不影响这次提交;不做 rebase、merge(「拉取当前分支最新代码」只允许快进)。退回只做单文件(行尾↶,二次确认):不提供「整组退回」,也不会用checkout -f静默丢掉其它改动 - 远端分支列表一次最多读 10 页(1000 个),到上限会明确提示「只显示前 N 个」
- 文件模式固定浏览项目根(没有仓库选择器),仓库切换只发生在变更模式的「储存库」里
- 提交会执行仓库自己的 git hooks,失败时原样显示 hook 的输出
- 生成说明 / AI 审阅用的是 DSH 里配好的模型,额度与密钥都归那个 provider 管:账号余额不足、密钥过期、限流或断网时,提示会直接说清是哪一种、下一步该充值还是换模型,原始错误附在末尾
- 文件模式的编辑不设语法高亮(diff 视图仍有词级高亮)
开发
node build/build-client.mjs # 构建客户端产物 client.js
node test/run.mjs # 全部 13 个测试套件
node scripts/audit-dead-code.mjs # 死代码体检(CI 也跑)
node test/make-fixture.mjs _sandbox/repo # 生成 host 测试用的真实仓库
文档:docs/ARCHITECTURE.md(平台约束、端点、反兜底约定)、docs/CONTRACT.md(客户端模块契约)。
License
MIT
Ähnliche Plugins
dsh-web (dsh-git-graph)
zhu1090093659/dsh-web
plannotator
backnotprop/plannotator
dsh-web-ui (dsh-git-graph)
zhu1090093659/dsh-web-ui
codex-guard (dsh)
akimiya-z/codex-guard