# Tripo

> 通过你的 AI Game Dev 订阅额度使用云端 3D：从文本、单张图像或多视图生成 3D 模型，生成贴图、重拓扑、部件拆分、网格补全、格式转换、骨骼绑定、动画，以及图像生成与编辑。智能体会为每个任务挑选合适的操作和模型变体。

- ID: `aigd.tripo`
- 来源: 官方 (第一方 `aigd.*`)
- 分类: 3D
- 发布者: AI Game Dev (`aigd`), 已验证
- 最新版本: 0.2.20 (发布于 2026-11-22)
- 许可证: Apache-2.0
- 需要 AI Game Dev 应用: `>=0.25.11`
- 原生代码: 否
- 评分: 暂无评分
- HTML 页面: https://ai-game.dev/zh-hans/packages/aigd.tripo

## 安装

使用 gamedev CLI，在项目文件夹中运行：

```bash
gamedev pkg add aigd.tripo
```

在桌面应用中：打开 Packages 窗口（状态栏中的包图标），选择 **Browse**，搜索 `aigd.tripo`，然后点击 **Add to Project**。更多：https://ai-game.dev/docs/wiki/app/packages

## 版本

| 版本 | 发布时间 | 需要应用 | 备注 |
|---|---|---|---|
| 0.2.20 | 2026-11-22 | `>=0.25.11` | 最新 |
| 0.2.19 | 2026-11-19 | `>=0.25.11` | - |
| 0.2.18 | 2026-11-13 | `>=0.25.11` | - |
| 0.2.17 | 2026-11-06 | `>=0.25.11` | - |
| 0.2.16 | 2026-11-06 | `>=0.25.11` | - |
| 0.2.15 | 2026-11-06 | `>=0.25.11` | - |
| 0.2.14 | 2026-11-05 | `>=0.25.11` | - |
| 0.2.13 | 2026-11-01 | `>=0.25.11` | - |
| 0.2.8 | 2026-10-24 | `>=0.25.10` | - |
| 0.2.7 | 2026-10-15 | `>=0.20.0` | - |
| 0.2.6 | 2026-10-13 | `>=0.20.0` | - |
| 0.2.5 | 2026-10-05 | `>=0.20.0` | - |

## 描述

````markdown
# Tripo (`aigd.tripo`)

Tripo 通过 AI Game Dev 服务器，把 AI Game Dev 智能体连接到 Tripo 的云端 3D 与图像生成，费用从你的订阅额度中扣除。它能从文本、一张图像或多个视图生成 3D 模型，生成贴图，处理网格（重拓扑、拆分为部件、补全缺失的几何体、格式转换），为模型绑定骨骼并制作动画，还能生成和编辑图像。在当前应用版本中，智能体会为每个任务挑选操作和模型变体。桌面应用会自动安装它。它适合想要 3D 资产和动画、但没有本地 GPU 的开发者。

## 可以制作什么

- 根据文本提示、一张图像或多个视图，生成道具、角色、生物和场景的 3D 模型。
- 为已有的 3D 模型生成贴图。
- 更干净的网格：优化拓扑、把模型拆分为部件、补全缺失的几何体，或把文件转换为其他 3D 格式。
- 已绑定骨骼并带动画的角色：检查模型能否绑定骨骼、添加骨架、为其制作动画。
- 2D 图像：从文本生成、编辑，或作为同一对象的多视图（用于多视图转 3D）。

## 示例请求

- “用 Tripo 根据文本提示制作一个木质宝箱，并保存到项目中。”
- “把 `Concepts/robot_front.png` 转成 3D 模型，然后绑定骨骼并添加走路动画。”
- “为 `Assets/Models/house.glb` 生成新的贴图。”
- “把这个载具模型拆分为部件，并优化它的拓扑。”
- “为这张角色图创建正面、侧面和背面视图，然后用它们构建 3D 模型。”

## 亮点

