@windypro-rourou/dsh-eda 0.1.1 → 0.1.3

package/lib/index.js

@@ -60,12 +60,13 @@ export const EDA_GUIDANCE =
   '本机已安装 dsh-lichuang-eda 插件（嘉立创 EDA 助手）：本插件是「平台层」——提供官方桥的装/启/连/状态，以及执行官方 eda.* API 的双手；「生成电路图」这类编排请在对话里直接进行（skill 式直觉）。' +
   '当用户说「嘉立创EDA，启动！」/「帮我画一个…电路」且已连接时，按此流程做：① `eda_status` 确认官方桥 connected（未连则 `eda_backend_connect`）；② 用 `eda_exec` 逐步执行官方 eda.* API 在用户的云端画板上实时生成（放元件→连线→网络标签→DRC/网表/BOM），' +
   '官方案例/参数在 ~/.dsh/eda/bridge/（docs、user-guide、guide、format 目录为官方文档，先用 read 查阅再调用）；③ 每步 `eda_exec` 后返回结果/错误，必要时 `eda_sch_drc` 校验。' +
-  '工具：eda_status（状态）、eda_bridge_install（一键装官方桥）、eda_backend_connect（启动/连接官方桥）、eda_exec（执行任意官方 eda.* 代码——云端实时生成的双手）、eda_pick_spot（**框内定位**：读页面尺寸+已有图元→返回互不冲突的框内网格空位；放元件前先调用）、eda_snapshot（**紧急保存**：画板现场 .epro2 + 预览 SVG + 网表/BOM + agent 动作日志 → ~/.dsh/eda/snapshots/，断连也能留档）、' +
+  '工具：eda_status（状态）、eda_bridge_install（一键装官方桥）、eda_backend_connect（启动/连接官方桥）、eda_exec（执行任意官方 eda.* 代码——云端实时生成的双手）、eda_pick_spot（**框内定位**：读页面尺寸+已有图元→返回互不冲突的框内网格空位；放元件前先调用）、eda_place（搜索+定位+放置一体并返回引脚坐标）、eda_wire（引脚级连线，自动校验水平/垂直）、eda_netflag（电源/地网络标志）、eda_save（保存当前文档）——高频画板动作建议用这四个封装而非手拼代码；eda_snapshot（**紧急保存**：画板现场 .epro2 + 预览 SVG + 网表/BOM + agent 动作日志 → ~/.dsh/eda/snapshots/，断连也能留档）、' +
   'eda_sch_drc / eda_get_netlist / eda_get_bom（校验/导出，需连接）、eda_generate_schematic_json（**离线兜底**：本地生成可导入的标准版 JSON，写入 ~/.dsh/eda/output/；仅在无法连接画板时使用，连接时一律走官方 API 云端实时）、' +
   'eda_template_list / eda_translate_request（模板与需求翻译，供离线/兜底使用）。' +
-  '**官方 Skill 全库已接入**：官方易达 skill 知识随插件 vendored（SKILL.md 总纲 / references/classes/*.md 逐类 API / guide、user-guide、format 教程与格式）。规划任何画板动作前先用 eda_skill_read 查阅（顺序：INDEX.md → 对应类文档 → eda_exec 落地）；不确定 API 存在性也可先 eda_capabilities。' +
+  '**官方 Skill 全库已接入**：官方易达 skill 知识随插件 vendored（SKILL.md 总纲 / references/classes/*.md 逐类 API / guide、user-guide、format 教程与格式；线上镜像 https://prodocs.easyeda.com/cn/api/reference/pro-api.html 可交叉核对）。规划任何画板动作前先用 eda_skill_read 查阅（顺序：INDEX.md → 对应类文档 → eda_exec 落地）；不确定 API 存在性也可先 eda_capabilities。' +
   '**放置定位（硬规则，禁止乱放）**：原理图坐标单位 10mil、图纸 A4≈1170×825，放置前必须先 `eda_exec` 读页面尺寸（dmt_Project.getCurrentProjectInfo()→titleBlockData.Width/Height）与已有图元位置（sch_PrimitiveComponent.getAll()+getState_X/Y 在代码内映射），只放**图框内边距≥80、网格 100 步进、与已有图元间距≥150**的空位（或直接调 eda_pick_spot）；导线用 getAllPinsByPrimitiveId 取真实引脚坐标后画水平/垂直线段（只连引脚）。PCB 坐标单位 1mil，同样读已有焊盘（getAllPins）后居中布件、焊盘级走线。' +
   '**已知缺陷与技巧（实测，勿踩坑）**：`pcb_Document.importChanges` 与 `pcb_Net.setNetlist` 实测不可靠（勿用于网表同步）；`sch_Netlist.getNetlist` 与 `pcb_Net.getNetlist("EasyEDA")` 会挂起（网表一律用 `sch_ManufactureData.getNetlistFile` 并 `await f.text()`）；`getBomFile` 返回二进制 xlsx（arrayBuffer→base64 处理）；DRC 用 `check(true,false,true)` 拿详情；`sch_PrimitiveComponent.getAll` 间歇失败需重试；PCB 板框（layer 11）官方无绘制 API（人工/导入）。' +
+  '**超时防线（防自动退出）**：所有聚合/查询工具内部单查询 5s 封顶、并行、单项降级（返回值带 degraded 说明），单次调用总耗时有界——不会触发超时中断；`eda_exec` 可传 `timeoutMs`（默认 25000，定位挂起用 8000~15000，长导出用 45000）。' +
   '**主动协作（能力入口）**：你能主动为用户完成——读工程/文档、放任意大类元件（搜库→定位→放置）、引脚级连线、网络标志/端口、DRC、网表/BOM 导出、PCB 元件/过孔/走线、现场截图、紧急保存。规划任务时若不确定某个 API 是否存在或怎么调，先调 `eda_capabilities`（结构化能力清单+注意事项+实测片段），再用 `eda_exec` 落地；用户提到画板相关需求时主动提议并执行，不要等用户一字一句教。' +
   '限制：v0 离线生成器仅支持 电阻/LED；云端实时生成能力由官方 eda.* API 决定（以 ~/.dsh/eda/bridge 内官方文档为准）。' +
   '用户提到「嘉立创 / 立创EDA / 原理图 / PCB草图 / 生成电路图」时即指本插件，请据此主动协作。'
