1055 Commits

Author	SHA1	Message	Date
k88936	f732555a44	为Tripo提交路由补应用级验收用例 ... - 走真实 build_router 断言两个端点未鉴权一律 401，路径写错或漏 merge 会退化成 404 - 断言缺 Idempotency-Key 在解析之后、组合校验与定价之前返回 400 - 断言贴图档位冲突与定价必填字段缺失都在定价与 provider 副作用之前返回 400 并定位字段 - 实施计划进展补记该组用例与当前全量测试通过数	2026-09-21 15:16:22 +08:00
k88936	d4af6802fb	补多视图请求契约的全字段往返用例 ... - 新增全字段往返：钉住 camelCase 字段名、各枚举线上取值与 Option 的可省略写法 - 新增显式 null 往返：确认可选字段回写时仍是 null 而不是整字段消失 - 补用例后字段改名或可空性漂移会被测试拦住，不再是只在 TS 绑定里可见	2026-09-21 15:16:06 +08:00
k88936	294b7461ff	去掉产物下载重试里的不可达panic分支 ... - download_artifact 原先用 for + last_error + expect 收尾，循环每轮都会 return，expect 实际不可达，却给库留下一条潜在 panic 路径 - 改为 loop 内递增 attempt，重试耗尽时直接返回最后一次错误，重试次数与退避行为不变	2026-09-21 15:15:07 +08:00
k88936	e9af6c0741	脱敏地址保留原始分隔符 ... - redacted 原先无条件用 ? 拼接脱敏标记，只有 fragment 的地址会被显示成带 query 的样子 - 改为按命中的分隔符原样拼接，日志里能区分 query 与 fragment	2026-09-21 15:14:51 +08:00
k88936	0f8ac57593	拒收带userinfo的产物地址 ... - TripoUrl::parse 原先只校验 scheme，带 user:password@ 的地址会被 Debug / redacted 原样打进日志 - 解析阶段直接拒绝 userinfo，产物地址不需要凭据	2026-09-21 15:14:07 +08:00
k88936	694a3c6f6c	产物下载前校验任务确实处于完成态 ... - download_model 与 download_rendered_image 原先只看 output 是否存在，快照字段全公开、status 与 output 可以被人为构造得不一致 - 两个入口统一走 completed_output：先校验 task_id，再要求 status=Completed 且有输出，否则按输出结构错误失败	2026-09-21 15:14:00 +08:00
k88936	6724f8b707	收紧产物文件名对远端扩展名的取值 ... - filename 直接取远端 URL 末段扩展名，path_segments 已百分号解码，%2F / %5C 会拼出跨目录路径 - 扩展名只接受长度不超过 10 的 ASCII 字母数字，其余一律退回 glb	2026-09-21 15:13:15 +08:00
k88936	33cd943ff9	长度与范围越界改用独立校验原因 ... - TripoValidationReason 新增 OutOfRange，与「参数组合互斥」不再共用 InvalidCombination - prompt 超 1024 字符、negative_prompt 超 255 字符改报 OutOfRange - face_limit 越界属同一类范围错误，一并改报 OutOfRange，调用方可按原因分流	2026-09-21 15:11:12 +08:00
k88936	7193bd28c2	多视图可选视图去掉首尾空白再提交provider ... - optional_view 先用 trim 判空、再把未 trim 的原串交给 FileInput，两侧口径不一致 - 改为提交前 trim，空白视图仍按未提供处理	2026-09-21 15:10:49 +08:00
k88936	e8467c2870	多视图前视图去掉首尾空白再提交provider ... - front 只按 trim 后判空，但先前把未 trim 的原串交给 FileInput，带空白的取值会被原样发出 - 改为提交前 trim，与 image_to_model 的输入口径一致	2026-09-21 15:10:24 +08:00
k88936	0982b952cb	收敛Tripo三入口重复的extra字段构造 ... - 新增 common/extra.rs 统一构造 texture_version 与 delight 的 SDK extra 字段，键名只留一份 - text_to_model 与 image_to_model 删除各自的 extra_fields 副本，改调公共实现 - multiview_to_model 的内联 extra.insert 也改为复用同一构造 - 未提供的参数仍不写入 extra，请求体行为与原先一致	2026-09-21 15:08:50 +08:00
k88936	eb4256f883	图生3D图片引用改为提交时定点预检 ... - image_source 拆成预检与执行两条路径，预检只做归属、记录类型与对象键校验，不读正文也不调用 provider - 定点解析改用既有 resolve_editor_reference_record_by_id_for_owner，取代列工程与读素材库的宽查询 - image-to-model 路由在扣费与入队前调用预检，跨 owner、未登记、已删除与 kind 不符统一返回 400 - editor_project 把定点引用查询暴露为 crate 内可见，供生成入口复用 - 新增源码钉住用例，防止预检退回宽查询或提前读图片正文	2026-09-21 15:08:46 +08:00
k88936	02ef84d9b6	清理Tripo3D新代码的死代码与无意义断言 ... - 删除 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 常量 - 删除对常量自身取值的恒真断言测试	2026-09-21 14:45:04 +08:00
k88936	29e554a30c	新增api-server Tripo3D worker执行链路与结果落库 ... - 新增 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 分支并纳入长任务超时，用户可见失败文案收敛为稳定文本	2026-09-21 14:36:59 +08:00
k88936	ac08ccbe39	修正spacetime-client checkpoint facade的落点 ... - facade 方法补进真正参与编译的 active/external_generation.rs，此前误写在未被编译的重复文件里 - mapper 重新导出 ExternalGenerationJobProviderCheckpointRecordInput，调用方无需从子模块路径引用 - 删除未被编译的 src/external_generation.rs 重复副本，避免再次改到死文件	2026-09-21 14:33:51 +08:00
k88936	e809cdd850	新增api-server Tripo3D图片输入解析与产物对象写入 ... - editor_project 暴露按注册 ID 定点解析资源与素材对象键的入口，只认本账号已登记记录 - image_source 把站内引用解析成对象键后读字节并上传 provider 换 file_token，不把签名地址交给第三方 - storage 负责产物 PUT、HEAD 复核与 asset_object 登记，模型与预览图共用同一条链路 - asset_object ID 使用 operation 稳定派生值，避免被生成结果事务的白名单校验拒绝 - 完整字节写入路径留 TODO，等待 platform-oss 提供流式上传	2026-09-21 14:24:41 +08:00
k88936	a8799adf5d	platform-tripo支持图片上传与预览图下载 ... - 产物下载类型改名为 TripoDownloadedArtifact，模型与预览图共用同一条流式读取路径 - 新增 download_rendered_image，读取 task 结果里的预览图地址 - 新增 upload_image，把图片字节上传 provider 换 file_token - 图片输入收敛为 TripoImageInput 枚举，只有 file_token 与公网地址两种形态，不再接受裸字符串 - smoke 示例跟随新的图片输入类型	2026-09-21 14:06:47 +08:00
k88936	4edeadae7d	登记Tripo 3D的生成结果operation_kind白名单 ... - SpacetimeDB storage 的编辑器生成白名单加入 model3d_text_to_model 与 model3d_image_to_model - 白名单是原子落库的 operation_kind 门禁，未登记会让整笔结果事务被拒 - api-server 侧按源码钉住两个 job kind 已在白名单内，避免只在运行期才发现	2026-09-21 14:02:58 +08:00
k88936	dd8f48bad9	新增api-server Tripo3D提交路由与入队 ... - tripo3d 目录按 job 身份、provider 配置、错误映射、入队与路由拆分小文件 - 两个内部路由要求 Bearer 与 Idempotency-Key，顺序固定为解析、组合校验、查价、入队 - 入队复用编辑器生成队列的幂等 dedupe key，同键同请求返回原 operation，同键不同请求 409 - Tripo job 走既有 editor-canvas 来源与单次尝试口径，不新建队列、不新增状态 - 提交响应返回 operation、job kind 与既有任务查询状态地址，不暴露 provider 信息 - 补齐 ExternalGenerationJobRecord 测试夹具新增的 checkpoint 字段	2026-09-21 13:46:41 +08:00
k88936	d012392779	api-server 增加 Tripo 生成的环境配置 ... - AppConfig 新增 tripo_base_url / tripo_api_key / 请求超时 / 重试四个字段 - 默认网关指向 Tripo 官方 v3 地址，可由 TRIPO_BASE_URL 覆盖 - 环境变量沿用 provider 示例的 TRIPO_* 口径，API Key 缺省为空 - 默认值断言补进配置测试	2026-09-21 13:23:18 +08:00
k88936	aa1a1a63ed	spacetime-client 暴露 provider checkpoint 写入入口 ... - 重新生成 module bindings，新增 checkpoint procedure 与输入类型、表行与快照投影 - mapper 增加 checkpoint 记录输入与到绑定输入的转换，快照映射补两个新字段 - facade 新增 set_external_generation_job_provider_checkpoint，复用 procedure 结果映射 - facade 注释说明已有 checkpoint 被拒是 at-most-once submit 保证，写入失败按失败处理	2026-09-21 13:10:11 +08:00
k88936	09ea0a5e76	新增external_generation_job的provider任务checkpoint ... - 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 不可覆盖的不变量单测	2026-09-21 13:02:52 +08:00
k88936	e105e34f83	新增Tripo生成请求的平台组合校验 ... - 价格相关参数必须显式给出，texture 与 textureQuality、pbr 不能互相矛盾 - 目标落点与图片引用的 ID 不能为空白 - provider 能力组合规则复用 platform-tripo 预检，不维护第二份 - 校验结果直接产出定价输入，路由在扣费与 provider 调用前执行 - api-server 依赖 platform-tripo	2026-09-21 12:53:22 +08:00
k88936	8f6458ffe2	新增api-server Tripo3D模块与泥点定价结构 ... - 新增 tripo3d/pricing.rs，底价按 endpoint × 模型版本 × 是否有贴图，add-on 按固定键表叠加 - 定价段加载即校验全部底价与 add-on 键，缺键即配置非法；缺段代表未配置，查价直接拒绝 - editor_generation_config 挂载可选 model3d 段并提供 fail-closed 查价入口 - 后台记录形状尚不支持 3D 段，暂由文件配置提供并留下同步待办 - model_version 增加 ALL 与排序，供定价表枚举校验	2026-09-21 12:53:02 +08:00
k88936	7790a181c4	provider按参数分层并公开组合校验入口 ... - submit 改为接收生成参数，图片输入由调用方解析后单独传入 - 公开 validate_text_to_model_params / validate_image_to_model_params 供平台层在副作用前预检 - 参数到 provider 校验选项的映射收敛为 From 实现，去掉重复拼装 - smoke 示例跟随新签名	2026-09-21 12:39:20 +08:00
k88936	e0108f7d57	分层Tripo生成的provider参数与平台API请求契约 ... - common 新增 Model3dGenerationSource、Model3dGenerationTarget、Model3dGenerationTargetRef 与产物元数据 - text/image 各自的参数类型独立成 params，API 请求为 generation + 平台字段 + target - 图片输入只接受站内引用，input 由服务端解析后注入 provider - 删除宽松的作业与结果占位 DTO，改为按端点的严格结果与端点 tagged enum - 新增契约严格性测试，覆盖分支必填字段、图片输入歧义与顶层未知字段	2026-09-21 12:38:46 +08:00
k88936	93306952d9	把画布占位载荷移出受feature门控的assets模块 ... - 新增 shared-contracts::editor_canvas，承载画布占位与回填载荷并接入 ts-rs 生成 - assets 模块改为内部引用该类型，不再自带定义 - api-server 七处引用改到新模块路径	2026-09-21 12:38:28 +08:00
k88936	188614d5d2	改用Provider流式下载Tripo产物 ... 保持第三方SDK不变并在Provider侧读取签名模型URL 逐块暴露模型响应并校验Content-Length，smoke示例改为异步落盘 为未来SDK原生stream能力保留迁移TODO	2026-09-19 23:14:00 +08:00
k88936	c48f0627cf	修复 ts-rs 对 enum 级 deny_unknown_fields 的解析告警并保留契约严格性 ... - 把 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 通过	2026-09-19 16:56:24 +08:00
k88936	0c4b1c34d9	标注模型下载的重复 task 查询 ... 在 download_model 增加 TODO，说明 SDK 只提供 download_model(&Task) 因而必须再取一次 task 若将来 SDK 支持按 URL 下载，可直接使用 snapshot 中的模型 URL 省掉这次请求	2026-09-19 14:17:31 +08:00
k88936	3c1059aa39	移除 TripoUrl 的 Display 实现 ... 删除 TripoUrl 的 Display，避免 `{}` 这类通用格式化输出带签名的完整 URL 完整 URL 仍可通过 as_str() 显式读取，日志与调试统一走 redacted() 或脱敏后的 Debug 技术方案文档补充该收敛说明	2026-09-19 14:17:00 +08:00
k88936	1392303f1c	请求契约把 model 改为必填字段 ... 三个生成请求的 model 由 Option<Model3dModelVersion> 改为必填 Model3dModelVersion，并同步重新生成 TypeScript 绑定 validate_generation_options 不再重复校验 model 缺失，直接由必填的 model 推导 family 三个 client 的 to_sdk_params 改为直接提交模型版本字符串 冒烟示例与技术方案文档同步为必填写法	2026-09-19 14:16:39 +08:00
k88936	12512f26b2	multiview 输入拒绝未知字段 ... Model3dMultiviewInputs 增加 deny_unknown_fields，与 Model3dMultiviewToModelRequest 的严格反序列化保持一致 未知视图键（例如拼写错误的 righ）不再被静默丢弃，避免用少于调用方预期的视图提交任务 ts-rs 12 不支持 enum 级该属性，构建时会打印一条可忽略的告警，已在代码注释说明	2026-09-19 14:14:55 +08:00
k88936	800da43a8d	说明生成结果 DTO 的 number 精度边界 ... 为 poll_after_ms、updated_at_micros、size_bytes 补充注释，说明其量级远低于 2^53，按 TS number 导出即可精确表示 重新生成 TypeScript 绑定，把上述说明同步为 JSDoc 技术方案补充同一说明，明确不做 bigint/string 特殊处理	2026-09-19 14:14:14 +08:00
k88936	b87d9358e5	对齐 Api 与 Request 的可重试状态码 ... TripoError::is_retryable 的 Api 分支补充 408 与 425，与 Request 分支的可重试集合保持一致	2026-09-19 13:15:31 +08:00
k88936	f4996d7ac2	auto_size 仅在显式开启时按模型能力拦截 ... validate_generation_options 中 auto_size 的 H25 校验由 is_some() 改为 == Some(true) auto_size: false 不再被当作启用，与 quad、smart_low_poly、generate_parts 的取值语义保持一致	2026-09-19 13:15:00 +08:00
k88936	09ef92420f	multiview 复用统一的 task_id 校验 ... 删除 submit_multiview_to_model 中重复的空白判断，改为调用 common::validate_task_id task_id 非法时的错误字段由 Inputs 改为更精确的 TaskId，与 get_task、download_model 保持一致	2026-09-19 13:14:32 +08:00
k88936	091938ed59	multiview 提交前裁剪 task_id ... to_sdk_params 改为提交 task_id.trim()，与 task_id.trim().is_empty() 的校验使用同一份标准化输入 带前后空白的 task_id 不再原样转发给 Provider	2026-09-19 13:13:54 +08:00
k88936	ddb8b9e8ba	multiview 空白视图按未提供处理 ... to_sdk_params 新增 optional_view，将仅含空白的 left、back、right 归一化为未提供 空白视图不再以 Some(FileInput) 形式提交，与提交前“至少两个视图”的校验保持一致	2026-09-19 13:13:35 +08:00
k88936	230e4d49f2	image_to_model 提交前统一使用裁剪后的输入 ... to_sdk_params 改为传入 request.input.trim()，与提交前的空值校验使用同一份标准化输入 带前后空白的输入不再原样转发给 Provider	2026-09-19 13:12:50 +08:00
k88936	6c209b115a	冒烟示例在任务未完成时跳过下载并继续后续入口 ... 轮询改用 throw_on_failure=false，失败终态交回示例按 status 判定而不是直接返回错误 非 Completed 的任务打印 status 与 failure 后 continue，避免一个入口失败中断其余入口的冒烟	2026-09-19 13:12:23 +08:00
k88936	b631125a16	冒烟示例不再输出完整下载地址 ... 产物行改用 TripoUrl::redacted()，避免把带签名的下载 URL 写入标准输出	2026-09-19 13:07:41 +08:00
k88936	771ff88440	脱敏 TripoUrl 的 Debug 输出 ... 为 TripoUrl 手写 Debug 实现，改用隐藏 query 与 fragment 的脱敏形式 新增 TripoUrl::redacted 提供日志用脱敏 URL，完整 URL 仍由 as_str 显式读取 TripoTaskSnapshot、TripoTaskOutput、TripoDownloadedModel 的调试输出随之不再暴露带签名的下载地址	2026-09-19 13:07:41 +08:00
k88936	950209f038	为 model3d 请求契约的可选字段补充 ts(optional) ... 为 image_to_model、multiview_to_model、text_to_model 三个请求的可选字段添加 ts(optional = nullable) multiview 视图分支的 left、back、right 同步标记为可选 重新生成 packages/shared/src/contracts/model3d 下的 TypeScript 绑定，使 TS 侧可按 serde 语义省略字段	2026-09-19 13:07:41 +08:00
k88936	42a5929a73	清理 model3d 请求契约中冗余的 serde(default) ... 移除 image_to_model、multiview_to_model、text_to_model 三个请求结构体 Option 字段上的 serde(default) 同步移除 multiview 视图分支中三个可选视图的 serde(default) serde 对 Option 字段本身即按 None 处理缺失字段，生成的 TypeScript 绑定保持不变	2026-09-19 13:07:41 +08:00
k88936	eda9da4d8d	单点维护 model3d 的 ts-rs 导出根目录 ... 在 model3d/mod.rs 新增 model3d_ts_export_dir 宏，集中定义仓库相对导出根路径 common、image_to_model、multiview_to_model、text_to_model 改为调用宏并只声明各自子目录名	2026-09-19 13:07:41 +08:00
k88936	da9ee65119	记录Tripo真实冒烟结果结构 ... 保留三个生成入口的脱敏真实结果形状与下载产物信息 使用实际可访问的 Rustacean 图片完成 image 与 multiview 示例 同步严格 endpoint 结果契约和真实 Provider 验收文档	2026-09-18 21:42:17 +08:00
k88936	527706b84e	按接口收紧Tripo任务结果类型 ... 为 text、image、multiview 三类生成定义独立必填结果结构 以枚举关联任务类型与具体结果并对缺失字段失败关闭 将通用 URL 类型由 TripoModelUrl 更名为 TripoUrl	2026-09-18 21:37:38 +08:00
k88936	a4beb53dc6	完善Tripo冒烟CLI产物流程 ... 等待三类生成任务完成并打印映射后的输出 完成后下载模型产物到当前目录并输出文件信息 仅在示例内部使用SDK轮询器，不扩展平台公共接口	2026-09-18 18:51:49 +08:00
k88936	25314d9a4a	新增Tripo三类生成冒烟CLI ... 增加仅通过环境变量配置的 Tripo generation example 顺序提交 text、image、multiview 三类任务并执行单次状态查询 保持无命令行参数且不调用 SDK 轮询接口	2026-09-18 18:42:58 +08:00