Overview Version History Q & A Rating & Review
Change Review
English | 简体中文
一款轻量的 VSCode 审查插件：支持 git、svn 与无版本管理的工程，把本地改动列成清单，逐文件 review、打钩标记进度；点文件名进入 diff 审查面板，可按块接受 / 拒绝。
为 AI Coding 设计。Codex、DeepSeek、WorkBuddy、ZCode 等 AI 工具自带的审查能力参差不齐，混用更是麻烦——用 Change Review 对一个或多个 AI 生成的代码改动做统一审查。
特性
改动清单 ：状态（修改 / 新增 / 删除 / 重命名 / 未跟踪 / 冲突）、增删行数、来源类型；已审查文件排最后（可配置）。审查面板 ：独立 diff 视图，每个块悬停出现「接受此块 / 拒绝此块 / 跳转」，接受与拒绝均可取消。块内编辑 ：行内直接编辑（Tab / 回车拆合行 / Ctrl+S / Ctrl+Z / Ctrl+Y），也可跳转到文件编辑器直接改。排除规则 ：.crignore 语义与 .gitignore 一致；git 项目可省略 .crignore、直接沿用 .gitignore（.crignore 优先级更高，会覆盖 .gitignore）。多来源分组 ：多个 git / svn 仓库按来源分组展示；仓库根在打开目录之外时，只显示打开目录内的改动。双语界面 ：中英文随 VSCode 显示语言切换（changeReview.uiLanguage）。
三种来源自动探测（git → svn → 快照，可用 forceVcs 强制）：
来源
对比基准
说明
Git HEAD支持多仓库工作区
SVN BASE支持子目录工程
快照基准 手动建立
无 git/svn 的项目执行一次「初始化对比基准」，之后可更新
审查模型
接受 / 拒绝（文件级或块级）只是记录决定 ，不改文件。一个文件的所有改动块都有决定后，自动标记为已审查 ，真正的执行发生在标记那一刻：
接受的部分 → git 工程执行 git add，其余类型无变化；
拒绝的部分 → 还原到基准（git restore / svn revert / 快照写回），未跟踪文件删除；
「拒绝全部」为整文件还原。
手动「标记已审查」 ：git 下勾选 = git add，取消勾选 = git reset（工作区内容不动）。手动「取消审查」优先 ：取消后只要文件没再改，就不会被自动标记打回；文件改动后恢复自动标记。文件被再次修改 → 原打钩自动失效，需要重新审查。
安装
零依赖、无编译步骤（纯 JavaScript）。
npm run release # 打包，产物在 dist/（vsix + 源码 zip）
npm run install-local # 打包并装进本机 VSCode
或在 VSCode 扩展面板 ... → 「从 VSIX 安装…」选择 dist/ 下的 .vsix。开发调试：本目录按 F5。
使用
命令
命令
说明
刷新改动列表 / 聚焦改动列表刷新 / 跳转视图
进入审查模式打开该文件的审查面板
在编辑器中打开差异原生 diff 编辑器（基准 ↔ 工作区）
接受改动记录全部块为已接受并自动标记（git 工程同时执行 git add）
拒绝改动记录全部块为已拒绝并自动标记（随标记还原或删除文件）
标记已审查 / 取消已审查标记手动打钩；git 工程：勾选 = git add、取消 = git reset
全部标记已审查 / 全部清除已审查批量操作
下一个待审查跳到下一个未审查文件
初始化对比基准 / 更新对比基准快照基准项目的基准管理（基准存扩展存储，不写项目目录）
配置排除规则…打开设置并定位 changeReview.exclude
忽略该文件写入 .crignore，之后不再出现在改动列表
快捷键（视图聚焦时）
键位
说明
Ctrl+Enter进入审查面板
Ctrl+Shift+A / Ctrl+Shift+R接受 / 拒绝
Ctrl+Shift+M标记 / 取消已审查
Alt+N下一个待审查
macOS 上 Ctrl 对应 Cmd。
设置
设置
默认值
说明
changeReview.includeUntrackedtrue是否列出未跟踪的新文件
changeReview.sortReviewedLasttrue已审查文件排到最后
changeReview.autoRefreshInterval5自动刷新间隔（秒），0 关闭
changeReview.contextLines3diff 上下文行数
changeReview.showStatusBartrue显示状态栏徽章
changeReview.gitPath / svnPath空
可执行文件完整路径，留空自动探测
changeReview.uiLanguageauto面板语言：auto / zh / en
changeReview.forceVcsauto强制来源：auto / git / svn / snapshot
changeReview.vcsSearchDepth5向上查找 .git / .svn 的层数（上限 5）
changeReview.exclude[]手动排除（glob，相对项目根），对所有来源生效
changeReview.snapshotExclude[node_modules, ...]快照基准模式排除的文件
changeReview.snapshotMaxFileSize1024超过该大小（KB）的文件不保存内容做逐行 diff
changeReview.snapshotMaxFiles10000快照基准最多纳入的文件数
开发
测试
npm run selfcheck # 临时 git 仓库：改动统计 / diff 解析 / 块级还原 / 接受 / 拒绝
npm run vcscheck # 临时 svn 仓库 + 快照目录：多来源
npm run mockcheck # mock vscode API：树视图 / 徽章 / 面板主流程（支持 --only 场景名）
发版
版本号以 package.json 的 version 为准，打 tag 触发 CI 自动发版，tag 必须和版本号一致 ：
git tag v<版本号> && git push origin v<版本号>
已知限制
文件被改过导致块位置对不上时，块操作会明确报错提示刷新，不乱改。
删除状态的文件不支持按块操作；二进制文件只显示行数。
SVN 只处理文本改动；属性改动只影响状态列。
依赖系统 git / svn 可执行文件；快照基准内容存于扩展 globalStorage（大项目配合 snapshotExclude 等设置使用）。
