dsh-eda-mcp 0.6.2 → 0.7.1

package/CHANGELOG.md

@@ -1,8 +1,71 @@
 # Changelog
 
+## 0.7.1 — 2026-10-20
+
+构建产物修正：**扩展 zip 只保留带版本号的那一个**。
+
+- 0.7.0 里为了不打破旧引用，同时产出了 `dsh-eda-bridge-extension-0.4.0.zip` 和同内容的 `dsh-eda-bridge-extension.zip`（SHA256 完全一致）。两个同内容文件摆在一起只会让人分不清哪份是当前版本，属于多余的冗余，删掉。
+- 现在只生成 `dsh-eda-bridge-extension-<线协议版本>.zip`。所有引用改为**按版本解析**：
+  - `src/index.ts`：从 `jlc-extension/extension.json` 读版本号拼出文件名（找不到时回退旧的固定名，兼容旧布局）；
+  - `src/routes.ts`：下载响应头用实际文件名的 `basename`，浏览器另存下来自带版本号；
+  - 设置卡片的下载链接去掉固定的 `download` 属性，改由响应头决定文件名；
+  - 桥接里所有提示语改成 `dsh-eda-bridge-extension-' + VERSION + '.zip`；
+  - README（中/英）、CONTRIBUTING、`docs/release.md`、扩展头部注释同步。
+- `package.json files` 去掉固定名条目，只保留 `dsh-eda-bridge-extension-*.zip`。
+
+线协议仍是 **0.4.0**，扩展内容未变——已导入 0.4.0 的机器**无需重新导入**。
+
+## 0.7.0 — 2026-10-20
+
+主题：把「操作嘉立创EDA」从**画图**扩展到**应用与工程**层面，并把这一路真机联调暴露的 bug 全部修掉。
+
+> **线协议 0.3.5 → 0.4.0**：扩展白名单有变动，**必须重新导入** `dsh-eda-bridge-extension-0.4.0.zip`，否则新工具会返回 `API method not allowed`。用 `eda_status` 的 `extensionVersions` 核对。
+
+### 新增工具（83 → 97）
+
+- **应用控制**：`eda_launch`（启动 EDA，可选带工程，并等扩展连上；Windows 上把启动交给 `explorer.exe`，见下）、`eda_close`（先优雅后强制，返回关闭前后进程数）。
+- **工程**：`eda_list_projects`（无过滤时跨本地目录聚合）、`eda_get_project`、`eda_open_project`（uuid 或**中文工程名**）、`eda_create_project`、`eda_delete_project`、`eda_modify_project`（改名/描述）、`eda_copy_project`、`eda_import_project`（**导入即建工程**，需目标团队）、`eda_export_project`（给 `outPath` 直接落盘）、`eda_close_document`。
+- **工作区**：`eda_get_workspace`（当前工作区 + 团队）、`eda_list_teams`、`eda_list_folders`。
+- **设置卡片**新增「嘉立创EDA 可执行文件（可选）」输入框（`edaExecutable`，留空自动探测）。
+
+### 真机验证过的能力（EDA 3.2.186、已登录、半离线）
+
+| 能力 | 结果 |
+|---|---|
+| 启动 / 关闭 EDA | ✅ `eda_launch` 走 explorer 交接，5 个进程 + 窗口，扩展 9 s 内连上；`eda_close` 5 → 0 进程（强制路径） |
+| 列出全部本地工程 | ✅ 跨目录聚合，7 → 8 个 |
+| 按中文工程名打开工程 | ✅ 两次成功 |
+| 打开原理图页并读取 | ✅ 页 `P1`、器件 `DC1`、板卡 `波形变换电路` |
+| 导出工程文件 | ✅ 1 056 450 字节 / 1.9 s |
+| **导入工程（= 变相新建）** | ✅ 新建出 `DSH-IMPORT-TEST`（4.7 s） |
+| `createProject` / `deleteProject` | ❌ 该构建无副作用（详见已知限制） |
+
+### 修掉的真 bug（全部由真机暴露，不是推测）
+
+1. **扩展硬编码版本常量**：`api-bridge.js` 里手写的 `var VERSION = '0.3.5'` 不随清单更新，导致「清单显示 0.3.6、运行时永远报 0.3.5」。改为构建时从 `extension.json` 注入 `__EXTENSION_VERSION__`，并有 3 条单测禁止再出现硬编码。
+2. **僵尸客户端吞调用**：`firstReadyClient()` 取第一个 `ready` socket，页面跳转留下的半开连接照样 `ready`，调用进黑洞直到 60 s 超时（就是那次 `MCP error -32001`）。改为「每条数据刷新 lastSeenAt + 优先最活跃 + 静默 >60 s 只作兜底 + 只读方法超时才换客户端重试一次」。
+3. **连接状态会撒谎**：`connectedClients`、`waitForExtensionConnection`、`/healthz` 全用原始 `ready` → 改用活跃客户端。
+4. **`optional is not defined`**：`optional()` 只定义在 `dsh.internal.pcbCreateRegion` 内部，导出/导入助手看不见 → 提升为共享函数并清掉 `optional2/optional3`。
+5. **团队/工程/文件夹被摘要成空对象**：`summarizePrimitive` 字段名不匹配 → 这些结构改为原样返回。
+6. **按名字找不到工程**：`getAllProjectsUuid()` 在半离线模式恒为空（本地目录才是 "team"）→ 无过滤时遍历团队聚合。
+7. **`reg query` 不带 `/s` 只返回默认值**，列不出 `OpenWithProgids`；拼键时少了分隔符；probe 缓存把「列全部值」和「默认值」当同一键。
+8. **GBK 解码**：`reg.exe` 按控制台代码页输出、progid 名是中文，UTF-8 解码出替换字符就拼不回注册表键 → 新增 `decodeRegistryOutput()`。
+9. **直接 spawn 起不来 GUI**：`lceda-pro.exe` 直接 spawn（含 ShellExecute）以退出码 0 立刻退出，只有交给 `explorer.exe` 才行 → `eda_launch` 在 Windows 固定走 explorer + 临时 `.cmd`。
+10. **`eda_close` 在非 Windows 把进程数当 -1**（等于谎报已关闭）→ 改用 `pgrep -f` 真实计数。
+
+### 可执行契约检查（新增）
+
+`scripts/contract-check.mjs`（接入 `pnpm check` 与 CI）机械校验四类**已真实发生过**的错配：工具声明 ↔ handler（自动解析 11 个别名）、桥接调用的每个 API ↔ 扩展白名单（`ALLOWED_API` + `FILE_METHODS`，160 条）、`dsh.internal.*` ↔ 扩展实现、`objectSchema` 的 required ↔ properties（94+ 个 schema）。
+
+### 构建与发布
+
+- zip 包名带版本号：`dsh-eda-bridge-extension-0.4.0.zip`，同时保留 `dsh-eda-bridge-extension.zip` 别名（内容一致；分发放带版本号的那个）。
+- 工具总数 **97**，单测 **110** 条全通过，`docs/tools.md` 自动重生成（0 未分组）。
+
+
 ## 0.6.2
 
