25 · Git 工作流：Cursor 中的 AI 辅助版本控制

你写代码 → 你 git add → 你 git commit → 你 git push
你解决冲突 → 你写提交信息 → 你审查 diff

你写意图 → AI 辅助实现 → AI 生成提交信息 → 你审查 → 你 push
AI 分析冲突 → AI 提出合并方案 → 你批准
AI 分析 commit graph → AI 建议 rebase 策略 → 你确认

"完成了用户认证模块的 JWT 实现，包括 token 生成、验证和中间件集成。
同时修复了登录页面在移动端显示的布局问题。"

┌──────────────────────────────────────┐
│  Agent Review  │  Accept All  │ ✕   │
├──────────────────────────────────────┤
│  📁 src/auth/jwt.ts  (+45 -12)      │
│  📁 src/auth/middleware.ts (+23 -3)  │
│  📁 src/pages/login.tsx  (+8 -15)   │
├──────────────────────────────────────┤
│  ┌─ diff ──────────────────────────┐ │
│  │ - const secret = "hardcoded";   │ │
│  │ + const secret = process.env.   │ │
│  │                  JWT_SECRET;    │ │
│  └─────────────────────────────────┘ │
│  ┌─── AI 解释 ─────────────────────┐ │
│  │ 将硬编码的密钥改为环境变量读取，  │ │
│  │ 提高安全性。                     │ │
│  └─────────────────────────────────┘ │
└──────────────────────────────────────┘

feat(auth): 实现 JWT token 生成与验证机制

- 添加 token 生成函数，支持自定义过期时间
- 实现 token 验证中间件，集成到路由保护
- 修复移动端登录页面布局偏移问题
- 将硬编码密钥迁移至环境变量

Closes #142

// settings.json
{
  "git.commitMessageTemplate": {
    "format": "conventional",
    "scope": "auto",
    "includeFooter": true,
    "maxLength": 72,
    "language": "chinese"
  }
}

<<<<<<< HEAD
  const timeout = 5000;
=======
  const timeout = 3000;
  const retryCount = 3;
>>>>>>> feature/retry-logic

AI 分析结果：
- HEAD (当前分支): 超时时间 5000ms，无重试
- feature/retry-logic: 超时时间 3000ms，增加重试机制

建议方案:
  方案 A: 保留 HEAD 的超时 + feature 的重试
          const timeout = 5000;
          const retryCount = 3;

  方案 B: 使用 feature 的完整逻辑
          const timeout = 3000;
          const retryCount = 3;

  方案 C: 取折中值，增加配置化
          const timeout = 4000;
          const retryCount = 2;

你: "帮我 rebase 最近 5 个提交，把 fix typo 和 fix formatting 合并到前一个提交中"
AI: "好的，我将执行以下操作：
   1. pick a1b2c3d feat: 添加用户注册功能
   2. squash e4f5g6h fix: 修复 typo → 合并到 a1b2c3d
   3. squash i7j8k9l fix: 格式化代码 → 合并到 a1b2c3d
   4. pick m0n1o2p feat: 添加邮箱验证
   请确认是否继续？"

git branch backup/rebase-2025-07-03

# 依赖目录
node_modules/
.pnpm-store/
vendor/

# 构建产物
dist/
build/
.out/
.next/

# 生成文件
*.generated.*
generated/
protobuf/

# 日志和缓存
*.log
.cache/
.eslintcache

# 大型数据文件
*.csv
*.parquet
data/

# 测试报告
coverage/
test-results/

# Git 相关（无需 AI 索引）
.git/
.git-blame-ignore-revs

本地操作（AI 可执行）          远程操作（仅人类）
─────────────────────          ─────────────────
git add  ← 暂存变更             git push  ← 推送代码
git commit  ← 记录提交           git push --force  ← 强制推送
git stash  ← 暂存工作区          git tag --push  ← 发布标签
git branch  ← 管理分支           git push --delete  ← 删除远程分支
git merge  ← 合并分支
git rebase  ← 整理历史

你 → AI Agent: "实现用户登录功能"
AI: 生成代码，展示在 Agent Review Tab
你: 审查变更，逐行确认
你: 点击 "Accept All"
AI: 自动创建提交 (git commit)
你: 运行测试，确认无误
你: 手动 git push (或点击 Source Control 的推送按钮)

// .cursor/rules/push-allow.json
{
  "name": "允许 AI 推送",
  "description": "仅在特定分支允许 AI 推送",
  "git": {
    "allowPush": true,
    "allowedBranches": ["dev/*", "feature/*"]
  }
}

开发流程:
1. AI 开始任务前 → 自动创建 Checkpoint A
2. AI 完成第一批变更 → 自动创建 Checkpoint B
3. 你审查 → 接受部分变更
4. AI 继续 → 自动创建 Checkpoint C
5. 全部完成 → 你审查 → AI 创建 Git 提交
6. Checkpoint 在提交后标记为"可清理"

1. 你: "修复登录表单的邮箱验证，目前不校验@符号"
2. AI Agent 分析代码，修改验证函数，更新测试
3. Agent Review Tab 显示:
   - 📁 src/utils/validation.ts  (+5 -2)
   - 📁 src/tests/validation.test.ts  (+10 -0)
4. AI 解释变更:
   "在 validateEmail() 中添加了 @ 符号检查，
   同时确保域名部分至少有一个点号。"
5. 你审查 → 确认无误 → Accept
6. AI 自动创建提交:
   "fix(login): 修复邮箱验证未检查 @ 符号的问题"
7. 你本地运行测试 → 通过
8. 你手动 git push

1. 执行 git merge feature/notification
2. Cursor 检测到冲突文件: src/services/notify.ts
3. 点击 "Resolve with AI"
4. AI 分析:
   "冲突主要在两个函数:
    - HEAD: sendNotification() 使用 WebSocket
    - feature: sendNotification() 使用 Server-Sent Events (SSE)
    AI 建议: 保留 SSE 方案，因为它更适合当前的架构"
5. 你选择 "应用方案"
6. AI 自动解决冲突，清理标记
7. 你确认合并结果 → 提交合并

1. 你: "帮我整理 feature/checkout 分支的提交历史"
2. AI 分析 12 个提交:
   - 6 个有意义的提交（新功能、重构）
   - 4 个 fixup 和 typo 修正（应 squash）
   - 2 个 "WIP" / "debug" 提交（应 squash 或删除）
3. AI 提出计划:
   pick  feat: 添加购物车功能
   squash fix: 购物车数量计算错误  → 合并到上一个
   squash fix: 变量命名错误         → 合并到上一个
   pick  refactor: 抽离价格计算逻辑
   drop  debug: 临时调试代码        → 删除
4. 你确认 → AI 执行 rebase
5. 最终 8 个干净提交，可以推送

// settings.json
{
  "git.enableSmartCommit": true,
  "git.commitMessageTemplate": {
    "format": "conventional",
    "language": "auto"
  },
  "git.autoCommitAfterAgent": true,
  "git.autoFetch": true,
  "git.enableAbortOnConflict": false,
  "git.checkpoint": {
    "enabled": true,
    "maxCount": 50,
    "retentionDays": 7
  },
  "git.rebase": {
    "createBackup": true,
    "autoSquashFixup": true
  }
}