第 1 章 · 小紫工作台 Git 入门
本章目标：第一次在小紫 AI 工作台里正确打开 Git 项目；弄清 文件树色标、仓库菜单 各干什么；建立 SRX 改代码 → 审阅 → Git 提交 的正确顺序；团队协作用 GitHub 远程仓库，不把「本地仓库」当主线。
学时建议：3.5～4 小时（含 1.5 小时跟练）
前置：完成 quick-start ch04（打开项目）、quick-start ch07（Git 习惯预习）；已安装 小紫 AI 工作台 v5.4.35+ 桌面版（Windows / macOS / Linux 安装包，不是纯浏览器页）。
1.1 先建立直觉：Git 在工作台里解决什么问题
| 你遇到的麻烦 | 没有 Git | 有 Git + 工作台 |
|---|---|---|
| SRX 改了一下午，改乱了 | 只能依赖 时间线 一步步回滚 | 提交 到一个稳定点，整包回退 |
| 想给队友最新代码 | 压缩包、U 盘、微信传文件 | 推送到 GitHub，对方 拉取 |
| 不确定改了哪些文件 | 自己记 | 左侧 U / M / A / D 色标 一眼看见 |
| 上线前要有「这一版能跑」的记录 | 复制文件夹 v1、v2 | 提交说明 可搜索、可对比 |
本课只教你怎么在工作台里操作；底层同样是标准 Git，与终端 git 命令互通（后面章节会用到终端辅助，但不是主路径）。
1.2 重要纠正（与 quick-start 一致）
| 错误说法 | 正确做法 |
|---|---|
| 「文件 → 打开文件夹」 | 没有这条菜单 |
| 用 Ctrl+O 打开整个仓库 | Ctrl+O 只打开单个文件 |
| 找「源代码管理」侧栏图标 | v5.4.35 已移除独立 SCM 侧栏 |
| 只回滚 SRX 时间线 就算备份 | 时间线管 AI 步骤；协作必须 Git 提交 |
打开整个 Git 仓库，请用下面任一入口：
| 入口 | 操作 |
|---|---|
| 菜单（推荐） | 项目 → 打开项目 → 打开项目文件夹 |
| 欢迎页 | 中间 打开项目 卡片 |
| AI 区空状态 | 📁 打开项目文件夹 |
1.3 工作台里和 Git 相关的三块能力（别混）
┌─────────────────────────────────────────────────────────┐
│ ① 文件树 Git 色标 日常：改了啥、保存后状态更新 │
│ ② GitHub 远程仓库 团队：克隆、推送、拉取、分支 │
│ ③ 本地仓库（选修） 本机快照，不能替代 GitHub 协作 │
└─────────────────────────────────────────────────────────┘| 能力 | 您在哪里看到 | 什么时候用 |
|---|---|---|
| ① 色标 | 左侧资源管理器，文件名旁 U / M / A / D | 每天改代码 |
| ② GitHub 菜单 | 顶栏 仓库 → GitHub 远程仓库 | 克隆、提交、推送、分支 |
| ③ 本地仓库 | 顶栏 仓库 → 本地仓库 | 离线练手；团队项目勿当主线 |
v5.4.35 更新说明里的 「Git 版本管理」 主要指 ① + ② 的暂存、提交、色标、改动对比。
1.4 跟练：第一次打开 Git 项目（逐步）
准备：一个含 .git 文件夹的目录（没有的话 ch02 会 初始化仓库；有 shop-demo 更好）。
步骤 1
顶栏点击 项目 → 打开项目。
步骤 2
在对话框选 打开项目文件夹（不是「打开项目文件」）。
步骤 3
选中 仓库根目录（目录里能看到 .git），确认。对话框标题类似 选择项目文件夹。
步骤 4 — 验证成功
| 您应看到 | 若不对 |
|---|---|
| 左侧出现完整目录树 | 可能只打开了子文件夹 → 重新选根 |
| 不再是「暂无文件」 | 路径选错或空目录 |
步骤 5 — 制造一个改动
打开 README.md（或任意已跟踪文件），加一行字，Ctrl+S 保存。
步骤 6 — 看色标
| 角标 | 大致颜色 | 含义 |
|---|---|---|
| U | 绿色系 | 新文件，Git 还没跟踪 |
| M | 黄色系 | 已修改，尚未提交 |
| A | 绿色系 | 已暂存，待提交 |
| D | 红色系 | 已删除 |
文件夹名也可能随内部变更变色。保存后稍等，色标会自动刷新。
若完全没有色标：十之八九是 没选含 .git 的根目录——回到步骤 3。
1.5 跟练：认识顶栏「仓库」菜单
鼠标移到顶栏 仓库（不要点别的菜单找）。
您应看到两大块（名称以界面为准）：
A. GitHub 远程仓库（协作主线，后面章节默认用这个）