@@ -88,25 +89,29 @@ function pushPendingActivity(entry) { return activityLog?.push({ status: 'pendin
 function updateActivity(id, patch) { activityLog?.update(id, patch) }
 function activityFeed(opts) { return activityLog?.feed(opts) ?? { currentSid: '', sessions: [], activities: [] } }
 
-/** Snapshot the current document's primitive ids (for 撤回 diff). */
+/** Snapshot the current document's primitive ids (for 撤回 diff). 内部每类 5s 封顶。 */
 async function captureDocumentIds(backend) {
   const CODE = `return await (async () => {
-    const info = await eda.dmt_SelectControl.getCurrentDocumentInfo();
+    const sleep = (ms) => new Promise(r => setTimeout(r, ms));
+    const T = 5000;
+    const pull = (fn) => Promise.race([fn().catch(() => null), sleep(T).then(() => null)]);
+    let info = null;
+    try { info = await pull(() => eda.dmt_SelectControl.getCurrentDocumentInfo()); } catch (e) {}
     const domain = info?.documentType === 3 ? 'pcb' : 'sch';
     const out = { domain };
     try {
       if (domain === 'sch') {
-        out.component = await eda.sch_PrimitiveComponent.getAllPrimitiveId();
-        out.wire = await eda.sch_PrimitiveWire.getAllPrimitiveId();
+        out.component = await pull(() => eda.sch_PrimitiveComponent.getAllPrimitiveId()) ?? [];
+        out.wire = await pull(() => eda.sch_PrimitiveWire.getAllPrimitiveId()) ?? [];
       } else {
-        out.component = await eda.pcb_PrimitiveComponent.getAllPrimitiveId();
-        out.via = await eda.pcb_PrimitiveVia.getAllPrimitiveId();
-        out.line = await eda.pcb_PrimitiveLine.getAllPrimitiveId();
+        out.component = await pull(() => eda.pcb_PrimitiveComponent.getAllPrimitiveId()) ?? [];
+        out.via = await pull(() => eda.pcb_PrimitiveVia.getAllPrimitiveId()) ?? [];
+        out.line = await pull(() => eda.pcb_PrimitiveLine.getAllPrimitiveId()) ?? [];
       }
     } catch { /* partial snapshot is fine */ }
     return out;
   })();`
-  const r = await backend.execute(CODE, 25000)
+  const r = await backend.execute(CODE, 20000)
   if (!r.ok) return null
   try { return JSON.parse(r.result) } catch { return null }
 }
@@ -556,6 +561,7 @@ function edaGenerateSchematicJsonTool() {
           ok: { type: 'boolean', required: true },
           title: { type: 'string' },
           note: { type: 'string' },
+          netSummary: { type: 'string' },
           components: { type: 'array', items: { type: 'string' } },
           nets: { type: 'array', items: { type: 'string' } },
           structureOk: { type: 'boolean' },
@@ -610,7 +616,7 @@ function edaBridgeInstallTool(backend) {
           error: { type: 'string' },
         },
       },
-      render: (_args, value) => ({ type: 'text', text: value?.ok ? (value.message ?? '安装完成') : `安装失败: ${value?.error ?? '?'}` }),
+      render: (_args, value) => [{ type: 'text', text: value?.ok ? (value.message ?? '安装完成') : `安装失败: ${value?.error ?? '?'}` }],
     },
     async execute(args, exec) {
       const sid = sessionIdOf(exec)
@@ -652,12 +658,12 @@ function edaBackendConnectTool(handle, backend) {
           note: { type: 'string' },
         },
       },
-      render: (_args, value) => ({
+      render: (_args, value) => [{
         type: 'text',
         text: value?.ok === false
           ? `启动失败: ${value?.error ?? '?'}\n${value?.note ?? ''}`
           : `官方桥: ${value?.state ?? '?'}\n${value?.note ?? ''}`,
-      }),
+      }],
     },
     async execute(_args, exec) {
       const sid = sessionIdOf(exec)
@@ -695,7 +701,7 @@ function bridgeTool(handle, backend, spec) {
           error: { type: 'string' },
         },
       },
-      render: (_args, value) => ({ type: 'text', text: value?.ok ? renderSummary(value.result) : `失败: ${value?.error ?? '?'}` }),
+      render: (_args, value) => [{ type: 'text', text: value?.ok ? renderSummary(value.result) : `失败: ${value?.error ?? '?'}` }],
     },
     async execute(args, exec) {
       const sid = sessionIdOf(exec)
@@ -768,6 +774,7 @@ function edaExecTool(backend) {
     parameters: {
       code: { type: 'string', description: '官方 eda.* JS 代码，例如 return await eda.dmt_Project.getCurrentProjectInfo();' },
       args: { type: 'string', description: '可选：附加 JSON（未来扩展位；可忽略）' },
+      timeoutMs: { type: 'integer', description: '可选：本调用的客户端超时毫秒（默认 25000；范围 5000-120000）。定位挂起问题用 8000~15000 快速失败；保存/导出等长操作可给 45000' },
     },
     output: {
       schema: {
@@ -779,12 +786,13 @@ function edaExecTool(backend) {
           error: { type: 'string' },
         },
       },
-      render: (_args, value) => ({ type: 'text', text: value?.ok ? `执行结果:\n${value.result ?? ''}` : `执行失败: ${value?.error ?? '?'}` }),
+      render: (_args, value) => [{ type: 'text', text: value?.ok ? `执行结果:\n${value.result ?? ''}` : `执行失败: ${value?.error ?? '?'}` }],
     },
     async execute(args, exec) {
       const sid = sessionIdOf(exec)
       const code = typeof args?.code === 'string' ? args.code.trim() : ''
       if (code === '') return { ok: false, error: 'code 不能为空（例如 return await eda.dmt_Project.getCurrentProjectInfo();）' }
+      const tms = Math.max(5000, Math.min(120000, Number(args?.timeoutMs) || 25000))
       await backend.refresh() // live facts before gating
       const st = statusOf(backend)
       if (!st.connected) {
@@ -793,9 +801,9 @@ function edaExecTool(backend) {
       }
       const id = pushPendingActivity({ sid, tool: 'eda_exec', action: describeEdaAction(code), code })
       const t0 = Date.now()
-      const before = await captureDocumentIds(backend) // best-effort (for 撤回)
-      const r = await backend.execute(code)
-      const after = await captureDocumentIds(backend)
+      const before = await captureDocumentIds(backend) // best-effort (for 撤回); 自身 5s 封顶
+      const r = await backend.execute(code, tms)
+      const after = await captureDocumentIds(backend) // 5s 封顶，绝不追加挂起
       updateActivity(id, {
         status: r.ok ? 'done' : 'error',
         ok: r.ok,
@@ -810,23 +818,22 @@ function edaExecTool(backend) {
   })
 }
 
-/** 读取当前原理图页的尺寸 + 已有图元分布（桥端映射；getAll 间歇失败→重试）。 */
+/** 读取当前原理图页的尺寸 + 已有图元分布（桥端映射；每项 5s 封顶，绝不挂满）。 */
 async function readSchLayout(backend) {
   const CODE = `return await (async () => {
-    const proj = await eda.dmt_Project.getCurrentProjectInfo();
+    const sleep = (ms) => new Promise(r => setTimeout(r, ms));
+    const T = 5000;
+    const pull = (fn) => Promise.race([fn().catch(() => null), sleep(T).then(() => null)]);
+    const proj = await pull(() => eda.dmt_Project.getCurrentProjectInfo());
     const page = proj?.data?.[0]?.schematic?.page?.[0];
-    let comps = null; let wires = null;
-    for (let i = 0; i < 3 && (comps == null || wires == null); i++) {
-      try { comps = await eda.sch_PrimitiveComponent.getAll(); } catch (e) { comps = null; }
-      try { wires = await eda.sch_PrimitiveWire.getAll(); } catch (e) { wires = null; }
-      if (comps == null || wires == null) await new Promise(r => setTimeout(r, 700));
-    }
+    const comps = (await pull(() => eda.sch_PrimitiveComponent.getAll())) || [];
+    const wires = (await pull(() => eda.sch_PrimitiveWire.getAll())) || [];
     const used = [];
-    for (const c of (comps || [])) { try { used.push({ x: c.getState_X(), y: c.getState_Y() }); } catch (e) {} }
-    for (const w of (wires || [])) { try { const l = w.getState_Line(); for (let i = 0; i + 1 < l.length; i += 2) used.push({ x: l[i], y: l[i + 1] }); } catch (e) {} }
+    for (const c of comps) { try { used.push({ x: c.getState_X(), y: c.getState_Y() }); } catch (e) {} }
+    for (const w of wires) { try { const l = w.getState_Line(); for (let i = 0; i + 1 < l.length; i += 2) used.push({ x: l[i], y: l[i + 1] }); } catch (e) {} }
     return { name: page?.name ?? '', width: Number(page?.titleBlockData?.Width?.value ?? 1170), height: Number(page?.titleBlockData?.Height?.value ?? 825), used };
   })();`
-  const r = await backend.execute(CODE, 30000)
+  const r = await backend.execute(CODE, 18000)
   if (!r.ok) return { ok: false, error: r.error }
   try { return { ok: true, ...JSON.parse(r.result) } } catch { return { ok: false, error: 'layout read failed' } }
 }
@@ -870,13 +877,13 @@ function edaPickSpotTool(backend) {
         },
       },
       render: (_args, value) => {
-        if (value?.ok !== true) return { type: 'text', text: `框内定位失败: ${value?.error ?? '?'}` }
+        if (value?.ok !== true) return [{ type: 'text', text: `框内定位失败: ${value?.error ?? '?'}` }]
         const lines = [
           `页面: ${value.page ?? '?'}（${value.size ?? '?'}）· 已有图元采样 ${value.usedCount ?? 0}`,
         ]
         for (const s of value.spots ?? []) lines.push(`  空位: (${s.x}, ${s.y})${s.inside ? '' : ' ⚠框外'}`)
         if (value.note) lines.push(`提示: ${value.note}`)
-        return { type: 'text', text: lines.join('\n') }
+        return [{ type: 'text', text: lines.join('\n') }]
       },
     },
     async execute(args) {
@@ -912,19 +919,23 @@ function edaPickSpotTool(backend) {
   })
 }
 
-/** 读 PCB 现有图元分布（元件/过孔/线），供 pcb 定位。 */
+/** 读 PCB 现有图元分布（元件/过孔/线），供 pcb 定位。每类 5s 封顶 + 并行。 */
 async function readPcbLayout(backend) {
   const CODE = `return await (async () => {
-    const used = [];
+    const sleep = (ms) => new Promise(r => setTimeout(r, ms));
+    const T = 5000;
+    const pull = (fn) => Promise.race([fn().catch(() => null), sleep(T).then(() => null)]);
     const grab = async (api) => {
-      try { const all = await eda[api].getAll(); for (const x of (all || [])) { try { used.push({ x: x.getState_X(), y: x.getState_Y() }); } catch (e) {} } } catch (e) {}
+      const all = (await pull(() => eda[api].getAll())) || [];
+      const used = [];
+      for (const x of all) { try { used.push({ x: x.getState_X(), y: x.getState_Y() }); } catch (e) {} }
+      return used;
     };
-    await grab('pcb_PrimitiveComponent');
-    await grab('pcb_PrimitiveVia');
-    await grab('pcb_PrimitiveLine');
+    const [a, b, c] = await Promise.all([grab('pcb_PrimitiveComponent'), grab('pcb_PrimitiveVia'), grab('pcb_PrimitiveLine')]);
+    const used = [...a, ...b, ...c];
     return { used, count: used.length };
   })();`
-  const r = await backend.execute(CODE, 30000)
+  const r = await backend.execute(CODE, 15000)
   if (!r.ok) return { ok: false, error: r.error }
   try { const j = JSON.parse(r.result); return { ok: true, used: j.used ?? [], count: j.count ?? 0 } } catch { return { ok: false, error: 'pcb layout read failed' } }
 }
@@ -969,11 +980,12 @@ function edaBoardOverviewTool(backend) {
             },
           },
           truncated: { type: 'boolean' },
