docs: record game audio client main integration

This commit is contained in:
2026-09-21 16:38:54 +08:00
parent 1841bafb18
commit e3a480964d
5 changed files with 87 additions and 7 deletions

View File

@@ -1,5 +1,21 @@
# Data Flow
## Game Audio generation and local delivery
Project-enabled optional bundled Game Audio → frozen eligible parent tool → one explicit
generation confirmation → Main durable pre-submit receipt → fixed Works Square hosted API.
Main queries the original execution internally, then saves every output beneath
`assets/generated/game-audio/<executionId>/` in the frozen original project. A lost POST
response uses operation lookup; restart, account reconnect and download retry never submit
another generation. The shared project write lease covers materialization/tracker only,
not network waiting. Provider/billing status and local delivery status remain separate.
The conversation card displays saved relative paths. An explicit preview click uses the
receipt/account-owned Main route and existing bounded local media reader, then native
audio controls with no autoplay. No Provider credential, URL, job ID or audio payload is
sent to the model. Server migration 0093 and enabled authoritative prices are deployment
prerequisites; synthetic media tests are not real Meowa acceptance.
## Code conversation metadata
Main 的 `.makelore/conversations.json` schema v2 是 Conversation 标题和归档状态的唯一权威。新建自动命名会话由 Main 生命周期订阅从首条真实、完整用户消息提取标题;未命名会话的历史 hydration 可补齐同一次命名。串行存储重查 `titleMode` / `autoTitleSet`,手动命名和已删除记录不会被后续事件覆盖。内部命名字段不进入公共 DTO,也不向 Pi session title 双写。