Feat/tribo3d集成 #421

Open

k88936 wants to merge 300 commits from feat/tribo3d-integeration into master

pull from: feat/tribo3d-integeration

merge into: GenarrativeAI:master

GenarrativeAI:master

GenarrativeAI:feat/external-scene-generation

GenarrativeAI:fix/mobile-style

GenarrativeAI:feat/msg-queue-to-rust

GenarrativeAI:opt/test-compile-warning

GenarrativeAI:fix/api-timeout

GenarrativeAI:codex/admin-gray-game-publish

GenarrativeAI:codex/remove-agc-codex-restrictions

GenarrativeAI:feat/gptimage2to2.5

GenarrativeAI:backup/agc-macos-dualarch-node-runtime

GenarrativeAI:feat/Crt_Ws

GenarrativeAI:codex/preview-llm-router-config

GenarrativeAI:fix/stroke-width-regression-from-285

GenarrativeAI:agent-organize

GenarrativeAI:feat/game-agent-canvas-resource-workbench-v2

GenarrativeAI:feat/agc-new-workflow

GenarrativeAI:fix/agc-release-version-sync

GenarrativeAI:codex/shared-components-followup

GenarrativeAI:codex/game-agent-runtime-interaction-design

GenarrativeAI:feat/spine-sequence-export-v2

GenarrativeAI:codex/game-agent-run

GenarrativeAI:codex/ui-spritesheet-durable-transaction-latest

GenarrativeAI:feat/art-agent-more-tools

GenarrativeAI:codex/editor-canvas-null-source-repair

GenarrativeAI:hotfix/editor-layout-2mib

GenarrativeAI:codex/showcase

Conversation 0 Commits 300 Files Changed 262

+23428 -1033

k88936 commented 2026-09-18 18:40:00 +08:00

Member

Copy Link

Copy Source

   

shotmd-1790234789.jpg

207 KiB

shotmd-1790234725.jpg

240 KiB

shotmd-1790234732.jpg

194 KiB

shotmd-1790230807.jpg

344 KiB

k88936 self-assigned this 2026-09-18 18:40:00 +08:00

k88936 added this to the 陶泥儿gameAgent project 2026-09-18 18:40:00 +08:00

k88936 added 3 commits 2026-09-18 18:40:00 +08:00

建立3D生成目录化契约 ... 1c4009ea3b

新增 model3d common、text-to-model、image-to-model、multiview-to-model Rust contracts

通过 ts-rs 按目录生成 TypeScript bindings，移除依赖 barrel 的组织方式

增加 model3d contracts 定向生成脚本

接入Tripo三类3D生成Provider ... 37b355a814

加入固定 revision 的 tripo-rust-sdk 与 platform-tripo workspace crate

实现 text-to-model、image-to-model、multiview-to-model 提交、通用任务查询和显式模型下载

抽取通用任务类型、状态映射、输出 URL 校验与 SDK 错误归一，保持 wait_for_task 不对外暴露

同步 Provider 边界文档并暂不接入 api-server

完善Tripo枚举与参数组合校验 ... 5be4a51ac1

按提供的 Tripo 文档补齐 compression、texture quality 与 texture version 枚举

移除未在三个生成接口出现的 style 占位字段并同步 Rust/TypeScript contracts

增加模型版本、纹理版本、生成部件、quad、smart-low-poly 与 face limit 的副作用前校验

同步 Provider 技术方案和 ADR

k88936 added 4 commits 2026-09-18 22:03:56 +08:00

新增Tripo三类生成冒烟CLI ... 25314d9a4a

增加仅通过环境变量配置的 Tripo generation example

顺序提交 text、image、multiview 三类任务并执行单次状态查询

保持无命令行参数且不调用 SDK 轮询接口

完善Tripo冒烟CLI产物流程 ... a4beb53dc6

等待三类生成任务完成并打印映射后的输出

完成后下载模型产物到当前目录并输出文件信息

仅在示例内部使用SDK轮询器，不扩展平台公共接口

按接口收紧Tripo任务结果类型 ... 527706b84e

为 text、image、multiview 三类生成定义独立必填结果结构

以枚举关联任务类型与具体结果并对缺失字段失败关闭

将通用 URL 类型由 TripoModelUrl 更名为 TripoUrl

记录Tripo真实冒烟结果结构 ... da9ee65119

保留三个生成入口的脱敏真实结果形状与下载产物信息

使用实际可访问的 Rustacean 图片完成 image 与 multiview 示例

同步严格 endpoint 结果契约和真实 Provider 验收文档

k88936 added 19 commits 2026-09-19 14:26:58 +08:00

补齐 model3d 契约在 packages/shared 的导出入口 ... 35be25dbd6

新增 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'

单点维护 model3d 的 ts-rs 导出根目录 ... eda9da4d8d

在 model3d/mod.rs 新增 model3d_ts_export_dir 宏，集中定义仓库相对导出根路径

common、image_to_model、multiview_to_model、text_to_model 改为调用宏并只声明各自子目录名

清理 model3d 请求契约中冗余的 serde(default) ... 42a5929a73

移除 image_to_model、multiview_to_model、text_to_model 三个请求结构体 Option 字段上的 serde(default)

同步移除 multiview 视图分支中三个可选视图的 serde(default)

serde 对 Option 字段本身即按 None 处理缺失字段，生成的 TypeScript 绑定保持不变

为 model3d 请求契约的可选字段补充 ts(optional) ... 950209f038

为 image_to_model、multiview_to_model、text_to_model 三个请求的可选字段添加 ts(optional = nullable)

multiview 视图分支的 left、back、right 同步标记为可选

重新生成 packages/shared/src/contracts/model3d 下的 TypeScript 绑定，使 TS 侧可按 serde 语义省略字段

脱敏 TripoUrl 的 Debug 输出 ... 771ff88440

为 TripoUrl 手写 Debug 实现，改用隐藏 query 与 fragment 的脱敏形式

新增 TripoUrl::redacted 提供日志用脱敏 URL，完整 URL 仍由 as_str 显式读取

TripoTaskSnapshot、TripoTaskOutput、TripoDownloadedModel 的调试输出随之不再暴露带签名的下载地址

冒烟示例不再输出完整下载地址 ... b631125a16

产物行改用 TripoUrl::redacted()，避免把带签名的下载 URL 写入标准输出

冒烟示例在任务未完成时跳过下载并继续后续入口 ... 6c209b115a

轮询改用 throw_on_failure=false，失败终态交回示例按 status 判定而不是直接返回错误

非 Completed 的任务打印 status 与 failure 后 continue，避免一个入口失败中断其余入口的冒烟

image_to_model 提交前统一使用裁剪后的输入 ... 230e4d49f2

to_sdk_params 改为传入 request.input.trim()，与提交前的空值校验使用同一份标准化输入

带前后空白的输入不再原样转发给 Provider

multiview 空白视图按未提供处理 ... ddb8b9e8ba

to_sdk_params 新增 optional_view，将仅含空白的 left、back、right 归一化为未提供

空白视图不再以 Some(FileInput) 形式提交，与提交前“至少两个视图”的校验保持一致

multiview 提交前裁剪 task_id ... 091938ed59

to_sdk_params 改为提交 task_id.trim()，与 task_id.trim().is_empty() 的校验使用同一份标准化输入

带前后空白的 task_id 不再原样转发给 Provider

multiview 复用统一的 task_id 校验 ... 09ef92420f

删除 submit_multiview_to_model 中重复的空白判断，改为调用 common::validate_task_id

task_id 非法时的错误字段由 Inputs 改为更精确的 TaskId，与 get_task、download_model 保持一致

auto_size 仅在显式开启时按模型能力拦截 ... f4996d7ac2

validate_generation_options 中 auto_size 的 H25 校验由 is_some() 改为 == Some(true)

auto_size: false 不再被当作启用，与 quad、smart_low_poly、generate_parts 的取值语义保持一致

对齐 Api 与 Request 的可重试状态码 ... b87d9358e5

TripoError::is_retryable 的 Api 分支补充 408 与 425，与 Request 分支的可重试集合保持一致

同步Tripo集成文档的契约导出与脱敏说明 ... b703f0c374

补充 TripoUrl 脱敏输出与 as_str 读取完整 URL 的说明

补充请求可选字段在 TypeScript 绑定中为 field?: T | null 及 model3d barrel 导出入口

补充 ts-rs 生成后需 prettier 格式化再提交的流程说明

说明生成结果 DTO 的 number 精度边界 ... 800da43a8d

为 poll_after_ms、updated_at_micros、size_bytes 补充注释，说明其量级远低于 2^53，按 TS number 导出即可精确表示

重新生成 TypeScript 绑定，把上述说明同步为 JSDoc

技术方案补充同一说明，明确不做 bigint/string 特殊处理

multiview 输入拒绝未知字段 ... 12512f26b2

Model3dMultiviewInputs 增加 deny_unknown_fields，与 Model3dMultiviewToModelRequest 的严格反序列化保持一致

未知视图键（例如拼写错误的 righ）不再被静默丢弃，避免用少于调用方预期的视图提交任务

ts-rs 12 不支持 enum 级该属性，构建时会打印一条可忽略的告警，已在代码注释说明

请求契约把 model 改为必填字段 ... 1392303f1c

三个生成请求的 model 由 Option<Model3dModelVersion> 改为必填 Model3dModelVersion，并同步重新生成 TypeScript 绑定

validate_generation_options 不再重复校验 model 缺失，直接由必填的 model 推导 family

三个 client 的 to_sdk_params 改为直接提交模型版本字符串

冒烟示例与技术方案文档同步为必填写法

移除 TripoUrl 的 Display 实现 ... 3c1059aa39

删除 TripoUrl 的 Display，避免 `{}` 这类通用格式化输出带签名的完整 URL

完整 URL 仍可通过 as_str() 显式读取，日志与调试统一走 redacted() 或脱敏后的 Debug

技术方案文档补充该收敛说明

标注模型下载的重复 task 查询 ... 0c4b1c34d9

在 download_model 增加 TODO，说明 SDK 只提供 download_model(&Task) 因而必须再取一次 task

若将来 SDK 支持按 URL 下载，可直接使用 snapshot 中的模型 URL 省掉这次请求

k88936 added 62 commits 2026-09-22 10:14:47 +08:00

新增 3D 模型查看器独立包 ... b0054fd51c

- 新增 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 的工作区链接

更新Tripo 3D模型Provider集成文档覆盖三个生成入口 ... 092bca7444

文档改名为「Tripo 3D模型Provider集成」，H1 同步去掉“文本到”前缀，并更新 docs/README.md 链接
目标段改为三个入口共用 TripoProviderClient，列明 submit / submit_image_to_model / submit_multiview_to_model
新增「三个入口的输入」小节，记录 prompt 长度上限、image input 裸字符串引用、multiview views 与 taskId 二选一及视图数量要求
新增「任务查询与下载」小节，记录 TripoTaskSnapshot、TripoDownloadedModel 与必须重复取 task 的原因
补充契约分层说明：产品级结果契约目前只服务 text-to-model，image 与 multiview 结果仍在 provider 层
非目标标注前端查看器由 packages/model3d-viewer 独立实现、本阶段不接 UI 链路，验收补上输入校验与 smoke 行为

修复 ts-rs 对 enum 级 deny_unknown_fields 的解析告警并保留契约严格性 ... c48f0627cf

- 把 server-rs 与 apps/ai-game-creator-shell/src-tauri 两个 workspace 的 ts-rs 从 registry 固定到上游修复 commit fd8679ef20f866f747c046b30bd29c15e3d7a003（PR #491：已发布版 12.0.1 的 EnumAttr 不识别 deny_unknown_fields，只有 StructAttr 会静默忽略它），两个 Cargo.lock 同步改成 git 源
- 说明固定原因与退出条件：crates.io 最新仍是 12.0.1、GitHub 最新 tag 仍是 v12.0.0，等发布 > 12.0.1 后改回 registry 版本并删除 commit 固定
- 明确不使用 ts-rs 的 no-serde-warnings feature 消警：它会连同 deserialize_with 这类真实未支持的 serde 属性一起静默，掩盖 Rust 与 TS 绑定的漂移
- 保留 shared-contracts 的 Model3dMultiviewInputs enum 级 deny_unknown_fields（该属性一直由 serde 生效，告警只来自 ts-rs 的属性解析），注释改为写明不要为消警删属性、也不要改用 no-serde-warnings
- 新增契约测试 tests/model3d_multiview_request_contract.rs：钉住 views/taskId 变体内部与请求体顶层拒绝未知字段，并覆盖 kind 与 camelCase 字段名解析
- 记录排障经验与决策：pitfalls.md 说明无 span 的告警不代表属性失效，decision-log.md 记录固定 commit、影响面与回退条件
- 验证：cargo check -p shared-contracts 与该 crate 的 cargo test 不再出现 deny_unknown_fields 告警且全绿；cargo test --locked -p shared-contracts model3d 加 prettier 后 packages/shared 的 model3d 绑定零 diff；AGC 的 cargo check --locked --bin genarrative-ai-game-creator-shell 不再出现该告警（AGC 侧仍保留 1 条既有的 deserialize_with 告警，与本改动无关）；npm run check:encoding、npm run check:doc-index、git diff --check、cargo fmt --all --check 通过

明确Tripo模型流式下载边界 ... 4c7fd968dd

记录SDK与Provider只提供分块模型下载流

约定未来OSS上传直接消费数据流而不缓存完整模型

改用Provider流式下载Tripo产物 ... 188614d5d2

保持第三方SDK不变并在Provider侧读取签名模型URL

逐块暴露模型响应并校验Content-Length，smoke示例改为异步落盘

为未来SDK原生stream能力保留迁移TODO

补充Tripo下载器迁移待办 ... 49b6451548

记录Provider侧流式下载与第三方SDK保持原样的边界

增加等待上游SDK原生stream能力后的替换TODO

新增Tripo生成API集成主规范与决策记录 ... 699f321651

- 新增主规范，固定两个端点的请求、异步执行、结果持久化与泥点扣费合同
- 新增 ADR 0002，记录不复用 Hyper3D、at-most-once submit、提交时定价与落库失败退款

新增Tripo生成API的里程碑规范与实施计划 ... 6db1079610

- 新增契约与数据模型里程碑，锁定范围、不做项与验收标准
- 新增 Worker 执行链路与 API 路由里程碑，标注 pending 与定价前置依赖
- 新增契约里程碑实施计划，固定步骤顺序、验证命令与回退范围

同步Tripo生成API的文档索引与领域术语 ... ddf8e2c213

- docs/README 增加主规范与 ADR 入口
- CONTEXT.md 补充 3D 模型生成操作、provider task、Tripo API facade 等术语
- provider 专题把应用层接入指向新主规范
- 文档生命周期索引改为指向活动计划目录

把画布占位载荷移出受feature门控的assets模块 ... 93306952d9

- 新增 shared-contracts::editor_canvas，承载画布占位与回填载荷并接入 ts-rs 生成
- assets 模块改为内部引用该类型，不再自带定义
- api-server 七处引用改到新模块路径

分层Tripo生成的provider参数与平台API请求契约 ... e0108f7d57

- common 新增 Model3dGenerationSource、Model3dGenerationTarget、Model3dGenerationTargetRef 与产物元数据
- text/image 各自的参数类型独立成 params，API 请求为 generation + 平台字段 + target
- 图片输入只接受站内引用，input 由服务端解析后注入 provider
- 删除宽松的作业与结果占位 DTO，改为按端点的严格结果与端点 tagged enum
- 新增契约严格性测试，覆盖分支必填字段、图片输入歧义与顶层未知字段

provider按参数分层并公开组合校验入口 ... 7790a181c4

- submit 改为接收生成参数，图片输入由调用方解析后单独传入
- 公开 validate_text_to_model_params / validate_image_to_model_params 供平台层在副作用前预检
- 参数到 provider 校验选项的映射收敛为 From 实现，去掉重复拼装
- smoke 示例跟随新签名

生成目录化的Tripo API与画布TS绑定 ... f90e114bcb

- 生成模型输入、结果落点、产物元数据与按端点的结果类型到 packages/shared/src/contracts/model3d 子目录
- 新增 editor-canvas 生成目录，画布占位载荷不再依赖手写 TS
- 更新 model3d 导出索引，移除已删除的占位作业类型
- contracts:model3d:generate 生成后自动跑 prettier

新增api-server Tripo3D模块与泥点定价结构 ... 8f6458ffe2

