npm - @minus-ai/dev-vite-plugin - Versions diffs - 0.1.0-beta.1 - Mend

@minus-ai/dev-vite-plugin 0.1.0-beta.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (6) hide show

package/dist/cleanup.js +74 -0
package/dist/index.js +653 -0
package/package.json +26 -0
package/src/.minus/session-counter +1 -0
package/src/cleanup.ts +65 -0
package/src/index.ts +647 -0

package/src/index.ts ADDED Viewed

@@ -0,0 +1,647 @@
+// @minus-ai/dev-vite-plugin — skill 开发/构建一体化 vite 插件
+//
+// dev 模式：proxy 所有 API 请求到平台网关，注入 dev 配置
+// build 模式：externalize react/@minus/*，归档 builds/{version}/
+import { createProxyMiddleware } from 'http-proxy-middleware';
+import { existsSync, readFileSync, readdirSync, mkdirSync, writeFileSync, unlinkSync, rmSync, cpSync, renameSync, realpathSync, statSync } from 'node:fs';
+import { resolve, join } from 'node:path';
+import type { Plugin, UserConfig } from 'vite';
+import type { IncomingMessage, ServerResponse } from 'node:http';
+import http from 'node:http';
+import https from 'node:https';
+export interface MinusDevOptions {
+  /** 平台网关地址。不传时从 .minus/skill.json 的 gateway 字段读取。 */
+  gateway?: string;
+  /** skill 版本号。不传时从 pipeline.py 读取。 */
+  version?: string;
+  /** 本地后端地址（如 http://localhost:4100）。设置后 /skill/{id}/{ver}/api/* 会转发到本地后端并剥掉前缀。 */
+  localBackend?: string;
+}
+function readSkillJson(skillDir: string): { skillId?: string; version?: string; gateway?: string } {
+  const p = join(skillDir, '.minus', 'skill.json');
+  if (!existsSync(p)) return {};
+  try { return JSON.parse(readFileSync(p, 'utf8')); } catch { return {}; }
+}
+function readPipelineVersion(skillDir: string): string | null {
+  const path = join(skillDir, 'pipeline.py');
+  if (!existsSync(path)) return null;
+  const src = readFileSync(path, 'utf8');
+  const m = src.match(/^\s*version\s*=\s*["']([^"']+)["']/m);
+  return m ? m[1] : null;
+}
+function promoteToBuilds(skillDir: string): void {
+  const meta = readSkillJson(skillDir);
+  const version = meta.version ?? readPipelineVersion(skillDir);
+  if (!version) {
+    console.log('[minus-dev] No version found, skipping promote.');
+    return;
+  }
+  const staticDir = join(skillDir, 'static');
+  if (!existsSync(staticDir)) {
+    console.log('[minus-dev] No static/ dir, skipping promote.');
+    return;
+  }
+  const buildsRoot = join(skillDir, 'builds');
+  mkdirSync(buildsRoot, { recursive: true });
+  const targetDir = join(buildsRoot, version);
+  if (existsSync(targetDir)) {
+    rmSync(targetDir, { recursive: true, force: true });
+  }
+  try {
+    renameSync(staticDir, targetDir);
+  } catch (e: any) {
+    if (e.code === 'EXDEV') {
+      mkdirSync(targetDir, { recursive: true });
+      cpSync(staticDir, targetDir, { recursive: true });
+      rmSync(staticDir, { recursive: true, force: true });
+    } else {
+      throw e;
+    }
+  }
+  console.log(`[minus-dev] static/ → builds/${version}/`);
+  const embedPath = join(targetDir, 'embed.html');
+  if (existsSync(embedPath)) {
+    const IMPORT_MAP = `<script type="importmap">{"imports":{` +
+      `"react":"/runtime/react-all/react-all.js",` +
+      `"react-dom":"/runtime/react-all/react-all.js",` +
+      `"react-dom/client":"/runtime/react-all/react-all.js",` +
+      `"react/jsx-runtime":"/runtime/react-all/react-all.js",` +
+      `"react/jsx-dev-runtime":"/runtime/react-all/react-all.js",` +
+      `"@minus/widget-framework":"/runtime/widget-framework/index.js",` +
+      `"@minus/embed-sdk":"/runtime/embed-sdk/index.js",` +
+      `"@minus/platform-widgets":"/runtime/platform-widgets/index.js",` +
+      `"@minus/platform-utils":"/runtime/platform-utils/index.js",` +
+      `"@minus/platform-hooks":"/runtime/platform-hooks/index.js"` +
+      `}}</script>`;
+    const ES_MODULE_SHIMS = `<script async src="https://ga.jspm.io/npm:es-module-shims@1.10.1/dist/es-module-shims.js"></script>`;
+    let html = readFileSync(embedPath, 'utf8');
+    html = html.replace('<head>', `<head>\n${ES_MODULE_SHIMS}\n${IMPORT_MAP}`);
+    writeFileSync(embedPath, html, 'utf8');
+    console.log('[minus-dev] importmap injected into embed.html');
+  }
+  writeFileSync(join(buildsRoot, '.current'), version + '\n', 'utf8');
+}
+import { cleanupDev, writePid } from './cleanup.ts';
+export { cleanupDev, writePid };
+export function minusDev(opts: MinusDevOptions = {}): Plugin[] {
+  const skillDir = resolve(process.cwd(), '..');
+  const meta = readSkillJson(skillDir);
+  // 读取项目根目录 .env.local 中的 MINUS_AI_PLATFORM_URL
+  let envPlatformUrl: string | undefined;
+  const envLocalPath = join(skillDir, '.env.local');
+  if (existsSync(envLocalPath)) {
+    const envContent = readFileSync(envLocalPath, 'utf8');
+    const match = envContent.match(/^MINUS_AI_PLATFORM_URL=(.+)$/m);
+    if (match) envPlatformUrl = match[1].trim();
+  }
+  // 读取开发者 mdk_ key（用于 dev-session cookie 认证）
+  let devApiKey: string | undefined;
+  const credentialsPath = join(process.env.HOME || '', '.minus', 'credentials.json');
+  if (existsSync(credentialsPath)) {
+    try {
+      const creds = JSON.parse(readFileSync(credentialsPath, 'utf8'));
+      if (creds.api_key) devApiKey = creds.api_key;
+    } catch { /* ignore */ }
+  }
+  const gateway = opts.gateway ?? envPlatformUrl ?? meta.gateway ?? 'http://localhost:18686';
+  const version = opts.version ?? meta.version ?? readPipelineVersion(skillDir) ?? '1.0.0';
+  const skillId = meta.skillId;
+  const localBackend = opts.localBackend;
+  // 找到 sif-platform-template/runtime 目录
+  // 策略 1: symlink resolve（npm/monorepo）
+  // 策略 2: package.json 里 file: 协议路径反推（pnpm 会复制到 .pnpm store，symlink 失效）
+  let localRuntimeDir: string | null = null;
+  for (const base of [skillDir, join(skillDir, 'frontend')]) {
+    try {
+      const pluginLink = join(base, 'node_modules', '@minus', 'dev-vite-plugin');
+      const pluginReal = realpathSync(pluginLink);
+      const candidate = resolve(pluginReal, '..', '..', 'runtime');
+      if (existsSync(candidate)) { localRuntimeDir = candidate; break; }
+    } catch { /* continue */ }
+  }
+  if (!localRuntimeDir) {
+    for (const base of [skillDir, join(skillDir, 'frontend')]) {
+      try {
+        const pkg = JSON.parse(readFileSync(join(base, 'package.json'), 'utf8'));
+        const ref = pkg.dependencies?.['@minus-ai/dev-vite-plugin'] ?? pkg.devDependencies?.['@minus-ai/dev-vite-plugin'];
+        if (typeof ref === 'string' && ref.startsWith('file:')) {
+          const pluginSrc = resolve(base, ref.slice('file:'.length));
+          const candidate = resolve(pluginSrc, '..', '..', 'runtime');
+          if (existsSync(candidate)) { localRuntimeDir = candidate; break; }
+        }
+      } catch { /* continue */ }
+    }
+  }
+  const devPlugin: Plugin = {
+    name: 'minus-dev-proxy',
+    apply: 'serve',
+    enforce: 'pre',
+    configureServer(server) {
+      // 自动清理残留进程 + 写 PID，无论 npx vite 还是 npm run dev 都生效
+      cleanupDev(skillDir);
+      writePid(skillDir);
+      server.httpServer?.once('close', () => {
+        const pidFile = join(skillDir, '.minus', 'dev.pid');
+        try { unlinkSync(pidFile); } catch { /* ok */ }
+      });
+      // SSE 端点需要 streaming proxy（不 buffer 响应）
+      const streamingProxy = createProxyMiddleware({
+        target: gateway,
+        changeOrigin: true,
+        cookieDomainRewrite: '',
+        proxyTimeout: 0,
+        timeout: 0,
+      });
+      // 普通 API 用 buffered proxy（避免 chunked encoding 问题）
+      const bufferedProxy = createProxyMiddleware({
+        target: gateway,
+        changeOrigin: true,
+        cookieDomainRewrite: '',
+        selfHandleResponse: true,
+        proxyTimeout: 0,
+        timeout: 0,
+        on: {
+          proxyRes: (proxyRes, _req, res) => {
+            const chunks: Buffer[] = [];
+            let finished = false;
+            const finalize = () => {
+              if (finished) return;
+              finished = true;
+              const body = Buffer.concat(chunks);
+              const headers = { ...proxyRes.headers };
+              delete headers['transfer-encoding'];
+              delete headers['connection'];
+              headers['content-length'] = String(body.length);
+              if (!res.headersSent) res.writeHead(proxyRes.statusCode || 502, headers);
+              res.end(body);
+            };
+            proxyRes.on('data', (c: Buffer) => chunks.push(c));
+            proxyRes.on('end', finalize);
+            proxyRes.on('aborted', finalize);
+            proxyRes.on('error', finalize);
+          },
+        },
+      });
+      // 本地后端代理（剥掉 /skill/{skillId}/{version} 前缀）
+      let localStreamingProxy: any = null;
+      let localBufferedProxy: any = null;
+      if (localBackend) {
+        localStreamingProxy = createProxyMiddleware({
+          target: localBackend,
+          changeOrigin: true,
+          proxyTimeout: 0,
+          timeout: 0,
+        });
+        localBufferedProxy = createProxyMiddleware({
+          target: localBackend,
+          changeOrigin: true,
+          selfHandleResponse: true,
+          proxyTimeout: 0,
+          timeout: 0,
+          on: {
+            proxyRes: (proxyRes: IncomingMessage, _req: IncomingMessage, res: ServerResponse) => {
+              const chunks: Buffer[] = [];
+              let finished = false;
+              const finalize = () => {
+                if (finished) return;
+                finished = true;
+                const body = Buffer.concat(chunks);
+                const headers = { ...proxyRes.headers };
+                delete headers['transfer-encoding'];
+                delete headers['connection'];
+                headers['content-length'] = String(body.length);
+                if (!res.headersSent) res.writeHead((proxyRes as any).statusCode || 502, headers);
+                res.end(body);
+              };
+              proxyRes.on('data', (c: Buffer) => chunks.push(c));
+              proxyRes.on('end', finalize);
+              proxyRes.on('aborted', finalize);
+              proxyRes.on('error', finalize);
+            },
+          },
+        });
+      }
+      const isSSE = (p: string) => p.includes('/pipeline/stream');
+      const localPrefix = skillId ? `/skill/${skillId}/` : null;
+      // dev-session：用 devApiKey 自动注入正确的 MINUS_AI_SID cookie
+      let devSessionInstalled = false;
+      if (devApiKey) {
+        server.middlewares.use((req: IncomingMessage, res: ServerResponse, next) => {
+          if (devSessionInstalled) return next();
+          const cookie = req.headers.cookie || '';
+          const sidMatch = cookie.match(/MINUS_AI_SID=([^;]*)/);
+          if (sidMatch && sidMatch[1] === devApiKey) { devSessionInstalled = true; return next(); }
+          const urlPath = (req.url || '').split('?')[0];
+          if (!urlPath.endsWith('.html') && urlPath !== '/' && urlPath !== '') return next();
+          const body = JSON.stringify({ apiKey: devApiKey });
+          const gwUrl = new URL('/api/auth/dev-session', gateway);
+          const mod = gwUrl.protocol === 'https:' ? https : http;
+          const gwReq = mod.request(gwUrl, { method: 'POST', headers: { 'Content-Type': 'application/json', 'Content-Length': Buffer.byteLength(body) } }, (gwRes: IncomingMessage) => {
+            const setCookie = gwRes.headers['set-cookie'];
+            if (setCookie) {
+              devSessionInstalled = true;
+              res.setHeader('Set-Cookie', setCookie);
+            }
+            next();
+          });
+          gwReq.on('error', () => next());
+          gwReq.end(body);
+        });
+      }
+      // /login → 重定向到平台网关登录页（独立开发模式下 embed-sdk 的 redirectToLogin 会跳到本地 /login）
+      server.middlewares.use((req: IncomingMessage, res: ServerResponse, next) => {
+        const urlPath = (req.url || '').split('?')[0];
+        if (urlPath === '/login') {
+          if (devApiKey) {
+            devSessionInstalled = false;
+            res.setHeader('Set-Cookie', 'MINUS_AI_SID=; Path=/; Max-Age=0');
+            res.writeHead(302, { Location: '/' });
+            res.end();
+          } else {
+            const devOrigin = `http://localhost:${(server.httpServer?.address() as any)?.port || 5173}`;
+            const loginUrl = new URL('/login', gateway);
+            loginUrl.searchParams.set('returnTo', devOrigin);
+            res.writeHead(302, { Location: loginUrl.toString() });
+            res.end();
+          }
+          return;
+        }
+        next();
+      });
+      server.middlewares.use((req: IncomingMessage, res: ServerResponse, next) => {
+        const url = req.url || '';
+        const urlPath = url.split('?')[0];
+        // dev 环境所有代理请求走 dev workspace
+        if (!req.headers['x-workspace-mode']) req.headers['x-workspace-mode'] = 'dev';
+        // 本地后端：/skill/{skillId}/{version}/api/* → 剥掉前缀转发到本地
+        if (localPrefix && localBackend && urlPath.startsWith(localPrefix) && urlPath.includes('/api/')) {
+          const apiStart = urlPath.indexOf('/api/');
+          req.url = url.slice(apiStart);
+          return (isSSE(urlPath) ? localStreamingProxy! : localBufferedProxy!)(req, res, next);
+        }
+        // /runtime/* → 优先从本地 sif-platform-template/runtime 目录读取
+        if (urlPath.startsWith('/runtime/') && localRuntimeDir) {
+          let localPath = join(localRuntimeDir, urlPath.slice('/runtime/'.length));
+          if (!existsSync(localPath)) {
+            // /runtime/pkg/file → try /runtime/pkg/{hash-subdir}/file
+            const parts = urlPath.slice('/runtime/'.length).split('/');
+            if (parts.length >= 2) {
+              const pkgDir = join(localRuntimeDir, parts[0]);
+              const fileName = parts.slice(1).join('/');
+              if (existsSync(pkgDir)) {
+                const subdirs = readdirSync(pkgDir).filter(d => {
+                  try { return statSync(join(pkgDir, d)).isDirectory(); } catch { return false; }
+                });
+                if (subdirs.length > 0) {
+                  const resolved = join(pkgDir, subdirs[0], fileName);
+                  if (existsSync(resolved)) localPath = resolved;
+                }
+              }
+            }
+          }
+          if (existsSync(localPath)) {
+            const content = readFileSync(localPath);
+            const ext = localPath.split('.').pop();
+            const mime = ext === 'js' ? 'application/javascript' : ext === 'css' ? 'text/css' : 'application/octet-stream';
+            res.writeHead(200, { 'Content-Type': mime, 'Content-Length': content.length });
+            res.end(content);
+            return;
+          }
+        }
+        // /api/* /auth/* /skill/* /runtime/* → 转发到平台网关
+        if (
+          urlPath.startsWith('/api/') || urlPath === '/api' ||
+          urlPath.startsWith('/auth/') || urlPath === '/auth' ||
+          urlPath.startsWith('/skill/') || urlPath === '/skill' ||
+          urlPath.startsWith('/runtime/')
+        ) {
+          // /api/skills/*/sessions 等 skill 操作端点需要 workspace mode，/api/me/* 不需要
+          return (isSSE(urlPath) ? streamingProxy : bufferedProxy)(req, res, next);
+        }
+        // / → 重定向到 /embed.html?skill_id=xxx
+        if (skillId && (urlPath === '/' || urlPath === '')) {
+          res.writeHead(302, { Location: `/embed.html?skill_id=${skillId}` });
+          res.end();
+          return;
+        }
+        return next();
+      });
+    },
+    // 注入 dev 配置到 HTML；独立模式下模拟 embed host 完成握手
+    transformIndexHtml(html) {
+      const devConfig = `<script>window.__MINUS_DEV__=${JSON.stringify({ version })}</script>`;
+      const importMap = `<script type="importmap">{"imports":{` +
+        `"react":"/runtime/react-all/react-all.js",` +
+        `"react-dom":"/runtime/react-all/react-all.js",` +
+        `"react-dom/client":"/runtime/react-all/react-all.js",` +
+        `"react/jsx-runtime":"/runtime/react-all/react-all.js",` +
+        `"react/jsx-dev-runtime":"/runtime/react-all/react-all.js",` +
+        `"@minus/widget-framework":"/runtime/widget-framework/index.js",` +
+        `"@minus/embed-sdk":"/runtime/embed-sdk/index.js",` +
+        `"@minus/platform-widgets":"/runtime/platform-widgets/index.js",` +
+        `"@minus/platform-utils":"/runtime/platform-utils/index.js",` +
+        `"@minus/platform-hooks":"/runtime/platform-hooks/index.js"` +
+        `}}</script>`;
+      // 当页面不在 iframe 中时，模拟 embed host：
+      // 监听 embed.ready → 回复 embed.init（home 模式，无 instanceId）
+      const embedShim = `<script>
+(function(){
+  if (window.parent !== window) return;
+  var skillId = new URLSearchParams(location.search).get("skill_id");
+  if (!skillId) return;
+  var VER = ${JSON.stringify(version)};
+  function uid(){ return crypto.randomUUID ? crypto.randomUUID() : Date.now().toString(36) + Math.random().toString(36).slice(2); }
+  function env(kind, type, payload, reqId){ return { sif:"v1", id: reqId||uid(), kind:kind, type:type, payload:payload, error:null, meta:{ts:Date.now(),from:"parent",skillId:skillId} }; }
+  function respond(reqId, payload){ window.postMessage(Object.assign(env("res","",payload,reqId),{type:""}), "*"); }
+  // 通用 req 响应：匹配 id，填充 kind=res
+  function sendRes(reqId, type, payload){
+    window.postMessage({ sif:"v1", id:reqId, kind:"res", type:type, payload:payload, error:null, meta:{ts:Date.now(),from:"parent",skillId:skillId} }, "*");
+  }
+  function sendEvt(type, payload){
+    window.postMessage(env("evt",type,payload), "*");
+  }
+  window.addEventListener("message", function(e){
+    var d = e.data;
+    if (!d || d.sif !== "v1") return;
+    if (d.meta && d.meta.from === "parent") return; // 忽略自己发的
+    // 拦截 child 发出的消息，防止 child 的 RpcChannel 收到自己的 req
+    e.stopImmediatePropagation();
+    // embed.ready (evt) → 回 embed.init (req)
+    if (d.kind === "evt" && d.type === "embed.ready") {
+      fetch("/api/skills/" + encodeURIComponent(skillId) + "/versions/" + encodeURIComponent(VER), { credentials:"include" })
+        .then(function(r){ return r.ok ? r.json() : null; })
+        .catch(function(){ return null; })
+        .then(function(skill){
+          var flow = skill ? { title:skill.displayName||skillId, description:skill.description||"", skillId:skillId, useCases:skill.useCases||[], tags:skill.tags||[] } : { title:skillId, description:"", skillId:skillId };
+          window.postMessage(env("req","embed.init",{ flow:flow, instanceId:null, currentStep:0 }), "*");
+        });
+      return;
+    }
+    // flow.start (req) → 创建 session，启动 SSE
+    if (d.kind === "req" && d.type === "flow.start") {
+      var reqId = d.id;
+      var input = d.payload && d.payload.input || {};
+      fetch("/api/skills/" + encodeURIComponent(skillId) + "/versions/" + encodeURIComponent(VER) + "/sessions", {
+        method:"POST", credentials:"include",
+        headers: {"Content-Type":"application/json"},
+        body: JSON.stringify({ entryParams: input })
+      })
+      .then(function(r){ return r.json(); })
+      .then(function(ses){
+        sendRes(reqId, "flow.start", { sessionId: ses.id, instanceId: ses.id });
+        // 启动 SSE pipeline stream（通过 dev proxy 到本地后端）
+        var streamUrl = "/skill/" + encodeURIComponent(skillId) + "/" + VER + "/api/sessions/" + encodeURIComponent(ses.id) + "/pipeline/stream";
+        var es = new EventSource(streamUrl);
+        es.onmessage = function(ev){
+          try {
+            var data = JSON.parse(ev.data);
+            sendEvt("state.update", data);
+          } catch(e){}
+        };
+        es.onerror = function(){ es.close(); };
+      })
+      .catch(function(err){
+        window.postMessage({ sif:"v1", id:reqId, kind:"res", type:"flow.start", payload:null, error:{code:"INTERNAL_ERROR",message:err.message}, meta:{ts:Date.now(),from:"parent",skillId:skillId} }, "*");
+      });
+      return;
+    }
+    // flow.resolve (req) → 直接 ack
+    if (d.kind === "req" && d.type === "flow.resolve") {
+      sendRes(d.id, "flow.resolve", { ok:true });
+      return;
+    }
+    // api.call (req) → 代理 API 调用
+    if (d.kind === "req" && d.type === "api.call") {
+      var p = d.payload;
+      fetch(p.url, { method:p.method||"GET", headers:p.headers||{}, body:p.body||null, credentials:"include" })
+        .then(function(r){ return r.text().then(function(t){ return {status:r.status,body:t}; }); })
+        .then(function(res){ sendRes(d.id, "api.call", res); })
+        .catch(function(err){ sendRes(d.id, "api.call", {status:500,body:err.message}); });
+      return;
+    }
+    // notify.toast (req) → ack
+    if (d.kind === "req" && d.type === "notify.toast") {
+      sendRes(d.id, "notify.toast", { ok:true });
+      return;
+    }
+  });
+})();
+</script>`;
+      return html.replace('<head>', `<head>\n${importMap}`).replace('</head>', `${devConfig}\n${embedShim}\n</head>`);
+    },
+  };
+  const EXTERNAL_URL_MAP: Record<string, string> = {
+    'react': '/runtime/react-all/react-all.js',
+    'react-dom': '/runtime/react-all/react-all.js',
+    'react-dom/client': '/runtime/react-all/react-all.js',
+    'react/jsx-runtime': '/runtime/react-all/react-all.js',
+    'react/jsx-dev-runtime': '/runtime/react-all/react-all.js',
+    '@minus/widget-framework': '/runtime/widget-framework/index.js',
+    '@minus/embed-sdk': '/runtime/embed-sdk/index.js',
+    '@minus/platform-widgets': '/runtime/platform-widgets/index.js',
+    '@minus/platform-utils': '/runtime/platform-utils/index.js',
+    '@minus/platform-hooks': '/runtime/platform-hooks/index.js',
+  };
+  const EXTERNALS = Object.keys(EXTERNAL_URL_MAP);
+  let isServe = false;
+  let devServerOrigin = '';
+  const VIRTUAL_PREFIX = '\0runtime:';
+  const exportsCache = new Map<string, string[]>();
+  async function getRemoteExports(source: string): Promise<string[]> {
+    if (exportsCache.has(source)) return exportsCache.get(source)!;
+    let code: string;
+    const relPath = EXTERNAL_URL_MAP[source];
+    let localFile: string | null = null;
+    if (localRuntimeDir) {
+      const direct = join(localRuntimeDir, relPath.slice('/runtime/'.length));
+      if (existsSync(direct)) {
+        localFile = direct;
+      } else {
+        // /runtime/pkg/index.js → try /runtime/pkg/{hash}/index.js via latest file
+        const parts = relPath.slice('/runtime/'.length).split('/');
+        if (parts.length >= 2) {
+          const pkgDir = join(localRuntimeDir, parts[0]);
+          const fileName = parts.slice(1).join('/');
+          if (existsSync(pkgDir)) {
+            const latestFile = join(pkgDir, 'latest');
+            let hash: string | null = null;
+            if (existsSync(latestFile)) {
+              hash = readFileSync(latestFile, 'utf8').trim();
+            } else {
+              const subdirs = readdirSync(pkgDir).filter(d => {
+                try { return statSync(join(pkgDir, d)).isDirectory(); } catch { return false; }
+              });
+              if (subdirs.length > 0) hash = subdirs[0];
+            }
+            if (hash) {
+              const versioned = join(pkgDir, hash, fileName);
+              if (existsSync(versioned)) localFile = versioned;
+            }
+          }
+        }
+      }
+    }
+    if (localFile) {
+      code = readFileSync(localFile, 'utf8');
+    } else {
+      const resp = await fetch(gateway + relPath, { redirect: 'follow' });
+      code = await resp.text();
+    }
+    const names: string[] = [];
+    for (const m of code.matchAll(/export\s*\{([^}]+)\}/g)) {
+      for (const item of m[1].split(',')) {
+        const trimmed = item.trim();
+        if (!trimmed) continue;
+        const asMatch = trimmed.match(/(?:\S+\s+as\s+)?(\S+)/);
+        if (asMatch) names.push(asMatch[1]);
+      }
+    }
+    for (const m of code.matchAll(/export\s+(function|const|let|var|class)\s+(\w+)/g)) {
+      names.push(m[2]);
+    }
+    const unique = [...new Set(names)].filter(n => n !== 'default');
+    exportsCache.set(source, unique);
+    return unique;
+  }
+  const externalsPlugin: Plugin = {
+    name: 'minus-dev-externals',
+    enforce: 'pre',
+    config(_config, { command }) {
+      if (command !== 'serve') return;
+      return {
+        optimizeDeps: {
+          esbuildOptions: {
+            plugins: [{
+              name: 'externalize-react',
+              setup(build) {
+                build.onResolve({ filter: /^react(-dom)?(\/.*)?$/ }, (args) => {
+                  if (args.importer) {
+                    return { path: args.path, external: true };
+                  }
+                });
+              },
+            }],
+          },
+        },
+      };
+    },
+    configResolved(config) {
+      isServe = config.command === 'serve';
+      if (isServe) {
+        const port = config.server?.port ?? 5173;
+        const host = 'localhost';
+        devServerOrigin = `http://${host}:${port}`;
+      }
+    },
+    configureServer(server) {
+      // Vite 可能因端口占用自动换端口，httpServer.listen 后拿到真实端口更新 origin
+      server.httpServer?.once('listening', () => {
+        const addr = server.httpServer?.address();
+        if (addr && typeof addr === 'object') {
+          devServerOrigin = `http://localhost:${addr.port}`;
+          const portsFile = join(skillDir, '.minus', 'dev-ports.json');
+          const ports: Record<string, number> = { frontend: addr.port };
+          if (localBackend) {
+            try { ports.backend = new URL(localBackend).port ? parseInt(new URL(localBackend).port, 10) : 0; } catch { /* skip */ }
+          }
+          try {
+            mkdirSync(join(skillDir, '.minus'), { recursive: true });
+            writeFileSync(portsFile, JSON.stringify(ports, null, 2) + '\n');
+          } catch { /* non-critical */ }
+        }
+      });
+    },
+    resolveId(source) {
+      if (!EXTERNAL_URL_MAP[source]) return;
+      if (isServe) return VIRTUAL_PREFIX + source;
+      return { id: source, external: true };
+    },
+    async load(id) {
+      if (!id.startsWith(VIRTUAL_PREFIX)) return;
+      const source = id.slice(VIRTUAL_PREFIX.length);
+      const path = EXTERNAL_URL_MAP[source];
+      const exports = await getRemoteExports(source);
+      const importUrl = `${devServerOrigin}${path}`;
+      const lines = [
+        `const __m = await import("${importUrl}");`,
+        `export default __m.default;`,
+      ];
+      if (exports.length > 0) {
+        lines.push(`const { ${exports.join(', ')} } = __m;`);
+        lines.push(`export { ${exports.join(', ')} };`);
+      }
+      // react-all.js is a production bundle — alias jsxDEV to jsx for dev mode
+      if (source === 'react/jsx-dev-runtime' || source === 'react/jsx-runtime') {
+        if (!exports.includes('jsxDEV') && exports.includes('jsx')) {
+          lines.push(`export const jsxDEV = __m.jsx;`);
+        }
+      }
+      return lines.join('\n');
+    },
+  };
+  const buildPlugin: Plugin = {
+    name: 'minus-dev-build',
+    apply: 'build',
+    config(_config, { command }): UserConfig {
+      if (command !== 'build') return {};
+      return {
+        build: {
+          rollupOptions: { external: EXTERNALS },
+        },
+      };
+    },
+    closeBundle() {
+      promoteToBuilds(skillDir);
+    },
+  };
+  return [externalsPlugin, devPlugin, buildPlugin];
+}