GenarrativeAI/Genarrative
10
0
Fork 0
Code Issues 22 Pull Requests 6 Actions Packages Projects 1 Releases Wiki Activity
5,104 Commits 27 Branches 4 Tags
643ffedfb61557ee55912530a25bc0d14b23f012
Commit Graph

1272 Commits

Author SHA1 Message Date
k88936 2877ede719 3D 面板的栅格覆盖不再依赖规则先后顺序 
- src/index.css：`--model3d` 面板的 grid/width/gap 覆盖把 `--image` 一起写进选择器提高特异性。它与 `--image` 的声明特异性相同，此前只靠 `--model3d` 排在后面取胜，规则顺序一变就会退回两栏布局
 2026-09-24 17:33:25 +08:00
k88936 0d2c81a3ce 画布导出的目录名单一来源 
- src/components/image-editor/useImageCanvasAssetExportWorkflow.ts：images / media / 3d_models 三个目录名提成 EXPORT_FOLDER 常量，建目录、挑目录与按层分流共用同一份字面量（写错目录名不会编译报错，只会在 zip 里悄悄换目录）
 2026-09-24 17:33:02 +08:00
k88936 9c2a9383fc 3D 两个生成模式也随失焦与关闭收起面板 
- src/components/image-editor/ImageCanvasGenerationDialogModel.ts：hideGeneratedLayerComposerAfterBlur 与 closeGenerateComposerDialog 的模式清单补上 model3d-text-to-model / model3d-image-to-model，此前点空白画布或关闭操作都收不起 3D 面板（其它生成模式都能收起）
- src/components/image-editor/ImageCanvasGenerationDialogModel.test.ts：补两个 3D 模式的收起断言
 2026-09-24 17:32:39 +08:00
k88936 946c101630 画布没接住任务状态时按失败收口 
- src/components/image-editor/model3d-generation/useModel3dGenerationTask.ts：applyQueuedGeneration 返回 false 时不再静默复位成 idle（用户会以为没提交过、再点一次就是又一次已扣费的外部生成），改为写回失败态与明确文案
- src/components/image-editor/model3d-generation/Model3dGenerationSubmission.ts：新增 MODEL3D_QUEUE_HANDOFF_FAILED_MESSAGE，与「服务端没返回任务状态」区分开
- src/components/image-editor/model3d-generation/useModel3dGenerationTask.test.tsx：原「回到空闲态」用例改为断言失败态
 2026-09-24 17:32:13 +08:00
k88936 3455b7a00f 3D 提交失败路径也刷新钱包余额 
- src/components/image-editor/model3d-generation/useModel3dGenerationTask.ts：请求失败与「2xx 但没有任务状态」两条路径都调用 onWalletBalanceMayHaveChanged，与其它画布生成链路的 runEditorGenerationWithWalletRefresh 同一口径（超时或空 body 的 2xx 都可能已经扣费）
- src/components/image-editor/model3d-generation/useModel3dGenerationTask.test.tsx：补两条失败路径各刷新一次钱包的断言
 2026-09-24 17:31:28 +08:00
k88936 5ba7a993de 3D 提交编排整段落在错误边界内 
- src/components/image-editor/model3d-generation/useModel3dGenerationTask.ts：把取占位框、算结果标题与构造提交计划一并移进 try，注入的回调或老快照缺字段导致的抛错不再漏成未捕获 rejection，而是照常写回失败态与提示
- src/components/image-editor/model3d-generation/useModel3dGenerationTask.test.tsx：补「计划构造阶段抛错」的用例（缺 prompt 的老快照）
 2026-09-24 17:30:53 +08:00
k88936 2350c56f2f 3D 失败提示只透出服务端给的文案 
- src/components/image-editor/model3d-generation/Model3dGenerationSubmission.ts：resolveModel3dGenerationErrorMessage 只对 ApiClientError 原样透出 message；原生 SyntaxError（2xx 但 body 不是 JSON）与其它运行时 TypeError 的英文技术文案不再直接显示给用户
- src/components/image-editor/model3d-generation/Model3dGenerationSubmission.test.ts、useModel3dGenerationTask.test.tsx：用例改用 ApiClientError 构造服务端文案，并补非服务端错误退回兜底文案的断言
 2026-09-24 17:30:01 +08:00
k88936 96b52ae7ee 提交计划把非图生模式显式判为不支持 
- src/components/image-editor/model3d-generation/Model3dGenerationSubmission.ts：图生分支之后补显式模式判断，契约将来新增端点时直接失败关闭，而不是静默按文生请求发出、丢掉新端点的输入
 2026-09-24 17:28:46 +08:00