|  |  |
|---|---|
| 类型 | 代码包（供智能体使用的会话工具）、云端生成 |
| 3D | 从文本、从图像、从多视图生成 3D |
| 贴图 | 为 3D 模型生成贴图 |
| 网格 | 优化拓扑、拆分为部件、补全缺失的几何体、转换文件格式 |
| 骨骼与动画 | 检查骨骼绑定、添加骨架、为已绑定骨骼的模型制作动画 |
| 2D | 从文本生成图像、编辑图像、创建和编辑多视图 |
| 费用 | 按订阅额度的百分比计费，并与对话的生成预算核对 |
| 安装方式 | 由桌面应用自动安装 |
| 许可 | Apache-2.0（本包） |

## 操作组

桌面应用会自动安装 `aigd.tripo`。它的五个操作组（3D、贴图、网格、骨骼与动画、2D）并不是各自独立的按钮：工具中对话的 **3D** 组会开启前四个，**图像** 会开启 2D。智能体可以使用其中哪些，仅在项目的模型界面中决定。

智能体会针对每个任务，从当前服务器目录中列为已启用、且符合用户套餐资格的所有变体中，挑选操作及其 `variant_id`；用户不自行选择。每次调用都会重新核对最新的目录，绝不会替换为其他模型。套餐不包含的变体不会出现在工具中；`status` 和 `capability_search` 会说明原因（`PLAN_REQUIRED`：需要更高档的套餐，只有用户自己可以购买）。工具无法更改会话设置。这需要宿主声明支持 `env.features.agentChoosesVariants`；在较旧的宿主上，本包保持原有行为（固定某个变体，或在各组设置中选择一份明确的“由智能体选择”允许列表）。较旧的 Kernel 只暴露设置和状态。

## 为任务付费

真实操作使用公开的 Kernel `paidOperations` API。Kernel 会获取不可变的服务器报价，将其与对话的生成预算核对（默认情况下，预算范围内的任务会直接运行，不再询问；在“每次操作前询问”模式下，由用户逐项批准），然后提交已批准的请求。预算无法覆盖的任务会被拒绝。会话配置不构成同意。密钥和账户令牌始终不进入本包；只有我们的服务器与 Tripo 通信。

## 等待、恢复与重试

正常生成会等待完成，并在同一次工具调用中保存所有产物。等待期间，该调用会保持应用的包重载和后台服务更新（`aigd.work.hold`），因此二者都不会在等待中途替换后端。智能体可以用 `retrieve_result` 恢复被中断的工作，或检查 `jobs` 和 `recover_jobs` 进行诊断，并撤销已保存的授权。下载重试绝不会重新生成资产。未知的提交结果会依据其持久化的请求标识进行恢复，而不会创建替代任务。已有文件会被保留。

## 账务

所有面向客户的估算和余额都以额度百分比表示。服务器账务按官方供应商成本扣费，不额外加价。实际执行取决于当前服务器就绪情况、订阅策略和 Kernel 支持。随附的设置页面不包含任何模拟控件。

## 验证

验证覆盖最新的策略变更、会话归属、提交前拒绝、无重试的确认丢失，以及不触发生成的产物获取。隔离的开发测试夹具属于 QA 辅助工具，并不构成对供应商的验证。

## 兼容性

兼容性：激活时会检查实际提议的 API，与引擎版本无关。此前负责会话配置的 Kernel 保留其旧版 webview 控件；当前 Kernel 会渲染全部五个已声明的模块，并管理它们的生命周期。缺少基线账户/会话配置 API 的 Kernel 不会注册任何提供程序，并记录一条需要更新应用的要求。此兼容路径绝不会替换变体，也不会授权支出。

## 已保存的资产

每个模块都在其清单中声明 `context.assetOperations`。只有当本次会话已产生输出文件时，Kernel 才会在该模块的设置中显示一个紧凑的资产计数。打开后会显示一个有尺寸限制的弹窗，绝不会是主动弹出的对话卡片。列表会排除其他模块和会话。已保存的文件会在项目查看器或文件管理器中打开；缺失或已更改的文件可以通过现有的持久投递日志恢复，而无需重复付费生成。
````
