Merge branch 'codex/backend-rewrite-spacetimedb' of http://82.157.175.59:3000/GenarrativeAI/Genarrative into codex/backend-rewrite-spacetimedb

docs/technical/PUZZLE_AGENT_LLM_REPLY_INTEGRATION_2026-04-23.md

@@ -205,6 +205,20 @@
    - SSE 返回 `error`
    - 以前端重新拉 session 为准
 
+## 8.1 anchor pack 解析边界
+
+`nextAnchorPack` 是 LLM 输出契约的一部分，字段名固定采用前端与 prompt 侧一致的 `camelCase`：
+
+1. `themePromise`
+2. `visualSubject`
+3. `visualMood`
+4. `compositionHooks`
+5. `tagsAndForbidden`
+
+Rust 领域模型 `PuzzleAnchorPack` 仍保持 `theme_promise / visual_subject / visual_mood / composition_hooks / tags_and_forbidden`，不把 LLM 契约命名扩散到 `module-puzzle`。因此 `api-server` 的 `puzzle_agent_turn.rs` 必须在 LLM 边界显式把 `camelCase` anchor pack 翻译为 Rust 领域结构，再序列化给 SpacetimeDB finalize。
+
+验收补充：真实 LLM 返回符合本文 `nextAnchorPack` 示例时，不应再触发“拼图 anchor pack 解析失败，请稍后重试。”。
+
 ## 9. 实现清单
 
 1. `module-puzzle`