fix: polish bark battle creation flow

.hermes/shared-memory/decision-log.md

@@ -16,12 +16,20 @@
 
 ---
 
-## 2026-05-19 汪汪声浪创作先进入草稿结果页
+## 2026-05-20 汪汪声浪 v1 公开闭环计划
 
-- 背景：汪汪声浪轻配置表单直接发布会缺少草稿编译、资源预览、手动上传、重新生成和发布前试玩环节，创作者无法确认角色形象、UI 背景和狗叫音效替换效果。
-- 决策：`bark-battle` 入口继续保持创作 Tab 内嵌轻配置表单；提交后先调用 `/api/creation/bark-battle/drafts` 生成草稿并进入 `bark-battle-result`，草稿响应必须带回 SpacetimeDB 草稿行上的稳定 `workId`、`configVersion` 和 `rulesetVersion`。结果页负责资源预览、图片槽位重新生成、四类资源手动上传、发布前试玩和最终发布；发布必须复用草稿返回的同一个 `workId`，不得在 publish 阶段重新生成作品 ID。排行榜字段暂保留兼容，但创作 UI 不展示排行榜开关。
-- 影响范围：`BarkBattleConfigEditor`、`BarkBattleResultView`、`BarkBattlePreviewCard`、`PlatformEntryFlowShellImpl`、Bark Battle creation client、玩法链路文档和相关交互测试。
-- 验证方式：创作 Tab 选择汪汪声浪后应看到轻配置表单；点击生成草稿进入结果页；结果页能看到玩家形象、对手形象、UI 背景和狗叫音效槽位，试玩在发布前可进入 runtime，发布成功后再进入正式 runtime。
+- 背景：Bark Battle v1 需要把创作、生成、结果、发布、详情和正式运行态收成一条闭环，避免把草稿试玩、公开广场和正式成绩混在一起。
+- 决策：`bark-battle` 入口改为 6 字段表单（作品标题、简介、主题 / 竞技背景描述 `themeDescription`、玩家形象描述、对手形象描述、难度）；提交后进入 `bark-battle-generating` 独立生成页，自动生成玩家形象、对手形象和竞技背景三图，部分失败也继续进入结果页。旧“角色设定 / 狗狗皮肤预设 / themePreset”统一退场，配置和文档只使用“形象描述 / themeDescription”。结果页只保留单槽重试、重新生成和上传，不再保留一次生成按钮、音频配置入口、皮肤预设入口或排名配置。发布后先跳统一作品详情页 `/works/detail?work=BB-xxxxxxxx`，再由详情页进入正式 `published` runtime；正式 runtime 必须真实麦克风，`draft` 可试玩、可 mock 且不写正式统计。公开广场统一读取 `bark_battle_gallery_view` read model。
+- 影响范围：`BarkBattleConfigEditor`、`BarkBattleGeneratingView`、`BarkBattleResultView`、`BarkBattleRuntimeShell`、`PlatformEntryFlowShellImpl`、`appPageRoutes`、Bark Battle creation/runtime client、公开广场聚合与相关交互测试。
+- 验证方式：提交表单后先进入生成页；生成页部分失败仍能落到结果页；结果页只出现单槽重试 / 重新生成 / 上传；发布后先到 `/works/detail?work=BB-xxxxxxxx` 再进正式 runtime；正式 runtime 会要求麦克风并写基础统计，草稿试玩可 mock 且不写正式 run；公开广场读取 `bark_battle_gallery_view`。
+- 关联文档：`docs/【玩法创作】平台入口与玩法链路-2026-05-15.md`。
+
+## 2026-05-22 汪汪声浪运行态与作品外显信息收口
+
+- 背景：Bark Battle v1 在正式运行态、图片生成提示词和作品外部卡片上仍存在体验漂移：能量条推满后还要等计时结束、进入正式 runtime 后还要二次点击声控、角色形象 prompt 会默认注入狗主体、草稿 / 已发布卡片外部看不到创作者。
+- 决策：能量条到玩家或对手边界即结算；正式 `published` runtime 从作品详情启动后立即申请真实麦克风权限，授权成功后立刻进入倒计时，并使用 start run 返回的 `runtimeConfig` 作为本局前端规则参数；结束后弹出独立结算弹窗，运行态固定提供返回按钮。玩家 / 对手形象图提示词保持用户填写的形象描述，只要求单个完整形象、正面和透明背景，不把非狗描述改写成狗；草稿架、已发布作品架、统一作品详情和公开广场列表都展示后端返回的 `authorDisplayName`。Bark Battle 卡片封面按竞技背景、玩家形象、对手形象、入口参考图兜底；works summary 优先读取 `publishedSnapshotJson` 的最终发布素材。拟声词进入配置 JSON，未手动编辑时随主题 / 形象描述重算，手动编辑后保持创作者自定义；触发阈值降到 `0.35`、冷却降到 `150ms`，后端 `BarkBattleRuleset.min_bark_gap_ms` 同步为 `150`，局内有效触发后快速随机展示高能词池。
+- 影响范围：`BarkBattleSession`、`BarkBattleRuntimeShell`、`BarkBattleConfigEditor`、`BarkBattleConfig`、Bark Battle 生图 prompt、Bark Battle works/gallery summary、创作中心作品架卡片、公开作品码、`module-bark-battle` ruleset 和玩法链路文档。
+- 验证方式：能量条推到 `100/-100` 的领域测试应提前 finished；发布态 runtime mount 后应自动调用麦克风 sampler、登记正式 run 并使用服务端 runtimeConfig；prompt 单测应覆盖透明背景、正面和非狗描述不强注入狗；作品架测试应覆盖草稿与已发布卡片作者展示和封面兜底；拟声词测试应覆盖主题自动重算、自定义保持和随机展示。
 - 关联文档：`docs/【玩法创作】平台入口与玩法链路-2026-05-15.md`。
 
 ## 2026-05-18 Rust 手写模块入口统一不用 mod.rs
@@ -59,6 +67,7 @@
 - 影响范围：`jenkins/Jenkinsfile.production-stdb-module-build` 及后续所有同类 Windows 构建流水线。
 - 验证方式：Jenkins 日志中应能看到 `[jenkins-powershell] user:` 和 `[jenkins-powershell] exe:`，Checkout 阶段会打印当前 `HEAD` 与请求 commit，并在 `COMMIT_HASH` 为空或一致时直接继续；不再停在 `PipelineNodeTreeScanner... Cannot run program "powershell"` 或重复 `git clean` 的退出码 5。
 - 关联文档：`docs/【开发运维】本地开发验证与生产运维-2026-05-15.md`、`.hermes/shared-memory/pitfalls.md`。
+
 ## 2026-05-19 tracking outbox 改为 rotate 后异步 flush
 
 - 背景：普通 route tracking 写入压力上来后，不能让 HTTP 请求线程等待 SpacetimeDB 批量入库。
@@ -273,6 +282,7 @@
 - 影响范围：平台个人页、登录弹窗、法律 Markdown 渲染和前端认证交互测试。
 - 验证方式：执行 `npm run test -- src/components/auth/AuthGate.test.tsx src/components/rpg-entry/RpgEntryHomeView.recharge.test.tsx`、触碰文件 ESLint、`npm run check:encoding`。
 - 关联文档：`docs/prd/PROFILE_LEGAL_INFO_AND_AUTH_AGREEMENT_PRD_2026-05-12.md`。
+
 ## 2026-05-12 微信小程序待绑定手机号优先走原生手机号授权
 
 - 背景：微信小程序 `web-view` 壳登录后若返回 `pending_bind_phone`，H5 仍会展示手输手机号和短信验证码绑定页，体验上多了一步。
@@ -651,3 +661,15 @@
 - 默认阈值：每批 500 条或 1 秒 flush 一次；outbox 磁盘上限 256 MiB，超过后丢弃低价值 route 事件并记录指标 / 日志。
 - 影响范围：`api-server` tracking 中间件、SpacetimeDB tracking procedure、部署数据目录、OTLP 指标和运维排障。
 - 验证方式：数据库不可用时公开 route 请求不失败且 outbox 文件保留；恢复后批量写入成功并删除本地 sealed 文件；关键事件仍立即影响任务 / 统计。