k88936 8d17855133 提交计划去掉无人读取的 title 字段 
- src/components/image-editor/model3d-generation/Model3dGenerationSubmission.ts：Model3dSubmissionPlanBase.title 没有任何消费方（调用方自己按 resolveModel3dResultTitle 重算），删除该字段与它的装配代码，避免把死数据当成权威标题
 2026-09-24 17:28:29 +08:00
k88936 bc68a9e884 查看器未知失败原因退回兜底文案 
- src/components/image-editor/model3d-preview/Model3dViewerModel.ts：default 分支保留 `never` 的编译期穷尽检查，但运行时（宿主与查看器版本错配）改回 fallbackText，不再把原始原因码当用户文案显示
 2026-09-24 17:28:02 +08:00
k88936 7b8bbac098 报价缺价文案提成具名常量 
- src/components/image-editor/model3d-generation/Model3dGenerationFormModel.ts：底价缺失与加价项缺失两句文案按模块既有约定提成 MODEL3D_PRICING_MISSING_BASE_PRICE_REASON 与 resolveModel3dPricingMissingAddOnReason，不再散落在计算路径里
 2026-09-24 17:27:37 +08:00
k88936 fe44054aa2 退役模型版本在报价与提交路径上一起回落默认版本 
- src/components/image-editor/model3d-generation/Model3dGenerationFormModel.ts：resolveModel3dModelVersion 改为走 normalizeModel3dModelVersion，老快照里契约中已不存在的版本不再直接进 MODEL3D_MODEL_TABLE 查表（原来会抛异常），报价与提交体也不会分裂成两个版本；此前该归一化函数只有测试在用
- src/components/image-editor/model3d-generation/Model3dGenerationFormModel.test.ts：补 resolveModel3dModelVersion 收到退役版本的用例
 2026-09-24 17:27:17 +08:00
k88936 9840f17189 模型版本判据不再认下原型链上的键 
- src/components/image-editor/model3d-generation/Model3dGenerationValidation.ts：isModel3dModelVersion 改用 Object.hasOwn，`toString` / `__proto__` 这类继承键不再被判成契约版本（之后查表会拿到 undefined）
- src/components/image-editor/model3d-generation/Model3dGenerationFormModel.test.ts：补原型链键回落默认版本的用例
 2026-09-24 17:26:49 +08:00
k88936 3191ca9d89 3D 面板的重试代次改在点击时铸造 
- src/components/image-editor/model3d-generation/Model3dGenerationModal.tsx：失败态下的代次刷新由渲染体里的常量改为点击时调用的 resolveSubmitDialog()，提交键不再随每次重渲染（含 StrictMode 双渲染）变化，渲染保持纯函数
 2026-09-24 17:26:17 +08:00
k88936 cd5218535e 3D 面板参考图菜单的边界 refs 数组稳定下来 
- src/components/image-editor/model3d-generation/Model3dGenerationModal.tsx：boundaryRefs 用 useMemo 缓存，避免每次渲染都新建数组导致浮层 dismiss effect 反复解绑/重挂 document 监听
 2026-09-24 17:26:02 +08:00
k88936 89b8211b94 生成中禁用图生 3D 参考图的删除按钮 
- src/components/image-editor/model3d-generation/Model3dGenerationForm.tsx：已选参考图槽位补 disabled={disabled}，提交中不再能删掉这次请求用的参考图，与面板其余控件的禁用口径一致
 2026-09-24 17:25:37 +08:00
k88936 fb0be97609 图生 3D 的素材库空确认不再清掉已选参考图 
- src/components/image-editor/ImageCanvasGenerationDialogModel.ts：单槽对话框只在素材库确实选到了图时才做「替换」，空确认退回原行为（保留画布点选/上传的那张）。此前确认按钮不校验空选，空确认会把已有参考图直接清掉
- src/components/image-editor/projectAssetReferencePickerModel.test.ts：补空确认保留画布参考图的用例
 2026-09-24 17:25:16 +08:00
k88936 ff38eb0308 Merge remote-tracking branch 'origin/master' into feat/tribo3d-integeration
Project CI / AI game creator shell Rust crates (pull_request) Successful in 1m38s
Details
Project CI / AI game creator shell Rust smoke (pull_request) Successful in 2m4s
Details
Project CI / Backend tests (pull_request) Successful in 5m5s
Details
Project CI / Native shell tests (pull_request) Successful in 6m21s
Details
Project CI / Frontend tests (pull_request) Successful in 2m20s
Details
Project CI / AI game creator shell Rust lane 2/2 (pull_request) Successful in 9m11s
Details
Project CI / Repository checks (pull_request) Failing after 1m42s
Details
Project CI / AI game creator shell Rust lane 1/2 (pull_request) Successful in 10m13s
Details
Project CI / AI game creator shell web tests (pull_request) Failing after 1m29s
Details 
# Conflicts:
#	docs/project-memory/shared-memory/decision-log.md
#	docs/project-memory/shared-memory/pitfalls.md
 2026-09-24 15:28:01 +08:00
