序列化热路径去重:to_dict 里重复求值的属性改局部复用

为什么:snapshot() 同时压在 SSE 每 250ms 推送和 full=1 动作回执两条
高频路径上,而它的成本大头是重复求值——profile 显示单次快照
1,128,001 次函数调用里近半是属性链重复计算同一份配置数据。

- Plot.to_dict:grow_days 原来经 4 个属性各求值一遍(本体 + days_left
  + is_ripe + stage),16 块地就是 64 次配置表查询。改为算一次局部
  复用;stage 的实现体拆到 _stage(grow),规则本体仍只有一份。
- Animal.to_dict:info 配置表原来查 4 次、cycle int() 两遍,改取一次。
- GameState.to_dict:weather_info 3 键 2 次查询;granary_free 原来把
  granary_capacity 和 storage_used 整个重算,改算一轮复用。

行为零变化(规则本体全在原属性里,532 项测试全绿)。
基准(tools/bench.py --repeat 5,最坏形态 16 地 + 8 牲畜):

    场景                       优化前      优化后
    engine.snapshot()          50.1 µs     44.2 µs      -12%
    session.snapshot()         51.0 µs     41.9 µs      -18%
    build_state_message()      50.9 µs     43.3 µs      -15%
    engine.available_actions   52.7 µs     48.7 µs       -8%

单次 snapshot 函数调用数 1,128,001 → 588,001(-48%),本次数字已记入
bench.py docstring 作长期参考。重复计数器全 OK(to_dict/snapshot/
net_worth 每请求仍各 1 次,无回归)。
This commit is contained in:
snowy-yang committed 2026-09-26 11:08:14 +08:00
1 parent 4bc7729715
commit a9bc8238ab
3 files changed
+63 -17

No files matched your search

+19
View File
@@ -59,4 +59,23 @@
- 测试 -2(AP 专属用例没了)改 5,532 项全绿;提交 15d290a 已推送。
真机:老库迁移 ✅、无行动点卡 ✅、倒计时 39:04→39:02 走秒 ✅。
## 2026-09-25 地图手感打磨(4bc7729)
- **动作粒子**:MAP.fx 数组,act() 成功后 mapJuice(action, params)——
地块号/牲畜 id 反查画布坐标喷粒子(重力+寿命衰减)+ 上浮表情浮字
(浇水💧播种🌱收获✨喂食🍽)。api() 失败返回 null 天然不触发。
- **昼夜色温**:dayTint(prog) 按一天进度叠半透明层(清晨淡金→正午无→
黄昏橙→入夜靛紫)。tick_seconds 只在完整快照里、brief 没有,
靠 refreshFromBrief 的 Object.assign 合并语义存活,兜底 2400。
- 成熟金光改呼吸式(sin 起伏 shadowBlur);悬停可交互对象指针变手型。
- 验收注意:粒子视觉链路可用 mapJuice 直接注入测(真动作要看地块状态
凑巧——全满时浇水会走失败路径,正好验证"失败不触发")。
- **沙箱进程回收边界(重要)**:WorkBuddy 会话里启动的进程都会被环境
回收——后台任务(跑 15m~1h 后静默死、日志无错误)、甚至
`--daemon` 的 DETACHED_PROCESS 守护进程(沙箱 Job 对象 kill-on-close
连 breakaway 进程一起杀)都活不长。**长期挂机必须让用户自己在系统
终端跑** `uv run main.py serve`(或 `--daemon`),那才是真正独立的进程。
会话内只做临时拉起 + 自动存档(60s 周期)兜底损失。