dsh-eda-mcp 0.7.0 → 0.7.1

package/CHANGELOG.md

@@ -1,5 +1,20 @@
 # 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 全部修掉。

package/CONTRIBUTING.md

@@ -34,7 +34,6 @@ 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-<version>.zip
-                 # (+ dsh-eda-bridge-extension.zip as a stable-name alias of the same build)
 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/README.md

@@ -16,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_*)
 ```
 
@@ -36,9 +36,9 @@ 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.zip`, so no build
+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.zip` (or download it from the
+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
@@ -71,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-<version>.zip` (plus a `dsh-eda-bridge-extension.zip` alias with identical content; **hand out the versioned file** so stale copies are obvious). 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**.
 
@@ -188,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).
 

package/README.zh.md

@@ -16,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_*）
 ```
 
@@ -47,8 +47,8 @@ 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`（也可从设置卡片下载）。
+发布包里已包含 `lib/` 与 `dsh-eda-bridge-extension-<线协议版本>.zip`，**不需要构建工具链**。扩展仍需手动导入
+嘉立创EDA：zip 位于 `node_modules/dsh-eda-mcp/dsh-eda-bridge-extension-<线协议版本>.zip`（也可从设置卡片下载，下载到的文件名自带版本号）。
 
 ### 1. 安装到 DSH Web profile
 
@@ -65,10 +65,10 @@ cd dsh-eda-mcp && pnpm install && dsh plugin --profile web add "link:$PWD"
 
 ### 2. 导入嘉立创EDA桥接扩展
 
