azwosile/dsh-tripo-studio

plugin

用于参考图生成、裁剪、分件 Tripo 3D 建模与本地资产预览的可视化工作台,收费操作须逐次确认。

工作流与自动化

dsh-tripo-studio 0.4.0 — 国际站 API 与 DSH Web

  • 显式选择国内站 / 国际站,独立凭据与任务;切站关闭收费,不自动跨站查询或重发。
  • DSH Web 默认仅本机;远程模式须配置独立口令、精确 HTTPS 来源和固定服务端目录,不面向多租户。
  • 客户端入口 lib/client-v0.4.0.js;无新增生产依赖。测试使用临时目录与模拟供应商,不代表真实 API 或用户公网部署验收。
  • 当前介绍 · Web 与双站配置 · 完整版本历史

dsh-tripo-studio 0.3.6 — P2.0 智能网格模型

  • 源码/构建 0.3.6(2026-10-08);安装状态以仓库根 README 为准。GUI及真实API未验收。
  • 「Tripo 几何模型」新增官方 P 系列 P2-20260801(「P2.0 智能网格(官方 preview)」,官方标注 preview 版),图生3D与多视图生3D均可选,接口不变;默认仍为 v3.1。官方文档
  • 选P2.0时:面数可留空自适应,或三角48–50000/原生四边面48–25000;不发送P系列不支持的 geometry_quality、smart_low_poly(超清几何禁用、智能低模隐藏);面板附官方说明。
  • 参考积分:P2.0 无贴图100/标准贴图110(官方P系列价表);高清/8K贴图组合不估价。未加入P1。
  • 入口 lib/client-v0.3.6.js,无新依赖。Windows单元170/170、npm run test:v036 12/12、全部历史浏览器回归通过;模拟供应商,未调用真实API。

dsh-tripo-studio 0.3.5 — 重拓扑(附官方提示)、导出朝向

  • 源码/构建 0.3.5(2026-10-02);安装状态以仓库根 README 为准。GUI及真实API未验收。
  • 重拓扑:统一建模页「⑤ 重拓扑 / 减面」,官方 POST /mesh/decimate。v2.0 智能重拓扑(30积分;面数自适应或三角500–20000/四边500–10000;可关闭bake)、v1.0 基础减面(10积分;面数必填,≤2M三角/≤150k四边;无bake)。输入为成功的同账户图生3D/多视图生3D任务,结果另存为新模型资产。
  • 官方提示:面板常驻 Tripo 官方提示(价格、范围、GLB输出、150 MB、v1.0限制、复杂模型可能失败、独立收费),勾选「已阅读」后才能准备,审批框重复显示。
  • 导出朝向 export_orientation(+x/-x/-y/+y):格式转换可选(官方推荐);图生3D/多视图默认不发送并显示官方警告。
  • 入口 lib/client-v0.3.5.js,无新依赖。Windows单元164/164、npm run test:v035 13/13、全部历史浏览器回归通过;模拟供应商,未调用真实API。实施报告

dsh-tripo-studio 0.3.4 — 多视图生成模型、拆件图紫色、拆件图任务失败修复

  • 源码/构建 0.3.4(2026-10-01);安装状态以仓库根 README 为准。GUI及真实API未验收。
  • 多视图生成模型:统一建模页「③ 多视图建模」,正面必填+左侧/背面/右侧可选(≥2张),按名称自动填充;提交时各视角免费上传,再一次 POST /generation/multiview-to-model(view-key inputs)。参考积分同图生3D。
  • 整张拆件图统一紫色框(--tw-role-purple),图例新增「拆件图 · 紫色」。
  • 拆件提示词去掉易触发内容审核的人体/内衬/“不要裸体”字样;失败任务像审核拦截时显示处理建议。
  • 并入官方 DeepSeek Harness 宿主兼容:install-local.mjs --target=official。
  • 入口 lib/client-v0.3.4.js,无新依赖。Windows单元155/155、0.3.4专项21/21(合同/模拟提交12+浏览器9)、工作流31/31、外观34/34、凭据17/17、0.3.3回归27/27、0.3.2回归22/22、0.3.1回归19/19、0.3.0回归24/24、0.2.12回归30/30、0.2.11回归35/35、0.2.10回归22/22、0.2.9回归24/24、实际宿主路由6/6;构建通过。实施报告