+
+## 2026-05-19 汪汪声浪默认开放并区分草稿试玩与正式运行态
+
+- 背景：`bark-battle` 已具备草稿结果页、发布链路与运行态 API，继续在入口层标记“敬请期待”会阻断创作闭环；同时草稿试玩不应污染正式成绩统计。
+- 决策：默认入口改为 `visible=true`、`open=true`、`badge=可创建`，参考图固定为 `/creation-type-references/bark-battle.webp`。系统默认迁移只纠偏未被后台人工改过的汪汪声浪入口。发布后先进入统一作品详情页 `/works/detail?work=BB-xxxxxxxx`；正式 runtime 使用 `runtimeMode=published` 并必须真实麦克风，调用 `startBarkBattleRun` / `finishBarkBattleRun` 写正式 run；草稿结果页试玩仍使用 `runtimeMode=draft`，允许 mock 且不写正式 run。
+- 验证方式：入口配置响应应返回汪汪声浪可创建和专属参考图；发布后地址应为 `/works/detail?work=BB-xxxxxxxx`；草稿试玩不调用 runtime run API；正式 runtime 无麦克风时不登记正式 run，结算后提交派生指标。
+
+## 2026-05-20 汪汪声浪生成页负责三图自动生成
+
+- 背景：结果页承载预览、修补和发布，若继续放“一次生成”按钮会把初始生成和结果修补职责混在一起。
+- 决策：初始三图生成改由 `bark-battle-generating` 独立生成页自动执行，目标槽位只有玩家形象、对手形象和竞技背景；表单术语统一为 `themeDescription`、玩家形象描述和对手形象描述，不再回退 `themePreset`、狗狗皮肤预设或“角色设定”。部分失败也进入结果页。结果页不再提供一次生成按钮，音频配置和排名配置不进入 v1 公开闭环；结果页只保留单槽重试、重新生成和上传。发布时 SpacetimeDB `bark_battle_published_config.config_json` 使用规范化后的最终 `publishedSnapshot`，`published_snapshot_json` 同步保存同一份快照。
+- 验证方式：表单提交后进入 `bark-battle-generating`；结果页不会出现一次生成按钮、音频槽、皮肤预设入口或排名配置；Bark Battle 发布后正式 runtime 应读取结果页最终图片素材而不是初始草稿素材。

.hermes/shared-memory/pitfalls.md

@@ -46,6 +46,36 @@
 - 验证：点击汪汪声浪后直接看到创作页内嵌表单，不再出现独立配置页；测试应覆盖内嵌表单与 runtime 返回路径。
 - 关联：`src/components/platform-entry/PlatformEntryFlowShellImpl.tsx`、`src/components/bark-battle-creation/BarkBattleConfigEditor.tsx`、`src/components/rpg-entry/RpgEntryFlowShell.agent.interaction.test.tsx`。
 
+## 汪汪声浪发布态不要丢失结果页最终素材
+
+- 现象：结果页上传或批量生成玩家形象、对手形象、UI 背景后，发布进入正式 runtime 仍可能显示初始草稿素材或兜底视觉。
+- 原因：`publish_bark_battle_work` 如果只把结果页最终状态保存到 `published_snapshot_json`，但正式 runtime 读取的 `config_json` 仍来自草稿行旧值，就会丢失结果页局部替换。
+- 处理：发布时把最终 `publishedSnapshot` 解析为 `BarkBattleEditorConfigSnapshot`、规范化后同时写入 `bark_battle_published_config.config_json` 和 `published_snapshot_json`；首轮自动生成只由 `bark-battle-generating` 负责，结果页仅覆盖已接入的玩家形象、对手形象和竞技背景图片槽位，不再提供音频配置入口。
+- 验证：发布后 runtime config 应包含结果页最终 `playerCharacterImageSrc`、`opponentCharacterImageSrc` 和 `uiBackgroundImageSrc`。
+
+## 汪汪声浪 v1 生成页和正式运行态要分开
+
+- 现象：如果把初始三图自动生成、结果页修补、公开发布和正式运行态混在一页，创作者容易误以为一次生成和正式运行是同一职责。
+- 原因：`bark-battle-generating` 才应该承担玩家形象、对手形象和竞技背景的自动生成；结果页只做单槽修补，正式 runtime 又必须切到真实麦克风和正式统计。
+- 处理：表单提交后先进入独立生成页，部分失败仍进结果页；结果页只保留单槽重试、重新生成和上传，不再保留一次生成按钮、音频配置入口、皮肤预设入口或排名配置。发布后先到统一作品详情页，再进正式 runtime；草稿试玩允许 mock，不写正式 run。
+- 验证：生成页负责首轮自动产出三图；结果页不出现一次生成按钮、音频配置入口、皮肤预设入口或排名配置；正式 runtime 必须麦克风可用且会写正式 run，草稿试玩不写正式统计。
+
+## 汪汪声浪生成页不要只停留在前端内存草稿
+
+- 现象：点击“生成草稿”后生成页一直转圈，或刷新 / 回到草稿架后看不到三图素材。
+- 原因：生成页只在前端内存里合并玩家形象、对手形象和竞技背景，没有把生成结果写回 `bark_battle_draft_config.config_json`；另外 BFF 若在刚创建草稿后先读 `spacetime-client` 订阅 cache 再保存，cache 可能短暂落后，导致保存失败或返回旧快照。
+- 处理：生成页三图完成后调用 `POST /api/creation/bark-battle/drafts/{draftId}/config` 持久化；保存接口直接把请求快照交给 SpacetimeDB procedure，由模块事务校验 owner / work，并在 HTTP 回包用本次请求里的三图字段覆盖，避免订阅 cache 滞后；保存请求必须设置前端超时，保存失败也进入结果页并标记部分失败。
+- 验证：`npm run test -- src/components/bark-battle-creation/BarkBattleGeneratingView.test.tsx src/services/bark-battle-creation/barkBattleCreationClient.test.ts src/components/bark-battle-creation/BarkBattleResultView.test.tsx packages/shared/src/contracts/barkBattle.test.ts`；`npm run test -- src/components/rpg-entry/RpgEntryFlowShell.agent.interaction.test.tsx -t "bark battle"`；`cargo check --manifest-path server-rs\Cargo.toml -p api-server`。
+- 关联：`src/components/bark-battle-creation/BarkBattleGeneratingView.tsx`、`src/services/bark-battle-creation/barkBattleCreationClient.ts`、`server-rs/crates/api-server/src/bark_battle.rs`、`server-rs/crates/spacetime-module/src/bark_battle.rs`。
+
+## 汪汪声浪三图不要复用 RPG 场景图链路
+
+- 现象：玩家形象和对手形象看起来走了场景图片 prompt；生成页三个槽位同时转圈，但只有第一个真实生成，首图返回后三个槽位一起停止或只显示首图。
+- 原因：前端曾复用 `/api/runtime/custom-world/scene-image`，三类素材都被当成 RPG landmark scene image；生成页又只用父级 draft 判断 ready，批量 Promise 结束后才一次性合并结果，缺少逐槽状态。
+- 处理：Bark Battle 生图统一走 `POST /api/creation/bark-battle/images/generate`，请求体包含 `slot` 和 v1 配置；后端在 `api-server/src/bark_battle.rs` 按 `player-character`、`opponent-character`、`ui-background` 分别拼装正式 prompt，写入 `generated-bark-battle-assets`，并返回 `prompt/actualPrompt`。前端 `generateAllBarkBattleImageAssets` 保持三槽 `Promise.allSettled` 并通过 `onSlotComplete` 逐槽刷新生成页状态。
+- 验证：`npm run test -- src/services/bark-battle-creation/barkBattleCreationClient.test.ts src/components/bark-battle-creation/BarkBattleGeneratingView.test.tsx packages/shared/src/contracts/barkBattle.test.ts`；`cargo test -p shared-contracts bark_battle --manifest-path server-rs\Cargo.toml`；`cargo check --manifest-path server-rs\Cargo.toml -p platform-oss -p api-server`。
+- 关联：`src/services/bark-battle-creation/barkBattleCreationClient.ts`、`src/components/bark-battle-creation/BarkBattleGeneratingView.tsx`、`server-rs/crates/api-server/src/bark_battle.rs`、`server-rs/crates/platform-oss/src/lib.rs`。
+
 ## 抓大鹅批量重新生成物品不要新增 itemId
 
 - 现象：结果页批量重新生成物品后，试玩或正式运行态的物品类型和图片对应关系漂移，或者用户输入一个不存在名称后被当作新物品追加。
