@windypro-rourou/dsh-eda 0.1.4 → 0.1.6

package/README.md

@@ -75,7 +75,7 @@ git clone https://github.com/WindyPro-rourou/JCL-EDA.git node_modules/@windypro-
 
 **界面适配（DSH 0.1.x / 0.2 桌面端）**：面板注册进 shell 的 **`shell.overlay` 槽位**（`position:absolute` + `z-index:30`，可拖拽调宽 120–760px 并记忆），入口是会话头部的 **header 工具位 pill**（0.2 桌面端左侧栏为槽位托管）；同时保留 0.1.x 侧边栏 DOM 入口与降级挂载。视觉优先复用宿主 UI 组件库 `@deepseek-ai/dsh-client-ui-primitives` + `--dsw-alias-*` 主题令牌——**不再使用遮挡式的 fixed 9999 覆盖层**。
 
-**限制（诚实说明）**：离线生成器支持 **9 种符号 + 6 个模板**（LED 点亮/分压/RC 延时/二极管续流/电池开关 LED/去耦/开关演示），更复杂符号（三极管/IC 等）待扩展；云端实时生成能力以官方 `eda.*` API 为准（**已知边界见 `docs/eda-conversation-skill.md` 附五缺陷速查表**：importChanges/setNetlist 不可靠、板框无 API、getNetlist('EasyEDA') 挂起、getAll 间歇失败等）。
+**限制（诚实说明）**：离线生成器支持 **9 种符号 + 6 个模板**（LED 点亮/分压/RC 延时/二极管续流/电池开关 LED/去耦/开关演示），更复杂符号（三极管/IC 等）待扩展；云端实时生成能力以官方 `eda.*` API 为准（**已知边界见 `docs/eda-conversation-skill.md` 附五缺陷速查表**：importChanges/setNetlist 不可靠、getNetlist('EasyEDA') 挂起、getAll 间歇失败等）。**v0.1.5 起**：官方 skill 知识库升级到 **1.1.56**（131 类），接入新能力——**PCB 板框改用 `pcb_PrimitivePolyline`**（官方新 Remarks 明确）、自动布线限制（900s 硬上限 / force 弹窗）、`SYS_ExternalApi` / `PCB_ImageTool` 等新类；同时新增**自动更新检测**（每小时查 npm dist-tags，有新版时在面板与系统提示里提醒）。
 
 ## 如何运行 / 开发
 

package/lib/backend.js

@@ -197,12 +197,61 @@ export class EdaBackend {
         const val = r.json?.result !== undefined ? r.json.result : r.text
         return { ok: true, result: typeof val === 'string' ? val : JSON.stringify(val) }
       }
+      // Async-task patch (community #16): a timed-out /execute returns HTTP 504
+      // WITH a taskId — the execution was NOT cancelled and late results are
+      // retained under /tasks/<id>.
+      const taskId = r.json?.taskId
+      if (taskId) {
+        return {
+          ok: false,
+          taskId,
+          error: `执行超过 ${Math.round(timeoutMs / 1000)}s（HTTP ${r.status}），任务未取消：可用 eda_task 查询 taskId=${taskId} 取迟到结果。`,
+        }
+      }
       return { ok: false, error: `execute 失败（HTTP ${r.status}）：${r.text.slice(0, 300)}` }
     } catch (error) {
       return { ok: false, error: error instanceof Error ? error.message : String(error) }
     }
   }
 