dsh-tripo-studio 0.3.0 — 工作室式界面与“来源 → 部件”

  • 源码/构建为 0.3.0,2026-09-24已按授权安装至DSH(未提交;以仓库根README为准)。GUI及真实API未验收。
  • 布局:顶栏单行;阶段01~05;左资产库(搜索、全部/原图/部件/3D)、中画布、右参数;底部任务坞可折叠。颜色/毛玻璃不变,全部原功能保留。
  • 05“来源 → 部件”:按原图列出本地裁剪与AI提取的部件及3D任务;只读,勾选带入03建模页后仍逐件审批收费。
  • 窄槽(<820px)单列,顶部切换素材/画布/参数/任务。
  • 数据:新版首次打开先把 state.json 原样备份到数据目录 backups/ 再写入,保留其他版本字段;安装器拒绝数据目录与插件目录重叠,并额外快照索引。
  • 入口 lib/client-v0.3.0.js,无新依赖。Windows单元133/133、工作流30/30、外观34/34、凭据17/17、0.3.0专项24/24、0.2.12回归30/30、0.2.11回归35/35、0.2.10回归22/22、0.2.9回归24/24、实际宿主路由6/6;宿主合同、构建及安装dry-run通过。实施报告

dsh-tripo-studio 0.2.12 — 选图/裁剪易用性与建模上传修复

  • 源码/构建为 0.2.12(开发轮文档;实际安装状态以仓库根README为准)。GUI及真实API未验收。
  • 图片卡:点击图片选择,悬停中央小按钮放大,右上角重命名(只改本机名称);删除「按提示词编辑选中图」重复按钮。
  • 拆件提示词可编辑并可恢复预设;裁剪面板下显示现有图片资产;“放大编辑”大画布;套索 Shift+拖添加、Alt+拖减去;保存裁剪后停留原图并可“换回原图”。
  • 候选裁剪与批量部件建模上限36(逐件审批收费);整体建模来源缩略图选择。
  • 建模“网络请求未取得响应”:免费参考图上传最多3次重试、超时按大小;失败标明“尚未发起收费生成”及脱敏原因;收费创建仍只提交一次。
  • 入口 lib/client-v0.2.12.js,无新依赖。Windows单元123/123、工作流30/30、外观34/34、凭据17/17、0.2.12专项30/30、0.2.11回归35/35、0.2.10回归22/22、0.2.9回归24/24、实际宿主路由6/6;宿主合同与构建通过。逐项报告

dsh-tripo-studio 0.2.11 — 资产预览、任务列表整理与3D计价

  • 当前源码/构建为 0.2.11,本轮未安装;DSH仍0.2.10,GUI及真实API未验收。
  • 资产图片单击放大、独立选择、标题透明度;拆件来源预览;关联删除失败在确认层显示。恢复区、参数等宽和转换入口布局修复。
  • 成功/失败/取消/丢弃/未提交记录可确认删本机记录;活动/未知/被引用任务隐藏并停止跟踪,保留恢复信息和资产。恢复显示不自动跟踪或查询;隐藏仍占本地容量。
  • 一键清理失败/丢弃:确认ID名单,仅删本机记录、保留全部资产,状态变化/引用/忙碌逐项报告。用户实际删除须自行确认,本轮测试只用临时夹具。
  • 3D计价Tips带官方来源及2026-09-23核对日,参考非报价;无公开取消协议,不提供假的云端停止功能。
  • 入口 lib/client-v0.2.11.js,无新依赖。Windows单元115/115、工作流30/30、外观34/34、凭据17/17、0.2.11专项35/35、0.2.9回归24/24、0.2.10回归22/22、实际宿主路由6/6;宿主合同、构建及安装dry-run通过。 本轮回执在仓库 validation/v0.2.11/;逐项报告 与 需求。不得将隔离测试等同原生GUI或真实消费验收。

