easyeda-agent

easyeda-agent é uma ferramenta de automação de IA para o EasyEDA Pro, projetada para permitir que agentes de IA operem diretamente o software EDA, completando todo o fluxo, desde a criação de bibliotecas a partir de datasheets até a verificação de fabricação de PCB. Ele se integra por meio de três formas: CLI, Agent Skill e stdio MCP, fornecendo operações tipadas de esquemático e PCB, com ênfase em verificação e auditoria antes e depois da escrita. ## Capacidades principais - **Criação de bibliotecas de componentes**: lê informações de modelo, pinos e encapsulamento de PDFs ou desenhos dimensionais, criando automaticamente Symbol, Footprint, Device e modelos 3D opcionais, com validação da fonte e do mapeamento de pinos. - **Design esquemático**: conclui seleção de componentes, desenho esquemático, substituição padronizada, verificação e correção de conexões a partir de requisitos em linguagem natural. - **Layout e roteamento de PCB**: layout automático com consciência de módulos, ajuste ao contorno da placa, roteamento com consciência de regras, vias, preenchimento de cobre, planos de alimentação multicamada e keepout de antena. - **Organização de silk-screen**: evita automaticamente pads, corpos de componentes e contornos de placa, adicionando notas de placa, nomes de interfaces, polaridade de LEDs e logotipos SVG. - **Reutilização de circuitos**: biblioteca integrada de blocos de circuito (como CH340, download automático ESP32, USB Hub, etc.) para reutilização rápida. - **Verificação e entrega**: verificação de conexões/geometria do esquemático, DRC/DFM de PCB, BOM, netlist, arquivos de fabricação, capturas de tela e logs de auditoria. ## Arquitetura e integração easyeda-agent consiste em três partes: 1. **easyeda CLI/daemon**: ferramenta de linha de comando local que fornece ações tipadas e logs de auditoria. 2. **EDA Agent Connector**: plugin de extensão executado dentro do EasyEDA Pro, interagindo com o software por meio da API oficial `eda.*`. 3. **Agent Skill**: pacote de habilidades instalado em clientes de IA (como Codex, Claude Code), permitindo que a IA entenda e invoque as operações. O fluxo de trabalho é: Agente de IA → CLI/daemon → Connector → Projeto EasyEDA Pro. Todas as operações incluem verificação pré-escrita, validação pós-leitura e relatórios detalhados (como layout-lint, check, bridge-check, DRC). ## Instalação e uso - **CLI e Skill**: suporta macOS/Linux (script curl) e Windows (script PowerShell), com verificação de SHA-256 e consistência de versão durante a instalação. - **Connector**: baixe o arquivo `.eext` do mercado de plugins da LCSC ou do GitHub Release e importe-o no gerenciador de extensões do EasyEDA Pro. - **Inicialização**: execute `easyeda daemon start`, habilite "Permitir interação externa" no EasyEDA e execute `easyeda health` para verificar a conexão. Os usuários podem descrever requisitos diretamente em linguagem natural, como "criar biblioteca a partir do PDF anexo" ou "fazer uma placa de sistema mínimo ESP32", e o agente executará automaticamente as operações correspondentes. ## Limitações - Roteamento complexo de labirinto requer Freerouting externo; o roteador integrado é adequado para linhas curtas e conexões locais. - A API de extensão não possui desfazer programático; o projeto reduz riscos por meio de dados de origem, guardas pré-escrita e leitura de retorno. - Parâmetros de impedância controlada não podem ser totalmente lidos; não é possível afirmar automaticamente conformidade de impedância. - A criação de bibliotecas a partir de PDF depende de modelos específicos e evidências do fabricante; pausa para perguntar quando ambíguo. ## Desenvolvimento e contribuição O projeto fornece documentação detalhada de navegação, guia de ambiente de desenvolvimento e especificações de contribuição de blocos de circuito, sendo bem-vindo à participação de desenvolvedores. A licença é MIT, com parte do código portado mantendo Apache-2.0.