easyeda-agent: AI를 활용하여 EasyEDA Pro(嘉立创 EDA 전문판) 직접 조작

easyeda-agent는 EasyEDA Pro(嘉立创 EDA 전문판)의 AI 자동화 계층입니다. 사용자가 원하는 회로나 수정해야 할 문제를 직접 설명하면, Agent가 실제 프로젝트 데이터를 읽고 공식 eda.* API를 통해 작업을 완료하며, 쓰기 전후에 부품 식별, 핀 네트워크, 기하학적 구조, DRC(Design Rule Check) 및 저장 상태를 검사합니다.

주요 기능

Agent에게 직접 지시하는 방법

설치 후에는 CLI(Command Line Interface) 학습이 필요 없습니다. 요구사항과 필요한 파일을 Skill을 지원하는 Agent에 전달하고, easyeda-agent 사용을 명확히 지정하면 됩니다.

PDF로 부품 라이브러리 생성하기

요청하신 파일 ABC123.pdf를 기반으로 완전한 모델명 ABC123-QFN의 라이브러리를 easyeda-agent를 사용하여 구축해 주세요.
먼저 EasyEDA와 LCSC 라이브러리에 완전히 일치하는 부품이 있는지 확인하고, 없다면 전체 데이터시트를 읽어 주문 접미사, 핀 테이블, 패키지 치수도 및 권장 패드를 대조합니다. Symbol, Footprint, Device를 자동으로 생성하고 증거 페이지 번호를 보존해야 합니다.
... 

이 과정은 easyeda lib device validate --spec …을 사용하여 EasyEDA 사용 또는 수정 전에 데이터시트 증거, 기하학적 구조 및 핀 매핑을 검사하고, 이후 lib device build를 통해 완전한 자산을 생성합니다. 사양 계약(Specification Contract)은 데이터시트 기반 자동 라이브러리 구축을 참고하세요.

ESP32 최소 시스템 보드 제작하기

프로젝트 ceshi에서 easyeda-agent를 사용하여 ESP32-S3-WROOM-1 최소 시스템 보드를 완성해 주세요:
5V 전원 입력, 3V3으로 다운 컨버전, CH340 USB 다운로드, BOOT/RESET 버튼, GPIO 제어 LED 하나, 네 모서리 M3 고정 구멍. 4층 기판을 사용하고 GND를 내부 전기층으로 하며, 모듈 안테나 영역은 모든 층에서 keepout 처리해야 합니다.
... 

전체 실습 및 실제 스크린샷은 요구사항 문서 → ESP32-S3 4층 기판을 참고하세요.

현재 PCB의 실크스크린 조정하기

표준화된 회로도 기판 부품

easyeda-agent를 사용하여 현재 회로도를 스캔하고, 정확한 부품 번호가 없거나 비표준 심볼 또는 패키지가 일치하지 않는 부품을 목록으로 작성하세요.
표준 부품 라이브러리와 정확한 LCSC C 번호를 우선적으로 매칭하여 모델명, 패키지 및 핀을 확인한 후 교체하세요. 교체 시에는 부품 번호(位号), 위치 및 uniqueId를 유지해야 합니다. 만약 pinDiff가 비어있지 않다면, 연결을 수리하고 sch check를 다시 실행해야 합니다.

기존 프로젝트 검사 및 수정

easyeda-agent를 사용하여 현재 회로도와 PCB 전체를 포괄적으로 검사하세요. 먼저 실제 부품, 핀, 네트워크, 보드 프레임(板框), 적층 구조(叠层) 및 DRC 규칙을 읽어 들인 후, 확실하게 수정할 수 있는 문제부터 해결하세요. 스크린샷만 보고 연결을 추측하지 마세요. 모든 수정이 완료되면 대조 검사(对账)를 다시 수행하고, 연결/기하학/DRC 검사를 실행하며 저장한 다음, 여전히 사람이 결정해야 할 문제는 별도로 목록화하세요.

효과 시연

모듈 크기도에서 개인 사설 라이브러리로

요구사항: 사용자가 제공한 AS07-M1101D-SMA의 크기와 핀 다이어그램에 맞춰 개인 라이브러리를 생성합니다. 회로도는 쌍방향(double row) 핀의 좌우 순서를 유지해야 하며, 패키지 표기에는 핀 이름과 모델명을 기재하고, 실크스크린은 모두 모듈 커버리지 영역 외부에 배치하되 설치 후에도 확인 가능하도록 하고, 조여지고 정렬되어야 합니다.

결과: Symbol, Footprint 및 Device가 생성 및 저장되었으며, 8개 핀과 8개의 비아 패드 매핑이 확인되었습니다. 심볼 경계 상자(边框)의 폐쇄와 핀 방향을 수정했습니다. 패키지 왼쪽에는 두 열의 풋 번호 + 이름이 배치되었고, 열 간격은 약 0.5 mm이며, 프레임에 가까운 첫 번째 열은 프레임에서 약 0.6 mm 떨어져 있습니다. 모델명은 중앙에 프레임 외부에 상단에 위치하며, 실제 문자 경계 상자(文字包围盒)를 다시 읽어 들일 때 중복이 없습니다.
최종적으로 사용자의 요청에 따라 일반 핀 라인과 미정의 유형을 사용했으며, 첫 번째 핀은 독립적인 원형 마커를 사용했습니다. 사용자가 NC(No Connect)를 정리한 상태를 유지했습니다.