@@ -1039,3 +1069,27 @@
 - 处理：打开草稿时把持久化 `generationStatus=generating` 等同于生成中 notice，恢复对应玩法生成进度页；恢复计时使用作品摘要 `updatedAt` 推导 `startedAtMs`。
 - 验证：`npm test -- src/components/rpg-entry/RpgEntryFlowShell.agent.interaction.test.tsx -t "persisted generating"`。
 - 关联：`src/components/platform-entry/PlatformEntryFlowShellImpl.tsx`、`src/components/rpg-entry/RpgEntryFlowShell.agent.interaction.test.tsx`、`docs/【玩法创作】平台入口与玩法链路-2026-05-15.md`。
+
+## 汪汪声浪草稿试玩不要写正式 run
+
+- 现象：如果草稿结果页试玩和发布后 runtime 共用同一写成绩路径，未发布或未确认资源的草稿试玩会污染正式单局、排行榜和作品统计。
+- 原因：`BarkBattleRuntimeShell` 同时承担草稿预览和发布后运行态，需要由调用方显式传入 `runtimeMode` 区分是否写正式 run。
+- 处理：草稿结果页试玩保持 `runtimeMode=draft`，只做本地预览；发布成功后先进入 `/works/detail?work=BB-xxxxxxxx`，再从详情页以 `runtimeMode=published` 进入正式 runtime，并在开始/结算时分别调用 `startBarkBattleRun` 与 `finishBarkBattleRun`。
+- 验证：草稿试玩不触发 start / finish run；正式 runtime 必须先通过麦克风授权，再写 start run 和结算派生指标。
+- 关联：`src/components/platform-entry/PlatformEntryFlowShellImpl.tsx`、`src/games/bark-battle/ui/BarkBattleRuntimeShell.tsx`、`src/services/bark-battle-runtime/barkBattleRuntimeClient.ts`。
+
+## 汪汪声浪移动端创作表单不要再套一层纵向滚动
+
+- 现象：移动端创作 Tab 里进入汪汪声浪表单后，页面右侧出现不自然的内层滚动条，最后的形象描述输入框容易被“生成草稿”按钮、键盘或底部 TabBar 挤压 / 遮挡；顶部玩法卡首尾也可能贴边显得被裁。
+- 原因：外层 `.platform-tab-panel` 已经是纵向滚动容器，创作页中间又有多层 `overflow-hidden`，旧的 `BarkBattleConfigEditor` 根节点再加 `overflow-y-auto`，形成外层 Tab 面板 + 内层表单的套滚动；底部按钮只预留 safe-area，不预留真实操作区距离；顶部玩法卡横向滚动条隐藏且首尾没有 scroll padding。
+- 处理：移动端让 Bark Battle 表单跟随父级滚动，`lg` 以上才恢复表单内滚动；创作页容器移动端使用 `overflow-visible` 和 safe-area 底部 padding；顶部模板 tablist 加 `scroll-px-3` / 横向 padding，移动端卡片宽度收窄，避免首尾 ring 和圆角贴边裁切。
+- 验证：`npm run test -- src/components/bark-battle-creation/BarkBattleConfigEditor.test.tsx`、`npm run test -- src/components/rpg-entry/RpgEntryFlowShell.agent.interaction.test.tsx -t "create tab shows template tabs"`、移动端视口检查最后一个输入框与“生成草稿”按钮不重叠。
+- 关联：`src/components/bark-battle-creation/BarkBattleConfigEditor.tsx`、`src/components/platform-entry/PlatformEntryFlowShellImpl.tsx`、`docs/【玩法创作】平台入口与玩法链路-2026-05-15.md`。
+
+## 汪汪声浪拟声词不要被默认狗主题锁死
+
+- 现象：创作者把主题或形象改成机甲、猫、骑士等非狗主题后，局内仍播放 `轰汪！`、`汪爆！` 这类狗叫词，表现像系统强行把主题带回狗。
+- 原因：拟声词 textarea 如果一开始就填入默认小狗词池，并且始终作为自定义 `onomatopoeia` 提交，runtime 会优先使用该字段，无法再根据新的 `themeDescription` / `playerImageDescription` / `opponentImageDescription` 走主题 fallback。
+- 处理：`BarkBattleConfigEditor` 需要区分“系统默认词池”和“创作者已手动编辑”。未手动编辑时随主题 / 形象描述自动重算；手动编辑后才冻结为自定义词池。默认词池只在命中狗相关关键词时加入狗叫词，非狗主题使用科技、幻想或通用高能词。
+- 验证：`npm run test -- src/components/bark-battle-creation/BarkBattleConfigEditor.test.tsx src/games/bark-battle/ui/__tests__/BarkBattleRuntimeShell.test.tsx`，并确认非狗主题的拟声词不含 `汪`。
+- 关联：`src/components/bark-battle-creation/BarkBattleConfigEditor.tsx`、`src/games/bark-battle/application/BarkBattleConfig.ts`、`src/games/bark-battle/ui/BarkBattleRuntimeShell.tsx`。

docs/【玩法创作】平台入口与玩法链路-2026-05-15.md

@@ -133,30 +133,38 @@
 当前领域语言：
 
 - 有效声浪触发：麦克风归一化响度在冷却结束后达到阈值的一次计分输入。
-- 能量条：玩家与对手当前声浪优势的连续对抗刻度。
+- 能量条：玩家与对手当前声浪优势的连续对抗刻度，推到玩家或对手一侧边界时本局立即结算。
+- 主题 / 竞技背景描述：配置字段为 `themeDescription`，用于生成竞技背景并表达整体场景，不再使用 `themePreset` 或狗狗皮肤预设。
+- 玩家 / 对手形象描述：配置字段为 `playerImageDescription` / `opponentImageDescription`，对外统一称“形象描述”，不再称“角色设定”。
 - 后端裁决结果：后端根据 start run 与 finish 派生指标校验后的正式单局结果。
-- 排行榜分榜：按 `workId + difficultyPreset + rulesetVersion` 拆分，只收录后端裁决玩家胜利的成绩。
+- 基础统计：只记录正式 `published` run 的开始、结算和派生指标，草稿试玩不写正式统计。
+- 公开广场：统一读取 `bark_battle_gallery_view` 这类 read model，不再由前端自己拼公开列表。
+- 创作者信息：草稿架、已发布作品架、统一作品详情和公开广场都必须展示后端返回的 `authorDisplayName`，不得只在详情页内层可见。
+- 拟声词：配置字段为 `onomatopoeia`。创作者未手动编辑时，前端根据主题 / 竞技背景描述、玩家形象描述和对手形象描述生成高能词池；创作者手动编辑后按自定义词池发布。默认词池只在命中狗相关主题时加入狗叫词，不能把非狗主题强行带回狗语义。
 
-当前入口沿用创作 Tab 内嵌轻配置表单，不再切到独立 `bark-battle-config` 阶段；配置提交后先进入草稿结果页，再由结果页执行资源预览、手动上传替换、重新生成、试玩和发布。runtime 从草稿试玩返回草稿结果页，从入口回退时恢复汪汪声浪模板选中态。
+当前入口默认开放：`visible=true`、`open=true`、`badge=可创建`，入口参考图使用 `/creation-type-references/bark-battle.webp`。创作入口使用 7 字段表单（作品标题、简介、主题 / 竞技背景描述 `themeDescription`、玩家形象描述、对手形象描述、拟声词、难度）；提交后先进入 `bark-battle-generating` 独立生成页，自动生成玩家形象、对手形象和竞技背景三图。生成页即使部分槽位失败也要继续落到结果页，失败槽位保留错误态和单槽重试入口，不在生成页停留。结果页只保留单槽重试、重新生成和上传，不再展示一次生成按钮、音频配置入口、皮肤预设入口或排名配置。发布成功后先跳统一作品详情页 `/works/detail?work=BB-xxxxxxxx`，正式 `published` runtime 从作品详情页进入并必须使用真实麦克风；`draft` 可试玩，可使用 mock 输入，且不写正式统计。草稿与已发布作品在外部卡片、作品架和广场列表都展示创作者名称。
+
+移动端创作 Tab 内嵌 Bark Battle 表单时，只保留外层 Tab 面板承担纵向滚动；表单自身移动端不再创建独立纵向滚动容器，底部“生成草稿”按钮作为普通表单尾部并保留 safe-area 底部间距，避免与最后一组输入框、移动端键盘或底部 TabBar 形成套滚动 / 遮挡。
 
 创作流程为：
 
