闭关总纲：路线 · 每日执行 · 学习法

你不是零基础（C/C++ → Delphi → Qt → ThinkPHP → Vue3 → 学过 Java），缺的是"单主线下的系统性训练"。所以本系列不按教科书顺序铺开，而是按"让你最快定型"的顺序组织。

1.1 闭关规则（写在最前面）

• 不跳出教程：每个模块都是"最小必要理论 + 照做步骤 + 完整代码 + 常见报错"。卡住了先看该模块的"常见报错"表；还不行就按 §6 的 AI 工作流把报错原文喂给 AI。
• 版本不纠结：本系列所有版本已锁定（见 09 版本总表），教程里出现的每个版本号都是让你照抄的，不是让你选择的。
• 动手优先：每天至少 2/3 的时间在敲代码，不是在读教程。理论只读到"够用"，深度靠阶段三、四补。
• 沉淀优先：每完成一个功能，先问"这属于四件套的哪一件"，写进资产库（§5），再继续。
• 验收才算完成：每个模块和里程碑都有验收标准（§4、§9），不达标不进入下一阶段。

1.2 三条阅读路径

这是 07 报告 §5.1 四阶段路线的执行版。阶段边界与报告一致，内部细化到周；每一行都挂到具体模块与验收。

2.1 52 周总表（何时读哪个模块）

弹性规则：表是骨架不是枷锁。某周提前完成就提前进入下一周内容；滞后超过 2 周就砍"可选项"（13 Flutter 顺延、14 减为脚本级）保主线，不要砍主线本身。唯一硬纪律：每个里程碑验收通过才能继续。

每天 4 小时是保底盘。模板把"理论 / 编码 / 项目 / 沉淀 / 复盘"做成固定节奏，避免"打开电脑不知道干什么"。

3.1 工作日主模板（4 小时）

3.2 扩展盘（想加到 6 小时）与周末盘

3.3 每周节奏与每日自查

• 周节奏：周一至周四推进主线模块；周五"验收日"（跑本周验收标准）；周六资产与梦想基金；周日复盘规划。
• 每日自查 5 问：①今天敲了多少行真实代码（≥200 行才合格）？②今天有没有把东西沉淀进四件套？③今天的代码过测试了吗？④版本动过吗（动了就违反纪律，除非命中升级三条件）？⑤明天第一个动作是什么？
• 连续 2 天答不上 ①或③ → 降速：回到当前模块的"照做编码"环节重敲一遍，不要往前赶。

"最快时间定型、真正充实起来"的抓手是里程碑，不是感觉。前三个里程碑全部在 8 周内完成，之后进入 12 个月长线。

三里程碑的意义：M1 治"空虚感"（你有真实跑通的系统了）；M2 治"低效重复"（从此新项目起步即复用）；M3 治"业余味"（工程纪律上身）。三个都过，你就有资格进入阶段三的企业级模式了。

07 报告 §5.2 的洞察：沉淀的不是代码，是架子 + 模式 + 片段 + 手册。下面是可直接照抄的目录与规则。

5.1 资产库目录模板（建在 ~/assets，git 仓库管理）

assets/
├── scaffolds/                    # ① 架子：可直接 fork 的骨架仓库
│   ├── go-scaffold/              #    Go 后端骨架（11 模块产出并持续完善）
│   │   ├── cmd/server/main.go
│   │   ├── internal/ (config/log/db/model/handler/middleware/router)
│   │   ├── go.mod / go.sum       #    锁文件 = 版本唯一事实来源
│   │   └── README.md             #    版本表 + 启动说明
│   └── vue3-template/            #    Vue3 前端骨架（12 模块产出）
├── patterns/                     # ② 模式：一份 md + 最小可运行 Go 片段
│   ├── rbac.md
│   ├── transaction-and-idempotency.md
│   ├── graceful-shutdown.md
│   └── ...
├── snippets/                     # ③ 片段：喂给 AI 的弹药（可复用函数）
│   ├── jwt-auth.go
│   ├── pagination.go
│   ├── cache-aside-redis.go
│   └── ...
└── playbook/                     # ④ 手册：运维与版本基线
    ├── deploy-vps.md             #    systemd / nginx / 备份脚本（20 模块）
    ├── mysql-playbook.md / pg-playbook.md / redis-playbook.md / sqlite-playbook.md
    └── versions.md               #    每类项目的版本表

