用途:在 Xpedition Designer 中处理 Xpedition 项目原理图,包括按设计描述绘制(含从书面需求设计电路)、回读元件/引脚/网络/连通性、审查(Designer ERC、网表规则、规则文件)、展示与导出 PDF、引脚分配规划与检查、在设计文件中选封装。不负责 Layout 板图(xpedition-pcb),也不负责安装、会话、建项目、BOM 或 ChangeSet 写入(xpedition-cli)。
前置:运行任何命令前先读 ../xpedition-cli/SKILL.md;缺失则停止并告知用户安装,经同意后用 npx skills add fatecannotbealtered/xpedition-cli -y -g。原理图命令在 Designer 中运行,需 session start --backend native_xpedition --kind schematic,原生命令均须 --backend native_xpedition --project X.prj。每次写入先看 dry run,再用相同参数与返回 token 确认。MockBackend 读取无需 Designer。
绘制约定:图纸单位 10 mil、网格 10 单位;坐标在边框内(B 尺寸 1700×1100);按实际尺寸加 30 单位间距;用带标签的短桩连接而非长导线;信号左到右、电源上、地下;每个器件有正确前缀的 refdes、值与 PDB 中存在的料号;网络用 ASCII UPPER_SNAKE 命名;未用引脚加 no-connect;地用 Globals:gnd。绘制前读 reference/schematic-conventions.md,设计文件格式见 reference/schematic-design-format.md。用 schematic draw --design FILE --dry-run 后看 preview.summary.issues,schematic render 预览每张图,确认时需 --dangerous --confirm <token>,成功后 netlist.matches 为 true 才算完成。之后 schematic show/--output 查看,review run 审查(来源标记 xpedition/verify:、xpedition/grc:、cli/、mock/project、rule:),schematic export 导出 PDF。封装来自 KiCad 库,用 library kicad-import,需先 dry run 并征得同意。绘制后须 library build --package 打包,否则回读或审查会因 COM 类型不匹配停止。项目与中央库路径须为 ASCII,含中文字符会报 E_VALIDATION。绘制失败可据 sheets_drawn/sheets_remaining 用 --sheets 续画;E_TIMEOUT(固定 1800 秒)需 session stop 再 start。引脚分配用 schematic pin-plan 与 pin-check 离线处理快照,快照比较不是实时回读或写入授权。限制:确认绘制会先清空并重绘设计列出的每张图,覆盖可能被手工编辑的图纸前须先询问;交叉导线会短路两个网络,优先标签并在确认前回读。