从哪开始
用一句话描述你想要的设备——例如「一个测距仪，每秒测一次前方障碍物有多远，并在手机上实时显示」——WhispBuild 会为你确定硬件方案、编写固件并完成编译。你只需把固件烧录到开发板，设备就能运行。
先选一条路径
还没有开发板 →
从零开始。先了解平台会给出什么方案，再决定采购哪些器件。
已有一块开发板 →
在描述里点名你的板子型号，平台会围绕这块板出方案，Step 0 里挑板子那一步可以跳过；传感器、杜邦线和面包板仍然要按清单采购。
直接复刻一个现成项目 →
最快见到结果的方式。选一个他人已完成的项目，替换为你的 WiFi 配置，烧录即可。
遇到问题，直接跳转
板子已插上，但识别不到
端口列表为空，且没有任何报错。
烧录失败
一开始就失败，或停在某个百分比不再推进。
串口输出是乱码
已经连上，但输出的内容无法辨认。
编译始终不通过
提示编译失败，但不清楚需要你做什么。
它的工作方式
整个平台的核心是一个对话框。你描述需求，它完成四件事：
| 1 · 确定硬件 | 选定主控、传感器并规划引脚，产出一份可以按清单采购、按表接线的方案。这份方案要你确认之后才生效。 |
|---|---|
| 2 · 编写固件 | 依据已确认的硬件方案编写代码。你不需要读懂 C++。 |
| 3 · 编译 | 在云端编译为可直接烧录的固件文件。失败时会说明原因，多数失败它会自行修复。 |
| 4 · 交付 | 在浏览器中直接烧录，或下载后使用你惯用的工具烧录。烧录完成后保持连线即可查看串口日志。 |
首页上半部分是一个输入框，左栏是你已创建的项目；输入框下方还有 我的 project 与 公开共享 两个标签页——前者列出你自己的项目卡片，后者列出他人公开发布的项目。这个输入框也可以直接用于提问，例如「我有哪些项目」「打开那个用超声波测距的项目」。它了解每个项目的用途与硬件构成，因此你可以用模糊的说法指代，无需记住准确的项目名。
开始之前，请先了解三件事
你需要一块真实的开发板。平台不提供模拟器。固件必须烧录到硬件才能验证结果。查看需要准备的物品 →
烧录仅支持 Chrome 与 Edge。Firefox 和 Safari 不具备 WebSerial 能力，无法在浏览器中烧录。你可以随时下载固件，使用自己惯用的工具烧录。
平台无法感知你的实际接线。引脚表是依据资料推导出来的，不是实测得到的。接线前请对照实物核对一遍——产品界面中也有同样的提示。
平台目前不具备的能力
列在前面，免得你花时间去找：模拟器与虚拟设备、账单与积分（界面上标注为「即将支持」）、命令行工具与 SDK。
支持的框架只有 esp-idf 与 arduino 两种。能编出固件的开发板是大部分 ESP32 系列开发板、ESP8266 开发板，以及 Arduino Uno R3（经典 AVR 版）——ESP32 系列并非每一款都在支持范围内，STM32、树莓派 Pico 这类则完全编不出来。完整清单 →
本文档无需登录即可查看。产品中创建项目或复刻项目需要登录；公开项目不登录也能查看，并可下载固件。