-- 创作 Tab 表单：填写作品标题、简介、主题、玩家角色设定、对手角色设定、难度和资源源。
+- 创作 Tab 表单：填写作品标题、简介、主题 / 竞技背景描述、玩家形象描述、对手形象描述、拟声词和难度。拟声词支持换行、逗号、顿号、斜杠或竖线分隔；未手动编辑时随主题 / 形象描述自动重算，手动编辑后保持创作者自定义。
 - 草稿编译：`POST /api/creation/bark-battle/drafts` 写入配置 JSON，返回包含 `draftId`、稳定 `workId`、`configVersion` 和 `rulesetVersion` 的草稿结果。
-- 资源预览：草稿结果页展示玩家形象、对手形象、UI 背景和狗叫音效槽位。
+- 生成页：`bark-battle-generating` 自动并行产出玩家形象、对手形象和竞技背景三图；前端按槽位实时显示生成中 / 已生成 / 失败状态，三图都走 Bark Battle 专用后端生图接口 `POST /api/creation/bark-battle/images/generate`，由后端按 `player-character`、`opponent-character`、`ui-background` 分别拼装正式提示词、写入 `generated-bark-battle-assets` 私有资产前缀并返回实际 prompt。玩家 / 对手形象提示词必须保持用户形象描述，不强行注入狗相关主体，并要求正面、单个完整形象和透明背景。部分失败也继续进入结果页。
+- 结果页：围绕三图槽位展示错误态与已生成结果，只保留单槽重试、重新生成和上传，不再提供一次生成按钮、音频配置入口或排名配置。
 - 手动上传：结果页通过平台资产直传 `/api/assets/direct-upload-tickets` 与 `/api/assets/objects/confirm` 写入私有资产，再把返回的历史 generated 路径写回草稿配置。
-- 重新生成：玩家形象、对手形象和 UI 背景先复用现有图片生成链路；狗叫音效暂不假装自动生成，未接专用音频生成时走手动上传。
-- 试玩：在发布前使用草稿配置启动本地 runtime 预览，不写正式发布记录。
-- 发布：结果页确认后必须携带草稿返回的同一个 `workId` 调用 `POST /api/creation/bark-battle/works/publish`，发布成功后进入 runtime；缺少 `workId` 的旧草稿状态需要重新生成草稿。
+- 发布：结果页确认后必须携带草稿返回的同一个 `workId` 和结果页最终 `publishedSnapshot` 调用 `POST /api/creation/bark-battle/works/publish`；SpacetimeDB 发布态的 `config_json` 必须使用该最终快照，works summary 若拿到 `publishedSnapshotJson` 也优先使用最终快照映射封面三图。发布成功后先进入统一作品详情页，再由详情页进入正式 runtime；缺少 `workId` 的旧草稿状态需要重新生成草稿。
+- 作品架：Bark Battle 草稿 / 已发布列表优先读取后端 `/works`，但创建、生成完成、保存或发布后的本地摘要必须在后端 read model 尚未回读到同 `workId` 前继续保留；创作中心作品架同时接入 pending shelf 兜底，避免 ready 且三图齐全的草稿在刷新窗口期从“我的草稿 / 已发布”中消失。
+- 试玩与正式 runtime：草稿试玩使用 `runtimeMode=draft` 和 mock 输入，不写正式 run；正式 runtime 使用 `runtimeMode=published`，进入运行态后直接申请真实麦克风权限，授权成功后立刻进入倒计时，启动对局时调用 `POST /api/runtime/bark-battle/works/{workId}/runs` 登记 start run，并以返回的 `runtimeConfig` 作为本局前端规则参数；结算时调用 `POST /api/runtime/bark-battle/runs/{runId}/finish` 写入基础统计派生指标；对局会在能量条推到任一侧边界时提前结算并弹出独立结算弹窗，运行态内固定提供返回按钮。
 
 支持的创作者可替换内容：
 
-- 基础信息：作品标题、简介、主题背景、玩家角色设定、对手角色设定和难度。
-- 角色形象：可分别替换玩家与对手角色图片；未配置图片时继续使用狗狗预设兜底。
-- UI 视觉：可替换运行态主背景图；未配置图片时继续使用主题背景兜底。
-- 狗叫音效：可替换局内触发叫声的音频资源；未配置音频时不强制播放自定义音效。
+- 基础信息：作品标题、简介、主题 / 竞技背景描述（`themeDescription`）、玩家形象描述、对手形象描述和难度。
+- 生成素材：玩家形象、对手形象和竞技背景三个槽位可单槽重试、重新生成或上传；形象图保持正面和透明背景，不把非狗形象描述改写成狗。
+- 拟声词：最多保留前 `24` 个有效词；默认池按狗、机甲 / 科技、幻想 / 骑士等主题补充高能短词，并叠加通用“炸场 / 破阵 / 声浪拉满”等基础词。局内只要有效声浪触发就随机快速展示，避免连续重复。
+- 运行态输入：正式 runtime 必须真实麦克风；草稿试玩允许 mock，不写正式统计。
 
-这些替换槽位写入 Bark Battle 配置 JSON，发布后由 runtime 读取；计分阈值、对局时长、反作弊校验和后端裁决仍由规则集与后端控制，不能通过前端替换项改变。排行榜相关后端字段暂保留兼容，但创作 UI 不再展示排行榜开关。
+这些创作字段写入 Bark Battle 配置 JSON，发布后由 runtime 和基础统计链路读取；对局时长、反作弊校验和后端裁决仍由规则集与后端控制，不能通过前端替换项改变。当前声浪触发口径为前端默认阈值 `0.35`、有效触发冷却 `150ms`，后端 `BarkBattleRuleset` 的 `min_bark_gap_ms` 也保持 `150ms`，用于正式成绩校验的物理触发上限。历史排名相关后端字段暂保留兼容，但 v1 公开闭环不展示音频、皮肤预设或排名配置入口。
 
 ## 方洞挑战
 

packages/shared/src/contracts/barkBattle.test.ts

