Files
Genarrative/docs
lhk229 dee91b6889
Project CI / Repository checks (pull_request) Successful in 1m11s
Project CI / Frontend tests (pull_request) Successful in 3m6s
Project CI / Backend tests (pull_request) Successful in 3m52s
Project CI / Native shell tests (pull_request) Successful in 12m6s
布局 flush 不再等待封面链
flushProjectPersistence 显式关掉 queueProjectLayoutSave 内建的 fire-and-forget
封面分支,自己另起一份并在最后 await。于是每个 await flush 的调用方都被挂在
封面链后面:封面渲染要为每个可绘制图层取 signed URL 再 new Image() 加载,而
那个 Image 只有 onload/onerror,没有 timeout 也没有 AbortSignal,外层的
try/catch 只接得住 reject、接不住「永不 settle」。一张图不 settle,生成 POST
就永远发不出去。

这是「完美像素请求账本移出项目布局」把严格通道与普通 flush 合并成一条路径时
引入的回归——改动前 strict 分支在封面链启动之前就 return,两者是结构性隔离的。
图集拆分一直走非严格路径,暴露是既有的,但同源,一并解开。

必然发生的是延迟:封面签名含未量化的 viewport,而创建占位时会移动视口,所以
几乎每次完美像素都触发全量重渲染,而这些与服务端那个 409 前置毫无关系。可能
发生的是挂死:此时 finally 永不执行,图层锁与归属登记被永久持有,用户删掉占位
也没用——闸的另一半是静默 return,再点没有任何反应。

删除式修复:去掉 persistCover: false 覆盖、独立的 coverSave 与末尾的 await,
让封面回到 queue 内建的 fire-and-forget 分支。参数逐项等价,封面照存,只是不再
有人等它。未采纳加选项的方案,那会把同一问题留在图集拆分身上。

代价是 returnToProjects 不再等封面就跳转;该保护本就很薄——SPA 跳转不会打断
promise,真正打断它的是页面卸载,而 await 在 beforeunload 里同样救不了。

遗留:loadProjectCoverImage 里无界的 new Image() 仍是隐患,自动保存路径一样会
踩,本次只是把它移出生成链的关键路径。建议单开。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-08-05 12:43:40 +00:00
..
2026-07-17 21:03:15 +08:00
2026-07-27 18:28:26 +08:00

文档总览

docs/ 只把当前融合文档和仍在维护的专题文档作为实现依据。旧创作模板、旧创作入口及其专属服务文档仅保留为历史材料,不再要求继续实现或兼容。

必读入口

  1. Agent 工作入口与执行准则
  2. 当前产品与工程约束
  3. server-rs 与 SpacetimeDB 数据契约
  4. 平台入口与玩法链路
  5. 本地开发验证与生产运维
  6. AI 游戏创作项目开发工作台 PRD

团队长期约定、决策、流程和排障摘要统一从 项目记忆入口 读取。代码、当前融合文档与项目记忆冲突时,以代码和最新融合文档为准。

当前专题

图片编辑器与 Agent

后端与公开数据

后台、宿主壳与运维

测试与协作

历史文档边界

  • 旧创作模板、旧创作入口、旧运行态和旧素材生成方案不再从本页索引,也不再作为修复目标。
  • maincloud、旧 Node/Express/PostgreSQL/Go 后端和人工 spacetime --root-dir 口径均已废弃。
  • 历史文档不得覆盖当前融合文档、代码契约或 docs/project-memory/shared-memory/decision-log.md 中更新的决策。

命名规则

后续新增 Markdown 文档文件名使用 【标签名】中文标题-日期.md。历史文件不做无关批量重命名;本次涉及的旧文档可直接删除或在当前入口中取消引用。