easyeda-agent

easyeda-agentは、嘉立创EDAプロ版（EasyEDA Pro）向けのAI自動化ツールであり、AIエージェントがEDAソフトウェアを直接操作し、データシートからのライブラリ作成からPCB製造検査までの完全なフローを実現することを目的としている。CLI、Agent Skill、stdio MCPの3つの形式で統合され、型付けされた回路図・PCB操作を提供し、書き込み前後の検証と監査を重視する。 ## 中核機能 - **部品ライブラリ作成**：PDFや寸法図から型番、ピン、パッケージ情報を読み取り、Symbol、Footprint、Device、およびオプションの3Dモデルを自動作成し、ソースとピンマッピングを検証する。 - **回路図設計**：自然言語の要件から部品選定、回路図描画、標準化置換、接続チェックと修復を実行する。 - **PCBレイアウト配線**：モジュール認識による自動レイアウト、基板枠への適合、ルール認識配線、ビア、銅箔充填、多層電源プレーン、アンテナキープアウトをサポート。 - **シルク整理**：パッド、部品本体、基板枠などを自動回避し、基板注記、インターフェース名、LED極性、SVGロゴを追加する。 - **回路再利用**：内蔵回路ブロックライブラリ（CH340、ESP32自動ダウンロード、USB Hubなど）により迅速な再利用をサポート。 - **検査と納品**：回路図の接続・幾何検査、PCB DRC/DFM、BOM、ネットリスト、製造ファイル、スクリーンショット、監査ログを提供。 ## アーキテクチャと統合 easyeda-agentは3つの部分で構成される： 1. **easyeda CLI/daemon**：ローカルコマンドラインツールで、型付けされたアクションと監査ログを提供。 2. **EDA Agent Connector**：EasyEDA Pro内で動作する拡張プラグインで、公式の`eda.*` APIを通じてソフトウェアと対話する。 3. **Agent Skill**：AIクライアント（Codex、Claude Codeなど）にインストールされるスキルパッケージで、AIが操作を理解し呼び出せるようにする。 ワークフローは：AIエージェント→CLI/daemon→Connector→EasyEDA Proプロジェクト。すべての操作には書き込み前チェック、書き込み後読み戻し検証、および項目別レポート（layout-lint、check、bridge-check、DRCなど）が含まれる。 ## インストールと使用方法 - **CLIとSkill**：macOS/Linux（curlスクリプト）とWindows（PowerShellスクリプト）をサポートし、インストール時にSHA-256とバージョン整合性を検証。 - **Connector**：立创プラグインマーケットまたはGitHub Releaseから`.eext`ファイルをダウンロードし、EasyEDA Proの拡張マネージャーでインポート。 - **起動**：`easyeda daemon start`を実行し、EasyEDAで「外部連携を許可」を有効にしてから、`easyeda health`で接続を確認。 ユーザーは自然言語で要件を直接記述できる。例えば「添付PDFに基づいてライブラリを作成」や「ESP32最小システム基板を作成」など、エージェントが対応する操作を自動実行する。 ## 能力の限界 - 複雑な迷路配線には外部のFreeroutingが必要で、内蔵ルーターは短い配線と局所的な接続に適している。 - 拡張APIにはプログラムによるアンドゥがなく、プロジェクトはソースデータ、書き込み前ガード、読み戻しによってリスクを低減する。 - 制御インピーダンスパラメータを完全に読み取ることができず、インピーダンス適合を自動的に主張できない。 - PDFからのライブラリ作成は具体的な型番とメーカー証拠に依存し、曖昧な場合は一時停止して確認を求める。 ## 開発と貢献 プロジェクトは詳細なドキュメントナビゲーション、開発環境ガイド、回路ブロック貢献規範を提供し、開発者の参加を歓迎する。ライセンスはMITで、一部の移植コードはApache-2.0を踏襲する。