通用变更审查

本地、只读的 Git 变更审查工具，适用于 Codex、Claude Code、Cursor 以及任何兼容 MCP 的客户端。0.4 版本新增了一键式 Changes 入口点：一个 Cursor 活动栏扩展和一个适用于兼容 Codex/ChatGPT 主机的 MCP Apps 启动器卡片。

它提供完整的工作区差异、暂存/未暂存视图、文件级检查以及任务范围快照，仅隔离任务开始后所做的更改。审查工具绝不会修改源文件和真实的 Git 索引。

要求

• Node.js 20+

• Git 2.30+

• 一个 Git 仓库

工具

当客户端支持 MCP 提示时，MCP 服务器还暴露两个可复用的提示：

任务快照使用临时 Git 索引，并仅在 .git/universal-change-review/ 下存储 Git 树 ID 及元数据。不会捕获被忽略的文件。不会上传任何源代码。

Codex

克隆仓库，注册其市场，然后安装插件：

git clone https://github.com/IP-DZ/universal-change-review.git
codex plugin marketplace add ./universal-change-review
codex plugin install universal-change-review@ip-dz

Codex 包包含 change-review 技能、UI 元数据、启动提示、MCP 服务器定义以及一个 MCP Apps 启动器卡片。使用 $change-review 显式调用该技能，或要求 Codex 打开当前 Changes。兼容的主机会显示一个可点击的 Open Changes 卡片；其他主机则会收到相同的 localhost URL 文本。

Claude Code

从仓库安装为 Claude Code 插件，以获取其技能和 /review-changes 命令，或直接添加 MCP 服务器：

claude mcp add universal-change-review --scope user -- npx -y github:IP-DZ/universal-change-review mcp

Cursor

为获得最接近 DSH 风格的体验，请安装捆绑的 Cursor 扩展：

npm run build:cursor
cursor --install-extension dist/universal-change-review-cursor-0.4.0.vsix --force

重新加载 Cursor 后，点击底部状态栏的 Changes Review，或使用 Changes Review 活动栏图标。该扩展会自动跟随第一个打开的工作区，并在 Cursor 编辑器标签页中打开实时面板。它运行的是扩展内部捆绑的相同本地只读面板代码。

对于项目范围的设置，将 .cursor/mcp.json、.cursor/rules/change-review.mdc 和 .cursor/commands/review-changes.md 复制到项目中。然后在 Cursor 聊天中使用 /review-changes。

对于全局 MCP 设置，将此服务器合并到 ~/.cursor/mcp.json 中，不要替换现有条目：

{
  "mcpServers": {
    "universal-change-review": {
      "command": "npx",
      "args": ["-y", "github:IP-DZ/universal-change-review", "mcp"]
    }
  }
}

Cursor 的全局 MCP 配置使这些工具在每个仓库中都可用。Cursor 规则和自定义命令是项目范围的，因此将提供的规则和命令复制到需要引导工作流的仓库中。

推荐工作流

1. 在执行重要任务之前，让代理启动一个变更基线。

2. 实现并验证所需的行为。

3. 根据客户端运行 $change-review、/review-changes 或 MCP 的 review-changes 提示。

4. 按 P0-P3 严重性顺序审查发现项，然后是变更的行为、验证和剩余风险。

实时 Changes 面板

要求代理“打开 Changes”，调用 changes_open_panel MCP 工具，或运行：

npx -y github:IP-DZ/universal-change-review web --cwd /path/to/repo

返回的 localhost 页面提供实时文件计数、全部/暂存/未暂存过滤器、任务基线选择以及逐行文件差异。它仅绑定到 127.0.0.1，使用随机访问令牌，并且不暴露任何写入或还原端点。

CLI

直接从 GitHub 运行：

npx -y github:IP-DZ/universal-change-review summary --cwd /path/to/repo
npx -y github:IP-DZ/universal-change-review begin --cwd /path/to/repo --label feature
npx -y github:IP-DZ/universal-change-review since --cwd /path/to/repo --id SNAPSHOT_ID

安全性

• 不暴露任何撤销、重置、检出、提交、推送或文件写入工具。

• 工作树和真实 Git 索引不会被修改。

• 快照捕获会在 .git 内写入正常的 Git blob/tree 对象和元数据。

• 差异输出默认有上限，并且可以限制为单个文件。

• 客户端在启动第三方 MCP 服务器之前仍应请求用户批准。

开发

npm test
npm run check
npm run build:cursor

MIT © IP-DZ