前言¶
在 DSH 里改代码时，工作区往往已经有一堆未提交 diff，但对话界面本身不负责看改动、勾暂存、写提交说明。常见做法是切到 IDE 或终端跑 git status、git diff，再回到对话继续——上下文容易断，也很难在同一会话里让 AI 参照「真实暂存区」起草提交信息。
dsh-code-review 是 DSH（DeepSeek Harness）的 Web UI 客户端插件：在当前对话所属 Git 仓库上打开非模态浮动窗口，直接基于未提交状态做并排审阅、按文件或变更块暂存与还原，并在窗口内完成提交与推送。下面按定位、能力、安装与典型用法说明。
这是什么¶
- 名称与包名：
@acanzaima/dsh-code-review（仓库 acanzaima/dsh-code-review，维护者 acanzaima）。 - 分类：客户端插件（
dsh.client.platform: web，注入对话与设置等 UI 槽位）。 - 一句话：在 DSH Web UI 中，用浮动窗口审阅当前工作区 Git 仓库的未提交改动，可选 AI 归类与草拟提交信息。
- 运行前提：本机可用 Git；Node.js ≥ 20.11（资料写明 DSH 桌面端已内置满足要求的运行时）。已在 DSH 0.2.2-rc.1 上验证；
package.json当前版本为 0.2.2，许可证 MIT，运行时依赖为 0。
插件以当前 DSH 进程权限操作本机 Git 仓库，安装与启用前请自行查看源码与许可证，涉密仓库慎用会向模型发送内容的 AI 功能。
核心功能¶
审阅与 Git 操作¶
- 并排审阅：文件 diff、语法高亮、增删统计，支持搜索与跳转上一处 / 下一处变更。
- 选择提交内容：按文件或分组勾选暂存、取消暂存；右键文件或 diff 变更块可暂存、取消暂存或还原（还原丢弃未暂存改动，需确认且不可撤销）。
- 提交与推送：填写提交信息并提交；需要时推送，可配置远程地址。推送预览不自动
git fetch，也不强制覆盖远端。 - 窗口行为：多工作区 / 多会话可各开独立审阅窗口，可拖动、缩放、最小化，不阻塞对话；适配 DSH 浅色 / 深色主题，中英双语。刷新 DSH 页面会关闭所有审阅窗口。
可选 AI¶
- AI 归类（默认关闭）：除按 Git 状态分组外，可切换「按职能」或「按功能逻辑」整理文件列表；失败时仍可按 Git 状态审阅。会向 DSH 模型服务发送项目线索、变更路径等元数据及少量未跟踪文本文件摘录；详见仓库内 AI 归类说明。
- AI 生成提交信息：提交区 sparkles 图标根据已暂存改动的 diff 与最近提交标题草拟信息，只写入可编辑框，不自动提交；详见 AI 生成提交信息说明。
明确不覆盖的能力¶
提交历史、分支切换、stash、rebase、冲突解决等需用其他 Git 工具；二进制文件无逐行 diff，部分类型不支持按变更块操作；变更列表过大时会截断并禁用全选与提交。
安装与启用¶
推荐在 DSH 桌面端「插件」页从 npm 包安装，包名为：
@acanzaima/dsh-code-review
步骤：
- 打开 DSH 桌面端，侧栏进入插件。
- 点击添加插件，在「包名或地址」填入
@acanzaima/dsh-code-review，点击安装。 - 安装后点立即启用；若已关闭对话框，在已安装插件中打开开关。
- 回到对话，输入框工具行出现「打开 Code Review」即成功；若没有，重启一次 DSH。
升级：先在插件页卸载旧版，再安装新版。跟进源码或排障时，可向插件页填入克隆目录或 Releases 解压目录的绝对路径（含 package.json 的一层）安装；资料写明源码包已含构建好的客户端文件，无需自行安装依赖或构建。
典型用法¶
- 在对应 Git 项目的 DSH 对话中，点击输入框工具行的 Code Review 图标（悬停「打开 Code Review」）。
- 左侧选文件看 diff，可搜索或跳转变更。
- 勾选文件或分组加入暂存区；取消勾选仅移出暂存，不改文件内容；列表顶部全选只作用于当前筛选结果。
- 展开底部提交区，填写提交信息并提交；需要同步远程时再点「推送」。可用 sparkles 按已暂存改动让 AI 草拟提交信息，确认或修改后再提交。
窗口内按 ? 查看快捷键；Esc 关闭菜单或对话框，审阅窗口用标题栏关闭。多窗口时可用标题栏「最小化」收成带仓库名的标题条，点向上箭头恢复。
适用场景与注意¶
适合：在 DSH 会话内完成「看 diff → 部分暂存 → 提交 / 推送」闭环的开发者；希望减少在终端与对话之间来回切换、又需要真实仓库状态（非粘贴 diff）的场景。
注意：
- 插件在本机以 DSH 进程权限执行 Git 与可选 AI 调用；涉密项目建议关闭 AI 归类，并谨慎使用 AI 草拟提交信息。
- 社区目录 skillhub 插件页 与 GitHub 为独立信息源；DSH 生态强调「一切皆插件」，该目录站与 DeepSeek / 幻方无资料所述的官方从属关系。
- Issue、PR 与开发文档见仓库 README 及
docs/。
结尾¶
dsh-code-review 把当前对话工作区的 Git 未提交改动带进 DSH 界面：真实状态、并排 diff、细粒度暂存与还原，再到提交与推送，窗口不挡对话。安装包名 @acanzaima/dsh-code-review；更多说明见 目录页 与 GitHub 仓库。