k88936 42c3186e13 3D 生成面板开放模型版本选择，参数按模型能力门禁
Project CI / AI game creator shell Rust crates (pull_request) Successful in 1m35s
Details
Project CI / Backend tests (pull_request) Failing after 14s
Details
Project CI / AI game creator shell Rust smoke (pull_request) Has been cancelled
Details
Project CI / Frontend tests (pull_request) Has been cancelled
Details
Project CI / Repository checks (pull_request) Has been cancelled
Details
Project CI / AI game creator shell web tests (pull_request) Has been cancelled
Details
Project CI / AI game creator shell Rust lane 1/2 (pull_request) Has been cancelled
Details
Project CI / AI game creator shell Rust lane 2/2 (pull_request) Has been cancelled
Details
Project CI / Native shell tests (pull_request) Has been cancelled
Details 
- Model3dGenerationValidation.ts（新）：前端唯一一份参数校验，逐条复刻 platform-tripo 的 validate_generation_options 与 api-server 的 PricingParamView::validate（模型族能力、分件三个前置条件、face_limit_bounds、平台必显式项），并给出按契约联合类型做键的 MODEL3D_MODEL_TABLE 与禁用原因文案
- Model3dGenerationFormModel：模型版本改为用户可选，可选集只取当前端点有底价的版本；报价与请求体读同一个 resolveModel3dModelVersion；换版本或切档位时按新能力收敛档位与开关并开新一代次；v2.5 的贴图档位不带 textureQuality
- Model3dGenerationForm：新增模型版本选择器（照图片面板的浮层选项形态），档位与开关按模型能力禁用并给出 title 原因
- Model3dGenerationModal：定价只读一次，模型选项与报价共用同一份快照
- Model3dGenerationSubmission / useModel3dGenerationTask：提交计划改成 endpoint 判别联合，两个端点各一个收口函数
- editorProjectClient：删掉「endpoint + 联合提交体」的单函数，改为 submitModel3dTextToModelRequest / submitModel3dImageToModelRequest 一个端点一个函数；basePrices 两层键改成契约枚举
- ImageCanvasOptionChoice.tsx（新）：把图片面板的浮层选项行抽成共享组件，3D 面板复用
- 测试：新增 Model3dGenerationValidation.test.ts（12 例），FormModel / Submission / Modal / useModel3dGenerationTask 补组合表与菜单用例，共 75 例通过
- 文档：实施计划与里程碑追加本轮口径与证据，decision-log 与 pitfalls 各记两条
 2026-09-24 14:55:06 +08:00
k88936 cc095a7620 画布底部工具栏不再横向滚动，工具放不下就换行 
- packages/image-canvas-react：共享工具栏去掉 overflow-x/scrollbar-width 的「滚动容器」语义与滚动条隐藏，改为 flex-wrap 换行，尾部工具不再被裁掉
- src/index.css：画布底部工具栏宽度上限 34rem 提到 42rem，13 个工具在桌面宽度下回到一行，窄屏按共享能力换行并居中
- apps/ai-game-creator-shell：资源画布底部工具栏删掉与共享默认重复的 overflow/flex-wrap 覆盖，只保留限宽
 2026-09-24 14:30:34 +08:00
kdletters 87e52860a7 游戏发行入口改为平台同源路径
Project CI / AI game creator shell Rust crates (push) Successful in 1m26s
Details
Project CI / AI game creator shell Rust smoke (push) Successful in 2m11s
Details
Project CI / Backend tests (push) Successful in 5m12s
Details
Project CI / AI game creator shell Rust lane 2/2 (push) Successful in 8m26s
Details
Project CI / Native shell tests (push) Successful in 6m31s
Details
Project CI / Frontend tests (push) Successful in 2m20s
Details
Project CI / Repository checks (push) Successful in 2m25s
Details
Project CI / AI game creator shell web tests (push) Successful in 1m21s
Details
Project CI / AI game creator shell Rust lane 1/2 (push) Has been cancelled
Details 
- 审核通过时由 api-server 按 gameId 派生 /games/{gameId}/ 相对路径写入公开投影，删除 AppConfig 的发行入口模板字段与读取逻辑
- 删除 deploy/env 两份示例中的 GENARRATIVE_GAME_DISTRIBUTION_RELEASE_ENTRY_TEMPLATE
- 三份 nginx 模板内联同源发行入口 location，把 /games/<gameId>/ 与子资源转发到发行网关并在边缘清空 Cookie
- SPA allowlist 补齐 components、design-system、games、games/detail、games/mine、games/play、games/publish
- 前端 normalizeGameEntryUrl 支持相对路径与同源发行路径，按当前 origin 解析并补尾斜杠，继续兼容历史绝对 URL
- 删除退役的独立来源模板 deploy/nginx/genarrative-release-origin.conf、门禁脚本 scripts/check-release-origin-config.mjs 与其 npm 脚本
- 游戏分发 e2e 脚本改为在公开投影上断言 entryUrl 等于 /games/{gameId}/
- 同步平台主规范、运维主规范、nginx README 与共享决策记录
 2026-09-24 00:21:27 +08:00
