（求加精！）节拍前夜开发周报 — 2026 第 14 周（3/30 - 4/05）
04/0730 浏览开发日记
节拍前夜 · 第 62-68 天 · v1.24.0 → v3.4.7
一句话总结
十二律系统从零到交付的史诗一周：
设计文档→数据层→UI 层→验收→收尾，外加 Gitee 推送事故和 FSC 编辑器架构两代进化。
本周成果
十二律系统（本周核心）
设计阶段（4/01 夜）：
十二律盘入场动画设计方案
钉选（Pinned）词条核心概念
词条 UI 标签方案：关键词字典 + 二级释义浮窗 + 卡牌/图标双形态
商店调音方案：基调可移除、永恒词条、阶梯定价
四篇附录合并为完整设计文档
数据逻辑层（4/01 夜→4/02 晨）：
SkillData 扩展：基调标记 + 关键词字典
GameRun 十二律槽位上限（skillSlotCap）
DrawActiveSkills 抽取算法
调音移除逻辑（基调反转 + 阶梯定价）
SIEngine / SIPreview 查询重定向至 activeSkills
DevTest 集成十二律开关 + 槽位上限滑块
UI 层（4/02 晚）：
TuningModal 调音弹窗交互组件
SkillCardWidget 统一卡牌组件（多场景模式 + 关键词彩色渲染）
KeywordTooltip 二级释义浮窗
SkillTooltipWidget 关键词渲染接入
TwelveToneDiskWidget 入场动画组件
ShopScreen / RewardScreen 接入统一 SkillCardWidget
技艺商品改为竖向卡牌展示
验收（4/03 - 4/05）：
Issue #1-17 全部处理（修复 16 项 + 1 项用户确认不改）
幽影重构：敌方技艺接入 activeSkills + 对称展示
调音旦结构重写
路线图 v5 大规模重组
FSC 编辑器进化
v1.24.0 全屏幕实时刷新 + 字体默认值固化 + COMBO 图层提升
v1.24.2 静默重建机制（时间防抖 0.25s + 编辑器自动恢复）
v1.25.0 BindWidget 就地更新机制——从"暴力重建整棵 UI 树"进化为"精准通知相关 widget"
Bug 修复
BUG-63~65 十二律验收中的 UI/逻辑修复
BUG-66~68 十二律默认开启、关键词内联化、调音底图变形
BUG-69 战斗技能按钮 bounce 手感修复（跨 3 个会话追踪，根因：键盘路径绕过 OnPointerDown）
技艺按钮容器宽度 +50→+70 解决鸣描述换行
存档恢复覆盖 enableSkillSlotCap 修复
其他
Gitee 推送事故（4/03） — 在 /workspace/ 直接 push 导致 250MB assets 上传，仓库膨胀到 735MB。事后写入推送准则和操作手册
新项目配置指南 v6.0→v7.0（辩证改版 + 一键部署脚本）
本周数据
| 指标 | 数值 |
|------|------|
| 开发天数 | 6 天（约 26 小时） |
| 版本跨度 | v1.24.0 → v3.4.7（含版本号体系切换） |
| 代码变化 | 约 +2800 / -900 行 |
| 项目总量 | 56,153 行 Lua 代码（113 个文件） |
| 新增组件 | 6 个（TuningModal、SkillCard、KeywordTooltip、TwelveToneDisk 等） |
| 设计文档 | 4 份 + 1 次全文整合 |
本周踩的坑
- FSC 静默重建的"编辑器消失"问题 — 重建 UI 树时编辑器自身被销毁。解决：重建末尾自动重新打开编辑器并恢复角色。之后进化为 BindWidget 精准通知，彻底告别全局重建。
- Gitee 推送事故（第二次 git 事故） — 和 3/25 的 filter-repo 事故根因相同：大文件与 git 操作未隔离。立了更严格的推送准则：clone 到 /tmp/ 隔离操作，assets/ 绝不推送。
- 验收"二次返工" — Issue #8-12 第一轮修复只覆盖 happy path，边界情况（0/nil/空）遗漏。教训：修 bug 时多问一句"极端值会怎样"。
- bounce 手感 BUG 跨 3 个会话 — 表象是"按钮不弹"，前两个会话在 bounceTimer 和 disabled 状态上打转。第三个会话才发现根因：战斗里走的是键盘快捷键路径，根本不经过 OnPointerDown。教训：当合理假设都对不上时，退一步问"这个函数有没有被调用过"。
本周心得
这是节拍前夜开发以来最密集的一周。十二律系统从一个模糊的想法到可验收的完整功能，6 天走完了设计→实现→验收的全流程。
回头看，4/01 的通宵是转折点——7 个小时写完设计文档 + 数据层，第二天晚上 2.5 小时就撸完了 UI 层。设计文档不是浪费时间，是给后续实现写"说明书"。
FSC 编辑器的架构也在本周内经历了"暴力重建→防抖优化→精准通知"的三代进化。有时候第一版就是要先写个"能跑但丑"的方案，跑起来才能看清正确的架构。
两次 git 事故（3/25 filter-repo + 4/03 push assets）终于让 git 安全准则变得足够严格了。代价不小，但教训深刻。
节拍前夜 · 第 14 周周报
开发工具：TapTap Maker + tarara Code