392 Commits

Author	SHA1	Message	Date
k88936	5d68749534	查看器不再把 glTF 解析失败吞成「未知错误」 ... - packages/model3d-viewer/src/loader.ts：GLTFLoader 的 onError 回传 ErrorEvent，改为先取它的 message 再包成 Error 抛出，外层报错能带出真实解析原因，而不是退化成「未知错误」	2026-09-24 17:24:40 +08:00
k88936	61cfb8800d	查看器认得 ASCII FBX 的字节开头 ... - packages/model3d-viewer/src/loader.ts：字节魔数多认一种 ASCII FBX 开头（`; FBX`，Blender 等工具的默认导出），此前这批文件在没显式给 format 时会被判 unsupported-format，尽管 FBXLoader 能解析 - packages/model3d-viewer/src/loader.ts：BOM / 前导空白的跳过抽成 resolveModel3dViewerContentStart，JSON 与 ASCII FBX 两处判据共用 - packages/model3d-viewer/src/loader.test.ts：补 ASCII FBX（含前导空白）的字节判定用例	2026-09-24 17:24:28 +08:00
k88936	0c0819249d	查看器取景装配失败时释放 renderer 与模型资源 ... - packages/model3d-viewer/src/scene.ts：模型加载成功后的取景 / ResizeObserver / 渲染循环装配抽成 setupLoadedScene，由外层 try/catch 兜住；任何异常先 teardown 再抛出，避免调用方拿不到 scene 引用时漏掉 WebGL 上下文与模型 GPU 资源	2026-09-24 17:23:58 +08:00
k88936	55ce6d7129	取景距离抬到不会让轨道缩放范围颠倒的下限 ... - packages/model3d-viewer/src/framing.ts：computeModel3dViewerFitDistance 对调用方传入的距离加下限（radius × 0.2 / 8），避免 distance 过小时 maxDistance 小于 minDistance，取景与轨道钳制同时失效 - packages/model3d-viewer/src/framing.test.ts：补极小距离的下限用例	2026-09-24 17:23:31 +08:00
k88936	3624f454e2	取景视角限定在 (0, 180)，非法值回落到默认视角 ... - packages/model3d-viewer/src/framing.ts：新增 normalizeFovDegrees，fovDegrees 只在 (0, 180) 内采用，>=180 时 tan(halfFovY) 非正会把 limitY/limitX 与 fallbackDistance 算成 0 或负数，污染取景距离与 near/far - packages/model3d-viewer/src/framing.test.ts：补 180 / 360 / 0 / 负数 / NaN 回落到默认视角的用例	2026-09-24 17:23:19 +08:00
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	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
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
k88936	f198b7a6d0	multiview 视图输入显式化为 url / fileToken，线上按文档 view-key 形态发出 ... - 契约新增 Model3dViewInput（url / fileToken 的 tagged enum），views 的四个视图都改用它，裸字符串在契约层即被拒绝 - platform-tripo 不再走 SDK 的位置数组形态：按 Tripo 文档推荐的 view-key 构造 inputs，值写成显式 {url} / {file_token}，种类由契约字段决定、链路上不再猜前缀 - 视图校验（front 必填、至少两张、空白按未提供）与 inputs 构造合并成一条路径，不再两处重复规则 - 新增 4 条定向用例钉住发出的 JSON 形状、空白视图、视图数量与 taskId 复用；契约用例补齐裸字符串与视图内未知字段被拒 - 重新生成 ts-rs 绑定与导出索引，技术方案同步 multiview 输入口径	2026-09-23 18:59:05 +08:00
lhk229	c2ec978199	修复宿主继续请求重复发送原始用户输入 (#500) ... 区分首次用户请求与宿主反馈，继续时发送实际验收或错误信息 固定 GUI 和 CLI 的原始用户条目，保留历史与回合身份关联 补充结构化输入、反馈发送、图片输入和历史去重的定向回归测试 同步更新实施计划与排障记录，保持交付验收条件和预算不变 Reviewed-on: https://git.genarrative.world/git/GenarrativeAI/Genarrative/pulls/500 Co-authored-by: Linghong <ink29535@proton.me> Co-committed-by: Linghong <ink29535@proton.me>	2026-09-23 18:20:42 +08:00
kdletters	297d7bf1e7	优化 AGC 发布资料与截图交互 ... 发布门禁阻断提示改为独立弹窗且不写入聊天记录 移除发布面板发行包技术摘要 新增免费发布简介与分类建议接口和前端回填 接入封面泥点定价、确认与生成流程 截图改为并行上传，单张失败隔离且不阻断发布 截图操作改为图标，失败项内嵌错误与删除 同步发布合同、实施计划和决策记录	2026-09-23 17:40:08 +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	158f9b741d	3D 落点放宽为「至少一个」并把结果引用改成平坦字段 ... - 校验层不再要求「projectId 与 assetFolderId 恰好一个」：两个都不给 400 点名 projectId，canvasCompletion 与「没有 projectId」同现 400 点名 canvasCompletion，两个都给按合法处理；与其它画布生成工具同一口径。 - 落点预检改成对给出的每个落点逐个定点查，出错字段只在「只给一个」时点名该键，两个都给无法归因回落到 target；去掉已经没有意义的旧用法注释。 - 结果侧 Model3dGenerationTargetRef 从 tagged enum（kind=projectResource/assetLibrary）改成与请求落点同形的平坦可选字段 resourceId / assetId，两个落点都写就两个都带；生成绑定同步变宽。 - worker 的 target_ref 改为按「写了哪条落点行」分别带 ID，完成结果用例改成断言平坦字段且只落项目资源时不得凭空出现 assetId；契约测试对称覆盖「只落素材库」形态。 - 验证：cargo test -p api-server tripo3d::（56 passed）、cargo test -p shared-contracts、npm run contracts:model3d:generate、check:rustfmt / check:encoding / git diff --check 通过。	2026-09-23 15:54:07 +08:00
k88936	fd48829c24	3D 生成请求落点改为平坦可选字段并复用统一落点预检 ... - shared-contracts 的 text-to-model / image-to-model 请求用平坦可选 projectId / canvasCompletion / assetFolderId / assetLabel 取代 tagged enum target，删除 Model3dGenerationTarget 及其契约测试。 - 同步 ts-rs 生成绑定：新增四个可选字段并移除 Model3dGenerationTarget.ts 与 barrel 导出。 - api-server 校验层改按「项目资源 / 素材库二选一」校验，缺失、冲突与空白值都返回 400 并点名具体字段。 - 落点预检改用其它付费编辑器生成共用的 preflight_editor_generation_target_and_return，素材库落点不再读整库。 - worker 按平坦字段落库，素材名缺省回落到 MODEL3D_DEFAULT_ASSET_LABEL。 - 定向验证：cargo test -p shared-contracts 与 cargo test -p api-server tripo3d:: 全绿（54 passed）。	2026-09-23 14:02:44 +08:00
k88936	5285832acb	3D 查看器容器宽高比变化时按新比例重算取景 ... - framing 新增 resolveModel3dViewerReframedCameraPosition：保留朝向与相对缩放并钳进新缩放范围 - scene 的 ResizeObserver 不再只认首次尺寸，宽高比变化超过 1% 就重算取景 - resetView 改为按容器当前宽高比重算，不再复用可能过期的取景 - 首帧直接套用创建时的取景，避免重复一次顶点采样 - 补 framing 测试：朝向保留、相对缩放保留、缩放钳制与方向退化	2026-09-23 11:51:26 +08:00
k88936	f4083dcb6d	3D 查看器给签名地址的兄弟资源补回鉴权 query ... - loader 新增 resolveModel3dViewerSourceQuery / resolveModel3dViewerResourceUrl，只补模型目录下的资源地址 - glTF / FBX 解析改用带 URL 修饰器的专用 LoadingManager，不动全局 DefaultLoadingManager - 补测试：query 提取与片段剔除、目录内外的补与不补、多文件 glTF 兄弟资源解析	2026-09-23 11:48:48 +08:00
k88936	852e65f7d8	查看器字节来源注明引用必须稳定 ... - Model3DViewerSource 的 bytes 分支补充 buffer 生命周期与稳定引用要求 - 说明同内容换新引用会触发场景重建与 GPU 重传的后果	2026-09-22 16:56:19 +08:00
k88936	62bf602fb1	多视图请求 DTO 补齐字段级说明并重生成绑定 ... - Model3dMultiviewToModelRequest 每个字段补一行中文语义说明与取值范围 - 结构体补严格反序列化与组合校验归属的说明 - 重新生成 ts-rs TS 绑定，注释同步进 Model3dMultiviewToModelRequest.ts	2026-09-22 16:48:57 +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	fb9c1d0e29	查看器取消时一并中止在途的模型下载 ... - packages/model3d-viewer/src/loader.ts：readModel3dViewerSource 与 loadModel3dViewerObject 新增可选 AbortSignal，透传给 fetch；signal 已中止时抛 Model3dViewerAbortedError，不再当成 load-failed - packages/model3d-viewer/src/scene.ts：场景输入新增 signal，创建时透传给模型加载 - packages/model3d-viewer/src/Model3DViewer.tsx：加载 effect 内建 AbortController，卸载 / 换源时先 abort 再释放场景，避免下载要读完 64 MiB 才被丢弃 - packages/model3d-viewer/src/loader.test.ts：新增回归用例，断言 signal 确实交给 fetch 且中止后抛取消错误 验证：npx vitest run packages/model3d-viewer（20 用例全绿）、npx tsc 严格模式检查查看器包全部源文件	2026-09-22 13:18:40 +08:00
k88936	b71d18b166	场景释放不再强制丢失 WebGL 上下文 ... - packages/model3d-viewer/src/scene.ts：teardown 去掉 renderer.forceContextLoss()，只保留 renderer.dispose()，并写明原因；宿主 Model3DViewer 全程复用同一个 <canvas>，强制丢上下文会让下一个模型拿到已丢失的上下文渲染全黑 验证：npx tsc（严格模式单文件检查）、npx vitest run packages/model3d-viewer	2026-09-22 13:18:04 +08:00
k88936	4bcf0cdb86	释放材质时用 if/else 取代嵌套三元 ... - packages/model3d-viewer/src/scene.ts：disposeModel3dViewerObject 里把材质归一化成数组的三元链改成 if/else，展开层级与语义不变，只是去掉内层三元嵌套 验证：npx tsc（严格模式单文件检查）、npx vitest run packages/model3d-viewer	2026-09-22 13:17:43 +08:00
k88936	104656aa99	去掉 Model3DViewer 加载 effect 里冗余的 sourceKind 依赖 ... - packages/model3d-viewer/src/Model3DViewer.tsx：删除只出现在依赖数组里的 sourceKind 变量与依赖项，effect 实际只分支 sourceData / sourceUrl，kind 变化必然带动这两者之一变化 验证：npx tsc（严格模式单文件检查）、npx vitest run packages/model3d-viewer	2026-09-22 13:17:27 +08:00
k88936	de8bb9d373	取景近远裁剪面比例改为具名常量 ... - packages/model3d-viewer/src/framing.ts：把 near / far 推导里内联的 1/1000 与 10 提成 NEAR_DISTANCE_RATIO / FAR_DISTANCE_RATIO，与同文件其它比例常量口径一致，取值不变 验证：npx vitest run packages/model3d-viewer（19 用例全绿）	2026-09-22 13:17:02 +08:00
k88936	f9750bde0b	查看器取景距离改用前校验有限正数 ... - packages/model3d-viewer/src/framing.ts：computeModel3dViewerFitDistance 不再无条件采信调用方传入的 distance，改为 Number.isFinite 且大于 0 才采用，否则回落包围盒角点求解，避免 0 / 负数 / NaN 让 maxDistance 小于 minDistance 验证：npx vitest run packages/model3d-viewer、npx tsc -p tsconfig.typecheck-guardrails.json --noEmit	2026-09-22 13:16:40 +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	c0d6531e92	三个入口的seed参数在TS契约里改用bigint ... - seed 是 i64，JS number 表示不了全部取值却又没有范围校验，客户端传 64 位值会被静默舍入 - text_to_model / image_to_model / multiview_to_model 的 image_seed、model_seed、texture_seed 由 number|null 改为 bigint|null - 同步重新生成的 ts-rs 绑定，仅这三个字段变化	2026-09-21 19:38:47 +08:00
k88936	3e426a1006	容器首帧无尺寸时按真实比例重算取景 ... - 取景原先只在加载完成时按 measureViewport() 的宽高比算一次，隐藏面板里挂载时只能拿到方形兜底值 - 抽出 computeFraming(aspect)，ResizeObserver 首次量到非零尺寸后按真实比例重算并复位一次，之后不再覆盖用户的缩放	2026-09-21 15:17:11 +08:00
k88936	03d5cde838	统一模型字节读取失败的报错口径 ... - response.arrayBuffer() 原先在 fetch 的 try/catch 之外，读到一半失败会直接抛出底层 DOMException - 改为包一层并把失败归一成 Model3dViewerLoadError 的 load-failed，与其它加载失败路径一致	2026-09-21 15:11:30 +08:00
k88936	a87e19444b	修复模型查看器环境贴图失败时的显存泄漏 ... - RoomEnvironment 建好之后若 PMREM 生成失败，原先只把引用置空，它的几何与贴图不会释放 - 失败分支改为先释放已建出的 RoomEnvironment，再释放可能已建出的 PMREMGenerator	2026-09-21 15:11:25 +08:00
k88936	ae426df240	修复模型查看器自动旋转状态可能停在旧值 ... - 场景创建使用 effect 开始时的 autoRotateRef.current，加载期间 prop 变化时 setAutoRotate 的 effect 因 sceneRef 为空被丢弃 - 场景就绪后按最新的 autoRotateRef.current 重新同步一次，避免旋转状态与 prop 不一致	2026-09-21 15:11:20 +08:00
k88936	f90e114bcb	生成目录化的Tripo API与画布TS绑定 ... - 生成模型输入、结果落点、产物元数据与按端点的结果类型到 packages/shared/src/contracts/model3d 子目录 - 新增 editor-canvas 生成目录，画布占位载荷不再依赖手写 TS - 更新 model3d 导出索引，移除已删除的占位作业类型 - contracts:model3d:generate 生成后自动跑 prettier	2026-09-21 12:39:33 +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
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
kdletters	7ff6e46774	修复分支上的格式与导入排序门禁问题 ... - 用 rustfmt 修正 AGC Tauri 导出包测试的断言排版 - 按 simple-import-sort 修正 AGC App.tsx 导入顺序与 packages/shared 导出顺序	2026-09-20 21:17:27 +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
kdletters	39aed2e486	OSS 写入显式使用 v1 签名 ... ossutil v2 默认 v4 签名，缺 region 会直接失败\n总号写入与回读统一走 buildOssutilArgs，默认 --sign-version v1，可切 v4 并配合 AGC_OSS_REGION\n补充参数构造单测	2026-09-20 18:33:02 +08:00
kdletters	54d0fb75ea	接入 Godot 编辑器插件与受控执行链路 ... 新增 GDExtension 自动引导、GDScript 执行和实例隔离缓存 接入 AGC 插件开关、Runner、Agent 工具与权限审计 完善执行回执确认、不确定状态阻断及卸载恢复 补齐 Windows 分发资源、定向测试与实机验收文档	2026-09-20 16:35:04 +08:00
kdletters	e3682fd06f	固定客户端dev服务并支持官网多平台下载 ... 移除服务器选择并按来源隔离登录凭据 新增官网客户端下载入口和匿名平台聚合接口 根据发布清单自动展示Windows与macOS首装包 补齐Mac首装元数据和上传顺序校验 同步定向测试与下载发布规范	2026-09-19 16:19:28 +08:00
k88936	b0054fd51c	新增 3D 模型查看器独立包 ... - 新增 packages/model3d-viewer（@genarrative/model3d-viewer），含 Model3DViewer、scene、loader、framing、status 与 index - 组件只走 WebGL2 单一路径渲染 glb、单文件 gltf 与 fbx，未承诺格式或超过 32 MiB 时只渲染一行状态文案 - 取景按真实顶点做投影拟合，与模型尺度无关，复位回到打开时的取景 - 新增 framing 与 loader 的纯函数单测 - 根 package.json 的 workspaces 增加 packages/model3d-viewer - scripts/check-npm-workspaces.mjs 与 scripts/check-npm-workspaces.test.mjs 同步工作区清单 - vitest.config.ts 增加新包测试匹配 - 同步 package-lock.json 的工作区链接	2026-09-19 16:13:55 +08:00
k88936	1392303f1c	请求契约把 model 改为必填字段 ... 三个生成请求的 model 由 Option<Model3dModelVersion> 改为必填 Model3dModelVersion，并同步重新生成 TypeScript 绑定 validate_generation_options 不再重复校验 model 缺失，直接由必填的 model 推导 family 三个 client 的 to_sdk_params 改为直接提交模型版本字符串 冒烟示例与技术方案文档同步为必填写法	2026-09-19 14:16:39 +08:00
k88936	800da43a8d	说明生成结果 DTO 的 number 精度边界 ... 为 poll_after_ms、updated_at_micros、size_bytes 补充注释，说明其量级远低于 2^53，按 TS number 导出即可精确表示 重新生成 TypeScript 绑定，把上述说明同步为 JSDoc 技术方案补充同一说明，明确不做 bigint/string 特殊处理	2026-09-19 14:14:14 +08:00
k88936	950209f038	为 model3d 请求契约的可选字段补充 ts(optional) ... 为 image_to_model、multiview_to_model、text_to_model 三个请求的可选字段添加 ts(optional = nullable) multiview 视图分支的 left、back、right 同步标记为可选 重新生成 packages/shared/src/contracts/model3d 下的 TypeScript 绑定，使 TS 侧可按 serde 语义省略字段	2026-09-19 13:07:41 +08:00
k88936	35be25dbd6	补齐 model3d 契约在 packages/shared 的导出入口 ... 新增 packages/shared/src/contracts/model3d/index.ts 聚合 ts-rs 生成的 3D 生成契约类型 contracts/index.ts 增加 export type * from './model3d' src/index.ts 增加 export type * from './contracts/model3d'	2026-09-19 13:02:01 +08:00
k88936	18252e24b8	合并主线并保留资源kind枚举收口 ... 合并 origin/master 的 AGC 画布参考与项目能力更新 解决 canvas 生成恢复与任务模型冲突并继续使用共享 GameCreationAppAssetKind 保留 run_id、generationKind 与外部协议字符串的独立边界	2026-09-19 01:50:09 +08:00