dsh-eda-mcp 1.0.1 → 1.0.2

package/CHANGELOG.md

@@ -1,5 +1,34 @@
 # Changelog
 
+## 1.0.2 — 2026-10-20
+
+### 覆铜调查结案（扩展 0.4.7 / 0.4.8 真机）
+
+结论：**这台构建（EDA 3.2.186 / pro-api 0.3.18.0bc12bb0）无法通过 API 创建铜面图元**。不是参数问题，证据链如下。
+
+| 尝试 | 结果 |
+|---|---|
+| `pcb_PrimitivePour.create` 静态入口 × 8 种组合（单/复杂多边形、原始源码数组、空网络、层 1/2/字符串、全参数显式、100×100 与 300×300 mil） | 全部 `无法创建覆铜边框图元` |
+| 实例入口 `new IPCB_PrimitivePour(...).create()`（0.4.7 新增，验证构造器在运行时可取） | 同样报错 |
+| 填充方式 `solid`/`45grid`/`90grid`/`0`/`1`/`2`/`SOLID`/`GRID45`/`45GRID` | 全部报错 |
+| `pcb_PrimitiveFill.create`（文档说明它同样带 `net` 参数）× 4 种（对象/原始数组/复杂源码/显式 fillMode） | 全部 `无法创建填充图元` |
+| **控制组**：同一多边形管线写丝印折线 `pcb_PrimitivePolyline` / `pcb_draw_polyline` | 也写不出来（`getAll` 0 条），而 `pcb_get_polylines` 内部路径能读到既有板框 1 条 |
+
+外部资料也到此为止：`prodocs` 正文是前端渲染（HTML 只有导航），官方配方给的流程就是我们实现的那条（`createPolygon`/`createComplexPolygon` → pour → `rebuildCopperRegion`），搜 "无法创建覆铜边框图元" 无任何社区解法，应用 bundle 内也搜不到该字符串。
+
+**因此撤掉 `pcb_create_copper_fill`**：它在这台构建上必然失败，留着就是给调用方挖坑。白名单里的 `pcb_MathPolygon.createComplexPolygon` 与 `pcb_PrimitiveFill.*` 保留（换构建可能有效），但不再包装成工具。
+
+**正解**：覆铜在界面手工铺（GND → 顶层+底层 → 重新铺铜）；`eda_design_audit` 会持续把缺覆铜记成 `copper-pour` warn，`eda_delivery_checklist` 也会带上它。
+
+
+### 通知堆叠 / 粘连（扩展 0.4.9）
+
+屏幕实测：三条提示叠在画布上（"未连接…点击右侧按钮"、"扩展已加载 v0.4.8"、"已连接；端口 39009"），且"未连接"那条永不消失。
+
+- 根因：`showToastMessage` 的 `timer: 0` 语义是**永不自动隐藏**，而 `SYS_Message` **没有任何隐藏或替换 API**；连接成功时也没有人撤掉它。
+- 修法：未连接提示改成 `showFollowMouseTip(tip, 8000)`，并在 WebSocket `onopen` 里 `removeFollowMouseTip` 显式撤掉；`showToast` 一律传有限时长（默认 4 s）；文案改为"菜单 DSH MCP → 连接 DSH MCP 服务器"（跟随提示没有按钮）。
+- 线协议 **0.4.8 → 0.4.9**（纯 UI 层）。
+
 ## 1.0.1 — 2026-10-20
 
 1.0.0 的真机回归修掉 4 个 bug（全部由"跑一遍"发现，不是靠读代码）：

package/docs/schematic-workflow.md

@@ -146,7 +146,7 @@
 | eda_launch 带 project 没打开工程 | 命令行路径被应用忽略 | 用 eda_open_project({ name }) 打开 |
 | 关应用后改动丢失 | eda_close 走了强制路径 | 关前先保存；看返回的 forced |
 | run_code 读大 JSON 被截断 | 宿主 read 有单行上限 | 用 node:fs 读盘或分片读 |