kdletters efbdf7031e 统一客户端维护态错误弹窗
Project CI / AI game creator shell Rust crates (push) Successful in 1m30s
Details
Project CI / AI game creator shell Rust smoke (push) Successful in 1m57s
Details
Project CI / Backend tests (push) Successful in 3m54s
Details
Project CI / Frontend tests (push) Successful in 2m5s
Details
Project CI / Native shell tests (push) Successful in 6m4s
Details
Project CI / AI game creator shell Rust lane 2/2 (push) Successful in 8m14s
Details
Project CI / AI game creator shell Rust lane 1/2 (push) Successful in 9m19s
Details
Project CI / AI game creator shell web tests (push) Successful in 1m23s
Details
Project CI / Repository checks (push) Successful in 1m55s
Details 
客户端维护响应统一识别并广播维护事件

AGC 与网页端根部展示维护大弹窗，收口发布、上传、资源换签和登录错误

补充维护态弹窗测试、类型检查与实施计划说明
 2026-09-23 23:16:23 +08:00
k88936 d231cc4602 合并 origin/master：保留 3D 契约与 provider checkpoint，旧玩法表随主线退役 
- server-rs/crates/shared-contracts/src/lib.rs：采用主线的模块裁剪（删掉 cfg(any()) 遗留模块、补上 agc_analytics 与 game_distribution），同时保留本分支的 editor_canvas、model3d 模块与 EDITOR_GENERATION_OPERATION_KINDS 导出
- server-rs/crates/spacetime-module/src/migration.rs：主线删除的 410 行旧玩法表 normalize 段保持删除，保留本分支的 provider_kind / provider_task_id 兼容段与对应用例
- docs/【开发运维】本地开发验证与生产运维-2026-05-15.md：校验清单同时保留 Tripo 3D 生成任务与 editor_background_music_generation / model3d_text_to_model / model3d_image_to_model
- .gitignore：补回本分支新增的 3D 模型文件忽略规则（*.glb / *.gltf 等 12 行），压测数据段随主线一并删除
- 共享记忆：本分支的 3D 决策与踩坑条目保留在主线重排后的 decision-log.md 与 pitfalls.md 中
 2026-09-23 19:39:30 +08:00
kdletters c2c5e1ced5 发行包上限提升到 200 MiB 并支持 AGC 分片续传上传 
- 发行包上限 100→200 MiB、展开总量 250→500 MiB，整包路由请求体上限继续从包上限派生；发行静态资源进程内缓存预算提到 256 MiB
- 反代放行量同步放宽到 210 MiB：Nginx 三份模板的 client_max_body_size、Pingora 网关默认值与 env 样例、路由对照矩阵
- platform-oss 新增内部对象追加写 append_internal_object(_with_retry)，以 OSS 返回的 next-append-position 作为权威已收字节
- api-server 新增 upload-state / chunk / complete / reset 四条分片路由，抽出共享收口 confirm_validated_package；偏移不符返回 409 与权威偏移，校验失败删除半包并落 upload_failed
- AGC 新增原生上传器 game_package_upload.rs（内容寻址暂存、分片续传、受控重试、进度事件）与 prepare / upload 两条命令，退役整包回传命令
- 渲染进程改为 prepare → 创建游戏 → 创建版本 → 原生分片上传 → 送审，LocalProjectExportPackagePayload 整包类型退役
- 同时修正 live 用例无法指向本地栈的两处基础设施问题：平台基址按传入 URL 选择，桥接层把 jsdom realm 的 Headers / Blob / FormData 降级成 Node 原生值
- 测试：platform-oss 74、api-server game_distribution 23、AGC 原生 4、发布相关前端 20；live 用例补真实栈「中断 → 续传 → 确认」断言（分片偏移序列 [0, 8388608]）
- 文档：玩法创作主规范的上传合同、运维与 Pingora 文档、决策记录、发行里程碑口径，以及新增的续传里程碑与实施计划
 2026-09-23 19:06:02 +08:00