+          degraded: { type: 'array', items: { type: 'string' } },
           error: { type: 'string' },
         },
       },
       render: (_args, value) => {
-        if (value?.ok !== true) return { type: 'text', text: `画板全览失败: ${value?.error ?? '?'}` }
+        if (value?.ok !== true) return [{ type: 'text', text: `画板全览失败: ${value?.error ?? '?'}` }]
         const lines = [
           `${value.domain === 'pcb' ? 'PCB' : '原理图'}（${value.doc ?? '?'}）· ${value.pageSize ?? ''}`,
           `元件 ${value.componentCount ?? 0} · 导线 ${value.wireCount ?? 0} · 过孔 ${value.viaCount ?? 0} · 走线 ${value.lineCount ?? 0}`,
@@ -984,43 +996,50 @@ function edaBoardOverviewTool(backend) {
           for (const c of value.componentsPreview.slice(0, 20)) lines.push(`  ${c.designator} ${c.name} @(${c.x},${c.y})${c.net ? ` [${c.net}]` : ''}`)
           if (value.truncated) lines.push(`  …共 ${value.componentCount} 个（full=true 看全）`)
         }
-        return { type: 'text', text: lines.join('\n') }
+        if ((value.degraded ?? []).length > 0) lines.push(`⚠ 单项降级: ${value.degraded.join('; ')}（可用最小粒度 eda_exec 单查该项）`)
+        return [{ type: 'text', text: lines.join('\n') }]
       },
     },
     async execute(args) {
       const full = args?.full === true
-      const r = await backend.execute(OVERVIEW_CODE, 40000)
-      if (!r.ok) return { ok: false, error: r.error, domain: 'sch', doc: '', pageSize: '', componentCount: 0, wireCount: 0, viaCount: 0, lineCount: 0, nets: [], componentsPreview: [], truncated: false }
+      const r = await backend.execute(OVERVIEW_CODE, 30000) // 内部单查询 5s 封顶+并行 → 总耗时 <15s，不触发超时中断
+      if (!r.ok) return { ok: false, error: r.error, domain: 'sch', doc: '', pageSize: '', componentCount: 0, wireCount: 0, viaCount: 0, lineCount: 0, nets: [], componentsPreview: [], truncated: false, degraded: [] }
       let raw
-      try { raw = JSON.parse(r.result) } catch { return { ok: false, error: 'overview parse failed', domain: 'sch', doc: '', pageSize: '', componentCount: 0, wireCount: 0, viaCount: 0, lineCount: 0, nets: [], componentsPreview: [], truncated: false } }
+      try { raw = JSON.parse(r.result) } catch { return { ok: false, error: 'overview parse failed', domain: 'sch', doc: '', pageSize: '', componentCount: 0, wireCount: 0, viaCount: 0, lineCount: 0, nets: [], componentsPreview: [], truncated: false, degraded: [] } }
       const o = buildOverview(raw, { full })
-      return { ok: true, ...o, doc: raw?.doc?.name ?? raw?.doc?.uuid ?? '' }
+      return { ok: true, ...o, doc: raw?.doc?.name ?? raw?.doc?.uuid ?? '', degraded: Array.isArray(raw?.degraded) ? raw.degraded : [] }
     },
   })
 }
 
 const OVERVIEW_CODE = `return await (async () => {
   const sleep = (ms) => new Promise(r => setTimeout(r, ms));
-  let info = null;
-  for (let i = 0; i < 3 && info == null; i++) {
-    try { info = await eda.dmt_SelectControl.getCurrentDocumentInfo(); } catch (e) { info = null; }
-    if (info == null) await sleep(700);
-  }
-  const domain = info?.documentType === 3 ? 'pcb' : 'sch';
-  const out = { domain, doc: info };
+  const TIMEOUT = 5000; // 每个子查询 5s 封顶：单点挂起只降级该项，绝不拖垮整个调用
+  const pull = (fn, label) => Promise.race([
+    (async () => { try { return { ok: true, value: await fn() }; } catch (e) { return { ok: false, label, err: String(e).slice(0, 80) }; } })(),
+    sleep(TIMEOUT).then(() => ({ ok: false, label, err: 'timeout' })),
+  ]);
+  const info = await pull(() => eda.dmt_SelectControl.getCurrentDocumentInfo(), 'doc info');
+  const domain = (info.ok && info.value?.documentType === 3) ? 'pcb' : 'sch';
+  const out = { domain, doc: info.ok ? info.value : null, degraded: [] };
+  if (!info.ok) out.degraded.push(info.label + ': ' + info.err);
   if (domain === 'sch') {
-    try {
-      const proj = await eda.dmt_Project.getCurrentProjectInfo();
-      const page = proj?.data?.[0]?.schematic?.page?.[0];
+    const proj = await pull(() => eda.dmt_Project.getCurrentProjectInfo(), 'project info');
+    if (proj.ok && proj.value?.data?.[0]?.schematic?.page?.[0]) {
+      const page = proj.value.data[0].schematic.page[0];
       out.pageSize = { w: Number(page?.titleBlockData?.Width?.value ?? 1170), h: Number(page?.titleBlockData?.Height?.value ?? 825), unit: '10mil' };
-    } catch (e) {}
-    let comps = []; let wires = [];
-    for (let i = 0; i < 3; i++) {
-      try { comps = await eda.sch_PrimitiveComponent.getAll(); break; } catch (e) { await sleep(700); }
-    }
-    try { wires = await eda.sch_PrimitiveWire.getAll(); } catch (e) { wires = []; }
+    } else out.degraded.push(proj.label)
+    // 并行取元件与导线（各自 5s 封顶）
+    const [compsR, wiresR] = await Promise.all([
+      pull(() => eda.sch_PrimitiveComponent.getAll(), 'components'),
+      pull(() => eda.sch_PrimitiveWire.getAll(), 'wires'),
+    ]);
+    if (!compsR.ok) out.degraded.push(compsR.label + ': ' + compsR.err)
+    if (!wiresR.ok) out.degraded.push(wiresR.label + ': ' + wiresR.err)
+    const comps = compsR.ok ? (compsR.value || []) : [];
+    const wires = wiresR.ok ? (wiresR.value || []) : [];
     const nets = new Set();
-    out.components = (comps || []).map(c => {
+    out.components = comps.map(c => {
       let d = ''; let t = ''; let n = ''; let x = 0; let y = 0;
       try { d = (c.getState_Designator ? c.getState_Designator() : '') || ''; } catch (e) {}
       try { t = (c.getState_ComponentType ? c.getState_ComponentType() : '') || ''; } catch (e) {}
@@ -1028,22 +1047,22 @@ const OVERVIEW_CODE = `return await (async () => {
       try { x = c.getState_X(); y = c.getState_Y(); } catch (e) {}
       return { id: c.getState_PrimitiveId ? c.getState_PrimitiveId() : '', d, n, t, x, y };
     });