-> 首个发布到 npm 的版本。下面 0.6.1 的内容从未发布过，同批一起带上。
+> **已发布到 npm**（`dsh-eda-mcp@0.6.2`，首个版本）。下面 0.6.1 的内容从未发布过，同批一起带上。
 
 ### 设置页：勾选框改为官方开关组件
 

package/CONTRIBUTING.md

@@ -33,7 +33,7 @@ packaged with PowerShell `Compress-Archive`.
 pnpm install
 pnpm typecheck   # tsc --noEmit
 pnpm test        # unit tests + the seam compatibility test
-pnpm build       # lib/*.js, lib/bridge.mjs, lib/client.js, dsh-eda-bridge-extension.zip
+pnpm build       # lib/*.js, lib/bridge.mjs, lib/client.js, dsh-eda-bridge-extension-<version>.zip
 pnpm check       # all three, in that order
 pnpm docs        # regenerate docs/tools.md from the built bridge
 pnpm seam-check  # assert the plugin's DSH contracts against another version line

package/LICENSE

@@ -1,55 +1,55 @@
-Apache License
-
-Version 2.0, January 2004
-
-http://www.apache.org/licenses/ 
-
-TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
-
-1. Definitions.
-
-"License" shall mean the terms and conditions for use, reproduction, and distribution as defined by Sections 1 through 9 of this document.
-
-"Licensor" shall mean the copyright owner or entity authorized by the copyright owner that is granting the License.
-
-"Legal Entity" shall mean the union of the acting entity and all other entities that control, are controlled by, or are under common control with that entity. For the purposes of this definition, "control" means (i) the power, direct or indirect, to cause the direction or management of such entity, whether by contract or otherwise, or (ii) ownership of fifty percent (50%) or more of the outstanding shares, or (iii) beneficial ownership of such entity.
-
-"You" (or "Your") shall mean an individual or Legal Entity exercising permissions granted by this License.
-
-"Source" form shall mean the preferred form for making modifications, including but not limited to software source code, documentation source, and configuration files.
-
-"Object" form shall mean any form resulting from mechanical transformation or translation of a Source form, including but not limited to compiled object code, generated documentation, and conversions to other media types.
-
-"Work" shall mean the work of authorship, whether in Source or Object form, made available under the License, as indicated by a copyright notice that is included in or attached to the work (an example is provided in the Appendix below).
-
-"Derivative Works" shall mean any work, whether in Source or Object form, that is based on (or derived from) the Work and for which the editorial revisions, annotations, elaborations, or other modifications represent, as a whole, an original work of authorship. For the purposes of this License, Derivative Works shall not include works that remain separable from, or merely link (or bind by name) to the interfaces of, the Work and Derivative Works thereof.
-
-"Contribution" shall mean any work of authorship, including the original version of the Work and any modifications or additions to that Work or Derivative Works thereof, that is intentionally submitted to Licensor for inclusion in the Work by the copyright owner or by an individual or Legal Entity authorized to submit on behalf of the copyright owner. For the purposes of this definition, "submitted" means any form of electronic, verbal, or written communication sent to the Licensor or its representatives, including but not limited to communication on electronic mailing lists, source code control systems, and issue tracking systems that are managed by, or on behalf of, the Licensor for the purpose of discussing and improving the Work, but excluding communication that is conspicuously marked or otherwise designated in writing by the copyright owner as "Not a Contribution."
-
-"Contributor" shall mean Licensor and any individual or Legal Entity on behalf of whom a Contribution has been received by Licensor and subsequently incorporated within the Work.
-
-2. Grant of Copyright License. Subject to the terms and conditions of this License, each Contributor hereby grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable copyright license to reproduce, prepare Derivative Works of, publicly display, publicly perform, sublicense, and distribute the Work and such Derivative Works in Source or Object form.
-
-3. Grant of Patent License. Subject to the terms and conditions of this License, each Contributor hereby grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable (except as stated in this section) patent license to make, have made, use, offer to sell, sell, import, and otherwise transfer the Work, where such license applies only to those patent claims licensable by such Contributor that are necessarily infringed by their Contribution(s) alone or by combination of their Contribution(s) with the Work to which such Contribution(s) was submitted. If You institute patent litigation against any entity (including a cross-claim or counterclaim in a lawsuit) alleging that the Work or a Contribution incorporated within the Work constitutes direct or contributory patent infringement, then any patent licenses granted to You under this License for that Work shall terminate as of the date such litigation is filed.
-
-4. Redistribution. You may reproduce and distribute copies of the Work or Derivative Works thereof in any medium, with or without modifications, and in Source or Object form, provided that You meet the following conditions:
-
-You must give any other recipients of the Work or Derivative Works a copy of this License; and
-
-You must cause any modified files to carry prominent notices stating that You changed the files; and
-
-You must retain, in the Source form of any Derivative Works that You distribute, all copyright, patent, trademark, and attribution notices from the Source form of the Work, excluding those notices that do not pertain to any part of the Derivative Works; and
-
-If the Work includes a "NOTICE" text file as part of its distribution, then any Derivative Works that You distribute must include a readable copy of the attribution notices contained within such NOTICE file, excluding those notices that do not pertain to any part of the Derivative Works, in at least one of the following places: within a NOTICE text file distributed as part of the Derivative Works; within the Source form or documentation, if provided along with the Derivative Works; or, within a display generated by the Derivative Works, if and wherever such third-party notices normally appear. The contents of the NOTICE file are for informational purposes only and do not modify the License. You may add Your own attribution notices within Derivative Works that You distribute, alongside or as an addendum to the NOTICE text from the Work, provided that such additional attribution notices cannot be construed as modifying the License. You may add Your own copyright statement to Your modifications and may provide additional or different license terms and conditions for use, reproduction, or distribution of Your modifications, or for any such Derivative Works as a whole, provided Your use, reproduction, and distribution of the Work otherwise complies with the conditions stated in this License.
-
-5. Submission of Contributions. Unless You explicitly state otherwise, any Contribution intentionally submitted for inclusion in the Work by You to the Licensor shall be under the terms and conditions of this License, without any additional terms or conditions. Notwithstanding the above, nothing herein shall supersede or modify the terms of any separate license agreement you may have executed with Licensor regarding such Contributions.
-
-6. Trademarks. This License does not grant permission to use the trade names, trademarks, service marks, or product names of the Licensor, except as required for reasonable and customary use in describing the origin of the Work and reproducing the content of the NOTICE file.
-
-7. Disclaimer of Warranty. Unless required by applicable law or agreed to in writing, Licensor provides the Work (and each Contributor provides its Contributions) on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied, including, without limitation, any warranties or conditions of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A PARTICULAR PURPOSE. You are solely responsible for determining the appropriateness of using or redistributing the Work and assume any risks associated with Your exercise of permissions under this License.
-
-8. Limitation of Liability. In no event and under no legal theory, whether in tort (including negligence), contract, or otherwise, unless required by applicable law (such as deliberate and grossly negligent acts) or agreed to in writing, shall any Contributor be liable to You for damages, including any direct, indirect, special, incidental, or consequential damages of any character arising as a result of this License or out of the use or inability to use the Work (including but not limited to damages for loss of goodwill, work stoppage, computer failure or malfunction, or any and all other commercial damages or losses), even if such Contributor has been advised of the possibility of such damages.
-
-9. Accepting Warranty or Additional Liability. While redistributing the Work or Derivative Works thereof, You may choose to offer, and charge a fee for, acceptance of support, warranty, indemnity, or other liability obligations and/or rights consistent with this License. However, in accepting such obligations, You may act only on Your own behalf and on Your sole responsibility, not on behalf of any other Contributor, and only if You agree to indemnify, defend, and hold each Contributor harmless for any liability incurred by, or claims asserted against, such Contributor by reason of your accepting any such warranty or additional liability.
-
-END OF TERMS AND CONDITIONS
+Apache License
+
+Version 2.0, January 2004
+
+http://www.apache.org/licenses/ 
+
+TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+1. Definitions.
+
+"License" shall mean the terms and conditions for use, reproduction, and distribution as defined by Sections 1 through 9 of this document.
+
+"Licensor" shall mean the copyright owner or entity authorized by the copyright owner that is granting the License.
+
+"Legal Entity" shall mean the union of the acting entity and all other entities that control, are controlled by, or are under common control with that entity. For the purposes of this definition, "control" means (i) the power, direct or indirect, to cause the direction or management of such entity, whether by contract or otherwise, or (ii) ownership of fifty percent (50%) or more of the outstanding shares, or (iii) beneficial ownership of such entity.
+
+"You" (or "Your") shall mean an individual or Legal Entity exercising permissions granted by this License.
+
+"Source" form shall mean the preferred form for making modifications, including but not limited to software source code, documentation source, and configuration files.
+
+"Object" form shall mean any form resulting from mechanical transformation or translation of a Source form, including but not limited to compiled object code, generated documentation, and conversions to other media types.
+
+"Work" shall mean the work of authorship, whether in Source or Object form, made available under the License, as indicated by a copyright notice that is included in or attached to the work (an example is provided in the Appendix below).
+
+"Derivative Works" shall mean any work, whether in Source or Object form, that is based on (or derived from) the Work and for which the editorial revisions, annotations, elaborations, or other modifications represent, as a whole, an original work of authorship. For the purposes of this License, Derivative Works shall not include works that remain separable from, or merely link (or bind by name) to the interfaces of, the Work and Derivative Works thereof.
+
+"Contribution" shall mean any work of authorship, including the original version of the Work and any modifications or additions to that Work or Derivative Works thereof, that is intentionally submitted to Licensor for inclusion in the Work by the copyright owner or by an individual or Legal Entity authorized to submit on behalf of the copyright owner. For the purposes of this definition, "submitted" means any form of electronic, verbal, or written communication sent to the Licensor or its representatives, including but not limited to communication on electronic mailing lists, source code control systems, and issue tracking systems that are managed by, or on behalf of, the Licensor for the purpose of discussing and improving the Work, but excluding communication that is conspicuously marked or otherwise designated in writing by the copyright owner as "Not a Contribution."
+
+"Contributor" shall mean Licensor and any individual or Legal Entity on behalf of whom a Contribution has been received by Licensor and subsequently incorporated within the Work.
+
+2. Grant of Copyright License. Subject to the terms and conditions of this License, each Contributor hereby grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable copyright license to reproduce, prepare Derivative Works of, publicly display, publicly perform, sublicense, and distribute the Work and such Derivative Works in Source or Object form.
+
+3. Grant of Patent License. Subject to the terms and conditions of this License, each Contributor hereby grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable (except as stated in this section) patent license to make, have made, use, offer to sell, sell, import, and otherwise transfer the Work, where such license applies only to those patent claims licensable by such Contributor that are necessarily infringed by their Contribution(s) alone or by combination of their Contribution(s) with the Work to which such Contribution(s) was submitted. If You institute patent litigation against any entity (including a cross-claim or counterclaim in a lawsuit) alleging that the Work or a Contribution incorporated within the Work constitutes direct or contributory patent infringement, then any patent licenses granted to You under this License for that Work shall terminate as of the date such litigation is filed.
+
+4. Redistribution. You may reproduce and distribute copies of the Work or Derivative Works thereof in any medium, with or without modifications, and in Source or Object form, provided that You meet the following conditions:
+
+You must give any other recipients of the Work or Derivative Works a copy of this License; and
+
+You must cause any modified files to carry prominent notices stating that You changed the files; and
+
+You must retain, in the Source form of any Derivative Works that You distribute, all copyright, patent, trademark, and attribution notices from the Source form of the Work, excluding those notices that do not pertain to any part of the Derivative Works; and
+
+If the Work includes a "NOTICE" text file as part of its distribution, then any Derivative Works that You distribute must include a readable copy of the attribution notices contained within such NOTICE file, excluding those notices that do not pertain to any part of the Derivative Works, in at least one of the following places: within a NOTICE text file distributed as part of the Derivative Works; within the Source form or documentation, if provided along with the Derivative Works; or, within a display generated by the Derivative Works, if and wherever such third-party notices normally appear. The contents of the NOTICE file are for informational purposes only and do not modify the License. You may add Your own attribution notices within Derivative Works that You distribute, alongside or as an addendum to the NOTICE text from the Work, provided that such additional attribution notices cannot be construed as modifying the License. You may add Your own copyright statement to Your modifications and may provide additional or different license terms and conditions for use, reproduction, or distribution of Your modifications, or for any such Derivative Works as a whole, provided Your use, reproduction, and distribution of the Work otherwise complies with the conditions stated in this License.
+
+5. Submission of Contributions. Unless You explicitly state otherwise, any Contribution intentionally submitted for inclusion in the Work by You to the Licensor shall be under the terms and conditions of this License, without any additional terms or conditions. Notwithstanding the above, nothing herein shall supersede or modify the terms of any separate license agreement you may have executed with Licensor regarding such Contributions.
+
+6. Trademarks. This License does not grant permission to use the trade names, trademarks, service marks, or product names of the Licensor, except as required for reasonable and customary use in describing the origin of the Work and reproducing the content of the NOTICE file.
+
+7. Disclaimer of Warranty. Unless required by applicable law or agreed to in writing, Licensor provides the Work (and each Contributor provides its Contributions) on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied, including, without limitation, any warranties or conditions of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A PARTICULAR PURPOSE. You are solely responsible for determining the appropriateness of using or redistributing the Work and assume any risks associated with Your exercise of permissions under this License.
+
+8. Limitation of Liability. In no event and under no legal theory, whether in tort (including negligence), contract, or otherwise, unless required by applicable law (such as deliberate and grossly negligent acts) or agreed to in writing, shall any Contributor be liable to You for damages, including any direct, indirect, special, incidental, or consequential damages of any character arising as a result of this License or out of the use or inability to use the Work (including but not limited to damages for loss of goodwill, work stoppage, computer failure or malfunction, or any and all other commercial damages or losses), even if such Contributor has been advised of the possibility of such damages.
+
+9. Accepting Warranty or Additional Liability. While redistributing the Work or Derivative Works thereof, You may choose to offer, and charge a fee for, acceptance of support, warranty, indemnity, or other liability obligations and/or rights consistent with this License. However, in accepting such obligations, You may act only on Your own behalf and on Your sole responsibility, not on behalf of any other Contributor, and only if You agree to indemnify, defend, and hold each Contributor harmless for any liability incurred by, or claims asserted against, such Contributor by reason of your accepting any such warranty or additional liability.
+
+END OF TERMS AND CONDITIONS

