优化 AGC 发布资料与截图交互

发布门禁阻断提示改为独立弹窗且不写入聊天记录移除发布面板发行包技术摘要新增免费发布简介与分类建议接口和前端回填接入封面泥点定价、确认与生成流程截图改为并行上传，单张失败隔离且不阻断发布截图操作改为图标，失败项内嵌错误与删除同步发布合同、实施计划和决策记录
2026-09-23 17:40:08 +08:00
parent 64018f9661
commit 297d7bf1e7
15 changed files with 1816 additions and 335 deletions
@@ -26,10 +26,19 @@
 - 验证方式：`npx tsc -p apps/ai-game-creator-shell/tsconfig.json --noEmit`、`npm run --workspace apps/ai-game-creator-shell typecheck`（含 `check-config.mjs` 的脚本与门禁一致性）、`npx vitest run apps/ai-game-creator-shell/tests/appSurface.test.ts`、`cargo check --tests`（告警消息集与基线一致）、`npm run check:encoding`、`git diff --check`；保留的 e2e 套件为 `supervisor-swarm`、`-transient-retry`、`-final-reply-transient-retry`、`-tool-plan-handoff-runner-kill`、`goal-runtime`、`response-stream`、`web-search`、`context-compaction`、`scoped-agents`、`project-skill`、`parallel-read`、`steer-runner-kill`、`process-session`。
 - 关联文档：[【ADR】退役AGC项目对话斜杠命令与终端swarm chat入口-2026-09-22](../../adr/【ADR】退役AGC项目对话斜杠命令与终端swarm chat入口-2026-09-22.md)、[【里程碑】退役AGC项目对话斜杠命令与终端swarm chat入口-2026-09-22](../plans/【里程碑】退役AGC项目对话斜杠命令与终端swarm chat入口-2026-09-22.md)、`docs/technical/【技术方案】AI游戏创作智能体App实施计划-2026-06-24.md`。

+## 2026-09-23 AGC 发布资料免费生成与封面泥点生成
+
+- 背景：AGC 发布面板仍展示 ZIP 路径、文件数和体积，同时一句话简介只取创作目标、分类固定为“其他”，封面只能手选；这与发布页应隐藏技术信息、使用创作上下文降低填写成本的目标不一致。
+- 决策：发布面板移除发行包技术摘要。简介和分类由 AGC 调用平台内部免费文本模型生成，输入仅限有界、脱敏的项目名称、创作目标、任务状态、素材类型和最近编辑摘要；生成失败保留本地兜底，不扣用户泥点且不阻断发布。分类始终收敛到七类白名单。
+- 决策：封面支持基于项目上下文生成，复用现役编辑器图片生成接口和泥点扣费 wrapper；按钮与确认弹窗显示后端运行时定价对应的具体泥点数。服务端返回的 `assetObjectId` 直接作为 `coverAssetId`，禁止生成后再直传导致素材身份分叉。生成失败原因留在发布面板内。
+- 决策：发布截图同批并行上传；成功缩略图在鼠标移入时显示“删除｜预览”，失败缩略图在图片内显示错误并保留独立删除按钮。单张失败只跳过该张，不阻断同批上传或发布。
+- 边界：网页发布表单、游戏分发审核 API、SpacetimeDB schema、外部 `/api/external/v1` OpenAPI 均不变；临时项目上下文不落库、不进聊天记录。
+- 验证：AGC 发布面板与发布 service 定向 vitest、api-server 发布资料 parser/route 测试、AGC 与 api-server 类型/编译检查、编码和 diff 检查。
+
 ## 2026-09-23 AGC 发布前先守可运行原型门禁

 - 背景：客户端已经显示“首个可运行原型尚未完成，运行视图暂不可用”，但发布入口仍会先执行用户项目的 `build`，导致未完成原型也进入构建并在后续失败。
- 决策：`project.export_package` 的发布专用导出链路先检查可玩入口；没有入口时，只有 `code-prototype` 已完成或存在运行中的预览才允许执行 `build`，否则直接返回“首个可运行原型尚未完成，暂不能发布”。发布不再进入聊天确认卡，改为独立全屏进度弹窗；运行中遮罩覆盖整个工作区并阻止交互，失败留在弹窗内，成功后切换到发布资料面板。
+- 决策：`project.export_package` 的发布专用导出链路先检查可玩入口；没有入口时，只有 `code-prototype` 已完成或存在运行中的预览才允许执行 `build`，否则直接返回“首个可运行原型尚未完成，暂不能发布”。发布阻断反馈使用独立提示弹窗，不写入 Direct 聊天记录；发布过程不再进入聊天确认卡，改为独立全屏进度弹窗；运行中遮罩覆盖整个工作区并阻止交互，失败留在弹窗内，成功后切换到发布资料面板。
 - 边界：已有可运行入口仍直接打包；原型已完成但缺构建产物时保留原有自动构建；缺失 `exports/README.md` 仍在导出前自动生成。
 - 验证：Rust `publish_export` 4/4、前端发布相关测试 16/16、AGC `tsc`、编码检查和 `git diff --check` 通过。