@windypro-rourou/dsh-eda 0.1.3 → 0.1.5

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,7 +123,7 @@ 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（人工/导入）。' +
+  '**已知缺陷与技巧（实测，勿踩坑）**：`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）。' +
   '**主动协作（能力入口）**：你能主动为用户完成——读工程/文档、放任意大类元件（搜库→定位→放置）、引脚级连线、网络标志/端口、DRC、网表/BOM 导出、PCB 元件/过孔/走线、现场截图、紧急保存。规划任务时若不确定某个 API 是否存在或怎么调，先调 `eda_capabilities`（结构化能力清单+注意事项+实测片段），再用 `eda_exec` 落地；用户提到画板相关需求时主动提议并执行，不要等用户一字一句教。' +
   '限制：v0 离线生成器仅支持 电阻/LED；云端实时生成能力由官方 eda.* API 决定（以 ~/.dsh/eda/bridge 内官方文档为准）。' +
@@ -249,6 +307,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 +322,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 +361,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 +520,8 @@ function edaStatusTool(handle) {
           extUrl: { type: 'string' },
           error: { type: 'string' },
           version: { type: 'string' },
+          latestVersion: { type: 'string' },
+          updateAvailable: { type: 'boolean' },
           note: { type: 'string' },
         },
       },
@@ -458,6 +535,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') }]
       },
     },