以下0.2.10及更早内容为历史时点,部署以仓库根README当前状态为准。


dsh-tripo-studio 0.2.10 — 任务与资产清理、手动云任务导入、局部裁剪、多格式预览与建模扩充

  • 当前源码及DSH已安装版本均为 0.2.10(2026-09-23按用户新授权从0.2.9备份升级);离线HTML仍只是无后端展示,不是DSH插件。原生GUI和真实API尚未验收。
  • 失败/成功任务确认删本机记录,默认保留产出,可勾选删除独占本地资产;参考图单独确认删除,关联任务受保护。
  • 国内站 task_id 经用户确认,仅 GET 查询并导入当前账户已存在的受支持任务;不重发提交未知任务、不自动扣费。
  • 项目图/任务图放大;同比例大图裁剪、候选检测与手动套索。建模三种官方几何版本、贴图/拓扑/面数、FBX四边面;格式转换是独立收费任务,须单独审批。
  • 本地查看 GLB/自包含GLTF/FBX/OBJ/STL;USDZ/3MF转换后仅下载。原始四边面请保存原文件;没有自动装配、绑定或真实API质量保证。
  • 入口 lib/client-v0.2.10.js;目标Windows仓库构建/单元105/105、浏览器工作流30/30、外观34/34、凭据17/17、专项22/22、0.2.9回归24/24、宿主路由6/6、安装前后dry-run通过,已安装且82/82发布文件匹配。根目录的 0.2.10 实施与限制 列出全部18项与官方文档。测试使用隔离目录和模拟服务,勿粘贴或使用真实密钥。

以下 0.2.9 和更早条目保留为历史状态;其“当前”和“已安装”仅指该时点,最新版部署状态以项目根 README 为准。


dsh-tripo-studio 0.2.9 — UUID任务恢复与图像工作流修复

  • 已完成源码/构建和隔离自动化,尚未安装;DSH仍为0.2.8。真实账户/GUI和既有云任务恢复待现场验收。
  • 修复UUID被误拒,兼容task_示例ID;未知提交可通过原账户查询、核对ID/类型后关联恢复,不重发收费POST。
  • 任务卡显示模型、图像/GLB产出、单任务刷新和失败记录确认删除;未知记录不可删除。
  • 独立图生图改写;一次任务生成一张正/侧/背排版图,使用image-to-image提示词而非官方四视图接口。
  • 整张/单部件拆图切换;裁剪40步撤回、换图、取色填充,已保存资产不随撤回删除。
  • 控件/计价链接透明度、主画布透明和Tips链接重叠修复;提示词区分官方建议、本地限制和用户实测Flare 1800字符限制。
  • 第16项额外易用性优化按用户选择仅登记,不实施。无新依赖,无真实供应商调用,不读取真实密钥,不切换真实项目根。
  • 入口 lib/client-v0.2.9.js;详见根目录 docs/mcp-tripo-v0.2.9-implementation.md 与 validation/v0.2.9/。

以下均为历史时点,当前源码和部署状态以根README为准。


dsh-tripo-studio 0.2.8 — 透明控件、模型计价与整体建模

  • 普通控件与标题区域独立背景不透明度;步骤选中框加粗,下拉选项保持实色对比。
  • 10个官方文生图模型、9个拆件/编辑模型;模型对应的尺寸和quality白名单,官方积分价表和核对日。
  • 拆分立绘独立选择模型;完整定稿图整体打底,主次部件规划,重点部件单独审批生成。
  • 「项目文件夹」选择统一根目录并二次确认;旧项目不迁移,凭据不移动。新根目录集中state.json索引,projects//files保存各项目资产。
  • 新功能源码/构建0.2.8;安装仍0.2.7,本轮未安装。原生目录对话框/GUI与真实API待现场验收,自动化使用隔离目录和模拟供应商。
  • 入口 lib/client-v0.2.8.js。说明见根README和 docs/mcp-tripo-v0.2.8-implementation.md。