-构建会生成 `dsh-eda-bridge-extension-<版本号>.zip`（同时保留 `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. 启用它，并务必开启 **允许外部交互**。
 
@@ -354,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)。
 

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/jlc-extension/api-bridge.js

@@ -4,7 +4,7 @@
  *
  * 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 = {

package/lib/bridge.mjs

@@ -781,7 +781,7 @@ function sendToClient(client, method, args, timeoutMs) {
 async function callExtension(method, args, timeoutMs) {
   const pool = pickClients();
   if (pool.length === 0) {
-    throw new Error('JLCEDA bridge extension is not connected. Open JLCEDA Pro, import dsh-eda-bridge-extension.zip, enable "Allow interactive with external", and keep a schematic or PCB page open.');
+    throw new Error("JLCEDA bridge extension is not connected. Open JLCEDA Pro, import dsh-eda-bridge-extension-" + VERSION + '.zip, enable "Allow interactive with external", and keep a schematic or PCB page open.');
   }
   const deadline = Date.now() + timeoutMs;
   let lastError;
@@ -1311,7 +1311,7 @@ async function executeTool(name, rawArgs, timeoutMs) {
         versionMismatch: stale.length > 0,
         mcpUnits: "0.01 inch",
         defaultPaper: DEFAULT_PAPER,
-        hint: ready.length === 0 ? "No JLCEDA extension is connected. Open JLCEDA Pro and click DSH MCP -> connect, or re-import dsh-eda-bridge-extension.zip." : stale.length > 0 ? "Connected EDA extension " + stale.join(", ") + " does not match bridge " + VERSION + ". In JLCEDA Pro remove the OLD dsh-eda-bridge extension first, import dsh-eda-bridge-extension.zip again, then restart the app; a simple reload keeps the old copy." : "ok"
+        hint: ready.length === 0 ? "No JLCEDA extension is connected. Open JLCEDA Pro and click DSH MCP -> connect, or re-import dsh-eda-bridge-extension-" + VERSION + ".zip." : stale.length > 0 ? "Connected EDA extension " + stale.join(", ") + " does not match bridge " + VERSION + ". In JLCEDA Pro remove the OLD dsh-eda-bridge extension first, import dsh-eda-bridge-extension-" + VERSION + ".zip again, then restart the app; a simple reload keeps the old copy." : "ok"
       };
     }
     case "eda_close_document":
@@ -1652,7 +1652,7 @@ async function executeTool(name, rawArgs, timeoutMs) {
         connected: waited.connected,
         connectedClients: waited.clients,
         waitedMs: waited.waitedMs,
-        hint: waited.connected ? "JLCEDA is connected; the eda_* tools can be used now." : "The app was started but no EDA extension connected yet. In JLCEDA Pro: \u6269\u5C55 \u2192 DSH MCP \u2192 \u8FDE\u63A5 (and enable \u201C\u5141\u8BB8\u5916\u90E8\u4EA4\u4E92\u201D); the extension must be imported once from dsh-eda-bridge-extension.zip."
+        hint: waited.connected ? "JLCEDA is connected; the eda_* tools can be used now." : "The app was started but no EDA extension connected yet. In JLCEDA Pro: \u6269\u5C55 \u2192 DSH MCP \u2192 \u8FDE\u63A5 (and enable \u201C\u5141\u8BB8\u5916\u90E8\u4EA4\u4E92\u201D); the extension must be imported once from dsh-eda-bridge-extension-" + VERSION + ".zip."
       };
     }
     case "eda_get_page_info": {
@@ -2215,7 +2215,7 @@ async function executeTool(name, rawArgs, timeoutMs) {
           componentsBefore: pcbComponentBaseline.length,
           componentsAfter: after.length,
           confirmedYet: after.length > pcbComponentBaseline.length,
-          hint: "The imported EDA extension has no background-job helper, so the sync was awaited. Re-import dsh-eda-bridge-extension.zip to use the async + polling flow."
+          hint: "The imported EDA extension has no background-job helper, so the sync was awaited. Re-import dsh-eda-bridge-extension-" + VERSION + ".zip to use the async + polling flow."
         };
       }
       return {
@@ -2514,7 +2514,7 @@ async function executeTool(name, rawArgs, timeoutMs) {
         } catch (error) {
           if (!isInternalHelperMissing(error)) throw error;
           const blocking = asRecord(await callExtension("pcb_Document.autoRouting", [props], toolTimeout(args, timeoutMs)));
-          return { ...blocking, backgroundUnavailable: true, props, hint: "The imported EDA extension has no background-job helper, so routing was awaited. Re-import dsh-eda-bridge-extension.zip to get the async + polling flow." };
+          return { ...blocking, backgroundUnavailable: true, props, hint: "The imported EDA extension has no background-job helper, so routing was awaited. Re-import dsh-eda-bridge-extension-" + VERSION + ".zip to get the async + polling flow." };
         }
         const running = started.started === true || started.alreadyRunning === true;
         return {

package/lib/client.js

@@ -1283,7 +1283,6 @@ function EdaMcpSettingsCard(props) {
         "a",
         {
           href: "/api/dsh-eda-mcp/extension.zip",
-          download: "dsh-eda-bridge-extension.zip",
           style: { ...secondaryButtonStyle, textDecoration: "none", display: "inline-flex", width: "fit-content" },
           children: t("settings.downloadExtension")
         }

package/lib/index.js

@@ -2,6 +2,7 @@
 import * as mcpClient from "@deepseek-ai/dsh-mcp-client";
 import z from "@deepseek-ai/schemastery";
 import { fileURLToPath } from "node:url";
+import { existsSync as existsSync2, readFileSync } from "node:fs";
 import { dirname as dirname2 } from "node:path";
 
 // src/guidance.ts
@@ -23,6 +24,7 @@ var EDA_MCP_GUIDANCE = [
 
 // src/routes.ts
 import { createReadStream } from "node:fs";
+import { basename } from "node:path";
 import { SettingsConflictError } from "@deepseek-ai/dsh-settings";
 
 // src/loopback.ts
@@ -196,7 +198,8 @@ function makeEdaMcpRoutes(deps) {
       if (!isLoopbackRequest(req)) return json(res, 403, { ok: false, error: "forbidden" });
       res.writeHead(200, {
         "content-type": "application/zip",
-        "content-disposition": 'attachment; filename="dsh-eda-bridge-extension.zip"',
+        // Keep the versioned file name the browser saves it as.
+        "content-disposition": 'attachment; filename="' + basename(deps.extensionZipPath) + '"',
         "cache-control": "no-store"
       });
       const stream = createReadStream(deps.extensionZipPath);
@@ -532,7 +535,19 @@ function installSettingsSection(ctx, scoped, ns, schema, entry, hooks) {
 }
 var inject = ["webServer", "systemPrompt"];
 var BRIDGE_URL = new URL("../lib/bridge.mjs", import.meta.url);
-var EXTENSION_ZIP_URL = new URL("../dsh-eda-bridge-extension.zip", import.meta.url);
+function resolveExtensionZipPath() {
+  const plain = fileURLToPath(new URL("../dsh-eda-bridge-extension.zip", import.meta.url));
+  try {
+    const manifest = JSON.parse(readFileSync(fileURLToPath(new URL("../jlc-extension/extension.json", import.meta.url)), "utf8"));
+    const version = typeof manifest.version === "string" ? manifest.version : "";
+    if (version !== "") {
+      const versioned = fileURLToPath(new URL("../dsh-eda-bridge-extension-" + version + ".zip", import.meta.url));
+      if (existsSync2(versioned)) return versioned;
+    }
+  } catch {
+  }
+  return plain;
+}
 var BRIDGE_PATH = fileURLToPath(BRIDGE_URL);
 function bridgeLaunchFor(active) {
   const runtime = resolveBridgeRuntime();
@@ -614,7 +629,7 @@ function apply(ctx, config) {
   ctx.effect(() => {
     const disposers = makeEdaMcpRoutes({
       getConfig: () => current(),
-      extensionZipPath: fileURLToPath(EXTENSION_ZIP_URL),
+      extensionZipPath: resolveExtensionZipPath(),
       reconnect: remountClient,
       bridgeLaunch: describeBridgeLaunch,
       diagnostics: () => diagnostics.liveSnapshot(),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-eda-mcp",
-  "version": "0.7.0",
+  "version": "0.7.1",
   "description": "DeepSeek Harness (DSH) plugin — connects DSH to JLCEDA Pro (EasyEDA Pro) via a local MCP bridge and draws schematics through the JLCEDA extension API.",
   "license": "Apache-2.0",
   "author": {
@@ -50,7 +50,6 @@
     "docs",
     "jlc-extension",
     "dsh-eda-bridge-extension-*.zip",
-    "dsh-eda-bridge-extension.zip",
     "cordis.patch.yml",
     "CHANGELOG.md",
     "CONTRIBUTING.md",

package/src/bridge/index.ts

@@ -507,7 +507,7 @@ function sendToClient(client, method, args, timeoutMs) {
 async function callExtension(method, args, timeoutMs) {
   const pool = pickClients()
   if (pool.length === 0) {
-    throw new Error('JLCEDA bridge extension is not connected. Open JLCEDA Pro, import dsh-eda-bridge-extension.zip, enable "Allow interactive with external", and keep a schematic or PCB page open.')
+    throw new Error('JLCEDA bridge extension is not connected. Open JLCEDA Pro, import dsh-eda-bridge-extension-' + VERSION + '.zip, enable "Allow interactive with external", and keep a schematic or PCB page open.')
   }
   const deadline = Date.now() + timeoutMs
   let lastError
@@ -1075,10 +1075,10 @@ async function executeTool(name, rawArgs, timeoutMs) {
         versionMismatch: stale.length > 0,
         mcpUnits: '0.01 inch', defaultPaper: DEFAULT_PAPER,
         hint: ready.length === 0
-          ? 'No JLCEDA extension is connected. Open JLCEDA Pro and click DSH MCP -> connect, or re-import dsh-eda-bridge-extension.zip.'
+          ? 'No JLCEDA extension is connected. Open JLCEDA Pro and click DSH MCP -> connect, or re-import dsh-eda-bridge-extension-' + VERSION + '.zip.'
           : (stale.length > 0
             ? 'Connected EDA extension ' + stale.join(', ') + ' does not match bridge ' + VERSION +
-              '. In JLCEDA Pro remove the OLD dsh-eda-bridge extension first, import dsh-eda-bridge-extension.zip again, then restart the app; a simple reload keeps the old copy.'
+              '. In JLCEDA Pro remove the OLD dsh-eda-bridge extension first, import dsh-eda-bridge-extension-' + VERSION + '.zip again, then restart the app; a simple reload keeps the old copy.'
             : 'ok'),
       }
     }
@@ -1459,7 +1459,7 @@ async function executeTool(name, rawArgs, timeoutMs) {
         waitedMs: waited.waitedMs,
         hint: waited.connected
           ? 'JLCEDA is connected; the eda_* tools can be used now.'
-          : 'The app was started but no EDA extension connected yet. In JLCEDA Pro: 扩展 → DSH MCP → 连接 (and enable “允许外部交互”); the extension must be imported once from dsh-eda-bridge-extension.zip.',
+          : 'The app was started but no EDA extension connected yet. In JLCEDA Pro: 扩展 → DSH MCP → 连接 (and enable “允许外部交互”); the extension must be imported once from dsh-eda-bridge-extension-' + VERSION + '.zip.',
       }
     }
 
@@ -1982,7 +1982,7 @@ async function executeTool(name, rawArgs, timeoutMs) {
           triggered: true, backgroundUnavailable: true, importResult: result,
           componentsBefore: pcbComponentBaseline.length, componentsAfter: after.length,
           confirmedYet: after.length > pcbComponentBaseline.length,
-          hint: 'The imported EDA extension has no background-job helper, so the sync was awaited. Re-import dsh-eda-bridge-extension.zip to use the async + polling flow.',
+          hint: 'The imported EDA extension has no background-job helper, so the sync was awaited. Re-import dsh-eda-bridge-extension-' + VERSION + '.zip to use the async + polling flow.',
         }
       }
       return {
@@ -2284,7 +2284,7 @@ async function executeTool(name, rawArgs, timeoutMs) {
           // Older EDA extension without the background-job helper: fall back to the
           // blocking call (which may hit the tool timeout for large boards).
           const blocking = asRecord(await callExtension('pcb_Document.autoRouting', [props], toolTimeout(args, timeoutMs)))
-          return { ...blocking, backgroundUnavailable: true, props, hint: 'The imported EDA extension has no background-job helper, so routing was awaited. Re-import dsh-eda-bridge-extension.zip to get the async + polling flow.' }
+          return { ...blocking, backgroundUnavailable: true, props, hint: 'The imported EDA extension has no background-job helper, so routing was awaited. Re-import dsh-eda-bridge-extension-' + VERSION + '.zip to get the async + polling flow.' }
         }
         const running = started.started === true || started.alreadyRunning === true
         return {

package/src/client/EdaMcpSettingsCard.tsx

@@ -456,7 +456,8 @@ export function EdaMcpSettingsCard(props: EdaMcpSettingsCardProps) {
         <Field label={t('settings.downloadExtension')} hint={t('settings.installHint')}>
           <a
             href="/api/dsh-eda-mcp/extension.zip"
-            download="dsh-eda-bridge-extension.zip"
+            // No download name: the server sends the versioned file name, so the
+            // saved copy always states which build it is.
             style={{ ...secondaryButtonStyle, textDecoration: 'none', display: 'inline-flex', width: 'fit-content' }}
           >
             {t('settings.downloadExtension')}

package/src/index.ts

@@ -5,6 +5,7 @@ import type {} from '@deepseek-ai/dsh-settings'
 import * as mcpClient from '@deepseek-ai/dsh-mcp-client'
 import z from '@deepseek-ai/schemastery'
 import { fileURLToPath } from 'node:url'
+import { existsSync, readFileSync } from 'node:fs'
 import { dirname } from 'node:path'
 import { EDA_MCP_GUIDANCE, SECTION_ORDER } from './guidance.ts'
 import { makeEdaMcpRoutes, makeEdaMcpSettingsRoutes, type SettingsBridge } from './routes.ts'
@@ -141,7 +142,27 @@ function installSettingsSection<T>(ctx: Context, scoped: Context, ns: string, sc
 export const inject = ['webServer', 'systemPrompt']
 
 const BRIDGE_URL = new URL('../lib/bridge.mjs', import.meta.url)
-const EXTENSION_ZIP_URL = new URL('../dsh-eda-bridge-extension.zip', import.meta.url)
+
+/**
+ * The extension zip is shipped as `dsh-eda-bridge-extension-<version>.zip` (the
+ * version is the wire contract in jlc-extension/extension.json). Resolve it from
+ * that manifest instead of hard-coding a file name; older layouts without a
+ * versioned file keep working through the plain-name fallback.
+ */
+function resolveExtensionZipPath(): string {
+  const plain = fileURLToPath(new URL('../dsh-eda-bridge-extension.zip', import.meta.url))
+  try {
+    const manifest = JSON.parse(readFileSync(fileURLToPath(new URL('../jlc-extension/extension.json', import.meta.url)), 'utf8')) as { version?: string }
+    const version = typeof manifest.version === 'string' ? manifest.version : ''
+    if (version !== '') {
+      const versioned = fileURLToPath(new URL('../dsh-eda-bridge-extension-' + version + '.zip', import.meta.url))
+      if (existsSync(versioned)) return versioned
+    }
+  } catch {
+    // Bundle-only installs may lack the manifest; the plain name is the fallback.
+  }
+  return plain
+}
 
 /** Bridge script path, resolved once. */
 const BRIDGE_PATH = fileURLToPath(BRIDGE_URL)
@@ -252,7 +273,7 @@ export function apply(ctx: Context, config?: EdaMcpConfig): void {
   ctx.effect(() => {
     const disposers = makeEdaMcpRoutes({
       getConfig: () => current(),
-      extensionZipPath: fileURLToPath(EXTENSION_ZIP_URL),
+      extensionZipPath: resolveExtensionZipPath(),
       reconnect: remountClient,
       bridgeLaunch: describeBridgeLaunch,
       diagnostics: () => diagnostics.liveSnapshot(),

package/src/routes.ts

@@ -1,4 +1,5 @@
 import { createReadStream } from 'node:fs'
+import { basename } from 'node:path'
 import type { ServerResponse } from 'node:http'
 import type { WebRoute } from '@deepseek-ai/dsh-host-webserver'
 import { SettingsConflictError, type SettingsPathOp } from '@deepseek-ai/dsh-settings'
@@ -186,7 +187,8 @@ export function makeEdaMcpRoutes(deps: EdaMcpRouteDeps): WebRoute[] {
       if (!isLoopbackRequest(req)) return json(res, 403, { ok: false, error: 'forbidden' })
       res.writeHead(200, {
         'content-type': 'application/zip',
-        'content-disposition': 'attachment; filename="dsh-eda-bridge-extension.zip"',
+        // Keep the versioned file name the browser saves it as.
+        'content-disposition': 'attachment; filename="' + basename(deps.extensionZipPath) + '"',
         'cache-control': 'no-store',
       })
       const stream = createReadStream(deps.extensionZipPath)