| name | tripo-3d |
| description | Tripo v3 在 Blender Harness 中的可恢复 provider adapter。用于 Tripo P1 低模、多视图生 3D、Smart Retopology、文件上传、task poll/fetch、AutoRig、retarget、与混元候选对比,或处理 Keychain、短期 URL、SUBMIT_UNKNOWN 和 provider DONE 不等于资产通过等边界。 |
Tripo 3D Adapter
先读
README.md
docs/architecture/HARNESS_V1.md
docs/integrations/TRIPO.md
- 当前任务若是揭小贤,再读
docs/milestones/JIEXIAOXIAN_CANONICAL_ENTITY.md 和 docs/milestones/JIEXIAOXIAN_INGOT_TOSS.md
- 需要核对 endpoint、模型版本或成熟度时读
references/API_V3_SNAPSHOT.md
Tripo 是候选生产者,不是资产审批者。success、provider_status=DONE、GLB 可解析或 P1 标称 clean topology 都不能替代 Blender 多视图、拓扑、身份和变形评审。
凭证
优先读取 TRIPO_API_KEY,否则读取 macOS Keychain service blender-harness.tripo。禁止把 Key 写进仓库、.env、request、fixture、日志、manifest 或命令历史。bh tripo credential-status 只输出来源和 fingerprint。
执行合同
bh tripo capabilities
bh tripo credential-status
bh tripo submit \
--operation geometry.multiview \
--request request.json \
--idempotency-key logical-probe-id
bh tripo poll HANDLE
bh tripo fetch HANDLE
首个 enabled operation 只有 geometry.multiview。registry 中的其余官方能力为 official_only,在具备 recorded/live fixture、request validator、required-output extractor 与内容 validator 前不得提交。
本地多视图 request 使用严格顺序:
{
"inputs": [
{"view": "front", "path": "/absolute/front.png"},
{"view": "left", "path": "/absolute/left.png"},
{"view": "back", "path": "/absolute/back.png"},
{"view": "right", "path": "/absolute/right.png"}
],
"model": "P1-20260311",
"model_seed": 20260713,
"face_limit": 10000,
"texture": false,
"pbr": false
}
Adapter 在付费 POST 前原子 reservation,按输入 SHA 恢复上传,file token 和原始结果 URL 只写 0600 private files。每次 poll 只请求一次;外部 orchestrator 决定等待频率。下载整个结果集先进入 attempt staging;必须存在主 GLB,并通过完整 GLB header/declared-length/chunk 与 SHA256 检查后才能整体发布。
任何可能已经创建远端任务但没有可靠 task_id 的窗口进入 SUBMIT_UNKNOWN,永不自动重提。只有通过供应商控制台/账单取得明确证据后,才使用:
bh tripo reconcile HANDLE --task-id TASK --trace-id TRACE --reason "..."
bh tripo reconcile HANDLE --confirmed-not-created --reason "..."
揭小贤对比
同一组新素体多视图、同一几何意图和接近的面预算比较 Tripo 与 Hunyuan;旧 FBX 是第三基线。先比较身份、轮廓、壳体、肩/腋/胯/腕布线和 canonical entity 适配性。静态候选被淘汰时停止,不提前调用 rig、UV、纹理或 retarget。
P1 输出属于 raw_geometry_candidate。若值得继续,下一探针才做统一临时 rig 与抛元宝所需的举臂/抓握/释放极值,而不是把 Tripo AutoRig 当作完成。