v0.3.13

Changes

• Clarify the Skill's automatic submission flow: the server-owned 60-second deadline starts when a review is created, including hidden/background cards and restart recovery.
• Clarify that the agent must establish authorization for the requested action and credit-spending scope before creation; existing sufficient authorization does not require repeated approval.
• Include the existing authentication recovery and asset-loading fixes on main.

The Skill clarification preserves the existing runtime behavior; it does not add a runtime consent gate.

Validation

• Four package CI jobs passed: https://github.com/GrinZero/tripo-studio-plugin/actions/runs/41399848707
• Local lint, format, distribution, build, and fresh/offline package checks passed. Tests: 209 passed, 2 Blender-only tests skipped because Blender was unavailable.

v0.3.12 — 8K 贴图参数与分辨率校验修复

修复请求 8K 贴图却生成 2K 的问题，并增加实际分辨率校验。

• 修正彩色贴图、纹理超分和 High Detail 建模的 8K 参数映射；工具和界面继续使用 ultra，发送到 Tripo 时转换为 extreme。
• 贴图与 PBR 任务完成后读取对应的固定模型版本，检查实际贴图尺寸；分辨率不足或尚未验证时，在任务结果和预览卡明确提示。
• 同步修正 8K 报价，并补充真实 8K 图片、2K 回退、多贴图尺寸不一致和版本隔离的回归测试。

已有 2K 文件不会自动升为 8K，更新不会自动重跑付费任务。

发布包通过本地测试、分发校验，以及全新 npx 和离线缓存启动验收。跨平台验收和 npm 发布状态见本 Release 对应的 GitHub Actions。

更新后开启新聊天以加载新版本的技能与 MCP 连接。

v0.3.11 — 后台配置卡自动计时修复

配置卡创建成功即启动服务端 60 秒倒计时，修复后台 session 因卡片未展开而一直无法自动提交的问题。

• 卡片未展开、未挂载或 session 在后台时，倒计时照常运行并在到期后自动提交。
• 展开、重新打开卡片及服务重启沿用已保存的截止时间，不重置倒计时。
• 配置卡创建后立即后台预上传输入；修改参数仍会暂停，保存后立即提交，取消后不再提交。
• 同步更新工具说明、技能和用户文档。

本地验证：构建、分发一致性检查、lint/格式检查、189 项测试、浏览器交互验证，以及发布包全新 npx 和离线缓存启动验收通过。

更新后开启新聊天，使用新版技能与 MCP 连接。

v0.3.10 — 工作台重新加载与倒计时恢复

工作台现在支持点击版本标记重新读取最新界面，并保留当前页签和未提交表单。重复加载、键盘操作和读取失败后的重试均已验证。后端或 MCP 配置更新后仍需重连 Tripo MCP。

修复配置卡片在重新打开、离开视口及服务重启后重置自动提交倒计时的问题；已经显示过的卡片延续首次截止时间，未显示的卡片仍等待首次显示，中断的提交不会自动重试。

修复贴图生成卡片的参考图预览，正确读取任务保留的 reference 来源。结果卡片统一使用 Tripo 标志，并显示构建时生成的版本与台北时间标记。

同步插件、市场、MCP、技能、文档与 npm 包版本为 0.3.10，提交完整构建产物。

验证：189 个自动化测试、lint、格式、分发一致性检查通过；Playwright 验证工作台重新加载、贴图参考图与配置卡片倒计时；发布包通过全新 npx 启动、68 个 MCP 工具与 WASM 图片处理，以及离线缓存启动验收。

v0.3.9 — 自动提交修复与 pnpm 工程化

修复自动提交倒计时误暂停：只有实际参数变化才暂停；聚焦、点击、重复选择和模型预览保持倒计时。

显式声明上传模块的 Smithy 依赖，保证 pnpm 干净安装可构建。

开发流程迁移到固定版本 pnpm，添加 ESLint、Prettier、Husky、lint-staged、commitlint、EditorConfig，以及 CI 中的 lint、格式和提交规范检查。更新分发构建与开发文档。

验证：187 个自动化测试、浏览器配置卡与模型预览回归、分发一致性检查，以及全新 npx 安装和离线缓存启动均通过。

GitHub CI 已通过 Linux / macOS / Windows 的 Node.js 22，以及 Linux 的 Node.js 24 检查。

v0.3.7 — 配置表单与模型预览更新

生成与编辑统一使用可调整的配置表单；模型、任务和结果卡片的预览支持 GLB 与二进制 FBX，并保留贴图和 PBR 材质。

• 配置表单在可见显示后开始 60 秒自动提交倒计时；编辑暂停，保存校验和重新报价后立即提交。Agent 通过只读状态等待跟进同一张表单，提交及工作流工具改为仅供应用使用。
• 工作台草稿可重新打开配置，配置卡片可查看来源模型，任务与结果卡片展示输入图片及完整提示词。
• 改进模型旋转、缩放、复位、线框和主题适配；支持 FBX 格式识别、层级名称、贴图转换及 PBR 通道保留，优先预览已下载的产物。
• 明确 Smart Mesh 的白模 → 颜色贴图 → PBR 三阶段流程，允许整模型贴图省略部件列表。
• 每次构建生成台北时间版本标记，并更新工作台资源 URI 和本地插件配置，减少旧页面缓存；同步多语言界面、技能和文档。

本地验证：184 项测试全部通过；实际发布包通过全新 npx 安装、68 个 MCP 工具、MCP Apps、WASM 图片处理及离线缓存启动验收。浏览器验证覆盖 GLB、嵌入贴图、Meshopt、FBX、配置可见性与编辑、草稿、来源模型、任务与结果预览及工作台布局。

更新后重连 Tripo MCP，并关闭后重新打开工作台；若仍显示旧页面，请完全退出并重新打开 Codex。

