展厅 3D 展品模型

概述

没有 3D 建模团队、没有 Blender/Maya 基础？描述一句话，1-5 分钟给你一个能 360° 旋转的 3D 模型。

投标样例图、互动程序资产、客户提案视觉——3D 资产不再卡脖子。

价格

¥19.9 / 次（SkillHub Pay Skill，按次付费）

它解决什么问题

• 3D 建模门槛高：传统流程 = 建模师数天 + 软件成本。用本技能只需一段中文描述（"科技感产品展示台，圆形发光底座，悬浮半透明展品，蓝色光带"），1-5 分钟出 GLB/OBJ。
• 投标样例图空缺：给客户的 PPT 里没 3D 视觉冲击。生成后嵌入 exhibition-pitch-template，立竿见影。
• 互动程序资产难产：Unity/Three.js 都需要 .glb，本技能直接输出 GLB，可直接 import。
• 预览麻烦：输出目录附带 _viewer.html，本地双击即可 360° 旋转，不用装任何软件。

适用场景

• 投标 PPT 里的展品样例图
• 互动程序的展品资产（Unity / three.js 通用）
• 客户提案视觉（提案前快速出图沟通）
• 展品原型预览（设计阶段快速迭代）
• 微信小程序 3D 嵌入（GLB 通用）

云端服务调用（SkillHub X402，半托管）

本技能已接入统一 X402 云端网关。由于 3D 生成需要买家自己的腾讯混元临时凭证（BUDDY_TEMP_TOKEN），网关完成支付授权后返回本地执行交付单，买家在本地完成 3D 生成：

# 1) 发起调用
POST https://czqlooi-d8ghvqslf8ca855ee-1470936211.ap-shanghai.app.tcloudbase.com/pay-gateway/exhibition-3d-showcase
body: {"prompt": "科技感产品展示台，圆形发光底座，悬浮半透明展品，蓝色光带"}

# 2) 收到 HTTP 402 → 调用 weixinpay_pay 完成微信支付（¥19.9/次）

# 3) 携带 X-Out-Trade-No 重试 → HTTP 200
#    响应含本地执行交付单：
#    {
#      "authorized": true,
#      "out_trade_no": "...",
#      "delivery": "LOCAL_EXECUTION",
#      "params": {"prompt": "...", "generate_type": "Normal", ...}
#    }

拿到交付单后，按下方「本地执行」章节，使用你自己的 BUDDY_TEMP_TOKEN 运行 scripts/run.py 完成 3D 生成。

本地执行

# 1) 获取临时凭证（首次调用前）
#    在 WorkBuddy 中执行 connect_cloud_service 获取 tempToken
export BUDDY_TEMP_TOKEN="<tempToken>"

# 2) 使用网关返回的交付单参数执行 3D 生成
python scripts/run.py --params-file << 'EOF'
{
  "prompt": "科技感产品展示台，圆形发光底座，悬浮半透明展品，蓝色光带",
  "output_dir": "./3d_output",
  "buddy_token": "<你的 BUDDY_TEMP_TOKEN>",
  "order_no": "<网关返回的 out_trade_no>"
}
EOF

# 或 图生 3D（图生模式）
{
  "prompt": "复刻这个展品",
  "image_url": "https://...",
  "output_dir": "./3d_output",
  "buddy_token": "<你的 BUDDY_TEMP_TOKEN>",
  "order_no": "<网关返回的 out_trade_no>"
}

你会得到什么

• GLB/OBJ 模型文件：可直接导入 Unity / three.js
• _viewer.html：本地双击即可 360° 旋转预览
• _preview.png：模型预览图，可直接贴进 PPT
• SkillHub_订单信息.txt：订单号溯源文件

参数说明

核心原则（安全第一）

1. 临时凭证不外传：BUDDY_TEMP_TOKEN 必须经 connect_cloud_service 获取，只在你本地环境使用，绝不写入 SkillHub 消息或日志。
2. 网关只收款授权：3D 生成在你本地完成，原始工程文件与临时凭证不会离开你的机器。
3. 一次付费一次授权：每个 out_trade_no 对应一次本地执行授权。

套装搭配（用得多，赚得多）

