EasyEDA Agent

Design, clean up, and verify EasyEDA schematics and PCBs

用本地 easyeda CLI、daemon 和连接器调用 EasyEDA Pro 官方 eda.* 接口。 依据需求与器件资料独立设计；有合适样例时复用参数结构和已验证方法。 模型可选择器件、功能划分及几何生成方法；执行与验收遵守同一数据契约。

工作循环

1. 明确供电、接口、机械与装配约束；已有授权内自主完成常规取舍，只澄清影响目标的缺失信息。
2. 现场读写前用 easyeda health 确认用户已打开的内置浏览器 Web EDA、工程和文档。 宿主要求 V4；连接或版本异常按环境配置处理，不擅自切换桌面版。
3. 保留原始快照，核实真实库身份、完整引脚、网络、NC、几何与规则；未知不能当作空或 NC。
4. 在源副本中明确连接、核心外围归属、单位与约束，生成候选并检查和预览。 求解器、样例或模型生成的数据均须满足数据契约；不强制某个求解器。
5. 用当前 --help / easyeda actions 核对接口，从新鲜快照生成计划，支持 dry-run 时先检查。 仅经 Cobra 子命令、typed action 或 easyeda apply 写入；同一窗口的调用串行执行。
6. 回读身份、逐脚连接和实际几何，与目标对账。部分成功、超时或 stale ID 时先回读，再修源并重算。
7. 稳定检查点显式保存；最终完成 save → doc reload → fresh readback/render。 必须返回布尔 saved:true；saved:false、缺失或其他类型均为失败，外层 ok:true 和 autosave 不替代保存证据。
8. 交付具体结果、证据与未覆盖项；检查、评分、版本或旧 workflow/stage 状态不作为普通动作许可。

设计与执行边界

• 禁止 GUI 自动化编辑、保存、重载或验证工程，也不得用 debug.exec_js 绕过缺失设计接口。 接口缺失或宿主持续加载、对象不可读时停止依赖写入，保留输入与错误，标 unsupported/incomplete，先修工具验证。
• 原始观测不可改写；改源数据后重新生成受保护队列，不手改队列、SVG 或回读来掩盖差异。
• 库中的相近型号须核对引脚和封装后复用；多变体未支持选择时拒绝，不默认取第一项。
• 原理图用 raw、y 向上、5 raw 网格；PCB 命令通常用 mil。明确原点、anchor 与 bbox 语义。
• 保留全部物理脚与明确 NC。netAmbiguous:true 表示歧义，不能转成未连接；标记通过非零导线接脚。 同名网络、同框或高分不能代替要求的外围实际直连；功能归属与网名分别核验（sch check 按已登记模块报 peripheral-not-direct，严格门禁失败）。
• 位号参与碰撞与入框检查；其余属性保留原值，最终导图仍须检查全部可见文字，不能由零碰撞推断无叠字。
• PCB 按真实机械、回流与器件要求安排布局；采集缺测不等于空，检查须说明几何与铜的覆盖范围。 完成前按布局规则通过连续两轮自检，第二轮包含保存重载和新回读；修复后重来。 展示最新回读版本并获用户确认后进入整板布线；确认前仅允许规则范围内的电源模块局部连接。
• 临时隐藏属性只能使用可恢复的 typed 视图接口，保存旧值、恢复并回读；不改属性内容来隐藏问题。
• DRC、连接检查、几何和图面分别说明覆盖事实；原生 pcb drc 的 passed:false 是失败，SCH 的 INFO 不等于错误。 离线通过、导出成功或截图不能代替现场持久化、制造或硬件验证。

按任务读取

只加载当前任务需要的参考；命令参数以当前 CLI help 为准。

任务	参考
需求、选型与设计取舍	设计流程、决策参考、器件选型
原理图数据、布局与 Apply	数据契约、执行步骤
原理图检查或局部修复	原理图、放置、连接
PCB 布局与机械	PCB、布局
PCB 布线、铺铜与禁布区	布线
规则与网络类	配置
库器件或自建库	选型、建库、候选表
新建、打开、导出或迁移工程	工程操作
交付原理图、PCB 正反面与图册	清晰设计图交付
连接、升级或保存异常	环境配置、Action 边界
原始文档源码探针	源码读取与同源回写；不接受任意新源码替代设计接口
复用案例与历史限制	样例索引；旧案例仅适用于其记录的范围

验证与维护

状态用 source-only、offline-verified、live-verified；后者要求真实写入并完成保存重载回读。 候选可标 candidate-unverified / candidate-rejected；未实现能力用 planned / unsupported。 新增可复用样例记录来源、开始状态、参数/单位、命令、实际结果、修法和验证范围。 历史发布验证不覆盖新任务。修改工具同步相应参考；修改 Skill 后运行 python3 scripts/pack-skill.py --check，包结构检查不代表现场通过。