EasyEDA Agent

用本地 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 为准。

验证与维护

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