O que precisa
- Rust 1.92 ou mais recente. O workspace utiliza a edição 2024, pelo que uma toolchain mais antiga para no manifesto.
rustup updateatualiza a sua. - Um compilador C, para o crate TLS que os descarregamentos do distribuidor e dos modelos utilizam: as ferramentas de linha de comandos da Xcode no macOS, as ferramentas de compilação MSVC no Windows,
gccouclangno Linux.
Não há bibliotecas de sistema para ligar. O visualizador carrega X11 ou Wayland em tempo de execução, e os solvers de GPU acedem a Vulkan, Metal ou DirectX 12 através do wgpu.
Instalar com cargo
cargo install --git https://github.com/v0l/agentee agenteeIsto compila o binário agentee em modo de libertação e coloca-o em ~/.cargo/bin. Execute o mesmo comando novamente para atualizar.
A partir de um clone
Trabalhe a partir de um clone quando quiser os exemplos, ou para alterar o próprio agentee:
git clone https://github.com/v0l/agentee
cd agentee
cargo install --path crates/agenteecargo build --release -p agentee compila sem instalar, para target/release/agentee.
Cada pacote de fabrico inclui agentee vX.Y.Z-HASH na sua serigrafia. O hash é o commit a partir do qual o binário foi compilado, com -dirty quando a árvore tinha alterações não commitadas, para que uma placa diga sempre de que fonte foi compilada.
O workspace
| crate | o que contém |
|---|---|
agentee | a CLI e o servidor MCP |
agentee-core | unidades, o modelo de ficheiro, resolução e verificação, as calculadoras |
agentee-kicad | o leitor de s-expressões e os importadores .kicad_sym, .kicad_mod e .kicad_pcb |
agentee-layout | colocação e roteirização: fases sobre um modelo de placa e uma pontuação |
agentee-sim | os solvers de campos de GPU: a secção transversal 2D e o FDTD 3D em wgpu |
agentee-fab | Gerbers, ficheiros de furação, BOM, colocação e notas de fabrico |
agentee-parts | stock do distribuidor, preços e alternativas mais baratas do Mouser e Farnell |
agentee-view | o visualizador egui e o renderizador PNG sem interface |
agentee-3d | modelos de partes STEP e VRML, pesquisa e descarregamento |
Testes e benchmarks
cargo test --workspaceO preenchimento de zonas tem um benchmark por fase (clip, overlay, min_width, probe, keep_connected, rasterize, fill_zone) sobre todas as zonas dos exemplos, além de check_zones e a carga de um projeto inteiro. Filtre para a fase em que está a trabalhar:
cargo bench -p agentee-core --bench fill -- --quick 'fill/hackrf-pro/overlay'
cargo bench -p agentee-core --bench fill -- 'load/'Dados de fabrico
Os presets de stackup vêm dos dados publicados dos fabricantes, que mudam ao longo do tempo. crates/agentee-core/stackups/fetch.py obtém-nos novamente do JLCPCB e PCBWay.