以下0.2.7及更早记录均为历史开发时点,不能覆盖上方当前状态。


dsh-tripo-studio 0.2.7 — 配色与Tripo专属标题栏毛玻璃

  • 顶部「界面外观」提供界面底色、顶部栏颜色、强调色,三套预设、4–40px模糊及恢复默认;原有字体、不透明度、独立控件尺寸保留。
  • 只在Tripo可见时,在DSH原生透明标题栏下面绘制无交互装饰层。宿主按钮颜色不改,底色混合用于对比保护;隐藏/卸载后清理。不修改宿主程序、主题或其他插件。
  • 3D预览页补充本地GLB/离线示例用途说明,不冒充云端生成。
  • 继续固定国内站 .com/v3、独立国内站密钥与旧站任务隔离;不改收费和安全逻辑。
  • 源码/构建入口 lib/client-v0.2.7.js;本轮未安装,DSH仍为0.2.6。Windows65/65、宿主路由6/6、外观33/33、工作流22/22、凭据17/17通过;原生GUI和真实API未验收。
  • 最新状态见根README及 docs/mcp-tripo-v0.2.7-palette.md,旧版说明按历史理解。

dsh-tripo-studio 0.2.6 — 固定国内站

  • 所有上传、生图、图生 3D、任务查询和余额请求固定为 https://openapi.tripo3d.com/v3,无国际站自动回退或任意 URL 配置。
  • 请在「连接设置 · 国内站」由用户自行填写国内站 Key;保存不代表供应商验证,收费仍需独立开启和逐笔审批。
  • 国内站使用独立 secrets/connection-cn.json(DPAPI、version 2、内外层 site=cn);不读取、不迁移、不覆盖旧国际站 connection.json。
  • 环境变量入口改为 TRIPO_CN_API_KEY 和 TRIPO_CN_ENABLE_PAID=1;旧 TRIPO_API_KEY 与 TRIPO_STUDIO_ENABLE_PAID 不再用于运行凭据或收费开关。
  • 旧无站点任务按国际站保留;禁止在国内站提交、查询、引用 task_id、恢复跟踪和重试云输出下载。已保存的本地资产可继续预览/下载,或经重新审批上传到国内站。
  • 新任务和审批绑定国内站,前端握手校验后端站点,避免新前端连到旧国际站后端。
  • 当前入口:lib/client-v0.2.6.js;旧构建保留。国内站保留原 3 个图像与 2 个几何模型,本轮不新增模型。
  • 验证与安装状态以项目根 README.md、docs/mcp-tripo-v0.2.6-cn.md 为准;未调用真实供应商、未验证真实密钥或消费。

以下为历史版本说明,不代表当前站点或配置:


dsh-tripo-studio 0.2.5 — 布局、外观和模型契约

  • 顶栏按 DSH 的实际标题栏 inset 避开窗口按钮;连接状态与设置等宽,项目选择和新建按钮对齐。
  • 「控件尺寸」改为浮动小面板,6 档 + 手动设置,不挤占页面;Escape / 关闭可返回。
  • 「界面外观」调整背景不透明度和字体颜色,支持恢复默认;不影响其他插件,安全弹窗保留实色。
  • 图像模型直接显示实际 chat_image_* 请求 ID;Prompt / size 旁有 Tips 和官方文档,支持合法自定义尺寸及 auto。
  • 当前实际端点仍为官方国际站 https://openapi.tripo3d.ai/v3;中文文档的 .com 是另一站点,不自动混用凭据。现有 3 个图像模型与 2 个几何模型的 URL / 请求头已有传输断言测试。
  • 拆件标题改为「拆分立绘」。本地模型和 NovelAI 属于未来方向,尚未接入。

