dsh-tripo-studio

DSH Tripo Studio

在 DSH Desktop 中，把参考图、拆件任务和 Tripo 3D 生成放进同一个工作台。

当前版本 0.4.0 · 桌面／DSH Web 插件 · Tripo 国内站／国际站 · MIT

插件名称为 DSH Tripo Studio，仓库名与包名统一为 dsh-tripo-studio（仓库原名 dsh-tripo-blender，2026-10-08 更名，旧链接会自动跳转，见 CHANGELOG）。它不是 Blender 插件，也不会自动启动 Blender、修模、装配或绑定骨骼。生成结果可以下载后交给 Blender 等工具继续处理。

能做什么

• 参考图创作：文生图、图像编辑、本地 PNG/JPEG 导入，整理和选择候选图。
• 拆件准备：AI 生成整张拆件图（结构化、可编辑的通用提示词）、提取部件参考图、裁剪与套索选区。
• 统一建模：每个部件标为 主要（绿）、次要（蓝） 或 基准（红）。主要与基准部件各自单独图生 3D；勾选的次要部件不单独收费，而是随它们所在的整张拆件图一次建模。被设为整张拆件图的图以 紫色 框标出。所有任务在同一页审阅后提交；格式转换也独立确认。
• 多视图生成模型：同一物体的正面＋左侧／背面／右侧（2～4 张）合并为一个 Tripo 多视图建模任务，按文件名自动填充视角。
• P2.0 智能网格：图生 3D／多视图生 3D 的「Tripo 几何模型」可选官方 P 系列 P2-20260801（官方标注 preview 版），支持原生四边面；按官方限制自动调整面数范围、禁用不支持的超清几何／智能低模，并附官方说明。
• 重拓扑 / 减面：对已完成的 3D 任务发起官方重拓扑（v2.0 智能重拓扑 / v1.0 基础减面），面板常驻 Tripo 官方提示，确认已阅读后才能提交；结果另存为新模型。
• 导出朝向：格式转换时可选前向轴（+x／-x／-y／+y）；生成时默认不设置，附官方说明。
• 明确的生成方式：参数区用「文生图／图生图」页签区分，按钮文字写明本次模式。
• 余额与实扣积分：审批框中可只读查询当前站点余额/冻结积分；国内站可与参考积分对比，国际站不套用国内站数值估价；可按官方用量记录回填任务实扣积分。
• 任务与资产管理：项目草稿、任务状态、按 task_id 查询/关联、失败下载重试、隐藏/恢复及有引用保护的本机删除。
• 3D 预览：查看已下载的项目模型或导入本机文件，旋转、线框、网格与背景设置，导出展示用 GLB 副本。
• 适应侧栏的界面：画布优先布局、可折叠资产库、画布下方参数区、底部任务区，以及主题、配色和控件尺寸设置。

“拆件”指参考图片与生成任务的拆分，不等于自动拆分已有 3D 网格。本机删除/隐藏记录、暂停跟踪，也不等于取消云端任务或退费。

工作流程

文字 / 本地参考图
       ↓
生成或编辑候选图 → 人工选择与确认
       ↓
整张拆件图 / 部件提取 / 裁剪 → 标记 主要·次要·基准
       ↓
统一审阅收费任务 → Tripo 图生 3D / 多视图生 3D
       ↓
查询结果 → 下载 → 本地预览 →（可选）格式/朝向转换、重拓扑
       ↓
按需交给 Blender 等外部工具后处理

快速开始

1. 准备环境

• 桌面使用：Windows + 已安装且已初始化的 DSH Desktop；DSH Web 使用见 Web 配置。本地安装脚本针对其现有 web profile，不是通用网站部署脚本。
• Node.js：包声明最低 >=20；新安装建议使用仍受维护的 Node.js 22 或 24。
• 若要实际生成：自行准备 所选 Tripo 站点的 API Key 和足够积分。仅本机导入、预览不需要供应商 Key。

