文档
构建、集成并扩展 Simplio3D
在这里，您可以找到正确构建 3D 产品配置器所需的全部信息。
三大参考资料
用于在编辑器中构建的教程；以及用于无头开发的 API 和 SDK。
教程涵盖的内容
文档按您的操作场景而非功能名称进行组织。
| 章节 | 涵盖内容 |
|---|---|
| 资源 | 上传 3D 模型、纹理和图形；在保留基于原模型构建的配置的同时，将模型替换为新版本 |
| 材质 | 创建 PBR 材质、使用共享材质库、以正确的 UV 方向应用纹理，以及按类别批量添加 |
| 项目 | 项目类型、编辑器界面、对象与选项模式、条件逻辑、定价、表单、设置、分享以及 AR |
| AI | 使用 AI 构建配置器、助理与智能体工作流，以及管理多步骤 AI 任务 |
| 集成 | WooCommerce、Shopify、REST API 和 TypeScript SDK、MCP 连接、移动端与原生应用，以及自定义 UI 构建 |
| 请求与账户 | 查看报价和表单提交、试用与账单，并管理团队成员 |
无头构建
如果您的店面采用自定义开发，以下是关键组成部分。
身份验证
X-API-Key 标头中的 API 令牌可用于选项块、定价、报价提交和 Webhook。作为 Bearer 凭证的访问令牌可开启完整功能。请将两者均保留在服务器端。
使用类型化客户端
@simplio3d/sdk 是同一 REST API 的类型化客户端。它以无头方式管理项目数据——不渲染配置器，且不包含查看器或 3D 画布。
连接智能体
MCP 服务器通过 OAuth 2.1 或限定范围的 Bearer 令牌提供 115 项工具——其中 51 项为只读，61 项为受控写入——并采用提议、确认和快照的写入模型。
一切皆为模块
该平台基于一个理念构建：选项、规则和价格均为带属性的模块，通过可视化方式组合，而非编写代码。16 种选项模块类型涵盖客户的交互方式，6 种价格模块类型可在基于令牌的公式编辑器中组合使用。 这种架构使得第二个产品能够通过装配完成，而非启动一个全新的开发项目。