1255 Commits

Author	SHA1	Message	Date
k88936	ff38eb0308	Merge remote-tracking branch 'origin/master' into feat/tribo3d-integeration ... # 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 生成面板开放模型版本选择，参数按模型能力门禁 ... - 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	游戏发行入口改为平台同源路径 ... - 审核通过时由 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	统一客户端维护态错误弹窗 ... 客户端维护响应统一识别并广播维护事件 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 模板库筛选与卡片状态的表现缺陷 ... - 模板库筛选区改用共享筛选条与标签 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	发布入口接入灰度开关 ... - 后端：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
k88936	5d47ef9347	3D 提交的「不自动重试」选项改回 retry 字段 ... - src/services/image-editor/editorProjectClient.ts：submitModel3dGenerationRequest 把 EDITOR_GENERATION_REQUEST_RETRY_OPTIONS 从顶层展开改成 retry 字段；requestJson 只认 options.retry，顶层展开的 maxRetries / retryUnsafeMethods 会被静默忽略，计费 POST 的「不自动重试」意图丢失（当前只是靠 POST 默认 maxRetries=0 侥幸不重试） 验证：文件内 9 处生成入口现在统一使用 retry 字段	2026-09-22 13:24:22 +08:00
k88936	fc8a674e91	3D 模型角标改用 Tailwind v4 可用的类与专用 CSS 规则 ... - src/index.css：新增 .image-canvas-editor__kind-badge--model3d 规则，背景与阴影沿用原取值，与其它 asset kind 的写法一致 - src/components/image-editor/ImageCanvasWorldView.tsx：model3d 角标改成引用该规则；原写法用 Tailwind v3 的 `!` 前缀（v4 改后缀），实际不会生成工具类，角标退化成白字无底色的白药丸 验证：npx prettier --check src/index.css src/components/image-editor/ImageCanvasWorldView.tsx	2026-09-22 13:23:24 +08:00
k88936	f1d0aed7dd	3D 生成面板补上浮动菜单的 portal 与定位参数 ... - src/components/image-editor/ImageCanvasGenerationComposerView.tsx：Model3dGenerationModal 传入 renderEditorPortal / buildPortalMenuStyle，与同文件其余生成面板一致；此前走默认的恒等实现，「参考图来源」菜单内联在文档流里且没有定位样式 验证：npx tsc -p tsconfig.typecheck-guardrails.json --noEmit	2026-09-22 13:22:44 +08:00
k88936	93002f1bd2	统一 model3d 查看器状态类型命名：Model3DViewerStatus 改回 Model3dViewerStatus ... - packages/model3d-viewer/src/status.ts：状态类型改名，与同文件的 Model3dViewerFailureReason / Model3dViewerStatusDetail 以及仓库既有 Model3d* 口径一致 - packages/model3d-viewer/src/Model3DViewer.tsx、packages/model3d-viewer/src/index.ts：跟随改名更新导入与引用 - src/components/image-editor/model3d-preview/Model3dViewerModal.tsx：跟随改名更新导入与状态类型引用 验证：npx tsc -p tsconfig.typecheck-guardrails.json --noEmit、npm run lint:eslint（改动文件）	2026-09-22 13:16:05 +08:00
k88936	10e63ecb6b	合并 origin/master 到 feat/tribo3d-integeration：ts-rs 一律常开、Cargo 清单去重 ... - server-rs/Cargo.toml：删除与 workspace git 固定重复的 registry `ts-rs = "12.0.1"`，保留固定 commit 并写明「ts-rs 一律常开、绑定命令固定为 cargo test -p shared-contracts export_bindings」 - server-rs/crates/shared-contracts/Cargo.toml：删除 master 侧新增的 `ts-bindings` feature，`ts-rs` 保持常开依赖 - server-rs/crates/shared-contracts/src/game_creation_app/asset_kind.rs：去掉 `cfg_attr(feature = "ts-bindings", …)` 门控，derive 与字段级 `ts(...)` 无条件展开 - apps/ai-game-creator-shell/src-tauri/Cargo.toml：shared-contracts 依赖去掉 `features = ["ts-bindings"]`，继续保留本分支的 ts-rs git 固定 - apps/ai-game-creator-shell/src-tauri/Cargo.lock：按上述依赖变更同步（shared-contracts 指向 git 源 ts-rs） - docs：同步 5 处绑定生成命令（去掉 `--features ts-bindings`），并在 decision-log 记本次合并的决策、代价与验证 - 其余暂存改动为 origin/master 带入的内容，冲突按两侧目的逐一合并 验证：cargo metadata --locked（server-rs 与 AGC 两个 workspace）、cargo test -p shared-contracts（119 + 5 + 5 + 2 + 2 全绿且无告警）、npm run contracts:model3d:generate 后 packages/shared 零 diff、cargo check -p spacetime-module --target wasm32-unknown-unknown、npm run check:encoding、npm run check:rustfmt、npm run check:spacetime-schema、git diff --check、暂存集 eslint / prettier 全过	2026-09-22 13:12:28 +08:00
k88936	61fe4c48af	图片画布接入 3D 资源：新增 model3d 类别、3D 预览与 3D 生成入口 ... - 后端资源投影按 asset_kind 分叉，新增 project_editor_client_media_src 与 EDITOR_MODEL3D_ASSET_KIND：model3d 只投影预览图，模型本体只留 objectKey，预览缺失才回落历史口径 - tripo3d 存储新增按字节魔数识别模型 content_type 与扩展名映射，不采信 provider 声明与下载响应头 - editor_project_storage 把 model3d 加入 EDITOR_CANVAS_ASSET_KINDS 白名单 - 前端 CanvasAssetKind 与 image-canvas-core 类型新增 model3d：画布卡片渲染预览图或 3D 占位，类型角标新增「3D模型」，覆盖资格只在它与空类别之间成立 - 新增 model3d-preview 子目录（Model3dViewerModal / Model3dViewerModel），Tailwind 内联、不新增 CSS，失败原因分超限 / 格式不可识别 / 无 WebGL2 三类展示 - 选中工具条新增只读 preview-model3d 能力位，仅 objectKey 为空时置灰；打开预览同时选中图层并暂停画布快捷键与舞台交互 - 查看器包源对象 format 改为可选，新增「声明 Content-Type → 字节魔数 → 地址扩展名」三级格式判定并导出支持格式清单 - 导出工作流新增 3d_models/ 目录，模型下载按真实响应头 MIME 定扩展名、对象键扩展名兜底 - 新增 3D 生成入口：底部工具栏浮动子选项与文生 / 图生 3D 面板，落 projectResource + canvasCompletion，复用占位框与任务侧栏 - 3D 定价只读实时定价查询，段缺失即入口不可提交；幂等键由前端铸造，用户重试必须换键 - 新增 ADR 0003 / 0004 与实施计划、里程碑文档；更新 Tripo 技术方案、后端架构、CONTEXT 术语、decision-log 与 pitfalls - .gitignore 忽略仓库根目录手工下载的 3D 样例模型	2026-09-22 10:10:00 +08:00
k88936	6981648796	合并 origin/master：Supervisor 永久退役，项目对话收敛为 DirectProject 与 Design Agent ... - 解决 refactor/split-direct-project 与 origin/master 在 App.tsx、立项策划聊天视图、Direct composer/引用输入区、styles.css、Rust direct user item 与 appSurface 用例上的冲突，按「Supervisor 永久退役」口径保留 DirectProject 独立聊天容器与 Design Agent 两条产品路径 - 采纳 master 的策划 Agent V1/V2 退役：删除 GDD 审批卡、策划输入卡、planningLane、planningSessionV2、planningSessionContract、规划展示适配与 Rust planning_*_v2 命令、模块、契约及对应用例，不保留兼容别名或双跑路径 - 把 master「折叠思考显示单行预览」的目的落到当前结构：新增共享表现 chat/components/AgentReasoning/AgentReasoning.tsx（折叠态单行纯文本预览 + 箭头、展开态安全 Markdown），DirectProject 回合与策划回合共用，删掉两处写死的 pre 折叠实现 - 把 master「策划入口可选模型 / 推理档」的目的接到当前策划输入盒：复用 ConversationModelSelect 与 ComposerReasoningEffortSelect，配置写回仍走客户端配置通道 - App.tsx 删除只服务退役 Supervisor / 策划 V2 的 state、ref、effect、回调与死参数，并删除两条读路径都退役后的 workspaceProjectKind；openWorkspace 的工程类型入参保留为未使用契约 - Rust 侧保留本分支 canonical→wire 投影、无审计 Direct 回合与 direct user item 严格校验，并入 master 的 prepare_new_web_project_at 前置复核 - 更新 ADR 与 shared-memory 决策记录：策划当前只有 Design Agent、两条路径的共享表现清单，以及本次合并的口径、代价与验证证据 - 验证：AGC 与仓库 typecheck、check:encoding、check:doc-index、git diff --check、改动文件 eslint 0 error；AGC vitest 168 个文件中除 5 个 jsdom localStorage 环境失败文件与本分支既有 resourceTagStatsRefresh 失败外全绿，appSurface 198 passed / 13 skipped；Rust 定向用例 direct_codex_user_item、skill_pack、sessions 全过（整套分片在本容器受 /sbin -> usr/bin 触发沙箱预检失败，与本合并无关）	2026-09-21 21:09:34 +08:00
suzmii	de502e9bc3	替换面板改为非模态浮层，支持在画布上点选替换目标 ... - 共享选择组件新增 opt-in nonModal：不铺遮罩、不做焦点陷阱、限高 + 内部滚动，Esc 在 document 阶段截断后取消，关掉即卸载；网页端美术画布不传，弹窗行为逐字不变。 - 新增 initialSelectionRevision：面板开着时宿主换了目标才重同步当前选择，面板里的搜索词与分类筛选不被重置。 - AGC 侧把候选面板锚到画布右上角（任务开关下方），壳样式放共享样式表、宿主只负责锚定；面板开着时画布照常可点，点中合法候选落成面板当前选择，写入仍只由「确认」发起。 - 退役旧的「点选替换」按钮、画布提示条与 resourceReplacementPickMode：同一个功能不留两条 UI 路径；合法性判据仍复用 resolveResourceReplacementPick，写入仍是同一个 confirm 函数。 - 确认时用画布点选结果兜底，避免点完当帧按确认误报「请选择一个替换素材」。 - 测试：替换用例 4 条点选路径改写为非模态 + 面板点选（含四类非法目标在面板内报因、Esc 只收面板），新增「画布点选不清掉面板搜索/分类」；共享组件用例新增 nonModal 形态与浮层壳声明级契约。 - 文档：PRD 5.3 / 7.8 第 8 条改写、验收用例 S15a 改写、decision-log 新增 2026-09-21 条目、待办文档登记三项并勾掉对应需求。	2026-09-21 03:48:40 +08:00
suzmii	55259683b8	删除角色动画面板里重复回显提示词的「动画描述」行 ... - 共享组件 ImageCanvasCharacterAnimationPanelView 不再渲染只读的生成文本回显（与上方输入区内容重复，且两个宿主都没有为它定义样式） - 用例同步：原断言「生成文本：…」改为钉住该节点不再渲染，并保留「输入区确实收下这段文本」的检查	2026-09-21 00:28:26 +08:00
kdletters	5ac7f65c92	合并 master 并保留游戏分发功能 ... - 合并 origin/master（含 429f991bd 定向回滚、Godot 原生绑定迁移与策划 Agent 模型控件）。 - 回滚提交删除的游戏分发代码按功能面补回：SpacetimeDB 模块注册与迁移表、api-server 路由与权限映射、后台审核页、AGC 发布命令与 payload 类型、SelectionStage 的 games 阶段、ProjectSupervisorView 的 overlay 挂载点、主站路由与标题、Cargo 依赖与锁、vite/vitest 代理与 tailwind source。 - 保留 master 的 Godot C++ 迁移（移除旧 vendored GDExtension、新的 composer 控件布局）与其它 master 侧改动。 - 修正 master 自带的红灯断言：/api/creation-entry 已被 api-server 列入退役路由，dev 中间件按退役路径 404，测试改为断言不进入代理。 - 验证：cargo check（api-server / spacetime-module / spacetime-client / AGC 壳）、cargo test（api-server 游戏分发 17、module-game-distribution 11、AGC 本地导出 7）、全量 vitest 4557 passed、两端 typecheck、eslint、rustfmt、编码、文档索引与 SpacetimeDB schema guard。	2026-09-21 00:20:45 +08:00
kdletters	2f0e2a48a3	把游戏分发客户端纳入 ESLint 边界 ... - `.eslintrc.cjs`：`src/services/gameDistributionClient.ts` 及其测试加入活跃服务白名单，不再被遗留忽略列表吞掉。 - 客户端：按仓库规则修掉排序与未使用类型导入（顺带移除两个只在 re-export 中出现的多余导入）。 - 修复 `scripts/vite-retired-css-plugin.test.ts` 的边界门禁：活跃模块不得停留在 ESLint 忽略名单里。	2026-09-20 22:56:43 +08:00
kdletters	0dde6ee501	打磨封面与截图的文件选择交互 ... - 网页发布页：封面与截图改用透明 input 覆盖自定义胶囊按钮，点击命中原生控件；上传后不再出现「未选择任何文件」与「已选择」互相矛盾的状态。 - AGC 发布面板：同一处理，按钮文案随状态在「选择封面图片 / 更换封面图片」「添加截图 / 截图已满 6 张」之间切换。 - 文档：实施计划补充真实浏览器发布链路证据（网页上传封面 → my-games 待审 → 版本 frozenMetadata 指向本次上传素材）与交互打磨记录。	2026-09-20 22:45:50 +08:00
kdletters	4a2b270714	补齐游戏分发封面与截图的冻结、上传与展示 ... - 服务端：游戏表追加可空 cover_object_key / screenshots_json，版本表追加可空 metadata_json，创建版本时校验必需封面、最多 6 张截图与图片素材归属，并从素材记录派生对象键生成冻结资料。 - 服务端：审核通过时把冻结资料整体生效到游戏行；只有已公开且存在有效活动版本的游戏，其封面/截图素材才在 /api/assets/read-url 获得匿名读授权。 - 服务端：作者与管理员回读版本时追加 frozenMetadata，带回封面与截图素材 ID 供续发复用，公开投影仍只暴露对象键。 - 网页：/games/publish 新增「封面与截图」区，复用平台图片直传与 confirm 通道，缺封面或截图超量在发请求前拦截，更新版本时按冻结资料回填且不要求重新上传。 - 网页：游戏广场卡片与详情页 hero 换签展示真实封面，详情页新增可点击的截图缩略图条，无素材或换签失败时静默回退原有渐变占位。 - AGC：发布面板支持封面必选与截图最多 6 张，新增素材直传服务并在创建游戏前拦截缺封面，同一文件重复提交复用素材 ID。 - AGC：http 能力作用域新增阿里云 OSS 直传地址，客户端同时校验直传目标必须是平台素材存储。 - 契约与文档：同步 shared-contracts、packages/shared 契约，更新 SpacetimeDB 迁移注释、后端架构、玩法链路与实施计划文档，并补齐网页端与 AGC 定向测试。	2026-09-20 22:19:50 +08:00
suzmii	a0d432b63d	Merge remote-tracking branch 'origin/master' into fix/agc-acceptance-followup	2026-09-20 21:27:23 +08:00
kdletters	429f991bde	回滚误入 master 的游戏分发 WIP（夹带在 OSS v1 签名提交里） ... - 撤销 39aed2e48 夹带的游戏分发前后端、SpacetimeDB 绑定、主站路由、后台审核页、文档与 nginx 改动，master 恢复可编译状态 - 保留该提交自身的 AGC 发号改动：agc-global-version.mjs 与其参数构造单测 - 恢复被误删的 output 产物，避免把无关清理混进该提交 - 补回两篇技术文档在 docs/README.md 的索引（它们属于后续两个补提交文档，不属于游戏分发） - 游戏分发完整实现保留在 codex/game-distribution 分支继续开发	2026-09-20 20:52:24 +08:00
kdletters	328ac31844	恢复游戏分发完整实现（特性分支） ... - 主站：游戏广场、详情、在线游玩、网页发布与作者中心，以及共享契约与客户端服务 - 后端：module-game-distribution 领域层、SpacetimeDB 表/迁移/绑定、spacetime-client facade、api-server 路由与发行网关 - 后台：游戏审核页（待审列表、通过/拒绝、安全下架） - AGC：发布面板、本地导出包读取命令与发布服务，含默认跳过的真实链路测试 - 运维：发行来源 nginx 模板与门禁、game-distribution:publish 灰度发布开关、OSS PutObject 受控重试 - 文档：主规范、里程碑与实施计划、决策日志与踩坑记录	2026-09-20 20:49:42 +08:00
suzmii	6fb17de9db	Merge remote-tracking branch 'origin/master' into fix/agc-acceptance-followup	2026-09-20 19:25:45 +08:00