2. 安装到 DSH

下载/克隆仓库，在仓库目录打开 PowerShell。正式安装前，先正常退出 DSH：

cd .\plugin
node .\scripts\install-local.mjs --dry-run
# 阅读预检结果，确认路径无误且 DSH 已退出，再执行：
node .\scripts\install-local.mjs --apply

发布快照已带当前客户端 plugin/lib/client-v0.4.0.js，普通安装无需先安装开发依赖。若自行修改源码，则按开发说明先重新构建。

安装器会备份旧插件和相关 profile，保留用户数据；不会自动启动/强行结束 DSH，也不会替你执行全局依赖安装。详细说明与卸载方式见安装与配置。

3. 首次使用

1. 手动启动 DSH，在侧栏打开 Tripo Studio，建立项目。
2. 在连接设置确认国内站／国际站并填写对应 Key。可仅在本次会话使用；Windows 支持 DPAPI 加密记住。
3. 导入参考图或填写提示词，设置图像/3D 参数。
4. 只有需要生成时才开启收费功能；检查确认弹窗中的任务和参数后再提交。
5. 在任务区查询结果、下载并预览；下载失败优先重试下载，不要重复生成。

费用、隐私与使用边界

• 支持显式选择国内站 .com/v3 或国际站 .ai/v3，无自动跨站重试、无任意 API 地址配置；Key、任务和审批按站点隔离。切换站点会关闭收费，旧账户指纹不自动迁移。
• 真实生成会将相应提示词、参考图提交给供应商；请确保有使用和上传这些素材的权利。
• 保存 Key、创建本机项目不等于提交收费任务。收费需要独立启用与逐次确认；收费 POST 不自动重试。界面价格仅供参考，以供应商账户结算为准。
• 模型预览支持 GLB、自包含 glTF、FBX、OBJ、STL；USDZ/3MF 仅下载。外部贴图/资源与复杂材质不保证完整还原。预览导出的 GLB 是展示副本，不应替代原始资产归档。
• 默认仅本机访问；DSH Web 远程模式须明确配置 HTTPS 精确来源与独立 Web 口令，所有用户共享同一可信工作台，不适用于多租户。不能直接作为 GitHub Pages 在线生成服务。 详见 DSH Web 与双站配置。
• 不含自动 Blender 修复、装配、重拓扑、骨骼绑定、动画或布料模拟；也未实现 WebUI、NAI 或本地生成模型后端。
• 此仓库只发布代码和必要测试夹具，不附带角色模型、贴图、个人参考图、项目记录或 API Key。

仓库结构

dsh-tripo-studio/
├─ README.md                  # 当前插件介绍
├─ CHANGELOG.md               # 产品版本历史
├─ LICENSE                    # MIT
├─ SECURITY.md                # 安全边界与问题报告
├─ docs/                      # 安装、开发、发布及本次审计
├─ tools/                     # 严格白名单打包与完整性校验
└─ plugin/
   ├─ client-src/             # React / Three.js 界面源码
   ├─ server/                 # 本机路由、任务、凭据与存储
   ├─ shared/                 # 参数合同、站点与任务策略
   ├─ lib/client-v0.4.0.js     # 当前可安装构建
   ├─ scripts/                # 构建、安装、模拟浏览器测试
   └─ tests/                  # 单元测试与非个人测试图片

文档

• 安装与配置
• DSH Web 与双站配置
• 开发、构建与测试
• 版本历史 · 历史整理说明
• GitHub 上传与重新打包
• 0.3.3 发布审计 · 首次发布审计
• 安全说明 · 第三方许可

许可

代码沿用 MIT License。Three.js、React 等第三方组件的声明见 THIRD_PARTY_NOTICES.md。供应商服务、生成内容和用户自带素材的权利另行受相应条款约束；本项目不附带这些素材的授权，也不代表 DSH 或 Tripo 官方项目。