接入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

docs/technical/【技术方案】Tripo文本到3D模型Provider集成-2026-09-18.md

@@ -0,0 +1,31 @@
+# 【技术方案】Tripo文本到3D模型 Provider 集成-2026-09-18
+
+## 目标
+
+本阶段在 `server-rs/crates/platform-tripo` 内接入固定 revision 的 `tripo3d-sdk`，完成 text-to-model、image-to-model 和 multiview-to-model 三个 3D 生成入口的 Rust provider adapter。adapter 提供显式配置、提交、单次通用 task 查询和模型下载能力；共享产品契约继续由 `shared-contracts` 管理，并始终生成目录化 ts-rs TypeScript binding。
+
+代码按 API 目录组织：公共 SDK 配置、client、任务映射、错误、下载类型和通用 task DTO 位于 `platform-tripo/src/common/`；三个生成 API 各自拥有独立目录。Rust 与 TypeScript contracts 按 `common/`、`text_to_model/`、`image_to_model/`、`multiview_to_model/` 分目录生成。
+
+## 非目标
+
+- 不接入 `api-server`、worker、SpacetimeDB、OSS、计费或 UI。
+- 不暴露 SDK 的 `wait_for_task`，不在 adapter 内启动后台轮询。
+- 不实现后处理、rig、animation、图片生成或其它 SDK endpoint。
+
+## 边界与状态
+
+`platform-tripo` 是唯一接触 `tripo3d-sdk` 的边界。它返回自己的 provider DTO，不让 SDK 类型穿透到未来的 `api-server`。Tripo 的 `success` 映射为 `completed`；`failed`/`banned` 映射为 `failed`；`cancelled` 和 `expired` 保留为独立终态；未知状态返回结构化错误。
+
+provider task 结果与产品资源结果分离。provider adapter 不生成 `resourceId` 或 `assetId`；未来应用层在资源持久化后再构造带资源 ID 的产品 DTO。模型 URL 被视为临时 provider 引用，下载由显式方法完成。
+
+## 请求与类型
+
+text-to-model 请求包含 SDK 已公开的字段。稳定且已由 SDK 常量定义的字段使用 Rust/TypeScript enum；`compress` 与 `style` 暂时使用带示例 variant 的 enum，并保留官方 API 文档补全 TODO。完整组合校验等待官方 API 文档后一次性落地，不复制不完整的规则集合。
+
+## 验收
+
+- `platform-tripo` 不公开 re-export SDK 类型或 `wait_for_task`。
+- 三个 3D 生成入口的 submit、通用 get task、固定 SDK output 字段映射和显式 download API 可编译。
+- provider 错误统一为 adapter 错误类型。
+- shared contracts 的 ts-rs binding 无 feature 开关且始终可生成。
+- 未运行真实 Provider smoke；需要 API key 的联调另行执行。