-    out.wireCount = (wires || []).length;
-    try { for (const w of (wires || [])) { const n = w.getState_Net ? w.getState_Net() : ''; if (n) nets.add(n); } } catch (e) {}
+    out.wireCount = wires.length;
+    try { for (const w of wires) { const n = w.getState_Net ? w.getState_Net() : ''; if (n) nets.add(n); } } catch (e) {}
     out.nets = [...nets];
   } else {
     const grab = async (api) => {
-      try { const all = await eda[api].getAll(); return (all || []).map(x => {
+      const r = await pull(() => eda[api].getAll(), api);
+      if (!r.ok) { out.degraded.push(r.label + ': ' + r.err); return []; }
+      return (r.value || []).map(x => {
         let d = ''; let n = ''; let x = 0; let y = 0;
         try { d = (x.getState_Designator ? x.getState_Designator() : '') || ''; } catch (e) {}
         try { n = (x.getState_Net ? x.getState_Net() : '') || ''; } catch (e) {}
         try { x = x.getState_X(); y = x.getState_Y(); } catch (e) {}
         return { id: x.getState_PrimitiveId ? x.getState_PrimitiveId() : '', d, n, t: 'part', x, y };
-      }); } catch (e) { return []; }
+      });
     };
-    const comps = await grab('pcb_PrimitiveComponent');
-    const vias = await grab('pcb_PrimitiveVia');
-    const lines = await grab('pcb_PrimitiveLine');
+    const [comps, vias, lines] = await Promise.all([grab('pcb_PrimitiveComponent'), grab('pcb_PrimitiveVia'), grab('pcb_PrimitiveLine')]);
     out.components = comps; out.viaCount = vias.length; out.lineCount = lines.length; out.wireCount = 0;
     const nets = new Set();
     for (const x of [...comps, ...vias, ...lines]) if (x.n) nets.add(x.n);
@@ -1074,7 +1093,7 @@ function edaTraceTool(backend) {
           error: { type: 'string' },
         },
       },
