46 Commits

Author	SHA1	Message	Date
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	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	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	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	e2809b83c0	3D 冒烟示例单端点失败不再中断其余端点 ... - wait_for_task / get_task / download_model 失败时记录该端点错误并继续 - 保留 throw_on_failure: false 的原有语义，仅补齐传输与超时类错误	2026-09-22 13:45:50 +08:00
k88936	2691ca8aca	补记图生输入的OSS直读待讨论项 ... - api-server 的 image_source 模块头与 platform-tripo 的 upload_image 各留一条 TODO(oss-direct-read)：交签名 URL 或对端直读 OSS 能省掉字节中转，但把私有对象与带时效凭据交给第三方，安全口径与可行性待讨论 - 技术方案文档把图生输入口径更新为当前的 source 站内引用 tagged enum，并补同一条待讨论说明 - 讨论清楚之前保持「api-server 自己读、自己传」的现口径，不改行为	2026-09-21 20:02:18 +08:00
k88936	14066eea11	产物下载改为按「无数据推进」判超时 ... - artifact reqwest client 不再设包含响应体的总超时，改成 connect_timeout + read_timeout（reqwest 0.12 的「每次读操作」语义，读完自动重置） - 响应头之前没有数据推进时用显式 tokio::time::timeout 兜住，避免连上却不返回响应头时无限挂住 - 新增 TripoProviderClient::artifact_stall_timeout 统一承载三处预算，取值沿用 TripoSettings::request_timeout - 补 3 个 mock TCP 用例：响应头一直不来、传输中途断流按无数据推进失败，慢速但持续的下载必须完整收完（后者能拦住「改回总超时」的回归） - 同步技术方案与后端架构文档里的下载超时口径	2026-09-21 19:54:57 +08:00
k88936	609b24c779	text-to-model入口的submit改名带端点 ... - TripoProviderClient::submit 改名为 submit_text_to_model，与 submit_image_to_model / submit_multiview_to_model 一致 - 同步 api-server tripo3d worker 与 tripo_generation_smoke example 的调用点 - 同步技术方案文档里写死的 submit 口径，方法名不再与另两个入口分叉	2026-09-21 19:49:31 +08:00
k88936	3af0d3d90b	契约枚举的线上取值只由serde定义 ... - 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 不会再静默分叉	2026-09-21 19:46:43 +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	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	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	188614d5d2	改用Provider流式下载Tripo产物 ... 保持第三方SDK不变并在Provider侧读取签名模型URL 逐块暴露模型响应并校验Content-Length，smoke示例改为异步落盘 为未来SDK原生stream能力保留迁移TODO	2026-09-19 23:14:00 +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	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	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
k88936	5be4a51ac1	完善Tripo枚举与参数组合校验 ... 按提供的 Tripo 文档补齐 compression、texture quality 与 texture version 枚举 移除未在三个生成接口出现的 style 占位字段并同步 Rust/TypeScript contracts 增加模型版本、纹理版本、生成部件、quad、smart-low-poly 与 face limit 的副作用前校验 同步 Provider 技术方案和 ADR	2026-09-18 17:23:55 +08:00
k88936	37b355a814	接入Tripo三类3D生成Provider ... 加入固定 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	2026-09-18 16:02:13 +08:00