输入 IKEA 产品名或货号,生成带动画和语音的 3D 组装分步指南。

348
40
TypeScript
MIT
创建于 8 天前

Bygga 是一个网页应用:输入 IKEA 家具的产品名或包装上的货号,就能得到按纸质说明书风格绘制的 3D 组装步骤,并配有朗读。指南可以打印,也可以在离线状态下打开。

指南如何生成

核心是参数化步骤生成器加 three.js 线稿舞台,步骤在离线阶段绘制完成。目录覆盖英国和美国市场的 1,171 个 IKEA 产品、2,180 个尺寸,数据来自 IKEA 的公开商品列表;商品信息变化时,可以用项目自带的抓取/构建/检查脚本重建目录(README)。指南全部由程序生成而非搬运原册,所以每个封面改为链接到 ikea.com 上的官方说明书(README)。

使用方式

可以直接用托管版 usebygga.com,也可以本地运行:安装后执行 npm run dev,输入 BISSA 之类的产品名(仓库)。具体步骤可以通过 URL 直接跳到,指南还有 A4 打印视图,分享卡片由同一引擎绘制。在线站点用 service worker 让已经打开过的指南在无信号时仍可用。

AI 功能及其密钥条件

可选的 Together AI 功能包括:为目录外的产品生成草稿、拍照查找,以及会附上对应板材/配件/步骤示意图的求助聊天(README)。这些功能使用每位访客自己的 Together 密钥,没有密钥就无法使用这部分。免手语音的范围更窄:1,476 段预录的 Kokoro 语音片段无需密钥即可播放,而识别口说的"下一步"则要通过带回声消除的麦克风走 Together 上的 Whisper。

已知限制

目录尚未覆盖所有异形件——三角搁板、转角组合和部分无法按框架拆分的 PAX 宽度仍列在生成器的待办中。语音只支持英语。纸质说明书扫描功能在开关后面,作者明确表示尚未恢复,也没有声称在真实说明书上测试过(README)。测试会回放录制的语音样本和检查目录条目,但这是作者自己的检验,不等同于对通用准确性的验证。

项目采用 MIT 许可,并附有声明:IKEA 及其产品名是 Inter IKEA Systems B.V. 的商标,许可证不授予这些商标的任何权利(LICENSE、NOTICE)。

本文由 AI 根据项目 README 生成,更新于 2026年10月29日,以项目官方文档为准。