---
title: Diff 审查
navTitle: Diff 审查
---
# Diff 审查

Diff 审查用于确认 AI 修改范围是否符合需求。正式项目中，推送测试、提交 Git 和发布生产前都应检查 diff。

## 看哪几类 diff{#types}

| Diff | 说明 |
| --- | --- |
| SuccApp 本地变化 diff | 本地文件相对服务器基线的变化，决定推送测试服务器的内容。 |
| SuccApp 远端变化 diff | 服务器相对本地 mirror 的变化，决定是否需要先拉取或处理冲突。 |
| Git diff | 本地文件相对 Git 版本的变化，决定提交和评审内容。 |
| 文件历史 diff | 当前版本与服务器历史版本的差异，适合排查回退和丢失修改。 |

SuccApp diff 和 Git diff 关注的问题不同，不能互相替代。

## 审查重点{#checkpoints}

1. 是否只修改了需求相关文件。
2. 是否出现无关格式化、大段重排或排序变化。
3. 是否误删目录级 `.meta`、资源文件或脚本。
4. 是否修改了稳定标识，例如字段名、组件 ID、数据集 ID、动作节点 ID。
5. 是否修改了权限、流程、数据范围、数据源或系统设置。
6. 是否包含 `.succapp/remote/`、缓存、日志、临时文件或未确认的 AI 草稿。
7. 是否有远端变化或冲突未处理。

## CLI 和 VS Code 用法{#usage}

CLI:

```bash
succapp workspace status
succapp workspace status --json
succapp workspace file diff path/to/file
git diff
```

VS Code:

1. 打开 SuccApp **变化** 视图。
2. 点击变化文件或选择 **与服务器版本对比**。
3. 打开 Git 视图检查 Git diff。
4. 对高风险文件查看服务器文件历史。

## AI 自查提示词{#prompt}

```text
请审查当前本地变化，按文件说明修改原因。
重点检查是否有无关格式化、误删、.meta 异常、稳定 ID 变化、权限/流程/数据范围风险。
不要继续修改文件。
```

AI 的自查结论只能作为参考，最终仍应由项目成员查看 diff。