# Eide

> EIDE 工程构建工具，用于操作 EIDE（Embedded IDE）管理的嵌入式工程，支持 build/rebuild/clean/flash/reload/add-src-dir/check 子命令。通过 EIDE MCP Server（默认 http://127.0.0.1:8940/mcp）与 EIDE 扩展交互。当用户提到 EIDE、 Embedded IDE、编译 EIDE、EIDE 构建、EIDE 烧录、EIDE 重建时自动触发，也兼容 /eide 显式调用。即使用户只是说"用 EIDE 编译一下"或"EIDE 烧录"，只要上下文 涉及 EIDE 管理工程的构建或烧录就应触发此 skill。

- Skill: `alexiaqaq/eide` (Agent Skill, multi-file: 8 files)
- Install (CLI): `npx skillmds@latest add alexiaqaq/eide`
- Raw SKILL.md: https://api.skillmd.com/api/skills/alexiaqaq/eide/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: AlexiaQAQ (https://skillmd.com/u/alexiaqaq)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/alexiaqaq/eide

---


# EIDE 工程构建工具

本 skill 通过 EIDE MCP Server 提供嵌入式工程的构建、重建、清理、烧录能力。

UID 自动检测（无需额外配置）：
- 优先用 `--uid` 参数
- 否则从工程目录下的 `.eide/eide.yml` 自动读取

## 子命令

| 子命令 | 用途 | 风险 |
|--------|------|------|
| `check` | 检测 MCP 服务器连通性 | 低 |
| `build` | 增量编译（自动先 reload 同步 Keil 更改） | 中 |
| `rebuild` | 全量重建（自动先 reload 同步 Keil 更改） | 中 |
| `reload` | 重载工程：同步 Keil uvproj 的更改到 EIDE 模型 | 低 |
| `add-src-dir <path>` | 添加源码目录，该目录下的 .c/.cpp 文件将参与编译 | 中 |
| `clean` | 清理构建产物 | 高 |
| `flash` | 烧录固件到 MCU | 高 |

## 参数

全局可选参数（放在子命令之前）：

| 参数 | 说明 |
|------|------|
| `--mcp-url` | MCP 服务器 URL（默认 `http://127.0.0.1:8940/mcp`） |
| `--uid` | Project UID（不指定则从 `.eide/eide.yml` 自动检测） |
| `--workspace` | 工程根目录（默认当前目录，用于查找 `.eide/eide.yml`） |

build / rebuild 子命令额外支持：

| 参数 | 说明 |
|------|------|
| `--no-reload` | 跳过构建前的自动 reload（默认自动 reload） |

flash 子命令额外支持：

| 参数 | 说明 |
|------|------|
| `--erase-all` | 烧录前擦除全片 |
| `--force` | 跳过确认提示（CI/CD 等非交互式环境需要） |

## 执行流程

1. 从 `--uid` 参数或 `.eide/eide.yml` 自动获取 UID
2. 执行 `POST /mcp` → MCP initialize → 获取 `mcp-session-id`
3. build/rebuild 时 shared session 内依次执行 reload → 编译
4. 解析 SSE 响应中的 JSON，提取错误/警告数、产物路径
5. 以结构化 JSON 返回结果

## 注意事项

- MCP 服务器由 VSCode 的 EIDE 扩展提供，需确保 VSCode 中 **EIDE.MCP.Server 已启用**（端口默认 8940）
- MCP 服务器不在运行时，`check` 子命令会返回连接失败
- 构建日志回显中包含错误/警告统计和产物路径
- UID 自动从 `.eide/eide.yml` 读取，无需手动配置或执行单独的 `uid` 命令
- `flash` 烧录前建议确认板子已连接

## 脚本调用

```bash
cd <workspace>

# 检查连通性
python <skill-dir>/scripts/eide.py check

# 增量编译（UID 自动从 .eide/eide.yml 读取）
python <skill-dir>/scripts/eide.py build

# 全量重建
python <skill-dir>/scripts/eide.py rebuild

# 清理
python <skill-dir>/scripts/eide.py clean

# 烧录（--erase-all 放在子命令后面）
python <skill-dir>/scripts/eide.py flash --erase-all

# 添加源码目录（路径相对 workspace）
python <skill-dir>/scripts/eide.py add-src-dir drivers

# 重载工程（同步 Keil uvproj 更改）
python <skill-dir>/scripts/eide.py reload
```