1149 Commits

Author	SHA1	Message	Date
k88936	ee4a9434fa	后台定价读取带版本、保存整段必填并做事务内乐观锁 ... - shared-contracts 新增定价版本冲突标记，module 与 api-server 共用一处声明 - SpacetimeDB upsert input 增加期望版本，事务内比对不一致即整笔拒绝（种子写入显式不比对） - 定价 store 记录当前版本，读取路径带出 updated_at 微秒值 - 后台 GET 返回 models / 3D 两段 / updatedAtMicros，POST 要求两段显式给出且带期望版本 - 缺 3D 段 400、版本不匹配 409，退役 with_previous_model3d 与「省略即沿用」用例 - 绑定按 input 新字段重新生成，模块补乐观锁比对用例	2026-09-23 11:38:23 +08:00
k88936	952bc1ccaa	覆盖文件缺 3D 段时按受控默认价补齐，不再把 3D 整段算成未配置 ... - 新增 backfill_legacy_model3d_pricing：旧覆盖文件整段没有 3D 时补上默认 JSON 的两段并告警 - 覆盖文件继续只承担种子与兜底，避免老种子文件把 3D 生成整段关掉 - 补用例覆盖覆盖文件缺 3D 段的读取	2026-09-23 11:15:42 +08:00
k88936	5e47f0c41e	3D 定价记录转换与读取归一化接上 SpacetimeDB 两段列 ... - 新增 editor_generation_model3d_records 深模块：配置与两段记录行之间双向转换 - 写入方向严格：落库前按契约强校验，缺键与契约外键都不写 - 读取方向归一化：记录缺键（含整段缺失的老行）用本地配置同段补齐，契约外键剔除并告警，补齐后仍不合法才判非法 - 定价配置读取以表为准，覆盖文件降级为种子与兜底；state.rs 保存路径写入两段 - spacetime-client 补导出 3D 定价记录类型，api-server 定向用例覆盖往返、补齐、剔除与拒绝	2026-09-23 11:12:57 +08:00
k88936	ebd904e193	公开读模型 3D 段保持迁移前的旧形状 ... - 新增 Model3dPricingPublicView，把内部两段结构投影回 basePrices 端点判别 + addOnPrices 单表 - 公开路由改用投影视图，画布 3D 入口与前端类型不需要随本次迁移改动 - 投影取文生 3D 段的加价项，两段不一致时打告警提示前端升级前不要差异化 - 公开路由用例补断言钉住 3D 段旧形状	2026-09-23 11:04:50 +08:00
k88936	9f4a71d2e3	3D 定价段拆成端点并列的两段结构 ... - Model3dPricingConfig 改为 textToModelPricing / imageToModelPricing 两段并列，各持自己的 versionPrices 与 addOnPrices - 新增 Model3dEndpointPricing 承接单端点定价，校验与查价按端点委派，溢出检查覆盖两段 - 受控默认 JSON 的 model3d 段同步改为两段结构 - 3D 定价相关用例夹具与断言更新到两段形状	2026-09-23 11:01:20 +08:00
k88936	774b74d3d6	SpacetimeDB 定价表追加 3D 两段列，记录形状先能表达端点 × 版本 × 贴图与加价项 ... - editor_generation_pricing_config 末尾追加 text_to_model_pricing / image_to_model_pricing 两个 Option 列并带显式默认值 - 新增模型版本底价、加价项、端点定价三个 SpacetimeType 行类型，模块侧按段校验空段、缺半段、重复键与非正价格 - upsert 输入、快照、生成绑定与客户端记录映射同步两段字段 - api-server 保存路径本次先写空值，读取仍走本地文件缓存；补模块段级归一化用例	2026-09-23 10:54:01 +08:00
k88936	aa6e3b8d79	SDK 请求错误不再丢弃响应体与底层错误链 ... - 映射 tripo3d_sdk::Error::Request 时带上 body 与 source 字段 - 响应体截断到 512 字符，疑似带 http(s) 地址的响应体整体丢弃 - 只取错误链底层文本，避免 reqwest 顶层 Display 带出完整签名 URL - 补错误链收集、响应体过滤与截断的用例	2026-09-22 16:55:16 +08:00
k88936	3ab7b386f1	补外部生成主表 provider checkpoint 归一化单测 ... - 新增 old_external_generation_job_rows_default_to_unsubmitted_provider - 断言旧迁移行的 provider_kind 与 provider_task_id 都归一成 null - 守住 at-most-once submit 的向后兼容路径	2026-09-22 16:52:19 +08:00
k88936	ed2eb43fe6	补 3D 生成选项校验的表驱动单测 ... - 覆盖最简选项全模型放行、fast 必须配 v3.5 贴图版本 - 覆盖 generate_parts 的 texture/pbr/quad/smart_low_poly 互斥组合 - 覆盖 quad 家族限制与各模式 face_limit 的 min-1/min/max/max+1 边界 - 覆盖空白 task id 按 OutputSchema 失败与 trim 行为	2026-09-22 16:50:06 +08:00
k88936	62bf602fb1	多视图请求 DTO 补齐字段级说明并重生成绑定 ... - Model3dMultiviewToModelRequest 每个字段补一行中文语义说明与取值范围 - 结构体补严格反序列化与组合校验归属的说明 - 重新生成 ts-rs TS 绑定，注释同步进 Model3dMultiviewToModelRequest.ts	2026-09-22 16:48:57 +08:00
k88936	2348315dba	3D 结果打标契约测试补齐 preview 与 imageToModel 分支 ... - textToModel 用例补 preview 产物的相等断言 - 新增对称的 imageToModel 用例，守住 tag 路由与分支字段 - 裸字符串 source 的负例改为点名 Model3dGenerationSource 并单独反序列化 source 值	2026-09-22 16:46:19 +08:00
k88936	bba96e18a1	队列状态映射改为借用记录避免提交路径整行克隆 ... - editor_generation_queue_state 收 &ExternalGenerationJobRecord，只克隆输出需要的三个字段 - Model3dSubmissionResponse::from_job 不再克隆整行 job，status_url 提前算好避免额外克隆 - 其余调用点改为传引用，行为不变	2026-09-22 16:44:47 +08:00
k88936	433ffb4a15	落库的模型版本改用严格 wire 取值 ... - Model3dJobRequest::model_version 改为返回 Result 并使用 wire_str - worker 落库前取不到契约取值即按服务端问题失败，不再写 Debug 兜底名 - 新增用例断言落库取值为契约线上值 v3.1-20260211	2026-09-22 16:40:48 +08:00
k88936	4e5ff179b2	3D 查价拒绝 texture=false 与贴图加价项的矛盾组合 ... - Model3dPricingError 新增 InconsistentTextureAddOn 变体与对应文案 - price() 在命中的 add-on 含贴图类而 texture=false 时失败关闭，不再照价收费 - 补齐矛盾组合报错与 texture=true 合法组合的价格用例	2026-09-22 16:38:24 +08:00
k88936	87ca86ae6a	图片输入解析抽出可注入查询的解析规则并补齐行为用例 ... - resolve_source_object_key 拆出 resolve_source_object_key_with 与 ResolvedReference 窄结果 - 新增按 ID 定点查询、类型不符、缺对象键、4xx 收敛与基础设施错误保留状态码的用例 - 源码文本断言不再按函数签名切片，只检查本模块不出现列工程 / 列素材库	2026-09-22 16:36:16 +08:00
k88936	48cde9624c	operation_kind 白名单改为两 crate 共用的共享常量 ... - 白名单常量迁到 shared-contracts 并从 crate 根导出 - spacetime-module 的原子落库事务改为引用该常量，删除本地重复定义 - api-server 的登记测试不再解析对方源码文本，改为直接断言常量内容 - 后端架构文档补上白名单常量的位置与共用口径	2026-09-22 16:30:28 +08:00
k88936	e359158ecf	校验文案的版本标签改为从契约枚举推导 ... - validate_generation_options 的错误文案改用 wire_str_lossy 取 serde 线上值 - v3.x 家族的模型标签收敛到 v3_model_labels 助手 - 契约改名后诊断文案随之更新，不再手写重复的版本字符串	2026-09-22 16:19:09 +08:00
k88936	bcac5a7c12	三个提交入口的生成选项映射收敛为单一字段清单 ... - common::validation 用 tripo_generation_options_from! 由一份字段清单派生三个 From 实现 - multiview 手写的 TripoGenerationOptions 映射改为复用该 From 实现 - 新增共享字段时三条路径一起跟上，缺字段会在编译期报错	2026-09-22 16:15:38 +08:00
k88936	c8b4160fcd	3D 查价错误并入统一的定价错误枚举 ... - EditorGenerationPricingError 新增 Model3d 变体并实现 From<Model3dPricingError> - model3d_price 改为返回 EditorGenerationPricingError，内层文案直通保持响应不变 - 提交路由对 3D 定价错误与定价快照错误分别映射，未配置用例改断言 Model3d(NotConfigured)	2026-09-22 16:11:17 +08:00
k88936	9800477c7c	模型版本清单从声明表派生避免漏加新版本 ... - Model3dModelVersion 的变体、线上值与 ALL 改为由 model3d_model_versions! 单一声明表生成 - ALL 类型改为 &'static [Self]，新增版本只需在声明表加一行 - 定价校验与测试的遍历改用 iter().copied()	2026-09-22 16:03:55 +08:00
k88936	2e9aed3750	三个提交入口统一校验 provider 返回的 task id ... - 新增 submitted_task_handle：空白 id 在提交调用附近以 OutputSchema 失败 - text / image / multiview 提交路径共用它，任务不再以孤儿状态等到下游查询才报错	2026-09-22 15:53:37 +08:00
k88936	09f0c51b81	空白视图规则收敛到单一助手 ... - 新增 view_input 同时服务提交前计数校验与 SDK 参数转换 - 空白 / 纯空白视图的判定不再有两份实现，避免校验与转换漂移	2026-09-22 15:49:34 +08:00
k88936	be07eb79c6	未知任务状态错误带上 task id ... - map_status 接收 task_id，Unknown 分支改用与其它映射失败一致的 OutputSchema - provider 异常可与具体任务对上，不再是一条无主错误	2026-09-22 15:47:01 +08:00
k88936	1749f427c1	任务快照只在失败终态保留 failure ... - failure 改由终态判定驱动，不再只看 provider 是否留下错误字段 - 已完成的任务即使带过期错误字段也不再挂 failure，保持快照内部自洽	2026-09-22 15:45:45 +08:00
k88936	050909a0b7	后台定价保存不再清空 3D 段 ... - payload 的 model3d 缺席或为 null 统一表示沿用当前 3D 定价，显式给出时才覆盖 - 保存路径先取当前快照合并，避免改图 / 视频价格让 3D 提交一直失败关闭 - 补用例覆盖「省略保持」与「显式覆盖」两种语义	2026-09-22 15:27:19 +08:00
k88936	ee2d505eb3	3D 提交在扣费前预检落点归属 ... - 新增 target 预检模块：画布项目按 (project_id, owner) 定点确认，素材库文件夹按 owner 的库匹配 - 两个提交路由都在查价与入队之前调用；跨 owner / 不存在的落点回 400 model3d-target-unavailable - 只剩基础设施故障保留原状态码，并补了收敛口径的单测	2026-09-22 15:21:25 +08:00
k88936	8473877bc3	5xx 错误响应不再回带 provider task id ... - TaskFailure / OutputSchema / 上游兜底分支只回固定文案，完整错误写入服务端日志 - 补一条断言 502 details 不含 task id 与 provider 原文的用例	2026-09-22 15:17:50 +08:00
k88936	cda7724cae	上游瞬时状态不再回落成 400 ... - 408 / 425 / 429 与 platform-tripo 的 is_retryable 口径对齐，分别回 504 / 502 / 429 - 补上这三档与客户端 4xx 的分支测试	2026-09-22 15:15:27 +08:00
k88936	e18c6ee502	产物下载客户端不再跟随跳转 ... - 产物地址来自 provider 响应，禁止 reqwest 自动跳转以防 SSRF - 需要跳转的地址会以非成功状态显式暴露，不再由服务端静默代发	2026-09-22 15:12:06 +08:00
k88936	669a08c7c2	产物下载失败信息补上可诊断上下文 ... - 传输失败带上脱敏 URL 与底层错误 source 链 - 非成功状态补上状态码文案与脱敏 URL	2026-09-22 13:51:29 +08:00
k88936	01a9941cbc	任务快照映射不再多余克隆字符串 ... - task_id 与 error_message 直接移交所有权，只保留错误路径上的必要克隆	2026-09-22 13:51:23 +08:00
k88936	fd0a37969e	3D 产物落盘文件名补上安全处理 ... - URL 无可用扩展名时按 content type 兜底，预览图不再写成 .glb - 文件名主干中性化路径分隔符与遍历片段，避免逃出目标目录	2026-09-22 13:50:29 +08:00
k88936	7dd7bdd3c7	provider checkpoint 存在性校验补上 provider_kind ... - at-most-once submit 的两字段不变量在数据层一起判定	2026-09-22 13:50:24 +08:00
k88936	5049c27f3d	3D 定价表加载时拦截加总溢出 ... - 底价与加价项累加改用 checked_add 校验，配置阶段即失败 - 避免结算路径 saturating_add 在异常配置下静默少收	2026-09-22 13:49:01 +08:00
k88936	129e2234f3	删掉 3D 引用解析里两个无人调用的宽查函数 ... - 两个 pub(crate) resolver 全仓无调用方，且会整表列举项目与素材 - 定点解析仍走既有按 ID 的窄查函数	2026-09-22 13:48:53 +08:00
k88936	2916e112df	3D provider 重试次数按上限 10 封顶 ... - TRIPO_RETRIES 配置异常时不再让产物下载近乎无限重试	2026-09-22 13:48:13 +08:00
k88936	c5e0c6a14d	去掉被丢弃的 remove 返回值告警 ... - 幂等指纹字段摘除改为显式丢弃返回值，表明这是 best-effort 行为	2026-09-22 13:48:10 +08:00
k88936	e2809b83c0	3D 冒烟示例单端点失败不再中断其余端点 ... - wait_for_task / get_task / download_model 失败时记录该端点错误并继续 - 保留 throw_on_failure: false 的原有语义，仅补齐传输与超时类错误	2026-09-22 13:45:50 +08:00
k88936	058d851a69	去掉 model3d_price 上已过期的 dead_code 豁免 ... - server-rs/crates/api-server/src/editor_generation_config.rs：model3d_price 现在由 tripo3d 提交路由真实消费，删掉「里程碑二的路由接上之前只有测试消费」这句已过期注释与配套的 #[allow(dead_code)] 验证：cargo check -p api-server（--locked）无该函数相关告警	2026-09-22 13:43:45 +08:00
k88936	444520b464	修正 storage.rs 注释错别字 ... - server-rs/crates/api-server/src/tripo3d/storage.rs：sniff_model_content_type 文档注释「说慌」改为「说谎」 验证：npm run check:encoding、git diff --check	2026-09-22 13:42:37 +08:00
k88936	326729a5ac	Idempotency-Key 校验错误保留请求上下文 ... - 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 个用例全绿）	2026-09-22 13:42:34 +08:00
k88936	14740e0ef6	3D 任务参数用例改为断言真实主张 ... - 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	2026-09-22 13:40:13 +08:00
k88936	48a5bf06d0	3D 产物读取不再克隆 content type ... - server-rs/crates/api-server/src/tripo3d/artifacts.rs：content_type 只在本函数取一次、之后不再读句柄字段，改用 take() 转移所有权而不是 clone() 验证：cargo check -p api-server（--locked）	2026-09-22 13:36:28 +08:00
k88936	9263d79d42	3D 产物读取按声明长度预分配缓冲 ... - 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）	2026-09-22 13:36:25 +08:00
k88936	6d8164d37a	OSS 不可用错误补上机器可读的 reason ... - 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）	2026-09-22 13:35:23 +08:00
k88936	66b8c2bed0	3D 定价快照读取失败补上机器可读的 reason ... - 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）	2026-09-22 13:35:20 +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
lhk229	4e41bd3e56	修复预览发布测试状态文件恢复竞态 ... deploy_and_uninstall 测试在断言状态文件恢复前，改为轮询等待持久化状态到达 Stopped 新增 wait_for_persisted_status 辅助函数，经 load_deployments 真实加载路径校验状态文件	2026-09-22 00:53:47 +08:00
k88936	9fc55a5cac	写入Tripo 3D泥点默认价并锁定credit换算口径 ... - 受控默认配置新增 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 风险	2026-09-21 22:07:55 +08:00