@@ -1777,7 +1855,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(() => {
@@ -1839,6 +1922,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.3",
+  "version": "0.1.5",
   "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" }`

package/skill/README.md

@@ -0,0 +1,125 @@
+[English](#) | [简体中文](./README.zh-Hans.md)
+
+# EasyEDA API Skill
+
+An EasyEDA Pro API skill package for AI coding tools such as Claude Code, OpenCode, QwenCode, and any other tool that supports the [Agent Skills](https://agentskills.io/) standard.
+
+This skill supports both online debugging of EasyEDA Pro through AI and extension development for EasyEDA Pro.
+When developing EasyEDA extensions, AI can use the extension-development documentation, API references, type information, usage examples, and bridge debugging capabilities provided by this skill to help with API lookup, code generation, and integration debugging.
+If you want to analyze or modify EasyEDA document source files directly instead of operating through the API, this project also provides documentation for the source file formats.
+
+- 📚 **Structured API documentation** — Automatically builds hierarchical indexes from reference docs for fast AI lookup
+- 🧾 **Document source format specifications** — Explains project, schematic, and PCB source formats for direct source analysis and modification
+- 🔌 **WebSocket Bridge** — A Node.js server that bridges AI tools and the EasyEDA client
+- 🤖 **SKILL.md** — A complete skill instruction file
+
+## Quick Start
+
+### 1. Install dependencies
+
+```bash
+npm install
+```
+
+### 2. Build API documentation
+
+```bash
+npm run build:docs
+```
+
+This reads the raw API documentation from the `reference/` directory and generates structured docs into the `docs/` directory.
+
+### 3. Start the WebSocket Bridge server
+
+```bash
+npm run server
+```
+
+The server automatically chooses an available port in the `49620-49629` range and waits for the EasyEDA client to connect.
+
+### 4. Connect from EasyEDA
+
+Install the `run-api-gateway.eext` extension in EasyEDA. Download:
+
+- https://jlcext.com/item/oshwhub-official/run-api-gateway
+
+After the extension is loaded, it connects to the Bridge server automatically by scanning the port range and verifying the handshake.
+
+### 5. Use from an AI coding tool
+
+AI coding tools such as Claude Code, OpenCode, and QwenCode automatically read `SKILL.md` for instructions, then use the HTTP API to send code to EasyEDA:
+
+```bash
+# Check EasyEDA connection status (assuming the service is on port 49620)
+curl http://localhost:49620/health
+
+# Execute EasyEDA code
+curl -X POST http://localhost:49620/execute \
+  -H "Content-Type: application/json" \
+  -d '{"code": "return await eda.dmt_Project.getCurrentProjectInfo();"}'
+```
+
+## One-Command Packaging
+
+```bash
+npm run pack
+```
+
+This performs the following steps:
+1. Build API documentation (`docs/`)
+2. Package `SKILL.md`, documentation, and the server into `dist/easyeda-api/`
+3. Generate `dist/easyeda-api.zip` for upload
+
+If the documentation has already been built, you can skip that step:
+
+```bash
+npm run pack:fast
+```
+
+### Publish to ClawHub
+
+```bash
+npx clawhub@latest publish dist/easyeda-api/
+```
+
+Or upload the zip file at https://clawhub.ai/upload
+
+## Architecture
+
+```
+┌──────────────┐   HTTP/WS     ┌────────────────┐   WebSocket   ┌──────────┐
+│   AI Agent   │ ◄───────────► │ Bridge Server  │ ◄───────────► │  EasyEDA │
+│ (Skill Tool) │  Port Range   │   (Node.js)    │  Port Range   │ (Client) │
+└──────────────┘  49620-49629  └────────────────┘  49620-49629  └──────────┘
+```
+
+## Communication Protocol
+
+| Message Type | Direction | Description |
+|--------------|-----------|-------------|
+| `execute` | AI → EDA | Execute JavaScript code |
+| `result` | EDA → AI | Return execution result |
+| `error` | EDA → AI | Return execution error |
+| `handshake` | Server → Client | Connection verification (includes `service: "easyeda-bridge"`) |
+| `ping/pong` | Bidirectional | Heartbeat |
+
+## Directory Structure
+
+```text
+easyeda-api-skill/
+  SKILL.md              # AgentSkills standard skill definition
+  AGENTS.md             # Agent prompt guide
+  package.json          # Project configuration
+  reference/            # Raw API reference docs (gitignored)
+  docs/                 # Built structured docs (gitignored)
+  format/               # EasyEDA document source format specs (project/schematic/pcb)
+  guide/                # API development guides
+  user-guide/           # User guides
+  server/index.mjs      # WebSocket Bridge server
+  scripts/
+    build-docs.mjs      # Documentation build script
+    pack.mjs            # Packaging script
+  dist/                 # Packaging output (gitignored)
+    easyeda-api/        # Publishable skill directory
+    easyeda-api.zip     # Zip archive for ClawHub upload
+```

package/skill/README.zh-Hans.md

@@ -0,0 +1,125 @@
+[English](./README.md) | [简体中文](#)
+
+# EasyEDA API Skill
+
+供 AI 编程工具（Claude Code、OpenCode、QwenCode 等所有支持 [Agent Skills](https://agentskills.io/) 标准的工具）使用的 EasyEDA Pro API 技能包（Skill）。
+
+这个 SKILL 不仅支持 AI 在线调试嘉立创EDA，也支持辅助开发嘉立创EDA扩展。
+在开发嘉立创EDA扩展时，AI 可以使用本 SKILL 提供的扩展开发相关文档、API 参考、类型信息、调用示例以及桥接调试能力，帮助完成接口查询、代码编写与联调验证。
+如果用户准备自行分析或修改嘉立创EDA文档源码，而不是通过 API 操作，也可以使用本项目提供的文档源码格式说明。
+
+- 📚 **结构化 API 文档** — 自动从参考文档生成分层索引，便于 AI 快速查阅
+- 🧾 **文档源码格式规范** — 说明工程、原理图、PCB 文档源码格式，适合直接分析和修改源码的场景
+- 🔌 **WebSocket Bridge** — Node.js 服务端，桥接 AI 和 EasyEDA 客户端
+- 🤖 **SKILL.md** — 完整的技能指导文件
+
+## 快速开始
+
+### 1. 安装依赖
+
+```bash
+npm install
+```
+
+### 2. 构建 API 文档
+
+```bash
+npm run build:docs
+```
+
+这会从 `reference/` 目录读取原始 API 文档，生成结构化文档到 `docs/` 目录。
+
+### 3. 启动 WebSocket Bridge 服务器
+
+```bash
+npm run server
+```
+
+服务器自动在端口范围 `49620-49629` 中选择可用端口启动，等待 EasyEDA 客户端连接。
+
+### 4. EasyEDA 端连接
+
+在嘉立创EDA中安装 `run-api-gateway.eext` 扩展，下载地址：
+
+- https://jlc-ext.com/item/oshwhub/run-api-gateway
+
+扩展加载后会自动连接到 Bridge 服务器（自动扫描端口范围，验证握手后连接）。
+
+### 5. 使用 AI 编程工具
+
+AI 编程工具（Claude Code、OpenCode、QwenCode 等）会自动读取 `SKILL.md` 获取技能指导，通过 HTTP API 向 EDA 发送代码：
+
+```bash
+# 检查 EDA 连接状态（端口自动发现，此处假设服务在 49620）
+curl http://localhost:49620/health
+
+# 执行 EDA 代码
+curl -X POST http://localhost:49620/execute \
+  -H "Content-Type: application/json" \
+  -d '{"code": "return await eda.dmt_Project.getCurrentProjectInfo();"}'
+```
+
+## 一键打包
+
+```bash
+npm run pack
+```
+
+这会执行以下步骤：
+1. 构建 API 文档（`docs/`）
+2. 将 SKILL.md、文档、服务器打包到 `dist/easyeda-api/`
+3. 生成 `dist/easyeda-api.zip` 用于上传
+
+如果文档已构建好，可跳过构建步骤：
+
+```bash
+npm run pack:fast
+```
+
+### 发布到 ClawHub
+
+```bash
+npx clawhub@latest publish dist/easyeda-api/
+```
+
+或上传 zip 文件到 https://clawhub.ai/upload
+
+## 架构
+
+```
+┌──────────────┐   HTTP/WS     ┌────────────────┐   WebSocket   ┌──────────┐
+│   AI Agent   │ ◄───────────► │ Bridge Server  │ ◄───────────► │  EasyEDA │
+│ (Skill Tool) │  Port Range   │   (Node.js)    │  Port Range   │ (Client) │
+└──────────────┘  49620-49629  └────────────────┘  49620-49629  └──────────┘
+```
+
+## 通信协议
+
+| 消息类型 | 方向 | 说明 |
+|----------|------|------|
+| `execute` | AI → EDA | 执行 JS 代码 |
+| `result` | EDA → AI | 返回执行结果 |
+| `error` | EDA → AI | 返回执行错误 |
+| `handshake` | Server → Client | 连接验证（含 `service: "easyeda-bridge"`） |
+| `ping/pong` | 双向 | 心跳检测 |
+
+## 目录结构
+
+```
+easyeda-api-skill/
+  SKILL.md              # AgentSkills 标准技能定义
+  AGENTS.md              # Agent 提示指南
+  package.json          # 项目配置
+  reference/            # 原始 API 参考文档（gitignore）
+  docs/                 # 构建后的结构化文档（gitignore）
+  format/               # 嘉立创EDA文档源码格式规范（project/schematic/pcb）
+  guide/                # API 开发指南（人工撰写）
+  user-guide/           # 用户指南（人工撰写）
+  server/index.mjs      # WebSocket Bridge 服务器
+  scripts/
+    build-docs.mjs      # 文档构建脚本
+    pack.mjs            # 打包脚本
+  dist/                 # 打包输出（gitignore）
+    easyeda-api/        # 可发布的 skill 目录
+    easyeda-api.zip     # 用于 ClawHub 上传的 zip 文件
+```