当前入口:lib/client-v0.2.5.js。Windows 测试48/48、真实宿主路由6/6、外观31/31、密钥15/15、工作流22/22;不代表真实收费API或原生GUI已验收。最新安装状态见根 README。


dsh-tripo-studio 0.2.4 — 修复 DSH 后端连接

0.2.3 现场反馈的“密钥框无法选中 / 粘贴、选项不能勾选、不能新建项目”来自宿主前缀路由多写一个末尾斜杠,状态请求没有进入后端;不是需要先填 Key,也不是创建项目必须收费。

本版统一正确前缀 /dsh-tripo-studio,补充准确错误提示和「重新连接」,并用实际 DSH WebServer 验证连接、无 Key 建项目、保存假密钥及安全限制。原同源 / CSRF、DPAPI、逐笔收费审批均保留。

安装并重启 DSH 后打开 Tripo Studio → 创作工作流 → 连接设置。状态连接成功即可粘贴密钥、勾选并保存;也可不填 Key,先创建本地项目。离线 HTML 没有后端,不能代替 DSH 插件。

新增测试:npm run test:host:routes(需实际 DSH 运行时)。Windows 单元 43/43、宿主路由 6/6、连接 UI 15/15、工作流 22/22、外观 26/26。真实 GUI 与账户请在本机验收,测试未使用用户真实密钥。

当前入口:lib/client-v0.2.4.js。最新安装状态见根目录 README 的 0.2.4 记录;旧说明保留如下。


dsh-tripo-studio 0.2.3

新增:界面填写 Tripo API 密钥

打开 DSH 内 Tripo Studio → 创作工作流 → 连接设置,在「Tripo API 密钥」输入框粘贴密钥,选择是否加密保存,以及是否启用收费生成,然后点击「保存连接设置」。立即生效,不需要重启。可点击「查询余额(不提交生成)」检查凭据是否可用。

  • 默认密码框;可临时显示,保存尝试后清空输入。服务器不回传原文,也不显示尾号。
  • Windows 加密保存使用当前用户 DPAPI;位置为项目数据目录中的 secrets/connection.json(默认 %APPDATA%/dsh-desktop/tripo-studio/secrets/connection.json),不是插件安装目录或项目 state.json。不采用明文回退。
  • 不勾选加密保存时仅当前后端运行有效;重启恢复已有加密配置或环境变量。
  • 配置优先级:保存的设置优先于环境变量。损坏 / 无法解密时停止使用,不悄悄回退。
  • 「清除密钥」须再次确认,清空当前凭据、关闭收费,并以不含密钥的禁用标记阻止环境变量在重启后重新启用;不取消云端任务,也不保证退款。
  • 本机同源 + CSRF 校验;忙碌的提交 / 查询 / 下载期间拒绝修改凭据。更换账户后旧草稿审批和历史任务的账户检查仍有效。
  • 保存 / 清除不请求供应商,余额查询由用户明确点击;生成仍逐笔审批。不要把真实密钥发给聊天代理。
  • DPAPI 不是防御同一 Windows 用户下恶意程序的保险箱;本功能不用于多用户或公网服务。

测试:npm test、npm run test:ui、npm run test:compat、npm run test:credentials。其中真实 DPAPI 测试仅 Windows 执行;跨平台浏览器测试使用测试专用加密替身与模拟 Tripo。

当前入口:lib/client-v0.2.3.js。实际安装与验收状态以交付根目录 README 的 0.2.3 条目为准。


以下保留旧版本历史(其中“只能配置环境变量”已被 0.2.3 的界面入口取代):

dsh-tripo-studio 0.2.2

本轮按 README 新需求修复 Tripo 工作台左侧参数栏,不是替换宿主导航。