- 新增 tripo3d/pricing.rs，底价按 endpoint × 模型版本 × 是否有贴图，add-on 按固定键表叠加
- 定价段加载即校验全部底价与 add-on 键，缺键即配置非法；缺段代表未配置，查价直接拒绝
- editor_generation_config 挂载可选 model3d 段并提供 fail-closed 查价入口
- 后台记录形状尚不支持 3D 段，暂由文件配置提供并留下同步待办
- model_version 增加 ALL 与排序，供定价表枚举校验

新增Tripo生成请求的平台组合校验 ... e105e34f83

- 价格相关参数必须显式给出，texture 与 textureQuality、pbr 不能互相矛盾
- 目标落点与图片引用的 ID 不能为空白
- provider 能力组合规则复用 platform-tripo 预检，不维护第二份
- 校验结果直接产出定价输入，路由在扣费与 provider 调用前执行
- api-server 依赖 platform-tripo

修正Tripo定价文档口径为 fail-closed 与无单位 ... 36036eed7b

- 主规范去掉 model3d 段的 unit 字段，3D 恒为按次计价
- 主规范把加载即校验改为段存在时必须全键，并补充段缺失即拒绝提交
- 契约里程碑验收第 6 条同步为段缺失 fail-closed
- 实施计划把定价步骤指向 api-server/src/tripo3d/pricing.rs

新增external_generation_job的provider任务checkpoint ... 09ea0a5e76

- provider_kind 与 provider_task_id 追加在表末尾，带显式默认值，旧行迁移时补 NULL
- 新增 set_external_generation_job_provider_checkpoint_and_return procedure，复用 running 租约栅栏
- 已有 checkpoint 时禁止覆盖并留下 provider_checkpoint 事件，作为 at-most-once submit 的数据层保证
- 快照与兼容快照同步投影两个新字段，轻量摘要按无 checkpoint 返回
- 增加 checkpoint 不可覆盖的不变量单测

spacetime-client 暴露 provider checkpoint 写入入口 ... aa1a1a63ed

- 重新生成 module bindings，新增 checkpoint procedure 与输入类型、表行与快照投影
- mapper 增加 checkpoint 记录输入与到绑定输入的转换，快照映射补两个新字段
- facade 新增 set_external_generation_job_provider_checkpoint，复用 procedure 结果映射
- facade 注释说明已有 checkpoint 被拒是 at-most-once submit 保证，写入失败按失败处理

同步external_generation_job表目录的provider checkpoint口径 ... a11fd709fa

- 补记 provider_kind 与 provider_task_id 的追加字段、租约栅栏与禁止覆盖语义
- 说明 checkpoint 不进 payload、read model、BFF 响应与公开契约
- 事件表目录补充 provider_checkpoint 事件

新增Tripo生成Worker执行链路实施计划 ... 2182b075b8

- 固定 api-server 侧 tripo3d 目录的文件切分与各文件职责
- 明确提交路由执行顺序、幂等口径与图片输入解析边界
- 记录 Tripo job 固定 max_attempts=1 与 checkpoint 收口语义
- 里程碑二转 active 并回链实施计划，里程碑一补实施计划入口

api-server 增加 Tripo 生成的环境配置 ... d012392779

- AppConfig 新增 tripo_base_url / tripo_api_key / 请求超时 / 重试四个字段
- 默认网关指向 Tripo 官方 v3 地址，可由 TRIPO_BASE_URL 覆盖
- 环境变量沿用 provider 示例的 TRIPO_* 口径，API Key 缺省为空
- 默认值断言补进配置测试

新增api-server Tripo3D提交路由与入队 ... dd8f48bad9

- tripo3d 目录按 job 身份、provider 配置、错误映射、入队与路由拆分小文件
- 两个内部路由要求 Bearer 与 Idempotency-Key，顺序固定为解析、组合校验、查价、入队
- 入队复用编辑器生成队列的幂等 dedupe key，同键同请求返回原 operation，同键不同请求 409
- Tripo job 走既有 editor-canvas 来源与单次尝试口径，不新建队列、不新增状态
- 提交响应返回 operation、job kind 与既有任务查询状态地址，不暴露 provider 信息
- 补齐 ExternalGenerationJobRecord 测试夹具新增的 checkpoint 字段

补记Tripo model3d的assetKind接入清单对照 ... 931be509f1

- 主规范新增 assetKind 接入清单对照表，逐行登记后端-only 类别的触碰点口径
- 主规范明确原子落库 operation_kind 白名单必须新增两个 Tripo job kind，画布回填只走 placement-only
- 主规范登记用户标签覆盖、快速编辑与改造 capability 三项结论均为不进入，并写明后续接前端需重评
- 实施计划把 provider 配置文件行更正为 provider.rs，并在产物落库步骤补白名单与 placement 口径验收
- 后端架构文档补充说明：不走编辑器前端的生成类别同样适用清单，不能靠无前端入口跳过

登记Tripo 3D的生成结果operation_kind白名单 ... 4edeadae7d

- SpacetimeDB storage 的编辑器生成白名单加入 model3d_text_to_model 与 model3d_image_to_model
- 白名单是原子落库的 operation_kind 门禁，未登记会让整笔结果事务被拒
- api-server 侧按源码钉住两个 job kind 已在白名单内，避免只在运行期才发现

platform-tripo支持图片上传与预览图下载 ... a8799adf5d

- 产物下载类型改名为 TripoDownloadedArtifact，模型与预览图共用同一条流式读取路径
- 新增 download_rendered_image，读取 task 结果里的预览图地址
- 新增 upload_image，把图片字节上传 provider 换 file_token
- 图片输入收敛为 TripoImageInput 枚举，只有 file_token 与公网地址两种形态，不再接受裸字符串
- smoke 示例跟随新的图片输入类型

新增api-server Tripo3D图片输入解析与产物对象写入 ... e809cdd850

- editor_project 暴露按注册 ID 定点解析资源与素材对象键的入口，只认本账号已登记记录
- image_source 把站内引用解析成对象键后读字节并上传 provider 换 file_token，不把签名地址交给第三方
- storage 负责产物 PUT、HEAD 复核与 asset_object 登记，模型与预览图共用同一条链路
- asset_object ID 使用 operation 稳定派生值，避免被生成结果事务的白名单校验拒绝
- 完整字节写入路径留 TODO，等待 platform-oss 提供流式上传

修正spacetime-client checkpoint facade的落点 ... ac08ccbe39

- facade 方法补进真正参与编译的 active/external_generation.rs，此前误写在未被编译的重复文件里
- mapper 重新导出 ExternalGenerationJobProviderCheckpointRecordInput，调用方无需从子模块路径引用
- 删除未被编译的 src/external_generation.rs 重复副本，避免再次改到死文件

新增api-server Tripo3D worker执行链路与结果落库 ... 29e554a30c

- 新增 artifacts/result/worker 三个文件：产物读取、严格结果构造与 at-most-once submit 执行链路
- 没有 checkpoint 才 submit；submit 成功后先落 checkpoint 再轮询，checkpoint 写入失败按终态失败，不退回可重试队列
- 模型与预览图分别写入 OSS 并按 operation 稳定 ID 登记 asset_object，预览对象单独登记以便按对象键解析归属
- 落点按 target 分支写入项目资源或账号素材，imageSrc 与 thumbnailSrc 指向预览图，模型本体留在 objectKey
- 画布回填只走 placement-only；新增只依赖资源身份与尺寸的占位条目构造函数供 3D 复用
- 标准消费者的队列结果透传调用方显式给出的 result，使 3D 完成结果可从既有任务查询返回
- external_generation_worker 增加两个 job kind 分支并纳入长任务超时，用户可见失败文案收敛为稳定文本

同步Tripo 3D生成的图片输入与完成结果口径 ... 8a828a43ba

- 主规范明确图片输入先读字节再上传换 file_token，不把带签名的临时地址交给第三方
- 主规范补完成结果读取口径：由既有任务查询的 result 字段返回，标准消费者仅透传调用方显式给出的 result
- 实施计划把图片输入步骤改写为 file_token 口径，文件表补 storage.rs
- 实施计划新增进展一节，写清已落地步骤、未确认的定价数值与尚未跑通的真实端到端
- 风险一节补 worker 并发位与长任务超时的运维前提

清理Tripo3D新代码的死代码与无意义断言 ... 02ef84d9b6

- 删除 job.rs 中无调用的 is_model3d_job_kind、source_entity_id 与本地 target_source_entity_id

- 删除 artifacts.rs 中未被引用的 map_artifact_error 及其 TripoError 导入

- 删除未被引用的 MODEL3D_JOB_MAX_ATTEMPTS 与只被同文件测试断言的 queue source module 常量

- 删除对常量自身取值的恒真断言测试

补记Tripo图生3D图片引用提交预检口径 ... 63c924dba0

- 主规范明确图片引用解析分两步：提交时只做元数据预检，worker 执行时重新确认同一事实

- 主规范新增第 5 条验收标准，验收清单顺延至 12 条，里程碑同步引用范围

- 实施计划把图片输入预检写进固定执行顺序，并记录已改用定点引用查询取代宽查询

- 决策记录新增条目：站内引用禁止在提交路径读正文、调 provider 或列全量工程与素材库

图生3D图片引用改为提交时定点预检 ... eb4256f883

- image_source 拆成预检与执行两条路径，预检只做归属、记录类型与对象键校验，不读正文也不调用 provider

- 定点解析改用既有 resolve_editor_reference_record_by_id_for_owner，取代列工程与读素材库的宽查询

- image-to-model 路由在扣费与入队前调用预检，跨 owner、未登记、已删除与 kind 不符统一返回 400

- editor_project 把定点引用查询暴露为 crate 内可见，供生成入口复用

- 新增源码钉住用例，防止预检退回宽查询或提前读图片正文

收敛Tripo三入口重复的extra字段构造 ... 0982b952cb

- 新增 common/extra.rs 统一构造 texture_version 与 delight 的 SDK extra 字段，键名只留一份
- text_to_model 与 image_to_model 删除各自的 extra_fields 副本，改调公共实现
- multiview_to_model 的内联 extra.insert 也改为复用同一构造
- 未提供的参数仍不写入 extra，请求体行为与原先一致

多视图前视图去掉首尾空白再提交provider ... e8467c2870

- front 只按 trim 后判空，但先前把未 trim 的原串交给 FileInput，带空白的取值会被原样发出
- 改为提交前 trim，与 image_to_model 的输入口径一致

多视图可选视图去掉首尾空白再提交provider ... 7193bd28c2

- optional_view 先用 trim 判空、再把未 trim 的原串交给 FileInput，两侧口径不一致
- 改为提交前 trim，空白视图仍按未提供处理

长度与范围越界改用独立校验原因 ... 33cd943ff9

- TripoValidationReason 新增 OutOfRange，与「参数组合互斥」不再共用 InvalidCombination
- prompt 超 1024 字符、negative_prompt 超 255 字符改报 OutOfRange
- face_limit 越界属同一类范围错误，一并改报 OutOfRange，调用方可按原因分流

修复模型查看器自动旋转状态可能停在旧值 ... ae426df240

- 场景创建使用 effect 开始时的 autoRotateRef.current，加载期间 prop 变化时 setAutoRotate 的 effect 因 sceneRef 为空被丢弃
- 场景就绪后按最新的 autoRotateRef.current 重新同步一次，避免旋转状态与 prop 不一致

修复模型查看器环境贴图失败时的显存泄漏 ... a87e19444b

- RoomEnvironment 建好之后若 PMREM 生成失败，原先只把引用置空，它的几何与贴图不会释放
- 失败分支改为先释放已建出的 RoomEnvironment，再释放可能已建出的 PMREMGenerator

统一模型字节读取失败的报错口径 ... 03d5cde838

- response.arrayBuffer() 原先在 fetch 的 try/catch 之外，读到一半失败会直接抛出底层 DOMException
- 改为包一层并把失败归一成 Model3dViewerLoadError 的 load-failed，与其它加载失败路径一致

收紧产物文件名对远端扩展名的取值 ... 6724f8b707

- filename 直接取远端 URL 末段扩展名，path_segments 已百分号解码，%2F / %5C 会拼出跨目录路径
- 扩展名只接受长度不超过 10 的 ASCII 字母数字，其余一律退回 glb

产物下载前校验任务确实处于完成态 ... 694a3c6f6c

- download_model 与 download_rendered_image 原先只看 output 是否存在，快照字段全公开、status 与 output 可以被人为构造得不一致
- 两个入口统一走 completed_output：先校验 task_id，再要求 status=Completed 且有输出，否则按输出结构错误失败

拒收带userinfo的产物地址 ... 0f8ac57593

- TripoUrl::parse 原先只校验 scheme，带 user:password@ 的地址会被 Debug / redacted 原样打进日志
- 解析阶段直接拒绝 userinfo，产物地址不需要凭据

脱敏地址保留原始分隔符 ... e9af6c0741

- redacted 原先无条件用 ? 拼接脱敏标记，只有 fragment 的地址会被显示成带 query 的样子
- 改为按命中的分隔符原样拼接，日志里能区分 query 与 fragment

去掉产物下载重试里的不可达panic分支 ... 294b7461ff

- download_artifact 原先用 for + last_error + expect 收尾，循环每轮都会 return，expect 实际不可达，却给库留下一条潜在 panic 路径
- 改为 loop 内递增 attempt，重试耗尽时直接返回最后一次错误，重试次数与退避行为不变

补多视图请求契约的全字段往返用例 ... d4af6802fb

- 新增全字段往返：钉住 camelCase 字段名、各枚举线上取值与 Option 的可省略写法
- 新增显式 null 往返：确认可选字段回写时仍是 null 而不是整字段消失
- 补用例后字段改名或可空性漂移会被测试拦住，不再是只在 TS 绑定里可见

为Tripo提交路由补应用级验收用例 ... f732555a44

- 走真实 build_router 断言两个端点未鉴权一律 401，路径写错或漏 merge 会退化成 404

- 断言缺 Idempotency-Key 在解析之后、组合校验与定价之前返回 400

- 断言贴图档位冲突与定价必填字段缺失都在定价与 provider 副作用之前返回 400 并定位字段

- 实施计划进展补记该组用例与当前全量测试通过数

容器首帧无尺寸时按真实比例重算取景 ... 3e426a1006

- 取景原先只在加载完成时按 measureViewport() 的宽高比算一次，隐藏面板里挂载时只能拿到方形兜底值
- 抽出 computeFraming(aspect)，ResizeObserver 首次量到非零尺寸后按真实比例重算并复位一次，之后不再覆盖用户的缩放

多视图输入变体字段统一按camelCase序列化 ... aebbd3bb99

- Model3dMultiviewInputs 的 serde 属性补 rename_all_fields = camelCase，结构体变体字段不再逐字段手工 rename
- TaskId 变体去掉冗余的 taskId 显式 rename，序列化结果与生成绑定均无变化

同步Tripo provider文档与本次行为修正 ... 25ee11771c

- 脱敏输出保留原分隔符、带 userinfo 的地址解析即拒绝
- 图片与视图引用提交前 trim；校验原因分 Required / InvalidCombination / OutOfRange
- 下载前要求快照为完成态，filename 扩展名收紧为短 ASCII 字母数字
- 顺带把文档里的下载包装类型名改为当前的 TripoDownloadedArtifact

补Tripo worker纯逻辑定向用例 ... c0fcb8553d

- checkpoint 只在 provider task id 非空且去空白后有效时才算存在，空白等同未提交

- 完成结果按端点严格区分，且序列化后不含 provider、taskId 与带签名的临时地址

- 预览图尺寸必须能真实解码，损坏字节直接失败而不是写占位宽高

- 预检用例去掉多余的通配导入，实施计划进展同步当前通过数

修正provider文档里过期的下载包装类型名 ... 03d26d46af

- 文档写的 TripoDownloadedModel 已不存在，按当前代码改成 TripoDownloadedArtifact
- 上一条文档提交的说明里已提到这处改动，但当时补丁没落上，这次补实

补记3D定价在模型定价体系中的例外口径 ... 13dfe07f94

- 模型定价管理方案新增 model3d 段说明：形状、事实源仍为文件配置、后台改价不覆盖

- 说明段缺失即 fail closed，未确认前禁止写入猜测值或 provider credit 数字

- 记录后续把 3D 段迁入 SpacetimeDB 并接后台编辑的收敛路径

- 实施计划补记 spacetime schema guard 通过及其锚点