-      render: (_args, value) => ({ type: 'text', text: value?.ok ? `✅ 截图已保存: ${value.path}（${((value.size ?? 0) / 1024).toFixed(1)}KB）` : `截图失败: ${value?.error ?? '?'}` }),
+      render: (_args, value) => [{ type: 'text', text: value?.ok ? `✅ 截图已保存: ${value.path}（${((value.size ?? 0) / 1024).toFixed(1)}KB）` : `截图失败: ${value?.error ?? '?'}` }],
     },
     async execute(args) {
       const r = await backend.execute(TRACE_CODE, 60000)
@@ -1120,7 +1139,7 @@ function edaVerifyTool(handle, backend) {
           note: { type: 'string' },
         },
       },
-      render: (_args, value) => ({
+      render: (_args, value) => [{
         type: 'text',
         text: [
           `验收: ${value?.ok ? '完成' : '部分失败'}`,
@@ -1130,7 +1149,7 @@ function edaVerifyTool(handle, backend) {
           ...(value?.errors ?? []).map((e) => `⚠ ${e}`),
           value?.note ?? '',
         ].filter(Boolean).join('\n'),
-      }),
+      }],
     },
     async execute(_args, exec) {
       const sid = sessionIdOf(exec)
@@ -1289,7 +1308,7 @@ function edaSkillReadTool() {
         },
       },
       render: (_args, value) => {
-        if (value?.ok !== true) return { type: 'text', text: `紧急保存失败: ${value?.error ?? '?'}` }
+        if (value?.ok !== true) return [{ type: 'text', text: `紧急保存失败: ${value?.error ?? '?'}` }]
         const lines = [
           `✅ 已紧急保存 → ${value.dir ?? ''}`,
           `文件: ${(value?.files ?? []).map((f) => f.name).join(', ') || '无'}`,
@@ -1297,7 +1316,7 @@ function edaSkillReadTool() {
           value?.preview ? `通用预览: ${value.preview}` : '',
         ].filter((s) => s !== '')
         if ((value?.errors ?? []).length > 0) lines.push(`降级项: ${value.errors.join('; ')}`)
-        return { type: 'text', text: lines.join('\n') }
+        return [{ type: 'text', text: lines.join('\n') }]
       },
     },
     async execute(_args, exec) {
@@ -1324,6 +1343,387 @@ function edaSkillReadTool() {
   })
 }
 
