<!-- Last verified: YYYY-MM-DD | Current stage: — -->

# 踩坑记录

## API 集成

### <!-- TODO: 现象标题 -->
- **现象：** <!-- TODO -->
- **原因：** <!-- TODO -->
- **解决方案：** <!-- TODO -->
- **教训：** <!-- TODO: 可迁移到其他模块的规则 -->

## 前端

## 文件系统

## 进程生命周期

## 并发 / 性能

## 构建 / 部署