k88936 5ebc6df6ae 3D 失败态下主按钮也开新一代，不再重现同一次失败 
- Model3dGenerationModal 主按钮与「重试」共用失败态重置后的 dialog（refreshModel3dAttemptNonce），失败态点主按钮不再沿用旧幂等键
- 新增用例：失败态主按钮提交的代次必须变化、状态回到 idle，且按钮保持可点
 2026-09-23 18:51:15 +08:00
kdletters e072c66ce9 修复 AGC 模板库筛选与卡片状态的表现缺陷
Project CI / AI game creator shell Rust lane 1/2 (push) Has been cancelled
Details
Project CI / AI game creator shell Rust lane 2/2 (push) Has been cancelled
Details
Project CI / Backend tests (push) Has been cancelled
Details
Project CI / Native shell tests (push) Has been cancelled
Details
Project CI / Frontend tests (push) Has been cancelled
Details
Project CI / Repository checks (push) Has been cancelled
Details
Project CI / AI game creator shell Rust crates (push) Has been cancelled
Details
Project CI / AI game creator shell web tests (push) Has been cancelled
Details
Project CI / AI game creator shell Rust smoke (push) Has been cancelled
Details 
- 模板库筛选区改用共享筛选条与标签 chip：选中为实心品牌填充 + 反白文字，未选为浅底描边
- 未选中悬停不再借用品牌色（品牌色专属已选中），状态阶梯固定为静止 / 悬停 / 按下 / 选中
- 新增 getPlatformCategoryChipClassName 收敛筛选 chip 类名口径，模板库、资源画布、参考图弹窗与平台 Web 端共用
- PlatformSegmentedTabs 增加 accent 选中口径，与筛选 chip 共用 --platform-chip-* 语义色
- 修复卡片文字区按 grid auto 行排版导致的标题 / 简介 / 标签被裁：行高契约拆为分项常量，文字区固定 174
- 修复忙状态下动作行塞入第三个元素导致的按钮文案换行顶出卡片：忙状态写在触发它的按钮上
- 修复经典滚动条占宽导致的卡片区横向滚动条：按竖滚动条预留列宽后再算列宽行高
- 焦点环由 15% 透明度改为实心色并用 outline 绘制，选中项聚焦不再被状态投影盖掉
- 封面加载失败改为隐藏图片留中性底色，不再出现浏览器裂图图标
- 补充状态对比度、行高契约、滚动条预留、封面兜底与忙状态文案的回归测试
- 同步技术方案、踩坑记录与决策记录的口径
 2026-09-23 16:51:15 +08:00
k88936 a4132616d8 3D 产物 content type 只认字节或槽位白名单，去掉兜底 
- 删除 fallback_extension 与「未知声明原样放行 + 扩展名兜底」的归一逻辑
- 槽位白名单收敛为唯一映射表（content type ↔ 对象键扩展名），跨槽位类型返回 None
- resolve_artifact_content_type 改为返回 Result：字节认不出且声明不在白名单时按 502 失败，
  不再把 text/plain 之类的声明连同拼出来的 .glb 扩展名落进 OSS 与 asset_object
- 错误体只回显截断到 64 字符的声明值，避免把任意长度的 provider 文本带进响应
- 重写 storage 测试：新增白名单外声明、跨槽位类型与字节认不出三类用例
- 同步技术方案：说明白名单范围与「不做任何兜底」的口径
 2026-09-23 16:39:15 +08:00
k88936 a753ac4cd8 3D 前端提交跟随其它画布生成工具同时落素材库 
- buildModel3dSubmissionPlan 接收当前素材夹与素材名，与图片/图标/音效等工具一样同时发 projectId + assetFolderId + assetLabel（素材名缺省回落本次结果标题），没有素材夹时只发 projectId。
- useModel3dGenerationTask 新增 assetFolderId 入参，画布生成链路把当前素材夹透传下来；结果仍走既有画布路径读回，刷新素材库沿用 applyGeneratedProjectSnapshot 的既有行为，不新增 3D 专用刷新。
- 素材库行加 model3d 分支：缩略图按预览图（asset.src）渲染，objectKey（模型本体 .glb）不参与图片签名，与画布 3D 卡片的 objectKey={null} 口径一致，避免素材行去加载模型文件。
- 用例补齐：请求体同时带两个落点、无素材夹时不带 assetFolderId/assetLabel、素材夹只 trim 且素材名回落标题，以及素材行 3D 预览不签模型对象键 / 普通图片仍按 objectKey 换签名地址。
- 验证：npx vitest run src/components/image-editor/model3d-generation src/components/image-editor/ImageCanvasAssetRowView.test.tsx（67 passed）、npm run typecheck、check:encoding / git diff --check 通过。
 2026-09-23 15:54:39 +08:00
