Bygga — 3D 生成的 IKEA 装配指南

它是什么： 一个网络应用（位于 usebygga.com），您输入 IKEA 包装盒上的名称或货号（如 BISSA 或 MALM），即可获得完整的装配指南，以 3D 线条图呈现，类似纸质手册，但可从任意角度查看，每一步都有语音朗读。

工作原理

Bygga 不使用 IKEA 的 PDF 手册。相反，它从 IKEA 的公开产品列表中提取数据，并使用参数化计划生成器自行生成每份指南。目前涵盖 1,171 款 IKEA 产品（英国和美国系列共 2,180 种尺寸），全部使用 three.js 线条艺术引擎离线绘制。

语音控制

该应用支持免提操作：包含 1,476 个预录音频片段（使用名为 Kokoro 的语音），无需任何 API 密钥即可播放。它还能使用运行在 Together AI 上的 Whisper（语音识别系统）监听“next”一词，并具备回声消除功能，以便在播放音频时听到您的指令。

AI 辅助

对于 Bygga 目录中没有的产品，或需要照片查找和帮助时，访客可以输入自己的 Together AI API 密钥。AI 可以：

• 为目录外的产品起草装配指南
• 通过照片查找产品
• 用精确面板、配件或步骤的图纸回答问题

其他功能

• 分享卡片，由同一 3D 引擎绘制
• A4 打印视图，用于纸质指南
• 离线支持，通过 service worker 实现，已打开的指南在无信号时也能使用
• 构建页面，以真实比例并排显示所有完成的构建

本地运行

克隆仓库，执行 npm install、npm run dev，然后打开 localhost:3000 并输入 BISSA 进行尝试。您可以通过 URL（如 /build/malm-3-drawers?step=12）跳转到特定步骤，在 /build/malm-3-drawers/print 打印，并在 /builds 查看完成的构建。对于 AI 功能，请将 .env.example 复制为 .env.local，设置 TOGETHER_API_KEY，并将模拟密钥粘贴到应用的密钥框中（只有 npm run dev 接受模拟密钥）。

测试

包含两套测试：npm run voice:check 重放 283 次录制的监听运行，npm run ikea:check 测试每个目录行。

路线图

计划改进：

• 教生成器处理不规则形状（三角架、转角组合、某些 PAX 宽度）
• 增加更多语音语言
• 在真实手册上测试手动扫描功能

许可证和商标

MIT 许可，但与 IKEA 无关。IKEA 及其产品名称是 Inter IKEA Systems B.V. 的商标，许可证不授予对这些商标的任何权利。