5.2 沉淀规则（每天执行）

07 报告 §5.3 的结论落地为可执行流程：AI 是实现者，你是契约制定者 + 评审者 + 调试者 + 部署者。每个功能单元走五步。

6.1 五步执行流程（每个功能单元）

6.2 版本注入：治"AI 写出旧版本"（三条铁律）

• 锁文件注入：每次对话把 go.mod / go.sum / pnpm-lock.yaml / pubspec.lock 喂给 AI，要求"只准用项目里已有的版本"。
• 项目根目录写 CLAUDE.md / AGENTS.md：写死版本与风格约束（模板见下），AI 每次开工先读。
• 真跑通才算完：AI 生成的代码必须对着你锁定的版本真实构建 + 测试通过，才算完成。AI 说"建议升级到 XX"= 默认拒绝（除非命中 §7 升级三条件）。

CLAUDE.md / AGENTS.md 模板（W2 里程碑 M2 时写入项目根目录）

# 项目约束（AI 每次开工必读）
- Go 版本：1.27.x（锁 go.mod，禁止自动升级）；依赖只准用 go.sum 里已有的版本
- Web 框架：Gin v1.12.x；ORM：GORM（gorm.io/gorm v1.31.x 线）；SQLite 驱动：glebarez/sqlite
- 代码风格：gofmt + golangci-lint v2 配置；错误必须显式处理（禁止吞 err）
- 测试：新功能必须带测试；先提交失败测试再实现
- 交付定义：`go build ./... && go test ./...` 全绿才算完成
- 禁止：擅自升级依赖版本；擅自改 spec.md 的接口契约；用教程外的"新框架"替换现有栈

6.3 调试纪律（不让 AI 瞎试）

• 自己先定位：日志（slog）、pprof、Delve 调试器、本地复现——你的 C/C++ 功底在这里派上用场。
• 打包证据给 AI：精确错误原文 + 复现步骤 + 相关日志，要求"给出一个基于证据的诊断，而不是三个猜测"。
• 先写复现测试：让 AI 写一个能复现 bug 的失败测试再修，测试绿了才叫修好。
• 纠正两次仍错 → 清上下文：把教训写进新提示词，不在污染会话里反复试。

07 报告 §5.4 的七条规则，这里给操作化步骤。版本纪律的目标：这个项目用什么、为什么、何时升，一次写死，不再纠结。

7.1 规则速查（七条）

7.2 README 版本表模板（每个项目复制一份）

# 版本表（本项目的唯一事实来源，2026-10 冻结）
| 组件        | 锁定版本            | 锁文件             | 上次评估 | 升级条件命中? |
|-------------|---------------------|--------------------|----------|---------------|
| Go          | 1.27.x              | go.mod + go.sum    | 2026-10  | 否            |
| Gin         | v1.12.x             | go.sum             | 2026-10  | 否            |
| GORM        | v1.31.x (v2 API)    | go.sum             | 2026-10  | 否            |
| SQLite 驱动 | glebarez/sqlite     | go.sum             | 2026-10  | 否            |
| Vue3        | ^3.5                | pnpm-lock.yaml     | 2026-10  | 否            |
| Vite        | ^8.3                | pnpm-lock.yaml     | 2026-10  | 否            |
| Node        | 24 LTS              | .nvmrc             | 2026-10  | 否            |
# 升级流程：命中三条件 → 改锁文件 → 跑全量测试 → 更新本表 → 提交

7.3 每半年评估流程（30 分钟）

1. 查安全通告（GitHub Dependabot / 官方 advisory）；
2. 对照 09 版本总表，看锁定版本是否仍在"支持窗口中点"；
3. 命中规则 4 任何一条 → 走升级流程；否则全部保持；
4. 把结论写进 playbook/versions.md，记入技术债清单。

全部 12 个模块（+本页=13）。每个模块独立成册、离线可读、可单独打开。生产顺序已按路径 A/B 排好。

8.1 四数据库在"你的场景"里的分工（先记住这张表）

复制到你的日程本，或存成 playbook/checklist.md。每过一项打勾；三项不过，回到对应模块重修。

完整版（含全部工具、来源 URL、核验说明）见 09 环境搭建与版本清单。这里只放主线核心，方便速查。

来源表

（编者整理：本页 12 个月路线、每日模板、里程碑、验收清单为基于 07 报告的执行化设计，无外部独立来源。）