k88936 f659ddfcf0 3D 生成前端提交体跟随平坦落点契约 
- buildModel3dSubmissionPlan 不再拼 tagged target，把 projectId 与 canvasCompletion 直接摊进请求体；画布链路仍只落项目资源。
- submitModel3dGenerationRequest 的提交体注释同步落点字段改名。
- 请求体、幂等键与排队用例改为断言扁平落点字段。
- 定向验证：npx vitest run src/components/image-editor/model3d-generation src/components/image-editor/model3d-preview（63 passed）、npm run typecheck 通过。
 2026-09-23 14:02:57 +08:00
kdletters e5460280ce 发布入口接入灰度开关
Project CI / AI game creator shell Rust lane 1/2 (pull_request) Has been cancelled
Details
Project CI / AI game creator shell Rust lane 2/2 (pull_request) Has been cancelled
Details
Project CI / AI game creator shell Rust smoke (pull_request) Has been cancelled
Details
Project CI / AI game creator shell Rust crates (pull_request) Has been cancelled
Details
Project CI / Backend tests (pull_request) Has been cancelled
Details
Project CI / Native shell tests (pull_request) Has been cancelled
Details
Project CI / Frontend tests (pull_request) Has been cancelled
Details
Project CI / Repository checks (pull_request) Has been cancelled
Details
Project CI / AI game creator shell web tests (pull_request) Has been cancelled
Details 
- 后端：GET /api/runtime/frontend-config 新增 gameDistributionPublishEnabled，复用 `game-distribution:publish` 判据（未配置或 enabled=false 时对已登录作者默认开放，显式收紧后只放行白名单/灰度命中用户，匿名恒为 false），前端入口与写入口共用同一事实源。
- 后端用例：新增 frontend_runtime_config_game_distribution_publish_is_scoped_to_authenticated_gate，覆盖默认开放、enabled=true 无白名单、白名单命中、deny 名单、enabled=false 回退与 rolloutPercent=100。
- 网页：平台壳按灰度隐藏「发布游戏 / 发布新版本」入口；/games/publish 直接访问时渲染「发布功能正在灰度中」并提供重新检查；读取失败按放行处理，由后端写入口把关并返回可读文案。
- AGC：新增 readGamePublishAvailability（同一运行时配置字段），只有命中才把发布回调交给 DirectProject 聊天头；字段缺失或读取失败按不开放处理。
- 文档：玩法链路、后端数据契约与实施计划记录灰度口径、入口行为与验证命令。
 2026-09-22 17:12:04 +08:00
k88936 caafb8baa3 3D 提交体改用端点契约类型而非 Record 
- Model3dSubmissionPlan.body 与 submitModel3dGenerationRequest 的 body 收紧为两个端点请求契约
- 提交计划按端点分支分别构造 text-to-model / image-to-model 请求体
- 幂等键入参同步收紧，测试夹具按契约补全 body
 2026-09-22 17:04:11 +08:00
k88936 4e46202c10 3D 提交收到无任务状态的成功响应不再静默复位 
- 新增 MODEL3D_SUBMISSION_MISSING_QUEUE_STATE_MESSAGE 提示文案
- 空 body 或缺 status 的 2xx 响应改判失败态并保留提示，不再直接回 idle
- 补用例断言不再触发排队链路且对话框进入失败态
 2026-09-22 17:00:13 +08:00
k88936 00eed191c5 3D 提交把兜底铸的尝试代次写回对话框状态 
- 新增 resolveModel3dAttemptNonce，提交计划带出本次实际使用的代次
- 提交编排在进入 generating 时把该代次写回 dialog，缺代次的老快照不再每次换键
- 补老快照场景用例，断言幂等键前缀与写回的代次一致
 2026-09-22 16:59:18 +08:00
k88936 62f1ca4537 3D 提交失败提示不再直接显示传输层英文文案 
- resolveModel3dGenerationErrorMessage 对超时单独给出中文可重试提示
- fetch 失败与中断收敛到中文兜底，服务端文案仍原样透出
- 补服务端文案透出、传输层兜底与超时提示的用例
 2026-09-22 16:57:55 +08:00
