Fix/let bgm and sfx async #437

Merged

k88936 merged 9 commits from fix/let-bgm-and-sfx-async into master 2026-09-21 00:48:49 +08:00

Conversation 2 Commits 9 Files Changed 22

+1419 -457

9 Commits

Author	SHA1	Message	Date
k88936	f19a003dec	Merge branch 'master' into fix/let-bgm-and-sfx-async	2026-09-21 00:48:26 +08:00
k88936	04db93faab	给生成面板的「提交被拒 + 草稿归属」加 TODO（只留标记，不改行为） ... - `ResourceCanvasGenerationPanelView.submit()` 加 `TODO(resource-generation-panel-contract)`：说明 `onSubmit` 只返回 `void` 导致宿主同步拒绝时草稿没人接走的缺口，以及「`onSubmit` 回报受理结果、 只有受理成功才置位 `draftReleased` 并关闭」的修法 - `ResourceCanvasAssetGenerationPanelView.submit()` 加同名 TODO：图片类面板与音频面板是同一份 契约，要改一起改 - `index.tsx` 的 `submitResourceCanvasGeneration` 同步拒绝分支加同名 TODO：指向面板侧修法与 「这里改成 `return false`」的宿主侧动作	2026-09-21 00:29:55 +08:00
k88936	98e42e6dae	文档同步：音频无源生成的源媒体类型由 editKind 推出，不作为入参 ... - `docs/technical/【AGC】栏目画布底部工具栏入口矩阵-2026-09-13.md`：音频入口复用无源生成链路的措辞 从「传 `sourceMediaType: 'audio/mpeg'`」改成「源快照媒体类型由 `editKind` 推为 `audio/mpeg` （Create 模式不读该入参）」 - `docs/prd/【AI游戏创作】项目开发工作台PRD-2026-07-20.md` 第 7.9 节第 6 条同口径修正，避免文档继续 描述一个代码已经不传、也不会被读的参数	2026-09-21 00:21:07 +08:00
k88936	f2a3ba7aca	音频提交上下文按任务 id 各自留存，重叠提交不再互相覆盖 ... - `resourceGenerationAudioSubmissionRef` 从单槽改成按任务 id 索引的 Map（键是 task id，值里 不再重复存 taskId） - 提交写入改成 `set(task.taskId, …)`，收口读取改成 `get(settlement.taskId)` + `delete`，切项目 改成 `clear()` - 原先两条音频提交重叠时，后一次提交会覆盖前一条的提交上下文，前一条「后端从未受理」的即时 失败因此找不到自己的恢复上下文，只走通用失败提示、丢掉「面板连原草稿带回来」 - 新增宿主用例「两条音频提交重叠：第一条未被受理时，它的面板仍会被带回来」：给测试宿主加 `holdFirstAssetGenerationStart` 开关，把第一次派发挂在受理前，复现两条提交重叠	2026-09-21 00:17:05 +08:00
k88936	7b1bc1d3e8	生成任务先登记 live 再落账本，关掉被判成中断残留的窗口 ... - `start_local_project_asset_generation` 的音频分支改为一律先登记 live、再写排队记录（原先顺序 相反，中间窗口里并发 `list_local_project_asset_generations` 会把这条排队记录当成上次运行的 残留收口成失败） - 图片类分支同一处顺序问题一并改正：同一条命令的两条通道共用同一条顺序约束 - 新增 `register_live_task_id`：登记并返回「本轮是否真的插入了新 id」，落账失败时只回滚本轮插入 的那条登记，避免删掉同 id 那个正在运行任务的 live 登记 - 新增用例 `a_failed_ledger_write_only_takes_back_the_live_registration_it_inserted` 覆盖该回滚判据	2026-09-21 00:14:11 +08:00
k88936	ae0ab0ddf4	音频后台生成不再传形同虚设的 sourceMediaType ... - `run_local_project_audio_generation_at` 提交 `derive_local_project_resource_at` 时把 `source_media_type` 从 `Some("audio/mpeg")` 改成 `None`（`generation_mode: Create` 下源快照的 媒体类型由 `edit_kind` 推出，这条通道根本不读该入参，留着会让读者以为它有作用） - 该函数文档补一句说明「Create 模式不读 `input.source_media_type`」，避免后续又被加回去	2026-09-21 00:11:31 +08:00
k88936	fca111239c	AGC 音频账本 kind 判定改成显式穷举，去掉静默兜底 ... - `begin_local_project_audio_generation_task` 的 `edit_kind → 账本 kind` 映射显式列出 `SoundEffect` 与 `BackgroundMusic` 两个成员，不再用 `_ =>` 兜底 - 其余 `LocalProjectResourceEditKind` 变体在此处直接返回错误，避免新增音频变体（或上游白名单被 放宽）时被静默记成音效	2026-09-21 00:05:44 +08:00
k88936	9a6875b4ce	Merge remote-tracking branch 'origin/master'	2026-09-20 23:45:36 +08:00
k88936	99fb6c38c1	AGC 音频生成并入图片类那份后台任务账本 ... - 原生：`start_local_project_asset_generation` 新增可选入参 `idempotencyKey`，并在音频 kind 上分叉；图片类载荷与分支逐字未改 - 原生：新增音频提交期收口 `prepare_local_project_audio_generation`（kind / 提示词上限 / 素材名 / operation 身份 / 幂等键） - 原生：新增 `run_local_project_audio_generation_at`，在派发时刻读项目 revision 并复用既有音频无源生成实现，不复制生成逻辑 - 原生：新增 `begin_local_project_audio_generation_task` / `run_local_project_audio_generation_task`，音频任务落同一份项目内账本并写 running → completed / failed，跑完没登记素材按失败收口 - 原生：补两条用例——被拒绝的提交零写入账本、音频任务落在同一账本且 kind 正确 - 前端任务模型：新增音频任务与 `idempotencyKey` 字段，恢复出来的历史任务不带它也不承接重试，入口文案扩到音频栏目 - 前端队列：按 kind 分流派发载荷，音频只发任务身份（任务 id 即 operation id）与幂等键 - 前端面板：音频生成面板改为点「生成」同步提交并立即关闭，删除「生成中…」「后台运行并关闭」与输入锁定 - 前端宿主：音频提交改为同步入队并展开「生成任务」侧栏，只有「后端从未受理」才连原草稿与原请求身份重开面板 - 前端清理：删除随本次改动失效的 `resourceCanvasGenerationSourceId` 与宿主里不再使用的 import - 测试：面板 / 队列 / 宿主生命周期 / 落点 / appSurface 改按后台账本口径断言，并补「未受理即时失败重开」用例（已用移除重开逻辑的变异验证其非空） - 文档：PRD §3.10 / §7.9、AGC 底部工具栏入口矩阵、V3 端到端验收 S11a 同步为音频后台化口径 - 文档：新增里程碑与实施计划（含验收证据矩阵），并在 decision-log 记下「音频并入后台任务账本」这条长期约定	2026-09-20 23:32:09 +08:00