# eai-coder

**Repository Path**: eai-code/eai-coder

## Basic Information

- **Project Name**: eai-coder
- **Description**: ● eai-coder(Embedded + Easy + AI + Coder)— 给通用 AI 助手赋能嵌入式开发能力的独立中间件框架。核心是拉平不同 AI 模型的能力差,让任意 AI 都能完成嵌入式开发全流程。采用分层架构 + 可插拔 adapter,归属 eai-code生态,多组件协作
- **Primary Language**: Unknown
- **License**: GPL-3.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-23
- **Last Updated**: 2026-07-29

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# eai-coder

> **eai-coder(Embedded + Easy + AI + Coder)— 给通用 AI 助手赋能嵌入式开发能力的独立中间件框架。核心是拉平不同 AI 模型的能力差,让任意 AI 都能完成嵌入式开发全流程。采用分层架构 + 可插拔 adapter,归属 eai-code 生态,多组件协作。**

📖 完整理念 → [docs/00-理念.md](docs/00-理念.md)

---

## 📌 状态

🚧 **MVP 开发中**(2026-07-23 启动)

当前模式:**用户授权 PM(AI 助手)自主推进**(用户休息期间)
- 自主执行期决策记录 → [`docs/05-自主执行期决策记录.md`](docs/05-自主执行期决策记录.md)
- 工作状态 → [`.ai/WORKSTATE.md`](.ai/WORKSTATE.md)

---

## 🎯 定位

eai-coder = 夹在「通用 AI 助手」和「具体嵌入式工具链」之间的**独立中间件框架**:
- 给 AI 赋能嵌入式领域知识(寄存器 / 外设 / 调试 / datasheet)
- **拉平不同 AI 模型的能力差**(弱 AI + eai-coder ≈ 强 AI 裸跑)

**核心差异化**:让 AI 能理解并生成"性能压榨"代码(中断 / DMA / 时序 / 寄存器位操作 / 内存对齐)——普通 AI 不懂的部分。

---

## 🏗️ 架构

**两层 + 可插拔 adapter**:

```
                    ┌────────────────────────────┐
                    │   eai-coder 核心(独立)    │
                    │   · 上层:嵌入式框架业务    │
                    │     (领域 + AI 能力拉平)   │
                    │   · 下层:工具链 adapter    │
                    └────────────────────────────┘
                       ↑       ↑           ↑
                ┌──────┘       │           └──────┐
          [CLI 接口]      [VSCode 插件]      [MCP/协议接口]
                                                   │
                                       ┌───────────┴───────────┐
                                 [Claude Code]          [Codex / 本地模型]
```

**adapter 家族**(可插拔):
- **EDA 源**:嘉立创 EDA(优先)/ KiCad(兼容)
- **Datasheet 源**:PDF + MinerU / 在线 API
- **工具链**:eide(优先)/ mdk / cmake

详见 [`docs/01-项目定位讨论.md`](docs/01-项目定位讨论.md)。

---

## 🚀 MVP 场景

**候选 1 + 候选 2 组合**:
- **候选 1**:「需求 / 原理图 → 工程」自动化(建项 + 引脚映射 + 文件结构)
- **候选 2**:Datasheet RAG + 配置生成(查手册 + 生成寄存器代码)

**锚定场景**:
> 用户讲「做一个 STM32F103 + SHT30 温湿度采集装置」→ eai-coder 自动:
> 1. 建项(选芯片 / 工具链 / 文件结构)
> 2. 引脚配置(原理图描述 → 引脚命名映射)
> 3. 寄存器初始化(USART / I2C 时序)
> 4. Datasheet 查询(SHT30 通信协议)
> 5. 生成骨架代码 + 驱动模板

详见 [`docs/04-嵌入式工程师痛点清单.md`](docs/04-嵌入式工程师痛点清单.md)。

---

## 🛠️ 技术栈

- **TypeScript / Node.js**(决策 3 待用户正式敲定,自主执行期默认)
- MCP SDK / VSCode API(后续)

---

## 📚 文档

所有讨论与决策沉淀在 `docs/`:

| 文件 | 内容 | 状态 |
|---|---|---|
| [01-项目定位讨论.md](docs/01-项目定位讨论.md) | 定位 / 架构 / 独立性 | ✅ 锁定 |
| [02-可行性讨论.md](docs/02-可行性讨论.md) | 可行性 6 维 + 3 大风险 | 🔄 讨论中 |
| [03-待敲定决策清单.md](docs/03-待敲定决策清单.md) | 4 个决策簇追踪 | 2/4 已敲定 |
| [04-嵌入式工程师痛点清单.md](docs/04-嵌入式工程师痛点清单.md) | 12+1 痛点 + MVP 候选 | ✅ 已输出 |
| [05-自主执行期决策记录.md](docs/05-自主执行期决策记录.md) | PM 自主期替用户做的决策 | 🔄 持续更新 |

过程状态在 `.ai/`(WORKSTATE / TASKS / changelog / requirements / errors)。

---

## 📋 开发模式

- **一人开发**,兴趣导向,无 deadline
- **质量标准**:真解决嵌入式工程师痛点(不是玩具)
- **长期愿景**:全谱系用户(个人 / 团队 / 开源社区)

---

## License

(待定,用户决策)