• 先用本技能出3D 展品样例图
• 配套 exhibition-pitch-template 把 3D 预览图嵌入提案 PPT
• 配套 exhibition-research-report 在提案前行业背书页加数据来源
• 配套 exhibition-showcase-page 给提案加在线案例页链接

风险逆转

• "生成失败怎么办"：检查 BUDDY_TEMP_TOKEN 是否过期，重新执行 connect_cloud_service 获取新 token。
• "生成时间太长"：文生 3D 约 1-5 分钟，可先用 --no-poll 提交再轮询状态（参考 references/cloud_3d.md）。
• "产物格式不对"：通过 result_format 参数指定 obj+glb / stl / usdz / fbx。
• "没有临时凭证"：本技能需买家自备 WorkBuddy 混元 3D 临时凭证；网关仅完成支付授权，不代替调用 3D API。

付费使用说明（X402 协议）

本技能为 SkillHub Pay Skill，按调用量计费。调用时由平台将请求转发至开发者服务，服务在未收到对应订单款项时返回 HTTP 402（Payment Required），引导用户完成微信支付；支付成功后再次请求即可返回本地执行交付单。

前置检查

• 调用方已检查 weixinpay 插件是否安装并启用（微信支付 AI 专属卡能力依赖此插件；未安装时无法弹出支付授权）。
• 调用方已登录 SkillHub 账号并完成商户入驻认证。
• 调用方账号余额或支付方式已绑定，可完成微信支付。
• 调用方已准备自己的腾讯混元 3D 临时凭证（BUDDY_TEMP_TOKEN），用于本地 3D 生成。
• 本地已安装 Python 3.7+。

支付触发

• 用户首次调用本技能时，开发者服务会创建一笔微信支付订单，并返回：
  • HTTP 状态码 402
  • 响应头 WeixinPay-Required: <payment_code>（X402 支付触发标识，值为支付链接 payUrl）
  • 响应头 X-Out-Trade-No（订单号）
  • 响应体中的 payUrl（支付链接）与 payment_code（与 payUrl 同值）
• Agent 识别 WeixinPay-Required 头后，应立即调用 weixinpay_pay 插件，传入 payment_code（或 payUrl）让用户完成支付。
• 支付完成后，Agent 必须在原请求的基础上增加请求头 X-Out-Trade-No: <订单号>，再次请求本技能。
• 第二次请求时，开发者服务会向微信查询订单状态；确认已支付后返回本地执行交付单。
• 若查询订单仍未支付，继续返回 402 与同一 payUrl，重复上述流程。

重试机制

• 网络类瞬时失败（连接超时、DNS 失败、微信 API 5xx）自动重试最多 3 次，退避 1s/2s/4s。
• 逻辑类失败（参数非法、目标工程不存在）直接返回错误，不重试。
• 同一 X-Out-Trade-No 可多次重试查询支付状态，不重复创建订单、不重复扣费。
• 用户支付成功后，因服务暂时不可用导致第二次请求失败的，按上述退避策略自动重试，最终返回执行结果。

订单号传递

• 订单号由开发者服务生成，通过响应头 X-Out-Trade-No 下发。
• Agent 必须在支付成功后的重试请求中，把同一订单号通过请求头 X-Out-Trade-No 回传。
• 订单号贯穿：调用日志、微信支付账单、SkillHub 计费、争议工单四个环节。
• 订单生命周期：pending → paid → running → succeeded/failed，状态变更由开发者服务与微信支付共同确认。

异常处理

• 用户未支付或支付未完成：服务返回 402，响应体含 payUrl 与 outTradeNo，提示继续支付。
• 微信支付订单查询失败：返回 502，按重试机制恢复。
• 参数非法 / 前置检查不通过：返回 400，不创建订单、不扣费。
• 技能执行失败：返回 500，订单标记失败，不扣费，可凭 X-Out-Trade-No 排查。

版权与许可

• 版权所有 © 2026 展厅多媒体交付。本技能（含 SKILL.md 提示词、脚本与生成模板）受著作权保护。
• 许可：仅限 SkillHub 付费用户依据平台协议使用；禁止反编译、去除水印、转售、再分发或用于训练竞品。
• 生成产物默认植入 SkillHub 订单号水印，用于溯源与侵权追责。
• 违规使用将依法追究法律责任。