kdletters f1b282f3cd 合并 master 并接入 DirectProject 新聊天架构 
- 合并 origin/master（304 个提交：DirectProject 聊天容器重构、Project Supervisor 退役、策划附件导入、CI 隔离编译缓存等）。
- 接受 master 对 ProjectSupervisorView / SupervisorChatOnlyView 的退役与预览快捷测试收敛；发布入口改由 DirectProject 聊天头承载。
- DirectProjectChatHeader 新增「发布到游戏广场」入口（无回调不渲染、回合忙态禁用），DirectProjectChatView 透传 onRequestGamePublish。
- App.tsx 继续由工作台壳持有试玩包导出与 GameDistributionPublishPanel，沿用 project.export_package 权限确认队列；check-config 把该命令从 native-only 清单移回 App invoke。
- 后台游戏审核 API / 类型 / 路由测试与 master 新增的 AGC 模板管理按双方保留合并，并修掉拼接造成的接口与用例闭合缺陷。
- 修正 master 自带的 viteProxyConfig 断言：/api/creation-entry 属退役路由，测试改为断言不进入代理。
- 记录合并踩坑：语法结构内部的冲突不能简单按「双方保留」拼接，必须按某一侧骨架重建并跑 tsc 与单文件测试。
- 验证：全量 vitest 393 文件 / 4374 用例通过，root / AGC / admin-web 三端 typecheck，cargo check 与游戏分发 Rust 测试，encoding、doc-index、rustfmt、SpacetimeDB schema guard。
 2026-09-22 16:45:29 +08:00
k88936 cb136fb445 画布图层的媒体渲染分派抽成独立函数 
- src/components/image-editor/ImageCanvasWorldView.tsx：音频 / 视频 / 序列帧 / model3d / 默认图片这条五层三元链提成 renderCanvasLayerMedia（早返回写成一列判断），渲染分支与传参不变，新增媒体类型不再加深三元

验证：npx vitest run src/components/image-editor/ImageCanvasWorldView.test.tsx（57 用例全绿）、npm run typecheck
 2026-09-22 13:33:14 +08:00
k88936 d1478e3859 文生 / 图生 3D 面板入口合并到同一个 opener 
- src/components/image-editor/useImageCanvasGenerationWorkflow.ts：新增 openModel3dGenerationDialog(mode)，openModel3dTextToModelDialog / openModel3dImageToModelDialog 退化成两个只传 mode 的薄包装；两条入口此前是除 mode 外逐字相同的复制，改逻辑时容易只改一处

验证：npm run typecheck
 2026-09-22 13:31:48 +08:00
k88936 b41d156edd 底部工具栏的子选项锚点 ref 改用查表 
- src/components/image-editor/ImageCanvasBottomToolbarView.tsx：把 spec / music / model3d / publication 的三层三元 ref 选择链提成 toolWrapRefs 映射表，新增子选项时不再延长三元链

验证：npx vitest run src/components/image-editor/ImageCanvasBottomToolbarView.test.tsx（3 用例全绿）、npm run typecheck
 2026-09-22 13:31:46 +08:00
k88936 4363a6219a 修正查看器失败文案穷尽检查的写法（上一提交未通过类型检查） 
- src/components/image-editor/model3d-preview/Model3dViewerModel.ts：上一提交把 never 断言写在 switch (detail?.reason) 上，default 分支里可选链未被收窄，npm run typecheck 报 TS2322（undefined 不能赋给 never）。改为先取局部常量并早返回「原因缺失 / load-failed」，switch 只处理其余三种原因，default 保留 never 断言
- 文案与判定结果不变

验证：npm run typecheck（tsconfig.typecheck-guardrails，exit 0）；临时给 Model3dViewerFailureReason 增加一个成员，确认该 default 分支会编译报错（TS2322），随后已还原；npx vitest run src/components/image-editor/model3d-preview（18 用例全绿）
 2026-09-22 13:31:24 +08:00
k88936 0ec0a13cbc 关闭 3D 预览面板时清掉查看器状态 
- src/components/image-editor/model3d-preview/Model3dViewerModal.tsx：layer 变 null（面板关闭）时把 viewerStatus 复位，下一次打开从禁用的「重置视角」开始，不再继承上一轮实例的 ready；只处理关闭不处理换模型，避免 effect 晚于查看器上报而盖掉 loading
- src/components/image-editor/model3d-preview/Model3dViewerModal.test.tsx：新增「关闭后重开不沿用 ready」的回归用例

验证：npx vitest run src/components/image-editor/model3d-preview（18 用例全绿）
 2026-09-22 13:29:10 +08:00
k88936 c96d7fe847 查看器失败文案改用穷尽 switch 
- src/components/image-editor/model3d-preview/Model3dViewerModel.ts：resolveModel3dViewerFailureText 从早返回改成 switch，并给 default 加 never 穷尽检查；查看器今后新增失败原因会在此处编译报错，而不是静默落到通用兜底文案。文案与判定结果不变

验证：npx vitest run src/components/image-editor/model3d-preview、npx tsc -p tsconfig.typecheck-guardrails.json --noEmit
 2026-09-22 13:28:14 +08:00
