Files
Genarrative/docs
lhk229 9336deb5b8 记录完美像素跨会话续命层的存废条件
本分支相对 master 新增约 16758 行,测试占 45%,而像素规整算法本体只改了
100 行。体量几乎全部来自「这条链路没有 durable job」这一个架构选择。

按存在理由把客户端机制分三层并写进文档:A 层服务端正确性与是否有 job 无关,
保留;C 层 POST 后一次对账保护的是「结果未知却谎报失败」,属于主链路,保留;
B 层跨会话续命(本机账本、刷新恢复与孤儿对账、75 秒窗口与锚点、marker 与账本
寿命对齐、exact retry、inline 占位到期与归属登记)只因为没有 job 而存在。

现在不删 B 层——它刚写完刚测过刚修完六个缺陷,删除本身有风险,收益在未来。
但迁移到 enqueue_editor_generation_job 时必须整层清除、不得与队列并存,否则
两套收口机制会产生「谁是终态权威」的二义性。写为阶段 4 的验收条件。

一并记录支撑结论的实测:requiresLiveSession 全仓仅一处置位、claim/release/has
五个调用点全在完美像素路径,故整层删除边界清晰;以及七条复查发现里 F1-F6 六条
全部落在 B 层。

另记一条待办:图集拆分的 catch 只 alert「拆分图集失败」,不区分确定失败与网关
合成的未知结果,服务端已落库却报失败属于谎报,落在主链路一侧。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-08-05 11:31:38 +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。历史文件不做无关批量重命名;本次涉及的旧文档可直接删除或在当前入口中取消引用。