一站式 AI 驱动的嵌入式硬件方案自动生成平台，支持 ESP32 / STM32 系列及自定义芯片。 从需求描述到硬件方案、工程代码、执行流程图，全链路自动化。
MetaCore AI 是一个纯 Web 端的 AI 硬件架构工程师平台。你只需要用自然语言描述硬件需求（比如"做一个 AI 桌宠，需要 OLED 显示表情、播放声音、检测温湿度"），平台就会通过 AI 自动完成：
- 硬件方案设计 — 引脚分配、BOM 清单、接线对照表
- 可视化引脚图 — SVG 芯片引脚图，悬停查看连接详情，支持暗色/亮色主题
- 模块化工程代码 — 完整可编译的 C/C++ 工程（ESP-IDF / Arduino / PlatformIO）
- AI 自检验证 — 代码生成后自动检查与硬件方案的一致性
- 代码执行流程图 — 自动分析代码生成可交互的流程图，节点支持自由拖动
- AI 问答助手 — 基于项目上下文的硬件工程顾问
- 自定义芯片 — 三种模式添加任意芯片（AI 识图 / AI 助填 / 手动配置）
- 一键导出 — ZIP 工程包 + 专业 PDF 文档
无需安装任何桌面软件，浏览器打开即用。所有数据保存在本地浏览器中，不经过任何中间服务器。
| 功能模块 | 说明 |
|---|---|
| 需求生成 | 输入自然语言需求，AI 基于芯片完整技术规格生成精准硬件方案 |
| 引脚可视化 | SVG 芯片图，支持预置芯片 + 自定义芯片，暗色/亮色主题适配 |
| 代码生成 | 根据硬件方案生成模块化 C/C++ 工程代码，附带 AI 自检 |
| 流程图 | 自动分析代码执行流程，生成可交互节点图，支持拖动布局 |
| AI 问答 | 流程图页内置 AI 聊天面板，硬件工程顾问角色 |
| 芯片管理 | 预置 5 种芯片（含 STM32F103-KIT）+ 支持三种方式添加自定义芯片 |
| 驱动模板 | 内置 8 个验证驱动（SSD1306、DHT、AHT20、WS2812、HC-SR04、蜂鸣器、舵机、DRV8833），代码生成时自动匹配注入，可直接上板编译 |
| 外设库浏览 | 侧边栏「外设库」页，按接口类型筛选，折叠展开查看驱动代码 |
| 手动预选驱动 | 生成方案前可手动勾选外设驱动，与自动匹配结果合并注入 |
| 一键式生成 | 可选开关，开启后点「生成方案」自动串行完成方案→代码→流程图三步 |
| 工程格式 | 支持 ESP-IDF / Arduino / PlatformIO / STM32CubeIDE 四种格式 |
| AI 协议 | OpenAI 服务商自动使用 Responses API，其他服务商保持 Chat Completions 兼容 |
| 项目管理 | 多项目创建、加载、删除，数据本地持久化 |
| 导出 | ZIP 工程包下载 + PDF 专业文档导出 |
| 主题 | 暗色 / 亮色主题一键切换，全组件适配 |
| 技术 | 用途 |
|---|---|
| React 18 + TypeScript | UI 框架 |
| Vite 5 | 构建工具，开发热更新 |
| Tailwind CSS 3 | 原子化 CSS 样式 |
| Zustand | 轻量状态管理（含 persist 持久化） |
| React Router 6 | 前端路由（HashRouter） |
| ReactFlow | 流程图可视化 |
| Monaco Editor | 代码预览编辑器（VS Code 同款） |
| @react-pdf/renderer | 浏览器端 PDF 生成 |
| pdfjs-dist | 浏览器端 PDF 文本提取（芯片 Datasheet 解析） |
| JSZip | 浏览器端 ZIP 打包下载 |
| Lucide React | 图标库 |
- Node.js >= 18
- npm >= 9（或 pnpm / yarn）
# 克隆项目
git clone https://github.com/你的用户名/MetaCore-AI.git
cd MetaCore-AI
# 安装依赖
npm install
# 启动开发服务器
npm run dev或者 Windows 用户直接双击 start.bat 一键启动（自动检测依赖、安装缺失包并打开浏览器）。
26.3.27更改bat文件，添加安装node.js功能（如果未安装node.js，会自动安装最新版本，实验性功能） 安装 Node.js 需要管理员权限，确保以管理员身份运行批处理文件
npm run build将 dist/ 目录部署到任意静态服务器即可。所有 AI 调用直接从浏览器发起，无需后端服务。
src/
├── components/
│ ├── layout/ # 布局组件（Sidebar、MainLayout）
│ ├── pages/ # 页面组件（Requirement、Codegen、Flow、Settings、Help、About）
│ ├── requirement/ # 需求页子组件（PinDiagram、PinTable、BOMTable、WiringTable）
│ ├── codegen/ # 代码页子组件（FileTree、CodePreview、ExportButtons）
│ ├── flow/ # 流程图子组件（FlowCanvas、AIChatPanel）
│ ├── chips/ # 芯片管理组件（ChipManager、PdfParseMode、AssistedMode、FormMode）
│ ├── settings/ # 设置页子组件（AIServiceForm、ServiceCard）
│ └── project/ # 项目管理组件（ProjectManager）
├── data/
│ ├── chipSpecs.ts # 芯片知识库（4 种预置芯片完整技术规格）
│ └── codeTemplates.ts # 代码模板库（3 种框架骨架 + 最佳实践）
├── services/
│ ├── ai/
│ │ ├── client.ts # AI 调用客户端（支持多服务商 + temperature 控制）
│ │ └── prompts.ts # AI Prompt 模板（system+user 双消息 + 芯片规格注入）
│ ├── export/
│ │ ├── zipExport.ts # ZIP 导出
│ │ └── pdfExport.tsx# PDF 导出
│ └── pdf/
│ └── pdfExtractor.ts # PDF 文本提取（芯片 Datasheet 解析）
├── store/
│ ├── projectStore.ts # 项目状态管理
│ ├── aiConfigStore.ts # AI 服务配置管理
│ ├── chipStore.ts # 自定义芯片管理
│ └── themeStore.ts # 主题状态管理
├── types/
│ ├── hardware.ts # 硬件相关类型（ChipSpec、GpioPin、PeripheralBus 等）
│ ├── project.ts # 项目相关类型
│ └── ai.ts # AI 服务相关类型
├── lib/
│ └── utils.ts # 工具函数
└── App.tsx # 路由配置
输入自然语言需求，选择目标芯片和工程格式，AI 自动生成：
- 硬件方案概述
- 引脚分配表 / SVG 引脚图（可切换视图）
- BOM 物料清单（含预估参考价）
- 接线对照表
方案生成后会显示精准度提示：生成结果的准确性与所选 AI 模型性能及芯片参数完整度直接相关。
基于硬件方案生成模块化工程代码：
- 文件树浏览 + Monaco 代码预览
- 生成后自动进行 AI 自检，检查代码与方案的一致性
- 支持导出 ZIP / PDF
自动分析代码执行流程：
- 可交互节点图，点击查看关联代码
- 节点支持自由拖动调整布局
- 内置 AI 问答面板，基于项目上下文回答问题
管理预置和自定义芯片，详见下方「自定义芯片」章节。
配置 AI 服务商，支持：DeepSeek、硅基流动、通义千问、OpenAI、Ollama（本地）。
快速开始教程 + 更新日志。
平台介绍、技术栈、版权信息、免责声明。
除了预置的 4 种芯片（ESP32、ESP32-S3、STM32F103、STM32F4），你可以通过三种方式添加任意芯片：
| 模式 | 说明 | 适用场景 |
|---|---|---|
| AI 识图 | 上传芯片 PDF Datasheet，AI 自动提取技术参数 | 有 Datasheet，想快速录入 |
| AI 助填 | 上传 PDF 预填表单 + 手动微调 | 想在 AI 基础上精确调整 |
| 自由配置 | 4 步分步表单手动填写所有参数 | 无 PDF 或需要完全自定义 |
自定义芯片录入的参数包括：
- 基本信息（名称、架构、Flash、SRAM、主频、电压）
- GPIO 引脚列表（引脚号、复用功能、是否仅输入）
- 外设总线（I2C/SPI/UART/I2S 等默认引脚）
- 启动受限引脚、关键限制条件
自定义芯片的技术规格会自动注入 AI 方案生成流程，确保生成结果的精准度。
在「设置」页面添加 AI 服务：
| 服务商 | 说明 |
|---|---|
| DeepSeek | 国产大模型，性价比高，推荐 deepseek-chat |
| 硅基流动 | 聚合平台，支持多种模型 |
| 通义千问 | 阿里云大模型 |
| OpenAI | GPT 系列，需海外网络 |
| Ollama | 本地部署，无需 API Key，需先启动 ollama serve |
配置步骤：
- 选择服务商，填入 API Key
- 点击「测试连接」验证
- 设为活跃服务
API Key 仅保存在你的浏览器 localStorage 中，不会上传到任何服务器。AI 调用直接从浏览器发送至对应服务商。
描述需求 → 选择芯片/格式 → 生成方案 → 生成代码 → 查看流程图 → 导出
- 在「设置」页配置 AI 服务
- 在「方案」页输入需求，选择芯片和工程格式
- 点击「生成方案」，查看引脚图、BOM、接线表
- 点击「生成工程代码」，AI 自动生成 + 自检
- 在「流程图」页查看代码执行逻辑
- 导出 ZIP 工程包或 PDF 文档
- 包含完整工程目录结构
- 可直接导入 VS Code + ESP-IDF / Arduino IDE / PlatformIO
- 包含硬件方案、引脚分配、BOM 清单、接线表、代码清单
- 专业排版，适合打印和存档
- 内置中文字体（SimHei），完美支持中文内容导出
点击侧边栏底部的太阳/月亮图标切换暗色/亮色主题。所有组件（包括引脚图、流程图、代码编辑器）均已适配双主题。
-
AI 生成内容 — 所有硬件方案、代码、流程图均由 AI 自动生成，仅供学习和参考。生成结果的准确性与所选 AI 模型性能及芯片参数完整度直接相关。用户在实际应用前应自行验证准确性和安全性。
-
价格信息 — BOM 清单中的价格均为 AI 预估参考价，不构成任何报价承诺，请以实际询价为准。
-
安全与合规 — 生成内容未经安全认证或合规审查。用于商业产品、医疗设备、车载系统等安全关键领域前，必须进行专业评审。因使用本平台生成内容导致的任何损失，开发者不承担法律责任。
-
数据隐私 — 所有数据保存在用户本地浏览器中，平台不收集、存储或处理任何用户数据。AI 调用直接发送至用户配置的服务商，用户应自行评估其数据隐私政策。
-
知识产权 — AI 生成的代码和方案归用户所有，但可能无意中包含与第三方知识产权相似的部分，用户在商业使用前应自行审查。
- 检查「设置」页的 AI 服务是否已配置 API Key 并设为活跃
- 检查网络连接是否正常
- 如果使用 Ollama，确保本地服务已启动（
ollama serve） - 尝试切换其他 AI 服务商
- 使用高性能 AI 模型（如 DeepSeek V3、GPT-4）效果更好
- 在「芯片管理」中补充完善芯片技术规格，参数越完整精准度越高
- 尝试更详细地描述需求，包括具体的传感器型号、通信方式等
- AI 生成的代码以完整可编译为目标，但可能需要根据实际硬件微调
- 代码生成后会自动进行 AI 自检，如有问题会在顶栏提示
- 建议下载 ZIP 后在对应 IDE 中打开检查
- 所有数据（项目、AI 配置、自定义芯片、主题偏好）保存在浏览器 localStorage 中
- 清除浏览器数据会丢失所有项目，建议重要项目及时导出
- 预置：ESP32（38 Pin）、ESP32-S3（38 Pin）、STM32F103（48 Pin）、STM32F4（100 Pin）
- 自定义：支持通过 AI 识图、AI 助填或手动配置添加任意芯片
- 可以。运行
npm run build后将dist/目录部署到任意静态服务器即可 - 所有 AI 调用直接从浏览器发起，无需后端服务
当前版本：v1.5.6
本项目由开发者 Leo 独立设计与开发。所有代码、设计、文档及相关知识产权均归 Leo 所有。
© 2026 Leo. All rights reserved.