+/** ---------------------------------------------------- deterministic wrappers */
+
+/** 系统库搜索 + 放置（sch）：搜索→create→读位号/引脚；pins 供画线用。 */
+function schPlaceCode(keyword, x, y) {
+  return `return await (async () => {
+    const devices = await eda.lib_Device.search(${JSON.stringify(keyword)});
+    if (!devices || devices.length === 0) return { ok: false, error: '未搜索到器件' };
+    const dev = devices[0];
+    const comp = await eda.sch_PrimitiveComponent.create(dev, ${x}, ${y}, undefined, 0, false, true, true);
+    const id = comp.getState_PrimitiveId();
+    let ref = ''; try { ref = comp.getState_Designator() || ''; } catch (e) {}
+    let name = ''; try { name = dev.name || ''; } catch (e) { name = dev.name || ''; }
+    let pins = [];
+    try { const ps = await eda.sch_PrimitiveComponent.getAllPinsByPrimitiveId(id); for (const p of (ps || [])) pins.push({ x: p.getState_X(), y: p.getState_Y() }); } catch (e) {}
+    return { ok: true, ref, id, pins, x: ${x}, y: ${y}, name, note: 'sch 原理图元件' };
+  })();`
+}
+
+function pcbPlaceCode(keyword, x, y) {
+  return `return await (async () => {
+    const devices = await eda.lib_Device.search(${JSON.stringify(keyword)});
+    if (!devices || devices.length === 0) return { ok: false, error: '未搜索到器件' };
+    const dev = devices[0];
+    const comp = await eda.pcb_PrimitiveComponent.create(dev, 1, ${x}, ${y}, 0, false);
+    const id = comp.getState_PrimitiveId();
+    let ref = ''; try { ref = comp.getState_Designator() || ''; } catch (e) {}
+    let name = ''; try { name = dev.name || ''; } catch (e) { name = dev.name || ''; }
+    let pins = [];
+    try { const rf = await eda.pcb_PrimitiveComponent.get(id); if (rf) { const ps = await rf.getAllPins(); for (const p of (ps || [])) pins.push({ x: p.getState_X(), y: p.getState_Y() }); } } catch (e) {}
+    return { ok: true, ref, id, pins, x: ${x}, y: ${y}, name, note: 'pcb 元件' };
+  })();`
+}
+
+/** 引脚级连线（sch）：sch_PrimitiveWire.create(segments, net, …)。 */
+function schWireCode(points, net) {
+  const pts = JSON.stringify(points)
+  const netStr = (typeof net === 'string' && net !== '') ? JSON.stringify(net) : 'null'
+  return `return await (async () => {
+    const wire = await eda.sch_PrimitiveWire.create(${pts}, ${netStr}, null, null, null);
+    let id = ''; try { id = (wire && wire.getState_PrimitiveId) ? wire.getState_PrimitiveId() : ''; } catch (e) {}
+    return { ok: true, primitives: id ? [id] : [], note: 'sch 导线' };
+  })();`
+}
+
+/** 引脚级连线（pcb）：每对相邻点一条 pcb_PrimitiveLine.create（TOP 层 / 宽 10）。 */
+function pcbWireCode(points, net) {
+  const pts = JSON.stringify(points)
+  const netStr = JSON.stringify((typeof net === 'string' && net !== '') ? net : '')
+  return `return await (async () => {
+    const pts = ${pts};
+    const net = ${netStr};
+    const segs = [];
+    for (let i = 0; i + 3 < pts.length; i += 2) {
+      const line = await eda.pcb_PrimitiveLine.create(net, 1, pts[i], pts[i + 1], pts[i + 2], pts[i + 3], 10);
+      let id = ''; try { id = (line && line.getState_PrimitiveId) ? line.getState_PrimitiveId() : ''; } catch (e) {}
+      if (id) segs.push(id);
+    }
+    return { ok: true, primitives: segs, note: 'pcb 走线（TOP 层 / 宽 10）' };
+  })();`
+}
+
+function schNetflagCode(type, net, x, y) {
+  return `return await (async () => {
+    const flag = await eda.sch_PrimitiveComponent.createNetFlag(${JSON.stringify(type)}, ${JSON.stringify(net)}, ${x}, ${y}, 0, false);
+    if (!flag) return { ok: false, error: 'createNetFlag 未返回图元' };
+    let id = ''; try { id = flag.getState_PrimitiveId ? flag.getState_PrimitiveId() : ''; } catch (e) {}
+    return { ok: true, id, net: ${JSON.stringify(net)}, x: ${x}, y: ${y} };
+  })();`
+}
+
+function saveDocCode() {
+  return `return await (async () => {
+    const info = await eda.dmt_SelectControl.getCurrentDocumentInfo();
+    const isPcb = info?.documentType === 3;
+    const saved = isPcb ? await eda.pcb_Document.save() : await eda.sch_Document.save();
+    return { ok: true, saved: saved === true, docType: info?.documentType ?? (isPcb ? 3 : 1) };
+  })();`
+}
+
+/** eda_place：搜索器件→框内定位→放置一体，并返回引脚坐标（连线用）。 */
+function edaPlaceTool(backend) {
+  return defineTool({
+    name: 'eda_place',
+    description: 'Search the system library (keyword), pick a collision-free spot, then place the component in ONE step and return its pins (for wiring). ' +
+      'kind=sch (default, units 10mil) | pcb (units 1mil). value is optional metadata (default \'?\'). ' +
+      'Triggers: 放一个元件, place a part, 搜索并放置, put LED on the schematic.',
+    parameters: {
+      keyword: { type: 'string', required: true, description: '系统库搜索关键词，如 LED / R0402 / 10K / ESP32' },
+      kind: { type: 'string', description: 'sch（默认，原理图）| pcb' },
+      value: { type: 'string', description: '可选：值（默认 \'?\'）' },
+    },
+    output: {
+      schema: {
+        type: 'object',
+        additionalProperties: false,
+        properties: {
+          ok: { type: 'boolean', required: true },
+          ref: { type: 'string' },
+          id: { type: 'string' },
+          pins: {
+            type: 'array',
+            items: {
+              type: 'object',
+              additionalProperties: false,
+              properties: {
+                x: { type: 'number', required: true },
+                y: { type: 'number', required: true },
+              },
+            },
+          },
+          x: { type: 'number' },
+          y: { type: 'number' },
+          name: { type: 'string' },
+          note: { type: 'string' },
+          error: { type: 'string' },
+        },
+      },
+      render: (_args, value) => {
+        if (value?.ok !== true) return [{ type: 'text', text: `放置失败: ${value?.error ?? '?'}` }]
+        const lines = [
+          `✅ 已放置 ${value.name || '元件'}（${value.ref || '?'}）@(${value.x}, ${value.y})`,
+          `primitiveId: ${value.id}`,
+          `引脚(${(value.pins ?? []).length}): ${(value.pins ?? []).map((p) => `(${p.x},${p.y})`).join(' ') || '无'}`,
+        ]
+        if (value.note) lines.push(`note: ${value.note}`)
+        return [{ type: 'text', text: lines.join('\n') }]
+      },
+    },
+    async execute(args, exec) {
+      const sid = sessionIdOf(exec)
+      const keyword = typeof args?.keyword === 'string' ? args.keyword.trim() : ''
+      if (keyword === '') {
+        pushActivity({ sid, tool: 'eda_place', action: '放置元件', ok: false, error: 'keyword 不能为空' })
+        return { ok: false, error: 'keyword 不能为空（系统库搜索关键词）', ref: '', id: '', pins: [], x: 0, y: 0, name: '', note: '' }
+      }
+      const kind = args?.kind === 'pcb' ? 'pcb' : 'sch'
+      const value = typeof args?.value === 'string' && args.value !== '' ? args.value : '?'
+      await backend.refresh() // live facts before gating
+      if (!statusOf(backend).connected) {
+        pushActivity({ sid, tool: 'eda_place', action: '放置元件', ok: false, error: '官方桥未连接（门控拦截）' })
+        return { ok: false, error: '官方桥未连接：请先 eda_backend_connect（并确认扩展 Run API Gateway 已装且开启「外部交互」）。', ref: '', id: '', pins: [], x: 0, y: 0, name: '', note: '' }
+      }
+      // 选点：显式坐标优先；否则读版图挑空位（最多 3 个候选重试）。
+      let candidates = []
+      if (Number.isFinite(args?.x) && Number.isFinite(args?.y)) {
+        candidates = [{ x: Number(args.x), y: Number(args.y) }]
+      } else if (kind === 'sch') {
+        const layout = await readSchLayout(backend)
+        if (!layout.ok) return { ok: false, error: layout.error, ref: '', id: '', pins: [], x: 0, y: 0, name: '', note: '' }
+        candidates = pickSpots({ pageWidth: layout.width, pageHeight: layout.height, used: layout.used, count: 3 })
+      } else {
+        const layout = await readPcbLayout(backend)
+        if (!layout.ok) return { ok: false, error: layout.error, ref: '', id: '', pins: [], x: 0, y: 0, name: '', note: '' }
+        candidates = pickSpotsPcb(layout.used, 3)
+      }
+      if (candidates.length === 0) {
+        return { ok: false, error: '未找到可放置的空位（可先 eda_pick_spot 或检查页面尺寸）', ref: '', id: '', pins: [], x: 0, y: 0, name: '', note: '' }
+      }
+      const actId = pushPendingActivity({ sid, tool: 'eda_place', action: '放置元件' })
+      const t0 = Date.now()
+      let lastError = ''
+      for (const cand of candidates.slice(0, 3)) {
+        const code = kind === 'pcb' ? pcbPlaceCode(keyword, cand.x, cand.y) : schPlaceCode(keyword, cand.x, cand.y)
+        const r = await backend.execute(code, 30000)
+        if (r.ok) {
+          let j = null
+          try { j = JSON.parse(r.result) } catch { j = null }
+          if (j?.ok === true) {
+            updateActivity(actId, { status: 'done', ok: true, action: '放置元件', result: `${j.name || keyword}（${j.ref || '?'}）@(${cand.x},${cand.y})·${(j.pins ?? []).length} 引脚`, durationMs: Date.now() - t0 })
+            return {
+              ok: true, ref: j.ref ?? '', id: j.id ?? '', pins: j.pins ?? [],
+              x: Number(j.x ?? cand.x), y: Number(j.y ?? cand.y), name: j.name ?? '',
+              note: j.note ?? (value === '?' ? '' : `值: ${value}`),
+            }
+          }
+          lastError = j?.error || r.error || '放置失败'
+        } else {
+          lastError = r.error
+        }
+      }
+      updateActivity(actId, { status: 'error', ok: false, action: '放置元件', error: lastError, durationMs: Date.now() - t0 })
+      return { ok: false, error: lastError || '放置失败', ref: '', id: '', pins: [], x: candidates[0]?.x ?? 0, y: candidates[0]?.y ?? 0, name: '', note: '' }
+    },
+  })
+}
+
+/** eda_wire：引脚/点连线（平铺坐标；服务端校验水平/垂直）。 */
+function edaWireTool(backend) {
+  return defineTool({
+    name: 'eda_wire',
+    description: 'Draw wires between given points: flat coordinates [x1,y1,x2,y2,...] (each segment must be horizontal or vertical — validated server-side). ' +
+      'kind=sch (default) | pcb (TOP layer, width 10). net is an optional network name. ' +
+      'Triggers: 画导线, connect pins, 连线, draw wire, 引脚级连线.',
+    parameters: {
+      points: { type: 'array', items: { type: 'number' }, description: '平铺坐标 [x1,y1,x2,y2,...]（必须水平或垂直段）' },
+      net: { type: 'string', description: '可选：网络名' },
+      kind: { type: 'string', description: 'sch（默认）| pcb（固用 TOP 层、线宽 10）' },
+    },
+    output: {
+      schema: {
+        type: 'object',
+        additionalProperties: false,
+        properties: {
+          ok: { type: 'boolean', required: true },
+          primitives: { type: 'array', items: { type: 'string' } },
+          note: { type: 'string' },
+          error: { type: 'string' },
+        },
+      },
+      render: (_args, value) => {
+        if (value?.ok !== true) return [{ type: 'text', text: `画导线失败: ${value?.error ?? '?'}` }]
+        return [{ type: 'text', text: `✅ 已画 ${(value.primitives ?? []).length} 段导线\nids: ${(value.primitives ?? []).join(', ') || '无'}${value.note ? '\n' + value.note : ''}` }]
+      },
+    },
+    async execute(args, exec) {
+      const sid = sessionIdOf(exec)
+      // 先校验参数（再连桥），保证参数错误与桥无关。
+      const pts = Array.isArray(args?.points) ? args.points : null
+      if (!pts || pts.length < 4) {
+        pushActivity({ sid, tool: 'eda_wire', action: '画导线', ok: false, error: '至少两个点' })
+        return { ok: false, error: '至少两个点（平铺坐标 [x1,y1,x2,y2,...]）', primitives: [], note: '' }
+      }
+      if (pts.length % 2 !== 0) {
+        return { ok: false, error: '坐标必须成对（每个点 x,y 两个数）', primitives: [], note: '' }
+      }
+      for (let i = 0; i + 3 < pts.length; i += 2) {
+        const x1 = Number(pts[i]); const y1 = Number(pts[i + 1]); const x2 = Number(pts[i + 2]); const y2 = Number(pts[i + 3])
+        if (!Number.isFinite(x1) || !Number.isFinite(y1) || !Number.isFinite(x2) || !Number.isFinite(y2)) {
+          return { ok: false, error: `第 ${i / 2 + 1} 段坐标非法`, primitives: [], note: '' }
+        }
+        if (x1 !== x2 && y1 !== y2) {
+          return { ok: false, error: `第 ${i / 2 + 1} 段不是水平/垂直（dx=${x2 - x1}, dy=${y2 - y1}）`, primitives: [], note: '' }
+        }
+      }
+      const kind = args?.kind === 'pcb' ? 'pcb' : 'sch'
+      const net = typeof args?.net === 'string' && args.net !== '' ? args.net : ''
+      await backend.refresh()
+      if (!statusOf(backend).connected) {
+        pushActivity({ sid, tool: 'eda_wire', action: '画导线', ok: false, error: '官方桥未连接（门控拦截）' })
+        return { ok: false, error: '官方桥未连接：请先 eda_backend_connect（并确认扩展 Run API Gateway 已装且开启「外部交互」）。', primitives: [], note: '' }
+      }
+      const code = kind === 'pcb' ? pcbWireCode(pts, net) : schWireCode(pts, net)
+      const actId = pushPendingActivity({ sid, tool: 'eda_wire', action: '画导线', code })
+      const t0 = Date.now()
+      const r = await backend.execute(code, 30000)
+      if (r.ok) {
+        let j = null
+        try { j = JSON.parse(r.result) } catch { j = null }
+        if (j?.ok === true) {
+          updateActivity(actId, { status: 'done', ok: true, action: '画导线', result: `${(j.primitives ?? []).length} 段`, durationMs: Date.now() - t0 })
+          return { ok: true, primitives: j.primitives ?? [], note: j.note ?? '' }
+        }
+        updateActivity(actId, { status: 'error', ok: false, action: '画导线', error: j?.error || r.error, durationMs: Date.now() - t0 })
+        return { ok: false, error: j?.error || r.error || '画导线失败', primitives: [], note: '' }
+      }
+      updateActivity(actId, { status: 'error', ok: false, action: '画导线', error: r.error, durationMs: Date.now() - t0 })
+      return { ok: false, error: r.error, primitives: [], note: '' }
+    },
+  })
+}
+
+/** eda_netflag：网络标志（sch）。 */
+function edaNetflagTool(backend) {
+  const TYPES = ['Power', 'Ground', 'AnalogGround', 'ProtectGround']
+  return defineTool({
+    name: 'eda_netflag',
+    description: 'Place a net flag (power / ground) on the schematic at (x,y). type must be one of Power / Ground / AnalogGround / ProtectGround. ' +
+      'Triggers: 放网络标志, 电源/地, net flag, connect to GND.',
+    parameters: {
+      type: { type: 'string', required: true, description: "'Power'|'Ground'|'AnalogGround'|'ProtectGround'" },
+      net: { type: 'string', required: true, description: '网络名' },
+      x: { type: 'integer', required: true, description: 'X 坐标（10mil）' },
+      y: { type: 'integer', required: true, description: 'Y 坐标（10mil）' },
+    },
+    output: {
+      schema: {
+        type: 'object',
+        additionalProperties: false,
+        properties: {
+          ok: { type: 'boolean', required: true },
+          id: { type: 'string' },
+          net: { type: 'string' },
+          x: { type: 'integer' },
+          y: { type: 'integer' },
+          error: { type: 'string' },
+        },
+      },
+      render: (_args, value) => {
+        if (value?.ok !== true) return [{ type: 'text', text: `网络标志失败: ${value?.error ?? '?'}` }]
+        return [{ type: 'text', text: `✅ 网络标志「${value.net}」@(${value.x}, ${value.y})${value.id ? '  id: ' + value.id : ''}` }]
+      },
+    },
+    async execute(args, exec) {
+      const sid = sessionIdOf(exec)
+      const type = args?.type
+      if (typeof type !== 'string' || !TYPES.includes(type)) {
+        return { ok: false, error: `type 必须是 ${TYPES.join('/')}`, id: '', net: '', x: 0, y: 0 }
+      }
+      const net = typeof args?.net === 'string' && args.net.trim() !== '' ? args.net.trim() : ''
+      if (net === '') {
+        return { ok: false, error: 'net 不能为空', id: '', net: '', x: 0, y: 0 }
+      }
+      const x = Number(args?.x); const y = Number(args?.y)
+      if (!Number.isFinite(x) || !Number.isFinite(y)) {
+        return { ok: false, error: 'x/y 必须是坐标', id: '', net: '', x: 0, y: 0 }
+      }
+      await backend.refresh()
+      if (!statusOf(backend).connected) {
+        pushActivity({ sid, tool: 'eda_netflag', action: '网络标志', ok: false, error: '官方桥未连接（门控拦截）' })
+        return { ok: false, error: '官方桥未连接：请先 eda_backend_connect（并确认扩展 Run API Gateway 已装且开启「外部交互」）。', id: '', net, x, y }
+      }
+      const code = schNetflagCode(type, net, x, y)
+      const actId = pushPendingActivity({ sid, tool: 'eda_netflag', action: '网络标志', code })
+      const t0 = Date.now()
+      const r = await backend.execute(code, 30000)
+      if (r.ok) {
+        let j = null
+        try { j = JSON.parse(r.result) } catch { j = null }
+        if (j?.ok === true) {
+          updateActivity(actId, { status: 'done', ok: true, action: '网络标志', result: `${j.net}@(${j.x},${j.y})`, durationMs: Date.now() - t0 })
+          return { ok: true, id: j.id ?? '', net: j.net ?? net, x: Number(j.x ?? x), y: Number(j.y ?? y) }
+        }
+        updateActivity(actId, { status: 'error', ok: false, action: '网络标志', error: j?.error || r.error, durationMs: Date.now() - t0 })
+        return { ok: false, error: j?.error || r.error || '网络标志失败', id: '', net, x, y }
+      }
+      updateActivity(actId, { status: 'error', ok: false, action: '网络标志', error: r.error, durationMs: Date.now() - t0 })
+      return { ok: false, error: r.error, id: '', net, x, y }
+    },
+  })
+}
+
+/** eda_save：保存当前文档（sch/pcb 自动判断）。 */
+function edaSaveTool(backend) {
+  return defineTool({
+    name: 'eda_save',
+    description: 'Save the CURRENT document (auto-detects schematic vs PCB via documentType: 3 = PCB). ' +
+      'Triggers: 保存当前文档, save document, 保存画板.',
+    parameters: {},
+    output: {
+      schema: {
+        type: 'object',
+        additionalProperties: false,
+        properties: {
+          ok: { type: 'boolean', required: true },
+          saved: { type: 'boolean' },
+          docType: { type: 'integer' },
+          error: { type: 'string' },
+        },
+      },
+      render: (_args, value) => {
+        if (value?.ok !== true) return [{ type: 'text', text: `保存失败: ${value?.error ?? '?'}` }]
+        return [{ type: 'text', text: `✅ 已保存（${value.docType === 3 ? 'PCB' : '原理图'}）: ${value.saved === true ? '成功' : '失败'}` }]
+      },
+    },
+    async execute(_args, exec) {
+      const sid = sessionIdOf(exec)
+      await backend.refresh()
+      if (!statusOf(backend).connected) {
+        pushActivity({ sid, tool: 'eda_save', action: '保存文档', ok: false, error: '官方桥未连接（门控拦截）' })
+        return { ok: false, error: '官方桥未连接：请先 eda_backend_connect（并确认扩展 Run API Gateway 已装且开启「外部交互」）。', saved: false, docType: 0 }
+      }
+      const code = saveDocCode()
+      const actId = pushPendingActivity({ sid, tool: 'eda_save', action: '保存文档', code })
+      const t0 = Date.now()
+      const r = await backend.execute(code, 30000)
+      if (r.ok) {
+        let j = null
+        try { j = JSON.parse(r.result) } catch { j = null }
+        if (j?.ok === true) {
+          updateActivity(actId, { status: 'done', ok: true, action: '保存文档', result: j.saved ? '已保存' : '保存失败', durationMs: Date.now() - t0 })
+          return { ok: true, saved: j.saved === true, docType: Number(j.docType ?? 0) }
+        }
+        updateActivity(actId, { status: 'error', ok: false, action: '保存文档', error: j?.error || r.error, durationMs: Date.now() - t0 })
+        return { ok: false, error: j?.error || r.error || '保存失败', saved: false, docType: 0 }
+      }
+      updateActivity(actId, { status: 'error', ok: false, action: '保存文档', error: r.error, durationMs: Date.now() - t0 })
+      return { ok: false, error: r.error, saved: false, docType: 0 }
+    },
+  })
+}
+
 /** -------------------------------------------------------------- apply */
 
 export function apply(ctx, config) {
@@ -1397,6 +1797,10 @@ export function apply(ctx, config) {
         edaCapabilitiesTool(),
         edaSkillReadTool(),
         edaBoardOverviewTool(backend),
+        edaPlaceTool(backend),
+        edaWireTool(backend),
+        edaNetflagTool(backend),
+        edaSaveTool(backend),
         edaTraceTool(backend),
         edaVerifyTool(edaHandle, backend),
         edaSnapshotTool(edaHandle, backend),