batter-pixso-mcp 0.5.0 → 0.7.0-beta.0

package/dist/index.js

@@ -1,210 +1,296 @@
 #!/usr/bin/env node
-
-// src/plugin/assets.ts
-import { createHash } from "node:crypto";
-import { mkdir, readdir, stat, unlink, writeFile } from "node:fs/promises";
-import { join as join2 } from "node:path";
+var __defProp = Object.defineProperty;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __esm = (fn, res) => function __init() {
+  return fn && (res = (0, fn[__getOwnPropNames(fn)[0]])(fn = 0)), res;
+};
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
 
 // src/config.ts
 import { tmpdir } from "node:os";
 import { join } from "node:path";
-var VERSION = true ? "0.5.0" : "0.0.0-dev";
-var HUB_NAME = "batter-pixso-mcp";
-var ASSETS_DIR = join(tmpdir(), "batter-pixso-assets");
-var config = {
-  /** 插件通信 HTTP 端口，仅监听 127.0.0.1。与插件 UI 的 DEFAULT_PORT 互为默认对端，改默认需同步 */
-  httpPort: Number(process.env.HTTP_PORT ?? 3210),
-  /** hub 空闲自毁阈值（无插件、无 agent 请求），默认 30 分钟 */
-  hubIdleMs: Number(process.env.HUB_IDLE_MS ?? 30 * 60 * 1e3),
-  /** 产物图片保留时长，默认 7 天 */
-  assetTtlMs: Number(process.env.ASSET_TTL_DAYS ?? 7) * 24 * 60 * 60 * 1e3
-};
-function hubBaseUrl() {
+function sleep(ms) {
+  const { promise, resolve } = Promise.withResolvers();
+  setTimeout(resolve, ms);
+  return promise;
+}
+function serviceBaseUrl() {
   return `http://127.0.0.1:${config.httpPort}`;
 }
+function mcpUrl() {
+  return `${serviceBaseUrl()}/mcp`;
+}
+function claudeAddCommand() {
+  return `claude mcp add --transport http batter-pixso ${mcpUrl()}`;
+}
 function log(...args) {
   console.error("[batter-pixso-mcp]", ...args);
 }
-function withResolvers() {
-  let resolve;
-  let reject;
-  const promise = new Promise((res, rej) => {
-    resolve = res;
-    reject = rej;
-  });
-  return { promise, resolve, reject };
+var VERSION, DEFAULT_PORT, SERVICE_NAME, ASSETS_DIR, config, PING_TIMEOUT_MS, SESSION_ONLINE_WINDOW_MS, COMMAND_TIMEOUT_MS, SSE_HEARTBEAT_MS, MCP_SESSION_SWEEP_MS, PROBE_TIMEOUT_MS, ASSET_SWEEP_INTERVAL_MS;
+var init_config = __esm({
+  "src/config.ts"() {
+    "use strict";
+    VERSION = true ? "0.7.0-beta.0" : "0.0.0-dev";
+    DEFAULT_PORT = true ? 3210 : 3210;
+    SERVICE_NAME = "batter-pixso-mcp";
+    ASSETS_DIR = join(tmpdir(), "batter-pixso-assets");
+    config = {
+      /** 插件通信 HTTP 端口，仅监听 127.0.0.1。默认值见上方 DEFAULT_PORT（HTTP_PORT 环境变量优先） */
+      httpPort: Number(process.env.HTTP_PORT ?? DEFAULT_PORT),
+      /** MCP HTTP 会话空闲 TTL：超时清扫防泄漏（客户端重连重新 initialize 即可恢复），默认 30 分钟 */
+      mcpSessionTtlMs: Number(process.env.MCP_SESSION_TTL_MS ?? 30 * 60 * 1e3),
+      /** 产物图片保留时长，默认 7 天 */
+      assetTtlMs: Number(process.env.ASSET_TTL_DAYS ?? 7) * 24 * 60 * 60 * 1e3
+    };
+    PING_TIMEOUT_MS = 800;
+    SESSION_ONLINE_WINDOW_MS = 45e3;
+    COMMAND_TIMEOUT_MS = 6e4;
+    SSE_HEARTBEAT_MS = 15e3;
+    MCP_SESSION_SWEEP_MS = 6e4;
+    PROBE_TIMEOUT_MS = 1500;
+    ASSET_SWEEP_INTERVAL_MS = 60 * 6e4;
+  }
+});
+
+// src/cli/service.ts
+var service_exports = {};
+__export(service_exports, {
+  PORT_FIX_HINT: () => PORT_FIX_HINT,
+  probeService: () => probeService,
+  serviceStateError: () => serviceStateError,
+  stopRunningService: () => stopRunningService,
+  stopService: () => stopService
+});
+async function probeService() {
+  try {
+    const res = await fetch(`${serviceBaseUrl()}/health`, { signal: AbortSignal.timeout(PROBE_TIMEOUT_MS) });
+    if (!res.ok) return { state: "foreign" };
+    let body;
+    try {
+      body = await res.json();
+    } catch {
+      return { state: "foreign" };
+    }
+    if (body.ok === true && body.name === SERVICE_NAME) return { state: "alive", health: body };
+    return { state: "foreign" };
+  } catch (err) {
+    const hung = err instanceof Error && err.name === "TimeoutError";
+    return { state: hung ? "hung" : "down" };
+  }
+}
+function serviceStateError(state) {
+  if (state === "hung") {
+    return new Error(`\u7AEF\u53E3 ${config.httpPort} \u4E0A\u7684\u670D\u52A1\u65E0\u54CD\u5E94\uFF08\u53EF\u80FD\u6302\u6B7B\uFF09\u3002${PORT_FIX_HINT}`);
+  }
+  return new Error(`\u7AEF\u53E3 ${config.httpPort} \u88AB\u5176\u4ED6\u7A0B\u5E8F\u5360\u7528\u3002${PORT_FIX_HINT}\uFF0C\u6216\u4FEE\u6539 HTTP_PORT \u6362\u7AEF\u53E3`);
+}
+function killServiceByPid(pid) {
+  try {
+    process.kill(pid);
+    return true;
+  } catch {
+    return false;
+  }
+}
+async function stopRunningService() {
+  const { state, health } = await probeService();
+  if (state !== "alive") return state;
+  return killServiceByPid(health.pid) ? "stopped" : "failed";
 }
+async function stopService() {
+  const result = await stopRunningService();
+  if (result === "down") {
+    log(`\u670D\u52A1\u672A\u5728\u8FD0\u884C\uFF08\u7AEF\u53E3 ${config.httpPort} \u65E0\u670D\u52A1\uFF09`);
+  } else if (result === "foreign") {
+    log(`\u7AEF\u53E3 ${config.httpPort} \u4E0A\u4E0D\u662F batter-pixso-mcp\uFF0C\u672A\u5904\u7406`);
+  } else if (result === "stopped") {
+    log("\u670D\u52A1\u5DF2\u505C\u6B62");
+  } else {
+    log(`\u505C\u6B62\u5931\u8D25${result === "hung" ? "\uFF08\u670D\u52A1\u65E0\u54CD\u5E94\uFF0C\u53EF\u80FD\u6302\u6B7B\uFF09" : ""}\u3002${PORT_FIX_HINT}`);
+  }
+}
+var PORT_FIX_HINT;
+var init_service = __esm({
+  "src/cli/service.ts"() {
+    "use strict";
+    init_config();
+    PORT_FIX_HINT = `\u7528 netstat -ano | findstr :${config.httpPort} \u67E5\u5230 PID \u540E taskkill /PID <pid> /F \u7ED3\u675F\uFF0C\u518D\u91CD\u8BD5`;
+  }
+});
 
-// src/plugin/assets.ts
-var EXT_BY_FORMAT = {
-  PNG: ".png",
-  SVG: ".svg",
-  JPG: ".jpg",
-  JPEG: ".jpg",
-  WEBP: ".webp",
-  PDF: ".pdf"
-  // export_image 尊重设计师导出标记，标记可能指定 PDF
-};
-var dirReady = null;
-async function saveAsset(bytes, format) {
-  dirReady ??= mkdir(ASSETS_DIR, { recursive: true });
-  await dirReady;
-  const ext = EXT_BY_FORMAT[format.toUpperCase()] ?? ".bin";
-  const name = `${createHash("sha1").update(bytes).digest("hex").slice(0, 16)}${ext}`;
-  await writeFile(join2(ASSETS_DIR, name), bytes);
-  log(`asset saved: ${name} (${bytes.length} bytes)`);
-  return name;
+// src/install/dist-resolver.ts
+import { existsSync } from "node:fs";
+import { readFile } from "node:fs/promises";
+import { join as join2 } from "node:path";
+import { fileURLToPath } from "node:url";
+function resolvePluginDir() {
+  const candidates = [
+    fileURLToPath(new URL("./plugin/", import.meta.url)),
+    // bundle: dist/index.js → dist/plugin/
+    fileURLToPath(new URL("../../plugin/dist/", import.meta.url)),
+    // bundle 开发: dist/index.js → packages/plugin/dist/
+    fileURLToPath(new URL("../../../plugin/dist/", import.meta.url))
+    // tsx 开发: src/install/ → packages/plugin/dist/
+  ];
+  return candidates.find((p) => existsSync(join2(p, "manifest.json"))) ?? null;
 }
-function substituteAssets(result, assets) {
-  if (!assets.length) return result;
-  const nameByKey = new Map(assets.map((a) => [a.key, a.name]));
-  return JSON.parse(
-    JSON.stringify(
-      result,
-      (_k, v) => typeof v === "string" ? nameByKey.get(v) ?? v : v
-    )
-  );
+function pluginDistDir() {
+  resolved ??= resolvePluginDir();
+  return resolved;
 }
-async function cleanOldAssets(ttlMs) {
-  let removed = 0;
-  const cutoff = Date.now() - ttlMs;
-  let names;
+function hasPluginDist() {
+  return pluginDistDir() !== null;
+}
+async function pluginManifest() {
+  const dir = pluginDistDir();
+  if (!dir) return null;
+  const raw = JSON.parse(await readFile(join2(dir, "manifest.json"), "utf8"));
+  raw.networkAccess = {
+    allowedDomains: [`http://localhost:${config.httpPort}`, `http://127.0.0.1:${config.httpPort}`]
+  };
+  return Buffer.from(JSON.stringify(raw, null, 2));
+}
+async function readPluginFile(name) {
+  const dir = pluginDistDir();
+  if (!dir) return null;
   try {
-    names = await readdir(ASSETS_DIR);
+    return await readFile(join2(dir, name));
   } catch {
-    return 0;
+    return null;
+  }
+}
+var resolved;
+var init_dist_resolver = __esm({
+  "src/install/dist-resolver.ts"() {
+    "use strict";
+    init_config();
+    resolved = null;
   }
-  for (const name of names) {
+});
+
+// src/cli/setup.ts
+var setup_exports = {};
+__export(setup_exports, {
+  setupAutostart: () => setupAutostart,
+  uninstallAutostart: () => uninstallAutostart
+});
+import { spawnSync } from "node:child_process";
+import { existsSync as existsSync2, mkdirSync, readFileSync, rmSync, writeFileSync } from "node:fs";
+import { copyFile, cp } from "node:fs/promises";
+import { dirname, join as join3 } from "node:path";
+import { fileURLToPath as fileURLToPath2 } from "node:url";
+function serviceCmd() {
+  return [
+    "@echo off",
+    `set HTTP_PORT=${config.httpPort}`,
+    `"%~dp0node.exe" "%~dp0index.js" >> "%TEMP%\\${SERVICE_LOG_NAME}" 2>&1`
+  ].join("\r\n");
+}
+async function withTransientLockRetry(what, action) {
+  for (let i = 0; ; i++) {
     try {
-      const p = join2(ASSETS_DIR, name);
-      const s = await stat(p);
-      if (s.isFile() && s.mtimeMs < cutoff) {
-        await unlink(p);
-        removed++;
+      await action();
+      return;
+    } catch (err) {
+      const code = err.code ?? "";
+      if (!TRANSIENT_LOCK_ERRORS.has(code) || i >= 4) {
+        throw new Error(
+          `\u62F7\u8D1D\u5931\u8D25 ${what}\uFF08${code || err}\uFF09\uFF1A\u6587\u4EF6\u88AB\u5360\u7528\u2014\u2014\u82E5\u81EA\u542F\u5B9E\u4F8B\u6B63\u5728\u8FD0\u884C\uFF0C\u8BF7\u5148 --stop\uFF1B\u5426\u5219\u591A\u4E3A\u6740\u6BD2\u8F6F\u4EF6\u626B\u63CF\u9501\u5B9A\uFF0C\u7A0D\u5019\u91CD\u8BD5`,
+          { cause: err }
+        );
       }
-    } catch {
+      await sleep(500);
     }
   }
-  if (removed > 0) log(`assets cleanup: removed ${removed} expired file(s)`);
-  return removed;
 }
-
-// src/plugin/sessions.ts
-import { randomUUID } from "node:crypto";
-var ONLINE_WINDOW_MS = 45e3;
-function unknownTargetError(target) {
-  return new Error(`\u627E\u4E0D\u5230\u76EE\u6807\u63D2\u4EF6\u4F1A\u8BDD\uFF1A${target}\u3002\u53EF\u7528 list_sessions \u67E5\u770B\u5F53\u524D\u8FDE\u63A5\u7684\u4F1A\u8BDD`);
+async function copyWithRetry(src, dest) {
+  await withTransientLockRetry(dest, () => copyFile(src, dest));
 }
-var SessionRegistry = class {
-  sessions = /* @__PURE__ */ new Map();
-  lastActiveId = null;
-  /** 会话亲和：fileKey → 上一次路由使用的 sessionId（仍在线时优先，避免同文件多实例间漂移） */
-  lastUsedByFileKey = /* @__PURE__ */ new Map();
-  isOnline(s) {
-    return s.connected || Date.now() - s.lastSeen < ONLINE_WINDOW_MS;
-  }
-  /** fileKey 寻址候选：该文件的在线会话（谁先 pong 由 ping 竞速决定，此处不排序） */
-  candidatesForFileKey(fileKey) {
-    return [...this.sessions.values()].filter((s) => s.meta.fileKey === fileKey && this.isOnline(s));
-  }
-  /** 亲和查询：上一次为该 fileKey 服务的 sessionId */
-  affinityIdOf(fileKey) {
-    return this.lastUsedByFileKey.get(fileKey);
-  }
-  /** 亲和钉住：fileKey 寻址探活成功后记录（下次优先） */
-  pinAffinity(fileKey, sessionId) {
-    this.lastUsedByFileKey.set(fileKey, sessionId);
-  }
-  /** 剔除会话（幽灵剔除/ping 判死共用）：清理亲和引用；存活但繁忙被误剔的插件会在 SSE 断开或上报 404 后自重注册 */
-  evict(id) {
-    if (this.sessions.delete(id)) {
-      for (const [k, v] of this.lastUsedByFileKey) {
-        if (v === id) this.lastUsedByFileKey.delete(k);
-      }
-      log(`session evicted: ${id.slice(0, 8)}`);
-    }
+async function materializeAutostart() {
+  if (!DIR) throw new Error("\u65E0\u6CD5\u5B9A\u4F4D\u7269\u5316\u76EE\u5F55\uFF1A\u73AF\u5883\u53D8\u91CF LOCALAPPDATA \u672A\u8BBE\u7F6E");
+  const bundle = fileURLToPath2(import.meta.url);
+  if (!bundle.endsWith(".js")) {
+    throw new Error("--setup \u4EC5\u652F\u6301\u53D1\u5E03\u5305\u5F62\u6001\uFF08dist bundle\uFF09\uFF1Btsx \u5F00\u53D1\u6001\u8BF7\u5148 npm run build \u540E\u7528 dist \u5165\u53E3\u6267\u884C");
+  }
+  const standalone = join3(dirname(bundle), "..", "standalone", "index.js");
+  if (!existsSync2(standalone)) {
+    throw new Error("\u672A\u627E\u5230 standalone bundle\uFF08standalone/index.js\uFF09\uFF1B\u4ED3\u5E93\u5185\u8BF7\u5148\u6267\u884C npm run pack:standalone -w batter-pixso-mcp");
+  }
+  const fresh = autostartVersion() === VERSION && existsSync2(join3(DIR, "node.exe")) && existsSync2(join3(DIR, "index.js")) && existsSync2(join3(DIR, "plugin", "manifest.json"));
+  mkdirSync(DIR, { recursive: true });
+  if (!fresh) {
+    const plugin = pluginDistDir();
+    await Promise.all([
+      copyWithRetry(process.execPath, join3(DIR, "node.exe")),
+      copyWithRetry(standalone, join3(DIR, "index.js")),
+      ...plugin ? [withTransientLockRetry(join3(DIR, "plugin"), () => cp(plugin, join3(DIR, "plugin"), { recursive: true }))] : []
+    ]);
+  }
+  writeFileSync(join3(DIR, "service.cmd"), serviceCmd(), "utf8");
+  writeFileSync(join3(DIR, "run.vbs"), RUN_VBS, "utf8");
+  writeFileSync(join3(DIR, "version.txt"), VERSION, "utf8");
+}
+function autostartVersion() {
+  if (!DIR) return null;
+  try {
+    return readFileSync(join3(DIR, "version.txt"), "utf8").trim() || null;
+  } catch {
+    return null;
   }
-  register(meta = {}) {
-    if (meta.fileKey) {
-      for (const s of [...this.sessions.values()]) {
-        if (s.meta.fileKey === meta.fileKey && !this.isOnline(s)) {
-          this.evict(s.id);
-        }
-      }
-    }
-    const session = { id: randomUUID(), meta, lastSeen: Date.now(), connected: false };
-    this.sessions.set(session.id, session);
-    this.lastActiveId = session.id;
-    log(`session registered: ${session.id} (${meta.fileName ?? "unknown file"})`);
-    return this.toInfo(session);
-  }
-  /** 心跳/连接状态用：只刷 lastSeen，不影响 lastActiveId（"最近活跃"= 用户行为，心跳不算） */
-  touchSeen(id) {
-    const s = this.sessions.get(id);
-    if (!s) return null;
-    s.lastSeen = Date.now();
-    return s;
-  }
-  /** 用户行为（选区上报/命令服务/注册）：刷 lastSeen 并标记最近活跃 */
-  touch(id) {
-    const s = this.touchSeen(id);
-    if (!s) return null;
-    this.lastActiveId = id;
-    return s;
-  }
-  setConnected(id, connected) {
-    const s = this.touchSeen(id);
-    if (!s) return false;
-    s.connected = connected;
-    return true;
+}
+async function setupAutostart() {
+  if (process.platform !== "win32") {
+    throw new Error("--setup \u5F53\u524D\u4EC5\u652F\u6301 Windows\uFF1Bmac/Linux \u8BF7\u7528\u7CFB\u7EDF\u5F00\u673A\u542F\u52A8\u673A\u5236\u914D\u7F6E npx batter-pixso-mcp");
   }
-  updateContext(id, meta) {
-    const s = this.touch(id);
-    if (!s) return false;
-    s.meta = { ...s.meta, ...meta };
-    log(
-      `context updated [${id.slice(0, 8)}]: ${s.meta.fileName ?? "?"} / ${s.meta.pageName ?? "?"} / ${s.meta.selection?.length ?? 0} selected`
-    );
-    return true;
+  await materializeAutostart();
+  const target = `wscript.exe "${join3(DIR, "run.vbs")}"`;
+  const r = spawnSync("reg", ["add", RUN_KEY, "/v", RUN_VALUE, "/t", "REG_SZ", "/d", target, "/f"]);
+  if (r.status !== 0) {
+    throw new Error(`\u6CE8\u518C\u5F00\u673A\u81EA\u542F\u5931\u8D25\uFF1A${r.stderr?.toString().trim() || `reg exit ${r.status}`}`);
   }
-  list() {
-    return [...this.sessions.values()].map((s) => this.toInfo(s));
+  log(`\u5F00\u673A\u81EA\u542F\u5DF2\u6CE8\u518C\uFF1A\u767B\u5F55\u540E\u9759\u9ED8\u542F\u52A8\u670D\u52A1\uFF08\u526F\u672C\u5728 ${DIR}\uFF0C\u4E0E nvm/npm \u72B6\u6001\u65E0\u5173\uFF09`);
+}
+async function uninstallAutostart() {
+  if (process.platform === "win32") {
+    spawnSync("reg", ["delete", RUN_KEY, "/v", RUN_VALUE, "/f"]);
+    log("\u5DF2\u79FB\u9664\u5F00\u673A\u81EA\u542F\uFF08\u82E5\u66FE\u6CE8\u518C\uFF09");
   }
-  /** 纯查找（不判活）：工具层寻址用——离线会话也可取到 fileKey 用于候选扩展与故障转移 */
-  get(id) {
-    return this.sessions.get(id);
+  const result = await stopRunningService();
+  if (result === "failed" || result === "hung") {
+    log(`\u670D\u52A1\u505C\u6B62\u5931\u8D25\uFF0C\u7269\u5316\u76EE\u5F55\u53EF\u80FD\u5220\u4E0D\u51C0\u3002${PORT_FIX_HINT}`);
   }
-  /** 缺省路由：最近活跃在线会话 > 任意在线会话（显式 target 由工具层 get/candidatesForFileKey + ping 完成） */
-  resolve() {
-    if (this.lastActiveId) {
-      const s = this.sessions.get(this.lastActiveId);
-      if (s && this.isOnline(s)) return s;
+  if (DIR && existsSync2(DIR)) {
+    try {
+      rmSync(DIR, { recursive: true, force: true, maxRetries: 4, retryDelay: 500 });
+    } catch {
     }
-    const fallback = [...this.sessions.values()].find((s) => this.isOnline(s));
-    if (fallback) return fallback;
-    throw new Error("Pixso \u63D2\u4EF6\u672A\u8FDE\u63A5\uFF1A\u8BF7\u5728 Pixso \u5BA2\u6237\u7AEF\u4E2D\u8FD0\u884C Batter Pixso Bridge \u63D2\u4EF6");
-  }
-  toInfo(s) {
-    return {
-      sessionId: s.id,
-      fileKey: s.meta.fileKey,
-      fileName: s.meta.fileName,
-      pageName: s.meta.pageName,
-      selectionCount: s.meta.selection?.length,
-      online: this.isOnline(s),
-      lastSeen: s.lastSeen
-    };
+    log(existsSync2(DIR) ? `\u76EE\u5F55\u5220\u9664\u5931\u8D25\uFF0C\u53EF\u624B\u52A8\u5220\u9664\uFF1A${DIR}` : `\u5DF2\u5220\u9664\u7269\u5316\u76EE\u5F55 ${DIR}`);
   }
-};
-var sessions = new SessionRegistry();
-
-// src/http.ts
-import { createServer } from "node:http";
-
-// src/agent/http.ts
-import { randomUUID as randomUUID2 } from "node:crypto";
-import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
-import { isInitializeRequest } from "@modelcontextprotocol/sdk/types.js";
+  log("\u5378\u8F7D\u5B8C\u6210\uFF08npm \u5168\u5C40/npx \u7F13\u5B58\u4E2D\u7684\u5305\u5982\u9700\u6E05\u7406\u8BF7\u81EA\u884C npm uninstall\uFF09");
+}
+var DIR, RUN_KEY, RUN_VALUE, SERVICE_LOG_NAME, RUN_VBS, TRANSIENT_LOCK_ERRORS;
+var init_setup = __esm({
+  "src/cli/setup.ts"() {
+    "use strict";
+    init_config();
+    init_dist_resolver();
+    init_service();
+    DIR = process.env.LOCALAPPDATA ? join3(process.env.LOCALAPPDATA, "batter-pixso-mcp") : null;
+    RUN_KEY = "HKCU\\Software\\Microsoft\\Windows\\CurrentVersion\\Run";
+    RUN_VALUE = "BatterPixsoMcp";
+    SERVICE_LOG_NAME = "batter-pixso-mcp-service.log";
+    RUN_VBS = [
+      "Set fso = CreateObject(" + JSON.stringify("Scripting.FileSystemObject") + ")",
+      "dir = fso.GetParentFolderName(WScript.ScriptFullName)",
+      // 路径由脚本自身位置推导，不写死绝对路径（用户名含中文/空格时 VBS 字面量会翻车）
+      'CreateObject("Wscript.Shell").Run """" & dir & "\\service.cmd""", 0, False'
+    ].join("\r\n");
+    TRANSIENT_LOCK_ERRORS = /* @__PURE__ */ new Set(["EPERM", "EBUSY"]);
+  }
+});
 
 // src/http-body.ts
 function sendJson(res, status, body) {
@@ -216,8 +302,6 @@ async function readBody(req) {
   for await (const chunk of req) chunks.push(chunk);
   return Buffer.concat(chunks);
 }
-var JsonBodyError = class extends Error {
-};
 async function readJsonBody(req) {
   const buf = await readBody(req);
   try {
@@ -226,7 +310,6 @@ async function readJsonBody(req) {
     throw new JsonBodyError("invalid json");
   }
 }
-var segsCache = /* @__PURE__ */ new Map();
 function segsOf(template) {
   let segs = segsCache.get(template);
   if (!segs) {
@@ -261,7 +344,7 @@ async function dispatchRoute(routes, req, res, url) {
       if (err instanceof JsonBodyError) {
         if (!res.headersSent) sendJson(res, 400, { error: "invalid json" });
       } else {
-        console.error("[batter-pixso-mcp] route handler error:", err);
+        log("route handler error:", err);
         if (!res.headersSent) sendJson(res, 500, { error: "internal error" });
       }
     }
@@ -269,25 +352,30 @@ async function dispatchRoute(routes, req, res, url) {
   }
   return false;
 }
-
-// src/agent/mcp.ts
-import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-import {
-  CallToolRequestSchema,
-  GetPromptRequestSchema,
-  ListPromptsRequestSchema,
-  ListResourceTemplatesRequestSchema,
-  ListToolsRequestSchema
-} from "@modelcontextprotocol/sdk/types.js";
+var JsonBodyError, segsCache;
+var init_http_body = __esm({
+  "src/http-body.ts"() {
+    "use strict";
+    init_config();
+    JsonBodyError = class extends Error {
+    };
+    segsCache = /* @__PURE__ */ new Map();
+  }
+});
 
 // src/agent/guides.ts
-var INTRO = `# batter-pixso-mcp \u4F7F\u7528\u6307\u5357
+var INTRO, DESIGN_TO_CODE, GUIDES;
+var init_guides = __esm({
+  "src/agent/guides.ts"() {
+    "use strict";
+    init_config();
+    INTRO = `# batter-pixso-mcp \u4F7F\u7528\u6307\u5357
 
 ## \u5DE5\u5177\u603B\u89C8
 
 | \u5DE5\u5177 | \u7528\u9014 |
 | --- | --- |
-| \`get_selected\` | \u8BFB\u753B\u5E03\u5F53\u524D\u9009\u4E2D\u56FE\u5C42\uFF08guid\u3001\u540D\u79F0\u3001\u7C7B\u578B\u3001\u5C3A\u5BF8\uFF09 |
+| \`get_selected\` | \u8BFB\u753B\u5E03\u5F53\u524D\u9009\u4E2D\u56FE\u5C42\uFF08guid\u3001\u540D\u79F0\u3001\u7C7B\u578B\uFF09 |
 | \`get_metadata\` | \u5168\u6811\u7ED3\u6784\u9AA8\u67B6\uFF08\u4EC5 id/name/type/kids\uFF0C\u65E0\u6837\u5F0F/\u5750\u6807/\u8D44\u6E90\uFF09\uFF0C\u9996\u6B21\u5B9A\u4F4D\u7528 |
 | \`get_node_dsl\` | \u751F\u6210\u8282\u70B9\u7684\u5F00\u53D1\u5411\u7CBE\u7B80 DSL\uFF08\u7ED3\u6784 + \u6837\u5F0F + \u8D44\u6E90\u6587\u4EF6\u540D\uFF09\uFF0C\u8BBE\u8BA1\u8F6C\u4EE3\u7801\u7684\u6838\u5FC3\u5165\u53E3 |
 | \`get_screenshot\` | \u5BFC\u51FA\u8282\u70B9\u622A\u56FE\uFF0C\u8FD4\u56DE\u56FE\u7247\u6587\u4EF6\u540D\uFF08\u672C\u673A\u8DEF\u5F84\u76F4\u8BFB\uFF09\uFF0C\u7528\u4E8E\u89C6\u89C9\u53C2\u7167/\u6821\u9A8C |
@@ -302,18 +390,18 @@ var INTRO = `# batter-pixso-mcp \u4F7F\u7528\u6307\u5357
 
 ## \u591A\u6587\u4EF6\u573A\u666F
 
-\u6BCF\u4E2A\u8FD0\u884C\u63D2\u4EF6\u7684\u8BBE\u8BA1\u6587\u4EF6\u662F\u4E00\u4E2A\u4F1A\u8BDD\u3002\u591A\u4E2A\u6587\u4EF6\u540C\u65F6\u6253\u5F00\u65F6\uFF1A
-\u5148\u7528 \`list_sessions\` \u786E\u8BA4\u76EE\u6807\u6587\u4EF6\uFF0C\u518D\u628A\u8FD4\u56DE\u7684 \`sessionId\` \u6216 \`fileKey\`
-\u4F5C\u4E3A\u5176\u4ED6\u5DE5\u5177\u7684 \`target\` \u53C2\u6570\u4F20\u5165\uFF1B\u4E0D\u4F20 \`target\` \u65F6\u8DEF\u7531\u5230\u6700\u8FD1\u6D3B\u8DC3\u7684\u6587\u4EF6\u3002
+\u6BCF\u4E2A\u8FD0\u884C\u63D2\u4EF6\u7684\u8BBE\u8BA1\u6587\u4EF6\u662F\u4E00\u4E2A\u4F1A\u8BDD\u3002\u8282\u70B9\u7C7B\u5DE5\u5177\uFF08\`get_node_dsl\`/\`get_metadata\`/\`get_screenshot\`/\`export_image\`\uFF09
+\u7684 \`guid\` \u5FC5\u4F20\uFF0C\u4E14 \`fileKey\`/\`sessionId\` \u4E8C\u9009\u4E00\u5FC5\u4F20\uFF1A\u5148\u7528 \`list_sessions\` \u786E\u8BA4\u76EE\u6807\u6587\u4EF6\uFF0C\u628A\u8FD4\u56DE\u7684 \`fileKey\`
+\u4F5C\u4E3A\u8DEF\u7531\u53C2\u6570\u4F20\u5165\uFF08\u8DE8\u91CD\u5F00\u7A33\u5B9A\uFF0C\u4F18\u5148\u4E8E \`sessionId\`\uFF09\uFF1B\u4EC5 \`get_selected\`/\`list_sessions\` \u53EF\u7F3A\u7701\u8DEF\u7531\u53C2\u6570\u505A\u63A2\u67E5\u3002
 
-**\u4F1A\u8BDD\u89E3\u6790\u4E0E\u4FE1\u5C01**\uFF1A\u63D2\u4EF6\u7C7B\u5DE5\u5177\u7684\u8FD4\u56DE\u7EDF\u4E00\u4E3A \`{sessionId, data}\`\u2014\u2014\`sessionId\` \u662F\u672C\u6B21\u5B9E\u9645\u670D\u52A1\u7684\u4F1A\u8BDD
-\uFF08\u6BCF\u6B21\u8C03\u7528\u7ECF ping/pong \u63A2\u6D3B\u91CD\u65B0\u786E\u8BA4\uFF0C\u4E0D\u662F\u53EF\u957F\u671F\u9489\u4F4F\u7684\u56FA\u5B9A\u6807\u8BC6\uFF09\u3002\u63A8\u8350 \`target\` \u7528 \`fileKey\`\uFF1A
-\u6BCF\u6B21\u8C03\u7528\u6309 fileKey \u91CD\u65B0\u5BFB\u5740\u2014\u2014\u540C fileKey \u591A\u4F1A\u8BDD\u65F6\u4F18\u5148\u4E0A\u4E00\u6B21\u4F7F\u7528\u7684\uFF08\u4EB2\u548C\uFF09\uFF0C\u6587\u4EF6\u5173\u95ED\u91CD\u5F00\u3001\u63D2\u4EF6\u91CD\u8DD1\u540E
+**\u4F1A\u8BDD\u89E3\u6790\u4E0E\u4FE1\u5C01**\uFF1A\u63D2\u4EF6\u7C7B\u5DE5\u5177\u7684\u8FD4\u56DE\u7EDF\u4E00\u4E3A \`{sessionId, fileKey, data}\`\u2014\u2014\`sessionId\` \u662F\u672C\u6B21\u5B9E\u9645\u670D\u52A1\u7684\u4F1A\u8BDD
+\uFF08\u6BCF\u6B21\u8C03\u7528\u7ECF ping/pong \u63A2\u6D3B\u91CD\u65B0\u786E\u8BA4\uFF0C\u4E0D\u662F\u53EF\u957F\u671F\u9489\u4F4F\u7684\u56FA\u5B9A\u6807\u8BC6\uFF09\uFF1B\`fileKey\` \u662F\u8DE8\u91CD\u5F00\u7A33\u5B9A\u7684\u53E5\u67C4\uFF0C\u540E\u7EED\u8C03\u7528
+\u7528\u5B83\u505A\u8DEF\u7531\u53C2\u6570\uFF1A\u6BCF\u6B21\u8C03\u7528\u6309 fileKey \u91CD\u65B0\u5BFB\u5740\u2014\u2014\u540C fileKey \u591A\u4F1A\u8BDD\u65F6\u4F18\u5148\u4E0A\u4E00\u6B21\u4F7F\u7528\u7684\uFF08\u4EB2\u548C\uFF09\uFF0C\u6587\u4EF6\u5173\u95ED\u91CD\u5F00\u3001\u63D2\u4EF6\u91CD\u8DD1\u540E
 \u81EA\u52A8\u89E3\u6790\u5230\u5F53\u524D\u5B58\u6D3B\u5B9E\u4F8B\uFF0Cagent \u65E0\u9700\u5173\u5FC3 sessionId \u7684\u5931\u6548\u3002
 
 \u8BE6\u7EC6\u5DE5\u4F5C\u6D41\u89C1\u8D44\u6E90 \`batter://guides/design-to-code\`\u3002
 `;
-var DESIGN_TO_CODE = `# \u8BBE\u8BA1\u8F6C\u4EE3\u7801\u5DE5\u4F5C\u6D41
+    DESIGN_TO_CODE = `# \u8BBE\u8BA1\u8F6C\u4EE3\u7801\u5DE5\u4F5C\u6D41
 
 ## \u3010\u786C\u6027\u89C4\u5219 \xB7 \u8FDD\u53CD\u5373\u8FD4\u5DE5\u3011
 
@@ -336,12 +424,12 @@ var DESIGN_TO_CODE = `# \u8BBE\u8BA1\u8F6C\u4EE3\u7801\u5DE5\u4F5C\u6D41
 
 1. **\u786E\u8BA4\u76EE\u6807\u8282\u70B9**
    - \u7528\u6237\u7ED9\u4E86 Pixso \u94FE\u63A5\uFF1A\u6309\u4E0A\u65B9\u786C\u6027\u89C4\u5219\u7B2C 2 \u6761\u63D0\u53D6 guid\uFF0C\u76F4\u63A5\u7EE7\u7EED\u3002
-   - \u7528\u6237\u660E\u786E\u8BF4\u4E86"\u8FD9\u4E2A/\u6211\u9009\u4E2D\u7684"\uFF1A\u8C03 \`get_selected\` \u62FF guid\uFF0C\u76F4\u63A5\u7EE7\u7EED\u3002
+   - \u7528\u6237\u660E\u786E\u8BF4\u4E86"\u8FD9\u4E2A/\u6211\u9009\u4E2D\u7684"\uFF1A\u8C03 \`get_selected\` \u62FF guid \u4E0E fileKey\uFF0C\u76F4\u63A5\u7EE7\u7EED\u3002
    - \u5176\u4F59\u4F9D\u8D56\u5F53\u524D\u9009\u533A\u7684\u573A\u666F\uFF1A**\u4E25\u7981\u9690\u5F0F\u4F7F\u7528\u9009\u533A guid**\u2014\u2014\u8C03 \`get_selected\` \u540E
      \u5FC5\u987B\u5148\u628A\u9009\u4E2D\u56FE\u5C42\u540D\u79F0\u62A5\u7ED9\u7528\u6237\u786E\u8BA4\uFF08"\u5F53\u524D\u9009\u4E2D\u7684\u662F\u300CXX\u300D\uFF0C\u786E\u8BA4\u5904\u7406\u5B83\u5417\uFF1F"\uFF09\uFF0C\u786E\u8BA4\u540E\u518D\u7EE7\u7EED\u3002
-     \`get_node_dsl\` / \`get_screenshot\` \u7684 guid \u7F3A\u7701\u56DE\u9000\u540C\u6837\u9002\u7528\u672C\u89C4\u5219\u3002
-2. **\u53D6\u7ED3\u6784**\uFF1A\u63D2\u4EF6\u7C7B\u5DE5\u5177\u8FD4\u56DE\u7EDF\u4E00\u4E3A \`{sessionId, data}\` \u4FE1\u5C01\u2014\u2014DSL \u5728 \`data\` \u5B57\u6BB5\u91CC\u3002
-   \`get_node_dsl(guid)\` \u62FF\u7CBE\u7B80 DSL\u3002
+     \u786E\u8BA4\u540E\u7684\u8C03\u7528\u91CC guid \u7528\u8FD4\u56DE\u7684\u9009\u4E2D\u56FE\u5C42 id\u3001\u8DEF\u7531\u53C2\u6570\u7528\u8FD4\u56DE\u7684 fileKey\uFF08guid \u5FC5\u4F20\u3001fileKey/sessionId \u5FC5\u4F20\u5176\u4E00\uFF09\u3002
+2. **\u53D6\u7ED3\u6784**\uFF1A\u63D2\u4EF6\u7C7B\u5DE5\u5177\u8FD4\u56DE\u7EDF\u4E00\u4E3A \`{sessionId, fileKey, data}\` \u4FE1\u5C01\u2014\u2014DSL \u5728 \`data\` \u5B57\u6BB5\u91CC\u3002
+   \`get_node_dsl(guid, fileKey)\` \u62FF\u7CBE\u7B80 DSL\uFF08guid \u5FC5\u4F20\uFF0CfileKey/sessionId \u5FC5\u4F20\u5176\u4E00\uFF09\u3002
    **\u9996\u6B21\u63A5\u89E6\u4E00\u4E2A\u8BBE\u8BA1\u7A3F/\u9875\u9762**\uFF08\u8FD8\u6CA1\u6709\u76EE\u6807\u8282\u70B9\u7684\u4E0A\u4E0B\u6587\u65F6\uFF09\uFF1A\u5148 \`get_metadata(guid)\`
    \u62FF\u5168\u6811\u9AA8\u67B6\uFF08\u4EC5 id/name/type/kids\uFF0C\u65E0\u6837\u5F0F/\u5750\u6807/\u8D44\u6E90\uFF0C\u4F53\u79EF\u6781\u5C0F\uFF09+ \`get_screenshot(guid)\` \u62FF\u89C6\u89C9\u5168\u8C8C\uFF0C
    \u636E\u6B64\u5B9A\u4F4D\u76EE\u6807\u8282\u70B9\uFF0C\u518D\u5BF9\u76EE\u6807\u6B63\u5E38\u53D6 DSL\u3002\u9AA8\u67B6\u4E2D ICON/IMAGE \u53F6\u5B50\u65E0 \`img\`\u2014\u2014\u9700\u8D44\u6E90\u65F6\u6309\u5176 \`id\` \u4E0B\u94BB\u5168\u91CF DSL\u3002
@@ -407,7 +495,7 @@ DSL \u662F\u5355\u884C\u7D27\u51D1 JSON\uFF1A\u77ED key\u3001\u4F4D\u7F6E\u6570\
 - **\u7F3A guid**\uFF1A\u5411\u7528\u6237\u8981\u5B8C\u6574\u7684 Pixso \u94FE\u63A5\uFF08\u542B item-id \u67E5\u8BE2\u53C2\u6570\uFF09\uFF0C\u4E0D\u8981\u731C\u6D4B\u8282\u70B9 id\u3002
 - **\u547D\u4EE4\u8D85\u65F6/\u7ED3\u679C\u8FC7\u5927**\uFF1A\u5BF9\u76EE\u6807\u8282\u70B9\u7684\u5B50\u8282\u70B9\u7528 \`get_node_dsl\` + \u8F83\u4F4E \`maxDepth\` \u5206\u6BB5\u53D6\uFF0C\u4E0D\u8981\u6574\u6811\u4E00\u6B21\u62C9\u3002
 - **\u7ED3\u679C\u7591\u4F3C\u8FC7\u671F**\uFF08\u8BBE\u8BA1\u7A3F\u521A\u6539\u8FC7\uFF09\uFF1A\u7ED9\u5BFC\u51FA\u7C7B\u5DE5\u5177\u52A0 \`cache: "refresh"\` \u5F3A\u5236\u5237\u65B0\u3002
-- **\u63D2\u4EF6\u65E0\u54CD\u5E94**\uFF08ping \u63A2\u6D4B\u8D85\u65F6\uFF09\uFF1A\u63D2\u4EF6\u672A\u8FD0\u884C\u6216\u6B63\u5728\u6267\u884C\u957F\u547D\u4EE4\u2014\u2014\u7A0D\u540E\u91CD\u8BD5\uFF1B\u6587\u4EF6\u91CD\u5F00\u573A\u666F \`target\` \u7528 fileKey \u4F1A\u81EA\u52A8\u89E3\u6790\u5230\u65B0\u5B9E\u4F8B\u3002
+- **\u63D2\u4EF6\u65E0\u54CD\u5E94**\uFF08ping \u63A2\u6D4B\u8D85\u65F6\uFF09\uFF1A\u63D2\u4EF6\u672A\u8FD0\u884C\u6216\u6B63\u5728\u6267\u884C\u957F\u547D\u4EE4\u2014\u2014\u7A0D\u540E\u91CD\u8BD5\uFF1B\u6587\u4EF6\u91CD\u5F00\u573A\u666F\u7528 fileKey \u5BFB\u5740\u4F1A\u81EA\u52A8\u89E3\u6790\u5230\u65B0\u5B9E\u4F8B\u3002
 - **\u7981\u6B62\u4EC5\u51ED\u622A\u56FE\u786C\u7F16\u7801**\uFF1A\u622A\u56FE\u662F\u6821\u9A8C\u4E0E\u610F\u56FE\u53C2\u7167\uFF0C\u4E0D\u662F\u7ED3\u6784\u6765\u6E90\u2014\u2014\u7ED3\u6784\u4E00\u5F8B\u8D70 DSL\u3002
 
 ## \u7EC4\u4EF6\u5173\u8054\uFF08comp \u5B57\u6BB5\uFF09
@@ -435,148 +523,284 @@ INSTANCE / COMPONENT / COMPONENT_SET \u8282\u70B9\u5E26 \`comp\` \u5B57\u6BB5\uF
 - DSL \u662F**\u6709\u635F\u7CBE\u7B80**\uFF1A\u7701\u7565\u4E86\u5E03\u5C14\u8FD0\u7B97\u8DEF\u5F84\u3001\u8499\u7248\u7B49\u7EAF\u8BBE\u8BA1\u7EC6\u8282\uFF0C\u89C6\u89C9\u590D\u6742\u8282\u70B9\u4EE5\u622A\u56FE\u4E3A\u51C6\u3002
 - \u5BFC\u51FA\u7C7B\u5DE5\u5177\uFF08\`get_node_dsl\`/\`get_screenshot\`/\`export_image\`\uFF09\u5E26 15 \u5206\u949F\u7ED3\u679C\u7F13\u5B58\uFF08\u63D2\u4EF6\u4FA7 TTL\uFF09\uFF1B
   \u8BBE\u8BA1\u7A3F\u521A\u6539\u8FC7\u4F46\u7ED3\u679C\u5BF9\u4E0D\u4E0A\u65F6\uFF0C\u52A0 \`cache: "refresh"\` \u5F3A\u5236\u5237\u65B0\u3002
-- \u591A\u6587\u4EF6\u573A\u666F\u6240\u6709\u5DE5\u5177\u90FD\u652F\u6301 \`target\` \u53C2\u6570\uFF08sessionId/fileKey\uFF09\uFF0C\u89C1 \`batter://guides/intro\`\u3002
+- \u591A\u6587\u4EF6\u573A\u666F\u8282\u70B9\u7C7B\u5DE5\u5177\u7528 \`fileKey\`/\`sessionId\` \u53C2\u6570\u8DEF\u7531\uFF08\u4E8C\u9009\u4E00\u5FC5\u4F20\uFF09\uFF0C\u89C1 \`batter://guides/intro\`\u3002
 `;
-var GUIDES = [
-  {
-    name: "intro",
-    uri: "batter://guides/intro",
-    description: "batter-pixso-mcp \u6982\u89C8\uFF1A\u5DE5\u5177\u6E05\u5355\u3001\u94FE\u63A5\u63D0\u53D6 item-id\u3001\u591A\u6587\u4EF6\u4F1A\u8BDD\u8DEF\u7531\u3002",
-    text: INTRO
-  },
-  {
-    name: "design-to-code",
-    uri: "batter://guides/design-to-code",
-    description: "\u8BBE\u8BA1\u8F6C\u4EE3\u7801\uFF08\u6837\u5F0F\u8FD8\u539F/\u8BBE\u8BA1\u8FD8\u539F\uFF09\u5DE5\u4F5C\u6D41\uFF1A\u786C\u6027\u89C4\u5219\uFF08\u8D44\u6E90\u6309\u672C\u673A\u8DEF\u5F84\u53D6\u7528\u3001\u94FE\u63A5\u63D0\u53D6 item-id\uFF09\u3001DSL \u5B57\u6BB5\u8BED\u4E49\u3001\u89C6\u89C9\u6821\u9A8C\u3002",
-    text: DESIGN_TO_CODE
+    GUIDES = [
+      {
+        name: "intro",
+        uri: "batter://guides/intro",
+        description: "batter-pixso-mcp \u6982\u89C8\uFF1A\u5DE5\u5177\u6E05\u5355\u3001\u94FE\u63A5\u63D0\u53D6 item-id\u3001\u591A\u6587\u4EF6\u4F1A\u8BDD\u8DEF\u7531\u3002",
+        text: INTRO
+      },
+      {
+        name: "design-to-code",
+        uri: "batter://guides/design-to-code",
+        description: "\u8BBE\u8BA1\u8F6C\u4EE3\u7801\uFF08\u6837\u5F0F\u8FD8\u539F/\u8BBE\u8BA1\u8FD8\u539F\uFF09\u5DE5\u4F5C\u6D41\uFF1A\u786C\u6027\u89C4\u5219\uFF08\u8D44\u6E90\u6309\u672C\u673A\u8DEF\u5F84\u53D6\u7528\u3001\u94FE\u63A5\u63D0\u53D6 item-id\uFF09\u3001DSL \u5B57\u6BB5\u8BED\u4E49\u3001\u89C6\u89C9\u6821\u9A8C\u3002",
+        text: DESIGN_TO_CODE
+      }
+    ];
   }
-];
+});
 
 // src/agent/prompts.ts
-var DESIGN_TO_CODE2 = {
-  name: "design-to-code",
-  description: "\u8BBE\u8BA1\u7A3F\u8F6C\u524D\u7AEF\u4EE3\u7801\uFF08\u6837\u5F0F\u8FD8\u539F/\u8BBE\u8BA1\u8FD8\u539F/UI \u8FD8\u539F\uFF09\uFF1A\u4ECE Pixso \u94FE\u63A5\u6216\u5F53\u524D\u9009\u533A\u53D6 DSL + \u622A\u56FE \u2192 \u751F\u6210 \u2192 \u622A\u56FE\u6821\u9A8C\u3002",
-  arguments: [
-    {
-      name: "url",
-      description: "Pixso \u94FE\u63A5\uFF08\u542B item-id \u67E5\u8BE2\u53C2\u6570\uFF0C\u4EFB\u610F\u57DF\u540D\uFF1A\u5B98\u65B9 pixso.cn \u6216\u79C1\u6709\u5316\u90E8\u7F72\uFF09\u3002\u7559\u7A7A\u5219\u4F7F\u7528\u753B\u5E03\u5F53\u524D\u9009\u4E2D\u56FE\u5C42\u3002",
-      required: false
-    }
-  ],
-  render: (args) => {
-    const targetLine = args.url?.trim() ? `\u76EE\u6807\u8282\u70B9\u6765\u81EA\u94FE\u63A5\uFF1A${args.url.trim()}\u3002\u5FC5\u987B\u4ECE\u67E5\u8BE2\u53C2\u6570 \`item-id\` \u63D0\u53D6\u8282\u70B9 guid \u5E76 URL \u89E3\u7801\uFF08\`1%3A2\` \u2192 \`"1:2"\`\uFF09\u540E\u4F5C\u4E3A guid \u4F20\u5165\uFF1B\u4E25\u7981\u628A\u6574\u4E2A URL \u5F53 guid \u4F20\u3002\u65E0\u8BBA\u57DF\u540D\u662F\u5426\u8BA4\u8BC6\uFF0C\u90FD\u6309\u6B64\u89C4\u5219\u5904\u7406\u3002` : `\u76EE\u6807\u8282\u70B9\u4E3A\u5F53\u524D\u9009\u533A\uFF1A\u8C03 \`get_selected\` \u62FF\u9009\u4E2D\u56FE\u5C42\u3002\u7981\u6B62\u9690\u5F0F\u4F7F\u7528\u5176 guid\u2014\u2014\u9664\u975E\u7528\u6237\u660E\u786E\u8BF4\u4E86"\u6211\u9009\u4E2D\u7684/\u5F53\u524D\u9009\u4E2D\u7684"\uFF0C\u5148\u628A\u9009\u4E2D\u56FE\u5C42\u540D\u79F0\u62A5\u7ED9\u7528\u6237\u786E\u8BA4\uFF08"\u5F53\u524D\u9009\u4E2D\u7684\u662F\u300CXX\u300D\uFF0C\u786E\u8BA4\u5904\u7406\u5B83\u5417\uFF1F"\uFF09\uFF0C\u786E\u8BA4\u540E\u518D\u7EE7\u7EED\u3002`;
-    return [
-      {
-        role: "user",
-        content: {
-          type: "text",
-          text: [
-            `\u628A Pixso \u8BBE\u8BA1\u7A3F\u8FD8\u539F\u4E3A\u524D\u7AEF\u4EE3\u7801\u3002`,
-            ``,
-            `## \u3010\u786C\u6027\u89C4\u5219 \xB7 \u8FDD\u53CD\u5373\u8FD4\u5DE5\u3011`,
-            ``,
-            `**\u5199\u4EE3\u7801\u524D\u5FC5\u987B\u5148\u8BFB**\u8D44\u6E90 \`batter://guides/design-to-code\` \u5E76\u9075\u5B88\u5176\u5168\u90E8\u786C\u6027\u89C4\u5219\uFF08\u8D44\u6E90\u53D6\u7528/\u7EC4\u4EF6\u6620\u5C04/\u9519\u8BEF\u6062\u590D/\u7981\u6B62\u622A\u56FE\u786C\u7F16\u7801\uFF09\uFF1B\u603B\u89C8\u89C1 \`batter://guides/intro\`\u3002`,
-            ``,
-            `## \u6267\u884C\u6D41\u7A0B`,
-            ``,
-            `1. \u786E\u8BA4\u76EE\u6807\u8282\u70B9\uFF1A${targetLine}`,
-            `2. \u53D6\u6570\u636E\uFF1A\u63D2\u4EF6\u7C7B\u5DE5\u5177\u8FD4\u56DE\u7EDF\u4E00\u4E3A \`{sessionId, data}\` \u4FE1\u5C01\uFF0C\u53D6 \`data\` \u5B57\u6BB5\u3002\u9996\u6B21\u63A5\u89E6\u8BBE\u8BA1\u7A3F\uFF1A\u5148 \`get_metadata(guid)\` \u62FF\u5168\u6811\u9AA8\u67B6\u5B9A\u4F4D\u76EE\u6807 + \`get_screenshot(guid)\` \u62FF\u89C6\u89C9\u5168\u8C8C\uFF1B\u968F\u540E \`get_node_dsl(guid)\` \u62FF\u5168\u91CF DSL\uFF08\u7ED3\u6784\u5F88\u5927\u65F6\u7528 \`maxDepth\` \u5206\u6BB5\u4E0B\u63A2\u2014\u2014\u622A\u65AD\u5904\u8282\u70B9\u5E26 \`more\` \u6807\u8BB0\u4E0E \`kidsSummary\` \u6D45\u9884\u89C8\uFF0C\u62FF\u5176 \`id\` \u56DE\u4F20 \`guid\` \u4E0B\u94BB\uFF09\u3002DSL \u4E2D\u5DF2\u5E26 \`img\` \u7684\u8282\u70B9\uFF08ICON/IMAGE \u53F6\u5B50\uFF09\u5DF2\u5B8C\u6210\u5BFC\u51FA\uFF0C\u76F4\u63A5\u7528\u5176\u6587\u4EF6\u540D\uFF0C\u4E0D\u8981\u518D\u8C03 \`export_image\`\u3002`,
-            `3. \u751F\u6210\u4EE3\u7801\uFF1A\u6309\u6307\u5357\u4E2D\u7684 DSL \u5B57\u6BB5\u8BED\u4E49\u6620\u5C04\u5230\u76EE\u6807\u6846\u67B6\u3002`,
-            `4. \u81EA\u68C0\uFF1A\u518D\u6B21\u8C03 \`get_screenshot(guid)\`\uFF0C\u4E0E\u4EE3\u7801\u6E32\u67D3\u7ED3\u679C\u5BF9\u6BD4\uFF0C\u6709\u504F\u5DEE\u5C31\u4FEE\u6B63\u540E\u518D\u6BD4\u4E00\u8F6E\uFF08\u5BFC\u51FA\u7C7B\u5DE5\u5177\u5E26 15 \u5206\u949F\u7F13\u5B58\uFF1B\u7ED3\u679C\u7591\u4F3C\u8FC7\u671F\u65F6\u52A0 \`cache: "refresh"\` \u5F3A\u5236\u5237\u65B0\uFF09\u3002`,
-            ``,
-            `**\u6700\u540E\u91CD\u7533**\uFF1A\u4EA4\u4ED8\u4EE3\u7801\u4E2D\u4E0D\u5141\u8BB8\u51FA\u73B0\u4EA7\u7269\u76EE\u5F55\u7684\u7EDD\u5BF9\u8DEF\u5F84\uFF0C\u5168\u90E8\u56FE\u7247\u5FC5\u987B\u662F\u5DF2\u590D\u5236\u5230\u9879\u76EE\u7684\u672C\u5730\u76F8\u5BF9\u8DEF\u5F84\uFF08\u7EC6\u5219\u89C1\u6307\u5357\u786C\u6027\u89C4\u5219\u7B2C 1 \u6761\uFF09\u3002`
-          ].join("\n")
+var DESIGN_TO_CODE2, PROMPTS;
+var init_prompts = __esm({
+  "src/agent/prompts.ts"() {
+    "use strict";
+    DESIGN_TO_CODE2 = {
+      name: "design-to-code",
+      description: "\u8BBE\u8BA1\u7A3F\u8F6C\u524D\u7AEF\u4EE3\u7801\uFF08\u6837\u5F0F\u8FD8\u539F/\u8BBE\u8BA1\u8FD8\u539F/UI \u8FD8\u539F\uFF09\uFF1A\u4ECE Pixso \u94FE\u63A5\u6216\u5F53\u524D\u9009\u533A\u53D6 DSL + \u622A\u56FE \u2192 \u751F\u6210 \u2192 \u622A\u56FE\u6821\u9A8C\u3002",
+      arguments: [
+        {
+          name: "url",
+          description: "Pixso \u94FE\u63A5\uFF08\u542B item-id \u67E5\u8BE2\u53C2\u6570\uFF0C\u4EFB\u610F\u57DF\u540D\uFF1A\u5B98\u65B9 pixso.cn \u6216\u79C1\u6709\u5316\u90E8\u7F72\uFF09\u3002\u7559\u7A7A\u5219\u4F7F\u7528\u753B\u5E03\u5F53\u524D\u9009\u4E2D\u56FE\u5C42\u3002",
+          required: false
         }
+      ],
+      render: (args) => {
+        const targetLine = args.url?.trim() ? `\u76EE\u6807\u8282\u70B9\u6765\u81EA\u94FE\u63A5\uFF1A${args.url.trim()}\u3002\u5FC5\u987B\u4ECE\u67E5\u8BE2\u53C2\u6570 \`item-id\` \u63D0\u53D6\u8282\u70B9 guid \u5E76 URL \u89E3\u7801\uFF08\`1%3A2\` \u2192 \`"1:2"\`\uFF09\u540E\u4F5C\u4E3A guid \u4F20\u5165\uFF1B\u4E25\u7981\u628A\u6574\u4E2A URL \u5F53 guid \u4F20\u3002\u65E0\u8BBA\u57DF\u540D\u662F\u5426\u8BA4\u8BC6\uFF0C\u90FD\u6309\u6B64\u89C4\u5219\u5904\u7406\u3002` : `\u76EE\u6807\u8282\u70B9\u4E3A\u5F53\u524D\u9009\u533A\uFF1A\u8C03 \`get_selected\` \u62FF\u9009\u4E2D\u56FE\u5C42\u3002\u7981\u6B62\u9690\u5F0F\u4F7F\u7528\u5176 guid\u2014\u2014\u9664\u975E\u7528\u6237\u660E\u786E\u8BF4\u4E86"\u6211\u9009\u4E2D\u7684/\u5F53\u524D\u9009\u4E2D\u7684"\uFF0C\u5148\u628A\u9009\u4E2D\u56FE\u5C42\u540D\u79F0\u62A5\u7ED9\u7528\u6237\u786E\u8BA4\uFF08"\u5F53\u524D\u9009\u4E2D\u7684\u662F\u300CXX\u300D\uFF0C\u786E\u8BA4\u5904\u7406\u5B83\u5417\uFF1F"\uFF09\uFF0C\u786E\u8BA4\u540E\u518D\u7EE7\u7EED\u3002`;
+        return [
+          {
+            role: "user",
+            content: {
+              type: "text",
+              text: [
+                `\u628A Pixso \u8BBE\u8BA1\u7A3F\u8FD8\u539F\u4E3A\u524D\u7AEF\u4EE3\u7801\u3002`,
+                ``,
+                `## \u3010\u786C\u6027\u89C4\u5219 \xB7 \u8FDD\u53CD\u5373\u8FD4\u5DE5\u3011`,
+                ``,
+                `**\u5199\u4EE3\u7801\u524D\u5FC5\u987B\u5148\u8BFB**\u8D44\u6E90 \`batter://guides/design-to-code\` \u5E76\u9075\u5B88\u5176\u5168\u90E8\u786C\u6027\u89C4\u5219\uFF08\u8D44\u6E90\u53D6\u7528/\u7EC4\u4EF6\u6620\u5C04/\u9519\u8BEF\u6062\u590D/\u7981\u6B62\u622A\u56FE\u786C\u7F16\u7801\uFF09\uFF1B\u603B\u89C8\u89C1 \`batter://guides/intro\`\u3002`,
+                ``,
+                `## \u6267\u884C\u6D41\u7A0B`,
+                ``,
+                `1. \u786E\u8BA4\u76EE\u6807\u8282\u70B9\uFF1A${targetLine}`,
+                `2. \u53D6\u6570\u636E\uFF1A\u63D2\u4EF6\u7C7B\u5DE5\u5177\u8FD4\u56DE\u7EDF\u4E00\u4E3A \`{sessionId, fileKey, data}\` \u4FE1\u5C01\uFF0C\u53D6 \`data\` \u5B57\u6BB5\u3002\u8282\u70B9\u7C7B\u5DE5\u5177\u7684 guid \u5FC5\u4F20\uFF0CfileKey/sessionId \u5FC5\u4F20\u5176\u4E00\uFF08\u4F18\u5148 fileKey\uFF1B\u9009\u533A\u573A\u666F\u7528 \`get_selected\` \u8FD4\u56DE\u7684 fileKey\uFF09\u3002\u9996\u6B21\u63A5\u89E6\u8BBE\u8BA1\u7A3F\uFF1A\u5148 \`get_metadata(guid, fileKey)\` \u62FF\u5168\u6811\u9AA8\u67B6\u5B9A\u4F4D\u76EE\u6807 + \`get_screenshot(guid, fileKey)\` \u62FF\u89C6\u89C9\u5168\u8C8C\uFF1B\u968F\u540E \`get_node_dsl(guid, fileKey)\` \u62FF\u5168\u91CF DSL\uFF08\u7ED3\u6784\u5F88\u5927\u65F6\u7528 \`maxDepth\` \u5206\u6BB5\u4E0B\u63A2\u2014\u2014\u622A\u65AD\u5904\u8282\u70B9\u5E26 \`more\` \u6807\u8BB0\u4E0E \`kidsSummary\` \u6D45\u9884\u89C8\uFF0C\u62FF\u5176 \`id\` \u56DE\u4F20 \`guid\` \u4E0B\u94BB\uFF09\u3002DSL \u4E2D\u5DF2\u5E26 \`img\` \u7684\u8282\u70B9\uFF08ICON/IMAGE \u53F6\u5B50\uFF09\u5DF2\u5B8C\u6210\u5BFC\u51FA\uFF0C\u76F4\u63A5\u7528\u5176\u6587\u4EF6\u540D\uFF0C\u4E0D\u8981\u518D\u8C03 \`export_image\`\u3002`,
+                `3. \u751F\u6210\u4EE3\u7801\uFF1A\u6309\u6307\u5357\u4E2D\u7684 DSL \u5B57\u6BB5\u8BED\u4E49\u6620\u5C04\u5230\u76EE\u6807\u6846\u67B6\u3002`,
+                `4. \u81EA\u68C0\uFF1A\u518D\u6B21\u8C03 \`get_screenshot(guid)\`\uFF0C\u4E0E\u4EE3\u7801\u6E32\u67D3\u7ED3\u679C\u5BF9\u6BD4\uFF0C\u6709\u504F\u5DEE\u5C31\u4FEE\u6B63\u540E\u518D\u6BD4\u4E00\u8F6E\uFF08\u5BFC\u51FA\u7C7B\u5DE5\u5177\u5E26 15 \u5206\u949F\u7F13\u5B58\uFF1B\u7ED3\u679C\u7591\u4F3C\u8FC7\u671F\u65F6\u52A0 \`cache: "refresh"\` \u5F3A\u5236\u5237\u65B0\uFF09\u3002`,
+                ``,
+                `**\u6700\u540E\u91CD\u7533**\uFF1A\u4EA4\u4ED8\u4EE3\u7801\u4E2D\u4E0D\u5141\u8BB8\u51FA\u73B0\u4EA7\u7269\u76EE\u5F55\u7684\u7EDD\u5BF9\u8DEF\u5F84\uFF0C\u5168\u90E8\u56FE\u7247\u5FC5\u987B\u662F\u5DF2\u590D\u5236\u5230\u9879\u76EE\u7684\u672C\u5730\u76F8\u5BF9\u8DEF\u5F84\uFF08\u7EC6\u5219\u89C1\u6307\u5357\u786C\u6027\u89C4\u5219\u7B2C 1 \u6761\uFF09\u3002`
+              ].join("\n")
+            }
+          }
+        ];
       }
-    ];
+    };
+    PROMPTS = [DESIGN_TO_CODE2];
   }
-};
-var PROMPTS = [DESIGN_TO_CODE2];
+});
 
 // src/plugin/command-bus.ts
-var CommandBus = class {
-  sseListeners = /* @__PURE__ */ new Map();
-  pendingById = /* @__PURE__ */ new Map();
-  seq = 0;
-  /** AI 侧：执行命令 */
-  execute(type, args, opts) {
-    const timeoutMs = opts.timeoutMs ?? 6e4;
-    const { promise, resolve, reject } = withResolvers();
-    const command = { id: `cmd-${++this.seq}`, type, args };
-    const entry = {
-      command,
-      sessionId: opts.sessionId,
-      resolve,
-      reject,
-      dispatched: false,
-      timer: setTimeout(() => {
+var CommandBus, commandBus;
+var init_command_bus = __esm({
+  "src/plugin/command-bus.ts"() {
+    "use strict";
+    init_config();
+    CommandBus = class {
+      sseListeners = /* @__PURE__ */ new Map();
+      pendingById = /* @__PURE__ */ new Map();
+      seq = 0;
+      /** AI 侧：执行命令 */
+      execute(type, args, opts) {
+        const timeoutMs = opts.timeoutMs ?? COMMAND_TIMEOUT_MS;
+        const { promise, resolve, reject } = Promise.withResolvers();
+        const command = { id: `cmd-${++this.seq}`, type, args };
+        const entry = {
+          command,
+          sessionId: opts.sessionId,
+          resolve,
+          reject,
+          dispatched: false,
+          timer: setTimeout(() => {
+            this.drop(entry);
+            reject(new Error(`\u547D\u4EE4 ${command.id} \u8D85\u65F6\uFF1A\u63D2\u4EF6 ${timeoutMs / 1e3}s \u5185\u672A\u8FD4\u56DE\u7ED3\u679C`));
+          }, timeoutMs)
+        };
+        opts.signal?.addEventListener("abort", () => {
+          if (!this.pendingById.has(command.id)) return;
+          this.drop(entry);
+          reject(new Error(`\u547D\u4EE4 ${command.id} \u5DF2\u88AB\u8C03\u7528\u65B9\u53D6\u6D88`));
+        });
+        this.pendingById.set(command.id, entry);
+        this.dispatch(opts.sessionId);
+        return promise;
+      }
+      /** 插件侧：订阅即时推送（SSE 通道），返回退订函数；补发订阅前已入队的命令 */
+      subscribe(sessionId, listener) {
+        let subs = this.sseListeners.get(sessionId);
+        if (!subs) {
+          subs = /* @__PURE__ */ new Set();
+          this.sseListeners.set(sessionId, subs);
+        }
+        subs.add(listener);
+        this.dispatch(sessionId);
+        return () => {
+          subs.delete(listener);
+          if (subs.size === 0) this.sseListeners.delete(sessionId);
+        };
+      }
+      /** 插件侧：回传结果 */
+      complete(id, ok, resultOrError) {
+        const entry = this.pendingById.get(id);
+        if (!entry) return false;
         this.drop(entry);
-        reject(new Error(`\u547D\u4EE4 ${command.id} \u8D85\u65F6\uFF1A\u63D2\u4EF6 ${timeoutMs / 1e3}s \u5185\u672A\u8FD4\u56DE\u7ED3\u679C`));
-      }, timeoutMs)
-    };
-    opts.signal?.addEventListener("abort", () => {
-      if (!this.pendingById.has(command.id)) return;
-      this.drop(entry);
-      reject(new Error(`\u547D\u4EE4 ${command.id} \u5DF2\u88AB\u8C03\u7528\u65B9\u53D6\u6D88`));
-    });
-    this.pendingById.set(command.id, entry);
-    this.dispatch(opts.sessionId);
-    return promise;
-  }
-  /** 插件侧：订阅即时推送（SSE 通道），返回退订函数；补发订阅前已入队的命令 */
-  subscribe(sessionId, listener) {
-    let subs = this.sseListeners.get(sessionId);
-    if (!subs) {
-      subs = /* @__PURE__ */ new Set();
-      this.sseListeners.set(sessionId, subs);
-    }
-    subs.add(listener);
-    this.dispatch(sessionId);
-    return () => {
-      subs.delete(listener);
-      if (subs.size === 0) this.sseListeners.delete(sessionId);
+        if (ok) {
+          entry.resolve(resultOrError);
+        } else {
+          entry.reject(resultOrError instanceof Error ? resultOrError : new Error(String(resultOrError)));
+        }
+        return true;
+      }
+      /** 排空该会话全部未派发命令（无订阅者则留待 subscribe 补发） */
+      dispatch(sessionId) {
+        const subs = this.sseListeners.get(sessionId);
+        if (!subs || subs.size === 0) return;
+        for (const entry of this.pendingById.values()) {
+          if (entry.sessionId !== sessionId || entry.dispatched) continue;
+          entry.dispatched = true;
+          log(`dispatch command ${entry.command.id}: ${entry.command.type} -> session ${sessionId.slice(0, 8)}`);
+          for (const fn of subs) fn(entry.command);
+        }
+      }
+      /** 从 pending 表移除（完成/超时/取消共用） */
+      drop(entry) {
+        clearTimeout(entry.timer);
+        this.pendingById.delete(entry.command.id);
+      }
     };
+    commandBus = new CommandBus();
   }
-  /** 插件侧：回传结果 */
-  complete(id, ok, resultOrError) {
-    const entry = this.pendingById.get(id);
-    if (!entry) return false;
-    this.drop(entry);
-    if (ok) {
-      entry.resolve(resultOrError);
-    } else {
-      entry.reject(resultOrError instanceof Error ? resultOrError : new Error(String(resultOrError)));
-    }
-    return true;
-  }
-  /** 排空该会话全部未派发命令（无订阅者则留待 subscribe 补发） */
-  dispatch(sessionId) {
-    const subs = this.sseListeners.get(sessionId);
-    if (!subs || subs.size === 0) return;
-    for (const entry of this.pendingById.values()) {
-      if (entry.sessionId !== sessionId || entry.dispatched) continue;
-      entry.dispatched = true;
-      log(`dispatch command ${entry.command.id}: ${entry.command.type} -> session ${sessionId.slice(0, 8)}`);
-      for (const fn of subs) fn(entry.command);
-    }
+});
+
+// src/plugin/sessions.ts
+import { randomUUID } from "node:crypto";
+function unknownRouteError(route) {
+  if (route.fileKey) {
+    return new Error(`\u627E\u4E0D\u5230 fileKey \u4E3A ${route.fileKey} \u7684\u5B58\u6D3B\u63D2\u4EF6\u4F1A\u8BDD\u3002\u53EF\u7528 list_sessions \u67E5\u770B\u5F53\u524D\u8FDE\u63A5\u7684\u4F1A\u8BDD`);
   }
-  /** 从 pending 表移除（完成/超时/取消共用） */
-  drop(entry) {
-    clearTimeout(entry.timer);
-    this.pendingById.delete(entry.command.id);
+  return new Error(`\u627E\u4E0D\u5230 sessionId \u4E3A ${route.sessionId} \u7684\u5B58\u6D3B\u63D2\u4EF6\u4F1A\u8BDD\uFF08\u53EF\u80FD\u5DF2\u88AB\u5254\u9664\uFF09\u3002\u53EF\u7528 list_sessions \u67E5\u770B\u5F53\u524D\u8FDE\u63A5\u7684\u4F1A\u8BDD`);
+}
+var SessionRegistry, sessions;
+var init_sessions = __esm({
+  "src/plugin/sessions.ts"() {
+    "use strict";
+    init_config();
+    SessionRegistry = class {
+      sessions = /* @__PURE__ */ new Map();
+      lastActiveId = null;
+      /** 会话亲和：fileKey → 上一次路由使用的 sessionId（仍在线时优先，避免同文件多实例间漂移） */
+      lastUsedByFileKey = /* @__PURE__ */ new Map();
+      isOnline(s) {
+        return s.connected || Date.now() - s.lastSeen < SESSION_ONLINE_WINDOW_MS;
+      }
+      /** fileKey 寻址候选：该文件的在线会话（谁先 pong 由 ping 竞速决定，此处不排序） */
+      candidatesForFileKey(fileKey) {
+        return [...this.sessions.values()].filter((s) => s.meta.fileKey === fileKey && this.isOnline(s));
+      }
+      /** 亲和查询：上一次为该 fileKey 服务的 sessionId */
+      affinityIdOf(fileKey) {
+        return this.lastUsedByFileKey.get(fileKey);
+      }
+      /** 亲和钉住：fileKey 寻址探活成功后记录（下次优先） */
+      pinAffinity(fileKey, sessionId) {
+        this.lastUsedByFileKey.set(fileKey, sessionId);
+      }
+      /** 剔除会话（幽灵剔除/ping 判死共用）：清理亲和引用；存活但繁忙被误剔的插件会在 SSE 断开或上报 404 后自重注册；
+       *  失效 sessionId 的 failover 不靠墓碑——工具结果信封带 fileKey，agent 手里的稳定句柄一直是 fileKey */
+      evict(id) {
+        if (this.sessions.delete(id)) {
+          for (const [k, v] of this.lastUsedByFileKey) {
+            if (v === id) this.lastUsedByFileKey.delete(k);
+          }
+          log(`session evicted: ${id.slice(0, 8)}`);
+        }
+      }
+      register(meta = {}) {
+        if (meta.fileKey) {
+          for (const s of [...this.sessions.values()]) {
+            if (s.meta.fileKey === meta.fileKey && !this.isOnline(s)) {
+              this.evict(s.id);
+            }
+          }
+        }
+        const session = { id: randomUUID(), meta, lastSeen: Date.now(), connected: false };
+        this.sessions.set(session.id, session);
+        this.lastActiveId = session.id;
+        log(`session registered: ${session.id} (${meta.fileName ?? "unknown file"})`);
+        return this.toInfo(session);
+      }
+      /** 心跳/连接状态用：只刷 lastSeen，不影响 lastActiveId（"最近活跃"= 用户行为，心跳不算） */
+      touchSeen(id) {
+        const s = this.sessions.get(id);
+        if (!s) return null;
+        s.lastSeen = Date.now();
+        return s;
+      }
+      /** 用户行为（选区上报/命令服务/注册）：刷 lastSeen 并标记最近活跃 */
+      touch(id) {
+        const s = this.touchSeen(id);
+        if (!s) return null;
+        this.lastActiveId = id;
+        return s;
+      }
+      setConnected(id, connected) {
+        const s = this.touchSeen(id);
+        if (!s) return false;
+        s.connected = connected;
+        return true;
+      }
+      updateContext(id, meta) {
+        const s = this.touch(id);
+        if (!s) return false;
+        s.meta = { ...s.meta, ...meta };
+        log(
+          `context updated [${id.slice(0, 8)}]: ${s.meta.fileName ?? "?"} / ${s.meta.pageName ?? "?"} / ${s.meta.selection?.length ?? 0} selected`
+        );
+        return true;
+      }
+      list() {
+        return [...this.sessions.values()].map((s) => this.toInfo(s));
+      }
+      /** 纯查找（不判活）：工具层寻址用——离线会话也可取到 fileKey 用于候选扩展与故障转移 */
+      get(id) {
+        return this.sessions.get(id);
+      }
+      /** 缺省路由：最近活跃在线会话 > 任意在线会话（显式 fileKey/sessionId 由工具层 get/candidatesForFileKey + ping 完成） */
+      resolve() {
+        if (this.lastActiveId) {
+          const s = this.sessions.get(this.lastActiveId);
+          if (s && this.isOnline(s)) return s;
+        }
+        const fallback = [...this.sessions.values()].find((s) => this.isOnline(s));
+        if (fallback) return fallback;
+        throw new Error("Pixso \u63D2\u4EF6\u672A\u8FDE\u63A5\uFF1A\u8BF7\u5728 Pixso \u5BA2\u6237\u7AEF\u4E2D\u8FD0\u884C Batter Pixso Bridge \u63D2\u4EF6");
+      }
+      toInfo(s) {
+        return {
+          sessionId: s.id,
+          fileKey: s.meta.fileKey,
+          fileName: s.meta.fileName,
+          pageName: s.meta.pageName,
+          selectionCount: s.meta.selection?.length,
+          online: this.isOnline(s),
+          lastSeen: s.lastSeen
+        };
+      }
+    };
+    sessions = new SessionRegistry();
   }
-};
-var commandBus = new CommandBus();
+});
 
 // src/agent/tools/shared.ts
-var PING_TIMEOUT_MS = 800;
 async function run(type, args, signal) {
-  const { target, ...rest } = args;
+  const { fileKey, sessionId, ...rest } = args;
   try {
-    const session = await resolveAndPing(target, signal);
+    const session = await resolveAndPing(
+      { fileKey, sessionId },
+      signal
+    );
     const data = await commandBus.execute(type, rest, { sessionId: session.id, signal });
     sessions.touch(session.id);
-    return jsonResult({ sessionId: session.id, data });
+    return jsonResult({ sessionId: session.id, fileKey: session.meta.fileKey, data });
   } catch (err) {
     return errorResult(err);
   }
@@ -605,39 +829,25 @@ async function pingCandidates(candidates, affinityId, signal) {
     return null;
   }
 }
-async function resolveAndPing(target, signal) {
-  const s = target ? sessions.get(target) : sessions.resolve();
-  const fileKey = s ? s.meta.fileKey : target;
+async function resolveAndPing(route, signal) {
+  const s = route.sessionId ? sessions.get(route.sessionId) : route.fileKey ? void 0 : sessions.resolve();
+  if (route.sessionId && !s) throw unknownRouteError(route);
+  const fileKey = s ? s.meta.fileKey : route.fileKey;
   const candidates = s && !fileKey ? [s] : sessions.candidatesForFileKey(fileKey);
   if (candidates.length === 0) {
     if (s) throw new Error(`\u76EE\u6807\u63D2\u4EF6\u5DF2\u79BB\u7EBF\uFF1A${s.meta.fileName ?? s.id}\uFF08\u91CD\u65B0\u6253\u5F00\u6587\u4EF6\u5E76\u8FD0\u884C\u63D2\u4EF6\u540E\u91CD\u8BD5\uFF09`);
-    throw unknownTargetError(target);
+    throw unknownRouteError(route);
   }
   const winner = await pingCandidates(candidates, fileKey ? sessions.affinityIdOf(fileKey) : void 0, signal);
   if (!winner) {
     for (const c of candidates) sessions.evict(c.id);
     throw new Error(
-      `\u63D2\u4EF6\u65E0\u54CD\u5E94\uFF08${PING_TIMEOUT_MS}ms \u672A\u56DE pong\uFF09\uFF1A${fileKey ?? target}\u2014\u2014\u63D2\u4EF6\u672A\u8FD0\u884C\uFF0C\u6216\u6B63\u5728\u6267\u884C\u957F\u547D\u4EE4\uFF08\u7A0D\u540E\u91CD\u8BD5\uFF09`
+      `\u63D2\u4EF6\u65E0\u54CD\u5E94\uFF08${PING_TIMEOUT_MS}ms \u672A\u56DE pong\uFF09\uFF1A${fileKey ?? route.sessionId}\u2014\u2014\u63D2\u4EF6\u672A\u8FD0\u884C\uFF0C\u6216\u6B63\u5728\u6267\u884C\u957F\u547D\u4EE4\uFF08\u7A0D\u540E\u91CD\u8BD5\uFF09`
     );
   }
   if (fileKey) sessions.pinAffinity(fileKey, winner.id);
   return winner;
 }
-var ENVELOPE_NOTE = "\u8FD4\u56DE\u5C01\u88C5\u4E3A {sessionId, data}\uFF08\u9519\u8BEF\u4E3A isError \u6587\u672C\uFF0C\u4E0D\u542B\u4FE1\u5C01\uFF09\uFF1AsessionId \u662F ping/pong \u786E\u8BA4\u7684\u5B9E\u9645\u670D\u52A1\u4F1A\u8BDD\uFF1Btarget \u7528 fileKey \u6700\u7A33\u2014\u2014\u6587\u4EF6\u91CD\u5F00\u540E\u81EA\u52A8\u89E3\u6790\u5230\u5B58\u6D3B\u5B9E\u4F8B\uFF08\u591A\u5B9E\u4F8B\u4F18\u5148\u4E0A\u4E00\u6B21\u4F7F\u7528\u7684\uFF09\u3002";
-var GUIDES_PTR = "\u5B8C\u6574\u89C4\u5219\uFF08\u8D44\u6E90\u53D6\u7528/\u7EC4\u4EF6\u6620\u5C04/\u9519\u8BEF\u6062\u590D/\u7981\u6B62\u622A\u56FE\u786C\u7F16\u7801\uFF09\u89C1\u8D44\u6E90 batter://guides/design-to-code\u3002";
-var TARGET_PROP = {
-  type: "string",
-  description: "\u76EE\u6807\u63D2\u4EF6\u4F1A\u8BDD\uFF08sessionId \u6216 fileKey\uFF09\u3002\u591A\u4E2A Pixso \u6587\u4EF6\u540C\u65F6\u5F00\u63D2\u4EF6\u65F6\u624D\u9700\u8981\uFF1B\u7F3A\u7701\u8DEF\u7531\u5230\u6700\u8FD1\u6D3B\u8DC3\u6587\u4EF6\u3002\u53EF\u7528 list_sessions \u67E5\u770B\u5F53\u524D\u4F1A\u8BDD\u3002"
-};
-var CACHE_PROP = {
-  type: "string",
-  enum: ["first", "refresh"],
-  description: "\u7F13\u5B58\u7B56\u7565\uFF1Afirst=\u7F13\u5B58\u4F18\u5148\uFF08\u9ED8\u8BA4\uFF0C15 \u5206\u949F\u5185\u76F8\u540C\u8C03\u7528\u76F4\u63A5\u8FD4\u56DE\uFF09\uFF1Brefresh=\u5F3A\u5236\u91CD\u65B0\u6784\u5EFA/\u5BFC\u51FA\uFF08\u4ECD\u5199\u5165\u7F13\u5B58\uFF09\u3002\u8BBE\u8BA1\u7A3F\u521A\u6539\u8FC7\u4E14\u7ED3\u679C\u5BF9\u4E0D\u4E0A\u65F6\u7528 refresh\u3002"
-};
-var GUID_PROP = {
-  type: "string",
-  description: '\u8282\u70B9 GUID\uFF08\u5982 "297:133032"\uFF09\u3002\u94FE\u63A5\u8F93\u5165\uFF1A\u4ECE item-id \u63D0\u53D6\u5E76 URL \u89E3\u7801\u540E\u4F20\u5165\uFF1B\u7F3A\u7701\u56DE\u9000\u5F53\u524D\u9009\u4E2D\u56FE\u5C42\uFF08\u7981\u6B62\u9690\u5F0F\u4F7F\u7528\u2014\u2014\u9009\u4E2D\u786E\u8BA4\u89C4\u5219\u89C1 get_selected\uFF09\u3002'
-};
 function jsonResult(data) {
   return { content: [{ type: "text", text: JSON.stringify(data) }] };
 }
@@ -647,151 +857,277 @@ function errorResult(err) {
     isError: true
   };
 }
+var ENVELOPE_NOTE, GUIDES_PTR, FILE_KEY_PROP, SESSION_ID_PROP, CACHE_PROP, GUID_PROP;
+var init_shared = __esm({
+  "src/agent/tools/shared.ts"() {
+    "use strict";
+    init_command_bus();
+    init_sessions();
+    init_config();
+    ENVELOPE_NOTE = "\u8FD4\u56DE\u5C01\u88C5\u4E3A {sessionId, fileKey, data}\uFF08\u9519\u8BEF\u4E3A isError \u6587\u672C\uFF0C\u4E0D\u542B\u4FE1\u5C01\uFF09\uFF1AsessionId \u662F ping/pong \u786E\u8BA4\u7684\u5B9E\u9645\u670D\u52A1\u4F1A\u8BDD\uFF0CfileKey \u662F\u8DE8\u91CD\u5F00\u7A33\u5B9A\u7684\u53E5\u67C4\u2014\u2014\u540E\u7EED\u8C03\u7528\u7528 fileKey \u5BFB\u5740\u3002";
+    GUIDES_PTR = "\u5B8C\u6574\u89C4\u5219\uFF08\u8D44\u6E90\u53D6\u7528/\u7EC4\u4EF6\u6620\u5C04/\u9519\u8BEF\u6062\u590D/\u7981\u6B62\u622A\u56FE\u786C\u7F16\u7801\uFF09\u89C1\u8D44\u6E90 batter://guides/design-to-code\u3002";
+    FILE_KEY_PROP = {
+      type: "string",
+      minLength: 1,
+      description: "\u76EE\u6807\u8BBE\u8BA1\u6587\u4EF6\u7684 fileKey\uFF08\u8DE8\u91CD\u5F00\u7A33\u5B9A\uFF0C\u4F18\u5148\uFF09\u3002\u4E0E sessionId \u4E8C\u9009\u4E00\uFF1B\u7528 list_sessions \u67E5\u770B\u5F53\u524D\u4F1A\u8BDD\u3002"
+    };
+    SESSION_ID_PROP = {
+      type: "string",
+      minLength: 1,
+      description: "\u76EE\u6807\u63D2\u4EF6\u4F1A\u8BDD\u7684 sessionId\uFF08ping/pong \u786E\u8BA4\u7684\u5B58\u6D3B\u5B9E\u4F8B\uFF09\u3002\u4E0E fileKey \u4E8C\u9009\u4E00\u3002"
+    };
+    CACHE_PROP = {
+      type: "string",
+      enum: ["first", "refresh"],
+      description: "\u7F13\u5B58\u7B56\u7565\uFF1Afirst=\u7F13\u5B58\u4F18\u5148\uFF08\u9ED8\u8BA4\uFF0C15 \u5206\u949F\u5185\u76F8\u540C\u8C03\u7528\u76F4\u63A5\u8FD4\u56DE\uFF09\uFF1Brefresh=\u5F3A\u5236\u91CD\u65B0\u6784\u5EFA/\u5BFC\u51FA\uFF08\u4ECD\u5199\u5165\u7F13\u5B58\uFF09\u3002\u8BBE\u8BA1\u7A3F\u521A\u6539\u8FC7\u4E14\u7ED3\u679C\u5BF9\u4E0D\u4E0A\u65F6\u7528 refresh\u3002"
+    };
+    GUID_PROP = {
+      type: "string",
+      minLength: 1,
+      description: '\u8282\u70B9 GUID\uFF08\u5982 "297:133032"\uFF09\uFF0C\u5FC5\u4F20\u3002\u94FE\u63A5\u8F93\u5165\uFF1A\u4ECE item-id \u63D0\u53D6\u5E76 URL \u89E3\u7801\u540E\u4F20\u5165\uFF1B\u8981\u64CD\u4F5C\u5F53\u524D\u9009\u4E2D\u56FE\u5C42\u65F6\uFF0C\u5148\u7528 get_selected \u53D6\u5176 guid \u518D\u4F20\u5165\u3002'
+    };
+  }
+});
 
 // src/agent/tools/export_image.ts
-var exportImage = {
-  description: '\u3010\u7528\u9014\u3011\u5BFC\u51FA\u8282\u70B9\u7684\u56FE\u7247\u7D20\u6750\uFF08\u5207\u56FE\uFF09\uFF0C\u4F9B\u4EA4\u4ED8\u4EE3\u7801\u4F7F\u7528\u3002\u5355\u8282\u70B9\u4F20 guid\uFF1B\u591A\u8282\u70B9\u4F20 guids \u6570\u7EC4\u6279\u91CF\u3002DSL \u4E2D\u5DF2\u5E26 img \u7684\u8282\u70B9\uFF08ICON/IMAGE \u53F6\u5B50\uFF09\u5728\u53D6 DSL \u65F6\u5DF2\u5BFC\u51FA\uFF0C\u76F4\u63A5\u7528\u5176\u6587\u4EF6\u540D\uFF0C\u4E25\u7981\u5BF9\u672C\u7C7B\u8282\u70B9\u91CD\u590D\u8C03\u7528\u3002\u3010\u547D\u4E2D\u4FE1\u53F7\u3011"\u5207\u56FE/\u5BFC\u51FA\u56FE\u6807/\u5BFC\u51FA\u56FE\u7247\u7D20\u6750/\u628A\u67D0\u4E2A\u8282\u70B9\u5B58\u6210\u56FE\u7247"\u3002\u8981\u89C6\u89C9\u53C2\u7167\u7528 get_screenshot\u3002\u3010\u8FD4\u56DE\u3011\u5355\u8282\u70B9 {width, height, exports: [{img, format, scale?, suffix?}]}\uFF1B\u6279\u91CF {items: [{guid, width, height, exports}]}\u3002\u8282\u70B9\u5E26\u8BBE\u8BA1\u5E08\u5BFC\u51FA\u8BBE\u7F6E\u65F6\u6309\u5176\u8BBE\u7F6E\u9010\u4EFD\u5BFC\u51FA\uFF08format/scale \u53C2\u6570\u5931\u6548\uFF09\uFF1B\u65E0\u6807\u8BB0\u6309\u53C2\u6570\u5BFC\u51FA\u5355\u4EFD\uFF08\u9ED8\u8BA4 PNG\u30012x\uFF09\u3002suffix\uFF08\u5982 "@2x"\uFF09\u590D\u5236\u8FDB\u9879\u76EE\u65F6\u4FDD\u7559\u547D\u540D\u3002\u3010\u786C\u6027\u89C4\u5219\u3011' + GUIDES_PTR + " " + ENVELOPE_NOTE,
-  inputSchema: {
-    type: "object",
-    properties: {
-      guid: GUID_PROP,
-      guids: {
-        type: "array",
-        items: { type: "string" },
-        description: "\u6279\u91CF\u5BFC\u51FA\uFF1A\u8282\u70B9 GUID \u6570\u7EC4\uFF08\u4E0E guid \u4E8C\u9009\u4E00\uFF09\u3002\u591A\u8282\u70B9\u573A\u666F\u4F18\u5148\u7528\u6279\u91CF\uFF0C\u907F\u514D\u9010\u4E2A\u8C03\u7528\u3002"
-      },
-      format: {
-        type: "string",
-        enum: ["PNG", "SVG", "JPG"],
-        description: "\u65E0\u5BFC\u51FA\u6807\u8BB0\u65F6\u7684\u515C\u5E95\u683C\u5F0F\uFF0C\u9ED8\u8BA4 PNG\u3002\u8282\u70B9\u5E26\u5BFC\u51FA\u6807\u8BB0\u65F6\u6B64\u53C2\u6570\u65E0\u6548\u3002"
-      },
-      scale: {
-        type: "number",
-        description: "\u65E0\u5BFC\u51FA\u6807\u8BB0\u65F6\u7684\u515C\u5E95\u500D\u7387\uFF0C\u9ED8\u8BA4 2\u3002\u8282\u70B9\u5E26\u5BFC\u51FA\u6807\u8BB0\u65F6\u6B64\u53C2\u6570\u65E0\u6548\u3002"
-      },
-      cache: CACHE_PROP,
-      target: TARGET_PROP
-    }
+var exportImage;
+var init_export_image = __esm({
+  "src/agent/tools/export_image.ts"() {
+    "use strict";
+    init_shared();
+    exportImage = {
+      description: '\u3010\u7528\u9014\u3011\u5BFC\u51FA\u8282\u70B9\u7684\u56FE\u7247\u7D20\u6750\uFF08\u5207\u56FE\uFF09\uFF0C\u4F9B\u4EA4\u4ED8\u4EE3\u7801\u4F7F\u7528\u3002\u5355\u8282\u70B9\u4F20 guid\uFF1B\u591A\u8282\u70B9\u4F20 guids \u6570\u7EC4\u6279\u91CF\u3002DSL \u4E2D\u5DF2\u5E26 img \u7684\u8282\u70B9\uFF08ICON/IMAGE \u53F6\u5B50\uFF09\u5728\u53D6 DSL \u65F6\u5DF2\u5BFC\u51FA\uFF0C\u76F4\u63A5\u7528\u5176\u6587\u4EF6\u540D\uFF0C\u4E25\u7981\u5BF9\u672C\u7C7B\u8282\u70B9\u91CD\u590D\u8C03\u7528\u3002\u3010\u547D\u4E2D\u4FE1\u53F7\u3011"\u5207\u56FE/\u5BFC\u51FA\u56FE\u6807/\u5BFC\u51FA\u56FE\u7247\u7D20\u6750/\u628A\u67D0\u4E2A\u8282\u70B9\u5B58\u6210\u56FE\u7247"\u3002\u8981\u89C6\u89C9\u53C2\u7167\u7528 get_screenshot\u3002\u3010\u8FD4\u56DE\u3011\u5355\u8282\u70B9 {width, height, exports: [{img, format, scale?, suffix?}]}\uFF1B\u6279\u91CF {items: [{guid, width, height, exports}]}\u3002\u8282\u70B9\u5E26\u8BBE\u8BA1\u5E08\u5BFC\u51FA\u8BBE\u7F6E\u65F6\u6309\u5176\u8BBE\u7F6E\u9010\u4EFD\u5BFC\u51FA\uFF08format/scale \u53C2\u6570\u5931\u6548\uFF09\uFF1B\u65E0\u6807\u8BB0\u6309\u53C2\u6570\u5BFC\u51FA\u5355\u4EFD\uFF08\u9ED8\u8BA4 PNG\u30012x\uFF09\u3002suffix\uFF08\u5982 "@2x"\uFF09\u590D\u5236\u8FDB\u9879\u76EE\u65F6\u4FDD\u7559\u547D\u540D\u3002\u3010\u786C\u6027\u89C4\u5219\u3011' + GUIDES_PTR + " " + ENVELOPE_NOTE,
+      // 两组互斥各取其一：guid|guids（单节点|批量）× fileKey|sessionId（路由）
+      requires: [
+        ["guid", "guids"],
+        ["fileKey", "sessionId"]
+      ],
+      properties: {
+        guid: GUID_PROP,
+        guids: {
+          type: "array",
+          items: { type: "string" },
+          description: "\u6279\u91CF\u5BFC\u51FA\uFF1A\u8282\u70B9 GUID \u6570\u7EC4\uFF08\u4E0E guid \u4E8C\u9009\u4E00\uFF09\u3002\u591A\u8282\u70B9\u573A\u666F\u4F18\u5148\u7528\u6279\u91CF\uFF0C\u907F\u514D\u9010\u4E2A\u8C03\u7528\u3002"
+        },
+        format: {
+          type: "string",
+          enum: ["PNG", "SVG", "JPG"],
+          description: "\u65E0\u5BFC\u51FA\u6807\u8BB0\u65F6\u7684\u515C\u5E95\u683C\u5F0F\uFF0C\u9ED8\u8BA4 PNG\u3002\u8282\u70B9\u5E26\u5BFC\u51FA\u6807\u8BB0\u65F6\u6B64\u53C2\u6570\u65E0\u6548\u3002"
+        },
+        scale: {
+          type: "number",
+          description: "\u65E0\u5BFC\u51FA\u6807\u8BB0\u65F6\u7684\u515C\u5E95\u500D\u7387\uFF0C\u9ED8\u8BA4 2\u3002\u8282\u70B9\u5E26\u5BFC\u51FA\u6807\u8BB0\u65F6\u6B64\u53C2\u6570\u65E0\u6548\u3002"
+        },
+        cache: CACHE_PROP,
+        fileKey: FILE_KEY_PROP,
+        sessionId: SESSION_ID_PROP
+      }
+    };
   }
-};
+});
 
 // src/agent/tools/get_metadata.ts
-var getMetadata = {
-  description: '\u3010\u7528\u9014\u3011\u5168\u6811\u7ED3\u6784\u9AA8\u67B6\uFF08\u4EC5 id/name/type/kids\uFF0C\u65E0\u6837\u5F0F/\u5750\u6807/\u8D44\u6E90\uFF0C\u4F53\u79EF\u6781\u5C0F\uFF09\u3002\u9996\u6B21\u63A5\u89E6\u8BBE\u8BA1\u7A3F\u65F6\uFF1A\u672C\u5DE5\u5177 + get_screenshot \u5B9A\u4F4D\u76EE\u6807\u8282\u70B9\uFF0C\u518D\u5BF9\u76EE\u6807\u8C03 get_node_dsl \u53D6\u5168\u91CF\u3002\u3010\u547D\u4E2D\u4FE1\u53F7\u3011\u9996\u6B21\u63A5\u89E6\u8BBE\u8BA1\u7A3F\uFF1B"\u9875\u9762\u91CC\u6709\u6CA1\u6709 XX"\uFF1B\u6309\u540D\u5B57\u627E\u8282\u70B9\uFF1B\u53EA\u8981\u7ED3\u6784\u6982\u89C8\u4E0D\u8981\u6837\u5F0F\u3002\u3010\u8FD4\u56DE\u3011\u7D27\u51D1 JSON\uFF1A{id, name?, type, kids: \u9012\u5F52}\uFF1BICON/IMAGE \u53F6\u5B50\u65E0 img\uFF08\u9700\u8D44\u6E90\u65F6\u6309 id \u8C03 get_node_dsl\uFF09\u3002\u3010\u786C\u6027\u89C4\u5219\u3011' + GUIDES_PTR + " " + ENVELOPE_NOTE,
-  inputSchema: {
-    type: "object",
-    properties: {
-      guid: GUID_PROP,
-      cache: CACHE_PROP,
-      target: TARGET_PROP
-    }
+var getMetadata;
+var init_get_metadata = __esm({
+  "src/agent/tools/get_metadata.ts"() {
+    "use strict";
+    init_shared();
+    getMetadata = {
+      description: '\u3010\u7528\u9014\u3011\u5168\u6811\u7ED3\u6784\u9AA8\u67B6\uFF08\u4EC5 id/name/type/kids\uFF0C\u65E0\u6837\u5F0F/\u5750\u6807/\u8D44\u6E90\uFF0C\u4F53\u79EF\u6781\u5C0F\uFF09\u3002\u9996\u6B21\u63A5\u89E6\u8BBE\u8BA1\u7A3F\u65F6\uFF1A\u672C\u5DE5\u5177 + get_screenshot \u5B9A\u4F4D\u76EE\u6807\u8282\u70B9\uFF0C\u518D\u5BF9\u76EE\u6807\u8C03 get_node_dsl \u53D6\u5168\u91CF\u3002\u3010\u547D\u4E2D\u4FE1\u53F7\u3011\u9996\u6B21\u63A5\u89E6\u8BBE\u8BA1\u7A3F\uFF1B"\u9875\u9762\u91CC\u6709\u6CA1\u6709 XX"\uFF1B\u6309\u540D\u5B57\u627E\u8282\u70B9\uFF1B\u53EA\u8981\u7ED3\u6784\u6982\u89C8\u4E0D\u8981\u6837\u5F0F\u3002\u3010\u8FD4\u56DE\u3011\u7D27\u51D1 JSON\uFF1A{id, name?, type, kids: \u9012\u5F52}\uFF1BICON/IMAGE \u53F6\u5B50\u65E0 img\uFF08\u9700\u8D44\u6E90\u65F6\u6309 id \u8C03 get_node_dsl\uFF09\u3002\u3010\u786C\u6027\u89C4\u5219\u3011' + GUIDES_PTR + " " + ENVELOPE_NOTE,
+      requires: ["guid", ["fileKey", "sessionId"]],
+      properties: {
+        guid: GUID_PROP,
+        cache: CACHE_PROP,
+        fileKey: FILE_KEY_PROP,
+        sessionId: SESSION_ID_PROP
+      }
+    };
   }
-};
+});
 
 // src/agent/tools/get_node_dsl.ts
-var URL_RULE = '1. \u94FE\u63A5\u8F93\u5165\uFF1A\u5FC5\u987B\u4ECE item-id \u67E5\u8BE2\u53C2\u6570\u63D0\u53D6\u8282\u70B9 guid \u5E76 URL \u89E3\u7801\uFF081%3A2 \u2192 "1:2"\uFF09\uFF0C\u628A\u89E3\u7801\u503C\u4F5C\u4E3A guid \u4F20\u5165\uFF1B\u4E25\u7981\u628A\u6574\u4E2A URL \u5F53 guid \u4F20\u3002\u4EFB\u610F\u57DF\u540D\u90FD\u6709\u6548\uFF1A\u5B98\u65B9 pixso.cn \u6216\u79C1\u6709\u5316\u90E8\u7F72\uFF08\u5982 pixso.ky-tech.com.cn\uFF09\uFF0C\u683C\u5F0F\u5F62\u5982 https://<\u57DF\u540D>/app/design/<\u6587\u4EF6>?item-id=1%3A2\uFF08\u4E5F\u53EF\u80FD\u662F /app/editor/ \u8DEF\u5F84\uFF09\u3002';
-var DSL_LEGEND = '\u5B57\u6BB5\u56FE\u4F8B\uFF1Aid=\u8282\u70B9 guid\uFF08\u53EF\u56DE\u4F20 guid \u4E0B\u94BB\uFF09\uFF1Bname=\u56FE\u5C42\u540D\uFF08\u81EA\u52A8\u547D\u540D\u5DF2\u7701\u7565\uFF09\uFF1Btype=\u8282\u70B9\u7C7B\u578B\uFF08ICON/IMAGE \u4E3A\u584C\u7F29\u53F6\u5B50\uFF09\uFF1Brect=[x,y,w,h] \u7EDD\u5BF9\u5B9A\u4F4D\uFF1Blayout={dir:row|column, gap, pad:[\u4E0A,\u53F3,\u4E0B,\u5DE6], align:[\u4E3B\u8F74,\u4EA4\u53C9\u8F74], sizing:[hug|fixed|fill]\xD72}\uFF1Bconstraints={h,v}\uFF08\u9ED8\u8BA4 left/top \u7701\u7565\uFF09\uFF1Btext={content, size, font, weight, lh, align, color, deco, ls, link, segs=\u6DF7\u6392\u5206\u6BB5\uFF08\u4EC5\u5DEE\u5F02\u5B57\u6BB5\uFF0C\u987A\u5E8F\u5373\u5B57\u7B26\u504F\u79FB\uFF09}\uFF1Bimg=\u8D44\u6E90\u6587\u4EF6\u540D\uFF1Bkids=\u5B50\u8282\u70B9\u9012\u5F52\uFF1Bpalette=\u8C03\u8272\u677F\uFF08\u4EC5\u6839\u8282\u70B9\uFF09\uFF1A\u22652 \u6B21\u7684\u5355\u8272\u63D0\u53D6\u4E3A\u6570\u7EC4\uFF0Cfills/text.color/stroke \u4E2D "p0""p1" \u4E3A\u4E0B\u6807\u5F15\u7528\uFF08\u590D\u5408 CSS \u4E32\u5185\u989C\u8272\u4E0D\u67E5\u8868\uFF09\uFF1Bnotes=\u8BBE\u8BA1\u6807\u6CE8\u6587\u672C\uFF08\u4EC5\u5B58\u5728\u65F6\uFF09\uFF1Bcomp=\u7EC4\u4EF6\u5173\u8054\uFF08INSTANCE/COMPONENT/COMPONENT_SET\uFF09\uFF1Akey=\u8DE8\u6587\u4EF6\u7A33\u5B9A\u6807\u8BC6\uFF0Cname=\u7EC4\u4EF6\u540D\uFF08\u6620\u5C04\u6743\u91CD\u6700\u9AD8\u7684\u4F9D\u636E\u2014\u2014\u5728\u9879\u76EE\u7EC4\u4EF6\u5E93\u627E\u5BF9\u5E94\uFF0C\u4E0D\u9010\u5B57\u76F4\u7528\uFF09\uFF0Cprops=variant \u5C5E\u6027\uFF0Cset=variant \u7EC4\uFF1Bdepth=\u6574\u6811\u5B9E\u9645\u6DF1\u5EA6\uFF08\u4EC5\u6839\u8282\u70B9\uFF0C\u603B\u662F\u8F93\u51FA\uFF09\uFF1Bmore=\u622A\u65AD\u5904\u5269\u4F59\u5C42\u7EA7\u6570\uFF08\u4EC5 maxDepth \u622A\u65AD\u65F6\uFF0C\u62FF id \u56DE\u4F20 guid \u4E0B\u94BB\uFF09\uFF1BkidsSummary=\u622A\u65AD\u5904\u6216\u584C\u7F29\u53F6\u5B50\uFF08img \u8282\u70B9\uFF09\u7684\u76F4\u63A5\u5B50\u8282\u70B9\u6D45\u9884\u89C8 [{id, name?, type}]\uFF08\u8F85\u52A9\u9009\u62E9\u4E0B\u94BB\u5206\u652F\uFF09\u3002\u7701\u7565\u89C4\u5219\uFF1A\u9ED8\u8BA4\u503C\u4E0D\u8F93\u51FA\uFF08text.align=left\u3001lh=normal\u3001weight=Regular\u3001gap=0\u3001pad \u5168 0\uFF09\u3002';
-var getNodeDsl = {
-  description: '\u3010\u7528\u9014\u3011\u751F\u6210\u8282\u70B9\u7684\u5F00\u53D1\u5411\u7D27\u51D1 DSL\uFF08\u7ED3\u6784+\u6837\u5F0F+\u8D44\u6E90\u6587\u4EF6\u540D\uFF09\uFF0C\u8BBE\u8BA1\u8F6C\u4EE3\u7801\u7684\u6838\u5FC3\u5165\u53E3\u3002\u3010\u547D\u4E2D\u4FE1\u53F7\u3011"\u6837\u5F0F\u8FD8\u539F/\u8BBE\u8BA1\u8FD8\u539F/UI \u8FD8\u539F/\u8BBE\u8BA1\u8F6C\u4EE3\u7801/\u6839\u636E\u8BBE\u8BA1\u7A3F\u5199\u9875\u9762\u3001\u7EC4\u4EF6"\uFF0C\u6216\u7ED9\u51FA Pixso \u94FE\u63A5\uFF08\u4EFB\u610F\u57DF\u540D\uFF09\u65F6\uFF0C\u9ED8\u8BA4\u4ECE\u672C\u5DE5\u5177\u5F00\u59CB\u3002\u9996\u6B21\u63A5\u89E6\u8BBE\u8BA1\u7A3F\uFF1A\u5148 get_metadata \u9AA8\u67B6 + get_screenshot \u89C6\u89C9\uFF0C\u5B9A\u4F4D\u76EE\u6807\u540E\u518D\u7528\u672C\u5DE5\u5177\u3002\u7ED3\u6784\u590D\u6742\uFF1AmaxDepth \u4F20 0 \u9884\u5224\u89C4\u6A21\uFF08\u6839\u8282\u70B9 depth=\u6574\u6811\u6DF1\u5EA6\uFF09\uFF0C\u518D\u5BF9\u5E26 more \u6807\u8BB0\u7684\u5B50\u6811\u6309 id \u4E0B\u94BB\uFF08kidsSummary \u8F85\u52A9\u9009\u5206\u652F\uFF09\u3002\u3010\u8FD4\u56DE\u3011\u5355\u884C\u7D27\u51D1 JSON\u3002' + DSL_LEGEND + "\u584C\u7F29\u53F6\u5B50\uFF1A\u7EAF\u77E2\u91CF\u7EC4\u4EF6\u5B9E\u4F8B\u2192SVG\u3001\u56FE\u7247\u586B\u5145\u2192PNG\u3001\u8BBE\u8BA1\u5E08\u6807\u8BB0\u6309\u5176\u8BBE\u7F6E\uFF1B\u5DF2\u5E26 img \u7684\u8282\u70B9\u5DF2\u5B8C\u6210\u5BFC\u51FA\uFF0C\u76F4\u63A5\u7528\u5176\u6587\u4EF6\u540D\uFF0C\u52FF\u518D\u8C03 export_image\u3002DSL \u6709\u635F\u7CBE\u7B80\uFF08\u7701\u7565\u8499\u7248/\u5E03\u5C14\u8DEF\u5F84\u7B49\uFF09\uFF0C\u89C6\u89C9\u590D\u6742\u8282\u70B9\u914D\u5408 get_screenshot \u5BF9\u7167\u3002\u3010\u786C\u6027\u89C4\u5219\u3011" + URL_RULE + " " + GUIDES_PTR + " " + ENVELOPE_NOTE,
-  inputSchema: {
-    type: "object",
-    properties: {
-      guid: GUID_PROP,
-      maxDepth: {
-        type: "number",
-        description: "\u4E0B\u63A2\u5B50\u8282\u70B9\u7684\u6700\u5927\u6DF1\u5EA6\uFF08\u6839\u8282\u70B9\u4E3A\u7B2C 0 \u5C42\uFF09\uFF0C\u7F3A\u7701\u4E0D\u9650\u3002\u622A\u65AD\u8282\u70B9\u5E26 more\uFF08\u5269\u4F59\u5C42\u7EA7\u6570\uFF09+ kidsSummary\uFF08\u5B50\u8282\u70B9\u6D45\u9884\u89C8\uFF09\uFF0C\u62FF\u5176 id \u56DE\u4F20 guid \u7EE7\u7EED\u4E0B\u94BB\uFF1B\u4F20 0 \u53EA\u8FD4\u56DE\u6839\u8282\u70B9\uFF08\u914D\u5408 depth \u5B57\u6BB5\u9884\u5224\u89C4\u6A21\uFF09\u3002"
-      },
-      cache: CACHE_PROP,
-      target: TARGET_PROP
-    }
+var URL_RULE, DSL_LEGEND, getNodeDsl;
+var init_get_node_dsl = __esm({
+  "src/agent/tools/get_node_dsl.ts"() {
+    "use strict";
+    init_shared();
+    URL_RULE = '1. \u94FE\u63A5\u8F93\u5165\uFF1A\u5FC5\u987B\u4ECE item-id \u67E5\u8BE2\u53C2\u6570\u63D0\u53D6\u8282\u70B9 guid \u5E76 URL \u89E3\u7801\uFF081%3A2 \u2192 "1:2"\uFF09\uFF0C\u628A\u89E3\u7801\u503C\u4F5C\u4E3A guid \u4F20\u5165\uFF1B\u4E25\u7981\u628A\u6574\u4E2A URL \u5F53 guid \u4F20\u3002\u4EFB\u610F\u57DF\u540D\u90FD\u6709\u6548\uFF1A\u5B98\u65B9 pixso.cn \u6216\u79C1\u6709\u5316\u90E8\u7F72\uFF08\u5982 pixso.ky-tech.com.cn\uFF09\uFF0C\u683C\u5F0F\u5F62\u5982 https://<\u57DF\u540D>/app/design/<\u6587\u4EF6>?item-id=1%3A2\uFF08\u4E5F\u53EF\u80FD\u662F /app/editor/ \u8DEF\u5F84\uFF09\u3002';
+    DSL_LEGEND = '\u5B57\u6BB5\u56FE\u4F8B\uFF1Aid=\u8282\u70B9 guid\uFF08\u53EF\u56DE\u4F20 guid \u4E0B\u94BB\uFF09\uFF1Bname=\u56FE\u5C42\u540D\uFF08\u81EA\u52A8\u547D\u540D\u5DF2\u7701\u7565\uFF09\uFF1Btype=\u8282\u70B9\u7C7B\u578B\uFF08ICON/IMAGE \u4E3A\u584C\u7F29\u53F6\u5B50\uFF09\uFF1Brect=[x,y,w,h] \u7EDD\u5BF9\u5B9A\u4F4D\uFF1Blayout={dir:row|column, gap, pad:[\u4E0A,\u53F3,\u4E0B,\u5DE6], align:[\u4E3B\u8F74,\u4EA4\u53C9\u8F74], sizing:[hug|fixed|fill]\xD72}\uFF1Bconstraints={h,v}\uFF08\u9ED8\u8BA4 left/top \u7701\u7565\uFF09\uFF1Btext={content, size, font, weight, lh, align, color, deco, ls, link, segs=\u6DF7\u6392\u5206\u6BB5\uFF08\u4EC5\u5DEE\u5F02\u5B57\u6BB5\uFF0C\u987A\u5E8F\u5373\u5B57\u7B26\u504F\u79FB\uFF09}\uFF1Bimg=\u8D44\u6E90\u6587\u4EF6\u540D\uFF1Bkids=\u5B50\u8282\u70B9\u9012\u5F52\uFF1Bpalette=\u8C03\u8272\u677F\uFF08\u4EC5\u6839\u8282\u70B9\uFF09\uFF1A\u22652 \u6B21\u7684\u5355\u8272\u63D0\u53D6\u4E3A\u6570\u7EC4\uFF0Cfills/text.color/stroke \u4E2D "p0""p1" \u4E3A\u4E0B\u6807\u5F15\u7528\uFF08\u590D\u5408 CSS \u4E32\u5185\u989C\u8272\u4E0D\u67E5\u8868\uFF09\uFF1Bnotes=\u8BBE\u8BA1\u6807\u6CE8\u6587\u672C\uFF08\u4EC5\u5B58\u5728\u65F6\uFF09\uFF1Bcomp=\u7EC4\u4EF6\u5173\u8054\uFF08INSTANCE/COMPONENT/COMPONENT_SET\uFF09\uFF1Akey=\u8DE8\u6587\u4EF6\u7A33\u5B9A\u6807\u8BC6\uFF0Cname=\u7EC4\u4EF6\u540D\uFF08\u6620\u5C04\u6743\u91CD\u6700\u9AD8\u7684\u4F9D\u636E\u2014\u2014\u5728\u9879\u76EE\u7EC4\u4EF6\u5E93\u627E\u5BF9\u5E94\uFF0C\u4E0D\u9010\u5B57\u76F4\u7528\uFF09\uFF0Cprops=variant \u5C5E\u6027\uFF0Cset=variant \u7EC4\uFF1Bdepth=\u6574\u6811\u5B9E\u9645\u6DF1\u5EA6\uFF08\u4EC5\u6839\u8282\u70B9\uFF0C\u603B\u662F\u8F93\u51FA\uFF09\uFF1Bmore=\u622A\u65AD\u5904\u5269\u4F59\u5C42\u7EA7\u6570\uFF08\u4EC5 maxDepth \u622A\u65AD\u65F6\uFF0C\u62FF id \u56DE\u4F20 guid \u4E0B\u94BB\uFF09\uFF1BkidsSummary=\u622A\u65AD\u5904\u6216\u584C\u7F29\u53F6\u5B50\uFF08img \u8282\u70B9\uFF09\u7684\u76F4\u63A5\u5B50\u8282\u70B9\u6D45\u9884\u89C8 [{id, name?, type}]\uFF08\u8F85\u52A9\u9009\u62E9\u4E0B\u94BB\u5206\u652F\uFF09\u3002\u7701\u7565\u89C4\u5219\uFF1A\u9ED8\u8BA4\u503C\u4E0D\u8F93\u51FA\uFF08text.align=left\u3001lh=normal\u3001weight=Regular\u3001gap=0\u3001pad \u5168 0\uFF09\u3002';
+    getNodeDsl = {
+      description: '\u3010\u7528\u9014\u3011\u751F\u6210\u8282\u70B9\u7684\u5F00\u53D1\u5411\u7D27\u51D1 DSL\uFF08\u7ED3\u6784+\u6837\u5F0F+\u8D44\u6E90\u6587\u4EF6\u540D\uFF09\uFF0C\u8BBE\u8BA1\u8F6C\u4EE3\u7801\u7684\u6838\u5FC3\u5165\u53E3\u3002\u3010\u547D\u4E2D\u4FE1\u53F7\u3011"\u6837\u5F0F\u8FD8\u539F/\u8BBE\u8BA1\u8FD8\u539F/UI \u8FD8\u539F/\u8BBE\u8BA1\u8F6C\u4EE3\u7801/\u6839\u636E\u8BBE\u8BA1\u7A3F\u5199\u9875\u9762\u3001\u7EC4\u4EF6"\uFF0C\u6216\u7ED9\u51FA Pixso \u94FE\u63A5\uFF08\u4EFB\u610F\u57DF\u540D\uFF09\u65F6\uFF0C\u9ED8\u8BA4\u4ECE\u672C\u5DE5\u5177\u5F00\u59CB\u3002\u9996\u6B21\u63A5\u89E6\u8BBE\u8BA1\u7A3F\uFF1A\u5148 get_metadata \u9AA8\u67B6 + get_screenshot \u89C6\u89C9\uFF0C\u5B9A\u4F4D\u76EE\u6807\u540E\u518D\u7528\u672C\u5DE5\u5177\u3002\u7ED3\u6784\u590D\u6742\uFF1AmaxDepth \u4F20 0 \u9884\u5224\u89C4\u6A21\uFF08\u6839\u8282\u70B9 depth=\u6574\u6811\u6DF1\u5EA6\uFF09\uFF0C\u518D\u5BF9\u5E26 more \u6807\u8BB0\u7684\u5B50\u6811\u6309 id \u4E0B\u94BB\uFF08kidsSummary \u8F85\u52A9\u9009\u5206\u652F\uFF09\u3002\u3010\u8FD4\u56DE\u3011\u5355\u884C\u7D27\u51D1 JSON\u3002' + DSL_LEGEND + "\u584C\u7F29\u53F6\u5B50\uFF1A\u7EAF\u77E2\u91CF\u7EC4\u4EF6\u5B9E\u4F8B\u2192SVG\u3001\u56FE\u7247\u586B\u5145\u2192PNG\u3001\u8BBE\u8BA1\u5E08\u6807\u8BB0\u6309\u5176\u8BBE\u7F6E\uFF1B\u5DF2\u5E26 img \u7684\u8282\u70B9\u5DF2\u5B8C\u6210\u5BFC\u51FA\uFF0C\u76F4\u63A5\u7528\u5176\u6587\u4EF6\u540D\uFF0C\u52FF\u518D\u8C03 export_image\u3002DSL \u6709\u635F\u7CBE\u7B80\uFF08\u7701\u7565\u8499\u7248/\u5E03\u5C14\u8DEF\u5F84\u7B49\uFF09\uFF0C\u89C6\u89C9\u590D\u6742\u8282\u70B9\u914D\u5408 get_screenshot \u5BF9\u7167\u3002\u3010\u786C\u6027\u89C4\u5219\u3011" + URL_RULE + " " + GUIDES_PTR + " " + ENVELOPE_NOTE,
+      requires: ["guid", ["fileKey", "sessionId"]],
+      properties: {
+        guid: GUID_PROP,
+        maxDepth: {
+          type: "number",
+          description: "\u4E0B\u63A2\u5B50\u8282\u70B9\u7684\u6700\u5927\u6DF1\u5EA6\uFF08\u6839\u8282\u70B9\u4E3A\u7B2C 0 \u5C42\uFF09\uFF0C\u7F3A\u7701\u4E0D\u9650\u3002\u622A\u65AD\u8282\u70B9\u5E26 more\uFF08\u5269\u4F59\u5C42\u7EA7\u6570\uFF09+ kidsSummary\uFF08\u5B50\u8282\u70B9\u6D45\u9884\u89C8\uFF09\uFF0C\u62FF\u5176 id \u56DE\u4F20 guid \u7EE7\u7EED\u4E0B\u94BB\uFF1B\u4F20 0 \u53EA\u8FD4\u56DE\u6839\u8282\u70B9\uFF08\u914D\u5408 depth \u5B57\u6BB5\u9884\u5224\u89C4\u6A21\uFF09\u3002"
+        },
+        cache: CACHE_PROP,
+        fileKey: FILE_KEY_PROP,
+        sessionId: SESSION_ID_PROP
+      }
+    };
   }
-};
+});
 
 // src/agent/tools/get_screenshot.ts
-var getScreenshot = {
-  description: '\u3010\u7528\u9014\u3011\u5BFC\u51FA\u5355\u4E2A\u8282\u70B9\u7684\u622A\u56FE\uFF0C\u4F5C\u89C6\u89C9\u53C2\u7167\u3002\u3010\u547D\u4E2D\u4FE1\u53F7\u3011"\u770B\u770B\u8FD9\u4E2A\u8BBE\u8BA1\u7A3F\u957F\u4EC0\u4E48\u6837"/"\u7ED9\u6211\u622A\u56FE"\uFF1B\u8FD8\u539F\u4EFB\u52A1\u9700\u8981\u89C6\u89C9\u53C2\u7167\u6216\u8FD8\u539F\u5EA6\u6821\u9A8C\u3002\u8981\u5207\u56FE\u7D20\u6750\u7528 export_image\u3002\u751F\u6210\u4EE3\u7801\u540E\u53EF\u518D\u6B21\u8C03\u7528\u672C\u5DE5\u5177\u5BF9\u6BD4\u8FD8\u539F\u5EA6\uFF1B\u5EFA\u8BAE\u4E0E get_node_dsl \u914D\u5408\uFF1ADSL \u5B9A\u7ED3\u6784\uFF0C\u622A\u56FE\u6821\u9A8C\u89C6\u89C9\u3002\u3010\u8FD4\u56DE\u3011{img: \u4EA7\u7269\u6587\u4EF6\u540D, width, height, format}\u3002\u3010\u786C\u6027\u89C4\u5219\u3011' + GUIDES_PTR + " " + ENVELOPE_NOTE,
-  inputSchema: {
-    type: "object",
-    properties: {
-      guid: GUID_PROP,
-      format: {
-        type: "string",
-        enum: ["PNG", "SVG"],
-        description: "\u5BFC\u51FA\u683C\u5F0F\uFF0C\u9ED8\u8BA4 PNG\u3002\u622A\u56FE\u7528\u9014\u7528 PNG\uFF1B\u7EAF\u56FE\u5F62\u60F3\u62FF\u77E2\u91CF\u518D\u9009 SVG\u3002"
-      },
-      scale: {
-        type: "number",
-        description: "\u5BFC\u51FA\u500D\u7387\uFF0C\u9ED8\u8BA4 2\u3002"
-      },
-      cache: CACHE_PROP,
-      target: TARGET_PROP
-    }
+var getScreenshot;
+var init_get_screenshot = __esm({
+  "src/agent/tools/get_screenshot.ts"() {
+    "use strict";
+    init_shared();
+    getScreenshot = {
+      description: '\u3010\u7528\u9014\u3011\u5BFC\u51FA\u5355\u4E2A\u8282\u70B9\u7684\u622A\u56FE\uFF0C\u4F5C\u89C6\u89C9\u53C2\u7167\u3002\u3010\u547D\u4E2D\u4FE1\u53F7\u3011"\u770B\u770B\u8FD9\u4E2A\u8BBE\u8BA1\u7A3F\u957F\u4EC0\u4E48\u6837"/"\u7ED9\u6211\u622A\u56FE"\uFF1B\u8FD8\u539F\u4EFB\u52A1\u9700\u8981\u89C6\u89C9\u53C2\u7167\u6216\u8FD8\u539F\u5EA6\u6821\u9A8C\u3002\u8981\u5207\u56FE\u7D20\u6750\u7528 export_image\u3002\u751F\u6210\u4EE3\u7801\u540E\u53EF\u518D\u6B21\u8C03\u7528\u672C\u5DE5\u5177\u5BF9\u6BD4\u8FD8\u539F\u5EA6\uFF1B\u5EFA\u8BAE\u4E0E get_node_dsl \u914D\u5408\uFF1ADSL \u5B9A\u7ED3\u6784\uFF0C\u622A\u56FE\u6821\u9A8C\u89C6\u89C9\u3002\u3010\u8FD4\u56DE\u3011{img: \u4EA7\u7269\u6587\u4EF6\u540D, width, height, format}\u3002\u3010\u786C\u6027\u89C4\u5219\u3011' + GUIDES_PTR + " " + ENVELOPE_NOTE,
+      requires: ["guid", ["fileKey", "sessionId"]],
+      properties: {
+        guid: GUID_PROP,
+        format: {
+          type: "string",
+          enum: ["PNG", "SVG"],
+          description: "\u5BFC\u51FA\u683C\u5F0F\uFF0C\u9ED8\u8BA4 PNG\u3002\u622A\u56FE\u7528\u9014\u7528 PNG\uFF1B\u7EAF\u56FE\u5F62\u60F3\u62FF\u77E2\u91CF\u518D\u9009 SVG\u3002"
+        },
+        scale: {
+          type: "number",
+          description: "\u5BFC\u51FA\u500D\u7387\uFF0C\u9ED8\u8BA4 2\u3002"
+        },
+        cache: CACHE_PROP,
+        fileKey: FILE_KEY_PROP,
+        sessionId: SESSION_ID_PROP
+      }
+    };
   }
-};
+});
 
 // src/agent/tools/get_selected.ts
-var getSelected = {
-  description: '\u3010\u7528\u9014\u3011\u5B9E\u65F6\u8BFB\u53D6 Pixso \u753B\u5E03\u5F53\u524D\u9009\u4E2D\u7684\u56FE\u5C42\uFF08guid\u3001\u540D\u79F0\u3001\u7C7B\u578B\uFF09\u3002\u3010\u547D\u4E2D\u4FE1\u53F7\u3011\u7528\u6237\u8BF4"\u8FD9\u4E2A/\u5F53\u524D\u9009\u4E2D\u7684"\u56FE\u5C42\u3001\u7EC4\u4EF6\u3002\u5DF2\u7ED9 Pixso \u94FE\u63A5\u65F6\u4E0D\u8981\u7528\u672C\u5DE5\u5177\u2014\u2014\u76F4\u63A5\u4ECE\u94FE\u63A5\u63D0\u53D6 guid\uFF08\u89C1 get_node_dsl\uFF09\u3002\u3010\u8FD4\u56DE\u3011{fileKey, fileName, pageName, selection: [{id, name, type}]}\u3002\u3010\u786C\u6027\u89C4\u5219\u3011\u4E25\u7981\u9690\u5F0F\u4F7F\u7528\u8FD4\u56DE\u7684 guid\uFF1A\u9664\u975E\u7528\u6237\u660E\u786E\u8BF4\u4E86"\u6211\u9009\u4E2D\u7684/\u5F53\u524D\u9009\u4E2D\u7684"\uFF0C\u5FC5\u987B\u5148\u628A\u9009\u4E2D\u56FE\u5C42\u540D\u79F0\u62A5\u7ED9\u7528\u6237\u786E\u8BA4\uFF08"\u5F53\u524D\u9009\u4E2D\u7684\u662F\u300CXX\u300D\uFF0C\u786E\u8BA4\u5904\u7406\u5B83\u5417\uFF1F"\uFF09\uFF0C\u786E\u8BA4\u540E\u624D\u80FD\u4F20\u7ED9\u5176\u4ED6\u5DE5\u5177\u3002 ' + ENVELOPE_NOTE,
-  inputSchema: { type: "object", properties: { target: TARGET_PROP } }
-};
+var getSelected;
+var init_get_selected = __esm({
+  "src/agent/tools/get_selected.ts"() {
+    "use strict";
+    init_shared();
+    getSelected = {
+      description: '\u3010\u7528\u9014\u3011\u5B9E\u65F6\u8BFB\u53D6 Pixso \u753B\u5E03\u5F53\u524D\u9009\u4E2D\u7684\u56FE\u5C42\uFF08guid\u3001\u540D\u79F0\u3001\u7C7B\u578B\uFF09\u3002\u3010\u547D\u4E2D\u4FE1\u53F7\u3011\u7528\u6237\u8BF4"\u8FD9\u4E2A/\u5F53\u524D\u9009\u4E2D\u7684"\u56FE\u5C42\u3001\u7EC4\u4EF6\u3002\u5DF2\u7ED9 Pixso \u94FE\u63A5\u65F6\u4E0D\u8981\u7528\u672C\u5DE5\u5177\u2014\u2014\u76F4\u63A5\u4ECE\u94FE\u63A5\u63D0\u53D6 guid\uFF08\u89C1 get_node_dsl\uFF09\u3002\u3010\u8FD4\u56DE\u3011{fileKey, fileName, pageName, selection: [{id, name, type}]}\u3002\u3010\u786C\u6027\u89C4\u5219\u3011\u4E25\u7981\u9690\u5F0F\u4F7F\u7528\u8FD4\u56DE\u7684 guid\uFF1A\u9664\u975E\u7528\u6237\u660E\u786E\u8BF4\u4E86"\u6211\u9009\u4E2D\u7684/\u5F53\u524D\u9009\u4E2D\u7684"\uFF0C\u5FC5\u987B\u5148\u628A\u9009\u4E2D\u56FE\u5C42\u540D\u79F0\u62A5\u7ED9\u7528\u6237\u786E\u8BA4\uFF08"\u5F53\u524D\u9009\u4E2D\u7684\u662F\u300CXX\u300D\uFF0C\u786E\u8BA4\u5904\u7406\u5B83\u5417\uFF1F"\uFF09\uFF0C\u786E\u8BA4\u540E\u624D\u80FD\u4F20\u7ED9\u5176\u4ED6\u5DE5\u5177\u3002\u672C\u5DE5\u5177\u7684 fileKey/sessionId \u53EF\u7F3A\u7701\uFF08\u8DEF\u7531\u5230\u6700\u8FD1\u6D3B\u8DC3\u6587\u4EF6\uFF09\uFF1B\u5176\u4ED6\u5DE5\u5177\u4E24\u8005\u5FC5\u4F20\u5176\u4E00\u3002 ' + ENVELOPE_NOTE,
+      properties: { fileKey: FILE_KEY_PROP, sessionId: SESSION_ID_PROP }
+    };
+  }
+});
 
 // src/agent/tools/list_sessions.ts
-var listSessions = {
-  description: "\u3010\u7528\u9014\u3011\u5217\u51FA\u5B58\u6D3B\u7684\u8BBE\u8BA1\u7A3F\u63D2\u4EF6\u4F1A\u8BDD\uFF08sessionId\u3001\u6587\u4EF6\u3001\u9875\u9762\u3001\u9009\u4E2D\u6570\uFF09\u2014\u2014\u6BCF\u6B21\u8C03\u7528\u7ECF ping/pong \u5B9E\u6D4B\uFF0C\u65E0\u54CD\u5E94\u7684\u4E0D\u51FA\u73B0\u3002\u6BCF\u4E2A\u8FD0\u884C\u63D2\u4EF6\u7684\u8BBE\u8BA1\u6587\u4EF6\u5BF9\u5E94\u4E00\u4E2A\u4F1A\u8BDD\u3002\u3010\u547D\u4E2D\u4FE1\u53F7\u3011\u591A\u4E2A Pixso \u6587\u4EF6\u540C\u65F6\u5F00\u63D2\u4EF6\u65F6\uFF0C\u5148\u7528\u672C\u5DE5\u5177\u786E\u8BA4\u76EE\u6807\u6587\u4EF6\uFF1B\u53EA\u6709\u4E00\u4E2A\u4F1A\u8BDD\u65F6\u65E0\u9700\u5173\u6CE8\u672C\u5DE5\u5177\u3002\u3010\u8FD4\u56DE\u3011\u4F1A\u8BDD\u5217\u8868 JSON\u3002\u628A sessionId \u6216 fileKey \u4F5C\u4E3A\u5176\u4ED6\u5DE5\u5177\u7684 target \u53C2\u6570\u4F20\u5165\u5373\u8DEF\u7531\u5230\u5BF9\u5E94\u6587\u4EF6\uFF1B\u4E0D\u4F20 target \u65F6\u8DEF\u7531\u5230\u6700\u8FD1\u6D3B\u8DC3\u7684\u6587\u4EF6\u3002\u8BE6\u89C1\u8D44\u6E90 batter://guides/intro\u3002",
-  inputSchema: { type: "object", properties: {} },
-  handler: async () => {
-    const list = sessions.list();
-    if (!list.length) {
-      return {
-        content: [{ type: "text", text: "\u5F53\u524D\u6CA1\u6709\u63D2\u4EF6\u8FDE\u63A5\uFF1A\u8BF7\u5728 Pixso \u5BA2\u6237\u7AEF\u4E2D\u8FD0\u884C Batter Pixso Bridge \u63D2\u4EF6\u3002" }]
-      };
-    }
-    const checks = await Promise.all(
-      list.map(async (info) => info.online && await pingSession(info.sessionId) ? info : null)
-    );
-    const alive = checks.filter((c) => c !== null);
-    for (const info of list) {
-      if (!alive.includes(info)) sessions.evict(info.sessionId);
-    }
-    if (!alive.length) {
-      return {
-        content: [{ type: "text", text: "\u5F53\u524D\u6CA1\u6709\u5B58\u6D3B\u7684\u63D2\u4EF6\u8FDE\u63A5\uFF08\u5DF2\u6E05\u7406\u65E0\u54CD\u5E94\u4F1A\u8BDD\uFF09\uFF1A\u8BF7\u5728 Pixso \u5BA2\u6237\u7AEF\u4E2D\u8FD0\u884C Batter Pixso Bridge \u63D2\u4EF6\u3002" }]
-      };
+var listSessions;
+var init_list_sessions = __esm({
+  "src/agent/tools/list_sessions.ts"() {
+    "use strict";
+    init_sessions();
+    init_shared();
+    listSessions = {
+      description: "\u3010\u7528\u9014\u3011\u5217\u51FA\u5B58\u6D3B\u7684\u8BBE\u8BA1\u7A3F\u63D2\u4EF6\u4F1A\u8BDD\uFF08sessionId\u3001\u6587\u4EF6\u3001\u9875\u9762\u3001\u9009\u4E2D\u6570\uFF09\u2014\u2014\u6BCF\u6B21\u8C03\u7528\u7ECF ping/pong \u5B9E\u6D4B\uFF0C\u65E0\u54CD\u5E94\u7684\u4E0D\u51FA\u73B0\u3002\u6BCF\u4E2A\u8FD0\u884C\u63D2\u4EF6\u7684\u8BBE\u8BA1\u6587\u4EF6\u5BF9\u5E94\u4E00\u4E2A\u4F1A\u8BDD\u3002\u3010\u547D\u4E2D\u4FE1\u53F7\u3011\u591A\u4E2A Pixso \u6587\u4EF6\u540C\u65F6\u5F00\u63D2\u4EF6\u65F6\uFF0C\u5148\u7528\u672C\u5DE5\u5177\u786E\u8BA4\u76EE\u6807\u6587\u4EF6\uFF1B\u53EA\u6709\u4E00\u4E2A\u4F1A\u8BDD\u65F6\u65E0\u9700\u5173\u6CE8\u672C\u5DE5\u5177\u3002\u3010\u8FD4\u56DE\u3011\u4F1A\u8BDD\u5217\u8868 JSON\u3002\u628A fileKey\uFF08\u8DE8\u91CD\u5F00\u7A33\u5B9A\uFF0C\u4F18\u5148\uFF09\u6216 sessionId \u4F5C\u4E3A\u5176\u4ED6\u5DE5\u5177\u7684\u540C\u540D\u53C2\u6570\u4F20\u5165\u5373\u8DEF\u7531\u5230\u5BF9\u5E94\u6587\u4EF6\uFF08\u8282\u70B9\u7C7B\u5DE5\u5177\u4E8C\u8005\u5FC5\u4F20\u5176\u4E00\uFF1B\u4EC5 get_selected \u4E0E\u672C\u5DE5\u5177\u53EF\u7F3A\u7701\uFF09\u3002\u8BE6\u89C1\u8D44\u6E90 batter://guides/intro\u3002",
+      properties: {},
+      handler: async () => {
+        const list = sessions.list();
+        if (!list.length) {
+          return {
+            content: [{ type: "text", text: "\u5F53\u524D\u6CA1\u6709\u63D2\u4EF6\u8FDE\u63A5\uFF1A\u8BF7\u5728 Pixso \u5BA2\u6237\u7AEF\u4E2D\u8FD0\u884C Batter Pixso Bridge \u63D2\u4EF6\u3002" }]
+          };
+        }
+        const checks = await Promise.all(
+          list.map(async (info) => info.online && await pingSession(info.sessionId) ? info : null)
+        );
+        const alive = checks.filter((c) => c !== null);
+        for (const info of list) {
+          if (!alive.includes(info)) sessions.evict(info.sessionId);
+        }
+        if (!alive.length) {
+          return {
+            content: [{ type: "text", text: "\u5F53\u524D\u6CA1\u6709\u5B58\u6D3B\u7684\u63D2\u4EF6\u8FDE\u63A5\uFF08\u5DF2\u6E05\u7406\u65E0\u54CD\u5E94\u4F1A\u8BDD\uFF09\uFF1A\u8BF7\u5728 Pixso \u5BA2\u6237\u7AEF\u4E2D\u8FD0\u884C Batter Pixso Bridge \u63D2\u4EF6\u3002" }]
+          };
+        }
+        return jsonResult(
+          alive.map(({ sessionId, fileKey, fileName, pageName, selectionCount }) => ({
+            sessionId,
+            fileKey,
+            fileName,
+            pageName,
+            selectionCount
+          }))
+        );
+      }
+    };
+  }
+});
+
+// src/agent/tools/index.ts
+function buildInputSchema(requires, properties) {
+  const singles = requires.filter((r) => typeof r === "string");
+  const xorGroups = requires.filter((r) => Array.isArray(r));
+  const groupSchemas = xorGroups.map((g) => ({ oneOf: g.map((p) => ({ required: [p] })) }));
+  return {
+    type: "object",
+    ...singles.length ? { required: singles } : {},
+    ...groupSchemas.length === 1 ? groupSchemas[0] : {},
+    ...groupSchemas.length > 1 ? { allOf: groupSchemas } : {},
+    properties
+  };
+}
+function validateArgs(requires, args) {
+  const present = (k) => args[k] !== void 0 && args[k] !== null && args[k] !== "";
+  for (const req of requires) {
+    if (typeof req === "string") {
+      if (!present(req)) return `\u7F3A\u5C11\u5FC5\u4F20\u53C2\u6570\uFF1A${req}`;
+      continue;
     }
-    return jsonResult(
-      alive.map(({ sessionId, fileKey, fileName, pageName, selectionCount }) => ({
-        sessionId,
-        fileKey,
-        fileName,
-        pageName,
-        selectionCount
-      }))
+    const given = req.filter(present);
+    if (given.length === 0) return `\u7F3A\u5C11\u53C2\u6570\uFF1A${req.join(" / ")} \u9700\u4F20\u4E00\u4E2A`;
+    if (given.length > 1) return `\u53C2\u6570\u4E92\u65A5\uFF1A${req.join(" / ")} \u53EA\u80FD\u4F20\u4E00\u4E2A`;
+  }
+  return null;
+}
+var TOOL_REGISTRY, TOOLS;
+var init_tools = __esm({
+  "src/agent/tools/index.ts"() {
+    "use strict";
+    init_export_image();
+    init_get_metadata();
+    init_get_node_dsl();
+    init_get_screenshot();
+    init_get_selected();
+    init_list_sessions();
+    init_shared();
+    TOOL_REGISTRY = {
+      get_selected: getSelected,
+      get_node_dsl: getNodeDsl,
+      get_metadata: getMetadata,
+      export_image: exportImage,
+      get_screenshot: getScreenshot,
+      list_sessions: listSessions
+    };
+    TOOLS = Object.fromEntries(
+      Object.entries(TOOL_REGISTRY).map(([name, def]) => {
+        const requires = def.requires ?? [];
+        const inputSchema = buildInputSchema(requires, def.properties);
+        const base = def.handler ?? ((args, ctx) => run(name, args, ctx?.signal));
+        const handler = (args, ctx) => {
+          const err = requires.length ? validateArgs(requires, args) : null;
+          if (err) return Promise.resolve(errorResult(err));
+          return base(args, ctx);
+        };
+        const resolvedDef = { description: def.description, inputSchema, handler };
+        return [name, { def: resolvedDef, tool: { name, description: def.description, inputSchema } }];
+      })
     );
   }
-};
-
-// src/agent/tools/index.ts
-var TOOL_REGISTRY = {
-  get_selected: getSelected,
-  get_node_dsl: getNodeDsl,
-  get_metadata: getMetadata,
-  export_image: exportImage,
-  get_screenshot: getScreenshot,
-  list_sessions: listSessions
-};
-var TOOLS = Object.fromEntries(
-  Object.entries(TOOL_REGISTRY).map(([name, def]) => {
-    const handler = def.handler ?? ((args, ctx) => run(name, args, ctx?.signal));
-    const resolvedDef = { description: def.description, inputSchema: def.inputSchema, handler };
-    return [name, { def: resolvedDef, tool: { name, description: def.description, inputSchema: def.inputSchema } }];
-  })
-);
+});
 
 // src/agent/mcp.ts
-var INSTRUCTIONS = `Pixso \u8BBE\u8BA1\u7A3F\u8F6C\u4EE3\u7801\u670D\u52A1\u3002\u6309\u7528\u6237\u8F93\u5165\u8DEF\u7531\uFF1A1. \u7ED9\u51FA Pixso \u94FE\u63A5\uFF08\u4EFB\u610F\u57DF\u540D\uFF09\u2192 \u4ECE item-id \u63D0\u53D6 guid\uFF08URL \u89E3\u7801\uFF09\uFF0C\u76F4\u63A5\u8C03 get_node_dsl / get_screenshot / export_image\uFF1B2. \u8BF4"\u6211\u9009\u4E2D\u7684/\u5F53\u524D\u9009\u4E2D\u7684"\u2192 get_selected \u62FF guid\uFF1B\u5176\u4ED6\u4F9D\u8D56\u9009\u533A\u7684\u573A\u666F\u5148 get_selected \u518D\u5411\u7528\u6237\u62A5\u540D\u79F0\u786E\u8BA4\uFF1B3. "\u6837\u5F0F\u8FD8\u539F/\u8BBE\u8BA1\u8FD8\u539F/UI \u8FD8\u539F/\u8BBE\u8BA1\u8F6C\u4EE3\u7801"\u2192 get_node_dsl \u53D6\u7ED3\u6784 + get_screenshot \u53D6\u89C6\u89C9\u53C2\u7167\uFF1B4. "\u5207\u56FE/\u5BFC\u51FA\u56FE\u6807\u6216\u56FE\u7247\u7D20\u6750"\u2192 export_image\uFF08DSL \u91CC\u5DF2\u5E26 img \u7684\u8282\u70B9\u76F4\u63A5\u7528\u5176\u6587\u4EF6\u540D\uFF0C\u4E0D\u8981\u91CD\u590D\u5BFC\u51FA\uFF09\uFF1B5. \u9996\u6B21\u63A5\u89E6\u8BBE\u8BA1\u7A3F/\u53EA\u8981\u7ED3\u6784\u6982\u89C8 \u2192 get_metadata \u62FF\u5168\u6811\u9AA8\u67B6\uFF08\u65E0\u6837\u5F0F\u65E0\u8D44\u6E90\uFF0C\u4F53\u79EF\u6781\u5C0F\uFF09\u5B9A\u4F4D\u76EE\u6807\u8282\u70B9\uFF1B\u7ED3\u6784\u590D\u6742 \u2192 get_node_dsl \u7528 maxDepth \u5206\u6BB5\u4E0B\u63A2\uFF08\u622A\u65AD\u5904 more \u6807\u8BB0 + kidsSummary \u6D45\u9884\u89C8\uFF0C\u6309 id \u4E0B\u94BB\uFF09\uFF1B6. \u751F\u6210\u540E\u5BF9\u6BD4\u8FD8\u539F\u5EA6 \u2192 get_screenshot \u6821\u9A8C\u5FAA\u73AF\uFF1B7. \u591A\u4E2A Pixso \u6587\u4EF6\u540C\u65F6\u6253\u5F00 \u2192 list_sessions + target \u53C2\u6570\u8DEF\u7531\u3002\u786C\u6027\u89C4\u5219\uFF08\u8D44\u6E90\u53D6\u7528/\u7EC4\u4EF6\u6620\u5C04/\u9519\u8BEF\u6062\u590D/\u7981\u6B62\u622A\u56FE\u786C\u7F16\u7801\uFF09\u89C1\u8D44\u6E90 batter://guides/design-to-code\u2014\u2014\u5199\u4EE3\u7801\u524D\u5FC5\u8BFB\u3002`;
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import {
+  CallToolRequestSchema,
+  GetPromptRequestSchema,
+  ListPromptsRequestSchema,
+  ListResourceTemplatesRequestSchema,
+  ListToolsRequestSchema
+} from "@modelcontextprotocol/sdk/types.js";
 function createMcpServer() {
   const server = new McpServer(
-    { name: HUB_NAME, version: VERSION },
+    { name: SERVICE_NAME, version: VERSION },
     { capabilities: { tools: {}, resources: {}, prompts: {} }, instructions: INSTRUCTIONS }
   );
   for (const guide of GUIDES) {
@@ -840,21 +1176,55 @@ function createMcpServer() {
   });
   return server;
 }
+var INSTRUCTIONS;
+var init_mcp = __esm({
+  "src/agent/mcp.ts"() {
+    "use strict";
+    init_config();
+    init_guides();
+    init_prompts();
+    init_tools();
+    INSTRUCTIONS = `Pixso \u8BBE\u8BA1\u7A3F\u8F6C\u4EE3\u7801\u670D\u52A1\u3002\u6309\u7528\u6237\u8F93\u5165\u8DEF\u7531\uFF1A1. \u7ED9\u51FA Pixso \u94FE\u63A5\uFF08\u4EFB\u610F\u57DF\u540D\uFF09\u2192 \u4ECE item-id \u63D0\u53D6 guid\uFF08URL \u89E3\u7801\uFF09\uFF0C\u76F4\u63A5\u8C03 get_node_dsl / get_screenshot / export_image\uFF1B2. \u8BF4"\u6211\u9009\u4E2D\u7684/\u5F53\u524D\u9009\u4E2D\u7684"\u2192 get_selected \u62FF guid\uFF1B\u5176\u4ED6\u4F9D\u8D56\u9009\u533A\u7684\u573A\u666F\u5148 get_selected \u518D\u5411\u7528\u6237\u62A5\u540D\u79F0\u786E\u8BA4\uFF1B3. "\u6837\u5F0F\u8FD8\u539F/\u8BBE\u8BA1\u8FD8\u539F/UI \u8FD8\u539F/\u8BBE\u8BA1\u8F6C\u4EE3\u7801"\u2192 get_node_dsl \u53D6\u7ED3\u6784 + get_screenshot \u53D6\u89C6\u89C9\u53C2\u7167\uFF1B4. "\u5207\u56FE/\u5BFC\u51FA\u56FE\u6807\u6216\u56FE\u7247\u7D20\u6750"\u2192 export_image\uFF08DSL \u91CC\u5DF2\u5E26 img \u7684\u8282\u70B9\u76F4\u63A5\u7528\u5176\u6587\u4EF6\u540D\uFF0C\u4E0D\u8981\u91CD\u590D\u5BFC\u51FA\uFF09\uFF1B5. \u9996\u6B21\u63A5\u89E6\u8BBE\u8BA1\u7A3F/\u53EA\u8981\u7ED3\u6784\u6982\u89C8 \u2192 get_metadata \u62FF\u5168\u6811\u9AA8\u67B6\uFF08\u65E0\u6837\u5F0F\u65E0\u8D44\u6E90\uFF0C\u4F53\u79EF\u6781\u5C0F\uFF09\u5B9A\u4F4D\u76EE\u6807\u8282\u70B9\uFF1B\u7ED3\u6784\u590D\u6742 \u2192 get_node_dsl \u7528 maxDepth \u5206\u6BB5\u4E0B\u63A2\uFF08\u622A\u65AD\u5904 more \u6807\u8BB0 + kidsSummary \u6D45\u9884\u89C8\uFF0C\u6309 id \u4E0B\u94BB\uFF09\uFF1B6. \u751F\u6210\u540E\u5BF9\u6BD4\u8FD8\u539F\u5EA6 \u2192 get_screenshot \u6821\u9A8C\u5FAA\u73AF\uFF1B7. \u591A\u4E2A Pixso \u6587\u4EF6\u540C\u65F6\u6253\u5F00 \u2192 list_sessions + fileKey/sessionId \u53C2\u6570\u8DEF\u7531\uFF08\u8282\u70B9\u7C7B\u5DE5\u5177\u4E8C\u8005\u5FC5\u4F20\u5176\u4E00\uFF09\u3002\u786C\u6027\u89C4\u5219\uFF08\u8D44\u6E90\u53D6\u7528/\u7EC4\u4EF6\u6620\u5C04/\u9519\u8BEF\u6062\u590D/\u7981\u6B62\u622A\u56FE\u786C\u7F16\u7801\uFF09\u89C1\u8D44\u6E90 batter://guides/design-to-code\u2014\u2014\u5199\u4EE3\u7801\u524D\u5FC5\u8BFB\u3002`;
+  }
+});
 
 // src/agent/sessions.ts
-var transports = /* @__PURE__ */ new Map();
 function getMcpTransport(sessionId) {
-  return transports.get(sessionId);
+  const entry = transports.get(sessionId);
+  if (entry) entry.lastSeen = Date.now();
+  return entry?.transport;
 }
 function registerMcpTransport(sessionId, transport) {
-  transports.set(sessionId, transport);
+  transports.set(sessionId, { transport, lastSeen: Date.now() });
   log(`MCP HTTP session initialized: ${sessionId.slice(0, 8)} (total ${transports.size})`);
   transport.onclose = () => {
     if (transport.sessionId) transports.delete(transport.sessionId);
   };
 }
+var transports, sweeper;
+var init_sessions2 = __esm({
+  "src/agent/sessions.ts"() {
+    "use strict";
+    init_config();
+    transports = /* @__PURE__ */ new Map();
+    sweeper = setInterval(() => {
+      const now = Date.now();
+      for (const [id, entry] of transports) {
+        if (now - entry.lastSeen <= config.mcpSessionTtlMs) continue;
+        transports.delete(id);
+        void entry.transport.close().catch(() => {
+        });
+        log(`MCP HTTP session expired: ${id.slice(0, 8)} (total ${transports.size})`);
+      }
+    }, MCP_SESSION_SWEEP_MS);
+    sweeper.unref();
+  }
+});
 
 // src/agent/http.ts
+import { randomUUID as randomUUID2 } from "node:crypto";
+import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
+import { isInitializeRequest } from "@modelcontextprotocol/sdk/types.js";
 function handleMcp(req, res, url) {
   return dispatchRoute(MCP_ROUTES, req, res, url);
 }
@@ -867,95 +1237,54 @@ async function sessionRequestHandler({ req, res }) {
   }
   await transport.handleRequest(req, res);
 }
-var MCP_ROUTES = [
-  {
-    method: "POST",
-    path: "/mcp",
-    handler: async ({ req, res }) => {
-      let body;
-      try {
-        body = await readJsonBody(req);
-      } catch {
-        sendJson(res, 400, { jsonrpc: "2.0", error: { code: -32700, message: "Parse error" }, id: null });
-        return;
-      }
-      const sessionId = req.headers["mcp-session-id"];
-      let transport = sessionId ? getMcpTransport(sessionId) : void 0;
-      if (!transport) {
-        if (!sessionId && isInitializeRequest(body)) {
-          const t = new StreamableHTTPServerTransport({
-            sessionIdGenerator: () => randomUUID2(),
-            onsessioninitialized: (id) => registerMcpTransport(id, t)
-          });
-          await createMcpServer().connect(t);
-          transport = t;
-        } else {
-          sendJson(res, 400, {
-            jsonrpc: "2.0",
-            error: { code: -32e3, message: "Bad Request: missing or unknown MCP session" },
-            id: null
-          });
-          return;
+var MCP_ROUTES;
+var init_http = __esm({
+  "src/agent/http.ts"() {
+    "use strict";
+    init_http_body();
+    init_mcp();
+    init_sessions2();
+    MCP_ROUTES = [
+      {
+        method: "POST",
+        path: "/mcp",
+        handler: async ({ req, res }) => {
+          let body;
+          try {
+            body = await readJsonBody(req);
+          } catch {
+            sendJson(res, 400, { jsonrpc: "2.0", error: { code: -32700, message: "Parse error" }, id: null });
+            return;
+          }
+          const sessionId = req.headers["mcp-session-id"];
+          let transport = sessionId ? getMcpTransport(sessionId) : void 0;
+          if (!transport) {
+            if (!sessionId && isInitializeRequest(body)) {
+              const t = new StreamableHTTPServerTransport({
+                sessionIdGenerator: () => randomUUID2(),
+                onsessioninitialized: (id) => registerMcpTransport(id, t)
+              });
+              await createMcpServer().connect(t);
+              transport = t;
+            } else {
+              sendJson(res, 400, {
+                jsonrpc: "2.0",
+                error: { code: -32e3, message: "Bad Request: missing or unknown MCP session" },
+                id: null
+              });
+              return;
+            }
+          }
+          await transport.handleRequest(req, res, body);
         }
-      }
-      await transport.handleRequest(req, res, body);
-    }
-  },
-  { method: "GET", path: "/mcp", handler: sessionRequestHandler },
-  { method: "DELETE", path: "/mcp", handler: sessionRequestHandler }
-];
-
-// src/install/dist-resolver.ts
-import { existsSync } from "node:fs";
-import { readFile } from "node:fs/promises";
-import { join as join3 } from "node:path";
-import { fileURLToPath } from "node:url";
-function resolvePluginDir() {
-  const candidates = [
-    fileURLToPath(new URL("./plugin/", import.meta.url)),
-    // bundle: dist/index.js → dist/plugin/
-    fileURLToPath(new URL("../../plugin/dist/", import.meta.url)),
-    // bundle 开发: dist/index.js → packages/plugin/dist/
-    fileURLToPath(new URL("../../../plugin/dist/", import.meta.url))
-    // tsx 开发: src/install/ → packages/plugin/dist/
-  ];
-  return candidates.find((p) => existsSync(join3(p, "manifest.json"))) ?? null;
-}
-var resolved = null;
-function pluginDir() {
-  resolved ??= resolvePluginDir();
-  return resolved;
-}
-function hasPluginDist() {
-  return pluginDir() !== null;
-}
-async function pluginManifest() {
-  const dir = pluginDir();
-  if (!dir) return null;
-  const raw = JSON.parse(await readFile(join3(dir, "manifest.json"), "utf8"));
-  raw.networkAccess = {
-    allowedDomains: [`http://localhost:${config.httpPort}`, `http://127.0.0.1:${config.httpPort}`]
-  };
-  return Buffer.from(JSON.stringify(raw, null, 2));
-}
-async function readPluginFile(name) {
-  const dir = pluginDir();
-  if (!dir) return null;
-  try {
-    return await readFile(join3(dir, name));
-  } catch {
-    return null;
+      },
+      { method: "GET", path: "/mcp", handler: sessionRequestHandler },
+      { method: "DELETE", path: "/mcp", handler: sessionRequestHandler }
+    ];
   }
-}
+});
 
 // src/install/template.ts
-var HTML_ESCAPES = {
-  "&": "&amp;",
-  "<": "&lt;",
-  ">": "&gt;",
-  '"': "&quot;",
-  "'": "&#39;"
-};
 function escapeHtml(s) {
   return s.replace(/[&<>"']/g, (c) => HTML_ESCAPES[c]);
 }
@@ -970,12 +1299,33 @@ function renderTemplate(tpl, vars, escape = escapeHtml) {
   };
   return tpl.replace(/\{\{\{\s*(\w+)\s*\}\}\}/g, (_, key) => lookup(key)).replace(/\{\{\s*(\w+)\s*\}\}/g, (_, key) => escape(lookup(key)));
 }
+var HTML_ESCAPES;
+var init_template = __esm({
+  "src/install/template.ts"() {
+    "use strict";
+    HTML_ESCAPES = {
+      "&": "&amp;",
+      "<": "&lt;",
+      ">": "&gt;",
+      '"': "&quot;",
+      "'": "&#39;"
+    };
+  }
+});
 
 // src/install/templates/bookmarklet.txt
-var bookmarklet_default = '// Batter Bridge \u4E66\u7B7E\u6CE8\u5165\u811A\u672C\n// \u5728 Pixso / MasterGo \u7F51\u9875\u7248\u8BBE\u8BA1\u6587\u4EF6\u9875\u9762\u70B9\u51FB\u540E\u6267\u884C\uFF1A\n// \u4ECE\u672C\u670D\u52A1\u62C9\u53D6 manifest + code\uFF0C\u901A\u8FC7\u5BBF\u4E3B\u6CE8\u5165 API \u8FD0\u884C\u63D2\u4EF6\u3002\n// \u670D\u52A1\u4E0D\u53EF\u8FBE\u65F6\u56DE\u9000 localStorage \u7F13\u5B58\uFF08\u4E0A\u6B21\u6210\u529F\u62C9\u53D6\u7684\u63D2\u4EF6\u5305\uFF09\u3002\n// \u6E32\u67D3\u65F6 {{ base }} \u66FF\u6362\u4E3A\u670D\u52A1\u5730\u5740\uFF08JS \u5B57\u7B26\u4E32\u8F6C\u4E49\uFF09\uFF0C\u6574\u4F53 encodeURIComponent \u540E\u4F5C\u4E3A\u4E66\u7B7E href\u3002\n(function () {\n  var SERVER_BASE = "{{ base }}";\n  var CACHE_KEY = "batter-bridge-cache";\n\n  /** \u7528\u5BBF\u4E3B\u9875\u9762\u7684\u6CE8\u5165 API \u542F\u52A8\u63D2\u4EF6 */\n  function startPlugin(codeText, manifestText) {\n    try {\n      var manifest = JSON.parse(manifestText);\n      if (window._FicAppObj && window._FicAppObj.runTestPlugin) {\n        // MasterGo \u5BBF\u4E3B\n        window._FicAppObj.runTestPlugin(manifest, codeText, "", null, { startup: "DEBUG" });\n        return;\n      }\n      if (window.runNewPlugin) {\n        // Pixso \u5BBF\u4E3B\n        window.runNewPlugin(codeText, null, null, { manifest: manifest, plugin: manifest });\n        return;\n      }\n      alert("\u8BF7\u5728 Pixso / MasterGo \u8BBE\u8BA1\u6587\u4EF6\u9875\u9762\u70B9\u51FB\u6B64\u4E66\u7B7E");\n    } catch (err) {\n      alert("\u63D2\u4EF6\u542F\u52A8\u5931\u8D25\uFF1A" + ((err && err.message) || err));\n    }\n  }\n\n  /** \u5C1D\u8BD5\u7528\u7F13\u5B58\u7684\u63D2\u4EF6\u5305\u542F\u52A8\uFF1B\u65E0\u7F13\u5B58\u8FD4\u56DE false */\n  function startFromCache() {\n    try {\n      var cached = JSON.parse(localStorage.getItem(CACHE_KEY) || "null");\n      if (cached && cached.manifest && cached.code) {\n        startPlugin(cached.code, cached.manifest);\n        return true;\n      }\n    } catch (err) {\n      // \u7F13\u5B58\u635F\u574F\uFF1A\u89C6\u4E3A\u65E0\u7F13\u5B58\n    }\n    return false;\n  }\n\n  function saveCache(manifestText, codeText) {\n    try {\n      localStorage.setItem(CACHE_KEY, JSON.stringify({ manifest: manifestText, code: codeText }));\n    } catch (err) {\n      // \u5B58\u50A8\u8D85\u9650\u7B49\uFF1A\u7F13\u5B58\u53EA\u662F\u79BB\u7EBF\u515C\u5E95\uFF0C\u5931\u8D25\u53EF\u5FFD\u7565\n    }\n  }\n\n  function fetchText(path) {\n    return fetch(SERVER_BASE + path + "?t=" + Date.now(), { cache: "no-store" }).then(\n      function (res) {\n        if (!res.ok) throw new Error("HTTP " + res.status);\n        return res.text();\n      },\n    );\n  }\n\n  Promise.all([fetchText("manifest.json"), fetchText("code.js")])\n    .then(function (texts) {\n      var manifestText = texts[0];\n      var codeText = texts[1];\n      saveCache(manifestText, codeText);\n      startPlugin(codeText, manifestText);\n    })\n    .catch(function () {\n      if (!startFromCache()) {\n        alert("\u65E0\u6CD5\u8FDE\u63A5 batter-pixso-mcp \u670D\u52A1\uFF08" + SERVER_BASE + "\uFF09\uFF0C\u8BF7\u786E\u8BA4\u670D\u52A1\u5DF2\u542F\u52A8");\n      }\n    });\n})();\n';
+var bookmarklet_default;
+var init_bookmarklet = __esm({
+  "src/install/templates/bookmarklet.txt"() {
+    bookmarklet_default = '// Batter Bridge \u4E66\u7B7E\u6CE8\u5165\u811A\u672C\n// \u5728 Pixso / MasterGo \u7F51\u9875\u7248\u8BBE\u8BA1\u6587\u4EF6\u9875\u9762\u70B9\u51FB\u540E\u6267\u884C\uFF1A\n// \u4ECE\u672C\u670D\u52A1\u62C9\u53D6 manifest + code\uFF0C\u901A\u8FC7\u5BBF\u4E3B\u6CE8\u5165 API \u8FD0\u884C\u63D2\u4EF6\u3002\n// \u670D\u52A1\u4E0D\u53EF\u8FBE\u65F6\u56DE\u9000 localStorage \u7F13\u5B58\uFF08\u4E0A\u6B21\u6210\u529F\u62C9\u53D6\u7684\u63D2\u4EF6\u5305\uFF09\u3002\n// \u6E32\u67D3\u65F6 {{ base }} \u66FF\u6362\u4E3A\u670D\u52A1\u5730\u5740\uFF08JS \u5B57\u7B26\u4E32\u8F6C\u4E49\uFF09\uFF0C\u6574\u4F53 encodeURIComponent \u540E\u4F5C\u4E3A\u4E66\u7B7E href\u3002\n(function () {\n  var SERVER_BASE = "{{ base }}";\n  var CACHE_KEY = "batter-bridge-cache";\n\n  /** \u7528\u5BBF\u4E3B\u9875\u9762\u7684\u6CE8\u5165 API \u542F\u52A8\u63D2\u4EF6 */\n  function startPlugin(codeText, manifestText) {\n    try {\n      var manifest = JSON.parse(manifestText);\n      if (window._FicAppObj && window._FicAppObj.runTestPlugin) {\n        // MasterGo \u5BBF\u4E3B\n        window._FicAppObj.runTestPlugin(manifest, codeText, "", null, { startup: "DEBUG" });\n        return;\n      }\n      if (window.runNewPlugin) {\n        // Pixso \u5BBF\u4E3B\n        window.runNewPlugin(codeText, null, null, { manifest: manifest, plugin: manifest });\n        return;\n      }\n      alert("\u8BF7\u5728 Pixso / MasterGo \u8BBE\u8BA1\u6587\u4EF6\u9875\u9762\u70B9\u51FB\u6B64\u4E66\u7B7E");\n    } catch (err) {\n      alert("\u63D2\u4EF6\u542F\u52A8\u5931\u8D25\uFF1A" + ((err && err.message) || err));\n    }\n  }\n\n  /** \u5C1D\u8BD5\u7528\u7F13\u5B58\u7684\u63D2\u4EF6\u5305\u542F\u52A8\uFF1B\u65E0\u7F13\u5B58\u8FD4\u56DE false */\n  function startFromCache() {\n    try {\n      var cached = JSON.parse(localStorage.getItem(CACHE_KEY) || "null");\n      if (cached && cached.manifest && cached.code) {\n        startPlugin(cached.code, cached.manifest);\n        return true;\n      }\n    } catch (err) {\n      // \u7F13\u5B58\u635F\u574F\uFF1A\u89C6\u4E3A\u65E0\u7F13\u5B58\n    }\n    return false;\n  }\n\n  function saveCache(manifestText, codeText) {\n    try {\n      localStorage.setItem(CACHE_KEY, JSON.stringify({ manifest: manifestText, code: codeText }));\n    } catch (err) {\n      // \u5B58\u50A8\u8D85\u9650\u7B49\uFF1A\u7F13\u5B58\u53EA\u662F\u79BB\u7EBF\u515C\u5E95\uFF0C\u5931\u8D25\u53EF\u5FFD\u7565\n    }\n  }\n\n  function fetchText(path) {\n    return fetch(SERVER_BASE + path + "?t=" + Date.now(), { cache: "no-store" }).then(\n      function (res) {\n        if (!res.ok) throw new Error("HTTP " + res.status);\n        return res.text();\n      },\n    );\n  }\n\n  Promise.all([fetchText("manifest.json"), fetchText("code.js")])\n    .then(function (texts) {\n      var manifestText = texts[0];\n      var codeText = texts[1];\n      saveCache(manifestText, codeText);\n      startPlugin(codeText, manifestText);\n    })\n    .catch(function () {\n      if (!startFromCache()) {\n        alert("\u65E0\u6CD5\u8FDE\u63A5 batter-pixso-mcp \u670D\u52A1\uFF08" + SERVER_BASE + "\uFF09\uFF0C\u8BF7\u786E\u8BA4\u670D\u52A1\u5DF2\u542F\u52A8");\n      }\n    });\n})();\n';
+  }
+});
 
 // src/install/templates/install-page.html
-var install_page_default = `<!DOCTYPE html>
+var install_page_default;
+var init_install_page = __esm({
+  "src/install/templates/install-page.html"() {
+    install_page_default = `<!DOCTYPE html>
 <html lang="zh-CN">
 <head>
 <meta charset="utf-8">
@@ -1308,15 +1658,17 @@ var install_page_default = `<!DOCTYPE html>
           <pre id="cfg">{
   "mcpServers": {
     "batter-pixso": {
-      "command": "npx",
-      "args": ["-y", "batter-pixso-mcp"],
-      "env": { "HTTP_PORT": "{{ httpPort }}" }
+      "url": "{{ mcpUrl }}"
     }
   }
 }</pre>
           <button class="copy" id="copy" type="button">\u590D\u5236</button>
         </div>
-        <p class="note">\u7C98\u8D34\u5230 Cursor / Claude Code \u7684 MCP \u914D\u7F6E\u6587\u4EF6\u3002\u7CFB\u7EDF Node \u4F4E\u4E8E 18 \u65F6\u6539\u7528 volta \u5305\u88F9\u542F\u52A8\uFF0C\u8BE6\u89C1 README\u3002</p>
+        <p class="note">
+          \u7C98\u8D34\u5230 Cursor / Cherry Studio \u7B49\u7684 MCP \u914D\u7F6E\u6587\u4EF6\uFF1BClaude Code \u6267\u884C
+          <code>{{ claudeAddCommand }}</code>\u3002
+          \u670D\u52A1\u672A\u542F\u52A8\u65F6\u5148\u5728\u7EC8\u7AEF\u6267\u884C <code>npx batter-pixso-mcp</code>\uFF08Windows \u53EF\u7528 <code>--setup</code> \u6CE8\u518C\u5F00\u673A\u81EA\u542F\uFF09\u3002
+        </p>
       </div>
     </div>
 
@@ -1368,6 +1720,7 @@ copyBtn.addEventListener("click", function () {
   if (navigator.clipboard && navigator.clipboard.writeText) {
     navigator.clipboard.writeText(text).then(done, done);
   } else {
+    // \u515C\u5E95\uFF1A\u65E0 clipboard API \u7684\u73AF\u5883\uFF08\u53CC\u6838\u6D4F\u89C8\u5668\u517C\u5BB9\u6A21\u5F0F\u7B49\uFF09
     var ta = document.createElement("textarea");
     ta.value = text;
     document.body.appendChild(ta);
@@ -1381,6 +1734,8 @@ copyBtn.addEventListener("click", function () {
 </body>
 </html>
 `;
+  }
+});
 
 // src/install/page.ts
 function bookmarkletHref(base) {
@@ -1388,26 +1743,27 @@ function bookmarkletHref(base) {
   return `javascript:${encodeURIComponent(source)}`;
 }
 function renderInstallPage() {
-  const base = `${hubBaseUrl()}/`;
+  const base = `${serviceBaseUrl()}/`;
   return renderTemplate(install_page_default, {
     version: VERSION,
     href: bookmarkletHref(base),
     base,
-    httpPort: config.httpPort
+    mcpUrl: mcpUrl(),
+    claudeAddCommand: claudeAddCommand()
   });
 }
+var init_page = __esm({
+  "src/install/page.ts"() {
+    "use strict";
+    init_config();
+    init_template();
+    init_bookmarklet();
+    init_install_page();
+  }
+});
 
 // src/install/zip.ts
 import { Buffer as Buffer2 } from "node:buffer";
-var CRC_TABLE = (() => {
-  const table = new Uint32Array(256);
-  for (let n = 0; n < 256; n++) {
-    let c = n;
-    for (let k = 0; k < 8; k++) c = c & 1 ? 3988292384 ^ c >>> 1 : c >>> 1;
-    table[n] = c >>> 0;
-  }
-  return table;
-})();
 function crc32(buf) {
   let crc = 4294967295;
   for (const byte of buf) crc = CRC_TABLE[(crc ^ byte) & 255] ^ crc >>> 8;
@@ -1463,9 +1819,23 @@ function buildZip(entries) {
   eocd.writeUInt32LE(offset, 16);
   return Buffer2.concat([...chunks, centralBuf, eocd]);
 }
+var CRC_TABLE;
+var init_zip = __esm({
+  "src/install/zip.ts"() {
+    "use strict";
+    CRC_TABLE = (() => {
+      const table = new Uint32Array(256);
+      for (let n = 0; n < 256; n++) {
+        let c = n;
+        for (let k = 0; k < 8; k++) c = c & 1 ? 3988292384 ^ c >>> 1 : c >>> 1;
+        table[n] = c >>> 0;
+      }
+      return table;
+    })();
+  }
+});
 
 // src/install/api.ts
-var NO_DIST = "plugin dist not found\uFF08\u8FD0\u884C npm run build \u751F\u6210\uFF09";
 function handleInstall(req, res, url) {
   return dispatchRoute(INSTALL_ROUTES, req, res, url);
 }
@@ -1473,168 +1843,271 @@ function sendBinary(res, buf, contentType) {
   res.writeHead(200, { "Content-Type": contentType, "Cache-Control": "no-store" });
   res.end(buf);
 }
-var PLUGIN_FILE_ROUTES = [
-  { path: "/code.js", file: "code.js", type: "text/javascript; charset=utf-8" },
-  { path: "/ui.html", file: "ui.html", type: "text/html; charset=utf-8" }
-].map(({ path, file, type }) => ({
-  method: "GET",
-  path,
-  handler: async ({ res }) => {
-    const buf = await readPluginFile(file);
-    if (!buf) {
-      sendJson(res, 404, { error: hasPluginDist() ? "not found" : NO_DIST });
-      return;
-    }
-    sendBinary(res, buf, type);
-  }
-}));
-var INSTALL_ROUTES = [
-  {
-    method: "GET",
-    path: "/",
-    handler: ({ res }) => {
-      res.writeHead(200, { "Content-Type": "text/html; charset=utf-8" });
-      res.end(renderInstallPage());
-    }
-  },
-  {
-    method: "GET",
-    path: "/manifest.json",
-    handler: async ({ res }) => {
-      const buf = await pluginManifest();
-      if (!buf) {
-        sendJson(res, 404, { error: NO_DIST });
-        return;
+var NO_DIST, PLUGIN_FILE_ROUTES, INSTALL_ROUTES;
+var init_api = __esm({
+  "src/install/api.ts"() {
+    "use strict";
+    init_http_body();
+    init_dist_resolver();
+    init_page();
+    init_zip();
+    NO_DIST = "plugin dist not found\uFF08\u8FD0\u884C npm run build \u751F\u6210\uFF09";
+    PLUGIN_FILE_ROUTES = [
+      { path: "/code.js", file: "code.js", type: "text/javascript; charset=utf-8" },
+      { path: "/ui.html", file: "ui.html", type: "text/html; charset=utf-8" }
+    ].map(({ path, file, type }) => ({
+      method: "GET",
+      path,
+      handler: async ({ res }) => {
+        const buf = await readPluginFile(file);
+        if (!buf) {
+          sendJson(res, 404, { error: hasPluginDist() ? "not found" : NO_DIST });
+          return;
+        }
+        sendBinary(res, buf, type);
       }
-      sendBinary(res, buf, "application/json; charset=utf-8");
-    }
-  },
-  ...PLUGIN_FILE_ROUTES,
-  {
-    method: "GET",
-    path: "/plugin.zip",
-    handler: async ({ res }) => {
-      if (!hasPluginDist()) {
-        sendJson(res, 404, { error: NO_DIST });
-        return;
+    }));
+    INSTALL_ROUTES = [
+      {
+        method: "GET",
+        path: "/",
+        handler: ({ res }) => {
+          res.writeHead(200, { "Content-Type": "text/html; charset=utf-8" });
+          res.end(renderInstallPage());
+        }
+      },
+      {
+        method: "GET",
+        path: "/manifest.json",
+        handler: async ({ res }) => {
+          const buf = await pluginManifest();
+          if (!buf) {
+            sendJson(res, 404, { error: NO_DIST });
+            return;
+          }
+          sendBinary(res, buf, "application/json; charset=utf-8");
+        }
+      },
+      ...PLUGIN_FILE_ROUTES,
+      {
+        method: "GET",
+        path: "/plugin.zip",
+        handler: async ({ res }) => {
+          if (!hasPluginDist()) {
+            sendJson(res, 404, { error: NO_DIST });
+            return;
+          }
+          try {
+            const [manifest, code, ui] = await Promise.all([
+              pluginManifest(),
+              readPluginFile("code.js"),
+              readPluginFile("ui.html")
+            ]);
+            const zip = buildZip([
+              { name: "manifest.json", data: manifest },
+              { name: "code.js", data: code },
+              { name: "ui.html", data: ui }
+            ]);
+            res.writeHead(200, {
+              "Content-Type": "application/zip",
+              "Content-Disposition": 'attachment; filename="batter-pixso-bridge.zip"'
+            });
+            res.end(zip);
+          } catch {
+            sendJson(res, 500, { error: "zip build failed" });
+          }
+        }
+      }
+    ];
+  }
+});
+
+// src/plugin/assets.ts
+import { createHash } from "node:crypto";
+import { mkdir, readdir, stat, unlink, writeFile } from "node:fs/promises";
+import { join as join4 } from "node:path";
+async function saveAsset(bytes, format) {
+  dirReady ??= mkdir(ASSETS_DIR, { recursive: true });
+  await dirReady;
+  const ext = EXT_BY_FORMAT[format.toUpperCase()] ?? ".bin";
+  const name = `${createHash("sha1").update(bytes).digest("hex").slice(0, 16)}${ext}`;
+  await writeFile(join4(ASSETS_DIR, name), bytes);
+  log(`asset saved: ${name} (${bytes.length} bytes)`);
+  return name;
+}
+function substituteAssets(result, assets) {
+  if (!assets.length) return result;
+  const nameByKey = new Map(assets.map((a) => [a.key, a.name]));
+  return JSON.parse(
+    JSON.stringify(
+      result,
+      (_k, v) => typeof v === "string" ? nameByKey.get(v) ?? v : v
+    )
+  );
+}
+async function cleanOldAssets(ttlMs) {
+  let removed = 0;
+  const cutoff = Date.now() - ttlMs;
+  let names;
+  try {
+    names = await readdir(ASSETS_DIR);
+  } catch {
+    return 0;
+  }
+  const expired = await Promise.all(
+    names.map(async (name) => {
+      try {
+        const p = join4(ASSETS_DIR, name);
+        const s = await stat(p);
+        return s.isFile() && s.mtimeMs < cutoff ? p : null;
+      } catch {
+        return null;
       }
+    })
+  );
+  await Promise.all(
+    expired.filter((p) => p !== null).map(async (p) => {
       try {
-        const [manifest, code, ui] = await Promise.all([
-          pluginManifest(),
-          readPluginFile("code.js"),
-          readPluginFile("ui.html")
-        ]);
-        const zip = buildZip([
-          { name: "manifest.json", data: manifest },
-          { name: "code.js", data: code },
-          { name: "ui.html", data: ui }
-        ]);
-        res.writeHead(200, {
-          "Content-Type": "application/zip",
-          "Content-Disposition": 'attachment; filename="batter-pixso-bridge.zip"'
-        });
-        res.end(zip);
+        await unlink(p);
+        removed++;
       } catch {
-        sendJson(res, 500, { error: "zip build failed" });
       }
-    }
+    })
+  );
+  if (removed > 0) log(`assets cleanup: removed ${removed} expired file(s)`);
+  return removed;
+}
+function scheduleAssetsSweep(ttlMs) {
+  void cleanOldAssets(ttlMs);
+  const sweeper2 = setInterval(() => void cleanOldAssets(ttlMs), ASSET_SWEEP_INTERVAL_MS);
+  sweeper2.unref();
+}
+var EXT_BY_FORMAT, dirReady;
+var init_assets = __esm({
+  "src/plugin/assets.ts"() {
+    "use strict";
+    init_config();
+    EXT_BY_FORMAT = {
+      PNG: ".png",
+      SVG: ".svg",
+      JPG: ".jpg",
+      JPEG: ".jpg",
+      WEBP: ".webp",
+      PDF: ".pdf"
+      // export_image 尊重设计师导出标记，标记可能指定 PDF
+    };
+    dirReady = null;
   }
-];
+});
 
 // src/plugin/api.ts
 function handlePluginApi(req, res, url) {
   return dispatchRoute(PLUGIN_ROUTES, req, res, url);
 }
-var PLUGIN_ROUTES = [
-  {
-    method: "POST",
-    path: "/sessions/register",
-    handler: async ({ req, res }) => {
-      sendJson(res, 201, sessions.register(await readJsonBody(req)));
-    }
-  },
-  {
-    method: "POST",
-    path: "/context",
-    handler: async ({ req, res, url }) => {
-      const session = url.searchParams.get("session");
-      if (!session) {
-        sendJson(res, 400, { error: "missing session" });
-        return;
-      }
-      const meta = await readJsonBody(req);
-      if (!sessions.updateContext(session, meta)) {
-        sendJson(res, 404, { error: "unknown_session" });
-        return;
-      }
-      sendJson(res, 200, { ok: true });
-    }
-  },
-  {
-    method: "GET",
-    path: "/commands/stream",
-    handler: ({ req, res, url }) => {
-      const session = url.searchParams.get("session");
-      if (!session || !sessions.setConnected(session, true)) {
-        sendJson(res, 404, { error: "unknown_session" });
-        return;
-      }
-      res.writeHead(200, {
-        "Content-Type": "text/event-stream; charset=utf-8",
-        "Cache-Control": "no-store",
-        Connection: "keep-alive"
-      });
-      res.write(": connected\n\n");
-      const unsubscribe = commandBus.subscribe(session, (command) => {
-        res.write(`data: ${JSON.stringify({ command })}
+var PLUGIN_ROUTES;
+var init_api2 = __esm({
+  "src/plugin/api.ts"() {
+    "use strict";
+    init_config();
+    init_http_body();
+    init_assets();
+    init_command_bus();
+    init_sessions();
+    PLUGIN_ROUTES = [
+      {
+        method: "POST",
+        path: "/sessions/register",
+        handler: async ({ req, res }) => {
+          sendJson(res, 201, sessions.register(await readJsonBody(req)));
+        }
+      },
+      {
+        method: "POST",
+        path: "/context",
+        handler: async ({ req, res, url }) => {
+          const session = url.searchParams.get("session");
+          if (!session) {
+            sendJson(res, 400, { error: "missing session" });
+            return;
+          }
+          const meta = await readJsonBody(req);
+          if (!sessions.updateContext(session, meta)) {
+            sendJson(res, 404, { error: "unknown_session" });
+            return;
+          }
+          sendJson(res, 200, { ok: true });
+        }
+      },
+      {
+        method: "GET",
+        path: "/commands/stream",
+        handler: ({ req, res, url }) => {
+          const session = url.searchParams.get("session");
+          if (!session || !sessions.setConnected(session, true)) {
+            sendJson(res, 404, { error: "unknown_session" });
+            return;
+          }
+          res.writeHead(200, {
+            "Content-Type": "text/event-stream; charset=utf-8",
+            "Cache-Control": "no-store",
+            Connection: "keep-alive"
+          });
+          res.write(": connected\n\n");
+          const unsubscribe = commandBus.subscribe(session, (command) => {
+            res.write(`data: ${JSON.stringify({ command })}
 
 `);
-      });
-      const heartbeat = setInterval(() => {
-        sessions.touchSeen(session);
-        res.write(": ping\n\n");
-      }, 15e3);
-      req.on("close", () => {
-        clearInterval(heartbeat);
-        unsubscribe();
-        sessions.setConnected(session, false);
-        log(`SSE channel closed: session ${session.slice(0, 8)}`);
-      });
-    }
-  },
-  {
-    method: "POST",
-    path: "/commands/:id/result",
-    handler: async ({ req, res, params }) => {
-      const payload = await readJsonBody(req);
-      const result = payload.ok && payload.assets?.length ? substituteAssets(payload.result, payload.assets) : payload.result;
-      const found = commandBus.complete(params["id"], payload.ok, payload.ok ? result : payload.error);
-      sendJson(res, found ? 200 : 404, found ? { ok: true } : { error: "unknown command" });
-    }
-  },
-  {
-    method: "POST",
-    path: "/assets",
-    handler: async ({ req, res, url }) => {
-      try {
-        const name = await saveAsset(await readBody(req), url.searchParams.get("format") ?? "PNG");
-        sendJson(res, 201, { name });
-      } catch {
-        sendJson(res, 500, { error: "asset save failed" });
+          });
+          const teardown = () => {
+            clearInterval(heartbeat);
+            unsubscribe();
+            sessions.setConnected(session, false);
+          };
+          const heartbeat = setInterval(() => {
+            if (!res.write(": ping\n\n")) {
+              teardown();
+              res.end();
+              log(`SSE ghost reaped: session ${session.slice(0, 8)}`);
+              return;
+            }
+            sessions.touchSeen(session);
+          }, SSE_HEARTBEAT_MS);
+          req.on("close", () => {
+            teardown();
+            log(`SSE channel closed: session ${session.slice(0, 8)}`);
+          });
+        }
+      },
+      {
+        method: "POST",
+        path: "/commands/:id/result",
+        handler: async ({ req, res, params }) => {
+          const payload = await readJsonBody(req);
+          const result = payload.ok && payload.assets?.length ? substituteAssets(payload.result, payload.assets) : payload.result;
+          const found = commandBus.complete(params["id"], payload.ok, payload.ok ? result : payload.error);
+          sendJson(res, found ? 200 : 404, found ? { ok: true } : { error: "unknown command" });
+        }
+      },
+      {
+        method: "POST",
+        path: "/assets",
+        handler: async ({ req, res, url }) => {
+          try {
+            const name = await saveAsset(await readBody(req), url.searchParams.get("format") ?? "PNG");
+            sendJson(res, 201, { name });
+          } catch {
+            sendJson(res, 500, { error: "asset save failed" });
+          }
+        }
       }
-    }
+    ];
   }
-];
+});
 
 // src/http.ts
-var lastActivity = Date.now();
-function getLastActivity() {
-  return lastActivity;
-}
-var ROUTES = [handleInstall, handleMcp, handlePluginApi];
+import { createServer } from "node:http";
 function startHttpServer() {
   const server = createServer((req, res) => {
-    lastActivity = Date.now();
     res.setHeader("Access-Control-Allow-Origin", "*");
     res.setHeader("Access-Control-Allow-Methods", "GET, POST, DELETE, OPTIONS");
     res.setHeader("Access-Control-Allow-Headers", "Content-Type, mcp-session-id");
@@ -1649,7 +2122,7 @@ function startHttpServer() {
       const all = sessions.list();
       sendJson(res, 200, {
         ok: true,
-        name: HUB_NAME,
+        name: SERVICE_NAME,
         pid: process.pid,
         version: VERSION,
         pluginsOnline: all.filter((s) => s.online).length
@@ -1673,161 +2146,141 @@ function startHttpServer() {
     });
     server.listen(config.httpPort, "127.0.0.1", () => {
       log(`plugin HTTP + MCP server on http://127.0.0.1:${config.httpPort} (MCP endpoint: /mcp, pid ${process.pid})`);
+      scheduleAssetsSweep(config.assetTtlMs);
       resolve(server);
     });
   });
 }
+var ROUTES;
+var init_http2 = __esm({
+  "src/http.ts"() {
+    "use strict";
+    init_http();
+    init_config();
+    init_http_body();
+    init_api();
+    init_api2();
+    init_assets();
+    init_sessions();
+    ROUTES = [handleInstall, handleMcp, handlePluginApi];
+  }
+});
 
-// src/process/hub.ts
-async function runHub() {
+// src/cli/serve.ts
+var serve_exports = {};
+__export(serve_exports, {
+  serve: () => serve
+});
+async function serve() {
+  const { state, health } = await probeService();
+  if (state === "alive" && health?.version === VERSION) {
+    printUsage();
+    return;
+  }
+  if (state === "alive") {
+    throw new Error(
+      `\u670D\u52A1\u5DF2\u5728\u8FD0\u884C\u4E14\u7248\u672C\u4E0D\u7B26\uFF08\u8FD0\u884C ${health?.version} / \u5F53\u524D ${VERSION}\uFF09\u2014\u2014\u5148\u6267\u884C --stop \u505C\u6B62\u65E7\u7248\u672C\u518D\u542F\u52A8`
+    );
+  }
+  if (state === "hung" || state === "foreign") {
+    throw serviceStateError(state);
+  }
   const server = await startHttpServer();
   if (!server) {
-    log(`\u7AEF\u53E3 ${config.httpPort} \u5DF2\u6709 hub \u5728\u8FD0\u884C\uFF0C\u672C\u8FDB\u7A0B\u9000\u51FA`);
-    process.exit(0);
-  }
-  log(`hub ready (idle TTL ${config.hubIdleMs / 6e4}min)`);
-  void cleanOldAssets(config.assetTtlMs);
-  let tick = 0;
-  const watchdog = setInterval(() => {
-    const idle = Date.now() - getLastActivity();
-    const anyPluginOnline = sessions.list().some((s) => s.online);
-    if (idle > config.hubIdleMs && !anyPluginOnline) {
-      log(`\u7A7A\u95F2 ${Math.round(idle / 6e4)} \u5206\u949F\u4E14\u65E0\u5728\u7EBF\u63D2\u4EF6\uFF0Chub \u81EA\u52A8\u9000\u51FA`);
-      process.exit(0);
-    }
-    if (++tick % 60 === 0) void cleanOldAssets(config.assetTtlMs);
-  }, 6e4);
-  watchdog.unref();
-}
-
-// src/process/stdio-proxy.ts
-import { Client } from "@modelcontextprotocol/sdk/client/index.js";
-import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js";
-import { Server } from "@modelcontextprotocol/sdk/server/index.js";
-import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
-import { ResultSchema } from "@modelcontextprotocol/sdk/types.js";
-
-// src/process/hub-process.ts
-import { spawn } from "node:child_process";
-import { closeSync, openSync } from "node:fs";
-import { tmpdir as tmpdir2 } from "node:os";
-import { join as join4 } from "node:path";
-import { fileURLToPath as fileURLToPath2 } from "node:url";
-async function probeHub() {
-  try {
-    const res = await fetch(`${hubBaseUrl()}/health`, { signal: AbortSignal.timeout(1500) });
-    if (!res.ok) return "foreign";
-    const body = await res.json();
-    if (body.ok === true && body.name === HUB_NAME) return "alive";
-    if (body.ok === true) return "legacy";
-    return "foreign";
-  } catch {
-    return "down";
-  }
-}
-var PORT_FIX_HINT = `\u7528 netstat -ano | findstr :${config.httpPort} \u67E5\u5230 PID \u540E taskkill /PID <pid> /F \u7ED3\u675F\uFF0C\u518D\u91CD\u8BD5`;
-function hubStateError(state) {
-  if (state === "legacy") {
-    return new Error(
-      `\u7AEF\u53E3 ${config.httpPort} \u4E0A\u662F\u65E7\u7248\u672C batter-pixso-mcp \u5B9E\u4F8B\uFF08\u4E0D\u652F\u6301\u591A agent \u590D\u7528\uFF09\u3002${PORT_FIX_HINT}`
+    throw new Error(
+      `\u7AEF\u53E3 ${config.httpPort} \u5728\u542F\u52A8\u77AC\u95F4\u88AB\u5360\u7528\uFF08\u53EF\u80FD\u662F\u767B\u5F55\u81EA\u542F\u5B9E\u4F8B\u62A2\u5148\u542F\u52A8\u2014\u2014\u91CD\u8DD1\u672C\u547D\u4EE4\u5373\u53EF\u81EA\u52A8\u8BC6\u522B\uFF1B\u82E5\u6301\u7EED\u88AB\u5360\uFF0C${PORT_FIX_HINT}\uFF09`
     );
   }
-  return new Error(`\u7AEF\u53E3 ${config.httpPort} \u88AB\u5176\u4ED6\u7A0B\u5E8F\u5360\u7528\u3002${PORT_FIX_HINT}\uFF0C\u6216\u4FEE\u6539 HTTP_PORT \u6362\u7AEF\u53E3`);
+  printUsage();
+  log("\u524D\u53F0\u8FD0\u884C\u4E2D\uFF1A\u6B64\u7A97\u53E3/\u8FDB\u7A0B\u9700\u4FDD\u6301\uFF08Ctrl+C \u505C\u6B62\u670D\u52A1\uFF09\uFF1B\u514D\u7A97\u53E3\u7528 --setup \u6CE8\u518C\u5F00\u673A\u81EA\u542F");
 }
-var HUB_LOG = join4(tmpdir2(), "batter-pixso-mcp-hub.log");
-function spawnHub() {
-  const out = openSync(HUB_LOG, "a");
-  const entry = process.argv[1] ?? fileURLToPath2(import.meta.url);
-  const SKIP_FLAGS = /* @__PURE__ */ new Set(["--eval", "-e", "--print", "-p", "--watch", "--watch-preserve-output"]);
-  const execArgv = process.execArgv.filter(
-    (a, i, arr) => !SKIP_FLAGS.has(a) && !(i > 0 && SKIP_FLAGS.has(arr[i - 1]))
+function printUsage() {
+  const url = mcpUrl();
+  console.log(
+    [
+      `batter-pixso-mcp v${VERSION} \u2014 \u670D\u52A1\u8FD0\u884C\u4E2D\uFF1A${serviceBaseUrl()}`,
+      ``,
+      `MCP \u5BA2\u6237\u7AEF\u914D\u7F6E\uFF08URL \u76F4\u8FDE\uFF0C\u4E00\u4E2A\u5730\u5740\u5168\u5BA2\u6237\u7AEF\u901A\u7528\uFF09\uFF1A`,
+      ``,
+      `  Claude Code\uFF08\u4E00\u884C\u547D\u4EE4\uFF09\uFF1A`,
+      `    ${claudeAddCommand()}`,
+      ``,
+      `  \u901A\u7528 JSON\uFF08Cursor / Cherry Studio \u7B49\uFF09\uFF1A`,
+      `    { "mcpServers": { "batter-pixso": { "url": "${url}" } } }`,
+      ``,
+      `\u63D2\u4EF6\u5B89\u88C5\uFF1A\u6D4F\u89C8\u5668\u6253\u5F00 ${serviceBaseUrl()}/ \u6309\u5F15\u5BFC\u5B89\u88C5`,
+      `\u5F00\u673A\u81EA\u542F\uFF1Anpx batter-pixso-mcp --setup\uFF08Windows\uFF09`,
+      `\u505C\u6B62\u670D\u52A1\uFF1Anpx batter-pixso-mcp --stop`
+    ].join("\n")
   );
-  const child = spawn(process.execPath, [...execArgv, entry, "--hub"], {
-    detached: true,
-    stdio: ["ignore", out, out],
-    windowsHide: true,
-    env: { ...process.env }
-  });
-  child.unref();
-  closeSync(out);
-  log(`hub spawned (pid ${child.pid}), log: ${HUB_LOG}`);
 }
-async function waitForHub(timeoutMs = 15e3) {
-  const deadline = Date.now() + timeoutMs;
-  for (; ; ) {
-    const state = await probeHub();
-    if (state === "alive") return;
-    if (state !== "down") throw hubStateError(state);
-    if (Date.now() > deadline) throw new Error(`\u7B49\u5F85 hub \u5C31\u7EEA\u8D85\u65F6\uFF08${timeoutMs / 1e3}s\uFF09`);
-    await new Promise((r) => setTimeout(r, 200));
+var init_serve = __esm({
+  "src/cli/serve.ts"() {
+    "use strict";
+    init_config();
+    init_http2();
+    init_service();
   }
-}
+});
 
-// src/process/stdio-proxy.ts
-async function startStdioProxy() {
-  const mcpUrl = `${hubBaseUrl()}/mcp`;
-  let upstream = null;
-  async function connectUpstream() {
-    const client = new Client(
-      { name: "batter-pixso-mcp-proxy", version: VERSION },
-      { capabilities: {} }
-    );
-    await client.connect(new StreamableHTTPClientTransport(new URL(mcpUrl)));
-    return client;
-  }
-  async function ensureUpstream() {
-    if (upstream) return upstream;
-    const state = await probeHub();
-    if (state === "down") spawnHub();
-    if (state === "legacy" || state === "foreign") throw hubStateError(state);
-    await waitForHub();
-    upstream = await connectUpstream();
-    log(`proxy connected to ${mcpUrl}`);
-    return upstream;
-  }
-  async function callWithRecovery(fn) {
-    const client = await ensureUpstream();
-    try {
-      return await fn(client);
-    } catch (err) {
-      const alive = await client.ping().then(
-        () => true,
-        () => false
-      );
-      if (alive) throw err;
-      log("hub \u4F1A\u8BDD\u5931\u8054\uFF0C\u91CD\u5EFA\u540E\u91CD\u8BD5\u2026");
-      upstream = null;
-      const rebuilt = await ensureUpstream();
-      return await fn(rebuilt);
+// src/cli/index.ts
+init_config();
+
+// src/cli/commands.ts
+init_config();
+var COMMANDS = [
+  {
+    flags: ["--stop"],
+    summary: "\u505C\u6B62\u6B63\u5728\u8FD0\u884C\u7684\u670D\u52A1",
+    run: async () => (await Promise.resolve().then(() => (init_service(), service_exports))).stopService()
+  },
+  {
+    flags: ["--version", "-v"],
+    summary: "\u6253\u5370\u7248\u672C\u53F7",
+    run: async () => log(VERSION)
+  },
+  {
+    flags: ["--uninstall"],
+    summary: "\u79FB\u9664\u767B\u5F55\u81EA\u542F + \u505C\u6B62\u670D\u52A1 + \u5220\u9664\u7269\u5316\u76EE\u5F55",
+    run: async () => (await Promise.resolve().then(() => (init_setup(), setup_exports))).uninstallAutostart()
+  },
+  {
+    flags: ["--setup"],
+    summary: "\uFF08Windows\uFF09\u7269\u5316\u81EA\u5305\u542B\u526F\u672C\u5230 %LOCALAPPDATA% \u5E76\u6CE8\u518C\u767B\u5F55\u81EA\u542F\uFF0C\u968F\u540E\u524D\u53F0\u542F\u52A8\u670D\u52A1",
+    run: async () => {
+      await (await Promise.resolve().then(() => (init_setup(), setup_exports))).setupAutostart();
+      await (await Promise.resolve().then(() => (init_serve(), serve_exports))).serve();
     }
+  },
+  {
+    flags: ["--help", "-h"],
+    summary: "\u6253\u5370\u672C\u5E2E\u52A9",
+    run: async () => printHelp()
   }
-  const upstreamClient = await ensureUpstream();
-  const server = new Server(
-    { name: HUB_NAME, version: VERSION },
-    {
-      capabilities: upstreamClient.getServerCapabilities() ?? {}
-    }
+];
+function printHelp() {
+  console.log(
+    [
+      `batter-pixso-mcp v${VERSION}`,
+      ``,
+      `\u7528\u6CD5\uFF1Abatter-pixso-mcp [\u547D\u4EE4]\uFF08\u4E0D\u5E26\u547D\u4EE4 = \u524D\u53F0\u542F\u52A8\u670D\u52A1\uFF09`,
+      ``,
+      ...COMMANDS.map((c) => `  ${c.flags.join(", ").padEnd(18)}${c.summary}`)
+    ].join("\n")
   );
-  server.fallbackRequestHandler = (req, extra) => callWithRecovery((c) => c.request(req, ResultSchema, { signal: extra.signal }));
-  server.onclose = () => {
-    log("agent disconnected, proxy exiting");
-    process.exit(0);
-  };
-  await server.connect(new StdioServerTransport());
-  log("proxy ready on stdio");
 }
-
-// src/process/main.ts
-async function main() {
-  if (process.argv.includes("--hub")) {
-    await runHub();
+async function dispatch(argv) {
+  const hit = COMMANDS.find((c) => c.flags.some((f) => argv.includes(f)));
+  if (hit) {
+    await hit.run();
     return;
   }
-  await startStdioProxy();
+  const { serve: serve2 } = await Promise.resolve().then(() => (init_serve(), serve_exports));
+  await serve2();
 }
 
-// src/process/index.ts
-main().catch((err) => {
-  console.error("[batter-pixso-mcp] fatal:", err);
+// src/cli/index.ts
+dispatch(process.argv).catch((err) => {
+  log("fatal:", err);
   process.exit(1);
 });