이번 입력은 사용자 크기도이며, 완전한 공장 PDF는 아닙니다. 패드와 부분 오프셋은 명확하게 가정한 계산을 적용했습니다.
실물 조립, 배치 인스턴스 및 PCB DRC를 아직 검증하지 않았으므로 생산 준비 완료 증명으로 간주할 수 없습니다.
원래 요구사항 그림, 패키지 미리보기, 사양 및 읽기 결과 보기.

嘉立创 PCB 초급 시험 제18회: AT32F415 레이아웃

현재의 파라미터화된 Layout 기준선은 69개의 부품, 15개의 기능 영역 및 90 × 50 mm의 모서리가 둥근 보드 프레임으로 구성되어 있으며, '예시 관계 → 알고리즘 후보 → AI 선택 → typed 쓰기 → 읽기'의 레이아웃 방법을 검증하는 데 사용됩니다. 이 그림은 레이아웃 단계 결과를 보여주며, 전체 보드 배선이나 생산 검사가 완료되었음을 의미하지 않습니다.

표준 시험 출처: 嘉立创 PCB 초급 시험 제18회입니다. 실행 단계, 매개변수 및 검증 경계는 260919 AT32F415 시험 실행 가이드를 참조하세요.

ESP32-S3 4층 보드 (과거 사례)

Agent가 모듈 배치, 모서리가 둥근 보드 프레임, 4층 전원 구조, 안테나 네트 클리어런스, 규칙 인식 배선, 구리 면 처리 및 실크스크린 정리를 포함하는 회로도에서 PCB까지의 전체 프로세스를 완료했습니다.

데이터 기반 회로도 조합

Agent는 먼저 로컬 데이터를 연결하여 부품, 핀, 네트워크를 확인하고, 모듈 내부 레이아웃을 계산한 후 EasyEDA에 다시 작성합니다. 분홍색 점선 상자는 독립적인 기능 영역을 나타내며, 적용(Apply) 후 개별 핀 단위로 순차적으로 읽어와 성공 여부를 판단하며, 단순히 스크린샷만으로는 판단하지 않습니다.

설치 및 사용 시작

easyeda-agent는 세 부분으로 구성됩니다: easyeda CLI/daemon, EasyEDA 내에서 실행되는 EDA Agent Connector, 그리고 AI 클라이언트에 설치되는 easyeda-agent Skill.

1. CLI와 Skill 설치

macOS / Linux:

curl -fsSL https://raw.githubusercontent.com/zhoushoujianwork/easyeda-agent/main/install.sh | bash

네이티브 Windows (Windows PowerShell 5.1 또는 PowerShell 7):

irm https://raw.githubusercontent.com/zhoushoujianwork/easyeda-agent/main/install.ps1 | iex

두 스크립트의 동작은 동일합니다: 먼저 checksums.txt를 가져와 모든 자산에 대해 SHA-256을 검증하고, CLI --version과 Skill metadata.version을 대조한 후 설치된 파일을 교체합니다. 환경 변수 EASYEDA_VERSION, EASYEDA_INSTALL_DIR, EASYEDA_INSTALL_SKILLS, EASYEDA_SKILL_PRESERVE, EASYEDA_GITHUB_PROXY 역시 유효합니다. 설치 프로그램은 Codex, Codex Desktop 및 Claude Code를 식별하고 연결기 다운로드 주소를 출력합니다.

install.ps1은 기본적으로 %USERPROFILE%\.localin에 설치되며 PATH를 임의로 변경하지 않습니다: 디렉토리가 사용자 PATH에 없는 경우 추가 명령만 출력하며, 자동으로 추가하려면 -AddToPath (파일로 다운로드하여 실행) 또는 $env:EASYEDA_ADD_TO_PATH=1 (파이프라인으로 실행)을 사용해야 합니다. 머신 레벨의 PATH는 항상 변경되지 않습니다. 수동 설치 단계는 빠른 시작을 참조하세요.

2. 커넥터 설치

立创插件市场에서 설치하거나, 최신 GitHub Release에서 easyeda-agent-connector.eext를 다운로드한 후 EasyEDA Pro의 확장 관리자에서 가져오기(Import) 합니다.

3. 프로젝트 열기 및 확인

대상 EasyEDA 프로젝트를 열고 설정 → 외부 상호 작용 허용을 활성화한 다음, 다음 명령어를 실행합니다:

easyeda health