-| 覆铜创建失败（无法创建覆铜边框图元） | 应用侧限制：polygonStage=ok（轮廓被接受）但 pours 被拒，与网络/填充方式/坐标无关 | 工具会重试一次并给出该诊断；手工在 PCB 页框选覆铜（GND，顶层+底层），design_audit 记为 warn |
+| 覆铜/填充一律被拒（无法创建覆铜边框图元 / 无法创建填充图元） | 应用侧限制：静态+实例入口、单/复杂多边形、原始源码数组、6 种填充枚举、全参数组合全部被拒；同一多边形管线在本构建上连丝印折线都写不出来 | 不要在 API 层反复试：覆铜请在界面手工铺（GND、顶层+底层）；design_audit 持续记 copper-pour warn |
 | pcb_draw_mounting_hole 报“无法创建焊盘图元” | pad 形状必填，且槽孔只能用 ELLIPSE | 已内建：圆孔 ELLIPSE(d,d)，槽孔 ELLIPSE(长,宽)+hole[SLOT,宽,长]；OBLONG/RECTANGLE 焊盘会被拒 |
 | pcb_PrimitiveString.getAll / pcb_PrimitivePad.getAll 返回 0 | 这两个 API 按层查询 | 传 layer：丝印 3/4，多层焊盘 12；不传参恒为 0 |
 | 按坐标算的越界没被发现 | 图框/原点假设与真实页面不一致 | 用 eda_get_page_info 的真实值 + eda_capture 导 PNG 看实际版面 |

package/jlc-extension/api-bridge.js

