🏗️ 第 05 阶段 · 项目工程化通用
进阶实战：把记账本重构升级
综合运用分支、测试、规范、自动化、发布，把记账本项目做一次完整工程化升级。
⏱ 60 分钟 · ☑ 6 个实操任务
本课任务
把你之前做的「记账本」（或任意一个旧项目）做一次完整的工程化升级。全程让 AI 干活，你负责下指令和验收。
术语提示：重构 = 在「功能不变」的前提下，把代码和结构整理得更好；分支 = 从主版本分出去的试验线。
第 1 步：开分支（10 分钟）
git checkout -b refactor
命令解读卡
这条命令在做什么：新建一条叫 refactor 的分支，并切过去。
| 部分 | 意思 |
|---|---|
git | 版本管理程序 |
checkout | 动作：切换分支 |
-b | 参数：新建（branch） |
refactor | 分支名字 |
第 2 步：补测试（15 分钟）
给记账本写一组测试，覆盖：添加账单、删除账单、按月汇总。写完跑一遍，把结果贴给我。
验收标准：测试全部通过（绿色）。
第 3 步：整理结构 + 写 README（10 分钟）
分析项目结构，按「一看就懂」的原则整理，并写一份 README：项目是什么、怎么运行、怎么测试。
验收标准：文件夹一眼能看懂，README 存在。
第 4 步：一键检查（10 分钟）
配置 npm run check，一键跑格式检查和测试，配好演示给我看。
如果 npm 装包慢，先运行：
npm config set registry https://registry.npmmirror.com🌐 需要代理或海外网络：npm 官方源在国外；用 npmmirror 国内镜像即可，不用代理。
验收标准：npm run check 一次通过。
第 5 步：合并 + 发布（10 分钟）
检查全部通过。把 refactor 合并回主分支，提交，然后发布新版本，告诉我新网址。
🌐 需要代理或海外网络：如果发布平台用的 Vercel，国内访问可能不稳定；建议用 Cloudflare Pages 发布，国内更稳。
第 6 步：验证（5 分钟）
用手机打开新网址，确认：能记账、能汇总、没有报错。再发给一个朋友试用。
每步验收标准速查
| 步骤 | 算完成的标志 |
|---|---|
| 开分支 | 终端显示已切换到 refactor |
| 补测试 | 测试全部绿色 |
| 整理结构 | 文件夹一目了然，有 README |
| 一键检查 | npm run check 通过 |
| 发布 | 手机能打开新网址 |
| 验证 | 收到至少一条真实反馈 |
卡住了怎么办
我在第 [X] 步卡住了：[描述现象 + 报错]。帮我解决，并用大白话解释原因。
下一步
做完这一步，你已经具备「正经做项目」的能力了。最后一课：结业清单和下一步方向。