HaoyueQin/dsh-git-review

DSH Git Review

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

界面预览

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

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

它能做什么

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-.tgz  # 以 pnpm pack 实际打出的文件名为准
dsh web

要求 DeepSeek Harness 0.1.2-rc.1 至 0.1.6-alpha.2（prerelease 系列在 peerDependencies 里逐个钉住），且宿主 PATH 里有 git。工作区不在 git 仓库内时，标签页提供文件浏览与一键初始化，而不是审查工作台——绝不白屏。显示偏好随宿主存放插件配置的位置走：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

MIT © HaoyueQin