# eai-exporters

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

## Basic Information

- **Project Name**: eai-exporters
- **Description**: EDA 导出插件层 | 嘉立创EDA · KiCad · Altium Designer
- **Primary Language**: Unknown
- **License**: GPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

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

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# eai-exporters

> **eai-code 生态的 EDA 导出插件聚合层**:把 EDA 工具(嘉立创EDA / KiCad / Altium)的原理图数据导出为 eai-coder YML 对接表。

[![status](https://img.shields.io/badge/status-POC%20v0.3.2-blue)](.ai/WORKSTATE.md) [![license](https://img.shields.io/badge/license-Apache--2.0-green)](LICENSE) [![ecosystem](https://img.shields.io/badge/eai--code-ecosystem-orange)](https://gitee.com/eai-code)

---

## 🎯 当前状态(v0.3.2 POC 已验证)

嘉立创EDA 专业版插件(**eai-exporter-jlceda**)POC 完成:

- ✅ **扩展(.eext)**:菜单导出 YML + 开启/断开交互
- ✅ **自带 bridge-server**:HTTP `GET /yml` 端点,独立于 Run API Gateway
- ✅ **多芯片导出**:主控 + 其他 IC(LDO/传感器/通信/光耦/ESD...)自动 role 分类
- ✅ **datasheets 数组**:每个 IC 附手册链接(为 MinerU 准备)
- ✅ **板级纯粹性**:YML 只含当前板,不含工程级信息
- ✅ **性能**:~78ms 响应

KiCad / Altium 插件待开发(将复用 jlceda 的 bridge 模式)。

---

## 🚀 快速开始(30 秒)

```bash
# 1. 拉仓库 + 启动 bridge
git clone https://gitee.com/eai-code/eai-exporters.git
cd eai-exporters/plugins/jlceda
npm install
npm run bridge          # → http://localhost:49630

# 2. EDA 端
# 导入 release/eai-exporter-jlceda-poc_v0.3.2.eext → 启用 + 勾"外部交互"
# 进原理图 → EAI Exporter 菜单 → 开启交互

# 3. 外部拿 YML
curl http://localhost:49630/yml > board.yml
```

详见 [架构文档 §0](docs/architecture.md#0-tldr30-秒上手)。

---

## 📚 文档索引

### 给消费者(eai-coder / 集成方)
- **[HTTP API 规格](docs/api/http-api.md)** — bridge-server 端点(GET /yml, /health)
- **[YML Schema 契约](docs/api/yml-schema.md)** — 完整字段定义 + 校验规则 + 升级指南

### 给贡献者(开发/新成员)
- **[框架架构](docs/architecture.md)** — 整体架构 + 目录结构 + 数据流 + 开发指南
- **[调研整合报告](docs/research/00-integrated-findings.md)** — POC 决策依据(3 专家调研交叉验证)
- **[PM 工作状态](.ai/WORKSTATE.md)** — 当前进度 + 中断点
- **[META 规则汇总](.ai/errors/distilled/meta-rules.md)** — 4 条跨项目经验(API 契约/外设识别/作用域隔离/状态管理)

### 调研子报告(深度参考)
- [嘉立创EDA 全景](docs/research/jlceda-plugin-research.md)
- [.eext 格式 + 插件市场](docs/research/jlceda-pro-eext-plugin.md)
- [eai-coder 生态契约](docs/research/eai-coder-contract.md)

---

## 🏗️ 仓库结构

```
eai-exporters/
├─ plugins/jlceda/         嘉立创EDA 专业版插件
│  ├─ src/index.ts         扩展主代码(菜单+转换+交互)
│  ├─ bridge/              自带 bridge-server(HTTP+WS)
│  └─ scripts/             开发期工具(Python)
├─ release/                可导入的 .eext 产物
├─ samples/                真实导出样本(.yml)
├─ docs/                   文档层(api/architecture/research)
├─ .ai/                    coordination 层(状态+任务+错误知识库)
└─ .claude/agent-memory/   PM 跨会话记忆
```

---

## 🌐 eai-code 生态

本仓库是 eai-code 生态 7 个职责层之一:

| 层 | 仓库 | 角色 |
|---|---|---|
| 核心 | [eai-coder](https://gitee.com/eai-code/eai-coder) | 大脑(消费 YML) |
| **EDA 导出** | **eai-exporters**(本仓库) | **眼睛(EDA → YML)** |
| 工具链 | [eai-adapters](https://gitee.com/eai-code/eai-adapters) | 手(编译/烧录) |
| 数据源 | [eai-data](https://gitee.com/eai-code/eai-data) | 记忆(datasheet) |
| 规范 | [eai-spec](https://gitee.com/eai-code/eai-spec) | 宪法(协议) |

完整生态蓝图:[eai-coder/docs/11](https://gitee.com/eai-code/eai-coder/blob/main/docs/11-生态蓝图与项目计划.md)。

---

## 📝 License

Apache-2.0(与嘉立创EDA 官方扩展 SDK 一致)。

## 🤝 贡献

- 问题/建议:[提 issue](https://gitee.com/eai-code/eai-exporters/issues)
- 开发指南:[docs/architecture.md §8](docs/architecture.md#8-开发指南)