同步Tripo3D的worker领取范围与长任务预算口径 ... d6c7a04a1c

- worker 领取清单补上 model3d_text_to_model 与 model3d_image_to_model

- 长任务预算说明补记两个 3D job kind 在单次 attempt 内轮询 provider 并占用并发位

- worker 化方案补记 Tripo provider 的四个环境变量、默认网关与缺密钥时的 503 口径

补记spacetime-client重复副本文件的排障经验 ... 7d842f0b15

- 记录 active.rs 用 path 属性指定真实模块、同名副本不参与编译的现象与原因

- 给出改动前先查 path 属性、只改 active 目录、用编译双绿确认的处理口径

补记Tripo TS绑定目录化生成的重跑验证 ... a4d9418cd3

- 实施计划进展记录 contracts:model3d:generate 重跑后 packages/shared 无 diff

- 验证命令清单补上该生成命令

三个入口的seed参数在TS契约里改用bigint ... c0d6531e92

- 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 绑定，仅这三个字段变化

契约枚举的线上取值只由serde定义 ... 3af0d3d90b

- shared-contracts 新增 wire_str 与 wire_str_lossy：线上取值只从 serde rename / rename_all 取，不再维护第二份字面量
- 删除模型版本、纹理质量、纹理版本、纹理对齐、几何质量、输入方向、导出方向、压缩共 8 个枚举上手工维护的 as_str
- platform-tripo 新增 common/wire.rs 负责契约枚举到 provider 请求字符串的转换，三个入口的 to_sdk_params 改走它并把失败归一成 provider 错误
- api-server 的定价文案与 job 模型版本取值改用 serde 取值，job 的 model_version 由 &'static str 改为 String
- 取值来源只剩 serde 一处，改 rename 不会再静默分叉

text-to-model入口的submit改名带端点 ... 609b24c779

- TripoProviderClient::submit 改名为 submit_text_to_model，与 submit_image_to_model / submit_multiview_to_model 一致
- 同步 api-server tripo3d worker 与 tripo_generation_smoke example 的调用点
- 同步技术方案文档里写死的 submit 口径，方法名不再与另两个入口分叉

产物下载改为按「无数据推进」判超时 ... 14066eea11

- artifact reqwest client 不再设包含响应体的总超时，改成 connect_timeout + read_timeout（reqwest 0.12 的「每次读操作」语义，读完自动重置）
- 响应头之前没有数据推进时用显式 tokio::time::timeout 兜住，避免连上却不返回响应头时无限挂住
- 新增 TripoProviderClient::artifact_stall_timeout 统一承载三处预算，取值沿用 TripoSettings::request_timeout
- 补 3 个 mock TCP 用例：响应头一直不来、传输中途断流按无数据推进失败，慢速但持续的下载必须完整收完（后者能拦住「改回总超时」的回归）
- 同步技术方案与后端架构文档里的下载超时口径

补记图生输入的OSS直读待讨论项 ... 2691ca8aca

- api-server 的 image_source 模块头与 platform-tripo 的 upload_image 各留一条 TODO(oss-direct-read)：交签名 URL 或对端直读 OSS 能省掉字节中转，但把私有对象与带时效凭据交给第三方，安全口径与可行性待讨论
- 技术方案文档把图生输入口径更新为当前的 source 站内引用 tagged enum，并补同一条待讨论说明
- 讨论清楚之前保持「api-server 自己读、自己传」的现口径，不改行为

写入Tripo 3D泥点默认价并锁定credit换算口径 ... 9fc55a5cac

- 受控默认配置新增 model3d 段：底价按端点 × 模型版本 × 是否有贴图，add-on 六项独立计价

- 换算口径固定为泥点 = ceil(0.8 × Tripo 官方 credit)，H 系列 10/20 与 20/30、P1 30/40 与 40/50、P2 100/110

- editor_generation_config 定向用例按 credit 表反算默认泥点价，改价必须先改 credit 表

- 段缺失语义改为显式摘段验证，仍保持 fail closed 不扣费不入队

- 主规范、里程碑、实施计划与定价管理方案同步默认价已确认与部署侧 override 风险

图片画布接入 3D 资源：新增 model3d 类别、3D 预览与 3D 生成入口 ... 61fe4c48af

- 后端资源投影按 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 样例模型

k88936 added 2 commits 2026-09-22 13:13:29 +08:00

合并 origin/master 到 feat/tribo3d-integeration：ts-rs 一律常开、Cargo 清单去重 ... 10e63ecb6b

- 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 全过

恢复合并时丢掉的 AGC 壳依赖 codex-patch-parser 与 chrono ... e7b067e977

- apps/ai-game-creator-shell/src-tauri/Cargo.toml：[dependencies] 补回 master 侧新增的 `codex-patch-parser = { path = "vendor/codex-patch-parser" }` 与 `chrono = { version = "0.4", default-features = false, features = ["std"] }`（冲突解决时随同段落的 ts-rs 一起被丢掉，导致 src/agent/direct_patch.rs 与 src/agent/direct_codex_audit.rs 报 8 条 E0433 / E0432）
- apps/ai-game-creator-shell/src-tauri/Cargo.lock：按清单恢复 genarrative-ai-game-creator-shell 条目里的 chrono 与 codex-patch-parser 依赖
- docs/project-memory/shared-memory/pitfalls.md：新增 2026-09-22 条，记录「合并后 CI 报 cannot find module or crate 先查对方新增的依赖行」的判据与踩坑点
- docs/project-memory/shared-memory/decision-log.md：在 2026-09-22 合并条目补记这次丢依赖与验证

验证：cargo metadata --locked（AGC workspace）、cargo test --locked --manifest-path apps/ai-game-creator-shell/src-tauri/Cargo.toml --no-run（bin + 4 个集成测试目标全部编译）、cargo check --locked --workspace --manifest-path server-rs/Cargo.toml、npm run check:native-shells:agc-rust-crates、npm run check:encoding、npm run check:doc-index、git diff --check

k88936 force-pushed feat/tribo3d-integeration from 9c63648547 to e7b067e977 2026-09-22 13:13:29 +08:00 Compare

k88936 added 52 commits 2026-09-22 15:36:31 +08:00

统一 model3d 查看器状态类型命名：Model3DViewerStatus 改回 Model3dViewerStatus ... 93002f1bd2

- 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（改动文件）

查看器取景距离改用前校验有限正数 ... 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

取景近远裁剪面比例改为具名常量 ... 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 用例全绿）

去掉 Model3DViewer 加载 effect 里冗余的 sourceKind 依赖 ... 104656aa99

- packages/model3d-viewer/src/Model3DViewer.tsx：删除只出现在依赖数组里的 sourceKind 变量与依赖项，effect 实际只分支 sourceData / sourceUrl，kind 变化必然带动这两者之一变化

验证：npx tsc（严格模式单文件检查）、npx vitest run packages/model3d-viewer

释放材质时用 if/else 取代嵌套三元 ... 4bcf0cdb86

- packages/model3d-viewer/src/scene.ts：disposeModel3dViewerObject 里把材质归一化成数组的三元链改成 if/else，展开层级与语义不变，只是去掉内层三元嵌套

验证：npx tsc（严格模式单文件检查）、npx vitest run packages/model3d-viewer

场景释放不再强制丢失 WebGL 上下文 ... b71d18b166

- packages/model3d-viewer/src/scene.ts：teardown 去掉 renderer.forceContextLoss()，只保留 renderer.dispose()，并写明原因；宿主 Model3DViewer 全程复用同一个 <canvas>，强制丢上下文会让下一个模型拿到已丢失的上下文渲染全黑

验证：npx tsc（严格模式单文件检查）、npx vitest run packages/model3d-viewer

查看器取消时一并中止在途的模型下载 ... 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 严格模式检查查看器包全部源文件

gitignore 连 glTF 兄弟资源一起忽略 ... 0ae73f7e0e

- .gitignore：仓库根目录手工下载的 3D 样例除容器文件外，再忽略多文件产物的 .bin 缓冲与 png / jpg / jpeg / webp / ktx2 / tga 贴图，避免整套样例在 git status 里逐条冒出来

验证：git check-ignore -v image_to_model.glb companion.bin scene.png（根目录同名文件命中新规则）

gitignore 的 3D 样例规则改为大小写不敏感 ... d24347d78e