v0.3.6 — 已授权任务直接提交

已授权的生成、编辑及连续批处理现在按 skill 指引直接提交，无需再次要求用户展开配置卡或明确选择“跳过卡片”。

• 按用户意图选择执行、交互调参或仅草稿模式；参数和费用仍在提交前展示。
• 误建配置卡时读取当前状态，符合已有授权的待提交任务复用原草稿，避免停顿和重复生成；保留用户编辑、取消及未知结果的处理约束。
• 同步修正 MCP 参数说明与使用文档，并更新插件、市场和运行时版本。

验证：152 项测试通过；发布包完成全新 npx 安装、68 个工具、MCP Apps、WASM 图片处理及离线缓存启动验收。

更新后开启新聊天或重连 Tripo MCP，以加载新版 skill 和工具说明。

v0.3.5 — 积分余额与配置确认优化

Tripo Studio for Codex 0.3.5 改进配置确认体验，并在工作台显示 Studio 剩余积分。

更新内容

• 积分余额：工作台顶部显示当前账号的 Studio 剩余积分。
• 更快的配置确认卡片：先显示配置与本地费用预估，图片在后台上传与审核；修改参数复用上传结果，替换图片只上传新内容。
• 稳定的草稿与任务跟踪：保存配置更新同一份草稿；提交前提供 draft_id，收到提交回执后才提供 task_id。通过 tripo_get_configuration_review 跟踪卡片状态。
• 本地开发更新：新增 npm run install:local，使用独立的本地市场与固定运行目录；界面更新可在现有 MCP 连接中生效，后端或技能更新时提示重新连接。
• 分发与文档：明确从 main 添加 Git 插件市场的安装方式，完善 MIT 许可证说明，修复已验证 tarball 的发布与失败重试流程，并同步所有语言 README 的版本徽章。

安装与更新

需要 Node.js ≥ 22、npm/npx、支持插件与 MCP Apps 的 Codex，以及自己的 Tripo Studio 账号。

首次安装：

codex plugin marketplace add https://github.com/GrinZero/tripo-studio-plugin.git --ref main
codex plugin add tripo-studio-plugin@tripo-studio-plugins

已有用户更新：

codex plugin marketplace upgrade tripo-studio-plugins
codex plugin add tripo-studio-plugin@tripo-studio-plugins

安装或更新后在 Codex 中开启新聊天。

安装包

tripo-studio-plugin-0.3.5.tgz 已上传为 Release 附件。完整插件包包含 MCP 配置、构建产物、ImageMagick WASM、界面、技能和用户文档。

• 152 项自动化测试通过。
• Linux、macOS、Windows / Node.js 22 与 Linux / Node.js 24 的 CI 验收全部通过。
• 全新 npx 启动和离线缓存启动验收通过，包括 68 个 MCP 工具、MCP Apps 与 WASM 图片处理。
• Release 附件与本地验收包的 SHA-256 一致：05c2af522ff72465707dc88e0ffcc5655e89792dc7a6df9c5231c53aba9e0dfe。

发布工作流已全部通过。npm 0.3.5 已发布并设为 latest，附带 provenance；注册表可查询，且 npm 安装包的完整性校验与已验收的本地包一致。

使用说明 · English · 完整变更

v0.3.4 — Tripo Studio for Codex 首次发布

Tripo Studio for Codex 的首个 GitHub 正式发布版本。

在 Codex 中连接自己的 Tripo Studio 会员账号，通过自然语言和交互式工作台生成、编辑、绑定、动画化并导出 3D 资产，无需 Tripo API Key。本项目是独立开发的非官方插件。

主要功能

• 67 个 MCP 工具：覆盖图片与多视图生成、3D 建模、网格处理、纹理/PBR、骨骼绑定、动作、任务管理和下载导出。
• 交互式工作台：资产、任务与创建面板，支持模型/图片分组和多选管理。
• 账号与任务持久化：复用浏览器登录会话，保留任务状态、参数及资产来源记录。
• 本地 Blender 工作流：支持几何检查、渲染、纹理投影和多格式交付；本地操作不消耗云端积分。
• 独立运行包：JavaScript 依赖与 ImageMagick WASM 随包提供，无外部运行时依赖；修复 Windows 启动路径与图片快照写入问题。
• 多语言文档：简体中文、繁体中文、English、日本語、한국어，以及分类工具指南。

安装

需要 Node.js ≥ 22、npm/npx、支持插件与 MCP Apps 的 Codex，以及自己的 Tripo Studio 账号。Blender 为可选依赖。

tripo-studio-plugin@0.3.4 已发布到 npm。在终端执行：

codex plugin marketplace add GrinZero/tripo-studio-plugin
codex plugin add tripo-studio-plugin@tripo-studio-plugins

安装后在 Codex 中开启新聊天，发送「检查 Tripo Studio 登录状态，需要的话帮我登录」，再发送「打开 Tripo 工作台」。

发布附件与验证

tripo-studio-plugin-0.3.4.tgz 是完整插件安装包，包含 MCP 配置、启动入口、构建产物、WASM、界面、技能和用户文档。GitHub 自动提供的 Source code 附件是源码归档。

• Linux、macOS、Windows / Node.js 22，以及 Linux / Node.js 24 的 CI 验收通过。
• 135 项自动化测试通过。
• 安装包通过全新 npx 启动和离线缓存启动验收，包括 MCP 握手、67 个工具、MCP Apps 和 WASM 图片处理。

发布工作流已全部通过，包含跨平台验收、Release 附件上传及附带 provenance 的 npm 发布。

发布提交：30d8d02d16827a9892d6ede72eab24c5a6b63192。

简体中文使用说明 · English · 配置说明