package/README.md

@@ -2,6 +2,7 @@
 
 [![check](https://github.com/MCviseron/dsh-eda-mcp/actions/workflows/check.yml/badge.svg)](https://github.com/MCviseron/dsh-eda-mcp/actions/workflows/check.yml)
 [![license](https://img.shields.io/badge/license-Apache--2.0-blue.svg)](LICENSE)
+[![npm](https://img.shields.io/npm/v/dsh-eda-mcp.svg)](https://www.npmjs.com/package/dsh-eda-mcp)
 [![node](https://img.shields.io/badge/node-%5E22.19%20%7C%7C%20%3E%3D24-brightgreen.svg)](package.json)
 
 DeepSeek Harness (DSH) plugin that connects DSH to **嘉立创EDA专业版 / EasyEDA Pro** and lets the agent draw schematics through MCP tools.
@@ -15,7 +16,7 @@ DSH agent
   └─ mcp__jlceda__eda_* tools
        └─ @deepseek-ai/dsh-mcp-client (stdio)
             └─ lib/bridge.mjs  (local MCP + WebSocket server, 127.0.0.1:39009)
-                 └─ JLCEDA Pro extension  dsh-eda-bridge-extension.zip
+                 └─ JLCEDA Pro extension  dsh-eda-bridge-extension-<version>.zip
                       └─ official EasyEDA Pro extension API (eda.sch_*)
 ```
 
@@ -27,6 +28,19 @@ The DSH plugin starts a zero-dependency bridge child process. The bridge speaks
 >
 > Verified generations: `0.1.5-rc.2` (this repo's dev set) and `0.2.0-rc.2` / `0.2.1-rc.2` (desktop runtime and npm `next`). Re-check any new line with `pnpm seam-check next` — it installs that generation's seam packages into a throwaway directory and asserts every contract this plugin probes: mcp-client `inject: ['tools']` and its config keys, the settings faces, `systemPrompt.section({ name, order, text })`, `webServer.register({ kind: 'exact' })`, and the `window.__ModuleLoader__.load({ id, factory })` wrapper.
 
+### 0. From npm (recommended)
+
+```sh
+cd "$DSH_HOME/profiles/<profile>"
+pnpm add dsh-eda-mcp            # or use the plugin manager in the Web GUI
+# restart DSH
+```
+
+The published package already contains `lib/` and `dsh-eda-bridge-extension-<version>.zip`, so no build
+toolchain is needed. The extension still has to be imported into JLCEDA Pro by hand — the zip
+sits at `node_modules/dsh-eda-mcp/dsh-eda-bridge-extension-<version>.zip` (or download it from the
+settings card).
+
 ### 1. Install into the DSH web profile
 
 ```sh
@@ -57,10 +71,10 @@ The plugin now resolves a real Node executable (`src/node-runtime.ts`), in order
 
 ### 2. Import the JLCEDA Pro bridge extension
 
-Build produces `dsh-eda-bridge-extension.zip`. In JLCEDA Pro:
+Build produces `dsh-eda-bridge-extension-<version>.zip` only — a second copy under the stable name only made it unclear which build you were looking at. In JLCEDA Pro:
 
 1. Open **扩展 → 导入** (Extensions → Import).
-2. Select `dsh-eda-bridge-extension.zip`.
+2. Select `dsh-eda-bridge-extension-<version>.zip`.
 3. In the extension list find **DSH EDA MCP Bridge**.
 4. Enable it and, importantly, enable **允许外部交互 / Allow external interactions**.
 
@@ -93,6 +107,10 @@ after routing.
 | Tool | Purpose |
 |---|---|
 | `eda_status` | Bridge status and connected JLCEDA clients |
+| `eda_launch` | Start JLCEDA Pro (optionally opening a `.eprj2` project) and wait until the extension connects |
+| `eda_list_projects` / `eda_get_project` | List workspace projects (uuid + name) / read the current project |
+| `eda_open_project` | Open a project by uuid, or by friendly name |
+| `eda_create_project` | Create a project and return its uuid (optionally open it) |
 | `eda_search_components` | Search JLCEDA library devices |
 | `eda_place_component` | Place a component/symbol |
 | `eda_place_net_flag` | Place VCC/GND/Power net flag |
@@ -170,7 +188,7 @@ Build outputs:
 - `lib/index.js` — DSH host plugin.
 - `lib/client.js` — DSH Web GUI settings card.
 - `lib/bridge.mjs` — standalone MCP/WebSocket bridge child.
-- `dsh-eda-bridge-extension.zip` — JLCEDA Pro extension.
+- `dsh-eda-bridge-extension-<version>.zip` — JLCEDA Pro extension (the version is the wire contract).
 
 `lib/` and the zip are build outputs and are git-ignored; the host loads the packaged `lib/index.js`, so a change under `src/` needs `pnpm build` plus a Host restart (a plugin reload does not re-import a cached ESM module).
 
@@ -193,6 +211,11 @@ See [CONTRIBUTING.md](CONTRIBUTING.md) for the repository layout, the release/ta
 - The JLCEDA extension socket is registered through `sys_WebSocket`, which has neither a close callback nor auto-reconnect; versions before 0.3.3 therefore had to be reconnected by hand after the DSH bridge child restarted. 0.3.3 adds a 10 s heartbeat that re-registers the socket when `pong` stops arriving.
 - Screenshot/canvas image return is not yet wired into MCP image blocks.
 - Changing the bridge WebSocket port requires editing both the bridge env and `jlc-extension/api-bridge.js`, then rebuilding/reimporting the extension zip.
+- `dmt_Project.createProject` / `deleteProject` do nothing on this EDA build (3.2.186, signed in but semi-offline): the former returns no uuid for a directory team, a canonical team uuid, or either with/without a folderUuid, and the latter always returns `false` (verified with the project open and after switching away). **Create projects with `eda_import_project` instead** (importing a project file does create one — verified), and delete them in the app.
+- In semi-offline mode EDA models **each local project directory as a "team"**: the `uuid` reported by `eda_list_teams` is the directory path, while a project record's `teamUuid` is a real uuid. `eda_list_projects` without a filter walks every team, so the first call is slower than one with `teamUuid`.
+- Spawning `lceda-pro.exe` directly (even through ShellExecute) makes it exit with code 0 immediately; only handing the launch to the desktop shell (`explorer.exe`) starts it, so on Windows `eda_launch` always goes through explorer plus a temporary `.cmd`.
+- A project path on the command line is **ignored by the app** (the active document stays HOME), so `eda_launch({ project })` only forwards the argument; the result carries `projectOpenedByArgument: false` and a `projectNote`. Use `eda_open_project` to actually open one.
+- The extension and bridge wire versions must move **together** (currently 0.4.0): a changed allow-list requires re-importing the zip, otherwise new tools answer `API method not allowed`. `eda_status` reports every connected page's version in `extensionVersions`.
 
 ## Repository
 

package/README.zh.md

@@ -2,6 +2,7 @@
 
 [![check](https://github.com/MCviseron/dsh-eda-mcp/actions/workflows/check.yml/badge.svg)](https://github.com/MCviseron/dsh-eda-mcp/actions/workflows/check.yml)
 [![license](https://img.shields.io/badge/license-Apache--2.0-blue.svg)](LICENSE)
+[![npm](https://img.shields.io/npm/v/dsh-eda-mcp.svg)](https://www.npmjs.com/package/dsh-eda-mcp)
 [![node](https://img.shields.io/badge/node-%5E22.19%20%7C%7C%20%3E%3D24-brightgreen.svg)](package.json)
 
 把 DeepSeek Harness (DSH) 连接到 **嘉立创EDA专业版 / EasyEDA Pro**，让 Agent 通过 MCP 工具画原理图。
@@ -15,7 +16,7 @@ DSH Agent
   └─ mcp__jlceda__eda_* 工具
        └─ @deepseek-ai/dsh-mcp-client（stdio）
             └─ lib/bridge.mjs（本地 MCP + WebSocket 服务，127.0.0.1:39009）
-                 └─ 嘉立创EDA专业版扩展 dsh-eda-bridge-extension.zip
+                 └─ 嘉立创EDA专业版扩展 dsh-eda-bridge-extension-<版本号>.zip
                       └─ 官方扩展 API（eda.sch_*）
 ```
 
@@ -38,6 +39,17 @@ DSH 插件启动一个零第三方依赖的桥接子进程。桥接进程通过
 >
 > 已验证的代际：`0.1.5-rc.2`（本仓库开发用）与 `0.2.0-rc.2` / `0.2.1-rc.2`（桌面端运行时与 npm `next`）。出现新版本线时跑 `pnpm seam-check next` —— 它会把该代际的接缝包装到临时目录，逐条断言本插件依赖的契约：mcp-client 的 `inject: ['tools']` 与配置键、设置接缝、`systemPrompt.section({ name, order, text })`、`webServer.register({ kind: 'exact' })`、以及 `window.__ModuleLoader__.load({ id, factory })` 包装格式。
 
+### 0. 从 npm 安装（推荐）
+
+```sh
+cd "$DSH_HOME/profiles/<profile>"
+pnpm add dsh-eda-mcp            # 或用 Web GUI 的插件管理器安装
+# 重启 DSH
+```
+
+发布包里已包含 `lib/` 与 `dsh-eda-bridge-extension-<线协议版本>.zip`，**不需要构建工具链**。扩展仍需手动导入
+嘉立创EDA：zip 位于 `node_modules/dsh-eda-mcp/dsh-eda-bridge-extension-<线协议版本>.zip`（也可从设置卡片下载，下载到的文件名自带版本号）。
+
 ### 1. 安装到 DSH Web profile
 
 ```sh
@@ -53,10 +65,10 @@ cd dsh-eda-mcp && pnpm install && dsh plugin --profile web add "link:$PWD"
 
 ### 2. 导入嘉立创EDA桥接扩展
 
-构建会生成 `dsh-eda-bridge-extension.zip`。在嘉立创EDA专业版中：
+构建只生成 `dsh-eda-bridge-extension-<版本号>.zip`（不再保留同名别名——两个同内容文件只会让人分不清是哪一版）。在嘉立创EDA专业版中：
 
 1. 打开 **扩展 → 导入**。
-2. 选择 `dsh-eda-bridge-extension.zip`。
+2. 选择 `dsh-eda-bridge-extension-<版本号>.zip`。
 3. 在扩展列表中找到 **DSH EDA MCP Bridge**。
 4. 启用它，并务必开启 **允许外部交互**。
 
@@ -149,6 +161,10 @@ DSH 桥接服务开着但 EDA 没有连上时，有三种入口：
 | 工具 | 用途 |
 |---|---|
 | `eda_status` | 桥接状态、端口、已连接 EDA 客户端数 |
+| `eda_launch` | 启动嘉立创EDA（命令行工程参数被应用忽略，见 docs/tools.md）并等待扩展连上 |
+| `eda_list_projects` / `eda_get_project` | 列出工作区工程（uuid + 名称）/ 读取当前工程 |
+| `eda_open_project` | 按 uuid 或工程名打开工程 |
+| `eda_create_project` | 新建工程并返回 uuid（可选立即打开） |
 | `eda_get_page_info` | 当前页、A4 图框、标题栏、安全区 |
 | `eda_get_schematic_pages` | 原理图图页列表 / 按 uuid 查询 |
 | `eda_search_components` | 搜索嘉立创库器件 |
@@ -266,7 +282,7 @@ JLCEDA 工程文件里真实的板框记录是：
 
 ## 完整工具参考
 
-`docs/tools.md` 由构建产物（bridge 的 MCP `tools/list`）自动生成（`pnpm docs`），共 **82 个工具**，是唯一权威清单：名称、描述、参数与必填项都在里面。下面只写流程与坑。
+`docs/tools.md` 由构建产物（bridge 的 MCP `tools/list`）自动生成（`pnpm docs`），共 **97 个工具**，是唯一权威清单：名称、描述、参数与必填项都在里面。下面只写流程与坑。
 
 ## 设计规范
 
@@ -338,7 +354,7 @@ pnpm check       # 以上三步
 - `lib/index.js` — DSH Host 插件。
 - `lib/client.js` — DSH Web GUI 设置卡片。
 - `lib/bridge.mjs` — 独立 MCP/WebSocket 桥接子进程。
-- `dsh-eda-bridge-extension.zip` — 嘉立创EDA专业版扩展。
+- `dsh-eda-bridge-extension-<版本号>.zip` — 嘉立创EDA专业版扩展（版本号 = 线协议版本）。
 
 `lib/` 与 zip 都是构建产物（已 gitignore）；宿主加载的是打包后的 `lib/index.js`，所以改 `src/` 后必须 `pnpm build` **并重启 Host**（插件重载不会重新 import 已缓存的 ESM 模块）。仓库结构、发布打 tag 流程、bridge/扩展版本规则见 [CONTRIBUTING.md](CONTRIBUTING.md)；**发布到 npm** 的完整流程（首次手动发布，之后由 `v*` tag 经 trusted publishing/OIDC 自动发布）见 [docs/release.md](docs/release.md)。
 
@@ -357,6 +373,11 @@ pnpm check       # 以上三步
 - 修改桥接端口需要同时改桥接环境变量和 `jlc-extension/api-bridge.js`，再重新构建并重新导入扩展。
 - 元件包围盒检查依赖 `sch_Primitive.getPrimitivesBBox`；个别图元若没有 BBox，会跳过超界检查。
 - 扩展 `activationEvents` 已包含 onStartupFinished / onProjectOpened / onEditorSchematic / onEditorPcb；如果导入旧版扩展后切到 PCB 掉线，请重新导入新版 zip。
+- `dmt_Project.createProject` / `deleteProject` 在本机 EDA 3.2.186（登录但半离线）上**无副作用**：前者返回空 uuid（目录路径 / 真 team uuid / 带不带 folderUuid 四种组合都试过），后者始终返回 `false`（工程打开时与切走后各试一次）。**新建工程请改用 `eda_import_project`（导入一个工程文件即建出工程，已实测）**，删除请在应用内完成。
+- 半离线模式下 EDA 把**每个本地工程目录当成一个 "team"**：`eda_list_teams` 返回的 `uuid` 就是目录路径，而工程记录里的 `teamUuid` 是另一种真 uuid。`eda_list_projects` 无过滤时会遍历所有 team 聚合，因此第一次调用会比带 `teamUuid` 时慢一些。
+- `lceda-pro.exe` 直接 `spawn`（含 ShellExecute）会**立刻以退出码 0 退出**：只有交给桌面外壳（`explorer.exe`）才能起来，所以 `eda_launch` 在 Windows 上固定走 explorer + 临时 `.cmd`。
+- 命令行带工程路径启动**被应用忽略**（活动文档仍是 HOME），所以 `eda_launch({ project })` 只保证"把参数传下去"，返回值里 `projectOpenedByArgument: false` 与 `projectNote` 会明确说明；要打开工程请用 `eda_open_project`。
+- 扩展与桥接的**线协议版本必须成对升级**（当前 0.4.0）：白名单变了就要重新导入 zip，否则新工具会报 `API method not allowed`；`eda_status` 的 `extensionVersions` 会指出每个页面连上来的版本。
 
 ## 仓库结构
 

package/docs/release.md

@@ -30,7 +30,7 @@ npm pack --dry-run                  # 看 tarball 内容
 ```
 
 `npm pack --dry-run` 里必须能同时看到 **`lib/index.js`、`lib/client.js`、`lib/bridge.mjs`、
-`dsh-eda-bridge-extension.zip`、`cordis.patch.yml`、`docs/`**。`lib/` 与 zip 是构建产物（被 gitignore），
+`dsh-eda-bridge-extension-<线协议版本>.zip`、`cordis.patch.yml`、`docs/`**。`lib/` 与 zip 是构建产物（被 gitignore），
 由 `prepare` 脚本在打包时生成 —— 所以**打包机必须是 Windows**（zip 用 PowerShell `Compress-Archive`）。
 
 ## 2. 首次手动发布（必须手动，顺序不能颠倒）

package/docs/tools.md

@@ -7,6 +7,36 @@ authoritative list of what the agent can call. Coordinates: schematic/symbol = *
 Design limits enforced by these tools (track widths, via sizes, net naming) are documented in
 [design-rules.md](design-rules.md).
 
+## Project
+
+| Tool | Description | Parameters |
+|---|---|---|
+| `eda_list_projects` | List project UUIDs in the workspace (dmt_Project.getAllProjectsUuid). resolveNames=true (default) also reads getProjectInfo per project so callers can match by friendly name. | `teamUuid?: string, folderUuid?: string, workspaceUuid?: string, resolveNames?: boolean, limit?: integer` |
+| `eda_get_project` | Read the current project (dmt_Project.getCurrentProjectInfo): uuid, friendly name, folder/team and other brief fields. | `` |
+| `eda_open_project` | Open a project by uuid, or by friendly name when only a name is known (the name is resolved through getAllProjectsUuid + getProjectInfo, exact match first, then case-insensitive substring). | `uuid?: string, name?: string` |
+| `eda_create_project` | Create a project (dmt_Project.createProject) and return its uuid; open=true (default false) also opens it. friendlyName is required; name and folder/team default to the app defaults. | `friendlyName: string, name?: string, teamUuid?: string, folderUuid?: string, description?: string, open?: boolean` |
+| `eda_delete_project` | Delete a project (dmt_Project.deleteProject) by uuid or friendly name. | `uuid?: string, name?: string` |
+| `eda_modify_project` | Rename a project or change its description (dmt_Project.modifyProjectFriendlyName / modifyProjectDescription), addressed by uuid or current friendly name. | `uuid?: string, name?: string, friendlyName?: string, description?: string` |
+| `eda_copy_project` | Copy a project (dmt_Project.copyProject), optionally into another team/folder and with a new friendly name; returns the new uuid. | `sourceUuid?: string, sourceName?: string, targetTeamUuid?: string, targetFolderUuid?: string, newFriendlyName?: string, newName?: string` |
+| `eda_close_document` | Close one editor tab (dmt_EditorControl.closeDocument). | `tabId: string` |
+| `eda_export_project` | Export a project file (sys_FileManager.getProjectFile / getProjectFileByProjectUuid). With outPath the bridge writes the bytes to disk and returns the path; without it the base64 payload is returned only when inline=true. | `uuid?: string, fileName?: string, fileType?: string, outPath?: string, inline?: boolean` |
+| `eda_import_project` | Import a local project file (.eprj2/.epro/...) into a team (sys_FileManager.importProjectByProjectFile with a saveTo target). teamUuid is required in local mode: without a target team the app imports nothing. Returns whether the import actually landed. | `path: string, teamUuid?: string, folderUuid?: string, friendlyName?: string, fileType?: string, open?: boolean` |
+
+## Workspace
+
+| Tool | Description | Parameters |
+|---|---|---|
+| `eda_get_workspace` | Read the current workspace and team (dmt_Workspace.getCurrentWorkspaceInfo / dmt_Team.getCurrentTeamInfo). Needed before creating a project, which requires a team (and usually a folder) uuid. | `` |
+| `eda_list_teams` | List teams (dmt_Team.getAllTeamsInfo), optionally including the teams this account is involved in. | `involved?: boolean` |
+| `eda_list_folders` | List folder uuids of one team (dmt_Folder.getAllFoldersUuid), optionally resolved through getFolderInfo. | `teamUuid?: string, resolveNames?: boolean` |
+
+## App control
+
+| Tool | Description | Parameters |
+|---|---|---|
+| `eda_close` | Close JLCEDA Pro gracefully (taskkill /T on Windows, SIGTERM elsewhere), then force-kill if it is still running after waitMs (default 8000). Returns the remaining process count. | `force?: boolean, waitMs?: integer` |
+| `eda_launch` | Launch JLCEDA Pro (EasyEDA Pro), optionally opening a .eprj2/.eprj project, then wait until the bridge extension connects. The executable is resolved from DSH_EDA_EXECUTABLE/JLCEDA_EXECUTABLE, the registry handler the installer registered, conventional install directories, then PATH - so it works on any machine without configuration. | `project?: string, executable?: string, waitForExtension?: boolean, timeoutMs?: integer` |
+
 ## Schematic: query
 
 | Tool | Description | Parameters |

package/jlc-extension/api-bridge.js

@@ -1,14 +1,14 @@
 /* eslint-disable */
 /**
- * dsh-eda-mcp — JLCEDA Pro bridge extension (v0.3.5).
+ * dsh-eda-mcp — JLCEDA Pro bridge extension (version injected from extension.json).
  *
  * Connects to the local dsh-eda-mcp bridge process over WebSocket and executes
  * a strict allow-list of official EasyEDA Pro extension APIs. Import through:
- *   Extensions → Import → select dsh-eda-bridge-extension.zip
+ *   Extensions → Import → select dsh-eda-bridge-extension-<version>.zip
  *   then enable "Allow interactive with external" for this extension.
  */
 var DSH_EDA_MCP = {
-  version: '0.3.5',
+  version: '__EXTENSION_VERSION__',
   connect: null,
   disconnect: null,
   status: null,
@@ -37,7 +37,9 @@ function dshEdaMcpStatus() {
 (function () {
   'use strict';
 
-  var VERSION = '0.3.5';
+  // Injected from extension.json at build time: a hand-maintained constant here
+  // went stale once and made the bridge report a version mismatch forever.
+  var VERSION = '__EXTENSION_VERSION__';
   var WS_ID = 'dsh-eda-mcp-bridge';
   var WS_PORT = 39009;
   var WS_URL = 'ws://127.0.0.1:' + WS_PORT + '/ws';
@@ -133,12 +135,29 @@ function dshEdaMcpStatus() {
     'dmt_Schematic.getSchematicInfo',
     'dmt_Schematic.getSchematicPageInfo',
     'dmt_Schematic.getAllSchematicPagesInfo',
+    'dmt_Team.getAllTeamsInfo',
+    'dmt_Team.getAllInvolvedTeamInfo',
+    'dmt_Team.getCurrentTeamInfo',
+    'dmt_Folder.getAllFoldersUuid',
+    'dmt_Folder.getFolderInfo',
+    'dmt_Workspace.getCurrentWorkspaceInfo',
+    'dmt_Project.getAllProjectsUuid',
+    'dmt_Project.getProjectInfo',
+    'dmt_Project.getCurrentProjectInfo',
+    'dmt_Project.openProject',
+    'dmt_Project.createProject',
+    'dmt_Project.deleteProject',
+    'dmt_Project.modifyProjectFriendlyName',
+    'dmt_Project.modifyProjectDescription',
+    'dmt_Project.copyProject',
+    'dmt_Project.moveProjectToFolder',
     'dmt_Board.createBoard',
     'dmt_Board.getAllBoardsInfo',
     'dmt_Board.getCurrentBoardInfo',
     'dmt_EditorControl.getSplitScreenTree',
     'dmt_EditorControl.getTabsBySplitScreenId',
     'dmt_EditorControl.openDocument',
+    'dmt_EditorControl.closeDocument',
     'dmt_EditorControl.activateDocument',
     'dmt_EditorControl.zoomToRegion',
     'dmt_EditorControl.zoomToAllPrimitives',
@@ -286,6 +305,11 @@ function dshEdaMcpStatus() {
     return btoa(parts.join(''));
   }
 
+  // JSON turns undefined array slots into null; the official API expects
+  // undefined (omitted) for optional parameters. One shared helper: the earlier
+  // per-helper copies were invisible to the project file helpers.
+  function optional(value) { return value === null ? undefined : value; }
+
   async function blobToDataUrl(blob) {
     var buffer = await blob.arrayBuffer();
     var bytes = new Uint8Array(buffer);
@@ -313,6 +337,41 @@ function dshEdaMcpStatus() {
     if (typeof message.method !== 'string') {
       throw new Error('API method not allowed: ' + String(message.method));
     }
+    // Internal helper: export a project as a File and hand it back as base64
+    // (the File object cannot cross the WebSocket boundary).
+    if (message.method === 'dsh.internal.exportProjectFile') {
+      var expArgs = message.args || [];
+      if (typeof eda === 'undefined' || !eda.sys_FileManager) {
+        throw new Error('dsh.internal.exportProjectFile: sys_FileManager is not available');
+      }
+      var expUuid = expArgs[0] == null ? undefined : String(expArgs[0]);
+      var expFile = expUuid === undefined
+        ? await eda.sys_FileManager.getProjectFile(optional(expArgs[1]), optional(expArgs[2]), optional(expArgs[3]))
+        : await eda.sys_FileManager.getProjectFileByProjectUuid(expUuid, optional(expArgs[1]), optional(expArgs[2]), optional(expArgs[3]));
+      if (!expFile) throw new Error('dsh.internal.exportProjectFile: the app returned no file (project not open, or the export was cancelled)');
+      var expBuffer = new Uint8Array(await expFile.arrayBuffer());
+      var expBinary = '';
+      for (var expIndex = 0; expIndex < expBuffer.length; expIndex += 1) expBinary += String.fromCharCode(expBuffer[expIndex]);
+      return { name: expFile.name || String(expArgs[1] || 'project.epro'), size: expBuffer.length, base64: btoa(expBinary) };
+    }
+    // Internal helper: import a project from base64 (local .eprj2/.epro handed over
+    // by the bridge) by rebuilding the File the official API expects.
+    if (message.method === 'dsh.internal.importProjectFile') {
+      var impArgs = message.args || [];
+      if (typeof eda === 'undefined' || !eda.sys_FileManager) {
+        throw new Error('dsh.internal.importProjectFile: sys_FileManager is not available');
+      }
+      var impBinary = atob(String(impArgs[0] || ''));
+      var impBytes = new Uint8Array(impBinary.length);
+      for (var impIndex = 0; impIndex < impBinary.length; impIndex += 1) impBytes[impIndex] = impBinary.charCodeAt(impIndex);
+      var impFile = new File([impBytes], String(impArgs[1] || 'import.eprj2'), { type: 'application/octet-stream' });
+      // saveTo (4th argument) is what gives the import a target team; without it the
+      // app answers undefined and imports nothing.
+      var impResult = await eda.sys_FileManager.importProjectByProjectFile(
+        impFile, optional(impArgs[2]), undefined, optional(impArgs[3])
+      );
+      return { result: impResult === undefined ? null : toJsonable(impResult) };
+    }
     // Internal helper: build an IPCB_Polygon from a raw source array and create
     // a PCB region (used for the board outline).
     if (message.method === 'dsh.internal.pcbCreateRegion') {
@@ -322,9 +381,6 @@ function dshEdaMcpStatus() {
       }
       var regionPolygon = eda.pcb_MathPolygon.createPolygon(regionArgs[1]);
       if (!regionPolygon) throw new Error('dsh.internal.pcbCreateRegion: invalid polygon source');
-      // JSON turns undefined array slots into null; the official API expects
-      // undefined (omitted) for optional parameters.
-      function optional(value) { return value === null ? undefined : value; }
       var region = await eda.pcb_PrimitiveRegion.create(
         optional(regionArgs[0]), regionPolygon, optional(regionArgs[2]), optional(regionArgs[3]),
         optional(regionArgs[4]), optional(regionArgs[5])
@@ -341,12 +397,11 @@ function dshEdaMcpStatus() {
       if (typeof eda === 'undefined' || !eda.pcb_MathPolygon || !eda.pcb_PrimitivePolyline) {
         throw new Error('dsh.internal.polylineCreate: PCB polyline APIs are not available');
       }
-      function optional2(value) { return value === null ? undefined : value; }
       var source = polyArgs[2];
       var polygon = eda.pcb_MathPolygon.createPolygon(source);
       if (!polygon) throw new Error('dsh.internal.polylineCreate: invalid polygon source ' + JSON.stringify(source));
       var polyline = await eda.pcb_PrimitivePolyline.create(
-        optional2(polyArgs[0]), optional2(polyArgs[1]), polygon, optional2(polyArgs[3]), optional2(polyArgs[4])
+        optional(polyArgs[0]), optional(polyArgs[1]), polygon, optional(polyArgs[3]), optional(polyArgs[4])
       );
       if (!polyline) {
         throw new Error('dsh.internal.polylineCreate: pcb_PrimitivePolyline.create returned undefined (net/layer/polygon rejected)');
@@ -361,12 +416,11 @@ function dshEdaMcpStatus() {
       if (typeof eda === 'undefined' || !eda.pcb_MathPolygon || !eda.pcb_PrimitivePour) {
         throw new Error('dsh.internal.pourCreate: PCB pour APIs are not available');
       }
-      function optional3(value) { return value === null ? undefined : value; }
       var pourPolygon = eda.pcb_MathPolygon.createPolygon(pourArgs[2]);
       if (!pourPolygon) throw new Error('dsh.internal.pourCreate: invalid polygon source ' + JSON.stringify(pourArgs[2]));
       var pour = await eda.pcb_PrimitivePour.create(
-        optional3(pourArgs[0]), optional3(pourArgs[1]), pourPolygon, optional3(pourArgs[3]), optional3(pourArgs[4]),
-        optional3(pourArgs[5]), optional3(pourArgs[6]), optional3(pourArgs[7]), optional3(pourArgs[8])
+        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])
       );
       if (!pour) {
         throw new Error('dsh.internal.pourCreate: pcb_PrimitivePour.create returned undefined (net/layer/polygon rejected; copper layers only)');

package/jlc-extension/extension.json

@@ -2,7 +2,7 @@
   "uuid": "d5e0a1b2c3f4456789abcdef01234567",
   "name": "dsh-eda-bridge",
   "displayName": "DSH EDA MCP Bridge",
-  "version": "0.3.5",
+  "version": "0.4.0",
   "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",