从源码构建 agentee

所需条件

Rust 1.92 或更高版本。工作区使用 2024 版，因此旧工具链会在清单处停止。rustup update 可更新你的工具链。
C 编译器，用于分销商和模型下载使用的 TLS crate：macOS 上为 Xcode 命令行工具，Windows 上为 MSVC 构建工具，Linux 上为 gcc 或 clang。

无需链接系统库。查看器在运行时加载 X11 或 Wayland，GPU 求解器通过 wgpu 访问 Vulkan、Metal 或 DirectX 12。

cargo install --git https://github.com/v0l/agentee agentee

该命令以发布模式构建 agentee 二进制文件并将其放入 ~/.cargo/bin。再次运行相同命令即可更新。

如果需要示例或修改 agentee 本身，请从克隆开始：

git clone https://github.com/v0l/agentee
cd agentee
cargo install --path crates/agentee

cargo build --release -p agentee 构建但不安装，输出到 target/release/agentee。

每个板厂数据包都在丝印中携带 agentee vX.Y.Z-HASH。哈希是构建二进制文件的提交，若树中有未提交的更改则带有 -dirty，因此电路板始终标明其构建来源。

crate	内容
`agentee`	CLI 和 MCP 服务器
`agentee-core`	单位、文件模型、解析和检查、计算器
`agentee-kicad`	s 表达式读取器以及 `.kicad_sym`、`.kicad_mod` 和 `.kicad_pcb` 导入器
`agentee-layout`	布局和布线：基于单个电路板模型和单个得分的阶段
`agentee-sim`	GPU 场求解器：基于 wgpu 的 2D 横截面和 3D FDTD
`agentee-fab`	Gerber、钻孔文件、BOM、贴装坐标和板厂备注
`agentee-parts`	来自 Mouser 和 Farnell 的分销商库存、价格和更便宜的替代品
`agentee-view`	egui 查看器和无头 PNG 渲染器
`agentee-3d`	STEP 和 VRML 器件模型、查找和下载

cargo test --workspace

铺铜填充为每个阶段（clip、overlay、min_width、probe、keep_connected、rasterize、fill_zone）提供基准，覆盖示例中的所有铺铜区，外加 check_zones 和整个项目加载。筛选到你正在处理的阶段：

cargo bench -p agentee-core --bench fill -- --quick 'fill/hackrf-pro/overlay'
cargo bench -p agentee-core --bench fill -- 'load/'

叠层预设来自板厂发布的数据，这些数据会随时间变化。crates/agentee-core/stackups/fetch.py 从 JLCPCB 和 PCBWay 重新获取数据。