// 开始前 · 操作指引
你将体验什么？
这个互动页会带你走一遍项目的关键迭代：从搭骨架、接后端，到遇到构建阻塞再恢复。每一步都对应真实开发动作。
- 01阅读每个阶段说明，理解当时的真实决策
- 02点击底部按钮推进阶段，模拟一次完整迭代
- 03在“构建阻塞”阶段可以尝试点击重跑构建，你会看到为什么会失败
- 04“排障阶段”会自动播放关键操作，展示如何把系统拉回可运行状态
- 05最后会给出这轮迭代的结果和下一阶段方向
⚠ 全流程约 2 分钟。阻塞阶段会自动进入下一步，无需额外操作。
// 阶段一 · 起步搭建
先把“能访问”的前台
快速搭起来
项目起步时先追求可见结果：先让游客能访问首页、记录、计划、社区和 AI 页面，再逐步完善登录与数据联动。
目标很明确：先有可走通的产品路径，再做精修。
[ 首页框架已落地
[ 饮食记录页可交互
[ 计划页可演示
[ 社区页初版
[ AI问诊页入口打通
[ 路由壳层可导航
// 阶段二 · 后端接入与后台分流
功能开始“真正可用”
前端骨架有了之后，项目进入工程深水区：接入 Go Gin、补齐鉴权和角色分层，并把后台从前台中独立出来。
这一步之后，项目从“页面展示”升级为“可运营系统”。
“先打通登录与后台能力，再追求界面完美。”
管理员用户创建、密码重置、AI 设置中心与安全配置逐步到位。
“vite 正在构建... transforming... 然后静默退出。”
Windows 中文路径构建阻塞 · 倒计时复现
10
! 当前路径存在中文与括号组合
你看到日志时，进程可能已经 silent exit
你尝试直接重跑构建命令……
但结果还是中途退出
尝试再次直接构建 ——
失败：仍在原始路径执行，进程再次静默退出
这轮构建又失败了。
下一步进入排障动作，把环境先稳住。
// 阶段三 · 排障动作回放
不是猜测，按步骤修复
- ◈先确认问题不是业务代码回归，而是构建进程在特定路径下异常 —— 归因调整
- ◈使用 `subst` 映射短盘符，绕开路径兼容问题 —— 环境重定向
- ◈采用 hoisted linker 重装依赖，恢复稳定依赖结构 —— 依赖重建
- ◈复查 `optimizeDeps`，避免误伤 `element-plus -> dayjs` 链路 —— 白屏回归修复
- ◈再次运行 build 与 dev，页面恢复正常渲染 —— 构建恢复
✓
迭代恢复成功
环境稳定 · 构建可用 · 页面回归
- [ 构建静默退出已修复
- [ `dayjs` 链路误伤白屏已修复
- [ 主题切换不一致已收敛
- [ 前后台视觉混杂已分流
- [ 高风险配置不可运营已后台化
- [ 无明确恢复路径已沉淀文档
“先稳住环境，再判断业务回归。”
“每轮都要留下可复用的恢复路径。”
—— 本项目排障阶段的核心方法
当前项目已具备完整主路径：前台访问、用户登录、后台运营与 AI 配置。构建恢复命令与注意事项已写入 README，可重复执行并快速复现。
// 下一程 · 继续迭代
恢复构建之后，
项目怎么继续长大？
稳定不是终点，而是下一轮优化的起点。系统进入“可持续迭代”阶段。
- »社区页重做为现代信息流，视觉层次更清晰 —— 用户浏览效率提升
- ◆后台 AI 设置中心持续增强，知识库管理集中化 —— 运营动作更顺手
- ◉亮暗主题和前后台切换继续细化 —— 体验一致性增强
- ▲用户中心逐步去“后台味”，强调卡片与图表表达 —— 前台观感更现代
- ■后台可配置范围持续扩大 —— 减少改 `.env` 的操作频次
- ↑`site-v65` 改写成开发档案页 —— 项目叙事与工程事实对齐
- ◎后续继续小步推进并验证 —— 每轮都可落地、可复盘
从“能跑”到“好用”，再到“可持续运营”。
这就是这套项目正在走的开发之路。