이 명령어는 daemon, 커넥터, 버전, EasyEDA 호스트, 프로젝트 및 탭의 준비 상태를 항목별로 나열하며, 준비되지 않은 항목에 대해서는 다음 단계를 직접 제시합니다. daemon은 수동으로 상시 실행할 필요가 없습니다: 모든 easyeda 명령은 실행 중이 아니면 자동으로 백그라운드에서 시작됩니다(로그는 ~/.easyeda-agent/daemon.log; EASYEDA_NO_AUTOSTART=1로 비활성화 시). 동기화 검사가 필요한 경우에만 easyeda update --check --exit-code를 실행합니다.

프로젝트 메인라인은 EasyEDA Pro V4가 필요하며, 검증된 V4.1.60 또는 그 이후 버전의 V4로 업그레이드하는 것을 권장합니다. easyeda health는 hostCompatibility에서 호스트 제품 버전을 개별적으로 보고합니다; V3 환경은 먼저 업그레이드한 후 현장 쓰기를 해야 합니다. V4 적응 진행 상황과 경계는 V4 개발 대장을 참조하세요.

버전 차이는 진단 출력으로만 사용되며, 설계 동작의 허가로 간주되어서는 안 됩니다. 커넥터에 현재 동작이 부족하거나 프로토콜이 호환되지 않으면, 진단에 따라 해당 구성 요소를 업그레이드해야 합니다. Skill 내용이 업데이트되면 클라이언트에서 다시 로드하도록 해야 합니다.

더 자세한 설치, 업그레이드, 프록시 및 문제 해결 단계는 빠른 시작을 참조하세요.

왜 Agent에 적합한가

임의의 JavaScript를 편집기에 직접 넣기는 검토하기 어렵고, 일부 실패 여부를 확인하기도 어렵습니다. easyeda-agent는 자주 사용되는 기능을 명확한 입력과 출력을 가진 typed actions으로 캡슐화하고, 워크플로우에 추가합니다:

• 쓰기 전 목표 프로젝트, 페이지, 부품 식별 및 원본 데이터를 검사합니다;
• 쓰기 후 핀(pin), 네트워크(network), 기하학적 형태 및 객체 바인딩을 다시 읽어옵니다;
• 회로도 layout-lint → check → bridge-check → DRC 항목별 보고서의 사실과 차이점을 확인합니다;
• PCB는 실제 DRC 규칙을 사용하여 배치, 배선, 접지면(copper pour) 및 제조 검사를 수행합니다;
• 일부 성공, 시간 초과 또는 확인할 수 없는 결과에 대해 맹목적인 재시도를 중단합니다;
• 안전망으로 자동 저장하고, 핵심 노드는 명시적으로 저장합니다.

AI Agent / Skill
       │
       ▼
...

아키텍처 및 프로토콜 세부 사항은 아키텍처 설명과 프로토콜 설명을 참조하세요.

능력 경계

• 밀집된 보드의 완전한 미로 자동 배선에는 외부 Freerouting이 필요합니다. 내장 라우터는 짧은 선이나 명확한 국부 연결에 적합합니다.
• EasyEDA 확장 API는 프로그래밍 가능한 undo 기능을 제공하지 않습니다. 프로젝트는 원본 데이터, 쓰기 전 가드(guard), 다시 읽어오기 및 실패 롤백을 통해 위험을 낮춥니다.
• 제어 임피던스에 필요한 유전체 두께, Er, 구리 두께는 현재 eda.* API에서 완전히 읽어올 수 없으므로, 자동적으로 임피던스 적합성을 주장할 수 없습니다.
• PDF를 이용한 자동 라이브러리 구축은 여전히 특정 모델과 원본 제조사 증거에 의존합니다. 스캔이 모호하거나, 패키지 접미사가 불분명하거나, 패드(pad)가 부족하면 일시 중단하고 질문을 합니다.

현재 능력 및 경계는 기능 목록과 CLI 인덱스를 참조하세요. 과거 조사 및 실측 결과는 이력 증거 인덱스에 모여 있습니다.

개발 및 기여

• PCB 알고리즘 기여: 네 개의 공개 Go 패키지, 수학 문제 및 인정 가능한 작업; make pcb-solver-test는 EDA 없이 오프라인 실행이 가능합니다.
• 문서 탐색 및 정보 귀속: docs/README.md
• 크로스 프로젝트 조회, Skill 유지보수 및 다중 클라이언트 호환성: Agent 협업 설계
• 개발 환경: docs/dev-environment.md
• 회로 블록 기여: standard-blocks-contributing.md
• Skill 진입점: .agents/skills/easyeda-agent/SKILL.md
• 저장소 구조 및 개발 규칙: AGENTS.md

嘉立创 EDA 전문판의 개방형 확장 인터페이스에 감사드리며, 다음에도 감사를 표합니다:
@jlceda/pro-api-types,
Freerouting 및
EasyEDA 공식 오픈소스 확장이 제공하는 기반과 참고 자료에.

라이선스

MIT. extension/src/beautify/에서 이식된 Easy_EDA_PCB_Beautify 파일은 Apache-2.0을 사용하며, 자세한 내용은 NOTICE를 참조하세요.

Star 기록

모든 star에 감사드립니다.