这页提供最常用的实战流程：项目初始化、硬件交互、固件开发、调试与会话管理。
新项目启动
选择平台
从官方目录选择平台，或手动新增。如需新增平台，输入名称并点击 + Add "[platform name]"，随后上传相关文档。 添加外设
选择你要用的外设（I2C/SPI/UART 等）。后续可随时再次运行 /peripheral 调整配置。 生成项目上下文文件
生成 EMBEDDER.md，便于后续会话复用约束和命令。 硬件交互
串口监视器
打开串口侧边栏：
或使用快捷键 Ctrl+`。
若不希望刷写后自动连接串口，可在提示中写：
> don't auto-connect to serial after flashing
[Filter] 进行 regex 过滤。
固件开发
写驱动
> write an I2C driver for the BME280 sensor on I2C1 (SDA=PB7, SCL=PB6).
> include functions for reading temperature, humidity, and pressure.
> create a UART driver for GPS module on UART2 at 9600 baud.
> implement a ring buffer for RX and parse NMEA sentences.
> implement SPI driver for the SD card module on SPI1.
> include initialization and single block read/write.
构建与刷写
安装依赖
> help me install the dependencies for this project
刷写固件
> flash the firmware to the device
构建 + 刷写 + 监控
> build and flash, then show me the serial output
串口调试
> what's causing this error in the serial output?
> the device keeps resetting, analyze the crash dump
> add debug prints to trace the initialization sequence
Plan 模式与 Act 模式
- Act 模式：可读写和执行命令，适合实现改动
- Plan 模式：只读分析，适合调研和方案设计
切换方式：Shift+Tab、/plan、/act
文档与上下文
你可以通过 /console 上传更多芯片手册、参考文档和外设资料。
示例：
> what's the maximum I2C clock speed for this sensor?
> show me the register map for the accelerometer
Bash 模式
以 ! 前缀直接执行命令，不经 AI 解释：
!ls -la
!make clean
!git status
串口发送模式
以 ~ 前缀直接向设备串口发送：
用 @ 引用文件/目录
> explain the logic in @src/main.c
> what's in @src/drivers/?
会话管理
/project
/history
/compress
快速参考
| 场景 | 命令 / 快捷键 |
|---|
| 新项目配置 | /project -> /peripheral -> /init |
| 打开串口 | /serial 或 Ctrl+` |
| 切换模式 | Shift+Tab 或 /plan /act |
| 引用文件 | 在提示中输入 @filename |
| Bash 直连 | !command |
| 串口发送 | ~message |
| 撤销 | /undo 或 Ctrl+Z |
| 回退 | /rewind 或 Ctrl+Z (2x) |
| 帮助 | /help |
Last modified on March 5, 2026
