# AI Game Developer 0.21.0 — Tripo 资产工具、随项目提交的知识库，以及本地图像基础能力

Tripo 的 3D、Textures、Mesh、Rig & animate 和 2D 工具现在是按会话分别控制的独立开关，每个都有自己的设置弹窗；一次资产请求会返回已保存的项目文件路径。此版本还提供了随项目提交的知识库及其 3D 图谱窗口，以及用于本地图像生成的包与内核基础。

本页由英文机器翻译而成。[阅读英文原文](https://ai-game.dev/releases/0.21.0)。

[所有版本](https://ai-game.dev/zh-hans/releases)

v0.21.0 2026年10月5日

4 项亮点 23 项新功能 4 项改进 11 项修复

Tripo 的 3D、Textures、Mesh、Rig & animate 和 2D 工具现在是按会话分别控制的独立开关，每个都有自己的设置弹窗；一次资产请求会返回已保存的项目文件路径。此版本还提供了随项目提交的知识库及其 3D 图谱窗口，以及用于本地图像生成的包与内核基础。

## 精选

### 支持经身份验证的付费执行的 Tripo 会话工具

桌面端新增 3D、Textures、Mesh、Rig & animate 和 2D 工具，可在会话中分别启用，每个工具都在自己的弹窗中配置；智能体只能看到你启用的组以及服务器为你的账户提供的变体。付费操作会按你配置的审批策略使用现有订阅额度，可用内容取决于你的套餐和服务器权限，而不是固定的免费额度。 (#652)

### 随项目提交的知识库

新的第一方包会为项目已提交知识文件夹中的笔记和文件夹建立索引，并为智能体提供浏览、搜索和读取这些内容的工具。它会在笔记变化时增量重新索引，跟踪链接并报告失效链接，还提供一个可供其他视图构建的快照。 (#654)

### 3D 知识库图谱窗口

知识库会在其独立窗口中打开为动态 3D 图谱：文件夹显示为圆环，笔记显示为球体，大小由连接度决定、颜色由所属文件夹决定，并带有包含关系和链接线以及星空背景。布局在 worker 中运行，并以主线程作为回退；没有原生 webview 窗口的应用会在窗格中显示同一图谱。 (#659)

### Tripo 操作等待完成并保存项目文件

现在一次 Tripo 请求会在单个操作内运行至完成：智能体会收到每个产物的已保存项目文件路径，或收到包含原因的明确失败信息，而不是自行轮询任务状态并获取结果。输出位置可以预先选择，并且能在响应丢失后保留，因此中断的任务无需再次支付生成费用即可恢复。 (#686)

## 新功能

### 包 webview 使用独立原生窗口

包可以在专用窗口中打开 webview，而不是在窗格中，并复用相同的页面代码和消息 API。该窗口按包、视图类型和项目保持单例；再次打开会显示现有面板，重新启动后不会恢复。 (#655)

### 用于下载文件的内容寻址存储

新的全机器级存储会按 SHA-256 哈希保存下载文件，并在发布任何内容前校验大小和哈希；它采用单一提交路径，绝不覆盖现有数据。所有者按哈希跟踪，因此仍在使用的文件会被保留，未使用的 blob 可以被回收。 (#663)

### 全机器级运行时协调器

后台协调器现在负责机器上的本地运行时进程，向需要它们的客户端分发租约，使一份运行时副本服务所有窗口和项目。它绑定到回环接口，要求提供每次启动的令牌，空闲时退出，并拒绝被旧客户端停止。 (#668)

### 运行时与图像模型贡献点

纯数据包现在可以声明运行时和图像模型，包括各平台变体、下载文件、许可证，以及每个模型适配的硬件层级。失败的规则只会丢弃它指定的运行时或模型，而不会丢弃整个包。 (#662)

### 包设置：路径字段与动态选项

包设置新增带“浏览”按钮的绝对路径字段，并提供可写性和可用空间反馈；还新增字符串字段，其选项来自提供程序而不是固定列表。已存储但不再提供的值会显示为不可用，且绝不会被改写。 (#666)

### 硬件探测

内核可以报告机器的显卡适配器、显存、驱动版本、计算能力、已安装内存、操作系统、可用磁盘空间以及相关的系统安全设置，结果会在多次运行之间缓存。该结果在选择运行时变体时用作提示。 (#665)

### 内核会话工具设置与独立的 Tripo 控件

包可以声明自己的会话工具栏控件和设置，以原生方式呈现，并检查包、窗口、项目和会话归属，同时协调过期的编辑。Tripo 保留五个独立工具：点击空白工具会打开其设置，选择子功能会激活它，清除最后一个选择会将其关闭而不会影响其他工具。 (#661)

### 带发布者限定的工具服务器名称

包工具服务器现在命名为发布者和名称以双连字符连接，消除了相似包标识符之间的歧义。未限定名称仍然可用，但会警告它们在后续版本中将不再被接受；第一方旧名称继续有效；过长的名称会连同其长度一起报告，而不是被截断。 (#667)

### 本地图像运行时启动规划与失败分类

本地图像运行时获得了其确定性的部分：它会为选定的模型和硬件适配构建启动参数，解析后端可以使用的设备，并将运行可能失败的方式（例如端口被占用、模型文件无效、系统策略阻止或缺少系统库）归类为用户可据以采取行动的原因。 (#672)

### 通过 CLI 管理包设置

包设置可以从命令行读取和写入；在写入任何内容之前，值会按其声明类型解析和校验，级别限制会得到遵守，不可用的选项会被报告。退出码区分成功、拒绝和用法错误。 (#671)

### 协调器任务队列

运行时协调器现在通过单个后端槽位调度生成任务，按模型和分块对等待中的工作进行分组，在停留窗口过去后让每个键获得公平轮次，并且绝不中断已经在运行的图像生成。它可以在客户端出现时预加载模型，取消排队中或运行中的任务，并保留已完成任务直到客户端取走。 (#670)

### 包工具结果可以携带图像

包工具现在可以在文本之外返回图像块，并通过与引擎结果相同的大小、尺寸、格式和编码检查；任何未通过检查的内容都会变成说明性文本注释，而结果的其余部分仍会保留。包 API 版本升至 0.3.0，CLI 会把返回的图像保存到项目中。 (#674)

### 可恢复且经过校验的下载

内核下载管理器会从稳定来源获取文件并存入内容寻址存储，使用范围请求从部分数据恢复，在流式传输时校验大小和哈希，并支持按组或按项暂停、恢复、重试和取消。状态会在工作开始时写入，因此重启后恢复的下载仍能完成。 (#669)

### 本地图像运行时包

新的第一方包以数据形式描述本地图像运行时：其适用于 CUDA、Vulkan、Metal 的平台变体以及预览版 Linux 构建，各变体施加的驱动和库要求，它公开的模型设置，以及包括 NVIDIA 运行时条款在内的许可证组件。该包不包含任何代码。 (#673)

### 运行时协调器随 CLI 和桌面端提供

协调器现在嵌入 CLI 二进制文件并按需启动，并提供一个用于检查或启动它的小命令。桌面端在使用本地运行时时启动它，更新时会先排空正在运行的工作再替换它，并处理便携版和 AppImage 安装。 (#677)

### 桌面端和 CLI 的下载传输

真实的网络传输现在已接入两个界面上的下载管理器，并带有重定向跟踪：拒绝降级重定向和不透明重定向；对于只在第一跳之后才报告大小的主机提供大小回退；每个进程使用一个存储和一个下载管理器。 (#679)

### 本地图像服务器后端

启动本地图像服务器的代码现在只会从经过校验的运行时目录树中派生进程，针对它启动的确切模型等待就绪，将静默回退到 CPU 视为可见失败，并在降低显存预算后对内存不足的启动重试一次。意外崩溃会退避，并以分类后的原因报告。 (#676)

### 四个本地图像模型包

四个纯数据包描述了图像模型及其文件、下载大小、默认设置和各自适配的硬件层级，使应用能够选择机器实际可运行的模型，并在没有任何模型适配时明确说明。它们的许可证和上游修订版本记录在包中。 (#678)

### 桌面通知中的下载进度

活动下载会在每个窗口中以实时通知显示，包含每个项目的字节数、速度和预计剩余时间，并提供任何窗口都能触发的暂停、恢复、取消、重试和丢弃操作。更新会节流；下载中途打开的窗口会在首次读取时获取当前状态；已完成项目会保留，直到你将其关闭。 (#682)

### 模型注册表与变体选择

内核现在可以为其运行的机器选择运行时变体，并解释每次拒绝的原因，例如驱动较旧、内存不足或缺少系统库，然后将下载的模型匹配到硬件层级。下载的模型可在该机器上的任何项目中使用，并可从应用中删除或更新。 (#685)

### CLI 中的进度行

CLI 会在输入区上方显示下载和包进度：每个组的字节数、百分比、速度和剩余时间，以及每个运行项一行。仅当没有其他内容需要时，Esc 键才会取消最新的可取消进度；完成的组会留下一行摘要。 (#681)

### 浏览 Tripo 工具生成的资产

每个 Tripo 工具的设置弹窗都会显示一个简洁的计数，表示该工具本次会话已生成的资产数量；打开后会仅列出该工具在当前会话中完成的文件。文件可在项目查看器或文件管理器中打开；被移动或更改的输出无需再次付费生成即可恢复。不会自动打开任何内容。 (#687)

### 面向包的存储、下载和硬件 API

包现在可以访问内核的文件存储、下载管理器和硬件探测；存储文件的所有权会强制归属于调用包，因此一个包无法认领或释放另一个包的数据。长时间运行的工作会立即返回，并通过事件报告进度；这些命名空间以提案形式提供，可能会变化。 (#684)

## 改进

### 重做的工作台主题与面板

桌面工作台现在使用中性黑色与金属质感的 Dark 调色板，之前炭灰色的外观保留为独立的 Carbon 主题。面板标题栏、分隔角、标签页和侧边栏共享同一套几何结构；每个主题都新增了可交互的空会话场景，并遵循“减少动态效果”设置；启动画面和登录界面则拥有各自的环境调色板。 (#639)

### 目录同步确保已保存的模型选择继续可用

客户端已更新到当前服务器目录契约，现有项目中保存的旧模型版本即使不再出现在公共目录中，也仍会发送请求。 (#656)

### 引擎工具结果携带图像和紧凑 JSON

来自引擎工具的截图结果现在会在通过大小、尺寸和格式检查时作为真实图像附件到达；否则会作为一段简短文本注释，说明为什么跳过图像。结果是紧凑 JSON，而不是一个格式化打印块；失败的调用会包含服务器的错误消息。 (#645)

### 移除了隐藏的图像生成占位符

一个不起作用的隐藏原型能力行已被移除，它使用的图标现在用于 Tripo 2D 组。引用旧标识符的已存储选择会被静默忽略，并在后续切换中保留。 (#664)

## 修复

### 发布任务现在会检出它所需的所有内容

公告步骤在发布前失败了，因为一个辅助文件不在其部分检出范围内。该任务现在会引入它依赖的每个文件，因此无需安装任何内容即可汇编已批准的说明。 (#623)

### 在复用的 runner 上执行完整发布检出

在部分检出之后，复用的 runner 可能会缺少受跟踪文件，从而破坏发布验证。现在完整检出会显式恢复整棵目录树。 (#624)

### 登录测试不再打开浏览器标签页

运行 CLI 登录测试过去会在每次运行时于开发者或 CI 机器上启动真实的浏览器标签页。测试现在会为浏览器打开器提供桩实现，同时保留真实的命令接线和断言。 (#640)

### 窗口控件在每个主题中都匹配标题栏

最小化、最大化和关闭按钮条可能显示与渲染器标题栏不同的背景，尤其是在登录和启动界面背后。现在它在全部六个主题中都透明，从而绘制出一个连续表面，同时保留主题化字形颜色和现有的模态遮罩变暗效果。 (#644)

### 未关联浏览器时的登录，以及技能关闭竞态

在没有用于网页链接的默认应用的 Windows 机器上，登录会卡在等待浏览器，却不说明原因。应用现在会显示包含链接和复制链接操作的提示；没有关联应用的文件会在文件管理器中显示，而不是静默失败；技能服务在关闭期间关闭时的竞态也已修复。 (#648)

### 包提供程序注册与 webview 清理

一个包可能被报告为激活失败，因为它自己声明的提供程序在包集重启仍待处理时被判为无所有者；现在该声明会被接受，直到该重启完成。过期的提示 webview 和不是插件的包文件夹会被处理，而不会产生虚假错误。 (#650)

### 错误的项目文件夹是用法错误，而不是崩溃

使用第一个词不是项目文件夹的命令运行 CLI（例如记错的子命令），过去会以原始堆栈跟踪和崩溃报告结束。现在会在引导前检查该路径，在清晰消息中指出它，并作为用法错误报告，同时使用匹配的退出码。 (#647)

### 减少关闭和更新检查时的崩溃报告

Windows 注销过去会被记录为应用程序崩溃，系统每终止一个进程就记录一次；从外部终止的 Chromium 实用程序服务也会被记录。现在不再报告这些终止，重复项会合并为每个会话一次，无法访问网络的更新检查也不再引发错误。 (#649)

### 为远离服务器的用户提供的登录

连接尝试过去只给每个解析出的地址 250 毫秒，因此与服务器相距约 300 毫秒的用户永远无法完成账户注册。现在地址族会以更长的允许时间进行竞速，用户拒绝或超时的登录不再被记录为错误。 (#651)

### 会话智能体使用其窗口自己的项目

当保存的全局文件夹指向别处时，窗口可能会在另一个项目的目录中启动其会话智能体，导致工具面板显示某个工具已启用，而提供程序查找读取的是错误项目。会话现在使用为其窗口捕获的项目目录。 (#657)

### 滚动条避开圆角

圆角框架过去会在聊天面板、侧边面板和工具弹窗中裁切滚动条滑块。现在无论是在应用中还是在注入的包 webview 中，滚动条都会在任一轴的两端保留一小段边距，并且不会移动滚动内容。 (#660)

试用 v0.21.0

免费，支持 Windows、macOS 和 Linux。启动时自动更新。

[下载 v0.21.0](https://ai-game.dev/download) [所有版本](https://ai-game.dev/zh-hans/releases)

---

Source (HTML): https://ai-game.dev/zh-hans/releases/0.21.0

Machine-translated (zh-Hans) from the English page: https://ai-game.dev/releases/0.21.0
