下载工作台
SRX-V7 编程教学

审阅条与多文件改仓

试读上半部分 · 解锁后可读全文

第 3 章 · 审阅条与多文件改仓

本章目标:把 审阅条 练成本能——逐文件看 diff、✓ 接受 / ✗ 拒绝、理解 全部保留 的风险;掌握 多文件改仓 的范围控制与 Git 安全网;知道审阅条没有什么功能(避免找错按钮)。

学时建议:3~3.5 小时(含 1.5 小时跟练)

前置srx-v7 ch01~ch02(会发 SRX 任务);git-collab ch03(暂存提交)建议已读。


3.1 场景说明:一次 SRX 改了 8 个文件,你点错了

Leader 的原话:

「SRX 可以快,但落盘是你的签字。审阅条不是形式主义——点全部保留之前,每个文件至少扫一眼。」

本章用 单文件 → 多文件 → 故意拒绝 三次跟练,让你建立「拒绝比接受更安全」的肌肉记忆。


3.2 学完你能

能力验收
审阅流程等审阅条 → 点文件名 → 看 diff → ✓/✗
快捷键预览里 Ctrl+Enter 接受、Esc 取消
多文件任务写清范围;单次建议 ≤6 文件
Git 网改前 status clean 或已 commit
边界知无「全部拒绝」、无 hunk 编辑按钮
纪律不盲点「全部保留」

3.3 审阅条是什么、为什么存在

SRX 改完代码后,不会直接静默写盘。改动先进入 审阅条(执行面板底部区域),等您确认后才落盘。

SRX 生成改动 → 审阅条(待确认) → 您 ✓ → 写入磁盘
                              → 您 ✗ → 丢弃该文件改动

这是 SRX 的质量闸门——相当于代码负责人 Review 通过才 merge(对照 git-collab ch09 PR Review,审阅条是本地第一道关)。

发送任务后常见提示:SRX 任务已发送,请关注审阅条


3.4 审阅条界面说明

元素含义
标题 N 个文件本次共改几个文件(超过 4 个可能默认折叠,可展开)
文件名列表点击打开 diff / 行内预览
接受该文件改动(落盘)
拒绝该文件改动(丢弃)
全部保留批量接受当前待确认改动
Review有待预览时出现,进入审阅流程

通知区常见文案:

  • 审阅 · 已落盘 / 已接受 / 已拒绝 / 已接受全部待确认改动

3.5 逐步审阅(推荐流程,逐步跟练)

步骤 1 — 等待

  • SRX 执行结束,审阅条出现
  • 先看 几个文件——若超出预期,优先 Whole files 或 停止 后重写任务范围

步骤 2 — 逐个打开

  • 点击文件名
  • 主编辑器显示 红/绿行内 diff

预览提示常类似:

请在主编辑器查看红/绿行内差异并确认(Ctrl+Enter 接受 · Esc 取消

步骤 3 — 单文件决策

判断操作
改动正确审阅条 ,或预览 Ctrl+Enter
改动不对审阅条 ,或预览 Esc
大体对、差一行可先 再手工改;或 后让 SRX 重做(更干净)

步骤 4 — 全部看完再考虑「全部保留」

  • 仅当每个文件都已看过且都 OK
  • 新手建议:永远不用全部保留,习惯逐文件 ✓

步骤 5 — 落盘后

  • Ctrl+S(若未自动保存)
  • Git 暂存 → 提交git-collab ch03
  • 运行任务里写的 验收(测试、curl、页面点一遍)

3.6 跟练 A:单文件 ✓ 与 ✗(必做)

  1. 打开小项目(ch01 仓库根)
  2. SRX 任务
【目标】给 README.md 加一行:「ch03 审阅练习 A」
【范围】仅 README.md
  1. 审阅条应 1 个文件
  2. 第一次:故意点 ✗ 拒绝 → 打开 README,应无新行
  3. 再发同样任务 → ✓ 接受应有新行

你应该看到:拒绝 = 磁盘不变;接受 = 内容写入。


3.7 跟练 B:多文件 + 范围控制(必做)

步骤 1 — Git 干净(ch09 绝学 1)

git status   # clean 或先 commit
git checkout -b try/ch03-review

步骤 2 — 任务(控制 2~3 文件)

【目标】README 增加「模块说明」小节;docs/guide.md 增加一行链接回 README
【范围】只改 README.md 和 docs/guide.md(若 guide 不存在可新建)

以下内容需解锁后阅读

试读已结束。解锁本章 ¥5.00,或开通年度会员畅读全部教程。
年度会员 ¥199.00/年; 小紫 AI 工作台有效会员 ¥99.00/年

正文仅在服务端鉴权后下发,未付费无法获取下半部分内容。