- .gitignore：把 /*.glb 一类规则改成 /*.[gG][lL][bB] 形式；gitignore 匹配与 core.ignoreCase 无关，浏览器下载保留下来的 Model.GLB / scene.GLTF 等大写扩展名此前仍会出现在 git status 里

验证：git check-ignore -v model.GLB scene.GLTF asset.FBX model.bin s.png（均命中新规则）

修正 model3d 绑定生成的 editor_canvas 测试过滤词 ... 928aee403a

- package.json：contracts:model3d:generate 的测试过滤词由 editorcanvas 改为 editor_canvas；libtest 过滤词按子串区分大小写，而模块名是 editor_canvas::export_bindings_*，原写法命中 0 个用例，packages/shared/src/contracts/editor-canvas 实际只被 prettier 重排、从未重新生成

验证：cargo test --locked -p shared-contracts -- model3d editor_canvas（25 个导出用例命中，含 editor_canvas 的 2 个；修复前该过滤词命中 0 个）、npm run contracts:model3d:generate 后 packages/shared 零 diff

修复 AGC 资源工具条缺 onPreviewModel3d 导致的类型检查失败 ... 9f4f7341c9

- apps/ai-game-creator-shell/src/view/project-development/index.tsx：给 ImageCanvasSelectedLayerToolbarView 补上 onPreviewModel3d 空实现，并写明资源画布不登记 preview-model3d、按钮不会渲染；此前该必填属性缺失，AGC 严格模式报 TS2741

验证：npm run ai-game-creator-shell:typecheck（修复前 error TS2741，修复后 exit 0、error TS 计数 0）

3D 生成面板补上浮动菜单的 portal 与定位参数 ... f1d0aed7dd

- src/components/image-editor/ImageCanvasGenerationComposerView.tsx：Model3dGenerationModal 传入 renderEditorPortal / buildPortalMenuStyle，与同文件其余生成面板一致；此前走默认的恒等实现，「参考图来源」菜单内联在文档流里且没有定位样式

验证：npx tsc -p tsconfig.typecheck-guardrails.json --noEmit

3D 模型角标改用 Tailwind v4 可用的类与专用 CSS 规则 ... fc8a674e91

- 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

3D 提交的「不自动重试」选项改回 retry 字段 ... 5d47ef9347

- src/services/image-editor/editorProjectClient.ts：submitModel3dGenerationRequest 把 EDITOR_GENERATION_REQUEST_RETRY_OPTIONS 从顶层展开改成 retry 字段；requestJson 只认 options.retry，顶层展开的 maxRetries / retryUnsafeMethods 会被静默忽略，计费 POST 的「不自动重试」意图丢失（当前只是靠 POST 默认 maxRetries=0 侥幸不重试）

验证：文件内 9 处生成入口现在统一使用 retry 字段

3D 提交地址改成按 endpoint 穷尽映射 ... 02df355281

- 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

删掉无人引用的 MODEL3D_IMAGE_PROMPT_MAX_LENGTH ... 7987fed204

- src/components/image-editor/model3d-generation/Model3dGenerationFormModel.ts：删除只导出、全仓库无引用的图生 3D 提示词长度常量；文生上限与画布尺寸常量仍在使用

验证：全仓库检索该常量只剩定义处；npx tsc -p tsconfig.typecheck-guardrails.json --noEmit

贴图质量映射抽成单一函数，去掉嵌套三元 ... 9a62941779

- src/components/image-editor/model3d-generation/Model3dGenerationFormModel.ts：resolveModel3dGenerationParams 里的贴图质量嵌套三元提成 resolveModel3dTextureQuality(tier)，取值与判定条件不变

验证：npx vitest run src/components/image-editor/model3d-generation

非 3D 面板不再复用「定价未配置」这句原因 ... 9b1c99f37b

- src/components/image-editor/model3d-generation/Model3dGenerationFormModel.ts：新增 MODEL3D_MODE_UNSUPPORTED_REASON，resolveModel3dGenerationQuote 在 mode 不是 3D 生成模式时返回它；原文案会把「模式不支持」误报成定价配置问题

验证：npx vitest run src/components/image-editor/model3d-generation

3D 提交计划在非 3D 模式改用专门的原因文案 ... 5bdabdc7f7

- 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

删掉重复且无人使用的 3D 提交超时常量 ... b48c34d6b4

- 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

幂等键指纹的键排序改成具名比较函数 ... 25fe98836f

- src/components/image-editor/model3d-generation/Model3dGenerationSubmission.ts：canonicalizeModel3dRequestValue 里的嵌套三元比较器提成模块级 compareModel3dRequestEntryKeys，排序结果不变，只是不再嵌三元且不必每次递归重建比较器

验证：npx vitest run src/components/image-editor/model3d-generation（39 用例全绿）

前端补上「分件 + 方形布线 / 智能低多边形」的互斥校验 ... 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 用例全绿）

失败态的重试按钮也按 canSubmit 门禁渲染 ... 8131a70a2f

- 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 用例全绿）

查看器失败文案改用穷尽 switch ... c96d7fe847

- 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

关闭 3D 预览面板时清掉查看器状态 ... 0ec0a13cbc

- 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 用例全绿）

修正查看器失败文案穷尽检查的写法（上一提交未通过类型检查） ... 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 用例全绿）

底部工具栏的子选项锚点 ref 改用查表 ... b41d156edd

- 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

文生 / 图生 3D 面板入口合并到同一个 opener ... d1478e3859

- src/components/image-editor/useImageCanvasGenerationWorkflow.ts：新增 openModel3dGenerationDialog(mode)，openModel3dTextToModelDialog / openModel3dImageToModelDialog 退化成两个只传 mode 的薄包装；两条入口此前是除 mode 外逐字相同的复制，改逻辑时容易只改一处

验证：npm run typecheck

画布图层的媒体渲染分派抽成独立函数 ... cb136fb445

- src/components/image-editor/ImageCanvasWorldView.tsx：音频 / 视频 / 序列帧 / model3d / 默认图片这条五层三元链提成 renderCanvasLayerMedia（早返回写成一列判断），渲染分支与传参不变，新增媒体类型不再加深三元

验证：npx vitest run src/components/image-editor/ImageCanvasWorldView.test.tsx（57 用例全绿）、npm run typecheck

3D 定价快照读取失败补上机器可读的 reason ... 66b8c2bed0

- server-rs/crates/api-server/src/tripo3d/errors.rs：map_pricing_store_error 增加 reason=model3d-pricing-store-error，与同文件其它映射一致，客户端可按 reason 分类这个 500；provider 保持 editor-generation-pricing（全仓库定价错误都是这个口径），不改写为 TRIPO_PROVIDER

验证：cargo check -p api-server（--locked）

OSS 不可用错误补上机器可读的 reason ... 6d8164d37a

- server-rs/crates/api-server/src/tripo3d/errors.rs：oss_unavailable 增加 reason=oss-unavailable，与同文件其它 5xx 映射及 editor_agent 的 OSS 错误口径一致，客户端可按 reason 分类这个 503

验证：cargo check -p api-server（--locked）

3D 产物读取按声明长度预分配缓冲 ... 9263d79d42

- server-rs/crates/api-server/src/tripo3d/artifacts.rs：read_artifact 用 Vec::with_capacity 按 provider 声明的 content_length 预分配（并封顶到 512 MiB 上限，防止谎报长度撑爆内存），避免几百 MB 产物逐块 extend 反复搬移

验证：cargo check -p api-server（--locked）

3D 产物读取不再克隆 content type ... 48a5bf06d0

- server-rs/crates/api-server/src/tripo3d/artifacts.rs：content_type 只在本函数取一次、之后不再读句柄字段，改用 take() 转移所有权而不是 clone()

验证：cargo check -p api-server（--locked）

3D 任务参数用例改为断言真实主张 ... 14740e0ef6

- server-rs/crates/api-server/src/tripo3d/job.rs：把 job_request_rejects_payload_without_fingerprint_stripping_support 改名为 job_request_stays_strict_after_stripping_platform_fingerprint 并补断言——带指纹 + 其它未知字段的合法 payload 仍必须被拒（摘下平台字段不等于放宽严格解析）；原用例名声称验证指纹摘除，实际只断言了「缺字段的 payload 被拒」和「未知 job kind 被拒」

验证：cargo test -p api-server --locked job_request（2 个用例全绿）、npm run check:rustfmt

Idempotency-Key 校验错误保留请求上下文 ... 326729a5ac

- server-rs/crates/api-server/src/tripo3d/routes.rs：require_idempotency_key 增加 request_context 参数，缺失 / 格式非法的两个 400 改用 into_response_with_context(Some(..))，与同处理器其它校验、定价错误一致；此前传 None，客户端拿不到请求 ID / 关联标识

验证：cargo test -p api-server --locked idempotency_key（相关 6 个用例全绿）

修正 storage.rs 注释错别字 ... 444520b464

- server-rs/crates/api-server/src/tripo3d/storage.rs：sniff_model_content_type 文档注释「说慌」改为「说谎」

验证：npm run check:encoding、git diff --check

去掉 model3d_price 上已过期的 dead_code 豁免 ... 058d851a69

- server-rs/crates/api-server/src/editor_generation_config.rs：model3d_price 现在由 tripo3d 提交路由真实消费，删掉「里程碑二的路由接上之前只有测试消费」这句已过期注释与配套的 #[allow(dead_code)]

验证：cargo check -p api-server（--locked）无该函数相关告警

3D 冒烟示例单端点失败不再中断其余端点 ... e2809b83c0

- wait_for_task / get_task / download_model 失败时记录该端点错误并继续
- 保留 throw_on_failure: false 的原有语义，仅补齐传输与超时类错误

去掉被丢弃的 remove 返回值告警 ... c5e0c6a14d

- 幂等指纹字段摘除改为显式丢弃返回值，表明这是 best-effort 行为

3D provider 重试次数按上限 10 封顶 ... 2916e112df

- TRIPO_RETRIES 配置异常时不再让产物下载近乎无限重试

删掉 3D 引用解析里两个无人调用的宽查函数 ... 129e2234f3

- 两个 pub(crate) resolver 全仓无调用方，且会整表列举项目与素材
- 定点解析仍走既有按 ID 的窄查函数

3D 定价表加载时拦截加总溢出 ... 5049c27f3d

- 底价与加价项累加改用 checked_add 校验，配置阶段即失败
- 避免结算路径 saturating_add 在异常配置下静默少收

provider checkpoint 存在性校验补上 provider_kind ... 7dd7bdd3c7

- at-most-once submit 的两字段不变量在数据层一起判定

3D 产物落盘文件名补上安全处理 ... fd0a37969e

- URL 无可用扩展名时按 content type 兜底，预览图不再写成 .glb
- 文件名主干中性化路径分隔符与遍历片段，避免逃出目标目录

任务快照映射不再多余克隆字符串 ... 01a9941cbc

- task_id 与 error_message 直接移交所有权，只保留错误路径上的必要克隆

产物下载失败信息补上可诊断上下文 ... 669a08c7c2

- 传输失败带上脱敏 URL 与底层错误 source 链
- 非成功状态补上状态码文案与脱敏 URL

产物下载客户端不再跟随跳转 ... e18c6ee502

- 产物地址来自 provider 响应，禁止 reqwest 自动跳转以防 SSRF
- 需要跳转的地址会以非成功状态显式暴露，不再由服务端静默代发

上游瞬时状态不再回落成 400 ... cda7724cae

- 408 / 425 / 429 与 platform-tripo 的 is_retryable 口径对齐，分别回 504 / 502 / 429
- 补上这三档与客户端 4xx 的分支测试

5xx 错误响应不再回带 provider task id ... 8473877bc3

- TaskFailure / OutputSchema / 上游兜底分支只回固定文案，完整错误写入服务端日志
- 补一条断言 502 details 不含 task id 与 provider 原文的用例

3D 提交在扣费前预检落点归属 ... ee2d505eb3

- 新增 target 预检模块：画布项目按 (project_id, owner) 定点确认，素材库文件夹按 owner 的库匹配
- 两个提交路由都在查价与入队之前调用；跨 owner / 不存在的落点回 400 model3d-target-unavailable
- 只剩基础设施故障保留原状态码，并补了收敛口径的单测

后台定价保存不再清空 3D 段 ... 050909a0b7

- payload 的 model3d 缺席或为 null 统一表示沿用当前 3D 定价，显式给出时才覆盖
- 保存路径先取当前快照合并，避免改图 / 视频价格让 3D 提交一直失败关闭
- 补用例覆盖「省略保持」与「显式覆盖」两种语义

Merge remote-tracking branch 'origin/master' into feat/tribo3d-integeration ... d9aa686e9a

# Conflicts:
#	docs/project-memory/shared-memory/pitfalls.md

k88936 marked the pull request as ready for review 2026-09-22 15:59:16 +08:00

k88936 added 52 commits 2026-09-23 16:33:50 +08:00

任务快照只在失败终态保留 failure ... 1749f427c1

- failure 改由终态判定驱动，不再只看 provider 是否留下错误字段
- 已完成的任务即使带过期错误字段也不再挂 failure，保持快照内部自洽

未知任务状态错误带上 task id ... be07eb79c6

- map_status 接收 task_id，Unknown 分支改用与其它映射失败一致的 OutputSchema
- provider 异常可与具体任务对上，不再是一条无主错误

空白视图规则收敛到单一助手 ... 09f0c51b81

- 新增 view_input 同时服务提交前计数校验与 SDK 参数转换
- 空白 / 纯空白视图的判定不再有两份实现，避免校验与转换漂移

三个提交入口统一校验 provider 返回的 task id ... 2e9aed3750

- 新增 submitted_task_handle：空白 id 在提交调用附近以 OutputSchema 失败
- text / image / multiview 提交路径共用它，任务不再以孤儿状态等到下游查询才报错

模型版本清单从声明表派生避免漏加新版本 ... 9800477c7c

- Model3dModelVersion 的变体、线上值与 ALL 改为由 model3d_model_versions! 单一声明表生成
- ALL 类型改为 &'static [Self]，新增版本只需在声明表加一行
- 定价校验与测试的遍历改用 iter().copied()

3D 查价错误并入统一的定价错误枚举 ... c8b4160fcd

- EditorGenerationPricingError 新增 Model3d 变体并实现 From<Model3dPricingError>
- model3d_price 改为返回 EditorGenerationPricingError，内层文案直通保持响应不变
- 提交路由对 3D 定价错误与定价快照错误分别映射，未配置用例改断言 Model3d(NotConfigured)

三个提交入口的生成选项映射收敛为单一字段清单 ... bcac5a7c12

- common::validation 用 tripo_generation_options_from! 由一份字段清单派生三个 From 实现
- multiview 手写的 TripoGenerationOptions 映射改为复用该 From 实现
- 新增共享字段时三条路径一起跟上，缺字段会在编译期报错

校验文案的版本标签改为从契约枚举推导 ... e359158ecf

- validate_generation_options 的错误文案改用 wire_str_lossy 取 serde 线上值
- v3.x 家族的模型标签收敛到 v3_model_labels 助手
- 契约改名后诊断文案随之更新，不再手写重复的版本字符串

operation_kind 白名单改为两 crate 共用的共享常量 ... 48cde9624c

- 白名单常量迁到 shared-contracts 并从 crate 根导出
- spacetime-module 的原子落库事务改为引用该常量，删除本地重复定义
- api-server 的登记测试不再解析对方源码文本，改为直接断言常量内容
- 后端架构文档补上白名单常量的位置与共用口径

图片输入解析抽出可注入查询的解析规则并补齐行为用例 ... 87ca86ae6a

- resolve_source_object_key 拆出 resolve_source_object_key_with 与 ResolvedReference 窄结果
- 新增按 ID 定点查询、类型不符、缺对象键、4xx 收敛与基础设施错误保留状态码的用例
- 源码文本断言不再按函数签名切片，只检查本模块不出现列工程 / 列素材库

3D 查价拒绝 texture=false 与贴图加价项的矛盾组合 ... 4e5ff179b2

- Model3dPricingError 新增 InconsistentTextureAddOn 变体与对应文案
- price() 在命中的 add-on 含贴图类而 texture=false 时失败关闭，不再照价收费
- 补齐矛盾组合报错与 texture=true 合法组合的价格用例

落库的模型版本改用严格 wire 取值 ... 433ffb4a15

- Model3dJobRequest::model_version 改为返回 Result 并使用 wire_str
- worker 落库前取不到契约取值即按服务端问题失败，不再写 Debug 兜底名
- 新增用例断言落库取值为契约线上值 v3.1-20260211

队列状态映射改为借用记录避免提交路径整行克隆 ... bba96e18a1

- editor_generation_queue_state 收 &ExternalGenerationJobRecord，只克隆输出需要的三个字段
- Model3dSubmissionResponse::from_job 不再克隆整行 job，status_url 提前算好避免额外克隆
- 其余调用点改为传引用，行为不变

3D 结果打标契约测试补齐 preview 与 imageToModel 分支 ... 2348315dba

- textToModel 用例补 preview 产物的相等断言
- 新增对称的 imageToModel 用例，守住 tag 路由与分支字段
- 裸字符串 source 的负例改为点名 Model3dGenerationSource 并单独反序列化 source 值

多视图请求 DTO 补齐字段级说明并重生成绑定 ... 62bf602fb1

- Model3dMultiviewToModelRequest 每个字段补一行中文语义说明与取值范围
- 结构体补严格反序列化与组合校验归属的说明
- 重新生成 ts-rs TS 绑定，注释同步进 Model3dMultiviewToModelRequest.ts

补 3D 生成选项校验的表驱动单测 ... ed2eb43fe6

- 覆盖最简选项全模型放行、fast 必须配 v3.5 贴图版本
- 覆盖 generate_parts 的 texture/pbr/quad/smart_low_poly 互斥组合
- 覆盖 quad 家族限制与各模式 face_limit 的 min-1/min/max/max+1 边界
- 覆盖空白 task id 按 OutputSchema 失败与 trim 行为

补外部生成主表 provider checkpoint 归一化单测 ... 3ab7b386f1

- 新增 old_external_generation_job_rows_default_to_unsubmitted_provider
- 断言旧迁移行的 provider_kind 与 provider_task_id 都归一成 null
- 守住 at-most-once submit 的向后兼容路径

SDK 请求错误不再丢弃响应体与底层错误链 ... aa6e3b8d79

- 映射 tripo3d_sdk::Error::Request 时带上 body 与 source 字段
- 响应体截断到 512 字符，疑似带 http(s) 地址的响应体整体丢弃
- 只取错误链底层文本，避免 reqwest 顶层 Display 带出完整签名 URL
- 补错误链收集、响应体过滤与截断的用例

查看器字节来源注明引用必须稳定 ... 852e65f7d8

- Model3DViewerSource 的 bytes 分支补充 buffer 生命周期与稳定引用要求
- 说明同内容换新引用会触发场景重建与 GPU 重传的后果

3D 提交失败提示不再直接显示传输层英文文案 ... 62f1ca4537

- resolveModel3dGenerationErrorMessage 对超时单独给出中文可重试提示
- fetch 失败与中断收敛到中文兜底，服务端文案仍原样透出
- 补服务端文案透出、传输层兜底与超时提示的用例

3D 提交把兜底铸的尝试代次写回对话框状态 ... 00eed191c5

- 新增 resolveModel3dAttemptNonce，提交计划带出本次实际使用的代次
- 提交编排在进入 generating 时把该代次写回 dialog，缺代次的老快照不再每次换键
- 补老快照场景用例，断言幂等键前缀与写回的代次一致

3D 提交收到无任务状态的成功响应不再静默复位 ... 4e46202c10

- 新增 MODEL3D_SUBMISSION_MISSING_QUEUE_STATE_MESSAGE 提示文案
- 空 body 或缺 status 的 2xx 响应改判失败态并保留提示，不再直接回 idle
- 补用例断言不再触发排队链路且对话框进入失败态

3D 提交体改用端点契约类型而非 Record ... caafb8baa3

- Model3dSubmissionPlan.body 与 submitModel3dGenerationRequest 的 body 收紧为两个端点请求契约
- 提交计划按端点分支分别构造 text-to-model / image-to-model 请求体
- 幂等键入参同步收紧，测试夹具按契约补全 body

3D 生成定价迁移先落文档：两段并列结构、SpacetimeDB 权威与后台编辑 ... 1327cd53b7

- 主规范把 3D 定价改成按端点两段并列结构，事实源改为 SpacetimeDB，补契约归一化、后台保存语义与验收项
- 新增 ADR 0005，记录权威事实源迁移、公开读模型不变的取舍与四条被否决做法
- 新增里程碑规范与实施计划，列出范围、验收标准、文件切分、验证命令与两个回滚点
- 同步 Tripo 技术方案的定价段形状、后端架构表目录的两列说明、CONTEXT.md 术语与决策记录

SpacetimeDB 定价表追加 3D 两段列，记录形状先能表达端点 × 版本 × 贴图与加价项 ... 774b74d3d6

- editor_generation_pricing_config 末尾追加 text_to_model_pricing / image_to_model_pricing 两个 Option 列并带显式默认值
- 新增模型版本底价、加价项、端点定价三个 SpacetimeType 行类型，模块侧按段校验空段、缺半段、重复键与非正价格
- upsert 输入、快照、生成绑定与客户端记录映射同步两段字段
- api-server 保存路径本次先写空值，读取仍走本地文件缓存；补模块段级归一化用例

3D 定价段拆成端点并列的两段结构 ... 9f4a71d2e3

- Model3dPricingConfig 改为 textToModelPricing / imageToModelPricing 两段并列，各持自己的 versionPrices 与 addOnPrices
- 新增 Model3dEndpointPricing 承接单端点定价，校验与查价按端点委派，溢出检查覆盖两段
- 受控默认 JSON 的 model3d 段同步改为两段结构
- 3D 定价相关用例夹具与断言更新到两段形状

公开读模型 3D 段保持迁移前的旧形状 ... ebd904e193

- 新增 Model3dPricingPublicView，把内部两段结构投影回 basePrices 端点判别 + addOnPrices 单表
- 公开路由改用投影视图，画布 3D 入口与前端类型不需要随本次迁移改动
- 投影取文生 3D 段的加价项，两段不一致时打告警提示前端升级前不要差异化
- 公开路由用例补断言钉住 3D 段旧形状

3D 定价记录转换与读取归一化接上 SpacetimeDB 两段列 ... 5e47f0c41e

- 新增 editor_generation_model3d_records 深模块：配置与两段记录行之间双向转换
- 写入方向严格：落库前按契约强校验，缺键与契约外键都不写
- 读取方向归一化：记录缺键（含整段缺失的老行）用本地配置同段补齐，契约外键剔除并告警，补齐后仍不合法才判非法
- 定价配置读取以表为准，覆盖文件降级为种子与兜底；state.rs 保存路径写入两段
- spacetime-client 补导出 3D 定价记录类型，api-server 定向用例覆盖往返、补齐、剔除与拒绝

覆盖文件缺 3D 段时按受控默认价补齐，不再把 3D 整段算成未配置 ... 952bc1ccaa

- 新增 backfill_legacy_model3d_pricing：旧覆盖文件整段没有 3D 时补上默认 JSON 的两段并告警
- 覆盖文件继续只承担种子与兜底，避免老种子文件把 3D 生成整段关掉
- 补用例覆盖覆盖文件缺 3D 段的读取

后台定价读取带版本、保存整段必填并做事务内乐观锁 ... ee4a9434fa

- shared-contracts 新增定价版本冲突标记，module 与 api-server 共用一处声明
- SpacetimeDB upsert input 增加期望版本，事务内比对不一致即整笔拒绝（种子写入显式不比对）
- 定价 store 记录当前版本，读取路径带出 updated_at 微秒值
- 后台 GET 返回 models / 3D 两段 / updatedAtMicros，POST 要求两段显式给出且带期望版本
- 缺 3D 段 400、版本不匹配 409，退役 with_previous_model3d 与「省略即沿用」用例
- 绑定按 input 新字段重新生成，模块补乐观锁比对用例

后台模型定价页新增 3D 两段编辑区块与乐观锁提示 ... c901f6954f

- 新增 3D 定价区块：按端点分「文生 3D / 图生 3D」，各渲染模型版本 × {无贴图, 带贴图} 底价与加价项输入，键全部来自接口返回
- 抽出 adminEditorGenerationPricing 纯模块：数值解析、提交前 ≥1 校验、加价项中文标签、保存请求组装
- 保存整段回传 models 与 3D 两段，并带 expectedUpdatedAtMicros；409 提示重新读取且提供入口
- 后端未配置 3D 段时提示并禁用保存，不在页面新建或停用整段
- API 类型与客户端补两段、定价版本与保存请求类型；补组件与纯模块用例

3D 定价后台可编辑补齐实现状态、验收证据与踩坑记录 ... c5a718ac0e

- 主规范补公开读模型投影口径、覆盖文件缺段补齐、旧形状覆盖文件的发布前置门禁与加价项一致性约束
- 实施计划补实现状态表、逐条判据的验收证据与真实环境待验收项；里程碑标记已实现待验收
- 后端架构文档补 upsert input 的期望版本与事务内 CAS 语义
- pitfalls 补「省略即沿用会静默覆盖」与「公开读模型形状不能跟着存储形状走」两条
- decision-log 补实现期的四个口径：公开投影取文生加价项、CAS 复用 updated_at、覆盖文件缺段按默认补齐、旧形状不兼容改发布门禁

3D 查看器给签名地址的兄弟资源补回鉴权 query ... f4083dcb6d

- loader 新增 resolveModel3dViewerSourceQuery / resolveModel3dViewerResourceUrl，只补模型目录下的资源地址
- glTF / FBX 解析改用带 URL 修饰器的专用 LoadingManager，不动全局 DefaultLoadingManager
- 补测试：query 提取与片段剔除、目录内外的补与不补、多文件 glTF 兄弟资源解析

3D 查看器容器宽高比变化时按新比例重算取景 ... 5285832acb

- framing 新增 resolveModel3dViewerReframedCameraPosition：保留朝向与相对缩放并钳进新缩放范围
- scene 的 ResizeObserver 不再只认首次尺寸，宽高比变化超过 1% 就重算取景
- resetView 改为按容器当前宽高比重算，不再复用可能过期的取景
- 首帧直接套用创建时的取景，避免重复一次顶点采样
- 补 framing 测试：朝向保留、相对缩放保留、缩放钳制与方向退化

补齐定价版本术语与 Tripo 技术方案的乐观锁说明 ... 5b488f5a59

- CONTEXT.md 补「定价版本（乐观锁）」术语，并在 3D 生成定价条目写明权威事实源与公开投影
- Tripo 技术方案补后台保存的版本比对与 409 语义

补齐 Tripo 3D 错误映射的剩余分支测试 ... 83913785ae

- 增补 SDK 参数错误、无状态码 Api、Api 5xx、Sdk 兜底与传输错误的 502 用例，断言只回固定文案、不回显上游报文与 task id
- 增补 map_request_error 的字段口径用例：平台字段路径、provider 字段名与字段未知时不写 field
- 增补 map_pricing_error / map_pricing_store_error / oss_unavailable 的状态码、provider 与 reason 断言

3D 结果序列化失败不再落「完成但 result 为空」的终态 ... 48ba8b3133

- job_result_payload 改为返回 Result，失败按 500 上报服务端问题，去掉 result:null 兜底形状
- worker 持久化前用 ? 把失败交给既有失败链路：任务按失败终态处理并冲正扣费
- worker 测试夹具同步改为 expect，断言完成结果可序列化

3D 生成请求落点改为平坦可选字段并复用统一落点预检 ... fd48829c24

- 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）。

3D 生成前端提交体跟随平坦落点契约 ... f659ddfcf0

- 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 通过。

3D 落点契约文档同步为平坦可选字段 ... 21b9d850c7

- 技术方案的请求契约段改成平坦可选 projectId / canvasCompletion / assetFolderId / assetLabel，并把「二选一 + 同现拒绝」的口径与落点预检路径写清。
- 里程碑与实施计划把 tagged enum 的表述改成平坦字段与二选一验收口径。
- 前端入口与 Worker 计划的落点表述去掉 target 分支写法，改为只发 projectId / 素材库落点产出 assetId。
- 决策记录补一条：撤销请求侧 tagged enum、复用统一定点预检、素材名缺省回落默认名，并记下未做的目录归一与原因。

3D 提交侧归一落点并删掉 Standard 顶层 result 透传 ... 9edb4e5f80

- 提交侧新增归一并写回请求：项目 ID 只 trim，素材夹 ID 走其它工具同一套 normalize_generated_asset_folder_id（project / 旧 folder-* 收敛到 owner 默认素材夹），素材名走 resolve_editor_generated_asset_label（trim、截断到上限、缺省「3D 模型」），保证预检值 = 队列载荷 = 落库值。
- 队列行 sourceEntityId 改用共用 editor_generation_source_entity_id（项目 ID，缺项目回落 job kind），不再拿素材夹 ID 顶替。
- 按你的决定删掉 Standard 消费者顶层 result 逐字透传：标准消费者只回来源身份，3D 结果与图片等画布任务一样靠画布 placement / 素材行读回，连带删掉「3D 生成没有画布读回路径」这条错注释。
- 技术方案与共享记忆同步落点归一、身份口径与结果读取路径；job.rs 补归一用例（含素材名截断）。
- 验证：cargo test -p api-server（1193 passed）、cargo test -p api-server tripo3d::（55 passed）、npx vitest run src/components/image-editor/model3d-generation src/components/image-editor/model3d-preview（63 passed）、check:rustfmt / check:encoding / check-doc-index / git diff --check 通过。

3D 图生输入解析把「缺对象键」改判为服务端问题 ... 8a8c00fbb6

- resolve_source_object_key_with 在记录已解析但缺对象键时返回 502 与 model3d-image-source-object-key-missing，不再复用「引用不可用」的 400
- 未登记 / 跨 owner / 已删除仍收敛成同一句 400；缺对象键口径与 editor_project::validate_editor_reference_id_for_owner 的 BAD_GATEWAY 对齐
- 定向用例改名为 image_source_resolution_reports_missing_object_key_as_server_side_failure，断言状态码与 reason

3D 图生输入解析只收敛「引用不可用」状态码 ... 1be77d2f99

- resolve_source_object_key_with 的 4xx 收敛从 is_client_error() 收窄为 400 / 404，不再把 403 服务身份校验失败与 409 并发冲突也说成「图片必须是已登记资源」
- 与模块注释「只有基础设施失败保留原状态码」的实际口径统一，403 / 409 / 5xx 一律按原状态码上报
- 定向用例改名 image_source_resolution_only_collapses_unavailable_references，覆盖 400 / 404 收敛与 403 / 409 / 500 保留

3D 图生输入解析的测试改为断言可观察行为 ... 11d1324857

- 删掉 include_str! 嵌源码、按 token 断言「没出现列工程 / 列素材库」的守卫：它测的是实现文本，改名、换格式、调顺序都会误伤
- 定点查询用例改成覆盖 resource / asset 两个分支，断言每个分支只发起一次按 ID 的查询、且对象键原样来自记录
- 模块文档写明定点查询由注入签名收口（一个 ID → 一条记录），失败语义与测试口径一并写实

图生 3D 图片输入的失败语义同步到文档 ... 1fa413a352

- 实施计划写明预检失败的状态码口径：400 只覆盖跨 owner / 未登记 / 已删除 / kind 不符，403 / 409 / 5xx 保留原状态码，缺对象键 502
- 决策记录新增同日条目，说明收窄收敛范围与缺对象键改判 502 的原因、代价与验证方式

3D 预览产物 content type 改为按字节识别 ... c64bfc3867

- storage.rs 新增 sniff_preview_content_type（PNG / JPEG / WebP），resolve_artifact_content_type 改为按槽位判定：预览与模型一样先嗅探字节，嗅不出才回落声明值（最终仍回落 image/webp）
- 修掉 provider / CDN 不写或写错 Content-Type 时 PNG 预览被写成 image/webp 并传播到 OSS metadata、asset_object.content_type 与生成结果的问题；对象键扩展名随之正确
- 定向用例重写为「字节优先 / 未知回落」两组，替换原先钉住「预览不嗅探」的用例
- 技术方案与决策记录同步该口径，并记录与其它图片链路（bgfilter / VectorEngine / 生成图落 OSS 适配器）的一致性对照

3D 落点放宽为「至少一个」并把结果引用改成平坦字段 ... 158f9b741d

- 校验层不再要求「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 通过。

3D 前端提交跟随其它画布生成工具同时落素材库 ... a753ac4cd8

- 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 通过。

3D 落点与结果引用对齐其它生成工具的文档同步 ... 825dde6602

- 技术方案：落点改为「至少一个、两个可同给」，补上归一在预检之前完成并写回请求（预检值 = 队列载荷 = 落库值）；完成结果读取补上双落点与平坦引用的说明。
- 技术方案素材库一节改为「素材库行已接 model3d 分支（预览图渲染 + 拖入画布）」，后台 renderer / 精选 read model / 公开 grant 仍未接。
- 里程碑与实施计划（API 契约、前端入口、结果前端预览）同步新口径：两个落点同给合法、前端同时发 projectId + assetFolderId + assetLabel、素材库行已进入。
- 共享记忆 decision-log 追加本次决策（原因、代价、影响面、验证方式），并在旧的「二选一」条目上标注 2026-09-23 追加修正。
- 验证：node scripts/check-doc-index.mjs（221 份 Markdown 通过）、npm run check:encoding、git diff --check 通过。

platform-tripo 构造配置时拒绝零超时与空白凭据 ... ffee739774

- TripoSettings::new 改为返回 Result：request_timeout 必须大于零，api_key / base_url 不能是空白
- 新增 TripoSettings::validate 与 TripoError::Configuration，字段是公开的，因此 TripoProviderClient::new 在使用前再校验一次
- 拒绝零超时的理由是同一个值存在两种语义：tokio::time::timeout 立即超时，reqwest 却当成不超时
- api-server 构造入口把构造失败按既有 503 口径映射，并补全 TripoError 的匹配分支
- smoke 示例与 platform-tripo 测试跟进新的构造签名，新增零超时 / 空白凭据用例

3D 生成请求允许缺省 geometryQuality 并按 standard 计价 ... 427b9f19a1

- PricingParamView::validate 去掉 geometryQuality 必填，缺省按 standard 计入定价
- 只有显式 detailed 才命中 hdGeometry 加价，缺省不会改变报价
- 新增缺省几何质量的定价用例（v3.1 与 v2.5 两条路径），并把它从必填字段用例里移除
- 同步技术方案：说明该字段允许缺省的原因，v2.5 / P1 / P2 因 provider 不支持该参数而必须允许缺省

3D 生成请求允许缺省 textureQuality 并按 standard 计价 ... 6a7cf294a0

- PricingParamView::validate 不再要求 texture=true 时显式给出 textureQuality，缺省按 standard 计价
- 只有显式 detailed / extreme 才命中 hdTexture / ultraTexture 加价，缺省不改变报价
- v2.5 拒绝任何显式 texture_quality，必填规则会让 H25 + texture=true 永远不可达
- texture=false 仍禁止出现贴图档位，原有冲突校验与用例保持不变
- 同步技术方案：说明 geometryQuality / textureQuality 两个字段允许缺省的共同理由

k88936 added 15 commits 2026-09-23 20:00:23 +08:00

3D 产物 content type 只认字节或槽位白名单，去掉兜底 ... a4132616d8

- 删除 fallback_extension 与「未知声明原样放行 + 扩展名兜底」的归一逻辑
- 槽位白名单收敛为唯一映射表（content type ↔ 对象键扩展名），跨槽位类型返回 None
- resolve_artifact_content_type 改为返回 Result：字节认不出且声明不在白名单时按 502 失败，
  不再把 text/plain 之类的声明连同拼出来的 .glb 扩展名落进 OSS 与 asset_object
- 错误体只回显截断到 64 字符的声明值，避免把任意长度的 provider 文本带进响应
- 重写 storage 测试：新增白名单外声明、跨槽位类型与字节认不出三类用例
- 同步技术方案：说明白名单范围与「不做任何兜底」的口径

3D 允许 projectId 为空的文档与共享记忆同步 ... 347d066fc5

- 实施计划（API 契约）：交付验收补上「只给 assetFolderId 合法」这一条。
- 里程碑（API 契约）：落点口径写成「两个都给合法、只给 assetFolderId（无画布工程）同样合法」。
- 实施计划（前端入口）：发送门禁改成「两个落点至少给一个」，projectId 可空、缺失时不发该字段，没有工程时结果只落素材库。
- 共享记忆 decision-log：在 G5 条目的「代价与取舍」里把「3D 仍要求 projectId」改成「同日按用户决定改为与其它工具一致」，并追加一条收尾说明（门禁常量改名、canvasCompletion 只随 projectId 下发、无工程时的读回边界）。
- 验证：node scripts/check-doc-index.mjs（221 份 Markdown 通过）、npm run check:encoding、git diff --check 通过。

3D 产物下载的重试改为覆盖整个响应体 ... b33a8a141c

- download_model / download_rendered_image 把「取响应头 + 读完 body」作为一次可重试事务，
  每次尝试都重新取响应头并整体重下，不做断点续传
- body 传输失败与长度不一致归一成可重试的传输错误（不再带 HTTP 200），HTTP 状态只留在文案里
- 新增 TripoArtifactBytes（读完的产物）并公开 download_model / download_rendered_image 的 max_bytes 上限；
  超限按 OutputSchema 失败且不重试，流式句柄 TripoDownloadedArtifact 收回 crate 内部
- api-server 的 read_artifact 改成对完整产物做落库前校验（只判空），体积上限转由调用方传入
- smoke 示例改为一次写入完整字节；新增「body 中途断开后整体重下成功」与「超限不重试」两个用例
- 同步技术方案与实施计划：把「只重试响应头」的描述改成「重试包住整个 body」

共享记忆补记本轮 3D 收口的四条决策 ... 508cf30f5d

- 产物 content type 不再兜底：白名单外一律按上游内容不合法失败（并作废预览条目里的回落口径）
- 两个改价字段 geometryQuality / textureQuality 允许缺省，按 standard 计价
- provider 客户端构造即校验配置（零超时 / 空白凭据）与产物重试包住整个 body 记录在同一条

geometry_quality 预检只拒绝 detailed，standard 按不传处理 ... f6f41f22c3

- validate_generation_options 对非 v3.1 / v3.0 家族只在取值 detailed 时拒绝，
  与 quad / smart_low_poly / generate_parts「只拒绝启用值」的处理对称
- 新增 wire_geometry_quality：不支持的家族把 standard 收敛成不发（等价于 provider 默认档），
  三个 endpoint 的请求映射都过这一层，避免 provider 因「不支持该字段」整单拒绝
- 新增两组表驱动用例：非 v3 家族 standard 放行 / detailed 拒绝，以及映射层的收敛结果
- 同步技术方案：写明「预检只拒绝启用值」与映射层收敛 standard 的口径

可重试性改为显式判定，不再由 status 缺省推断 ... 42b4315b4f

- TripoError::Request 增加 retryable 字段：由产生错误的一方按真实分类判定
- 传输层失败按 reqwest 的 is_timeout / is_connect 分类（新增 transport_error_is_transient，
  以及状态集合 http_status_is_transient）
- SDK 的 Error::Request 只在带瞬时状态码、或底层 reqwest 错误确实瞬时时可重试；
  source 为空（空 body / 格式错误 / 缺 data 字段）不再重试
- 产物客户端构造失败标为不可重试；无数据推进、body 读取失败与长度不一致标为可重试
- 新增四组用例：显式标记、状态集合、SDK 分类，以及用真实 reqwest 错误（连接被拒 vs 非法地址）验证分类
- 同步技术方案：写明「可重试性由产生错误处判定」的口径

提交前先判预算，耗尽时不再发起计费的 submit ... 85219ad1d4

- run_model3d_job 在没有 checkpoint 的分支上先走 ensure_submit_budget：
  预算已被解析 / 排队耗光时直接按 provider 超时终态失败，不去白花一次 provider 提交
- 续跑（已有 checkpoint）分支不受影响，仍然只轮询不提交
- 新增用例：预算耗尽必须拒绝提交，仍有预算必须放行

把 checkpoint 分支写实为 at-most-once 硬约束而非续跑能力 ... 985955205c

- worker.rs 模块注释明确 Tripo job 固定 max_attempts = 1，崩溃后租约耗尽直接终态失败、不会被重新 claim，因此不存在续跑路径
- worker.rs 说明 existing_checkpoint 是防御性硬约束，checkpoint 的日常用途是人工对账
- 技术方案与 ADR 把「崩溃后重新 claim 只查询」改写为「不重新 claim，带 checkpoint 的路径绝不二次 submit」
- 实施计划与里程碑同步 checkpoint 语义，不再宣称续跑

59/60/61/65 按决定不修复，改为在代码里写清取舍 ... 6b1114356c

- worker.rs：说明 last_error_message 是落库且前端直接展示的摘要，只取 provider message，不塞内部 reason/taskStatus（#59）
- platform-tripo error.rs：说明 ADR 0001 要求平台层不带出 SDK 错误模型，Io/Serde 只保留文本（#60）
- platform-tripo mapping.rs：说明 Tripo 文档把 generated_image_url 列为 text_to_model 固定字段，按 ADR 0001 失败关闭保留必填（#61）
- platform-tripo image_to_model/client.rs：说明 PublicUrl 只做非空白校验的边界条件与将来接外部地址时的校验位置（#65）

图生 3D 的资源派生来源改为取自请求的 source ... df6694c4a9

- job.rs 新增 Model3dJobRequest::source_resource_id()：resource 来源带出画布资源 id，素材库来源与文生 3D 没有可登记的来源资源
- worker.rs 落库时资源行与素材行都改用它：资源行记派生来源，素材行优先指向本项目的资源行、只落素材库时退回请求里的来源资源
- 新增单测钉住三种来源（resource / asset / 文生）的取值，不再拿本次新生成的输出资源 id 冒充来源

3D 失败态下主按钮也开新一代，不再重现同一次失败 ... 5ebc6df6ae

- Model3dGenerationModal 主按钮与「重试」共用失败态重置后的 dialog（refreshModel3dAttemptNonce），失败态点主按钮不再沿用旧幂等键
- 新增用例：失败态主按钮提交的代次必须变化、状态回到 idle，且按钮保持可点

multiview 视图输入显式化为 url / fileToken，线上按文档 view-key 形态发出 ... f198b7a6d0

- 契约新增 Model3dViewInput（url / fileToken 的 tagged enum），views 的四个视图都改用它，裸字符串在契约层即被拒绝
- platform-tripo 不再走 SDK 的位置数组形态：按 Tripo 文档推荐的 view-key 构造 inputs，值写成显式 {url} / {file_token}，种类由契约字段决定、链路上不再猜前缀
- 视图校验（front 必填、至少两张、空白按未提供）与 inputs 构造合并成一条路径，不再两处重复规则
- 新增 4 条定向用例钉住发出的 JSON 形状、空白视图、视图数量与 taskId 复用；契约用例补齐裸字符串与视图内未知字段被拒
- 重新生成 ts-rs 绑定与导出索引，技术方案同步 multiview 输入口径

共享记忆补记本轮 3D 收口的三条决策与一条踩坑 ... 5ee9a1e2e2

- decision-log：视图输入显式化并改按文档 view-key 形态发出、派生来源取自请求 source、失败态提交开新一代
- pitfalls：失败态沿用同一尝试代次会让主按钮只是重现同一次失败，以及新增提交入口时的判断口径

合并 origin/master：保留 3D 契约与 provider checkpoint，旧玩法表随主线退役 ... d231cc4602

- 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 中

清掉 api-server 两条编译告警：未使用导入与测试态死代码 ... eb27bb9226

- server-rs/crates/api-server/src/tripo3d/routes.rs：删除未使用的 Model3dJobTarget 导入，同批使用的 Model3dJobKind 等保留
- server-rs/crates/api-server/src/state.rs：map_editor_generation_pricing_persistence_error 只被 cfg(not(test)) 分支调用，补 cfg_attr(test, allow(dead_code))，与同文件 seed_editor_generation_pricing_config 的既有写法一致
- 验证：cargo check --workspace --all-targets 零告警零错误

k88936 added 3 commits 2026-09-24 15:27:08 +08:00

Tripo 配置改为启动期失败关闭，缺网关或密钥的进程拒绝启动 ... d1e11c705d

- api-server 新增启动期门禁：会提交或会执行 3D job 的角色（api / external-generation-worker / all）缺 TRIPO_BASE_URL 或 TRIPO_API_KEY、值为空白或网关不是合法 HTTP(S) 地址时直接拒绝启动；bgfilter-worker 与 external-generation-controller 不受影响
- 删除内置默认网关常量，AppConfig::default() 的 tripo_base_url 改为空串；请求路径不再把超时静默钳到 .max(1)、重试钳到 .min(10)，坏值原样交给 TripoSettings 并映射 503，作为启动期之后的第二道防线
- 两个运行旋钮仍可缺省（沿用内置 60000 / 2），显式声明时零超时、非数字或重试超过 10 都判启动失败
- .env.example 与 deploy/env/api-server.env.example 补齐 TRIPO_* 必填说明；deploy/container/api-server.env.example 与 container-worker-smoke 生成 env 补占位值，避免容器压测与 Jenkins 分支预览起不来
- 文档：新增 ADR 0006 并登记 docs/README.md，同步外部生成 Worker 化方案、开发运维文档、CONTEXT.md、决策记录、踩坑记录与实施计划

画布底部工具栏不再横向滚动，工具放不下就换行 ... 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 覆盖，只保留限宽

3D 生成面板开放模型版本选择，参数按模型能力门禁 ... 42c3186e13

- 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 各记两条

k88936 added 1 commit 2026-09-24 15:29:04 +08:00

Merge remote-tracking branch 'origin/master' into feat/tribo3d-integeration ... ff38eb0308

# Conflicts:
#	docs/project-memory/shared-memory/decision-log.md
#	docs/project-memory/shared-memory/pitfalls.md

k88936 added 86 commits 2026-09-24 21:19:40 +08:00

修掉 AGC 工具栏守卫：二级菜单不裁剪的断言改钉共享工具栏规则 ... 127e491ab0

- apps/ai-game-creator-shell/tests/appSurface：`.game-resource-bottom-toolbar-strip` 的 `overflow: visible` 断言随宿主覆盖一起失效；改读 packages/image-canvas-react 的 `.genarrative-image-canvas__toolbar` 规则，断言「flex-wrap: wrap 且不声明任何 overflow 裁剪」——机制住在共享工具栏里，谁把横向滚动容器加回来，二级菜单就会被裁掉，这条先失败（已注入 overflow-x: auto 复验过会挂）
- apps/ai-game-creator-shell/src/features/resource-canvas/resourceCanvasChrome.css：删掉已过期的「共享 chrome 是横向滚动条」注释，改成当前口径——换行与不裁剪由共享工具栏保证，这里只限宽

后台 3D 定价校验不再因缺段或缺子表整页崩掉 ... 367fa2f5f1

- apps/admin-web/src/pages/adminEditorGenerationPricing.ts：提交前校验对 3D 端点段做存在性判断，缺段直接跳过该段
- apps/admin-web/src/pages/adminEditorGenerationPricing.ts：versionPrices / addOnPrices 取值补 `?? {}` 兜底，接口返回残缺时降级为「校验不出问题」，不再抛异常白屏

后台定价校验：空 prices 不再跳过底价检查 ... 7adf560f15

- apps/admin-web/src/pages/adminEditorGenerationPricing.ts：分层计价分支改为仅当 prices 真的有档位时进入，`prices: {}` 不再让 modelPricing.price 逃过提交前校验

后台定价输入解析不再把小数与半截数字静默截断 ... 84c5129225

- apps/admin-web/src/pages/adminEditorGenerationPricing.ts：parsePositiveInteger 改用 Number + Number.isInteger，`3.9`、`12abc` 这类输入收敛成 0 交给提交前校验，而不是截成 3 / 12
- apps/admin-web/src/pages/adminEditorGenerationPricing.test.ts：补小数与尾随非数字字符的用例

后台 3D 定价两栏底价输入改为描述表驱动 ... 62e6bfc52f

- apps/admin-web/src/pages/AdminEditorGenerationModel3dPricingSection.tsx：抽出 VERSION_PRICE_FIELDS 描述表，无贴图 / 带贴图两栏共用一段 JSX，字段键与展示名只有一处来源，避免两栏后续改动走偏

契约绑定生成脚本改用能命中的过滤器 ... e5076eb27c

- package.json：contracts:model3d:generate 的过滤器由 `model3d editor_canvas` 改为工作区文档写明的 `export_bindings`；ts-rs 生成的用例名是 `export_bindings_<类型名小写>`，`editor_canvas` 带下划线永远匹配不到 editor-canvas 两个绑定，此前脚本实际只重生成 model3d 一侧

取景视角限定在 (0, 180)，非法值回落到默认视角 ... 3624f454e2

- 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 回落到默认视角的用例

取景距离抬到不会让轨道缩放范围颠倒的下限 ... 55ce6d7129

- packages/model3d-viewer/src/framing.ts：computeModel3dViewerFitDistance 对调用方传入的距离加下限（radius × 0.2 / 8），避免 distance 过小时 maxDistance 小于 minDistance，取景与轨道钳制同时失效
- packages/model3d-viewer/src/framing.test.ts：补极小距离的下限用例

查看器取景装配失败时释放 renderer 与模型资源 ... 0c0819249d

- packages/model3d-viewer/src/scene.ts：模型加载成功后的取景 / ResizeObserver / 渲染循环装配抽成 setupLoadedScene，由外层 try/catch 兜住；任何异常先 teardown 再抛出，避免调用方拿不到 scene 引用时漏掉 WebGL 上下文与模型 GPU 资源

查看器认得 ASCII FBX 的字节开头 ... 61cfb8800d

- 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（含前导空白）的字节判定用例

查看器不再把 glTF 解析失败吞成「未知错误」 ... 5d68749534

- packages/model3d-viewer/src/loader.ts：GLTFLoader 的 onError 回传 ErrorEvent，改为先取它的 message 再包成 Error 抛出，外层报错能带出真实解析原因，而不是退化成「未知错误」

图生 3D 的素材库空确认不再清掉已选参考图 ... fb0be97609

- src/components/image-editor/ImageCanvasGenerationDialogModel.ts：单槽对话框只在素材库确实选到了图时才做「替换」，空确认退回原行为（保留画布点选/上传的那张）。此前确认按钮不校验空选，空确认会把已有参考图直接清掉
- src/components/image-editor/projectAssetReferencePickerModel.test.ts：补空确认保留画布参考图的用例

生成中禁用图生 3D 参考图的删除按钮 ... 89b8211b94

- src/components/image-editor/model3d-generation/Model3dGenerationForm.tsx：已选参考图槽位补 disabled={disabled}，提交中不再能删掉这次请求用的参考图，与面板其余控件的禁用口径一致

3D 面板参考图菜单的边界 refs 数组稳定下来 ... cd5218535e

- src/components/image-editor/model3d-generation/Model3dGenerationModal.tsx：boundaryRefs 用 useMemo 缓存，避免每次渲染都新建数组导致浮层 dismiss effect 反复解绑/重挂 document 监听

3D 面板的重试代次改在点击时铸造 ... 3191ca9d89

- src/components/image-editor/model3d-generation/Model3dGenerationModal.tsx：失败态下的代次刷新由渲染体里的常量改为点击时调用的 resolveSubmitDialog()，提交键不再随每次重渲染（含 StrictMode 双渲染）变化，渲染保持纯函数

模型版本判据不再认下原型链上的键 ... 9840f17189

- src/components/image-editor/model3d-generation/Model3dGenerationValidation.ts：isModel3dModelVersion 改用 Object.hasOwn，`toString` / `__proto__` 这类继承键不再被判成契约版本（之后查表会拿到 undefined）
- src/components/image-editor/model3d-generation/Model3dGenerationFormModel.test.ts：补原型链键回落默认版本的用例

退役模型版本在报价与提交路径上一起回落默认版本 ... fe44054aa2

- src/components/image-editor/model3d-generation/Model3dGenerationFormModel.ts：resolveModel3dModelVersion 改为走 normalizeModel3dModelVersion，老快照里契约中已不存在的版本不再直接进 MODEL3D_MODEL_TABLE 查表（原来会抛异常），报价与提交体也不会分裂成两个版本；此前该归一化函数只有测试在用
- src/components/image-editor/model3d-generation/Model3dGenerationFormModel.test.ts：补 resolveModel3dModelVersion 收到退役版本的用例

报价缺价文案提成具名常量 ... 7b8bbac098

- src/components/image-editor/model3d-generation/Model3dGenerationFormModel.ts：底价缺失与加价项缺失两句文案按模块既有约定提成 MODEL3D_PRICING_MISSING_BASE_PRICE_REASON 与 resolveModel3dPricingMissingAddOnReason，不再散落在计算路径里

查看器未知失败原因退回兜底文案 ... bc68a9e884

- src/components/image-editor/model3d-preview/Model3dViewerModel.ts：default 分支保留 `never` 的编译期穷尽检查，但运行时（宿主与查看器版本错配）改回 fallbackText，不再把原始原因码当用户文案显示

提交计划去掉无人读取的 title 字段 ... 8d17855133

- src/components/image-editor/model3d-generation/Model3dGenerationSubmission.ts：Model3dSubmissionPlanBase.title 没有任何消费方（调用方自己按 resolveModel3dResultTitle 重算），删除该字段与它的装配代码，避免把死数据当成权威标题

提交计划把非图生模式显式判为不支持 ... 96b52ae7ee

- src/components/image-editor/model3d-generation/Model3dGenerationSubmission.ts：图生分支之后补显式模式判断，契约将来新增端点时直接失败关闭，而不是静默按文生请求发出、丢掉新端点的输入

3D 失败提示只透出服务端给的文案 ... 2350c56f2f

- 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 构造服务端文案，并补非服务端错误退回兜底文案的断言

3D 提交编排整段落在错误边界内 ... 5ba7a993de

- src/components/image-editor/model3d-generation/useModel3dGenerationTask.ts：把取占位框、算结果标题与构造提交计划一并移进 try，注入的回调或老快照缺字段导致的抛错不再漏成未捕获 rejection，而是照常写回失败态与提示
- src/components/image-editor/model3d-generation/useModel3dGenerationTask.test.tsx：补「计划构造阶段抛错」的用例（缺 prompt 的老快照）

3D 提交失败路径也刷新钱包余额 ... 3455b7a00f

- src/components/image-editor/model3d-generation/useModel3dGenerationTask.ts：请求失败与「2xx 但没有任务状态」两条路径都调用 onWalletBalanceMayHaveChanged，与其它画布生成链路的 runEditorGenerationWithWalletRefresh 同一口径（超时或空 body 的 2xx 都可能已经扣费）
- src/components/image-editor/model3d-generation/useModel3dGenerationTask.test.tsx：补两条失败路径各刷新一次钱包的断言

画布没接住任务状态时按失败收口 ... 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：原「回到空闲态」用例改为断言失败态

3D 两个生成模式也随失焦与关闭收起面板 ... 9c2a9383fc

- 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 模式的收起断言

画布导出的目录名单一来源 ... 0d2c81a3ce

- src/components/image-editor/useImageCanvasAssetExportWorkflow.ts：images / media / 3d_models 三个目录名提成 EXPORT_FOLDER 常量，建目录、挑目录与按层分流共用同一份字面量（写错目录名不会编译报错，只会在 zip 里悄悄换目录）

3D 面板的栅格覆盖不再依赖规则先后顺序 ... 2877ede719

- src/index.css：`--model3d` 面板的 grid/width/gap 覆盖把 `--image` 一起写进选择器提高特异性。它与 `--image` 的声明特异性相同，此前只靠 `--model3d` 排在后面取胜，规则顺序一变就会退回两栏布局

修掉没测到 API Key 分支的用例 ... 1600c107e0

- server-rs/crates/api-server/src/tripo3d/provider.rs：missing_api_key_is_reported_as_unavailable 先补全 TRIPO_BASE_URL 再断言缺密钥。AppConfig::default() 的网关是空串，原用例一直停在「缺网关」分支上，API Key 校验删掉也能过

请求路径也拦住越界的 TRIPO_RETRIES ... 62600fe881

- server-rs/crates/api-server/src/tripo3d/provider.rs：tripo_settings 显式校验 config.tripo_retries 不超过 TRIPO_MAX_RETRIES 并映射 503。TripoSettings::validate 只查空值与零超时，越界值会原样进 artifact_retries，把产物下载的挂起时间成倍拉长；注释里「第二道防线」的说法此前并不成立
- server-rs/crates/api-server/src/tripo3d/provider.rs：补越界拒绝 / 上限放行的用例

请求路径也拦住写歪的 Tripo 网关地址 ... 110354fad9

- server-rs/crates/api-server/src/tripo3d/provider.rs：URL 判据（合法 URL + HTTP(S) + 有主机名）抽成 validate_tripo_base_url_syntax，启动期门禁与 tripo_settings 共用；非空但缺 scheme / 非 HTTP(S) / 无主机名的地址在请求前就映射 503，不再拖到 SDK 里变成一条指向连接失败的报错
- server-rs/crates/api-server/src/tripo3d/provider.rs：补请求期拒绝写歪地址的用例

定点引用查询补上调用方必须传本人 user_id 的说明 ... 72cdabbef3

- server-rs/crates/api-server/src/editor_project.rs：resolve_editor_reference_record_by_id_for_owner 从 pub 收窄到 pub(crate) 后授权边界移到调用方，给函数补上「必须传已认证用户自己的 ID，本函数不做授权」的前置条件说明，避免后续 crate 内调用方传入客户端可控的 owner 造成越权读取

provider 4xx 不再把原文错误体回给客户端 ... 643ffedfb6

- server-rs/crates/api-server/src/tripo3d/errors.rs：400..=499 分支不再拼接 error.to_string()。TripoError::Api 的 Display 直接转述 provider 的 code/message/suggestion（HTTP 错误体原文，未做 URL 清洗），可能把带签名的地址等内部信息带进用户可见的任务错误；改为固定中文文案

图生 3D 的源图对象键为空时按缺失处理 ... 0b3c15ee7c

- server-rs/crates/api-server/src/tripo3d/image_source.rs：预检对 object_key 加非空判断，空串 / 纯空白与缺字段同义。此前 Some("") 能过预检，等任务已入队计费后才在下载源图时失败

后台保存定价的版本推进改为饱和加法 ... d927a8cfa7

- server-rs/crates/api-server/src/state.rs：expected_updated_at_micros 来自后台请求体、只校验了必须给出，没有范围校验；expected + 1 在 i64::MAX 上会溢出（debug 下 panic、release 下回绕成 i64::MIN 并让版本推进失效），改用 saturating_add（与测试分支同一口径）

落点纵深防御的兜底字段名与归因口径对齐 ... 791011eacf

- server-rs/crates/api-server/src/tripo3d/target.rs：两个落点都没给时的兜底报错由点 projectId 改为点 target，与 target_unavailable_field 对 both-missing 的归因一致，不再把错误指到一个调用方可能根本没传的键上

落点校验的文档注释改成与实现一致 ... 8af4287bf3

- server-rs/crates/api-server/src/tripo3d/validation.rs：validate_target 的注释此前写「项目资源与素材库二选一 / 不接受两个都给」，与实际实现（两个都接受、只要求至少一个）以及用例 target_accepts_both_locators_but_requires_at_least_one 矛盾，改为按实际口径描述

3D 产物的 content type 与落库值同源 ... 79ae24fa43

- server-rs/crates/api-server/src/tripo3d/storage.rs：返回给调用方的 content_type 改为优先取 HEAD 复核回来的值（取不到才回落到本地解析值），与 asset_object.content_type 用同一份取值。此前接口返回的是本地解析值、落库的是 OSS 回显值，OSS 一旦归一化或回显空值，两个来源就会给出互相矛盾的元数据

带地址响应体的过滤改成大小写不敏感 ... 82e889dc6d

- server-rs/crates/platform-tripo/src/common/error.rs：body_snippet 先整串转小写再匹配 http:// 与 https://，`HTTPS://…` 这类大小写变体不再绕过过滤，签名 URL 不会被带进持久化的任务错误信息

修掉多视图生成 3D 请求文档注释里的漏字 ... 14294a2c9b

- server-rs/crates/shared-contracts/src/model3d/multiview_to_model/request.rs：公开文档注释「多视图生 3D」补回漏字，改成「多视图生成 3D」

旧 external_generation_job 归一化用例改成真断言 ... 40c97bf876

- server-rs/crates/spacetime-module/src/migration.rs：provider_kind / provider_task_id 的断言改成先 as_object() 取键再比 null，原先用 Value 索引在键缺失时返回 Null，归一化被删掉也照样通过

后台缺 3D 段的负例改成断言中文文案 ... f2d3e2218d

- server-rs/crates/api-server/src/app.rs：用例文案说「必须以中文文案拒绝」，断言却只查小写英文 model3d，改成断言「定价段必须整段给出」，真正守住中文拒绝这条契约

后台定价用例改键前先断言目标键存在 ... a8dc0d8870

- server-rs/crates/api-server/src/app.rs：改默认定价 fixture 时先用 pointer_mut 断言目标键存在再赋值，不再依赖 Value::index_mut 的隐式 panic，键名或版本号漂移时报错能指出是哪一层对不上

3D 定价整段兜底也要过端点校验 ... 98f2c21872

- server-rs/crates/api-server/src/editor_generation_model3d_records.rs：记录整段缺失时回退到本地配置前先跑 endpoint.validate()，缺键分支与兜底分支走同一条 fail-closed 路径，不再依赖调用方事后补 config.validate()
- server-rs/crates/api-server/src/editor_generation_model3d_records.rs：补用例锁住「整段缺失 + 兜底配置不合法」必须被拒绝

3D 查价的加价累加改成溢出即报错 ... f82eba4c94

- server-rs/crates/api-server/src/tripo3d/pricing.rs：endpoint 查价用 checked_add 替换 saturating_add，溢出走新的 Model3dPricingError::PriceOverflow，与加载校验的 fail-closed 口径一致，不再静默夹到 u32 上限按错价收费
- server-rs/crates/api-server/src/tripo3d/pricing.rs：补用例锁住「底价 + 加价项溢出必须报错」

3D 产物哈希挪到 blocking 线程池 ... 7a4ccb8bfe

- server-rs/crates/api-server/src/tripo3d/storage.rs：上传前对最大 512 MiB 的产物做 sha256 会占住一个 Tokio worker，改成 spawn_blocking 并把 bytes 原样带回（不做整块复制），失败按 500 收口

平台层 Tripo 配置把 base_url 校验成绝对 http(s) 地址 ... b54ff06bc7

- server-rs/crates/platform-tripo/src/common/config.rs：validate 用 url::Url 解析 base_url，缺 scheme（openapi.tripo3d.com）、非 http(s)（ftp://）与无 host 的值都在构造点按 Configuration 失败，不再拖到请求期变成传输层报错
- server-rs/crates/platform-tripo/src/common/config.rs：补用例覆盖缺 scheme / 非 http(s) / 非法 URL 被拒、前后带空白的合法地址放行

平台层转发 API Key 前去掉首尾空白 ... 80ae730dc5

- server-rs/crates/platform-tripo/src/common/config.rs：client_options 里 api_key 先 trim 再交给 SDK，校验口径与发送口径统一，带空白的密钥不再变成 provider 侧的 401
- server-rs/crates/platform-tripo/src/common/config.rs：补用例锁住 client_options 发送的 api_key 已 trim

平台层转发 base_url 前去掉首尾空白 ... ebce5f9304

- server-rs/crates/platform-tripo/src/common/config.rs：client_options 里 base_url 先 trim 再交给 SDK，带空白的地址不再以低层解析错误的形式暴露出来
- server-rs/crates/platform-tripo/src/common/config.rs：把 client_options 的用例扩到 base_url，锁住「校验看到的」与「发出去的」是同一个值

传输判据补上 is_body，并把截断体的归因写清 ... 2330a25172

- server-rs/crates/platform-tripo/src/common/error.rs：transport_error_is_transient 补上 is_body()，与 TripoError::Request.retryable 文档列举的瞬时类型对齐
- server-rs/crates/platform-tripo/src/common/error.rs：注释写明「传输中途截断的响应体在 reqwest 里落在 Decode」这一实测结论，说明为何不把 Decode 判成可重试
- server-rs/crates/platform-tripo/src/common/error.rs：补用例用截断响应体锁住 Decode 不判可重试

产物文件名主干加上长度上限 ... 0c716d7d9c

- server-rs/crates/platform-tripo/src/common/types.rs：sanitize_artifact_file_stem 在字符过滤后按 MAX_ARTIFACT_FILE_STEM_LEN=128 截断，远端来的超长主干不再拼出超过文件系统名字上限的一长串
- server-rs/crates/platform-tripo/src/common/types.rs：新建 types 的用例模块，锁住超长 / 带路径的主干被中性化并截断、全中性化后为空时退回固定名

产物扩展名兜底认下 image/jpg ... 925be4573d

- server-rs/crates/platform-tripo/src/common/types.rs：fallback_artifact_extension 补上 image/jpg 分支，非标准写法但确有 provider 这么回，预览图不再落到默认 .glb 后缀
- server-rs/crates/platform-tripo/src/common/types.rs：补用例覆盖 png / jpg / webp 与读不出形态时的 glb 兜底

写明 TripoUrl 脱敏只覆盖 query 与 fragment ... 03aec35350

- server-rs/crates/platform-tripo/src/common/types.rs：redacted() 的文档注明脱敏范围只到 query / fragment，若 provider 改成把 token 写进路径（如 path-style SAS）则需一并处理路径段；无 query 分支补注释说明路径原样保留

产物结构体不再派生 Debug，改成只打元数据 ... b83113619e

- server-rs/crates/platform-tripo/src/common/types.rs：TripoArtifactBytes 去掉 derive(Debug)，改为手写实现，只输出 url / content_type / content_length / 字节数，几十 MB 的 bytes 不会再被一次 {:?} 刷进日志
- server-rs/crates/platform-tripo/src/common/types.rs：补用例锁住 Debug 只带字节数、不带字节内容

平台层校验补上 pbr 依赖贴图 ... 06f091f0ff

- server-rs/crates/platform-tripo/src/common/validation.rs：validate_generation_options 增加 texture=false 与 pbr=true 的组合拒绝（TripoField::Pbr），直连调用方不用再把这种不会成立的组合拖到 provider 侧才报错；放在 generate_parts 分支之后，不改变该分支原有的归因
- server-rs/crates/platform-tripo/src/common/validation.rs：补用例锁住 texture=false + pbr=true 被拒、texture=true 时放行

图生 3D 的引用类型判别改用枚举 ... cc472d0736

- server-rs/crates/api-server/src/tripo3d/image_source.rs：ResolvedReference.kind 从 &'static str 改成 ResolvedReferenceKind 枚举，From<EditorReferenceRecord> 写值与匹配比较由同一处产出，字符串错字不再只在运行期暴露
- server-rs/crates/api-server/src/tripo3d/image_source.rs：对外文案仍由 as_str() 生成，用例同步改用枚举取值

删掉根目录临时 3D 样例模型并移除对应的根级忽略规则 ... 02f334b04a

- 删除仓库根目录手工下载的 image_to_model.glb / multiview_to_model.glb / text_to_model.glb 三个临时样例（合计约 125 MB，本来就没入库）
- .gitignore：移除只为它们存在的十条根级规则（/*.glb、/*.gltf、/*.fbx、/*.bin、/*.png、/*.jpg、/*.jpeg、/*.webp、/*.ktx2、/*.tga），根目录再出现同类文件会正常显示为未跟踪，不再被静默忽略

3D 冒烟示例把产物写到 target 目录，不再落到仓库里 ... acdfb8ed73

- server-rs/crates/platform-tripo/examples/tripo_generation_smoke.rs：产物落盘目录从「当前工作目录」改为 <cargo target>/tripo-smoke-artifacts，开始前建目录并打印路径；该目录本来就在入库排除范围内，根目录不会再攒出临时模型
- server-rs/crates/platform-tripo/examples/tripo_generation_smoke.rs：文件头文档同步改为说明新的产物落点

后台各页的整数解析统一到共享助手 ... 9bcd8f728b

- apps/admin-web/src/pages/pageUtils.ts：新增 parsePositiveInteger，用 Number + Number.isSafeInteger，空串 / 非数字 / 小数 / 0 / 负数一律收敛成 0
- 删除 AdminTaskConfigPage、AdminProfileWalletConfigPage、AdminRechargeProductPage、AdminRedeemCodePage 与 adminEditorGenerationPricing 里各自的一份实现，5 个页面统一从 pageUtils 引入，修掉「钱包页拒 1.5、任务页把 1.5 当 1」这类口径不一致
- adminEditorGenerationPricing.test.ts 的引入路径同步改到 pageUtils

写明 ts-rs 的 feature 一律保持全开 ... c39798e491

- server-rs/Cargo.toml：把注释里「ts-rs 一律常开」改成明确口径——保持默认 features 原样，不写 default-features = false、也不逐个关掉，成员 crate 需要新能力时优先用默认已覆盖的部分，不改任何依赖声明

种子字段的对外类型改成普通数字，不再导出 bigint ... 5748cf303f

- shared-contracts：多视图请求与文生 / 图生参数的 seed 注记从 `bigint | null` 改成 `number | null`，并写明只支持 JS 安全整数范围（2^53-1）内的取值；Rust 侧仍是 `Option<i64>`，反序列化行为不变
- packages/shared：重新生成 model3d 绑定，seed 变成 `number | null`，请求体可以直接 JSON 序列化（带 bigint 的请求在 JSON.stringify 阶段必定抛错）；顺带补上此前漏生成的多视图请求文档注释（「多视图生 3D」→「多视图生成 3D」）
- docs/technical：在 Tripo Provider 集成方案里写明 seed 为什么按 number 导出、代价是超出 2^53-1 的取值无法从 TS 侧精确构造

写明产物是单文件，多文件模型的兄弟资源拼接只算兜底 ... 647822bbc4

- packages/model3d-viewer：把 resolveModel3dViewerResourceUrl 的注释改成实话——产物是单文件（.glb 自带几何贴图，.fbx 媒体内嵌），多文件模型不会出现，最多是「模型 + 一个 bin」；这段补签名只是最后一层兜底，签名按单个文件签发时会被云端拒绝，不指望它能读成功
- docs/adr 0003：同一条前提写进 ADR，并写明将来真要支持多文件模型时应当由宿主为每个兄弟文件分别换取临时地址，而不是继续扩展这段拼接

把 Tripo 配置写成明确的破坏性部署要求，并说明刻意不做开关 ... 6679dd2ebf

- docs 开发运维：Tripo 两项配置改成以「破坏性部署要求」表述，写明升级前必须配好、不做开关也没有缺配置先启动的逃生口，不需要 3D 的机器只跑不检查该配置的两个角色
- docs/adr 0006：补上同一条口径与理由（允许缺配置启动就会退回「起得来但悄悄坏掉」的形态），并写明被否决的逃生口

容器尺寸变化时只重算相机取景，不再重新采一遍顶点 ... 3900aa9157

- packages/model3d-viewer/framing：取景求解器把每个采样点投影后的「上下向 / 左右向 / 深度」存成样本，resolve 可以带上新的宽高比重算；顶点投影与宽高比无关，比例变化时只在这份样本上重取最大值，距离算法与取值口径不变（含非有限顶点作废整次取景的旧行为）
- packages/model3d-viewer/scene：顶点采样改成加载后只做一次，computeFraming 只调用 resolve(aspect)；拖拽面板连续触发 ResizeObserver 时不再重复 updateMatrixWorld 与逐顶点读取（单网格上限 20 万点）
- framing.test：补两条用例——带新比例重算与全新求解器结果一致、非有限顶点回落到与尺度相关的默认距离

后台模型定价保存去掉版本比对：保存即整段覆盖 ... ad2b37c6d3

- shared-contracts：删掉 `EDITOR_GENERATION_PRICING_VERSION_CONFLICT` 常量
- spacetime-module：`EditorGenerationPricingConfigUpsertInput` 去掉期望版本字段，删掉版本比对方法与它的用例，入库只按请求内容整段覆盖
- spacetime-client：重新生成定价 upsert input 绑定（少一个字段），记录映射同步去掉版本
- api-server：进程内缓存去掉版本字段与 409 冲突错误，`editor_generation_pricing()` / `save_editor_generation_pricing()` 只返回配置本身，`EditorGenerationPricingStore::replace` 注释写明「只是缓存刷新、不做版本校验、不是拦截点」
- api-server admin/app：后台 GET 不再返回 `updatedAtMicros`，POST 不再读 `expectedUpdatedAtMicros`，删掉 409 映射与「旧版本被拒」用例，新增「连续保存两次以后一次为准」
- admin-web：定价类型去掉版本字段，保存请求不再回传版本，删掉 409 分支与「重新读取」提示及其用例
- docs：主规范新增「保存语义」段（整段覆盖、同时只有一个管理员在操作、缓存替换不是拦截点），后端数据契约、ADR 0005、里程碑 / 实施计划、决策记录与 pitfalls 同步为删除版本比对

补齐定价文档里漏掉的版本比对：技术方案与决策记录同步为整段覆盖 ... a61725003e

- docs/technical Tripo 集成方案：删掉「后台保存携带定价版本做事务内比对、不一致 409」这句，改成整段覆盖、不做版本比对
- docs/project-memory 决策记录：在 2026-09-23 那条设计决策末尾追加 2026-09-24 的修订说明，指向同日「模型定价保存去掉版本比对」

格式判定的注释与文档改成「信任后端的检测结果」，不再说魔数纠正错误声明 ... 2dfb60a34e

- packages/model3d-viewer：`resolveModel3dViewerFormat` 与字节识别函数的注释改写——声明优先是因为后端的 `content_type` 写入前已按字节核过，魔数只在声明缺失或认不出来时兜住，不负责纠错一个认得出来但不对的声明
- docs/technical Tripo 集成方案：补上同一条口径，与实现里「声明 → 字节魔数 → 地址扩展名」的顺序对齐

行为不变，只改注释与文档。

3D 资源没有预览图时封面留空，不再拿模型对象顶上去 ... 453e351fc6

- api-server：`project_editor_client_media_src` 对 `model3d` 在没有预览（`thumbnail_src` 与存储的 `image_src` 都缺）时直接返回空，不再回落到模型对象；用例改成断言空串，并补「存储的 image_src 是空白」一例
- docs/adr 0003：写明这是唯一允许「有对象但 `imageSrc` 为空」的类别，消费方按空值显示占位；被否决项里补上「拿模型对象冒充 imageSrc 的投影回落」
- docs/technical Tripo 集成方案：资源表说明改成「有预览才填」，验收项 11 改成「预览缺失时留空、不得回落成模型对象」
- 画布侧 `Model3dViewerModel` 的注释同步：历史布局里仍可能留着指向模型本体的地址，图片元素不能加载它

落点预检改为按归类信号收敛，服务端没配好不再被说成「落点选错了」 ... 14e72379fc

- api-server：新增定点查询失败归类 `EditorPointLookupKind` / `EditorPointLookupFailure` 与 `classify_editor_point_lookup_failure`，只把「目标不存在 / 不属于当前账号」的固定文案认成用户侧不可用，其余（服务身份 403、定价身份未初始化、版本冲突、runtime 与连接故障）原样带出
- api-server tripo3d/target.rs：`collapse_target_unavailable` 改为只看归类，不再按 `is_client_error()` 分档，落点预检的模块注释同步
- 用例：target 侧覆盖「Unavailable 收敛、403/400/409/5xx 一律保留」；editor_project 侧新增归类用例，钉住运行时服务无权的 403 与「模型定价服务身份尚未初始化」不在不可用清单里

provider 的 4 字头不再一律按「你的参数不对」回客户端 ... 6e081676f0

- api-server tripo3d/errors.rs：401/403 按上游凭据或权限不可用（502，`tripo-api-unauthorized`）、404 按上游找不到（502，`tripo-api-not-found`）、409 按上游冲突（409，`tripo-api-conflict`）、其余 4 字头按上游拒绝（502，`tripo-api-refused`）；只有 400 / 422 继续回 400 `tripo-api-rejected`
- 文件头部说明补上这条分档口径
- 用例：`provider_client_side_4xx_stays_bad_request` 覆盖 400 / 422；新增 `provider_non_parameter_4xx_is_not_reported_as_bad_request` 覆盖 401/403/404/409/402 的状态码、reason 与「不回传上游原文」

Tripo 启动检查连解析后的字段一起校验，不再只看环境变量原文 ... d04f74bd34

- api-server tripo3d/provider.rs：`validate_tripo_startup_config` 在原有 env 校验之后，追加对 `AppConfig` 字段值的校验（零超时、重试越界），与请求期 `tripo_settings` 读的是同一对字段
- 用例：新增 `startup_rejects_invalid_parsed_fields_from_any_construction_path`，覆盖「直接构造的配置带着非法值也不能通过启动检查」

图生 3D 的引用预检改为按归类信号收敛，不再拿状态码猜 ... 93ef6cebf3

- api-server：`resolve_editor_reference_record_by_id_for_owner` 拆出 `..._classified` 版本，失败带「引用不可用 / 其它」归类；原函数保持逐字段一致的对外行为（其它调用方不受影响）
- api-server tripo3d/image_source.rs：注入的解析闭包改为返回归类后的失败，只对 `Unavailable` 收敛成「图片输入必须是当前账号已登记的画布资源或素材」，400 / 404 里的 runtime 与通用过程错误原样上报；模块注释同步
- 用例：`image_source_resolution_only_collapses_unavailable_references` 改成「Unavailable 收敛、400/404/403/409/5xx 一律保留原错」
- docs/project-memory：pitfalls 新增「4xx 不等于用户输入错」一条，记下这条口径与新增模块文案时要同步的清单

3D 定价不再在加载时检查加总溢出 ... a6409d79dc

- pricing：加载校验删掉「两段加价项相加 + 全表最高底价」的溢出检查与对应的 overflow_error 助手，只保留每段键齐全与合法性的校验
- 理由写进注释：真实查价只用一个端点的底价与它自己的加价项，价格都是手填的小数字，撞不到 u32 上限；按两段相加去挡反而会拒掉能正常计费的配置
- 计费点的 checked_add 保留为唯一一道溢出闸，溢出即失败退款（PriceOverflow 的说明同步改掉「配置阶段已挡过一次」的说法）

产物地址只允许公网主机，回环与内网段一律拒收 ... a08e3bf262

- platform-tripo：`TripoUrl::parse` 在协议与 userinfo 检查之后，再加一道主机检查——回环、内网、链路本地、组播与保留段（含云元数据 169.254.169.254）全部拒收；`localhost` 及其子域同样拒收；IPv4-mapped 的 IPv6 地址按内嵌的 IPv4 判定，`::ffff:127.0.0.1` 绕不过去
- 保留段按 IANA 特殊用途表逐段列出（0/8、100.64/10、192.0.0/24、198.18/15、240/4），因为 `Ipv4Addr::is_reserved` 与 `is_global` 在当前工具链上仍是 nightly
- 新增用例覆盖 17 个拒收地址与 5 个放行地址；产物下载用例本来就跑在 127.0.0.1 的本地 mock 上，改用 `parse_unchecked_for_test` 构造
- docs/technical：写明这条主机规则与「域名解析结果在这一层看不见」的已知限制

任务状态查询本身带上退避重试，瞬时故障不再作废一次计费任务 ... 4ca1329d24

- platform-tripo：`get_task` 内部按 `TripoSettings::retries` 对瞬时故障（连接抖动 / 超时、408、429、5xx）退避重试，确定性失败（任务 id 非法、响应结构不符、404）立即返回；重试字段与退避函数改名，不再只服务产物下载
- api-server worker：查询在重试后仍是瞬时故障时继续按轮询间隔查到预算用尽，只有确定性失败才立刻收口
- 新增用例：一次 500 后成功（重试生效）、404 只打一次请求（不重试），并给测试客户端加了可指定 base_url 的构造
- docs/technical：写明查询带退避重试与「确定性失败立即返回」的边界

图生 3D 在真正提交前再确认一次剩余预算 ... 75f757f807

- worker：`submit_and_checkpoint` 接收 provider 截止时间，图生 3D 在下载源图、上传给 provider 之后、真正 submit 之前再调一次 `ensure_submit_budget`
- 原因写进注释：解析源图这两步都可能耗时到把预算用光，而 submit 不可撤销且计费，宁可本次尝试判失败，也不要提交上去立刻被截止时间判失败、白花一次外部调用
- `ensure_submit_budget` 的说明补上两处调用点

3D 产物上传带上退避重试，一次瞬时网络失败不再废掉整笔生成 ... 8af02daeea

- platform-oss：新增按前缀拼对象键的 `put_object_with_transient_retry`，与内部对象 PUT 共用同一套「可判定才重试」规则与退避（传输 / 超时 / 408 / 429 / 5xx 才重试，确定性 4xx 直接失败），body 只准备一次、每次 attempt 复用引用计数字节；重试次数或退避配置不足时按配置错误失败关闭
- api-server storage：3D 产物的模型 / 预览图 PUT 改用该入口，最多 3 次尝试、退避 250 / 500 ms（与角色动画同一口径）；模型上限 512 MiB 但实际产物远小，重试成本可控
- 新增用例：重试次数为 0 与退避不足都失败关闭；对一定解析不出的域名会真的按退避重试多次
- docs/technical：写明产物 PUT 的重试口径与「每个网络动作都要能重试」的理由

3D 产物登记失败时删掉已经传上去的对象 ... 2aa59328de

- storage：新增 `discard_model3d_artifact`，按对象键删除刚写入的产物；OSS 未配置或删除失败都只记警告并带上对象键，方便人工清理
- worker：预览图上传失败时删掉已传的模型对象；登记失败时把模型与预览图两个对象都删掉；`persist_result` 改成接收引用，好让调用方在失败后还能按对象键清理
- docs/technical：写明「上传成功但后续失败就删掉对象，不接受失败就烂在 bucket 里」

provider 报 unknown 任务状态时改为可重试，不再直接判死 ... e20ff2e89e

- platform-tripo：`TaskStatus::Unknown` 不再归一成 `OutputSchema` 终态失败，改成新的 `TripoError::TaskStatusUnknown`，并把它的可重试性判为真（SDK 自己也没把 unknown 算进终态）
- platform-tripo：补用例——provider 回 `"status":"unknown"` 时必须返回可重试的 `TaskStatusUnknown`，不能当成正常快照
- api-server：错误映射补 `TaskStatusUnknown` 分支（502 + 固定文案，轮询侧早已按可重试继续查到截止时间）
- api-server worker：状态查询遇到可重试错误时补一条 warn 日志，便于区分「一直是 unknown」和「一次网络抖动」
- docs：Provider 集成方案写明 unknown 按可重试处理及其理由

多视图视图地址的注释改成 TODO：接线时必须补地址校验，并删掉引错的 ADR 依据 ... 8fa2bfc3ed

- platform-tripo：`view_value` 的说明不再引用 ADR 0001（那份 ADR 里没有这条约定），改成 `TODO(multiview-url-validation)`，写明当前只有冒烟示例与接口测试能构造 `Url` 形态、api-server 没有现役入口，以及真正接线时必须在构造侧补协议 / 账号密码 / 内网主机校验
- 同时点明 image-to-model 的 `PublicUrl` 是同一处待办

把「已提交但没写下记录」的崩溃窗口写进文档 ... d4416e8b88

- docs/technical Tripo 集成方案：at-most-once submit 段新增「崩溃窗口（已知并接受，消不掉）」一条——submit 受理与 checkpoint 落库之间崩溃时库里没有任何记录，该窗口加判断消不掉；固定 max_attempts = 1 保证不会二次 submit / 二次计费，代价是这笔生成按失败退款、provider task id 也没留下
- docs/后端数据契约：provider checkpoint 那条把「重新 claim 一定能读到」的保证收窄为「checkpoint 已写下之后」，并指向集成方案的这一段

3D 生成面板补 TODO：弹出式对话框的标记与焦点管理要一起做 ... dfbde6fbc1

- 面板容器只标了 role="dialog"、没标 aria-modal，也没有焦点约束与焦点归还（评审 #74）
- 加上 TODO(a11y-modal) 说明为什么单独补标记反而会误导，以及「与焦点管理一起做 / 一次性推广到所有同类面板」两条路，本轮不改行为

换模型时不再拿上一个模型的地址渲染 3D 查看器 ... 8e169e17b8

- useResolvedAssetReadUrl：地址与「它是为哪个 objectKey 换回来的」一起返回（`resolvedObjectKey`），换签期间归属清空——只按地址字符串判断的话，调用方分不出「新资源 + 旧地址」这一帧
- Model3dViewerModal：只有确认地址属于当前模型才交给查看器；该帧按「正在准备模型地址」提示，不闪「地址不可用」
- 用例：换模型那一帧不渲染查看器；换 objectKey 时旧地址的归属先清空

3D 开关互斥：打开分件就关掉四边面 / 智能减面，反之亦然 ... 2204df139c

- `applyModel3dSwitchChange` 不再原样套用改动：收到「生成部件 = 开」时清掉四边面与智能减面，收到任一几何模式打开时清掉生成部件；让刚刚打开的那个赢，面板上不留提交前校验必然拒绝的组合
- 只关掉某个开关时不动其它开关（关分件不该顺带清空几何模式）
- 用例：两个方向的互斥各一例 + 只关一个开关不动其它

导出压缩包里的目录改成第一次写文件时才建，不再留空目录 ... 0c5aeb5271

- `useImageCanvasAssetExportWorkflow`：三个导出目录（images / media / 3d_models）从「开包就全建好」改成 `createExportFolderResolver` 按需创建，同一轮导出每个目录只建一次；没有对应内容的压缩包里不再出现空的 `media/`、`3d_models/`
- 用例：只导出图片时压缩包里不存在 media / 3d_models 的任何条目
- docs/adr 0003：后果里补上「目录按需创建、空目录不进包」

Merge remote-tracking branch 'origin/master' into feat/tribo3d-integeration ... 1f5329b90c

# Conflicts:
#	docs/project-memory/shared-memory/decision-log.md
#	docs/project-memory/shared-memory/pitfalls.md

k88936 added 1 commit 2026-09-24 21:34:36 +08:00

删掉 ADR 0002 文末多余的空行，让 diff --check 通过 ... c908b83fe3

- docs/adr/0002：去掉文件末尾多出的一个空行，文件以单个换行结尾；正文内容不变

Some checks are pending

Hide all checks

Project CI / AI game creator shell Rust smoke (pull_request) Successful in 1m55s

Details

Project CI / AI game creator shell Rust crates (pull_request) Successful in 1m26s

Details

Project CI / Backend tests (pull_request) Successful in 5m33s

Details

Project CI / Native shell tests (pull_request) Successful in 5m57s

Details

Project CI / AI game creator shell Rust lane 2/2 (pull_request) Successful in 9m8s

Details

Project CI / AI game creator shell Rust lane 1/2 (pull_request) Successful in 9m22s

Details

Project CI / Frontend tests (pull_request) Successful in 1m45s

Details

Project CI / Repository checks (pull_request) Successful in 2m2s

Details

Project CI / AI game creator shell web tests (pull_request) Successful in 1m18s

Details

This pull request can be merged automatically.

This branch is out-of-date with the base branch

You are not authorized to merge this pull request.

View command line instructions

Checkout

From your project repository, check out a new branch and test the changes.

git fetch -u origin feat/tribo3d-integeration:feat/tribo3d-integeration

git checkout feat/tribo3d-integeration

Sign in to join this conversation.

Reviewers

No Reviewers

Labels

Clear labels

Compat/Breaking

Breaking change that won't be backward compatible

Kind/Bug

Something is not working

Kind/Documentation

Documentation changes

Kind/Enhancement

Improve existing functionality

Kind/Feature

New functionality

Kind/Security

This is security issue

Kind/Testing

Issue or pull request related to testing

Priority

Critical

1

The priority is critical

Priority

High

2

The priority is high

Priority

Low

4

The priority is low

Priority

Medium

3

The priority is medium

Reviewed

Confirmed

1

Issue has been confirmed

Reviewed

Duplicate

2

This issue or pull request already exists

Reviewed

Invalid

3

Invalid issue

Reviewed

Won't Fix

3

This issue won't be fixed

Status

Abandoned

3

Somebody has started to work on this but abandoned work

Status

Blocked

1

Something is blocking this issue or pull request

Status

Need More Info

2

Feedback is required to reproduce issue or to continue work

No Label

Milestone

No items

No Milestone

Projects

Clear projects

No project 陶泥儿gameAgent

Assignees

Clear assignees

HuangJiaJia JenkenB k88936 (王德宇) kdletters (段舒康) laura2008 (王乐) lhk229 (孔令弘) Loer (农洛儿) loong suzmii (董羽秦) taobaisu (叶东旭) wuxiangwanzi (王子民) YixuanLiu ziyu

No Assignees k88936

1 Participants

Notifications

Subscribe

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: GenarrativeAI/Genarrative#421