Files
Genarrative/docs
lhk229 1d4d77ef3d
Project CI / Repository checks (pull_request) Failing after 13s
Project CI / Backend tests (pull_request) Failing after 14s
Project CI / Frontend tests (pull_request) Has been cancelled
Project CI / Native shell tests (pull_request) Has been cancelled
立项策划:落地 M1C-0 合入复核结论,三条 M1C-1 前置与一条哨兵订正
生产代码零改动(delegation.rs 三个 hunk 全在 mod tests 内),本次只补回归与文档。

复核确认「今天行为零变化」成立且可证:contract_status 生产赋值点只有两处且都从
客观事实派生;StaticDelegateClaimRecord 全仓库唯一构造点是运行时构造,不是 agent
提交的 JSON;durable sidecar 在 .agent/runtime/** 下被 file_ops 与 filesystem 各
三处拒写;前端无 contractStatus 消费者。lineage 三个 fail-closed 出口全部返回
(u32::MAX, u32::MAX),新分支的哨兵检查接得住。

三条 M1C-1 前置写进技术方案第 23.7、23.8 节与 decision-log:
① UserRevisionRequested 不进 repair_required_count / user_input_required_count
   任一 barrier,写入方落地即意味着 Supervisor run 可在用户修订未派出时完成;
② validate_static_delegate_structured_result 对该变体只有否定约束,缺正向一致性
   分支,UserRevisionRequested + failed + 缺产物 能通过校验落盘;
③ 前向兼容失败粒度是整个子系统——list_static_delegate_deliveries_at 逐条 ? 上抛,
   一条解析失败即整个目录枚举失败。bump schema version 救不了(版本校验在 parse 之后)。

文档订正:STATIC_DELEGATE_LINEAGE_MAX_HOPS = 32 限的是链上节点数不是跳数
(判据排在入链之前),真实跳数上限 31,第 23.7 节原写 32 跳已订正。

测试:
- static_delegate_user_revision_preserves_existing_clarification_round 名不副实,
  它把 UserRevisionRequested 放在目标位置,而计数循环只遍历父节点集合,新分支
  从未被执行。改名为 ..._parent_hop_preserves_depth_and_clarification_round,补
  一跳真正以用户修订为父的续跑并加反证;原断言留作对照组并注明性质。
- 新增 concurrent_user_revision_dispatch_creates_exactly_one_delivery,父节点为
  UserRevisionRequested 且 depth 已为 1,两侧同时钉住并发下恰好放行一条。
- user_revision_continuation_... 补兄弟检查断言(depth 门对用户修订失效后,它是
  该路径上唯一剩下的扇出约束)。

变异测试:摘掉 counters 分支 4 条变红(含新增反证 left (2,0) / right (1,1));
摘掉 gate 分支 3 条变红(并发用例 left 0 / right 1)。两处守卫各自有回归覆盖。

验证:定向 41 passed / 0 failed;npm run check:encoding 通过(5374 files);
git diff --check 干净。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-08-15 05:17:39 +00:00
..
2026-07-17 21:03:15 +08:00
2026-08-13 20:11:51 +08:00
2026-08-12 03:48:19 +00:00

文档总览

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

必读入口

  1. Agent 工作入口与执行准则
  2. 当前产品与工程约束
  3. server-rs 与 SpacetimeDB 数据契约
  4. 平台入口与玩法链路
  5. 本地开发验证与生产运维
  6. AI 游戏创作项目开发工作台 PRD
  7. AI 游戏创作智能体 App 实施计划
  8. 客户端素材创作无限画布阶段一合同

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

当前专题

AI 游戏创作与 Agent Runtime

图片编辑器与 Agent

后端与公开数据

后台、宿主壳与运维

测试与协作

历史文档边界

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

命名规则

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