zhoushoujianwork/easyeda-agent

嘉立创EDA专业版(EasyEDA Pro)自动化：给 AI harness 装上画板的「手」—— 一套 typed 原理图/PCB 动作，CLI / Agent Skill / stdio MCP 三形态融合接入。承接嘉立创「不以卖板赚钱，以培养中国工程师为己任」 | EasyEDA Pro automation: the hands of your AI harness — typed schematic/PCB actions via CLI, Agent Skill and stdio MCP.

easyeda‑agent란?

easyeda‑agent는 EasyEDA Pro(JLC EDA 온라인 설계 제품군의 전문가 버전)를 위한 AI 기반 자동화 계층입니다. 자연어로 AI 어시스턴트와 대화하고 데이터시트 읽기, 심볼/풋프린트 생성, 회로도 그리기, PCB 레이아웃, 실크스크린 조정, DRC/DFM 검사 실행, 마지막으로 설계 저장을 EasyEDA가 공개하는 공식 eda.* API를 통해 수행할 수 있습니다.

핵심 기능

영역	에이전트가 할 수 있는 일
라이브러리 작성	PDF 또는 기계 도면에서 부품 번호, 핀 배치, 패키지 치수를 추출한 다음 개인 EasyEDA 라이브러리에 완전한 심볼, 풋프린트, 디바이스(선택적 3D 모델)를 생성하고, 쓰기 전에 증거 페이지와 검증을 제공합니다.
엔드투엔드 보드 생성	자연어 요구 사항(예: "ESP32‑S3 최소 시스템, 4층, USB‑C 다운로드, 전원 레일, 안테나용 키프아웃")이 주어지면 에이전트가 부품을 선택하고, 회로도를 구축하고, 보드를 분할하고, 구성 요소를 배치하고, 트레이스를 라우팅하고, 구리를 붓고, 실크스크린을 생성하고, 저장 전에 전체 DRC/DFM을 실행합니다.
구성 요소 표준화	기존 회로도를 스캔하여 비표준 부품을 찾고, 핀 번호, 위치 및 연결된 PCB 인스턴스를 유지하면서 정확한 LCSC C 번호 또는 공식 풋프린트로 교체합니다.
회로도 정리	플로팅 넷, 단락, 페이지 간 넷 이름, NC 핀, 핀 번호 불일치를 감지하고 회로도를 자동으로 재배열하고 검사를 다시 실행할 수 있습니다.
PCB 레이아웃 및 라우팅	모듈 인식 자동 배치, 보드 외곽선 맞춤, 규칙 인식 짧은 트레이스 라우팅, 비아 삽입, 구리 붓기, 4층 전원 평면 생성, 안테나 키프아웃 등.
실크스크린 편집	실크스크린 항목을 패드, 구성 요소 및 키프아웃에서 이동하고, 보드 노트, 커넥터 이름, LED 극성 마커 및 SVG 로고를 추가합니다.
검증된 블록 재사용	일반적인 회로(CH340, ESP32, 전원 레귤레이터, USB 허브 등)의 내장 라이브러리를 설계에 드롭하고 자동으로 배선하고 회로도와 조정할 수 있습니다.
검증 및 전달	BOM, 넷리스트, 제조 파일, 스크린샷, 감사 로그를 생성하고 각 단계 후에 명시적 저장을 수행합니다.

사용 방법

설치 EasyEDA CLI/데몬 및 AI 스킬을 한 줄 스크립트(macOS/Linux용 install.sh 또는 Windows용 install.ps1)로 설치합니다. 설치 프로그램은 체크섬을 확인하고 환경 변수를 설정하며 보유한 LLM 클라이언트(Codex, Claude 등)를 감지합니다.
커넥터 추가 JLC 플러그인 마켓에서 EasyEDA Pro에 추가(또는 GitHub 릴리스에서 .eext 파일 다운로드)하고 EasyEDA 설정에서 외부 상호 작용 허용을 활성화합니다.
데몬 시작: easyeda daemon start.
에이전트와 대화 – 지원되는 채팅 클라이언트를 통해 또는 스킬에 프롬프트를 제공합니다. README에는 PDF에서 라이브러리 생성, ESP32‑S3 보드 구축, 실크스크린 수정, 구성 요소 표준화 또는 전체 설계 감사를 위한 예제 프롬프트가 제공됩니다.
에이전트는 요청을 타입화된 작업으로 변환하고 CLI가 커넥터로 보내며, 커넥터는 공식 eda.* API를 호출하여 프로젝트를 읽고 씁니다. 각 작업은 사전 검사와 사후 읽기 검증으로 보호되며, 데몬은 성공적인 단계 후에 프로젝트를 자동 저장합니다.

설치 스냅샷

# macOS / Linux
curl -fsSL https://raw.githubusercontent.com/zhoushoujianwork/easyeda-agent/main/install.sh | bash
# Windows PowerShell
irm https://raw.githubusercontent.com/zhoushoujianwork/easyeda-agent/main/install.ps1 | iex

스크립트는 SHA‑256 체크섬을 확인하고, CLI를 $HOME/.local/bin(Windows에서는 %USERPROFILE%\.local\bin)에 설치하고, 스킬 파일을 LLM 클라이언트가 로드할 수 있는 위치에 배치합니다.

현재 제한 사항

라우팅: 완전히 밀집된 미로 스타일 자동 라우팅은 Freerouting과 같은 외부 도구가 필요합니다. 내장 라우터는 짧고 명확한 연결을 처리합니다.
실행 취소: EasyEDA의 API에는 프로그래밍 방식 실행 취소가 없으므로 에이전트는 쓰기 전 가드, 쓰기 후 검증 및 명시적 저장에 의존하여 설계를 안전하게 유지합니다.
임피던스: API가 모든 스택업 매개변수(유전 상수, 구리 두께)를 읽을 수 없으므로 에이전트는 임피던스 제어 트레이스를 자동으로 보장할 수 없습니다.
PDF 라이브러리 생성: PDF에 명확한 모델 번호, 핀 테이블 및 패드 치수가 포함된 경우 가장 잘 작동합니다. 모호하거나 저품질 스캔은 에이전트가 일시 중지하고 설명을 요청하게 합니다.

자세히 알아보기

빠른 시작 가이드 – docs/quick-start.md
CLI 참조 – docs/cli/schematic.md 및 docs/cli/pcb.md
기능 목록 – docs/FEATURES.md
아키텍처 및 프로토콜 – docs/architecture.md / docs/protocol.md
쇼케이스 프로젝트 – ESP32‑S3 4층 보드, AS07‑M1101D SMA 라이브러리 생성, JLC PCB 시험 레이아웃 등.

라이선스

MIT(뷰티파이 모듈에는 일부 Apache‑2.0 구성 요소 포함).

요약

easyeda‑agent는 LLM이 EasyEDA Pro 내에서 설계 어시스턴트로 작동하게 합니다. 원하는 것을 설명하면 데이터시트를 읽고, 라이브러리를 구축하고, 회로도를 그리고, PCB를 배치 및 라우팅하고, 실크스크린을 정리하고, 검사를 실행하고, 결과를 저장합니다 – 모두 타입화된 작업 API를 통해 워크플로를 안전하고 감사 가능하게 유지합니다.