@@ -212,6 +212,9 @@ function dshEdaMcpStatus() {
     'pcb_PrimitivePad.create',
     'pcb_PrimitivePad.getAll',
     'pcb_PrimitivePad.delete',
+    'pcb_PrimitiveFill.create',
+    'pcb_PrimitiveFill.getAll',
+    'pcb_PrimitiveFill.delete',
     'pcb_PrimitivePour.create',
     'pcb_PrimitivePour.modify',
     'pcb_PrimitivePour.delete',
@@ -459,21 +462,54 @@ function dshEdaMcpStatus() {
         : undefined;
       if (!pourPolygon) pourPolygon = eda.pcb_MathPolygon.createPolygon(pourSource);
       if (!pourPolygon) throw new Error('dsh.internal.pourCreate: invalid polygon source ' + JSON.stringify(pourSource));
-      var pour = await eda.pcb_PrimitivePour.create(
-        optional(pourArgs[0]), optional(pourArgs[1]), pourPolygon, optional(pourArgs[3]), optional(pourArgs[4]),
-        optional(pourArgs[5]), optional(pourArgs[6]), optional(pourArgs[7]), optional(pourArgs[8])
-      );
+      // Route 1: the documented static factory.
+      var pourRoutes = [];
+      var pour = null;
+      var usedRoute = 'static';
+      try {
+        pour = await eda.pcb_PrimitivePour.create(
+          optional(pourArgs[0]), optional(pourArgs[1]), pourPolygon, optional(pourArgs[3]), optional(pourArgs[4]),
+          optional(pourArgs[5]), optional(pourArgs[6]), optional(pourArgs[7]), optional(pourArgs[8])
+        );
+      } catch (staticError) {
+        pourRoutes.push('static: ' + (staticError && staticError.message ? staticError.message : String(staticError)));
+      }
+      // Route 2: the instance entry point (@internal in the typings, but the class
+      // constructor is exported at runtime on some builds).
       if (!pour) {
-        throw new Error('dsh.internal.pourCreate: pcb_PrimitivePour.create returned undefined (net/layer/polygon rejected; copper layers only)');
+        var PourCtor = null;
+        try {
+          if (typeof eda.IPCB_PrimitivePour === 'function') PourCtor = eda.IPCB_PrimitivePour;
+          else if (eda.pcb_PrimitivePour && typeof eda.pcb_PrimitivePour.constructor === 'function' && eda.pcb_PrimitivePour.constructor !== Object) PourCtor = eda.pcb_PrimitivePour.constructor;
+        } catch (ctorProbeError) { PourCtor = null; }
+        if (PourCtor !== null) {
+          usedRoute = 'instance';
+          try {
+            var pourInstance = new PourCtor(
+              optional(pourArgs[0]), optional(pourArgs[1]), pourPolygon, optional(pourArgs[3]), optional(pourArgs[4]),
+              optional(pourArgs[5]), optional(pourArgs[6]), optional(pourArgs[7]), optional(pourArgs[8])
+            );
+            pour = await pourInstance.create();
+          } catch (instanceError) {
+            pourRoutes.push('instance: ' + (instanceError && instanceError.message ? instanceError.message : String(instanceError)));
+            usedRoute = 'none';
+          }
+        } else {
+          pourRoutes.push('instance: no exported constructor');
+          usedRoute = 'none';
+        }
       }
-      // A pour border alone leaves no copper: the region has to be rebuilt for the
-      // fill (and the clearance against other nets) to be computed.
+      if (!pour) {
+        throw new Error('dsh.internal.pourCreate: every route refused (' + pourRoutes.join(' | ') + ')');
+      }
+      // A pour border alone leaves no copper: rebuild so the fill (and the clearance
+      // against other nets) is actually computed.
       var rebuilt = false;
       if (pour && typeof pour.rebuildCopperRegion === 'function') {
         try { await pour.rebuildCopperRegion(); rebuilt = true; } catch (error) { rebuilt = false; }
       }
       var pourJson = toJsonable(pour);
-      if (pourJson && typeof pourJson === 'object') pourJson.rebuilt = rebuilt;
+      if (pourJson && typeof pourJson === 'object') { pourJson.rebuilt = rebuilt; pourJson.route = usedRoute; }
       return pourJson;
     }
     // Internal helper: long-running jobs (auto-routing / auto-layout) are started
@@ -579,6 +615,9 @@ function dshEdaMcpStatus() {
         function () {
           wsReady = true;
           lastPongAt = Date.now();
+          // The 'not connected' tip is sticky by design while we are offline; once the
+          // socket is up it must go away, otherwise it sits on the canvas forever.
+          hideConnectTip();
           sendObject({ type: 'hello', version: VERSION });
         }
       );
@@ -599,10 +638,11 @@ function dshEdaMcpStatus() {
     registerWebSocket();
   }
 
-  function showToast(message, type) {
+  function showToast(message, type, seconds) {
     try {
       if (typeof eda !== 'undefined' && eda.sys_Message && typeof eda.sys_Message.showToastMessage === 'function') {
-        eda.sys_Message.showToastMessage(message, type || 'info');
+        // Always pass a finite timer: omitting it (or 0) leaves the toast on screen forever.
+        eda.sys_Message.showToastMessage(message, type || 'info', seconds || 4);
       } else {
         console.log('[dsh-eda-mcp] ' + message);
       }
@@ -706,20 +746,30 @@ function dshEdaMcpStatus() {
     }
   }
 
+  // One removable tip instead of a stack of toasts: showToastMessage has no hide API
+  // (timer:0 meant "never"), so a stack of them used to pile up over the canvas and the
+  // '未连接' banner survived even after the connection was established (measured).
+  var CONNECT_TIP = 'DSH MCP 未连接：菜单 DSH MCP → 连接 DSH MCP 服务器（ws://127.0.0.1:39009/ws）';
+
+  function hideConnectTip() {
+    try {
+      if (typeof eda !== 'undefined' && eda.sys_Message && typeof eda.sys_Message.removeFollowMouseTip === 'function') {
+        eda.sys_Message.removeFollowMouseTip(CONNECT_TIP);
+      }
+    } catch (_) { /* ignore */ }
+  }
+
   function showConnectToast() {
     if (wsReady) return;
     try {
       if (typeof eda === 'undefined' || !eda.sys_Message) return;
-      eda.sys_Message.showToastMessage(
-        'DSH MCP 未连接。点击右侧按钮连接本地桥接服务（ws://127.0.0.1:39009/ws）。',
-        'warning',
-        0,
-        undefined,
-        '连接 DSH MCP',
-        "eda.sys_MessageBus.publishPublic('dsh-eda-mcp/connect', {})"
-      );
+      if (typeof eda.sys_Message.showFollowMouseTip === 'function') {
+        eda.sys_Message.showFollowMouseTip(CONNECT_TIP, 8000);
+        return;
+      }
+      eda.sys_Message.showToastMessage(CONNECT_TIP, 'warning', 8);
     } catch (error) {
-      console.error('[dsh-eda-mcp] connect toast failed:', error);
+      console.error('[dsh-eda-mcp] connect tip failed:', error);
     }
   }
 

package/jlc-extension/extension.json

@@ -2,7 +2,7 @@
   "uuid": "d5e0a1b2c3f4456789abcdef01234567",
   "name": "dsh-eda-bridge",
   "displayName": "DSH EDA MCP Bridge",
-  "version": "0.4.6",
+  "version": "0.4.9",
   "description": "Local WebSocket bridge used by the dsh-eda-mcp plugin to let DeepSeek Harness draw schematics and drive PCB operations in JLCEDA Pro through the official extension API.",
   "entry": "./api-bridge.js",
   "publisher": "dsh-eda-mcp",

package/lib/bridge.mjs

@@ -807,7 +807,7 @@ var WORKFLOW_GUIDE = WORKFLOW_SUMMARY + "\n\n" + [
 ].join("\n");
 
 // src/bridge/index.ts
-var VERSION = "0.4.6";
+var VERSION = "0.4.9";
 var WS_PORT = Number(process.env.DSH_EDA_MCP_WS_PORT ?? 39009);
 var WS_HOST = "127.0.0.1";
 var ALLOW_RAW_API = (process.env.DSH_EDA_MCP_ALLOW_RAW_API ?? "1") !== "0";

package/lib/index.js

@@ -179,7 +179,7 @@ var SKILL_PLAYBOOK_LINES = [
   "| eda_launch \u5E26 project \u6CA1\u6253\u5F00\u5DE5\u7A0B | \u547D\u4EE4\u884C\u8DEF\u5F84\u88AB\u5E94\u7528\u5FFD\u7565 | \u7528 eda_open_project({ name }) \u6253\u5F00 |",
   "| \u5173\u5E94\u7528\u540E\u6539\u52A8\u4E22\u5931 | eda_close \u8D70\u4E86\u5F3A\u5236\u8DEF\u5F84 | \u5173\u524D\u5148\u4FDD\u5B58\uFF1B\u770B\u8FD4\u56DE\u7684 forced |",
   "| run_code \u8BFB\u5927 JSON \u88AB\u622A\u65AD | \u5BBF\u4E3B read \u6709\u5355\u884C\u4E0A\u9650 | \u7528 node:fs \u8BFB\u76D8\u6216\u5206\u7247\u8BFB |",
-  "| \u8986\u94DC\u521B\u5EFA\u5931\u8D25\uFF08\u65E0\u6CD5\u521B\u5EFA\u8986\u94DC\u8FB9\u6846\u56FE\u5143\uFF09 | \u5E94\u7528\u4FA7\u9650\u5236\uFF1ApolygonStage=ok\uFF08\u8F6E\u5ED3\u88AB\u63A5\u53D7\uFF09\u4F46 pours \u88AB\u62D2\uFF0C\u4E0E\u7F51\u7EDC/\u586B\u5145\u65B9\u5F0F/\u5750\u6807\u65E0\u5173 | \u5DE5\u5177\u4F1A\u91CD\u8BD5\u4E00\u6B21\u5E76\u7ED9\u51FA\u8BE5\u8BCA\u65AD\uFF1B\u624B\u5DE5\u5728 PCB \u9875\u6846\u9009\u8986\u94DC\uFF08GND\uFF0C\u9876\u5C42+\u5E95\u5C42\uFF09\uFF0Cdesign_audit \u8BB0\u4E3A warn |",
+  "| \u8986\u94DC/\u586B\u5145\u4E00\u5F8B\u88AB\u62D2\uFF08\u65E0\u6CD5\u521B\u5EFA\u8986\u94DC\u8FB9\u6846\u56FE\u5143 / \u65E0\u6CD5\u521B\u5EFA\u586B\u5145\u56FE\u5143\uFF09 | \u5E94\u7528\u4FA7\u9650\u5236\uFF1A\u9759\u6001+\u5B9E\u4F8B\u5165\u53E3\u3001\u5355/\u590D\u6742\u591A\u8FB9\u5F62\u3001\u539F\u59CB\u6E90\u7801\u6570\u7EC4\u30016 \u79CD\u586B\u5145\u679A\u4E3E\u3001\u5168\u53C2\u6570\u7EC4\u5408\u5168\u90E8\u88AB\u62D2\uFF1B\u540C\u4E00\u591A\u8FB9\u5F62\u7BA1\u7EBF\u5728\u672C\u6784\u5EFA\u4E0A\u8FDE\u4E1D\u5370\u6298\u7EBF\u90FD\u5199\u4E0D\u51FA\u6765 | \u4E0D\u8981\u5728 API \u5C42\u53CD\u590D\u8BD5\uFF1A\u8986\u94DC\u8BF7\u5728\u754C\u9762\u624B\u5DE5\u94FA\uFF08GND\u3001\u9876\u5C42+\u5E95\u5C42\uFF09\uFF1Bdesign_audit \u6301\u7EED\u8BB0 copper-pour warn |",
   "| pcb_draw_mounting_hole \u62A5\u201C\u65E0\u6CD5\u521B\u5EFA\u710A\u76D8\u56FE\u5143\u201D | pad \u5F62\u72B6\u5FC5\u586B\uFF0C\u4E14\u69FD\u5B54\u53EA\u80FD\u7528 ELLIPSE | \u5DF2\u5185\u5EFA\uFF1A\u5706\u5B54 ELLIPSE(d,d)\uFF0C\u69FD\u5B54 ELLIPSE(\u957F,\u5BBD)+hole[SLOT,\u5BBD,\u957F]\uFF1BOBLONG/RECTANGLE \u710A\u76D8\u4F1A\u88AB\u62D2 |",
   "| pcb_PrimitiveString.getAll / pcb_PrimitivePad.getAll \u8FD4\u56DE 0 | \u8FD9\u4E24\u4E2A API \u6309\u5C42\u67E5\u8BE2 | \u4F20 layer\uFF1A\u4E1D\u5370 3/4\uFF0C\u591A\u5C42\u710A\u76D8 12\uFF1B\u4E0D\u4F20\u53C2\u6052\u4E3A 0 |",
   "| \u6309\u5750\u6807\u7B97\u7684\u8D8A\u754C\u6CA1\u88AB\u53D1\u73B0 | \u56FE\u6846/\u539F\u70B9\u5047\u8BBE\u4E0E\u771F\u5B9E\u9875\u9762\u4E0D\u4E00\u81F4 | \u7528 eda_get_page_info \u7684\u771F\u5B9E\u503C + eda_capture \u5BFC PNG \u770B\u5B9E\u9645\u7248\u9762 |",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-eda-mcp",
-  "version": "1.0.1",
+  "version": "1.0.2",
   "description": "DeepSeek Harness (DSH) plugin — connects DSH to JLCEDA Pro (EasyEDA Pro) via a local MCP bridge and draws schematics through the JLCEDA extension API.",
   "license": "Apache-2.0",
   "author": {

package/src/bridge/index.ts

@@ -21,7 +21,7 @@ import {
 } from './design-rules.ts'
 import { WORKFLOW_GUIDE, WORKFLOW_SUMMARY } from './workflow-guide.ts'
 
-const VERSION = '0.4.6'
+const VERSION = '0.4.9'
 const WS_PORT = Number(process.env.DSH_EDA_MCP_WS_PORT ?? 39009)
 const WS_HOST = '127.0.0.1'
 const ALLOW_RAW_API = (process.env.DSH_EDA_MCP_ALLOW_RAW_API ?? '1') !== '0'
@@ -3136,6 +3136,7 @@ async function executeTool(name, rawArgs, timeoutMs) {
     case 'eda_pcb_delete_via':
       return await callExtension('pcb_PrimitiveVia.delete', [String(args.primitiveId)], timeoutMs)
 
+
     case 'eda_pcb_create_pour': {
       const layer = resolveRegionLayer(args.layer, 'eda_pcb_create_pour')
       const points = requireFlatPoints(args.points, 'eda_pcb_create_pour')

package/src/skills-content.ts

@@ -153,7 +153,7 @@ export const SKILL_PLAYBOOK_LINES: readonly string[] = [
   "| eda_launch 带 project 没打开工程 | 命令行路径被应用忽略 | 用 eda_open_project({ name }) 打开 |",
   "| 关应用后改动丢失 | eda_close 走了强制路径 | 关前先保存；看返回的 forced |",
   "| run_code 读大 JSON 被截断 | 宿主 read 有单行上限 | 用 node:fs 读盘或分片读 |",
-  "| 覆铜创建失败（无法创建覆铜边框图元） | 应用侧限制：polygonStage=ok（轮廓被接受）但 pours 被拒，与网络/填充方式/坐标无关 | 工具会重试一次并给出该诊断；手工在 PCB 页框选覆铜（GND，顶层+底层），design_audit 记为 warn |",
+  "| 覆铜/填充一律被拒（无法创建覆铜边框图元 / 无法创建填充图元） | 应用侧限制：静态+实例入口、单/复杂多边形、原始源码数组、6 种填充枚举、全参数组合全部被拒；同一多边形管线在本构建上连丝印折线都写不出来 | 不要在 API 层反复试：覆铜请在界面手工铺（GND、顶层+底层）；design_audit 持续记 copper-pour warn |",
   "| pcb_draw_mounting_hole 报“无法创建焊盘图元” | pad 形状必填，且槽孔只能用 ELLIPSE | 已内建：圆孔 ELLIPSE(d,d)，槽孔 ELLIPSE(长,宽)+hole[SLOT,宽,长]；OBLONG/RECTANGLE 焊盘会被拒 |",
   "| pcb_PrimitiveString.getAll / pcb_PrimitivePad.getAll 返回 0 | 这两个 API 按层查询 | 传 layer：丝印 3/4，多层焊盘 12；不传参恒为 0 |",
   "| 按坐标算的越界没被发现 | 图框/原点假设与真实页面不一致 | 用 eda_get_page_info 的真实值 + eda_capture 导 PNG 看实际版面 |",