k88936 8131a70a2f 失败态的重试按钮也按 canSubmit 门禁渲染 
- src/components/image-editor/model3d-generation/Model3dGenerationModal.tsx：重试按钮改为 dialog.status === 'failed' && canSubmit 才渲染；此前定价失效或参考图未上传完时它仍可点，提交管线再挡回来，交互上表现为「点了没反应」

验证：npx vitest run src/components/image-editor/model3d-generation/Model3dGenerationModal.test.tsx（8 用例全绿）
 2026-09-22 13:27:39 +08:00
k88936 73f34ecbc9 前端补上「分件 + 方形布线 / 智能低多边形」的互斥校验 
- src/components/image-editor/model3d-generation/Model3dGenerationFormModel.ts：resolveModel3dGenerationParams 增加 generateParts 与 quad / smartLowPoly 的互斥判定，与 provider 的 validate_generation_options 对齐；此前纯几何档位下这两个开关仍可同开，前端能出价、提交后才被后端拒
- src/components/image-editor/model3d-generation/Model3dGenerationFormModel.test.ts：新增该组合被拒的用例

验证：npx vitest run src/components/image-editor/model3d-generation（40 用例全绿）
 2026-09-22 13:26:49 +08:00
k88936 25fe98836f 幂等键指纹的键排序改成具名比较函数 
- src/components/image-editor/model3d-generation/Model3dGenerationSubmission.ts：canonicalizeModel3dRequestValue 里的嵌套三元比较器提成模块级 compareModel3dRequestEntryKeys，排序结果不变，只是不再嵌三元且不必每次递归重建比较器

验证：npx vitest run src/components/image-editor/model3d-generation（39 用例全绿）
 2026-09-22 13:26:28 +08:00
k88936 b48c34d6b4 删掉重复且无人使用的 3D 提交超时常量 
- src/components/image-editor/model3d-generation/Model3dGenerationSubmission.ts：删除 MODEL3D_SUBMISSION_TIMEOUT_MS；实际生效的是 editorProjectClient 的 EDITOR_MODEL3D_SUBMISSION_TIMEOUT_MS（submitModel3dGenerationRequest 用它），保留两份 60_000 只会各自漂移

验证：全仓库检索该常量只剩定义处（已删）；npx tsc -p tsconfig.typecheck-guardrails.json --noEmit
 2026-09-22 13:26:00 +08:00
k88936 5bdabdc7f7 3D 提交计划在非 3D 模式改用专门的原因文案 
- src/components/image-editor/model3d-generation/Model3dGenerationSubmission.ts：buildModel3dSubmissionPlan 的 mode 兜底改用 MODEL3D_MODE_UNSUPPORTED_REASON，不再把非 3D 面板说成「3D 模型定价尚未配置」

验证：npx vitest run src/components/image-editor/model3d-generation
 2026-09-22 13:25:38 +08:00
k88936 9b1c99f37b 非 3D 面板不再复用「定价未配置」这句原因 
- src/components/image-editor/model3d-generation/Model3dGenerationFormModel.ts：新增 MODEL3D_MODE_UNSUPPORTED_REASON，resolveModel3dGenerationQuote 在 mode 不是 3D 生成模式时返回它；原文案会把「模式不支持」误报成定价配置问题

验证：npx vitest run src/components/image-editor/model3d-generation
 2026-09-22 13:25:37 +08:00
k88936 9a62941779 贴图质量映射抽成单一函数，去掉嵌套三元 
- src/components/image-editor/model3d-generation/Model3dGenerationFormModel.ts：resolveModel3dGenerationParams 里的贴图质量嵌套三元提成 resolveModel3dTextureQuality(tier)，取值与判定条件不变

验证：npx vitest run src/components/image-editor/model3d-generation
 2026-09-22 13:25:22 +08:00
k88936 7987fed204 删掉无人引用的 MODEL3D_IMAGE_PROMPT_MAX_LENGTH 
- src/components/image-editor/model3d-generation/Model3dGenerationFormModel.ts：删除只导出、全仓库无引用的图生 3D 提示词长度常量；文生上限与画布尺寸常量仍在使用

验证：全仓库检索该常量只剩定义处；npx tsc -p tsconfig.typecheck-guardrails.json --noEmit
 2026-09-22 13:25:18 +08:00
k88936 02df355281 3D 提交地址改成按 endpoint 穷尽映射 
- src/services/image-editor/editorProjectClient.ts：新增 EDITOR_MODEL3D_ENDPOINT_API（Record<Model3dPricingEndpoint, string>）取代三元判断；原写法对非 image-to-model 的值一律回落 text-to-model，endpoint 联合扩容时会静默走错接口

验证：npx tsc -p tsconfig.typecheck-guardrails.json --noEmit
 2026-09-22 13:24:43 +08:00