Files
Genarrative/docs
lhk229 ef1807e350 同步专题文档中已被推翻的完美像素契约
近五个提交连续翻转了多条前端契约,但只追加了 decision-log。专题文档是这些
条目自己声明的「关联文档」,其中仍写着旧契约,按它做验收会把当前正确行为
判成缺陷。

更正:请求快照写入占位并 flush 布局 → 账本写本机、布局只留 marker;strict
layout save 预算与 revision ACK 前 POST 为零 → 通道已删除,改 best-effort,
并写明服务端要求占位此前已持久化否则 409、客户端无法证明只能提高概率;
窗口从快照写入起算 → 从 POST 发出时刻起算;POST 前必须取得保存成功确认
→ 保存失败不再让 POST 为零;未收口 operation 不可删除、durable operation
不得被普通删除路径清理 → 任何状态可删且不弹确认。

新增不变式:标记与账本寿命必须对齐,收口态不写标记也不判无效;账本读不到
时只有未收口占位收口成可删除失败态;恢复必须覆盖孤儿账本,孤儿走一次确定性
的读、不按 reconcileUntil 短路。

「普通按钮不得创建第二个 operation」保留为已知缺口而非静默删除:该保证只由
existingOperation 闸提供,而它只扫内存 dialog 列表,占位可删之后删掉再从源图
发起会产生第二个 identity。文档如实描述现状并标注闭合方向,代码侧未修。

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