Skip to content

Diff 审查 ​

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

看哪几类 diff ​

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

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

审查重点 ​

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

CLI 和 VS Code 用法 ​

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 自查提示词 ​

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

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

微信公众号微信公众号:山川软件