dsh-git-review

dsh plugin --profile web add dsh-git-review

<p align="center">

<picture>

<source media="(prefers-color-scheme: dark)" srcset="docs/banner-zh-dark.svg">

<img src="docs/banner-zh.svg" alt="DSH Git Review" width="720">

</picture>

</p>

DSH Git Review

<p align="center"><a href="README.md">English</a> | 中文</p>

<p align="center">

<a href="https://www.npmjs.com/package/dsh-git-review"><img src="https://img.shields.io/npm/v/dsh-git-review?style=flat-square" alt="npm version"></a>

<a href="https://www.npmjs.com/package/dsh-git-review"><img src="https://img.shields.io/npm/dt/dsh-git-review?style=flat-square" alt="npm downloads"></a>

<img src="https://img.shields.io/badge/dsh-plugin-4D6BFE?style=flat-square&logo=deepseek&logoColor=white" alt="dsh plugin">

<img src="https://img.shields.io/badge/dsh-0.1.2--rc.1..0.2.0--rc.1-4D6BFE?style=flat-square" alt="harness 0.1.2-rc.1 through 0.2.0-rc.1">

<img src="https://img.shields.io/badge/platform-web-8A9CF5?style=flat-square" alt="platform: web">

<a href="LICENSE"><img src="https://img.shields.io/badge/License-MIT-yellow.svg?style=flat-square" alt="License: MIT"></a>

<img src="https://img.shields.io/badge/i18n-zh%20%7C%20en-success?style=flat-square" alt="i18n: zh | en">

<a href="https://awesome-dsh-plugin.com"><img src="https://awesome-dsh-plugin.com/badge.svg" alt="Awesome DSH Plugin"></a>

<a href="https://github.com/HaoyueQin/dsh-git-review/graphs/commit-activity"><img src="https://img.shields.io/github/commit-activity/t/HaoyueQin/dsh-git-review?style=flat-square" alt="Commit activity"></a>

<a href="https://github.com/HaoyueQin/dsh-git-review/commits"><img src="https://img.shields.io/github/last-commit/HaoyueQin/dsh-git-review?style=flat-square" alt="Last commit"></a>

</p>

DeepSeek Harness 的审查标签页 + 围栏 Git 工作台：把 agent 改了什么摆在一页里做决定——文件树、差异、提交图谱，设防的 Git 操作同处一页。

<p align="center">

<img src="docs/demo-zh.svg" alt="DSH Git Review 演示" width="720">

</p>

界面预览

<p align="center">

<img src="docs/review-changes.png" alt="变更视图：语法高亮文件与可过滤文件树" width="720">

<br>

<em>变更视图——语法高亮文件与可过滤文件树</em>

</p>

<p align="center">

<img src="docs/review-graph.png" alt="图谱视图：提交详情与双列差异加词级高亮" width="720">

<br>

<em>图谱视图——提交详情与双列差异加词级高亮</em>

</p>

它能做什么

DSH Git Review 在会话视图里对话与轨迹旁边注册一个审查标签页。展示工作区仓库相对 HEAD（或任意两 ref）的状态，看完直接动手，不用切走：

• 先审后动：可过滤的文件树（状态徽标）、双列 / 单列 / 全文三档差异、hunk 折叠、词级改动高亮、语法着色，以及文件名 / 差异内容 / 文件内容三范围搜索。键盘优先：j/k 切文件，/ 聚焦搜索。
• 用历史做判断：泳道提交图谱（每提交的文件与差异）、blame 边栏、单文件历史，可读历史中任意版本的文件全文。
• 设防的操作：按文件或按 hunk 暂存 / 取消暂存 / 放弃，提交（含 amend、Ctrl+Enter）、提交并推送与推送；分支（创建 / 切换 / 重命名 / 删除 / 合并 / 跟踪远端）带拉取与合并上游；历史操作（reset / revert / cherry-pick，可在图谱中对提交直接操作）；轻量标签（创建 / 删除 / 推送）；贮藏；以及合并冲突解决（ours / theirs，继续 / 中止）。每次写操作都要明确确认，破坏性操作确认两遍，agent 运行中全部上锁。
• 审查闭环：在任意差异行写评论并送入对话输入框，把文件标为已审（文件再改自动取消），评论草稿按工作区分存。
• 文件预览：markdown 用宿主自带的 Markdown 引擎渲染，HTML / 图片 / SVG 内联展示，PDF 沙箱打开——依赖脚本的 HTML 页面会被提示条标注并给出「在浏览器打开」，而不是停留在一块黑屏；每种预览都有源码切换，办公文档请在文件树右键用外部应用打开。
• 图片对比：图片变更（PNG / JPG / GIF / WebP / BMP / AVIF / ICO / SVG）直接在差异视图里渲染成图——并排（双列左右、单列上下）、滑动、叠加、差异四种模式，源码 diff 一键切换。

偏好（差异布局、默认搜索范围、图谱形态、匹配方式、空白、语法高亮）放在 harness 设置的插件标签页，与审查标签页即时互相同步。

安装

dsh plugin --profile web add dsh-git-review
dsh web

或从本地 tarball 安装：

pnpm install
pnpm build
pnpm pack
dsh plugin --profile web add ./dsh-git-review-<version>.tgz  # 以 pnpm pack 实际打出的文件名为准
dsh web

要求 DeepSeek Harness 0.1.2-rc.1 至 0.2.0-rc.1（prerelease 系列在 peerDependencies 里逐个钉住），且宿主 PATH 里有 git。工作区不在 git 仓库内时，标签页提供文件浏览与一键初始化，而不是审查工作台——绝不白屏。显示偏好的存放位置随宿主走：0.1.7-alpha.1 起是宿主为本插件条目服务的那份配置（本插件用 .volatile() 字段声明、按 profile 条目 id 读取），0.1.6-alpha.2 起在侧栏 Plugins 页里本插件的条目，更早则是设置弹窗的插件卡片。

检查

pnpm typecheck      # 严格类型检查
pnpm check:parse    # 纯函数回归（Node >= 23.6 原生 TS 剥离）
pnpm check:git      # 真实 git 夹具集成测试（仓库建在 .tmp-check-git/ 下）
pnpm build          # lib/index.js（node 端）+ lib/client.js（浏览器端 bundle）

工作原理

• Host 半：宿主进程内的 cordis 插件，经围栏前缀路由提供 JSON 动作接口（非 JSON 请求体直接 415，顺带关掉经典 no-cors 写向量）。所有路径围栏在会话工作区的仓库内，所有 ref 服务端复核，commit id 只收 40-hex，并清洗 GIT_DIR 一类环境劫持。
• 浏览器半：会话视图插槽组件；host 路由可选——缺席时标签页明示而不报错。
• 规模护栏：2 万行渲染帽、单文件 2 MiB 差异帽、图谱 500 提交分页加载、最大 git 输出 8 MiB 流式字节帽另加独立的 8 MiB 预览帽（均截断而非整体入内存），以及每次 status 32 MiB 预算内的精确计数。
• 界面语言：简体中文与英文，随 harness 语言切换；深浅主题走语义 token。

Activity

<p align="center">

<a href="https://gitstock.org/HaoyueQin/dsh-git-review"><img src="https://gitstock.org/HaoyueQin/dsh-git-review/stock.svg" alt="HaoyueQin/dsh-git-review GitStock K-Line Chart"></a>

</p>

MIT © HaoyueQin

插件图标复刻自 Jason Long 设计的 Git logo，依

CC BY 3.0 授权使用。