dsh-loopx-plugin
loopx-project/loopxLoopX——面向长周期 Agent 的提供商中立、本地优先状态内核与控制平面:在 DeepSeek Harness 执行层之上持久化 Goal、Todo、门禁、证据、配额、恢复与交接状态;插件负责引导安装 CLI 与技能、准入有界的同会话续跑,并为精确绑定的工作循环提供本地 GoalBar。
lib/client-v0.4.0.js;无新增生产依赖。测试使用临时目录与模拟供应商,不代表真实 API 或用户公网部署验收。P2-20260801(「P2.0 智能网格(官方 preview)」,官方标注 preview 版),图生3D与多视图生3D均可选,接口不变;默认仍为 v3.1。官方文档geometry_quality、smart_low_poly(超清几何禁用、智能低模隐藏);面板附官方说明。lib/client-v0.3.6.js,无新依赖。Windows单元170/170、npm run test:v036 12/12、全部历史浏览器回归通过;模拟供应商,未调用真实API。POST /mesh/decimate。v2.0 智能重拓扑(30积分;面数自适应或三角500–20000/四边500–10000;可关闭bake)、v1.0 基础减面(10积分;面数必填,≤2M三角/≤150k四边;无bake)。输入为成功的同账户图生3D/多视图生3D任务,结果另存为新模型资产。export_orientation(+x/-x/-y/+y):格式转换可选(官方推荐);图生3D/多视图默认不发送并显示官方警告。lib/client-v0.3.5.js,无新依赖。Windows单元164/164、npm run test:v035 13/13、全部历史浏览器回归通过;模拟供应商,未调用真实API。实施报告POST /generation/multiview-to-model(view-key inputs)。参考积分同图生3D。--tw-role-purple),图例新增「拆件图 · 紫色」。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;构建通过。实施报告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通过。实施报告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;宿主合同与构建通过。逐项报告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当前状态为准。
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 为准。
lib/client-v0.2.9.js;详见根目录 docs/mcp-tripo-v0.2.9-implementation.md 与 validation/v0.2.9/。以下均为历史时点,当前源码和部署状态以根README为准。
lib/client-v0.2.8.js。说明见根README和 docs/mcp-tripo-v0.2.8-implementation.md。以下0.2.7及更早记录均为历史开发时点,不能覆盖上方当前状态。
.com/v3、独立国内站密钥与旧站任务隔离;不改收费和安全逻辑。lib/client-v0.2.7.js;本轮未安装,DSH仍为0.2.6。Windows65/65、宿主路由6/6、外观33/33、工作流22/22、凭据17/17通过;原生GUI和真实API未验收。docs/mcp-tripo-v0.2.7-palette.md,旧版说明按历史理解。https://openapi.tripo3d.com/v3,无国际站自动回退或任意 URL 配置。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 不再用于运行凭据或收费开关。lib/client-v0.2.6.js;旧构建保留。国内站保留原 3 个图像与 2 个几何模型,本轮不新增模型。README.md、docs/mcp-tripo-v0.2.6-cn.md 为准;未调用真实供应商、未验证真实密钥或消费。以下为历史版本说明,不代表当前站点或配置:
chat_image_* 请求 ID;Prompt / size 旁有 Tips 和官方文档,支持合法自定义尺寸及 auto。https://openapi.tripo3d.ai/v3;中文文档的 .com 是另一站点,不自动混用凭据。现有 3 个图像模型与 2 个几何模型的 URL / 请求头已有传输断言测试。当前入口:lib/client-v0.2.5.js。Windows 测试48/48、真实宿主路由6/6、外观31/31、密钥15/15、工作流22/22;不代表真实收费API或原生GUI已验收。最新安装状态见根 README。
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 → 创作工作流 → 连接设置,在「Tripo API 密钥」输入框粘贴密钥,选择是否加密保存,以及是否启用收费生成,然后点击「保存连接设置」。立即生效,不需要重启。可点击「查询余额(不提交生成)」检查凭据是否可用。
secrets/connection.json(默认 %APPDATA%/dsh-desktop/tripo-studio/secrets/connection.json),不是插件安装目录或项目 state.json。不采用明文回退。测试: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 的界面入口取代):
本轮按 README 新需求修复 Tripo 工作台左侧参数栏,不是替换宿主导航。
tripo-studio:appearance:v2。不修改三方设置。lib/client-v0.2.2.js,旧构建保留。开发测试:npm test、npm run test:ui、npm run test:compat。每轮需求在交付根目录 README 新建版本条目,保留用户原文、实现结果、测试证据和安装状态。本轮沿用已登记的 0.2.2,连接恢复与进度更新不额外升版。
以下为 0.2.1 及更早版本历史说明(其中 Sizer 跟随已被本版独立设置替代):
DSH Desktop 原生双端插件:GPT-image 2.5 生图、参考图编辑、部件提取/裁剪、Tripo 图生 3D 与本地资产预览。
0.2.1 是界面兼容更新:源码与构建已完成自动化验证,但本轮尚未替换已安装的 0.2.0。完整原生 GUI 操作和收费 Tripo API 尚未验收。不要将模拟图像/三角形模型视为 AI 生成效果。
顶部可选择主题(跟随宿主 / 浅色 / 夜间)、面板(毛玻璃 / 实色)和控件尺寸(跟随 Sizer / 标准)。新增 client-src/appearance.js、appearance-settings.js 与 appearance-styles.js,只管理 Tripo 的局部 token、偏好和资源生命周期。
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。Config 改为 Cordis 4 可消费的 Standard Schema,修复 Cannot read properties of undefined (reading 'validate')。window.__ModuleLoader__.load 注册;只复用宿主 React,不打包第二份 React,不加载运行期 CDN。| 能力 | 实现 |
|---|---|
| 文生图 / 图像编辑 | 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 服务、模型输出及参考素材的使用权遵循各自条款,不由本插件许可证代替。