+  /** Submit code as a background task (bridge async-task patch, HTTP 202). */
+  async submitTask(code) {
+    if (this.port === null) return { ok: false, error: '官方桥未连接' }
+    try {
+      const r = await httpJson('POST', `http://127.0.0.1:${this.port}/tasks`, { code }, 20000)
+      if (r.ok && r.json?.taskId) {
+        return { ok: true, taskId: r.json.taskId, statusUrl: r.json.statusUrl ?? `/tasks/${r.json.taskId}` }
+      }
+      return { ok: false, error: r.json?.error ?? `tasks 提交失败（HTTP ${r.status}）：${r.text.slice(0, 200)}` }
+    } catch (error) {
+      return { ok: false, error: error instanceof Error ? error.message : String(error) }
+    }
+  }
+
+  /** Query one background task (status/phase/elapsedMs/result/errorDetails/events). */
+  async getTask(taskId) {
+    if (this.port === null) return { ok: false, error: '官方桥未连接' }
+    try {
+      const r = await httpJson('GET', `http://127.0.0.1:${this.port}/tasks/${encodeURIComponent(taskId)}`, undefined, 15000)
+      if (r.ok && r.json) return { ok: true, task: r.json }
+      return { ok: false, error: r.json?.error ?? `查询失败（HTTP ${r.status}）` }
+    } catch (error) {
+      return { ok: false, error: error instanceof Error ? error.message : String(error) }
+    }
+  }
+
+  /** List retained tasks (bounded, in-memory). */
+  async listTasks() {
+    if (this.port === null) return { ok: false, error: '官方桥未连接' }
+    try {
+      const r = await httpJson('GET', `http://127.0.0.1:${this.port}/tasks`, undefined, 15000)
+      if (r.ok && Array.isArray(r.json?.tasks)) return { ok: true, tasks: r.json.tasks }
+      return { ok: false, error: r.json?.error ?? `列表失败（HTTP ${r.status}）` }
+    } catch (error) {
+      return { ok: false, error: error instanceof Error ? error.message : String(error) }
+    }
+  }
+
   /**
    * Call one action: uses the official snippet for known ids, or runs a raw
    * code snippet passed in params.code (official execute accepts any code).

package/lib/capabilities.js

@@ -71,7 +71,8 @@ export const CAPABILITIES = [
     methods: [
       { name: 'pcb_PrimitiveComponent.create(dev, 1, x, y)', desc: '放元件（layer 1=TOP）；get(id)→getAllPins() 取焊盘坐标' },
       { name: 'pcb_PrimitiveVia.create(net, x, y, hole, dia)', desc: '过孔（网络名直给）' },
-      { name: 'pcb_PrimitiveLine.create(net, 1, x1,y1,x2,y2, width)', desc: '走线（TOP 层）；焊盘间连线的正解' },
+      { name: 'pcb_PrimitiveLine.create(net, 1, x1,y1,x2,y2, width)', desc: '走线（TOP 层）；焊盘间连线的正解；仅铜层（1/2/内层）可用' },
+      { name: 'pcb_PrimitivePolyline.create(net, layer, polygon, width)', desc: '折线；**板框（layer 11）正解**：polygon = pcb_MathPolygon.createPolygon([x,y,"L",x2,y2,...])，再 create("", 11, polygon, 10, false)' },
       { name: 'pcb_Document.save()', desc: '保存 PCB（每步后必调）' },
     ],
   },
@@ -97,7 +98,10 @@ export const CAPABILITIES = [
     domain: '已知边界',
     note: '官方 API 缺陷清单（实测）',
     methods: [
-      { name: 'PCB 板框 / 非铜层', desc: '板框 layer=11 无绘制入口；pcb_PrimitiveLine 非铜层（丝印/阻焊/机械等）实测失败——但 BOTTOM(2) 底层实测可用（双层走线 OK）；丝印文本 API 实测挂起' },
+      { name: 'PCB 板框 / 非铜层', desc: '板框（layer 11）用 pcb_PrimitivePolyline + pcb_MathPolygon.createPolygon（官方 1.1.56 Remarks 明确；line 接口仅铜层）；pcb_PrimitiveLine 非铜层（丝印/阻焊/机械）实测失败，BOTTOM(2) 可用；丝印文本 API 实测挂起' },
+      { name: '桥异步任务 /tasks', desc: '长操作（自动布线/大导出/批量写回）用 eda_task 提交；/execute 超时返回 HTTP 504 + taskId 且任务不取消（迟到结果保留）——桥已打社区补丁 #16' },
+      { name: 'PCB 写回顺序', desc: '必须先建过孔、后建走线（反序产生大量 Connection Error）；改铜皮后跑 DRC 前先 rebuildCopperRegion()+save（Issues #23）' },
+      { name: 'DRC 条目', desc: 'obj1.suffix 不是图元 ID（真 ID 在 objs 数组）；DRC 不幂等——一轮验证只跑一次（Issues #23/#6）' },
       { name: 'sch_Netlist.getNetlist()', desc: '挂起 30s——用 sch_ManufactureData.getNetlistFile()' },
       { name: 'getAll()', desc: '间歇性报错——重试 3 次（间隔 700ms）' },
       { name: 'PCB 电气级连网', desc: '直放元件焊盘无网络；网表同步链路不可靠——画布级可用，DRC 可能报 SMD Pad to Track' },

package/lib/client.js

@@ -194,6 +194,13 @@ window.__ModuleLoader__.load({
 .eda-pill .eda-dot { width: 6px; height: 6px; }
 .eda-pill[hidden] { display: none !important; }
 
+/* update hint (top bar) — one quiet warning-tinted pill, click to copy */
+.eda-update { flex: none; display: inline-flex; align-items: center; gap: 4px; height: 22px; padding: 0 8px;
+  border: 1px solid color-mix(in srgb, var(--eda-warn) 42%, transparent); border-radius: 999px;
+  background: color-mix(in srgb, var(--eda-warn) 10%, transparent); color: var(--eda-warn);
+  font: inherit; font-size: 10.5px; font-weight: 600; cursor: pointer; white-space: nowrap; }
+.eda-update:hover { background: color-mix(in srgb, var(--eda-warn) 18%, transparent); }
+
 /* 0.1.x sidebar entry */
 [data-dsh-eda-entry] { display: flex; align-items: center; gap: 8px; width: 100%; padding: 9px 12px; margin: 2px 0;
   border: 0; border-radius: 8px; background: transparent; color: inherit; font: inherit; cursor: pointer; text-align: left; }