本轮更新

  • 左侧参数栏、输入框、下拉框、标签、开关和提示文字均使用局部深浅色变量。跟随 DSH Desktop 或手动切换主题时保留当前参数。
  • 新增顶栏「控件尺寸」:紧凑 / 标准 / 宽松;可自定义高度 28–56px、字号 11–18px、间距 4–16px、3D 左侧参数栏宽度 220–420px。宽度在空间不足时夹限或转为上下布局。
  • 移除 dsh-controls-sizer 桥接:不读它的全局变量或 localStorage,不再每秒轮询。旧版自身主题 / 面板偏好可读取迁移,独立尺寸保存在 tripo-studio:appearance:v2。不修改三方设置。
  • 按工作台实际容器宽度重排,适配 DSH 左右侧栏压缩主面板的情形;窄面板里左侧参数与资产详情不再被隐藏。
  • 继续使用宿主 React 与原有主面板注册协议;不全局覆盖 DSH 主题或其他插件 CSS。
  • 本轮新构建入口 lib/client-v0.2.2.js,旧构建保留。开发测试:npm test、npm run test:ui、npm run test:compat。
  • 真实 Tripo 收费调用、完整原生 GUI 验收仍须另行授权和验证。安装状态见交付根目录 README 的 0.2.2 条目,不以下方历史说明代替。

版本记录约定

每轮需求在交付根目录 README 新建版本条目,保留用户原文、实现结果、测试证据和安装状态。本轮沿用已登记的 0.2.2,连接恢复与进度更新不额外升版。


以下为 0.2.1 及更早版本历史说明(其中 Sizer 跟随已被本版独立设置替代):

dsh-tripo-studio 0.2.1

DSH Desktop 原生双端插件:GPT-image 2.5 生图、参考图编辑、部件提取/裁剪、Tripo 图生 3D 与本地资产预览。

0.2.1 是界面兼容更新:源码与构建已完成自动化验证,但本轮尚未替换已安装的 0.2.0。完整原生 GUI 操作和收费 Tripo API 尚未验收。不要将模拟图像/三角形模型视为 AI 生成效果。

0.2.1 外观兼容

顶部可选择主题(跟随宿主 / 浅色 / 夜间)、面板(毛玻璃 / 实色)和控件尺寸(跟随 Sizer / 标准)。新增 client-src/appearance.js、appearance-settings.js 与 appearance-styles.js,只管理 Tripo 的局部 token、偏好和资源生命周期。

  • Wallpaper Engine:保护透明背景下顶部栏位与内容可读性,不修改宿主或壁纸配置。
  • dsh-controls-sizer:只读整排宽高,页签组限宽、控件最小高度,变更约 1 秒同步;插件不在时安全回退。不是将原插件的拖拽手柄移植到本工作台。
  • dsh-settings-nav-color:共存并沿用宿主文字颜色,不重写其设置栏修复规则。
  • npm run test:compat 进行 Chromium 接口回归;若没有本机两个兼容插件,真实客户端共存项目会标注跳过。可用 TRIPO_COMPAT_FIXTURES 指向只读 sizer.js / nav.js 测试副本。
  • 新版入口:lib/client-v0.2.1.js;旧入口保留。完整记录见交付目录 docs/mcp-tripo-v0.2.1-compatibility.md。

0.2.0 修复摘要(保留)

  • Node 侧 Config 改为 Cordis 4 可消费的 Standard Schema,修复 Cannot read properties of undefined (reading 'validate')。
  • 客户端继续通过 window.__ModuleLoader__.load 注册;只复用宿主 React,不打包第二份 React,不加载运行期 CDN。
  • 默认先打开工作流,按需启动 WebGL;增加面板错误边界、计时器/图片 URL/GPU 资源清理。
  • 修复首次打开时模型无法导出、线框模式导出成线段、预览遮挡导航及窄屏无法找到导出入口的问题。

能力与边界