@@ -1,15 +1,19 @@
 import { describe, expect, test } from 'vitest';
 
 import {
+  BARK_BATTLE_ASSET_SLOTS,
   BARK_BATTLE_DIFFICULTY_PRESETS,
   type BarkBattleDraftConfig,
+  type BarkBattleDraftConfigUpdateRequest,
   type BarkBattleFinishResponse,
+  type BarkBattleGeneratedImageAsset,
+  type BarkBattleImageAssetGenerateRequest,
   type BarkBattlePersonalBestSummary,
   type BarkBattleWorkStats,
 } from './barkBattle';
 
 describe('Bark Battle shared contracts', () => {
-  test('default draft config fixture uses normal difficulty and camelCase fields', () => {
+  test('default draft config fixture uses normal difficulty and v1 description fields', () => {
     const draft: BarkBattleDraftConfig = {
       draftId: 'draft-bark-1',
       workId: 'work-bark-1',
@@ -17,15 +21,14 @@ describe('Bark Battle shared contracts', () => {
       rulesetVersion: 'bark-battle-ruleset-v1',
       title: '汪汪声浪挑战',
       description: '轻配置草稿',
-      themePreset: 'city-park',
-      playerDogSkinPreset: 'corgi',
-      opponentDogSkinPreset: 'husky',
+      themeDescription: '傍晚城市公园里的声浪擂台',
+      playerImageDescription: '戴红围巾的柯基主角',
+      opponentImageDescription: '蓝色运动头带的哈士奇对手',
+      onomatopoeia: ['轰汪！', '嗷呜！', '咚咚！'],
       playerCharacterImageSrc: '/generated-bark-battle/player/image.png',
       opponentCharacterImageSrc: 'https://example.test/opponent.png',
       uiBackgroundImageSrc: '/generated-bark-battle/ui/background.png',
-      barkSoundSrc: '/generated-bark-battle/audio/bark.mp3',
       difficultyPreset: 'normal',
-      leaderboardEnabled: true,
       updatedAt: '2026-05-13T03:00:00.000Z',
     };
 
@@ -38,18 +41,100 @@ describe('Bark Battle shared contracts', () => {
       'rulesetVersion',
       'title',
       'description',
-      'themePreset',
-      'playerDogSkinPreset',
-      'opponentDogSkinPreset',
+      'themeDescription',
+      'playerImageDescription',
+      'opponentImageDescription',
+      'onomatopoeia',
       'playerCharacterImageSrc',
       'opponentCharacterImageSrc',
       'uiBackgroundImageSrc',
-      'barkSoundSrc',
       'difficultyPreset',
-      'leaderboardEnabled',
       'updatedAt',
     ]);
     expect(draft.playerCharacterImageSrc).toContain('/generated-bark-battle/');
+    expect('barkSoundSrc' in draft).toBe(false);
+    expect('leaderboardEnabled' in draft).toBe(false);
+  });
+
+  test('draft config update contract persists generated image slots only', () => {
+    const update: BarkBattleDraftConfigUpdateRequest = {
+      draftId: 'draft-bark-1',
+      workId: 'BB-12345678',
+      configVersion: 2,
+      rulesetVersion: 'bark-battle-ruleset-v1',
+      title: '汪汪声浪挑战',
+      description: '轻配置草稿',
+      themeDescription: '傍晚城市公园里的声浪擂台',
+      playerImageDescription: '戴红围巾的柯基主角',
+      opponentImageDescription: '蓝色运动头带的哈士奇对手',
+      onomatopoeia: ['轰！', '燃起来！', '破阵！'],
+      playerCharacterImageSrc: '/generated-bark-battle/player/image.png',
+      opponentCharacterImageSrc: '/generated-bark-battle/opponent/image.png',
+      uiBackgroundImageSrc: '/generated-bark-battle/ui/background.png',
+      difficultyPreset: 'normal',
+    };
+
+    expect(Object.keys(update)).toEqual([
+      'draftId',
+      'workId',
+      'configVersion',
+      'rulesetVersion',
+      'title',
+      'description',
+      'themeDescription',
+      'playerImageDescription',
+      'opponentImageDescription',
+      'onomatopoeia',
+      'playerCharacterImageSrc',
+      'opponentCharacterImageSrc',
+      'uiBackgroundImageSrc',
+      'difficultyPreset',
+    ]);
+    expect('barkSoundSrc' in update).toBe(false);
+    expect('leaderboardEnabled' in update).toBe(false);
+  });
+
+  test('image generation contract uses dedicated Bark Battle slots and backend prompt result', () => {
+    expect(BARK_BATTLE_ASSET_SLOTS).toEqual([
+      'player-character',
+      'opponent-character',
+      'ui-background',
+    ]);
+
+    const request: BarkBattleImageAssetGenerateRequest = {
+      slot: 'opponent-character',
+      draftId: 'bark-battle-draft-1',
+      config: {
+        title: '汪汪冠军杯',
+        description: '',
+        themeDescription: '霓虹公园擂台',
+        playerImageDescription: '红围巾柴犬',
+        opponentImageDescription: '蓝头带哈士奇',
+        onomatopoeia: ['轰汪！', '炸场！', '冲啊！'],
+        difficultyPreset: 'normal',
+      },
+    };
+    const response: BarkBattleGeneratedImageAsset = {
+      imageSrc: '/generated-bark-battle-assets/draft/opponent/image.webp',
+      assetId: 'asset-1',
+      sourceType: 'generated',
+      model: 'gpt-image-2',
+      size: '1024*1024',
+      taskId: 'task-1',
+      prompt: '后端拼装后的对手形象 prompt',
+    };
+
+    expect(JSON.parse(JSON.stringify(request))).toMatchObject({
+      slot: 'opponent-character',
+      config: {
+        opponentImageDescription: '蓝头带哈士奇',
+        onomatopoeia: ['轰汪！', '炸场！', '冲啊！'],
+      },
+    });
+    expect(JSON.parse(JSON.stringify(response))).toMatchObject({
+      imageSrc: '/generated-bark-battle-assets/draft/opponent/image.webp',
+      prompt: '后端拼装后的对手形象 prompt',
+    });
   });
 
   test('finish accepted player_win fixture exposes backend adjudication result', () => {

packages/shared/src/contracts/barkBattle.ts

@@ -16,31 +16,65 @@ export type BarkBattleFinishStatus =
 
 export type BarkBattlePlayTypeId = 'bark-battle';
 
+export const BARK_BATTLE_ASSET_SLOTS = [
+  'player-character',
+  'opponent-character',
+  'ui-background',
+] as const;
+
+export type BarkBattleAssetSlot = (typeof BARK_BATTLE_ASSET_SLOTS)[number];
+
 export interface BarkBattleReplacementConfig {
   playerCharacterImageSrc?: string;
   opponentCharacterImageSrc?: string;
   uiBackgroundImageSrc?: string;
-  barkSoundSrc?: string;
 }
 
+export type BarkBattleOnomatopoeia = string[];
+
 export interface BarkBattleConfigEditorPayload extends BarkBattleReplacementConfig {
   title: string;
   description?: string;
-  themePreset: string;
-  playerDogSkinPreset: string;
-  opponentDogSkinPreset: string;
+  themeDescription: string;
+  playerImageDescription: string;
+  opponentImageDescription: string;
+  onomatopoeia?: BarkBattleOnomatopoeia;
   difficultyPreset: BarkBattleDifficultyPreset;
-  leaderboardEnabled: boolean;
 }
 
 export interface BarkBattleDraftCreateRequest extends BarkBattleConfigEditorPayload {}
 
+export interface BarkBattleDraftConfigUpdateRequest
+  extends BarkBattleConfigEditorPayload {
+  draftId: string;
+  workId?: string | null;
+  configVersion?: number;
+  rulesetVersion?: string;
+}
+
 export interface BarkBattleWorkPublishRequest {
   draftId: string;
   workId: string;
   publishedSnapshot?: BarkBattleConfigEditorPayload;
 }
 
+export interface BarkBattleImageAssetGenerateRequest {
+  slot: BarkBattleAssetSlot;
+  draftId?: string | null;
+  config: BarkBattleConfigEditorPayload;
+}
+
+export interface BarkBattleGeneratedImageAsset {
+  imageSrc: string;
+  assetId: string;
+  sourceType?: 'generated' | string;
+  model: string;
+  size: string;
+  taskId: string;
+  prompt: string;
+  actualPrompt?: string;
+}
+
 export interface BarkBattleDraftConfig extends BarkBattleConfigEditorPayload {
   draftId: string;
   workId?: string;
@@ -57,19 +91,62 @@ export interface BarkBattlePublishedConfig {
   playTypeId: BarkBattlePlayTypeId;
   title: string;
   description?: string;
-  themePreset: string;
-  playerDogSkinPreset: string;
-  opponentDogSkinPreset: string;
+  themeDescription: string;
+  playerImageDescription: string;
+  opponentImageDescription: string;
+  onomatopoeia?: BarkBattleOnomatopoeia;
   playerCharacterImageSrc?: string;
   opponentCharacterImageSrc?: string;
   uiBackgroundImageSrc?: string;
-  barkSoundSrc?: string;
   difficultyPreset: BarkBattleDifficultyPreset;
-  leaderboardEnabled: boolean;
   updatedAt: string;
   publishedAt: string;
 }
 
+export type BarkBattleWorkStatus = 'draft' | 'published';
+
+export type BarkBattleGenerationStatus =
+  | 'pending_assets'
+  | 'ready'
+  | 'partial_failed'
+  | string;
+
+export interface BarkBattleWorkSummary {
+  workId: string;
+  draftId?: string | null;
+  ownerUserId: string;
+  authorDisplayName: string;
+  title: string;
+  summary: string;
+  themeDescription: string;
+  playerImageDescription: string;
+  opponentImageDescription: string;
+  onomatopoeia?: BarkBattleOnomatopoeia;
+  playerCharacterImageSrc?: string | null;
+  opponentCharacterImageSrc?: string | null;
+  uiBackgroundImageSrc?: string | null;
+  difficultyPreset: BarkBattleDifficultyPreset;
+  status: BarkBattleWorkStatus;
+  generationStatus?: BarkBattleGenerationStatus | null;
+  publishReady: boolean;
+  playCount: number;
+  finishCount?: number;
+  winCount?: number;
+  drawCount?: number;
+  lossCount?: number;
+  recentPlayCount7d?: number;
+  updatedAt: string;
+  publishedAt?: string | null;
+}
+
+export interface BarkBattleWorksResponse {
+  items: BarkBattleWorkSummary[];
+}
+
+export interface BarkBattleWorkDetailResponse {
+  item: BarkBattleWorkSummary;
+}
+
 export interface BarkBattleRuntimeConfig {
   workId: string;
   configVersion: number;
@@ -81,14 +158,13 @@ export interface BarkBattleRuntimeConfig {
   drawThreshold: number;
   minBarkGapMs: number;
   difficultyPreset: BarkBattleDifficultyPreset;
-  themePreset: string;
-  playerDogSkinPreset: string;
-  opponentDogSkinPreset: string;
+  themeDescription: string;
+  playerImageDescription: string;
+  opponentImageDescription: string;
+  onomatopoeia?: BarkBattleOnomatopoeia;
   playerCharacterImageSrc?: string;
   opponentCharacterImageSrc?: string;
   uiBackgroundImageSrc?: string;
-  barkSoundSrc?: string;
-  leaderboardEnabled: boolean;
   updatedAt: string;
 }
 

server-rs/crates/api-server/src/app.rs

@@ -1001,6 +1001,7 @@ mod tests {
             "/generated-puzzle-assets/session-1/candidate/image.png",
             "/generated-custom-world-scenes/world-1/camp/scene.png",
             "/generated-custom-world-covers/world-1/cover.webp",
+            "/generated-bark-battle-assets/draft/player/image.webp",
             "/generated-qwen-sprites/master/candidate-01.png",
         ] {
             let response = app

server-rs/crates/api-server/src/creation_entry_config.rs

@@ -174,6 +174,25 @@ mod tests {
         assert_eq!(resolve_creation_entry_route_id("/healthz"), None);
     }
 
+    #[test]
+    fn test_creation_entry_config_response_opens_bark_battle() {
+        let config = test_creation_entry_config_response();
+        let bark_battle = config
+            .creation_types
+            .iter()
+            .find(|item| item.id == "bark-battle")
+            .expect("test creation entry config should include bark-battle");
+
+        assert_eq!(bark_battle.title, "汪汪声浪");
+        assert!(bark_battle.visible);
+        assert!(bark_battle.open);
+        assert_eq!(bark_battle.badge, "可创建");
+        assert_eq!(
+            bark_battle.image_src,
+            "/creation-type-references/bark-battle.webp"
+        );
+    }
+
     #[test]
     fn test_creation_entry_config_response_keeps_baby_object_match_coming_soon() {
         let config = test_creation_entry_config_response();

server-rs/crates/api-server/src/match3d/draft.rs

@@ -532,7 +532,9 @@ fn build_config_from_message(
     }
 }
 
-pub(super) fn resolve_config_or_default(config: Option<&Match3DCreatorConfigRecord>) -> Match3DConfigJson {
+pub(super) fn resolve_config_or_default(
+    config: Option<&Match3DCreatorConfigRecord>,
+) -> Match3DConfigJson {
     config
         .map(|config| Match3DConfigJson {
             theme_text: config.theme_text.clone(),
@@ -595,7 +597,10 @@ fn build_match3d_assistant_reply(config: &Match3DConfigJson) -> String {
     )
 }
 
-pub(super) fn build_match3d_assistant_reply_for_turn(config: &Match3DConfigJson, current_turn: u32) -> String {
+pub(super) fn build_match3d_assistant_reply_for_turn(
+    config: &Match3DConfigJson,
+    current_turn: u32,
+) -> String {
     match current_turn {
         0 => MATCH3D_QUESTION_THEME.to_string(),
         1 => MATCH3D_QUESTION_CLEAR_COUNT.to_string(),

server-rs/crates/api-server/src/match3d/item_assets.rs

@@ -1040,7 +1040,10 @@ pub(super) fn build_fallback_match3d_background_prompt(config: &Match3DConfigJso
     )
 }
 
-pub(super) fn build_fallback_match3d_item_sound_prompt(config: &Match3DConfigJson, item_name: &str) -> String {
+pub(super) fn build_fallback_match3d_item_sound_prompt(
+    config: &Match3DConfigJson,
+    item_name: &str,
+) -> String {
     let theme = config.theme_text.trim();
     let normalized_theme = if theme.is_empty() { "抓大鹅" } else { theme };
     normalize_match3d_audio_prompt(
@@ -1416,7 +1419,9 @@ fn resolve_match3d_material_cell_crop(
     crop.to_crop_tuple()
 }
 
-pub(super) fn crop_match3d_material_view_edge_matte(image: image::DynamicImage) -> image::DynamicImage {
+pub(super) fn crop_match3d_material_view_edge_matte(
+    image: image::DynamicImage,
+) -> image::DynamicImage {
     let mut image = image.to_rgba8();
     let (width, height) = image.dimensions();
     remove_match3d_material_view_edge_matte(image.as_mut(), width as usize, height as usize);

server-rs/crates/api-server/src/match3d/mappers.rs

@@ -134,12 +134,11 @@ pub(super) fn map_match3d_draft_response(
     draft: Match3DResultDraftRecord,
 ) -> Match3DResultDraftResponse {
     // 中文注释：session draft 自身也可能携带生成素材快照，不能只依赖 work detail 回读补齐 UI 背景和容器图。
-    let generated_item_assets = parse_match3d_generated_item_assets(
-        draft.generated_item_assets_json.as_deref(),
-    )
-    .into_iter()
-    .map(Match3DGeneratedItemAsset::from)
-    .collect::<Vec<_>>();
+    let generated_item_assets =
+        parse_match3d_generated_item_assets(draft.generated_item_assets_json.as_deref())
+            .into_iter()
+            .map(Match3DGeneratedItemAsset::from)
+            .collect::<Vec<_>>();
     let background_asset = find_match3d_generated_background_asset(&generated_item_assets);
     let mut response = Match3DResultDraftResponse {
         profile_id: draft.profile_id,

server-rs/crates/api-server/src/match3d/works.rs

@@ -587,7 +587,10 @@ async fn load_match3d_container_reference_image() -> Result<OpenAiReferenceImage
     })
 }
 
-pub(super) fn build_match3d_background_generation_prompt(config: &Match3DConfigJson, prompt: &str) -> String {
+pub(super) fn build_match3d_background_generation_prompt(
+    config: &Match3DConfigJson,
+    prompt: &str,
+) -> String {
     let style_clause = resolve_match3d_asset_style_prompt(config)
         .map(|style| format!("整体美术风格参考：{style}。"))
         .unwrap_or_default();
@@ -596,7 +599,10 @@ pub(super) fn build_match3d_background_generation_prompt(config: &Match3DConfigJ
     )
 }
 
-pub(super) fn build_match3d_container_generation_prompt(config: &Match3DConfigJson, prompt: &str) -> String {
+pub(super) fn build_match3d_container_generation_prompt(
+    config: &Match3DConfigJson,
+    prompt: &str,
+) -> String {
     let style_clause = resolve_match3d_asset_style_prompt(config)
         .map(|style| format!("整体美术风格参考：{style}。"))
         .unwrap_or_default();
@@ -1183,7 +1189,9 @@ pub(super) async fn persist_match3d_generated_bytes(
     })
 }
 
-pub(super) fn require_match3d_oss_client(state: &AppState) -> Result<&platform_oss::OssClient, AppError> {
+pub(super) fn require_match3d_oss_client(
+    state: &AppState,
+) -> Result<&platform_oss::OssClient, AppError> {
     state
         .oss_client()
         .ok_or_else(|| match3d_oss_config_error(&state.config))

server-rs/crates/api-server/src/modules/bark_battle.rs

@@ -7,7 +7,9 @@ use crate::{
     auth::require_bearer_auth,
     bark_battle::{
         create_bark_battle_draft, finish_bark_battle_run, get_bark_battle_run,
-        get_bark_battle_runtime_config, publish_bark_battle_work, start_bark_battle_run,
+        generate_bark_battle_image_asset, get_bark_battle_runtime_config,
+        list_bark_battle_gallery, list_bark_battle_works, publish_bark_battle_work,
+        start_bark_battle_run, update_bark_battle_draft_config,
     },
     state::AppState,
 };
@@ -21,6 +23,20 @@ pub fn router(state: AppState) -> Router<AppState> {
                 require_bearer_auth,
             )),
         )
+        .route(
+            "/api/creation/bark-battle/drafts/{draft_id}/config",
+            post(update_bark_battle_draft_config).route_layer(middleware::from_fn_with_state(
+                state.clone(),
+                require_bearer_auth,
+            )),
+        )
+        .route(
+            "/api/creation/bark-battle/images/generate",
+            post(generate_bark_battle_image_asset).route_layer(middleware::from_fn_with_state(
+                state.clone(),
+                require_bearer_auth,
+            )),
+        )
         .route(
             "/api/creation/bark-battle/works/publish",
             post(publish_bark_battle_work).route_layer(middleware::from_fn_with_state(
@@ -28,6 +44,17 @@ pub fn router(state: AppState) -> Router<AppState> {
                 require_bearer_auth,
             )),
         )
+        .route(
+            "/api/runtime/bark-battle/works",
+            get(list_bark_battle_works).route_layer(middleware::from_fn_with_state(
+                state.clone(),
+                require_bearer_auth,
+            )),
+        )
+        .route(
+            "/api/runtime/bark-battle/gallery",
+            get(list_bark_battle_gallery),
+        )
         .route(
             "/api/runtime/bark-battle/works/{work_id}/config",
             get(get_bark_battle_runtime_config).route_layer(middleware::from_fn_with_state(

server-rs/crates/api-server/src/process_metrics.rs

@@ -199,11 +199,9 @@ fn cpu_usage_ratio_between_samples(
 
 #[cfg(windows)]
 fn collect_process_metrics() -> Result<ProcessMetricsSnapshot, String> {
-    use windows_sys::Win32::{
-        System::{
-            ProcessStatus::{GetProcessMemoryInfo, PROCESS_MEMORY_COUNTERS_EX},
-            Threading::{GetCurrentProcess, GetCurrentProcessId, GetProcessHandleCount},
-        },
+    use windows_sys::Win32::System::{
+        ProcessStatus::{GetProcessMemoryInfo, PROCESS_MEMORY_COUNTERS_EX},
+        Threading::{GetCurrentProcess, GetCurrentProcessId, GetProcessHandleCount},
     };
 
     let handle = unsafe { GetCurrentProcess() };
@@ -212,11 +210,7 @@ fn collect_process_metrics() -> Result<ProcessMetricsSnapshot, String> {
         ..Default::default()
     };
     let ok = unsafe {
-        GetProcessMemoryInfo(
-            handle,
-            std::ptr::addr_of_mut!(counters).cast(),
-            counters.cb,
-        )
+        GetProcessMemoryInfo(handle, std::ptr::addr_of_mut!(counters).cast(), counters.cb)
     };
     if ok == 0 {
         return Err("GetProcessMemoryInfo returned false".to_string());
@@ -244,10 +238,7 @@ fn collect_process_metrics() -> Result<ProcessMetricsSnapshot, String> {
 
 #[cfg(windows)]
 fn windows_process_cpu_time_seconds(handle: windows_sys::Win32::Foundation::HANDLE) -> Option<f64> {
-    use windows_sys::Win32::{
-        Foundation::FILETIME,
-        System::Threading::GetProcessTimes,
-    };
+    use windows_sys::Win32::{Foundation::FILETIME, System::Threading::GetProcessTimes};
 
     let mut creation_time = FILETIME::default();
     let mut exit_time = FILETIME::default();
@@ -337,8 +328,8 @@ fn collect_process_metrics() -> Result<ProcessMetricsSnapshot, String> {
         .ok_or_else(|| "missing VmSize/statm size field".to_string())?;
     let private_bytes = parse_status_kb(&status, "VmData:").map(|value| value * 1024);
     let cpu_time_seconds = linux_cpu_time_seconds(&stat)?;
-    let thread_count = parse_status_u64(&status, "Threads:")
-        .ok_or_else(|| "missing Threads field".to_string())?;
+    let thread_count =
+        parse_status_u64(&status, "Threads:").ok_or_else(|| "missing Threads field".to_string())?;
 
     Ok(ProcessMetricsSnapshot {
         rss_bytes,
@@ -427,11 +418,7 @@ fn parse_status_u64(status: &str, key: &str) -> Option<u64> {
 
 #[cfg(target_os = "linux")]
 fn parse_statm_pages(statm: &str, index: usize) -> Option<u64> {
-    statm
-        .split_whitespace()
-        .nth(index)?
-        .parse::<u64>()
-        .ok()
+    statm.split_whitespace().nth(index)?.parse::<u64>().ok()
 }
 
 #[cfg(not(any(windows, target_os = "linux")))]

server-rs/crates/module-bark-battle/src/domain.rs

@@ -72,7 +72,7 @@ impl BarkBattleRuleset {
             standard_duration_ms: 30_000,
             min_duration_ms: 28_000,
             max_duration_ms: 35_000,
-            min_bark_gap_ms: 250,
+            min_bark_gap_ms: 150,
             trigger_count_tolerance: 2,
             min_volume: 0.0,
             max_volume: 1.0,

server-rs/crates/module-bark-battle/src/scoring.rs

@@ -174,6 +174,7 @@ mod tests {
     #[test]
     fn flags_trigger_count_above_physical_limit_with_tolerance() {
         let ruleset = BarkBattleRuleset::v1();
+        assert_eq!(ruleset.min_bark_gap_ms, 150);
         let mut input = metrics(30_000);
         input.trigger_count = input.duration_ms / ruleset.min_bark_gap_ms
             + u64::from(ruleset.trigger_count_tolerance)

server-rs/crates/module-runtime/src/application.rs

@@ -142,10 +142,10 @@ pub fn default_creation_entry_type_snapshots(
             "bark-battle",
             "汪汪声浪",
             "声控对战挑战",
-            "敬请期待",
-            "/creation-type-references/creative-agent.webp",
+            "可创建",
+            "/creation-type-references/bark-battle.webp",
+            true,
             true,
-            false,
             85,
             updated_at_micros,
         ),

server-rs/crates/module-runtime/src/lib.rs

@@ -246,9 +246,13 @@ mod tests {
 
         assert_eq!(bark_battle.title, "汪汪声浪");
         assert!(bark_battle.visible);
-        assert!(!bark_battle.open);
-        assert_eq!(bark_battle.badge, "敬请期待");
+        assert!(bark_battle.open);
+        assert_eq!(bark_battle.badge, "可创建");
         assert_eq!(bark_battle.sort_order, 85);
+        assert_eq!(
+            bark_battle.image_src,
+            "/creation-type-references/bark-battle.webp"
+        );
     }
 
     #[test]
@@ -522,8 +526,9 @@ mod tests {
 
     #[test]
     fn runtime_profile_beijing_day_key_uses_business_day_boundary() {
-        let before_beijing_midnight = 1_714_927_999_999_999;
-        let after_beijing_midnight = 1_714_928_000_000_000;
+        // 中文注释：2024-05-06 00:00:00 Asia/Shanghai 前后 1 微秒。
+        let before_beijing_midnight = 1_714_924_799_999_999;
+        let after_beijing_midnight = 1_714_924_800_000_000;
 
         assert_eq!(
             runtime_profile_beijing_day_key(before_beijing_midnight),

server-rs/crates/platform-oss/src/lib.rs

@@ -20,7 +20,7 @@ const OSS_V4_REQUEST: &str = "aliyun_v4_request";
 const OSS_V4_SERVICE: &str = "oss";
 const OSS_UNSIGNED_PAYLOAD: &str = "UNSIGNED-PAYLOAD";
 
-pub const LEGACY_PUBLIC_PREFIXES: [&str; 10] = [
+pub const LEGACY_PUBLIC_PREFIXES: [&str; 11] = [
     "generated-character-drafts",
     "generated-characters",
     "generated-animations",
@@ -30,6 +30,7 @@ pub const LEGACY_PUBLIC_PREFIXES: [&str; 10] = [
     "generated-puzzle-assets",
     "generated-custom-world-scenes",
     "generated-custom-world-covers",
+    "generated-bark-battle-assets",
     "generated-qwen-sprites",
 ];
 
@@ -51,6 +52,7 @@ pub enum LegacyAssetPrefix {
     PuzzleAssets,
     CustomWorldScenes,
     CustomWorldCovers,
+    BarkBattleAssets,
     QwenSprites,
 }
 
@@ -238,6 +240,7 @@ impl LegacyAssetPrefix {
             "generated-puzzle-assets" => Some(Self::PuzzleAssets),
             "generated-custom-world-scenes" => Some(Self::CustomWorldScenes),
             "generated-custom-world-covers" => Some(Self::CustomWorldCovers),
+            "generated-bark-battle-assets" => Some(Self::BarkBattleAssets),
             "generated-qwen-sprites" => Some(Self::QwenSprites),
             _ => None,
         }
@@ -254,6 +257,7 @@ impl LegacyAssetPrefix {
             Self::PuzzleAssets => "generated-puzzle-assets",
             Self::CustomWorldScenes => "generated-custom-world-scenes",
             Self::CustomWorldCovers => "generated-custom-world-covers",
+            Self::BarkBattleAssets => "generated-bark-battle-assets",
             Self::QwenSprites => "generated-qwen-sprites",
         }
     }
@@ -1315,6 +1319,7 @@ mod tests {
         );
         assert!(LEGACY_PUBLIC_PREFIXES.contains(&"generated-puzzle-assets"));
         assert!(LEGACY_PUBLIC_PREFIXES.contains(&"generated-match3d-assets"));
+        assert!(LEGACY_PUBLIC_PREFIXES.contains(&"generated-bark-battle-assets"));
         assert_eq!(LegacyAssetPrefix::parse("unknown"), None);
     }
 

server-rs/crates/spacetime-client/src/bark_battle.rs

@@ -1,4 +1,5 @@
 use super::*;
+use std::collections::HashMap;
 
 pub type BarkBattleDraftCreateRecordInput = BarkBattleDraftCreateInput;
 pub type BarkBattleDraftConfigUpsertRecordInput = BarkBattleDraftConfigUpsertInput;
@@ -44,6 +45,32 @@ impl SpacetimeClient {
         .await
     }
 
+    pub async fn get_bark_battle_draft_config(
+        &self,
+        draft_id: String,
+        owner_user_id: String,
+    ) -> Result<BarkBattleDraftConfigRecord, SpacetimeClientError> {
+        self.read_after_connect("get_bark_battle_draft_config", move |connection| {
+            let row = connection
+                .db()
+                .bark_battle_draft_config()
+                .draft_id()
+                .find(&draft_id)
+                .ok_or_else(|| {
+                    SpacetimeClientError::procedure_failed(Some(
+                        "bark_battle draft 不存在".to_string(),
+                    ))
+                })?;
+            if row.owner_user_id != owner_user_id {
+                return Err(SpacetimeClientError::procedure_failed(Some(
+                    "bark_battle draft owner 不匹配".to_string(),
+                )));
+            }
+            Ok(map_bark_battle_draft_config_row(row))
+        })
+        .await
+    }
+
     pub async fn publish_bark_battle_work(
         &self,
         input: BarkBattleWorkPublishRecordInput,
@@ -142,4 +169,83 @@ impl SpacetimeClient {
         })
         .await
     }
+
+    pub async fn list_bark_battle_works(
+        &self,
+        owner_user_id: String,
+    ) -> Result<Vec<serde_json::Value>, SpacetimeClientError> {
+        self.read_after_connect("list_bark_battle_works", move |connection| {
+            let owner_user_id = owner_user_id.as_str();
+            let drafts: Vec<serde_json::Value> = connection
+                .db()
+                .bark_battle_draft_config()
+                .iter()
+                .filter(|row| row.owner_user_id == owner_user_id)
+                .map(map_bark_battle_draft_config_row)
+                .collect();
+            let published: Vec<serde_json::Value> = connection
+                .db()
+                .bark_battle_published_config()
+                .iter()
+                .filter(|row| row.owner_user_id == owner_user_id)
+                .map(map_bark_battle_published_config_row)
+                .collect();
+
+            let mut works_by_id: HashMap<String, serde_json::Value> = HashMap::new();
+            for work in published.into_iter().chain(drafts) {
+                let Some(work_id) = work
+                    .get("workId")
+                    .and_then(serde_json::Value::as_str)
+                    .filter(|value| !value.trim().is_empty())
+                    .map(ToString::to_string)
+                else {
+                    continue;
+                };
+                works_by_id.entry(work_id).or_insert(work);
+            }
+
+            let mut works: Vec<serde_json::Value> = works_by_id.into_values().collect();
+            works.sort_by(|left: &serde_json::Value, right: &serde_json::Value| {
+                let left_updated_at = left
+                    .get("updatedAtMicros")
+                    .and_then(serde_json::Value::as_i64)
+                    .unwrap_or_default();
+                let right_updated_at = right
+                    .get("updatedAtMicros")
+                    .and_then(serde_json::Value::as_i64)
+                    .unwrap_or_default();
+                right_updated_at.cmp(&left_updated_at)
+            });
+            Ok(works)
+        })
+        .await
+    }
+
+    pub async fn list_bark_battle_gallery(
+        &self,
+    ) -> Result<Vec<serde_json::Value>, SpacetimeClientError> {
+        self.read_after_connect("list_bark_battle_gallery", move |connection| {
+            let recent_play_counts = public_work_recent_play_counts(connection, "bark-battle");
+            let mut items = connection
+                .db()
+                .bark_battle_gallery_view()
+                .iter()
+                .collect::<Vec<_>>();
+            items.sort_by(|left, right| {
+                right
+                    .updated_at_micros
+                    .cmp(&left.updated_at_micros)
+                    .then_with(|| left.work_id.cmp(&right.work_id))
+            });
+            Ok(items
+                .into_iter()
+                .map(|item| {
+                    let recent_play_count_7d =
+                        recent_play_counts.get(&item.work_id).copied().unwrap_or(0);
+                    map_bark_battle_gallery_view_row(item, recent_play_count_7d)
+                })
+                .collect())
+        })
+        .await
+    }
 }

server-rs/crates/spacetime-client/src/lib.rs

@@ -550,6 +550,7 @@ impl SpacetimeClient {
     ) -> Result<Vec<SubscriptionHandle>, SpacetimeClientError> {
         let mut subscriptions = Vec::new();
         for query in [
+            "SELECT * FROM bark_battle_gallery_view",
             "SELECT * FROM puzzle_gallery_card_view",
             "SELECT * FROM custom_world_gallery_entry",
             "SELECT * FROM match_3_d_gallery_view",
@@ -570,6 +571,7 @@ impl SpacetimeClient {
             "SELECT * FROM public_work_play_daily_stat WHERE source_type = 'square-hole'",
             "SELECT * FROM public_work_play_daily_stat WHERE source_type = 'visual-novel'",
             "SELECT * FROM public_work_play_daily_stat WHERE source_type = 'big-fish'",
+            "SELECT * FROM public_work_play_daily_stat WHERE source_type = 'bark-battle'",
             "SELECT * FROM creation_entry_config",
             "SELECT * FROM creation_entry_type_config",
         ] {

server-rs/crates/spacetime-client/src/mapper.rs

@@ -112,8 +112,9 @@ pub(crate) use self::auth::{
     map_auth_store_snapshot_import_procedure_result, map_auth_store_snapshot_procedure_result,
 };
 pub(crate) use self::bark_battle::{
-    map_bark_battle_draft_config_procedure_result, map_bark_battle_run_procedure_result,
-    map_bark_battle_runtime_config_procedure_result,
+    map_bark_battle_draft_config_procedure_result, map_bark_battle_draft_config_row,
+    map_bark_battle_gallery_view_row, map_bark_battle_published_config_row,
+    map_bark_battle_run_procedure_result, map_bark_battle_runtime_config_procedure_result,
 };
 pub(crate) use self::big_fish::{
     map_big_fish_gallery_view_row, map_big_fish_run_procedure_result,