@@ -204,6 +211,8 @@ window.__ModuleLoader__.load({
 		//#endregion
 
 		const API_BASE = "/api/dsh-eda";
+		/** The one upgrade command the update pill copies. */
+		const UPDATE_CMD = "dsh plugin --profile desktop add @windypro-rourou/dsh-eda@latest";
 		const LINKS = {
 			editor: "https://pro.lceda.cn/editor",
 			ext: "https://jlc-ext.com/item/oshwhub/run-api-gateway",
@@ -297,6 +306,27 @@ window.__ModuleLoader__.load({
 				h("path", { d: "M2.6 3.4l10.8 4.6-10.8 4.6 1.7-4.6z", strokeLinejoin: "round" }));
 		}
 
+		/**
+		 * Compact update hint (top bar): rendered ONLY when /status reports a
+		 * newer published release. One click copies the upgrade command; quiet,
+		 * no modal, no badge hunting. Exported for the bundle runtime test.
+		 */
+		function UpdatePill({ status }) {
+			const [copied, setCopied] = useState(false);
+			if (status?.updateAvailable !== true) return null;
+			const latest = typeof status.latestVersion === "string" ? status.latestVersion : "";
+			if (latest === "") return null;
+			const copy = () => {
+				try { navigator.clipboard?.writeText(UPDATE_CMD); } catch (e) { /* clipboard unavailable */ }
+				setCopied(true);
+				setTimeout(() => setCopied(false), 1600);
+			};
+			return h("button", {
+				type: "button", className: "eda-update", onClick: copy,
+				title: "点击复制升级命令：" + UPDATE_CMD,
+			}, copied ? "已复制 ✓" : "v" + latest + " 可更新");
+		}
+
 		/** Header pill — the 0.2 entry point (slot-owned header utilities). */
 		function HeaderPill({ store }) {
 			const open = useStore(store);
@@ -552,6 +582,7 @@ window.__ModuleLoader__.load({
 					h("div", { className: "eda-title" },
 						h("b", null, "嘉立创 EDA"),
 						h("span", null, "official bridge · v" + (status?.version ?? "—"))),
+					h(UpdatePill, { status }),
 					h("button", { className: "eda-iconbtn", onClick: () => store.set(false), title: "关闭面板", "aria-label": "关闭" }, "✕")),
 				h("div", { className: "eda-scroll" },
 					h(ConnectCard, { status, error, install, bridge, onInstall: doInstall, onStart: doStart }),
@@ -742,6 +773,8 @@ window.__ModuleLoader__.load({
 
 		exports.apply = apply;
 		exports.inject = inject;
+		// Test seam (bundle runtime test renders the update pill directly).
+		exports.UpdatePill = UpdatePill;
 		return module.exports;
 	},
 });

package/lib/index.js

@@ -38,6 +38,64 @@ import { translateRequest, TEMPLATE_CATALOG, describeDesign } from '../src/nl-to
 /** This package's manifest (name + version), read from the installed location. */
 const OWN_MANIFEST = JSON.parse(readFileSync(new URL('../package.json', import.meta.url), 'utf8'))
 
+/** Latest published version (cached 1h; null until the first successful check). */
+let latestVersion = null
+let lastVersionCheck = 0
+
+/** Simple semver compare: 1 when a > b, -1 when a < b, 0 equal/unknown. Prerelease < release. */
+function semverCompare(a, b) {
+  const parse = (v) => {
+    const m = /^(\d+)\.(\d+)\.(\d+)(?:-([0-9A-Za-z.-]+))?/.exec(v ?? '')
+    return m ? { major: Number(m[1]), minor: Number(m[2]), patch: Number(m[3]), pre: m[4] ?? null } : null
+  }
+  const pa = parse(a)
+  const pb = parse(b)
+  if (pa === null || pb === null) return 0
+  for (const key of ['major', 'minor', 'patch']) {
+    if (pa[key] !== pb[key]) return pa[key] > pb[key] ? 1 : -1
+  }
+  if (pa.pre === pb.pre) return 0
+  if (pa.pre === null) return 1 // release > prerelease
+  if (pb.pre === null) return -1
+  return pa.pre > pb.pre ? 1 : -1
+}
+
+/**
+ * Refresh the cached npm dist-tag `latest` of this package (1h cache).
+ * Offline-safe by design: every failure is swallowed and the previous value is
+ * kept, so a broken/absent registry can never disturb the plugin.
+ * @returns {Promise<{ok: boolean, error: string}>} whether the last lookup succeeded.
+ */
+async function checkLatestVersion() {
+  if (latestVersion !== null && Date.now() - lastVersionCheck < 3600_000) return { ok: true, error: '' }
+  lastVersionCheck = Date.now()
+  try {
+    const res = await fetch('https://registry.npmjs.org/-/package/' + encodeURIComponent(OWN_MANIFEST.name) + '/dist-tags', {
+      signal: AbortSignal.timeout(6000),
+    })
+    if (!res.ok) return { ok: false, error: 'npm registry 响应 HTTP ' + res.status }
+    const tags = await res.json()
+    if (typeof tags?.latest !== 'string' || tags.latest === '') return { ok: false, error: 'npm registry 未返回 latest 标签' }
+    latestVersion = tags.latest
+    return { ok: true, error: '' }
+  } catch (error) {
+    return { ok: false, error: error instanceof Error ? error.message : String(error) }
+  }
+}
+
+/** The update hint for this install (never throws; empty text when up to date). */
+function updateHint() {
+  const latest = latestVersion ?? ''
+  const available = latest !== '' && semverCompare(latest, OWN_MANIFEST.version) > 0
+  return {
+    latestVersion: latest,
+    updateAvailable: available,
+    text: available
+      ? `嘉立创 EDA 插件新版本 v${latest} 可更新（当前 v${OWN_MANIFEST.version}）：升级命令 dsh plugin --profile desktop add @windypro-rourou/dsh-eda@latest （或 npm i @windypro-rourou/dsh-eda@latest），然后重启 GUI。`
+      : '',
+  }
+}
+
 /** Stable cordis plugin name. */
 export const name = 'eda'
 
@@ -65,8 +123,9 @@ export const EDA_GUIDANCE =
   'eda_template_list / eda_translate_request（模板与需求翻译，供离线/兜底使用）。' +
   '**官方 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）。' +
+  '**已知缺陷与技巧（实测，勿踩坑）**：`pcb_Document.importChanges` 与 `pcb_Net.setNetlist` 实测不可靠（勿用于网表同步；1.1.56 文档提到 `force=true` 防弹窗但签名无此参数）；`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）用 `pcb_PrimitivePolyline` + `pcb_MathPolygon.createPolygon([…, "L", …])`**（官方 1.1.56 明确；`pcb_PrimitiveLine` 仅铜层）；自动布线单次硬上限 900s 且超时中间结果不提交。' +
+  '**超时防线（防自动退出）**：所有聚合/查询工具内部单查询 5s 封顶、并行、单项降级（返回值带 degraded 说明），单次调用总耗时有界——不会触发超时中断；`eda_exec` 可传 `timeoutMs`（默认 25000，定位挂起用 8000~15000，长导出用 45000）。**后台任务（桥已打异步补丁）**：`/execute` 超时（HTTP 504）时任务不会取消并返回 taskId（迟到结果保留）；用 `eda_task`（action=submit 提交官方 eda.* 代码 / get 查询状态与结果 / list 列表）执行自动布线、大导出、批量写回等长操作。' +
+  '**社区实测要点（官方 Issues）**：PCB 写回**必须先建过孔、后建走线**（反序会导致大量 Connection Error）；改铜皮后**跑 DRC 前先 `rebuildCopperRegion()` + save**（否则虚假 Copper Region 错误）；DRC 条目的 `obj1.suffix` **不是图元 ID**（真 ID 在 `objs` 数组）；DRC 不幂等（一轮验证只跑一次）；netport/net label 不能直接放引脚上（要从引脚画短 stub 线再放标签）；enum 全局可能未注入（`EPCB_LayerId` 等取不到时回退字面值）；`get(id)` 返回对象字段多为 null，须用 `getState_*()`。' +
   '**主动协作（能力入口）**：你能主动为用户完成——读工程/文档、放任意大类元件（搜库→定位→放置）、引脚级连线、网络标志/端口、DRC、网表/BOM 导出、PCB 元件/过孔/走线、现场截图、紧急保存。规划任务时若不确定某个 API 是否存在或怎么调，先调 `eda_capabilities`（结构化能力清单+注意事项+实测片段），再用 `eda_exec` 落地；用户提到画板相关需求时主动提议并执行，不要等用户一字一句教。' +
   '限制：v0 离线生成器仅支持 电阻/LED；云端实时生成能力由官方 eda.* API 决定（以 ~/.dsh/eda/bridge 内官方文档为准）。' +
   '用户提到「嘉立创 / 立创EDA / 原理图 / PCB草图 / 生成电路图」时即指本插件，请据此主动协作。'
@@ -249,6 +308,7 @@ async function generateSchematicJson({ description = '', template = '' } = {}) {
 /** Enriched status snapshot for the handle / routes / eda_status tool. */
 function statusOf(backend) {
   const b = backend.status()
+  const hint = updateHint()
   return {
     ready: b.running && b.connected,
     backend: b.backend,
@@ -263,6 +323,8 @@ function statusOf(backend) {
     extUrl: OFFICIAL_EXT_URL,
     error: b.error ?? '',
     version: OWN_MANIFEST.version,
+    latestVersion: hint.latestVersion,
+    updateAvailable: hint.updateAvailable,
     note: b.connected
       ? `官方桥已连接（127.0.0.1:${b.port}）：可实时执行官方 eda.* API（放元件/连线/DRC/网表/BOM）`
       : '官方桥未连接（离线生成仍可用）。一键流程：①「一键安装官方桥」→ ②「启动桥」→ ③ EasyEDA Pro 装官方扩展 Run API Gateway 并勾选「允许外部交互」→ ④ 状态变绿。',
@@ -300,6 +362,20 @@ function makeRoutes(handle) {
         writeJson(res, 200, handle.status())
       },
     },
+    {
+      kind: 'exact',
+      path: API_BASE + '/update/check',
+      handler: async (req, res) => {
+        if (!isLoopbackRequest(req)) { writeJson(res, 403, { error: 'forbidden: loopback-only' }); return }
+        if ((req.method ?? 'GET') !== 'POST') { writeJson(res, 405, { error: 'method not allowed' }); return }
+        lastVersionCheck = 0 // force a fresh npm dist-tags lookup
+        const result = await checkLatestVersion()
+        const hint = updateHint()
+        writeJson(res, 200, result.ok
+          ? { ok: true, latestVersion: hint.latestVersion, updateAvailable: hint.updateAvailable, text: hint.text }
+          : { ok: false, latestVersion: hint.latestVersion, updateAvailable: hint.updateAvailable, text: '', error: result.error })
+      },
+    },
     {
       kind: 'exact',
       path: API_BASE + '/activity',
@@ -445,6 +521,8 @@ function edaStatusTool(handle) {
           extUrl: { type: 'string' },
           error: { type: 'string' },
           version: { type: 'string' },
+          latestVersion: { type: 'string' },
+          updateAvailable: { type: 'boolean' },
           note: { type: 'string' },
         },
       },
@@ -458,6 +536,7 @@ function edaStatusTool(handle) {
         ]
         if (value?.note !== '' && value?.note != null) lines.push(`note: ${value.note}`)
         if (value?.version != null && value.version !== '') lines.push(`version: ${value.version}`)
+        if (value?.updateAvailable === true) lines.push(`update: v${value.latestVersion} 可更新`)
         return [{ type: 'text', text: lines.join('\n') }]
       },
     },
@@ -1674,6 +1753,111 @@ function edaNetflagTool(backend) {
   })
 }
 
+/**
+ * eda_task：后台任务（桥异步任务补丁，#16）。
+ * 长耗时操作（自动布线/大导出/批量写回）用 submit 提交，避免 /execute 的等待
+ * 上限；超时的 /execute 也会返回 taskId（任务未取消、迟到结果保留）。
+ */
+function edaTaskTool(backend) {
+  return defineTool({
+    name: 'eda_task',
+    description: 'Background EDA task over the official bridge (async-task patch): submit official eda.* code as a task, ' +
+      'query one task (status/phase/elapsedMs/result/errorDetails/events), or list retained tasks. ' +
+      'Use for long-running work (autorouting, large exports, bulk write-back) and to retrieve late results of a timed-out eda_exec. ' +
+      'Triggers: 后台执行, 长任务, 任务状态, async task, /tasks, 自动布线进度.',
+    parameters: {
+      action: { type: 'string', description: "'submit' | 'get' | 'list'（默认 list）" },
+      code: { type: 'string', description: 'action=submit 时：要执行的官方 eda.* 代码（如 return await eda.pcb_Document.autoRouting(...)）' },
+      taskId: { type: 'string', description: 'action=get 时：任务 id（submit 或超时的 eda_exec 返回）' },
+    },
+    output: {
+      schema: {
+        type: 'object',
+        additionalProperties: false,
+        properties: {
+          ok: { type: 'boolean', required: true },
+          taskId: { type: 'string' },
+          statusUrl: { type: 'string' },
+          status: { type: 'string' },
+          phase: { type: 'string' },
+          elapsedMs: { type: 'integer' },
+          outcome: { type: 'string' },
+          result: { type: 'string' },
+          errorText: { type: 'string' },
+          events: { type: 'array', items: { type: 'string' } },
+          tasks: { type: 'array', items: { type: 'object', additionalProperties: true, properties: {} } },
+          error: { type: 'string' },
+        },
+      },
+      render: (_args, value) => {
+        if (value?.ok !== true) return [{ type: 'text', text: `后台任务失败: ${value?.error ?? '?'}` }]
+        if (Array.isArray(value.tasks)) {
+          const lines = value.tasks.slice(0, 30).map((t) =>
+            `${t.id ?? '?'} · ${t.status ?? '?'}${t.elapsedMs ? ' · ' + t.elapsedMs + 'ms' : ''}${t.outcome ? ' · ' + t.outcome : ''}`)
+          return [{ type: 'text', text: (lines.length ? lines.join('\n') : '（无保留任务）') }]
+        }
+        if (value.taskId && value.status === undefined) {
+          return [{ type: 'text', text: `已提交任务 ${value.taskId}（${value.statusUrl ?? ''}）——用 eda_task action=get 查询` }]
+        }
+        const parts = [`任务 ${value.taskId ?? '?'}`, `状态 ${value.status ?? '?'}${value.phase ? ' / ' + value.phase : ''}`]
+        if (value.elapsedMs) parts.push(`${value.elapsedMs}ms`)
+        if (value.outcome) parts.push(`结果 ${value.outcome}`)
+        const head = parts.join(' · ')
+        if (value.errorText) return [{ type: 'text', text: `${head}\n错误: ${value.errorText}` }]
+        return [{ type: 'text', text: `${head}${value.result ? '\n' + value.result.slice(0, 1500) : ''}` }]
+      },
+    },
+    async execute(args, exec) {
+      const sid = sessionIdOf(exec)
+      await backend.refresh()
+      if (!backend.status().connected) return { ok: false, error: '官方桥未连接：请先 eda_backend_connect（并确认 Run API Gateway 已开启「外部交互」）。' }
+      const action = typeof args?.action === 'string' ? args.action : 'list'
+      const t0 = Date.now()
+
+      if (action === 'submit') {
+        const code = typeof args?.code === 'string' ? args.code.trim() : ''
+        if (code === '') return { ok: false, error: 'action=submit 需要 code（官方 eda.* 代码）' }
+        const actId = pushPendingActivity({ sid, tool: 'eda_task', action: '提交后台任务', code: code.slice(0, 120) })
+        const r = await backend.submitTask(code)
+        updateActivity(actId, {
+          status: r.ok ? 'done' : 'error', ok: r.ok,
+          action: '提交后台任务', result: r.ok ? `taskId=${r.taskId}` : '', error: r.ok ? '' : r.error,
+          durationMs: Date.now() - t0,
+        })
+        return r.ok ? { ok: true, taskId: r.taskId, statusUrl: r.statusUrl } : { ok: false, error: r.error }
+      }
+
+      if (action === 'get') {
+        const taskId = typeof args?.taskId === 'string' ? args.taskId.trim() : ''
+        if (taskId === '') return { ok: false, error: 'action=get 需要 taskId' }
+        const r = await backend.getTask(taskId)
+        if (!r.ok) return { ok: false, error: r.error }
+        const t = r.task ?? {}
+        const events = Array.isArray(t.events)
+          ? t.events.slice(-20).map((e) => (typeof e === 'string' ? e : JSON.stringify(e)))
+          : []
+        return {
+          ok: true,
+          taskId: String(t.id ?? taskId),
+          status: typeof t.status === 'string' ? t.status : '',
+          phase: typeof t.phase === 'string' ? t.phase : '',
+          elapsedMs: Number.isFinite(t.elapsedMs) ? Math.round(t.elapsedMs) : undefined,
+          outcome: typeof t.result?.outcome === 'string' ? t.result.outcome : undefined,
+          result: t.result !== undefined ? JSON.stringify(t.result).slice(0, 4000) : undefined,
+          errorText: t.errorDetails ? JSON.stringify(t.errorDetails).slice(0, 2000) : undefined,
+          events,
+        }
+      }
+
+      const r = await backend.listTasks()
+      if (!r.ok) return { ok: false, error: r.error }
+      return { ok: true, tasks: r.tasks.map((t) => ({
+        id: t.id, status: t.status, phase: t.phase, elapsedMs: t.elapsedMs, outcome: t.outcome,
+      })) }
+    },
+  })
+}
+
 /** eda_save：保存当前文档（sch/pcb 自动判断）。 */
 function edaSaveTool(backend) {
   return defineTool({
@@ -1777,7 +1961,12 @@ export function apply(ctx, config) {
       disposeSection = ctx.systemPrompt.section({
         name: 'plugin:dsh-eda',
         order: SECTION_ORDER,
-        text: EDA_GUIDANCE,
+        // Dynamic: a newer published release appends one short reminder paragraph;
+        // no update → the guidance text stays byte-identical (no blank lines).
+        text: () => {
+          const hint = updateHint()
+          return hint.updateAvailable ? `${EDA_GUIDANCE}\n\n${hint.text}` : EDA_GUIDANCE
+        },
       })
     }
     disposeRoutes = ctx.effect(() => {
@@ -1793,6 +1982,7 @@ export function apply(ctx, config) {
         edaBridgeInstallTool(backend),
         edaBackendConnectTool(edaHandle, backend),
         edaExecTool(backend),
+        edaTaskTool(backend),
         edaPickSpotTool(backend),
         edaCapabilitiesTool(),
         edaSkillReadTool(),
@@ -1839,6 +2029,10 @@ export function apply(ctx, config) {
 
   sync()
 
+  // Non-blocking update check at mount (offline-safe; never throws). `/status`
+  // and the system-prompt section read the cached value on demand.
+  if (config?.checkUpdates !== false) void checkLatestVersion()
+
   // FULLY-SELF-CONTAINED lifecycle: if the official bridge is installed, the
   // plugin starts it and connects by itself — no external babysitting.
   if (autoStartBridge && resolve().enabled && isBridgeInstalled()) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@windypro-rourou/dsh-eda",
-  "version": "0.1.4",
+  "version": "0.1.6",
   "type": "module",
   "description": "dsh-lichuang-eda (JCL-EDA): 嘉立创 EDA 助手 DSH 插件 —— 官方 eda.* API 云端实时生成（原理图/PCB）+ 离线标准版 JSON 兜底 + 面板记录式时间线（撤回/清空/紧急保存）。开箱即用：npm i 后 cordis.patch.yml insert 一行即挂载。",
   "packageManager": "pnpm@11.22.0",
@@ -43,5 +43,14 @@
   "repository": {
     "type": "git",
     "url": "https://github.com/WindyPro-rourou/JCL-EDA.git"
+  },
+  "scripts": {
+    "gen": "node src/json-gen.js",
+    "test:json": "node --test --experimental-test-isolation=none src/json-gen.test.js",
+    "test:plugin": "node selfcheck.mjs && node --experimental-test-isolation=none --test \"test/*.test.mjs\"",
+    "test:all": "npm run test:json && npm run test:plugin",
+    "check": "node --check lib/index.js && node --check lib/client.js && node --check lib/backend.js",
+    "publish:dry": "node scripts/publish.mjs --dry",
+    "publish": "node scripts/publish.mjs"
   }
 }

package/skill/INDEX.md

@@ -2,8 +2,6 @@
 
 本目录为官方 easyeda-api-skill 文档的 vendored 拷贝（含 SKILL.md 总纲、官方 README、format/ 文档格式、guide/ 教程、references/ 参考文档）。agent 通过 `eda_skill_read` 查阅：`doc` 参数填本文件内的相对路径，如 `references/classes/SCH_PrimitiveComponent.md`。
 
-**线上权威源（与本站文档对应，可 web 交叉核对）**：<https://prodocs.easyeda.com/cn/api/reference/pro-api.html>（官方「扩展 API 参考」，类/枚举与 vendored 同代；若线上有更新版本差异，以 prodocs 为准并反馈。
-
 ## 入口
 
 | 文件 | 内容 |
@@ -28,7 +26,7 @@
 | 画板截图 | DMT_EditorControl.md（getCurrentRenderedAreaImage） |
 | 文档导出/本地文件 | SYS_FileManager.md、SYS_FileSystem.md |
 
-## references/classes 类索引（127 个）
+## references/classes 类索引（131 个）
 
 ### SCH_*（21 个）
 
@@ -54,11 +52,12 @@
 - SCH_SimulationEngine
 - SCH_Utils
 
-### PCB_*（25 个）
+### PCB_*（27 个）
 
 - PCB_Document
 - PCB_Drc
 - PCB_Event
+- PCB_ImageTool
 - PCB_Layer
 - PCB_ManufactureData
 - PCB_MathPolygon
@@ -81,6 +80,7 @@
 - PCB_PrimitiveVia
 - PCB_RayTracerEngine
 - PCB_SelectControl
+- PCB_Tool
 
 ### IPCB_*/ISCH_*（31 个）
 
@@ -143,16 +143,18 @@
 - LIB_SimulationModel
 - LIB_Symbol
 
-### SYS_*（27 个）
+### SYS_*（29 个）
 
 - SYS_ClientUrl
 - SYS_Dialog
 - SYS_Environment
+- SYS_ExternalApi
 - SYS_FileManager
 - SYS_FileSystem
 - SYS_FontManager
 - SYS_FormatConversion
 - SYS_HeaderMenu
+- SYS_Help
 - SYS_I18n
 - SYS_IFrame
 - SYS_LoadingAndProgressBar
@@ -184,12 +186,12 @@
 ## 其它参考
 
 ### references/enums
-> EDMT_EditorDocumentType、EDMT_EditorSplitScreenDirection、EDMT_EditorTabEventType、EDMT_IndicatorMarkerType、EDMT_ItemType、EDMT_ProjectCollaborationMode、ELIB_DeviceJlcLibraryCategory、ELIB_LibraryType、ELIB_PreviewType、ELIB_SimulationModelType、ELIB_SymbolType、EPCB_AutoRoutingCornerStyle、EPCB_AutoRoutingExistingPrimitiveMode、EPCB_AutoRoutingOptimization、EPCB_DocumentCanvasUpdateCalculationActiveStatus、EPCB_DocumentRatlineCalculatingActiveStatus、EPCB_InactiveLayerDisplayMode、EPCB_LayerColorConfiguration、EPCB_LayerId、EPCB_LayerStatus、EPCB_LayerType、EPCB_MouseEventType、EPCB_NetEventType、EPCB_PcbPlateType、EPCB_PdfOutputMethod、EPCB_PrimitiveArcInteractiveMode、EPCB_PrimitiveDimensionType、EPCB_PrimitiveEventType、EPCB_PrimitiveFillMode、EPCB_PrimitivePadHeatWeldingConnectionMethod、EPCB_PrimitivePadHoleType、EPCB_PrimitivePadShapeType、EPCB_PrimitivePadType、EPCB_PrimitivePourFillMethod、EPCB_PrimitiveRegionRuleType、EPCB_PrimitiveStringAlignMode、EPCB_PrimitiveType、EPCB_PrimitiveViaType、ESCH_DynamicSimulationEnginePullEventType、ESCH_DynamicSimulationEnginePushEventType、ESCH_ExportDocumentFileType、ESCH_MouseEventType、ESCH_PrimitiveComponentType、ESCH_PrimitiveEventType、ESCH_PrimitiveFillStyle、ESCH_PrimitiveLineType、ESCH_PrimitivePinShape、ESCH_PrimitivePinType、ESCH_PrimitiveTextAlignMode、ESCH_PrimitiveType、ESCH_SimulationNetlistType、ESCH_SpiceSimulationEnginePullEventType、ESCH_SpiceSimulationEnginePushEventType、ESYS_BottomPanelTab、ESYS_HeaderMenuEnvironment、ESYS_ImportProjectBoardOutlineSource、ESYS_ImportProjectImportOption、ESYS_ImportProjectSchematicObjectStyle、ESYS_ImportProjectViaSolderMaskExpansion、ESYS_LeftPanelTab、ESYS_LogType、ESYS_NetlistType、ESYS_RightPanelTab、ESYS_ShortcutKeyEffectiveEditorRange、ESYS_ShortcutKeyEffectiveEditorScene、ESYS_StartPageQuickStartItem、ESYS_Theme、ESYS_ToastMessageType、ESYS_Unit、ESYS_WindowEventType、ESYS_WindowOpenTarget、NetportDeviceName、SchToolBarDeviceName
+> EDMT_EditorDocumentType、EDMT_EditorSplitScreenDirection、EDMT_EditorTabEventType、EDMT_IndicatorMarkerType、EDMT_ItemType、EDMT_ProjectCollaborationMode、EDMT_ProjectFileFormat、EDMT_ProjectReadyState、ELIB_DeviceJlcLibraryCategory、ELIB_LibraryType、ELIB_PreviewType、ELIB_SimulationModelType、ELIB_SymbolType、EPCB_AutoRoutingCornerStyle、EPCB_AutoRoutingExistingPrimitiveMode、EPCB_AutoRoutingOptimization、EPCB_DocumentCanvasUpdateCalculationActiveStatus、EPCB_DocumentRatlineCalculatingActiveStatus、EPCB_InactiveLayerDisplayMode、EPCB_LayerColorConfiguration、EPCB_LayerId、EPCB_LayerStatus、EPCB_LayerType、EPCB_MouseEventType、EPCB_NetEventType、EPCB_PcbPlateType、EPCB_PdfOutputMethod、EPCB_PrimitiveArcInteractiveMode、EPCB_PrimitiveDimensionType、EPCB_PrimitiveEventType、EPCB_PrimitiveFillMode、EPCB_PrimitivePadHeatWeldingConnectionMethod、EPCB_PrimitivePadHoleType、EPCB_PrimitivePadShapeType、EPCB_PrimitivePadType、EPCB_PrimitivePourFillMethod、EPCB_PrimitiveRegionRuleType、EPCB_PrimitiveStringAlignMode、EPCB_PrimitiveType、EPCB_PrimitiveViaType、ESCH_DynamicSimulationEnginePullEventType、ESCH_DynamicSimulationEnginePushEventType、ESCH_ExportDocumentFileType、ESCH_MouseEventType、ESCH_PrimitiveComponentType、ESCH_PrimitiveEventType、ESCH_PrimitiveFillStyle、ESCH_PrimitiveLineType、ESCH_PrimitivePinShape、ESCH_PrimitivePinType、ESCH_PrimitiveTextAlignMode、ESCH_PrimitiveType、ESCH_SimulationNetlistType、ESCH_SpiceSimulationEnginePullEventType、ESCH_SpiceSimulationEnginePushEventType、ESYS_BottomPanelTab、ESYS_HeaderMenuEnvironment、ESYS_ImportProjectBoardOutlineSource、ESYS_ImportProjectImportOption、ESYS_ImportProjectSchematicObjectStyle、ESYS_ImportProjectViaSolderMaskExpansion、ESYS_JobState、ESYS_LeftPanelTab、ESYS_LogType、ESYS_NetlistType、ESYS_PanelPosition、ESYS_PanelTab、ESYS_RightPanelTab、ESYS_ShortcutKeyEffectiveEditorRange、ESYS_ShortcutKeyEffectiveEditorScene、ESYS_StartPageQuickStartItem、ESYS_Theme、ESYS_ToastMessageType、ESYS_Unit、ESYS_WindowEventType、ESYS_WindowOpenTarget、NetportDeviceName、SchToolBarDeviceName
 
 ### references/types
-> ISYS_LanguageKeyValuePairs、TPCB_LayerTypesOfInnerLayer、TPCB_LayersInTheSelectable、TPCB_LayersOfComponent、TPCB_LayersOfCopper、TPCB_LayersOfCustom、TPCB_LayersOfDimension、TPCB_LayersOfFill、TPCB_LayersOfImage、TPCB_LayersOfInner、TPCB_LayersOfLine、TPCB_LayersOfObject、TPCB_LayersOfPad、TPCB_LayersOfRegion、TPCB_NumberOfCopperLayers、TPCB_PolygonSourceArray、TPCB_PrimitiveDimensionCoordinateSet、TPCB_PrimitivePadHole、TPCB_PrimitivePadShape、TPCB_PrimitiveSpecialPadShape、TSYS_MathPolygonGroup、TSYS_MathPolygonInput、TSYS_PcbComparisonErrorCode、TSYS_ShortcutKeys
+> Align、CellContentType、ColumnDefOrGroup、ColumnEditConfig、ColumnType、DataChangeType、FilterMatchMode、RichTableRow、Serializable、SerializablePrimitive、SortOrder、TPCB_LayerTypesOfInnerLayer、TPCB_LayersInTheSelectable、TPCB_LayersOfComponent、TPCB_LayersOfCopper、TPCB_LayersOfCustom、TPCB_LayersOfDimension、TPCB_LayersOfFill、TPCB_LayersOfImage、TPCB_LayersOfInner、TPCB_LayersOfLine、TPCB_LayersOfObject、TPCB_LayersOfPad、TPCB_LayersOfRegion、TPCB_NumberOfCopperLayers、TPCB_PolygonSourceArray、TPCB_PrimitiveDimensionCoordinateSet、TPCB_PrimitivePadHole、TPCB_PrimitivePadShape、TPCB_PrimitiveSpecialPadShape、TSYS_ComparisonErrorCode、TSYS_LanguageKeyValuePairs、TSYS_MathPolygonGroup、TSYS_MathPolygonInput、TSYS_ShortcutKeys
 
 ### references/interfaces
-> BoardProps、ButtonProps、CheckBoxProps、ComponentPropsMap、DialogProps、FlexItemProps、FlexProps、GridItemProps、GridProps、IDMT_BoardItem、IDMT_BriefProjectItem、IDMT_EditorDocumentItem、IDMT_EditorSplitScreenItem、IDMT_EditorTabItem、IDMT_FolderItem、IDMT_IndicatorMarkerShape、IDMT_PanelItem、IDMT_PcbItem、IDMT_ProjectItem、IDMT_SchematicItem、IDMT_SchematicPageItem、IDMT_TeamItem、IDMT_WorkspaceItem、IDesignPortal、ILIB_3DModelItem、ILIB_3DModelSearchItem、ILIB_CbbItem、ILIB_CbbSearchItem、ILIB_ClassificationIndex、ILIB_DeviceAssociationItem、ILIB_DeviceExtendPropertyItem、ILIB_DeviceItem、ILIB_DevicePropertiesForSearch、ILIB_DeviceSearchItem、ILIB_ExtendLibrary3DModelFunctions、ILIB_ExtendLibraryCbbFunctions、ILIB_ExtendLibraryClassificationIndex、ILIB_ExtendLibraryDeviceFunctions、ILIB_ExtendLibraryFootprintFunctions、ILIB_ExtendLibraryFunctions、ILIB_ExtendLibraryItem、ILIB_ExtendLibraryItemIndex、ILIB_ExtendLibrarySearchProperty、ILIB_ExtendLibrarySearchResult、ILIB_ExtendLibrarySearchResultDataLine、ILIB_ExtendLibrarySymbolFunctions、ILIB_ExtendLibraryUserIndex、ILIB_FootprintItem、ILIB_FootprintPropertiesForSearch、ILIB_FootprintSearchItem、ILIB_LibraryInfo、ILIB_LibraryItem、ILIB_PanelLibraryItem、ILIB_PanelLibrarySearchItem、ILIB_SimulationModelItem、ILIB_SimulationModelSearchItem、ILIB_SymbolItem、ILIB_SymbolPropertiesForSearch、ILIB_SymbolSearchItem、IPCB_AutoLayoutResult、IPCB_AutoRoutingProps、IPCB_AutoRoutingResult、IPCB_BomPropertiesTableColumns、IPCB_DifferentialPairItem、IPCB_DiscretizeOptions、IPCB_DiscretizedPoint、IPCB_EqualLengthNetGroupItem、IPCB_LayerItem、IPCB_NetClassItem、IPCB_NetInfo、IPCB_PadPairGroupItem、IPCB_PadPairMinWireLengthItem、IPCB_PhysicalStackingConfiguration、IPCB_Primitive、IPCB_PrimitiveAPI、IPCB_PrimitivePadHeatWelding、IPCB_PrimitivePouredPourFill、IPCB_PrimitiveSolderMaskAndPasteMaskExpansion、IPCB_SubstratePhysicalProperties、IRawNet、IRawPureSchematic、IRawSchematic、IRawWire、ISCH_DrcError、ISCH_DrcErrorPrimitive、ISCH_ExportPngResolution、ISCH_NetInfo、ISCH_Primitive、ISCH_PrimitiveAPI、ISCH_ProjectNetInfo、ISCH_WireInfo、ISYS_FileSystemFileList、ISYS_HeaderMenuSub1MenuItem、ISYS_HeaderMenuSub2MenuItem、ISYS_HeaderMenuTopMenuItem、ISYS_HeaderMenus、ISYS_LogLine、ISYS_MathBBox、ISYS_MathPoint、ISYS_MathPolygonWithHoles、ISYS_MessageBusTask、ISYS_MultilingualLanguagesData、ISYS_PcbComparisonResponse、ISYS_RightClickMenuItem、ISYS_ShortcutKeyData、ISYS_ShortcutKeyDataWithCallFn、ISYS_ShortcutKeyDataWithUserDefinedShortcutKey、ISYS_WindowEventListenerRemovableObject、IconProps、ImageProps、InputProps、ListChildren、ListProps、ModalProps、RadioGroupProps、RadioItem、ScrollerProps、SelectListItem、SelectProps、SlotProps、StyleProps、TextAreaProps、TextProps
+> BoardProps、BorderConfig、ButtonProps、CellClickInfo、CellCoord、CheckBoxProps、CheckChangeDetail、CheckboxEditConfig、ClipboardCellData、ClipboardConfig、ColorPickerProps、ColumnDef、ColumnEditTrigger、ColumnGroupDef、ColumnResizeConfig、ComponentPropsMap、CustomHeaderConfig、DialogProps、DragSortConfig、EditingConfig、FilteringConfig、FixedColumnConfig、FlexItemProps、FlexProps、GridItemProps、GridProps、IDMT_BoardItem、IDMT_BriefProjectItem、IDMT_EditorDocumentItem、IDMT_EditorSplitScreenItem、IDMT_EditorTabItem、IDMT_FolderItem、IDMT_IndicatorMarkerShape、IDMT_PanelItem、IDMT_PcbItem、IDMT_ProjectItem、IDMT_SchematicItem、IDMT_SchematicPageItem、IDMT_TeamItem、IDMT_WorkspaceItem、IDesignPortal、ILIB_3DModelItem、ILIB_3DModelSearchItem、ILIB_CbbItem、ILIB_CbbSearchItem、ILIB_ClassificationIndex、ILIB_ClassificationNode、ILIB_DeviceAssociationItem、ILIB_DeviceExtendPropertyItem、ILIB_DeviceItem、ILIB_DevicePropertiesForSearch、ILIB_DeviceSearchItem、ILIB_ExtendLibrary3DModelFunctions、ILIB_ExtendLibraryCbbFunctions、ILIB_ExtendLibraryClassificationIndex、ILIB_ExtendLibraryDeviceFunctions、ILIB_ExtendLibraryFootprintFunctions、ILIB_ExtendLibraryFunctions、ILIB_ExtendLibraryItem、ILIB_ExtendLibraryItemIndex、ILIB_ExtendLibrarySearchProperty、ILIB_ExtendLibrarySearchResult、ILIB_ExtendLibrarySearchResultDataLine、ILIB_ExtendLibrarySymbolFunctions、ILIB_ExtendLibraryUserIndex、ILIB_FootprintItem、ILIB_FootprintPropertiesForSearch、ILIB_FootprintSearchItem、ILIB_LibraryInfo、ILIB_LibraryItem、ILIB_PanelLibraryItem、ILIB_PanelLibrarySearchItem、ILIB_RegisterExtendLibraryProps、ILIB_SimulationModelItem、ILIB_SimulationModelSearchItem、ILIB_SymbolItem、ILIB_SymbolPropertiesForSearch、ILIB_SymbolSearchItem、IPCB_AutoLayoutResult、IPCB_AutoRoutingProps、IPCB_AutoRoutingResult、IPCB_BomPropertiesTableColumns、IPCB_DifferentialPairItem、IPCB_DiscretizeOptions、IPCB_DiscretizedPoint、IPCB_EqualLengthNetGroupItem、IPCB_LayerItem、IPCB_NetClassItem、IPCB_NetInfo、IPCB_PadPairGroupItem、IPCB_PadPairMinWireLengthItem、IPCB_PhysicalStackingConfiguration、IPCB_Primitive、IPCB_PrimitiveAPI、IPCB_PrimitivePadHeatWelding、IPCB_PrimitivePouredPourFill、IPCB_PrimitiveSolderMaskAndPasteMaskExpansion、IPCB_RayTracerBackgroundConfig、IPCB_RayTracerLightConfig、IPCB_RayTracerMaterialConfig、IPCB_RayTracerPcbMaterialConfig、IPCB_RayTracerRenderConfigurations、IPCB_RayTracerRendererConfig、IPCB_RayTracerSceneElement、IPCB_RayTracerSceneElementTransform、IPCB_RayTracerTexture、IPCB_SubstratePhysicalProperties、IRawNet、IRawPureSchematic、IRawSchematic、IRawWire、ISCH_DrcError、ISCH_DrcErrorPrimitive、ISCH_ExportPngResolution、ISCH_NetInfo、ISCH_Primitive、ISCH_PrimitiveAPI、ISCH_ProjectNetInfo、ISCH_WireInfo、ISYS_ComparisonResponse、ISYS_ExtensionExternalApiIndex、ISYS_ExtensionRegisteredExternalApis、ISYS_ExternalApiHelp、ISYS_ExternalApiRegistration、ISYS_FileSystemFileList、ISYS_HeaderMenuSub1MenuItem、ISYS_HeaderMenuSub2MenuItem、ISYS_HeaderMenuTopMenuItem、ISYS_HeaderMenus、ISYS_HelpAudienceEntry、ISYS_HelpClassSummary、ISYS_HelpData、ISYS_HelpMethodDetail、ISYS_JobHandle、ISYS_JobLogEntry、ISYS_JobStatus、ISYS_LogLine、ISYS_MathBBox、ISYS_MathPoint、ISYS_MathPolygonWithHoles、ISYS_MessageBusTask、ISYS_MultilingualLanguagesData、ISYS_RightClickMenuItem、ISYS_ShortcutKeyData、ISYS_ShortcutKeyDataWithCallFn、ISYS_ShortcutKeyDataWithUserDefinedShortcutKey、ISYS_WindowEventListenerRemovableObject、IconProps、ImageProps、InputEditConfig、InputProps、KeyboardConfig、ListChildren、ListProps、ModalProps、NumberEditConfig、RadioGroupProps、RadioItem、RichTableProps、RowMetaConfig、ScrollerProps、SelectEditConfig、SelectListItem、SelectOption、SelectProps、SelectionConfig、SliderProps、SlotProps、SortState、SortingConfig、StyleProps、TextAreaProps、TextProps、TextareaEditConfig、ValidationRule、VirtualScrollConfig
 
 > 查阅方式：`eda_skill_read { "doc": "references/classes/SCH_PrimitiveComponent.md" }`