能力实现
文生图 / 图像编辑Tripo v3 的 text-to-image / image-to-image
图像模型chat_image_2.5_flare、chat_image_2.5_sunburst、chat_image_2
四图候选四个独立收费任务,明确展示数量,不虚构 n=4 参数
部件提取图像编辑提示词;单件或拆件图,须人工核对
本地裁剪手动框选、百分比坐标、纯色背景连通区域检测、方图补白
图生 3D独立参考图逐件提交;v3.1-20260211 / v3.0-20250812
审批草稿绑定输入哈希、参数与凭据指纹;未确认不提交
持久化本地项目、任务 ID、独立资产;重新打开只查询,不重新生成
输出受控同源资产路由、原始 GLB 下载、预览、项目清单

自动裁剪不是语义分割;AI 提取不是精确的原图像素分割。自动 Blender 装配、绑定、动力学、DCC Bridge、Agent 工具、多用户计费和多格式云转换不在本版实现范围内。

文件结构

index.js                  Node 插件入口,仅注册路由
server/config.js          Standard Schema
server/routes.js          本机 HTTP 边界、CSRF、受控文件访问
server/service.js         草稿、审批、提交、查询、下载与恢复
server/store.js           JSON 状态与本地资产
server/tripo.js           固定 Tripo v3 客户端、只读重试、下载校验
shared/contracts.js       模型枚举、参数校验、部件提示词
client-src/workflow.jsx   四阶段创作界面
client-src/image-tools.js  本地裁剪与区域检测
client-src/main.jsx        宿主槽位、错误边界与离线预览
client-src/scene.js        Three.js 生命周期与 GLB 预览
lib/client-v0.2.1.js       已构建客户端,无需现场重新构建
scripts/                  构建、宿主测试、界面测试、安装与停用

服务端配置

TRIPO_API_KEY                 仅在后端进程设置,不写入前端或项目文件
TRIPO_STUDIO_ENABLE_PAID=1    明确启用收费提交;缺省关闭
TRIPO_STUDIO_DATA_DIR         可选,本地项目数据目录
TRIPO_ASSET_HOSTS             可选,核实后添加的精确 CDN 主机名,逗号分隔

Windows 默认数据目录为 %APPDATA%\dsh-desktop\tripo-studio。插件文件与项目数据分开,停用脚本不会删除模型或项目。

环境变量不是系统密钥保险箱,同权限本机程序仍可能读取。当前服务拒绝公网、代理及跨站请求;不要自行放宽校验后用于多人服务。只运行一个使用该数据目录的后端实例;本版没有跨进程写锁或远端 exactly-once 保证。

「停止跟踪」只停止查询,不取消云端任务、不保证退款。提交结果未知时不会自动重发。显式重试下载会重新查询成功任务的输出 URL,但不会重新提交生成;能否更新过期 URL 取决于供应商。

安装与测试

完整说明见交付根目录的 docs/mcp-tripo-install-and-acceptance.md。

在目标 Windows 主机、源码目录内:

node scripts/test-host.mjs
node scripts/install-local.mjs --dry-run
# 正常退出 DSH 并确认之后,才执行:
node scripts/install-local.mjs --apply

安装器不执行全局 pnpm 安装,不修改其他插件或 lockfile,不取消宿主安全检查。默认不写入。

开发测试(源码目录):

npm ci
npm run build
npm test
npx playwright install chromium
npm run test:ui

Linux 浏览器测试环境可能需要 npx playwright install --with-deps chromium;这是开发依赖,不属于最终用户运行插件的前提。

停用(先关闭 DSH):

node scripts/uninstall-local.mjs --dry-run
node scripts/uninstall-local.mjs --apply

保留原始模型时,请用任务资产列表的「下载」。预览中的 GLB 导出为规范化展示副本,不承诺保留原始单位、朝向或动画;不会替代原始输出的下载。

许可证

工程声明为 MIT。运行时与离线预览内嵌的第三方组件许可见 THIRD_PARTY_NOTICES.md。Tripo 服务、模型输出及参考素材的使用权遵循各自条款,不由本插件许可证代替。