fyfish code 是专为嵌入式系统打造的专业级命令行 AI 编程智能体。
不是通用代码补全，而是嵌入式工程师真正的"副驾"。
这些坑，每个嵌入式工程师都踩过
通用 AI 编程助手不懂嵌入式语境，常给出主机 GCC 代码、忽略 volatile/ISR/DMA，代码充满致命隐患。
HardFault 无法自动解码、串口 hexdump 靠手动解析、寄存器现场靠人工翻手册硬查，效率极低。
缺乏烧录前 Pre-flight 校验，不理解 volatile/MMIO 重要性，极易损坏昂贵硬件。
芯片型号繁杂、迭代极快，手册查阅耗时费力，大量资料不开放或缺失，底层移植适配反复踩坑。
原生支持
从芯片选型到固件部署，覆盖嵌入式开发全流程
自动检测本地工具链，解析 Makefile / CMake / ESP-IDF，一键交叉编译，无需手动配置编译参数。
封装 OpenOCD / J-Link / esptool / ST-Link / WCH-Link / CMSIS-DAP，含防烧砖校验，安全可靠。
多模式解码 + HardFault 自动解析 + 日志落盘 + 时间戳，调试效率大幅提升。
断点 / 单步 / 寄存器 / 内存查看，JTAG/SWD 全支持，复杂 Bug 无处遁形。
读得懂 Datasheet、寄存器手册、HAL 库与厂商 SDK，基于 CMSIS-SVD 查询寄存器位域语义。
FreeRTOS vTaskList 任务分析（栈水位 / 死锁检测），实时掌握系统运行状态。
通用 AI 做不到的，我们写进了产品基因
内置 10+ 嵌入式专用工具，Agent 可直接调用
| 工具 | 职责 |
|---|---|
cross_compile | 交叉编译：自动检测工具链，解析 Makefile / CMake / ESP-IDF |
flash | 烧录：封装 OpenOCD / J-Link / esptool / st-flash，含防烧砖校验 |
serial_monitor | 串口监控：多模式解码 + HardFault 解析 + 日志落盘 |
debug_probe | 调试探针：断点 / 单步 / 寄存器 / 内存查看 |
datasheet_query | 手册检索：寄存器位域查询，实时查 Datasheet |
svd_query | 基于 CMSIS-SVD 查询寄存器地址、位域语义、复位值 |
firmware_analyze | 分析 ELF / map size / 符号 / Flash·RAM 使用率 |
rtt_monitor | 采集 SEGGER RTT 调试日志（不占串口） |
rtos_analyze | FreeRTOS vTaskList 任务分析（栈水位 / 死锁检测） |
toolchain_detect | 工具链探测：首次运行自动检测本地环境 |
覆盖 MCU 到 SoC，从裸机到 Linux 的全栈嵌入式平台
HAL/LL 库、CubeMX、STM32CubeIDE、OpenOCD/J-Link 调试
ESP-IDF、Arduino core、分区表、OTA、WiFi/BLE
Linux 内核/驱动、U-Boot、Buildroot/Yocto、RKNN NPU
Linux BSP、Tina Linux、U-Boot、媒体框架
GCC 工具链、自定义 ISA 扩展、裸机与 RTOS
MCUXpresso、跨界 MCU、高速 Cortex-M7 内核
三级跃迁，从工具到基础设施
当下：写码 / 交叉编译 / 烧录 / HardFault 解码，一体化闭环
积累中：越用越懂各平台寄存器、时序、功耗与典型坑点，每块芯片的使用经验自动沉淀为平台知识图谱
终局：成为芯片原厂与开发者之间不可或缺的 AI 研发工具
芯片平台知识靠「使用」持续沉淀，迁移成本随使用深度指数级增长 → 天然护城河
从写代码到固件部署，全程命令行操作，无需离开终端
用自然语言描述需求，AI 自动生成嵌入式驱动代码，精确到寄存器位域
自动检测工具链，解析构建系统，一键交叉编译生成固件
Pre-flight 校验 + 跨进程锁保护，安全烧录到目标芯片
HardFault 自动解析 + 日志落盘，快速定位问题
开箱即用的嵌入式开发技能，Agent 自动调用
外设驱动开发（SPI/I2C/UART/GPIO/DMA/ADC/Timer/PWM/CAN/USB）
RTOS 任务调试与系统分析（FreeRTOS / RT-Thread）
硬件级排障（JTAG/SWD 连接 / OpenOCD 报错 / 芯片解锁）
OTA 升级、Bootloader、A/B 分区、MCUboot
低功耗设计与电源管理（Sleep/Stop/Standby）
串口压测与自动重启循环，长时间稳定性验证
Coder / Tester / Reviewer 三角色闭环，而非单点补全
根据需求生成驱动、应用逻辑和构建配置，严格遵循安全红线
编译检查 + 烧录验证 + 串口断言，捕获编译期与运行时错误
静态审计 volatile/ISR/DMA/栈深度，拒绝不合规代码
Coder / Tester / Reviewer 三角色协作，最多 3 轮迭代，确保交付质量
可自主创建 / 改进 / 审计 13+ 嵌入式技能，越用越懂硬件
自动检索项目上下文、芯片配置与历史失败记录，拒绝重复踩坑
通过 .fycode/project.toml 集中管理，烧录/调试/串口自动读取
# 板卡常驻参数集中配置
[board]
chip = "STM32H743VIT6"
target = "stm32"
flash_addr = "0x08000000"
[probe]
type = "stlink"
interface = "interface/stlink.cfg"
target_cfg = "target/stm32h7x.cfg"
[serial]
port = "COM3"
baudrate = 115200支持 Linux / Windows / macOS，开箱即用
bash install.sh自解压部署包，自动安装 Node.js 运行时及全部依赖
install-windows.bat一键安装，自动解压并配置环境
npm install -g fycode@latest需要 Node.js 24 (推荐) 或 Node 22.16+
pnpm add -g fycode@latest需要 Node.js 24 (推荐) 或 Node 22.16+
fycode onboardfycode onboard 会引导你完成：
fycode启动 TUI 交互界面fycode toolchain detect检测本地嵌入式工具链fycode cross-compile --target stm32交叉编译当前工程fycode flash --probe stlink烧录固件到目标芯片fycode serial-monitor --port COM3串口监控与调试fycode svd-query --chip STM32F407CMSIS-SVD 寄存器查询从个人开发者到企业级部署，灵活匹配
专业工程师 / 小团队
芯片原厂 / 车企 / 军工
高校实验室 / 科研机构
通用助手「不懂硬件」，传统工具「没有 AI」
| 对比维度 | 通用 AI 编程助手 | 传统 IDE/厂商工具 | fyfish code |
|---|---|---|---|
| 懂嵌入式硬件语境 | ✕ | 部分 | ✓ |
| 内建烧录/调试工具链 | ✕ | ✓（分散） | ✓（一体化） |
| HardFault/SVD 解码 | ✕ | ✕ | ✓ |
| 安全铁律/防烧砖 | ✕ | 手动 | ✓ 自动 |
| 终端原生/离线可用 | 部分 | 部分 | ✓ |
| Skills 自举可扩展 | ✕ | ✕ | ✓ |
| 芯片平台知识积累 | ✕ | ✕ | ✓ 核心壁垒 |
从辅助工具到数字工程师的演进之路