只读查询 easyeda-agent 仓库的工具能力、实现、参数化样例与验证证据,适合在其他项目中复用 EDA 自动化经验。 Search the linked easyeda-agent checkout for capabilities, implementation, examples, and evidence; does not operate an EDA document.
日本語の概要は準備中です。原文の説明を表示しています。
通过本地 easyeda CLI、daemon 和连接器操作嘉立创EDA专业版(EasyEDA Pro):用可迁移样例和参数化数据构建或修复原理图、布局布线 PCB,并回读连接、几何、DRC 与保存结果。适用于已有工程操作及数据驱动电路设计。
インストールする前に、エージェントに与えられる指示の中身を確認できます。
用 typed CLI 经 WebSocket 调用 EasyEDA Pro 官方 eda.* API。工作方式是:找到相近样例,
理解其电气或机械理由,替换项目参数,执行,读取实际结果,再修正。样例提供起点,不是完成态
黄金答案;连接、封装、尺寸和规则仍以当前需求、数据手册、原始工程及官方回读为准。
1.7.0 的本轮现场验收覆盖基础 CLI(个人空间、已有自定义规则配置)。高级规划、求解、 Compose/Apply 和整板设计验收留到下一版本;命令可用不代表这些设计流程已通过现场验证。 原理图修改、NC 清除和首次规则初始化的已知 bug 仍须按对应 reference 的回读要求处理。
1.8.0 按已验证的 CLI 修复范围发布。三页原理图和未布线 PCB 布局已有限验证; 完整 ESP32 成品、整板布线、最终 GND 内电层和 PCB DRC 仍待后续,不宣称设计 E2E 通过。
仓库日常测试收尾已改为板外稳压 3.3V、单页原理图、两层 PCB 的 ESP32-S3 最小点灯板。 复杂开发板按任务或受影响能力补测;测试范围及历史结论分开记录,见设计流程。
easyeda Cobra 子命令、typed action 或
easyeda apply 执行。不得用任意 debug.exec_js 绕过缺失的设计 action。planned / unsupported,先补工具和自动化验证。宿主持续加载、
保存或回读失败时停止现场写入并报告数据不可用;不得刷新浏览器或从工程树手工恢复。unsupported,不得用 GUI 或修改属性内容兜底。easyeda health,读取目标页、器件、引脚、网络、板框和规则;用
easyeda <domain> <command> --help 与 easyeda actions 确认当前参数。位号或
primitiveId 不明确时先查清。安装、升级或连接异常才读
environment-setup.md 并运行显式版本对账。页面已打开不等于
connector 已连接;health.windows 出现目标工程/文档后才访问 EDA。同一窗口的 typed 调用
串行执行,subagent 只并行做离线分析或在主 Agent 停止访问窗口时做只读核查。
项目主线要求 EasyEDA Pro V4;hostCompatibility 为 V3/block 时停止现场写入并请用户升级,
V4 低于推荐 4.1.60 时提示升级。产品版本与 engines.eda API 版本不可混为一谈。easyeda apply,不另造执行语言。sch save / pcb save;需要验证持久化时用有界 doc reload 后再次
读取。若 Web 编辑器停在加载动画或对象不可读,停止现场写入,保存故障证据并将结果标为
incomplete;先修复 typed reload/open 能力再复测。报告事实级检查结果和未覆盖项,不用
阶段签字或综合评分代替判断。
用户明确要求刷新整个 Web 编辑器时,使用 easyeda web reload --project <UUID> --doc <UUID>:
它保存当前文档、冻结已连接窗口、触发 typed 页面刷新,只接受新注册及同一工程/文档的
fresh 回读,并报告耗时;同工程其他旧窗口不能作为刷新成功证据。
先保存其他已打开文档;不能把 web reload 当作对象不可读时的自动兜底。
用户明确要求轮换侧载连接器时,可在先逐页 typed 保存后用浏览器 UI 管理扩展;
同 UUID 先卸载旧项、导入新包,并在新项配置中重新启用“允许外部交互”。
health 必须确认运行中的新版本与目标工程/文档,UI 只用于插件管理,不用于工程编辑。pcb stage-snapshot --fit-mode board 生成 typed 整板预览并连续自检两轮;
记录 captureKind 和 objectLevelExport,不得把 board-fitted viewport PNG 称为编辑器菜单的
对象级导出。第 1 轮查空间/模块关系/视觉异常;
第 2 轮严格 save → reload → fresh dump → fresh render。任一轮修正都清零并从第 1 轮重来;
两轮均无待修的明显问题且无修正,才称 Layout 完成、展示复核包并等待用户确认。确认前不进入整板布线;LDO/DCDC
模块内部短电流环路可随布局先完成。具体边界见 pcb-layout.md。从首页调用 MCP project.create 时,先通过 easyeda_health 选择真实窗口,把新名称放在
payload.friendlyName,可用 payload.open 请求打开。此动作只创建工程容器,必须提供
window,不要传 project 或 doc;拟建名称不是已有工程,首页标签不是原理图页面。
创建后检查 created / opened / partial 并读回工程身份,再处理文档创建。部分成功时
先用 easyeda project find --window <id> --name <完整友好名称> --team <teamUuid>
按友好名称和团队精确查找,不盲目重复创建。它只调用官方项目 UUID 枚举与逐项详情读取;
查找默认等待 90 秒,可显式加 --timeout 120s(范围 5 秒到 10 分钟)。超时仍是未知,
不能据此创建同名工程;先保存其他打开文档,用户要求时 typed web reload 后再有界重试。
found 可用于核对已有工程,unknown(例如 UUID 清单为空、详情缺失或枚举报错)不能当作
不存在;只有 enumeration.complete:true 且 presence:"absent" 才能说明指定团队根文件夹内
没有匹配(SDK 不保证递归子文件夹)。本例未传 folderUuid,故先查目标团队根文件夹。
结果仍需核对 UUID 和团队,不因同名自动打开或重试创建。无 --team 的查找仅
用于发现匹配,不证明全局不存在。返回 UNKNOWN_ACTION 时检查连接器是否实现此动作;健康检查的
版本兼容不能证明 handler 存在。其他 MCP 写操作仍要求真实 project 和 doc;不得推广此例外。
创建目标要区分个人空间和团队。 创建个人工程省略 --team;project info 中可用于
find --team 枚举的归属 UUID,不能直接假定也可传给 create --team。Web V4.1.60 现场
同名、同参数对照中,显式传个人空间的归属 UUID 立即返回无 UUID;完整回查确认未创建后,
只省略该参数则创建成功,并回查到原归属 UUID。团队工程仍须明确目标团队,失败时不能自动
改为个人工程。遇无 UUID 先完整回查,再根据已确定的目标空间修正参数;不能盲目重试或改归属。
工程级跨项目打开及原生 .epro2 导出见 工程操作;页面打开不替代工程切换。
| 任务 | 读取 |
|---|---|
| 260919 AT32F415 考试 Demo、LDO、固定板框 | 260919 索引 |
| 历史模拟/练习题迁移 | 考题差异表 |
| 原理图源数据、参数化布局、Apply | schematic-data.md、auto-layout-sop.md |
| 已有原理图检查或小修 | schematic.md、schematic-wiring.md |
| PCB 布局 | pcb.md、pcb-layout.md |
| PCB 布线、铺铜、禁布区 | pcb-routing.md |
| EDA 配置、考试设计规则、PWR 网络类绑定 | pcb-config.md |
| 从需求到整板 | design-flow.md、design-decisions.md |
| 选型、标准电路、库器件 | part-selection.md、library-authoring.md、standard-parts.json |
| 交付原理图、PCB 正反面与图册 | 清晰设计图交付 |
| action 或队列字段 | actions.md;未知官方接口先 easyeda api search/show |
| Web 原始文档源码读取与同源 roundtrip 验证 | document-source.md;不接受任意新源码或替代设计验收 |
常用辅助脚本(在 Skill 根目录运行,Windows 用 python):
scripts/lint.sh 原理图 lint、
scripts/parts-select.py 选型、
scripts/bom-enrich.py BOM 补 LCSC C 号、
scripts/blocks-pin-audit.py 块引脚审计、
scripts/parts-relocalize.py 按当前站点重解析
standard-parts.json 的 deviceUuid(国际版器件 uuid 与国内版不同,block-apply
首个 place 就 “connector did not respond” 时用它,详见
part-selection.md)。
check、连通率、几何测量和评分各自只说明其覆盖事实。缺测、读回失败、未保存或
未重开核验时标记 incomplete,截图仅用于发现遗漏。incomplete。若“系统封装无损复制到当前工程库”已在
目标宿主重复实测失败,则将这条组合能力标 unsupported 并跳过该写入;可用实测封装外形
继续参数化布局避让,但必须保留未满足考点,不得把几何代理写成已有封装禁放区。pcb dump --include-copper --out board.json,再运行 pcb layout-plan --from layout.json --board board.json --module <id> --candidates 3 --out <dir>。输入明确成员、固定轴、允许角度及
member pad → owner pad;同网去耦不得按最近焊盘重新分配。候选报告位置、板边、距离和
最近的内部/外部/keepout 对象对,不给总分;AI 写明理由后执行 .apply.json,都不合适就
改关系或搜索参数重算,禁止现场试摆。带铜模块使用 schemaVersion 2,声明器件、内部铜、
外部端口、旧铜替换清单和验收要求;模块内部对象可刚体变换,连接固定 owner 的外部引线
必须在候选位置重新求解。pcb module-check 只在新鲜铜快照、journal 和候选一致时验收;
bundle 的 affectedBaselinePours 必须把可被重建的既有材料化铺铜绑定到 boundary/materialized
ID 与参数化 impactEnvelope:只允许声明对象在包络内变化,包络外及未声明铜严格保持。
晶振模块逐个证明每个 fence/anchor via 在 TOP/BOTTOM 实际 GND 铜中与 anchor 同岛,并核对
OSC ordered path、fresh pad geometry、实际长度/转折、capture PID 与 polygon/holes/ARC。
pcb poured-list 读取重建后的实际铺铜;只有完整 inventory 返回真实 [] 才是 known-empty,
fill/boundary/net/layer/polygon 任一缺测均为 unknown/error。执行前核对语义哈希,
之后 save → 有界 reload → 新 dump → pour rebuild → module-check 对账。完整做法见
PCB 布线 和 模块候选 Layout。pcb layout solve --board board.json --from request.json --out report.json;
pcb layout check 从原板和独立请求重建/复验候选,pcb layout render 只渲染同一候选。
当前仅支持完整实测的二层 TOP/BOTTOM,四层层数不得推断平面角色。离线候选 typed 写入后仍需
连续两轮 Layout 自检,并在进入整板布线前等待用户确认持久化回读版本。每个样例写来源页、开始状态、参数与单位、命令、观测、错误修法和验证状态。交付状态只用
source-only、offline-verified、live-verified;候选生命周期可另标 candidate-unverified /
candidate-rejected,不能冒充交付验证。未实现的 typed 能力标 planned / unsupported,
不得改走 GUI;新接口先用当前 --help 核对,离线测试不等于已在用户的 EDA 构建现场验证。
修改底层 action、daemon 或连接器时同步更新样例;修改 Skill 后运行 python3 scripts/pack-skill.py --check,它不代表现场验证。
まだレビューはありません。使ってみた感想をお寄せください。
概要と使いどころ
只读查询 easyeda-agent 仓库的工具能力、实现、参数化样例与验证证据,适合在其他项目中复用 EDA 自动化经验。 Search the linked easyeda-agent checkout for capabilities, implementation, examples, and evidence; does not operate an EDA document.
日本語の概要は準備中です。原文の説明を表示しています。
维护 easyeda-agent 仓库的 Skill、CLI、daemon、connector 与文档,补回可复用经验并组织验证和 Git 贡献。 Develop and contribute to the linked automation repository; use easyeda-agent for circuit design operations.
日本語の概要は準備中です。原文の説明を表示しています。