@open-dy/vibecoding-sdk-taro 0.0.1-beta.4 → 0.0.1

package/src/build/taro.ts

@@ -0,0 +1,830 @@
+import type { UserConfigExport } from "@tarojs/cli";
+import tailwindcss from "@tailwindcss/postcss";
+import path from "path";
+import fs from "fs";
+import { fileURLToPath } from "node:url";
+import type { Plugin } from "vite";
+import { UnifiedViteWeappTailwindcssPlugin } from 'weapp-tailwindcss/vite';
+import { viteImageAssetImportPlugin } from "./plugins/vite-image-asset-import";
+import { viteDependCardPlugin } from "./plugins/vite-depend-card";
+import { viteInlineJsonPlugin } from "./plugins/vite-inline-json";
+import { viteTaroSourceLocationPlugin } from "./plugins/vite-taro-source-location";
+import { viteTtComponentsEntryPlugin } from "./plugins/vite-tt-components-entry";
+
+const SDK_DIR = path.dirname(fileURLToPath(import.meta.url));
+
+/**
+ * @desc Taro 构建阶段共享的编译上下文。
+ * @example const context: BuildContext = { isH5: true, isTt: false, mode: 'development', projectRoot }
+ * @ai-intent 描述 SDK 构建插件收到的 Taro 编译上下文。
+ * @ai-when 需要根据 H5、TT 或开发模式调整构建配置时。
+ * @ai-avoid 不要在业务页面中手动伪造该上下文或修改构建产物。
+ * @ai-example { isH5: true, isTt: false, mode: 'development', projectRoot }
+ */
+export interface BuildContext {
+  /** @desc 是否构建 H5 输出。 */
+  isH5: boolean
+  /** @desc 是否构建 TT 小程序输出。 */
+  isTt: boolean
+  /** @desc 当前 Taro 构建模式。 */
+  mode: string
+  /** @desc 工程根目录。 */
+  projectRoot: string
+}
+
+/**
+ * @desc 创建普通小程序 Taro 配置的选项。
+ * @params {string} projectRoot 工程根目录。
+ * @params {'' | 'ext'} [platformChannel] 平台渠道。
+ * @params {string[]} [viteErrorTargets] Vite 错误上报目标。
+ * @params {Record<string, any> | Function} [overrides] 配置覆盖项。
+ * @example createMicroappTaroConfig({ projectRoot: process.cwd() })
+ * @ai-intent 配置普通小程序的 Taro/Vite 构建入口。
+ * @ai-when 需要从项目构建脚本创建普通小程序配置时。
+ * @ai-avoid 不要在业务代码中直接调用 Taro/Vite 内部构建 API。
+ * @ai-example createMicroappTaroConfig({ projectRoot: process.cwd() })
+ */
+export interface CreateMicroappTaroConfigOptions {
+  /** @desc 工程根目录。 */
+  projectRoot: string
+  /** @desc 平台渠道。 */
+  platformChannel?: '' | 'ext'
+  /** @desc Vite 错误上报目标列表。 */
+  viteErrorTargets?: string[]
+  /** @desc 配置对象或配置变换函数。 */
+  overrides?: Record<string, any> | ((config: UserConfigExport, ctx: BuildContext) => UserConfigExport | void)
+}
+
+import { applyConfigOverrides } from './config-overrides'
+export { applyConfigOverrides, mergeConfigValue } from './config-overrides'
+
+function shouldRewritePreviewRequest(req: any) {
+  if (req.method !== "GET" && req.method !== "HEAD") return false;
+  if (req.headers.accept && !req.headers.accept.includes("text/html")) {
+    return false;
+  }
+  return true;
+}
+
+function isViteOptimizedDepsRequest(url?: string) {
+  if (!url) return false;
+  const cleanUrl = url.split("?")[0].split("#")[0];
+  return (
+    cleanUrl.includes("/node_modules/.vite/deps/") ||
+    cleanUrl.includes("/@fs/") && cleanUrl.includes("/node_modules/.vite/deps/")
+  );
+}
+
+interface NetworkCallInfo {
+  method: string;
+  url: string;
+  file: string;
+}
+
+type EstreeNode = {
+  type: string;
+  loc?: { start: { line: number; column: number } };
+  [key: string]: any;
+};
+
+function extractUrlFromEstree(node: EstreeNode): string {
+  if (node.type === "Literal" && typeof node.value === "string")
+    return node.value;
+  if (node.type === "TemplateLiteral") {
+    let result = "";
+    for (let i = 0; i < node.quasis.length; i++) {
+      result += node.quasis[i].value.cooked ?? node.quasis[i].value.raw;
+      if (i < node.expressions.length)
+        result += `\${${extractUrlFromEstree(node.expressions[i])}}`;
+    }
+    return result;
+  }
+  if (node.type === "BinaryExpression" && node.operator === "+")
+    return extractUrlFromEstree(node.left) + extractUrlFromEstree(node.right);
+  if (node.type === "Identifier") return `\${${node.name}}`;
+  return "<dynamic>";
+}
+
+function visitEstree(node: EstreeNode, callback: (node: EstreeNode) => void) {
+  callback(node);
+  for (const key of Object.keys(node)) {
+    const child = node[key];
+    if (child && typeof child === "object" && child.type) {
+      visitEstree(child, callback);
+    } else if (Array.isArray(child)) {
+      for (const item of child) {
+        if (item && typeof item === "object" && item.type)
+          visitEstree(item, callback);
+      }
+    }
+  }
+}
+
+const TARGET_METHODS = new Set(["request", "uploadFile", "downloadFile"]);
+const CLIENT_ROUTES_FILE = "/tmp/routes/client-routes.json";
+
+function writeRoutes(results: NetworkCallInfo[]) {
+  try {
+    const outDir = path.dirname(CLIENT_ROUTES_FILE);
+    if (!fs.existsSync(outDir)) fs.mkdirSync(outDir, { recursive: true });
+    fs.writeFileSync(CLIENT_ROUTES_FILE, JSON.stringify(results, null, 2));
+    console.log(
+      `\n[NetworkUrlAnalyzerPlugin] Collected ${results.length} client route(s) -> ${CLIENT_ROUTES_FILE}\n`,
+    );
+  } catch {
+    // Ignore route dump failures in build-time analysis.
+  }
+}
+
+function collectNetworkCalls(
+  ast: EstreeNode,
+  id: string,
+  srcDir: string,
+  results: NetworkCallInfo[],
+) {
+  visitEstree(ast, (node) => {
+    if (
+      node.type === "CallExpression" &&
+      node.callee?.type === "MemberExpression" &&
+      node.callee.object?.type === "Identifier" &&
+      node.callee.object.name === "Network" &&
+      node.callee.property?.type === "Identifier" &&
+      TARGET_METHODS.has(node.callee.property.name)
+    ) {
+      const arg = node.arguments?.[0];
+      if (arg?.type === "ObjectExpression") {
+        const urlProp = arg.properties?.find(
+          (p: EstreeNode) =>
+            p.type === "Property" &&
+            ((p.key?.type === "Identifier" && p.key.name === "url") ||
+              (p.key?.type === "Literal" && p.key.value === "url")),
+        );
+        if (urlProp) {
+          const urlValue = extractUrlFromEstree(urlProp.value);
+          results.push({
+            method: node.callee.property.name,
+            url: urlValue,
+            file: path.relative(path.resolve(srcDir, ".."), id),
+          });
+        }
+      }
+    }
+  });
+}
+
+function networkUrlAnalyzerPlugin(srcDir: string): Plugin {
+  const results: NetworkCallInfo[] = [];
+  let isBuild = false;
+
+  return {
+    name: "network-url-analyzer",
+    buildStart() {
+      isBuild = !this.meta.watchMode;
+      if (!isBuild) return;
+      results.length = 0;
+      try {
+        fs.unlinkSync(CLIENT_ROUTES_FILE);
+      } catch {
+        // Ignore missing route snapshot files.
+      }
+    },
+    transform(code, id) {
+      if (!isBuild) return;
+      try {
+        if (!id.startsWith(srcDir) || id.includes("network.ts")) return;
+        if (!/\.(ts|tsx|js|jsx)$/.test(id)) return;
+
+        const ast = this.parse(code) as unknown as EstreeNode;
+        collectNetworkCalls(ast, id, srcDir, results);
+      } catch {
+        // Ignore analyzer failures and avoid blocking builds.
+      }
+    },
+    closeBundle() {
+      if (!isBuild) return;
+      writeRoutes(results);
+      results.length = 0;
+    },
+  };
+}
+
+function createAppEntryMatcher(srcDir: string) {
+  const candidateEntries = new Set(
+    ["app.ts", "app.tsx", "app.js", "app.jsx"].map((name) =>
+      path.normalize(path.join(srcDir, name)),
+    ),
+  );
+
+  return (id: string) => {
+    if (!id.includes("/app.") && !id.includes("\\app.")) {
+      return false;
+    }
+
+    const cleanId = id.split("?")[0];
+    return candidateEntries.has(path.normalize(cleanId));
+  };
+}
+
+function buildInjectedViteErrorReporter(targetOrigins: string[]) {
+  return `
+/* Injected vite error reporter */
+if (typeof window !== "undefined" &&
+    window !== window.parent &&
+    import.meta.hot &&
+    !window.__AGI_VITE_ERROR_SYNC__) {
+  window.__AGI_VITE_ERROR_SYNC__ = true;
+  const viteErrorTargets = ${JSON.stringify(targetOrigins)};
+  const postToParent = (message) => {
+    viteErrorTargets.forEach((targetOrigin) => {
+      try {
+        window.parent.postMessage(message, targetOrigin);
+      } catch (error) {
+      }
+    });
+  };
+  const normalizeError = (err) => {
+    if (!err) {
+      return null;
+    }
+    return {
+      message: err.message,
+      id: err.id,
+    };
+  };
+
+  import.meta.hot.on("vite:error", (payload) => {
+    const error = normalizeError(payload && payload.err);
+    if (!error) {
+      return;
+    }
+    window.__LAST_VITE_ERROR__ = error;
+    postToParent({ type: "VITE_ERROR", hasError: true, error });
+  });
+
+  import.meta.hot.on("vite:beforeUpdate", () => {
+    window.__LAST_VITE_ERROR__ = null;
+  });
+}
+`;
+}
+
+// dev-only 路由自愈：app.config 改动重启重载后，若当前 URL 对应页面已从
+// pages 中移除，重定向到新首页。兼容 hash（本地）与 browser（云端 + basename）模式。
+function buildInjectedRouteHealer() {
+  return `
+/* Injected dev route healer */
+if (typeof window !== "undefined" && !window.__AGI_ROUTE_HEALER__) {
+  window.__AGI_ROUTE_HEALER__ = true;
+  var healRoute = function () {
+    try {
+      var config = window.__taroAppConfig;
+      var pages = config && config.pages;
+      if (!pages || !pages.length) return;
+      var router = config.router || {};
+      var mode = router.mode || "hash";
+      var basename = router.basename || "";
+      var stripBase = function (p) {
+        if (basename && p.indexOf(basename) === 0) p = p.slice(basename.length);
+        return p.replace(/^\\//, "");
+      };
+      var currentPath;
+      if (mode === "browser" || mode === "multi") {
+        currentPath = stripBase(window.location.pathname).split("?")[0];
+      } else {
+        var hash = window.location.hash || "";
+        currentPath = hash.replace(/^#/, "").split("?")[0].replace(/^\\//, "");
+      }
+      if (!currentPath) return;
+      var exists = pages.some(function (p) {
+        return p === currentPath || ("/" + p) === ("/" + currentPath);
+      });
+      if (exists) return;
+      var home = pages[0];
+      if (mode === "browser" || mode === "multi") {
+        var target = (basename ? basename.replace(/\\/$/, "") : "") + "/" + home;
+        window.location.replace(target + window.location.search);
+      } else {
+        window.location.hash = "#/" + home;
+      }
+    } catch (e) {}
+  };
+  if (document.readyState === "complete") {
+    setTimeout(healRoute, 0);
+  } else {
+    window.addEventListener("load", function () { setTimeout(healRoute, 0); });
+  }
+}
+`;
+}
+
+/**
+ * @desc 创建普通小程序的 Taro/Vite 构建配置。
+ * @params {CreateMicroappTaroConfigOptions} options 构建配置选项。
+ * @return {UserConfigExport} Taro 配置工厂函数。
+ * @example createMicroappTaroConfig({ projectRoot: process.cwd() })
+ * @ai-intent 创建普通小程序的 Taro/Vite 构建配置。
+ * @ai-when 构建脚本需要加载普通小程序的 SDK 配置时。
+ * @ai-avoid 不要在业务页面调用该构建工厂，也不要绕过 SDK 修改代理配置。
+ * @ai-example createMicroappTaroConfig({ projectRoot: process.cwd() })
+ */
+export function createMicroappTaroConfig(
+  options: CreateMicroappTaroConfigOptions,
+): UserConfigExport {
+ return (async (merge: (...configs: any[]) => UserConfigExport) => {
+  const DOUYIN_CLOUD_ENV_ID = process.env.DOUYIN_CLOUD_ENV_ID || "";
+  const DOUYIN_CLOUD_DEV_ENV_ID = process.env.DOUYIN_CLOUD_DEV_ENV_ID || "";
+  const DOUYIN_CLOUD_SERVICE_ID = process.env.DOUYIN_CLOUD_SERVICE_ID || "";
+  const APP_ID = process.env.APP_ID || "";
+  const OPEN_CARD_ID = process.env.OPEN_CARD_ID || "";
+  const AUDIT_DOUYIN_CLOUD_ENV_ID = process.env.AUDIT_DOUYIN_CLOUD_ENV_ID || "";
+  const AUDIT_DOUYIN_CLOUD_SERVICE_ID = process.env.AUDIT_DOUYIN_CLOUD_SERVICE_ID || "";
+  if (APP_ID) {
+    process.env.TARO_APP_ID = APP_ID;
+  }
+  const projectRoot = path.resolve(options.projectRoot)
+  const srcDir = path.resolve(projectRoot, "src");
+  // Keep generated projects using their local icons; SDK-based templates use
+  // the scoped package while still accepting legacy `lucide-taro` imports.
+  const legacyIconEntry = path.resolve(projectRoot, 'icons/dist/lucide-taro.mjs')
+  const isH5 = process.env.TARO_ENV === 'h5';
+  const viteErrorTargets = options.viteErrorTargets ?? []
+  const cloudDevProjectDomain = viteErrorTargets[0] ?? ''
+  let conversationId = ''
+  try {
+    const meta = JSON.parse(
+      fs.readFileSync('/opt/gem/ai_coding_app/.meta/ai_coding_app_meta.json', 'utf8'),
+    ) as { conversation_id?: string }
+    conversationId = meta.conversation_id ?? ''
+  } catch {
+    // Local development has no cloud metadata.
+  }
+  const isCloudEnv = Boolean(conversationId)
+  const previewBasePath = isCloudEnv
+    ? `/api/apps/open_ai_coding_chat_server/aio_fe/${conversationId}/preview`
+    : ''
+  const aioServerPath = isCloudEnv
+    ? `${cloudDevProjectDomain}/api/apps/open_ai_coding_chat_server/aio_server/${conversationId}/api`
+    : 'http://localhost:10086/api'
+  const backendUrl = `http://localhost:${process.env.NJS_SERVER_PORT || '3000'}`
+  const withProjectDomain = (urlPath: string) => {
+    if (isCloudEnv && process.env.NODE_ENV === 'production') {
+      return `https://ma.zijieapi.com${urlPath}`
+    }
+    if (isCloudEnv && process.env.NODE_ENV === 'development') {
+      return `${cloudDevProjectDomain}${urlPath}`
+    }
+    return `http://localhost:10086${urlPath}`
+  }
+  const aioServerUrl = new URL(aioServerPath)
+  const PROJECT_DOMAIN = process.env.PROJECT_DOMAIN || withProjectDomain(aioServerUrl.pathname)
+  const UPLOAD_URL = process.env.UPLOAD_URL || withProjectDomain(
+    `/api/apps/open_ai_coding_chat_server/aio_server/${conversationId}/v1/file/upload`,
+  )
+  const DOWNLOAD_URL = process.env.DOWNLOAD_URL || withProjectDomain(
+    `/api/apps/open_ai_coding_chat_server/aio_server/${conversationId}/v1/file/download?path=`,
+  )
+  const proxyConfig = isCloudEnv
+    ? {
+        [aioServerPath]: {
+          target: backendUrl,
+          changeOrigin: true,
+          secure: false,
+          rewrite: (requestPath: string) => {
+            const rest = requestPath.replace(aioServerPath, '')
+            return rest.startsWith('/api') ? rest : `/api${rest}`
+          },
+        },
+      }
+    : {
+        '/api': { target: backendUrl, changeOrigin: true, secure: false },
+      }
+  const devConfig: UserConfigExport<'vite'> = {
+    logger: { quiet: false, stats: true },
+    mini: {},
+    h5: {
+      publicPath: isCloudEnv ? `${previewBasePath}/` : '/',
+      router: isCloudEnv
+        ? { mode: 'browser', basename: previewBasePath }
+        : { mode: 'hash' },
+      devServer: {
+        port: 10086,
+        open: false,
+        ...({ hmr: false } as Record<string, unknown>),
+        proxy: proxyConfig,
+      },
+    },
+  }
+  const prodConfig: UserConfigExport = {
+    mini: {},
+    cache: { enable: true },
+    h5: {},
+  }
+  const appConfigPath = path.join(srcDir, "app.config.ts");
+  // 保存 Taro 常驻编译上下文的引用，用于刷新 app/pages 与重置 loaderMeta。
+  let taroCompilerContext: any;
+  const isAppEntry = createAppEntryMatcher(srcDir);
+  const injectedViteErrorReporter = buildInjectedViteErrorReporter(
+    viteErrorTargets,
+  );
+  // dev（watch 模式）下 tt 产物输出到 dist，
+  // 与 build:tt（NODE_ENV=production）的 dist-tt 区分开。
+  const isDevBuild = process.env.NODE_ENV === 'development';
+  const injectedRouteHealer = buildInjectedRouteHealer();
+  const isTt = process.env.TARO_ENV === 'tt';
+  const shouldRefreshAppConfigOnUpdate = isH5 || isTt;
+  let shouldRefreshTtConfig = false;
+  const refreshTaroCompilerContext = (
+    ctx: any,
+    options: { resetLoaderMeta?: boolean } = {},
+  ) => {
+    if (!ctx) {
+      return;
+    }
+    if (options.resetLoaderMeta) {
+      ctx.loaderMeta = undefined;
+    }
+    // 原地更新，保持 app 对象 / pages 数组引用（下游插件闭包持有）。
+    if (typeof ctx.getApp === "function" && ctx.app) {
+      Object.assign(ctx.app, ctx.getApp());
+    }
+    if (typeof ctx.getPages === "function" && Array.isArray(ctx.pages)) {
+      ctx.pages.splice(0, ctx.pages.length, ...ctx.getPages());
+    }
+  };
+  const outputRootMap: Record<string, string> = {
+    tt: isDevBuild ? 'dist' : 'dist-tt',
+    h5: 'dist-web',
+  };
+  const defaultOutputRoot = outputRootMap[process.env.TARO_ENV || ''] || 'dist';
+  const baseConfig: UserConfigExport<"vite"> = {
+    projectName: "microapp",
+    date: "2026-3-5",
+    designWidth: 375,
+    deviceRatio: {
+      640: 2.34 / 2,
+      750: 1,
+      375: 2,
+      828: 1.81 / 2,
+    },
+    sourceRoot: "src",
+    outputRoot: defaultOutputRoot,
+    alias: {
+      "@": srcDir,
+      // TT collects used native components from plugin-inject's export barrel.
+      // Only replace the internal native entry; preserve the SDK runtime wrapper.
+      ...(isTt ? {
+        '#miniapp-open-card-native': '@tarojs/plugin-inject/dist/components-react.js',
+      } : {}),
+      "lucide-taro": fs.existsSync(legacyIconEntry)
+        ? legacyIconEntry
+        : '@open-dy/lucide-taro',
+    },
+    plugins: [
+      [
+        path.resolve(SDK_DIR, "plugins/app-config.cjs"),
+        { previewBasePath }
+      ],
+      [
+        "@tarojs/plugin-inject", // 注入抖音小程序的一些原生事件
+        {
+          components: {
+            // Registers the host-side MiniappOpenCard mapping. Business code
+            // imports MiniappOpenCard from the Taro SDK; its props,
+            // domain rules, and rendering requirements live in the Skill
+            // reference rather than in this build-only plugin configuration.
+            MiniappOpenCard: {
+              'app-id': JSON.stringify(OPEN_CARD_ID),
+              path: '',
+              'init-data': '',
+              'env-version': '',
+              bindLoad: '',
+              bindError: '',
+            },
+            Button: {
+              'bindaddshortcut': '', // 注入 bindaddshortcut 事件，当openType为addShortcut时回调触发
+              'data-video-id': '', // 注入 data-video-id 属性，当openType为navigateToVideoView时，指定跳转的视频id
+              'data-video-type': '', // 注入 data-video-type 属性，当openType为navigateToVideoView时，指定跳转的视频类型
+              'bindnavigatetovideoview': '', // 注入 bindnavigatetovideoview 事件，当openType为navigateToVideoView时回调触发
+            },
+            ChannelVideo: {
+              'item-id': '',
+              'item-id-type': "'raw'",
+              autoplay: 'false',
+              loop: 'false',
+              'object-fit': "'contain'",
+              preload: 'false',
+              bindplay: '',
+              bindpause: '',
+              bindwaiting: '',
+              bindstop: '',
+              bindend: '',
+              bindprogress: '',
+              binderror: '',
+            },
+          },
+          componentsMap: {
+            MiniappOpenCard: "miniapp-open-card",
+            ChannelVideo: 'channel-video',
+          },
+          voidComponents: ['channel-video'],
+        }
+      ],
+    ],
+    defineConstants: {
+      PROJECT_DOMAIN: JSON.stringify(PROJECT_DOMAIN),
+      DOUYIN_CLOUD_ENV_ID: JSON.stringify(DOUYIN_CLOUD_ENV_ID),
+      DOUYIN_CLOUD_DEV_ENV_ID: JSON.stringify(DOUYIN_CLOUD_DEV_ENV_ID),
+      DOUYIN_CLOUD_SERVICE_ID: JSON.stringify(DOUYIN_CLOUD_SERVICE_ID),
+      OPEN_CARD_ID: JSON.stringify(OPEN_CARD_ID),
+      AUDIT_DOUYIN_CLOUD_ENV_ID: JSON.stringify(AUDIT_DOUYIN_CLOUD_ENV_ID),
+      AUDIT_DOUYIN_CLOUD_SERVICE_ID: JSON.stringify(AUDIT_DOUYIN_CLOUD_SERVICE_ID),
+      UPLOAD_URL: JSON.stringify(UPLOAD_URL),
+      DOWNLOAD_URL: JSON.stringify(DOWNLOAD_URL),
+    },
+    copy: {
+      patterns: [],
+      options: {},
+    },
+    jsMinimizer: "esbuild",
+    framework: "react",
+    compiler: {
+      type: "vite",
+      vitePlugins: [
+        ...(isTt ? [viteTtComponentsEntryPlugin()] : []),
+        viteDependCardPlugin(),
+        viteTaroSourceLocationPlugin({
+          enabled: isDevBuild,
+          projectRoot,
+        }),
+        {
+          name: "build-sourcemap",
+          config(config) {
+            if (!isTt && !isDevBuild) {
+              return;
+            }
+            config.build = config.build ?? {};
+            config.build.sourcemap = true;
+            if (isDevBuild) {
+              config.build.minify = false;
+            }
+          },
+        },
+        viteInlineJsonPlugin({
+          projectRoot,
+        }),
+        viteImageAssetImportPlugin({
+          projectRoot,
+        }),
+        ...(isH5
+          ? []
+          : [
+              UnifiedViteWeappTailwindcssPlugin({
+                rem2rpx: true,
+                cssEntries: [path.resolve(srcDir, "app.css")],
+                cssSelectorReplacement: {
+                  universal: ['view', 'text', 'page'],
+                },
+              }),
+            ]),
+        {
+          name: "postcss-config-loader-plugin",
+          config(config) {
+            if (typeof config.css?.postcss === "object") {
+              config.css?.postcss.plugins?.unshift(tailwindcss());
+            }
+          },
+        },
+        {
+          // Avoid a separate pre-bundled lucide-taro chunk in H5 dev.
+          name: "lucide-taro-alias-fix",
+          config(config) {
+            config.optimizeDeps = config.optimizeDeps ?? {};
+            config.optimizeDeps.exclude = [...new Set([
+              ...(config.optimizeDeps.exclude ?? []),
+              "lucide-taro",
+              "@open-dy/lucide-taro",
+            ])];
+          },
+        },
+        {
+          name: "cloud-preview-hmr-path",
+          config() {
+            if (!isH5 || !previewBasePath) {
+              return;
+            }
+            return {
+              server: {
+                hmr: {
+                  path: `/ws`,
+                },
+              },
+            };
+          },
+        },
+        {
+          name: "allow-all-hosts",
+          configureServer(server) {
+            server.config.server.allowedHosts = true;
+          },
+        },
+        {
+          name: "vite-optimized-deps-no-cache",
+          configureServer(server: any) {
+            if (!isH5 || process.env.NODE_ENV === "production") {
+              return;
+            }
+            server.middlewares.use((req: any, res: any, next: any) => {
+              if (!isViteOptimizedDepsRequest(req.url)) {
+                return next();
+              }
+              const originalSetHeader = res.setHeader.bind(res);
+              res.setHeader = ((name: string, value: string | number | readonly string[]) => {
+                if (name.toLowerCase() === "cache-control") {
+                  return originalSetHeader(name, "no-cache");
+                }
+                return originalSetHeader(name, value);
+              }) as typeof res.setHeader;
+              next();
+            });
+          },
+        },
+        {
+          name: "preview-history-fallback",
+          configureServer(server) {
+            server.middlewares.use((req, res, next) => {
+              if (!shouldRewritePreviewRequest(req)) {
+                return next();
+              }
+              if (
+                previewBasePath &&
+                req.url?.startsWith(previewBasePath) &&
+                !req.url.startsWith(`${previewBasePath}/ws`) &&
+                !req.url.includes("/@vite/") &&
+                !/\.[a-zA-Z0-9]+($|\?)/.test(req.url)
+              ) {
+                const urlObj = new URL(req.url, `http://${req.headers.host}`);
+                urlObj.pathname = `${previewBasePath}/`;
+                req.url = urlObj.pathname + urlObj.search;
+              }
+              next();
+            });
+          },
+        },
+        {
+          // app.config 改动需重建路由/入口，普通 HMR 无效。Taro 常驻
+          // viteCompilerContext 的 app/pages 在进程启动时定死，因此要在同一
+          // context 上原地刷新 app/pages。H5 侧仍触发 dev server 重启，并重置
+          // loaderMeta（规避 taro-react 字符串拼接累积导致的 React import 重复）。
+          // tt 侧显式 watch app.config.ts，页面配置由 Taro 自身监听。
+          // 两者变化时都在下一轮编译前刷新 context，让 JSON 和页面 JS 使用新配置。
+          name: "refresh-on-app-config-change",
+          async buildStart() {
+            if (!shouldRefreshAppConfigOnUpdate) {
+              return;
+            }
+            if (isTt && this.meta.watchMode) {
+              this.addWatchFile(appConfigPath);
+            }
+            try {
+              const info = await (this as any).load({ id: "taro:compiler" });
+              const ctx = (info?.meta as any)?.viteCompilerContext;
+              if (ctx) {
+                taroCompilerContext = ctx;
+                if (isTt && this.meta.watchMode && shouldRefreshTtConfig) {
+                  refreshTaroCompilerContext(ctx);
+                  shouldRefreshTtConfig = false;
+                }
+              }
+            } catch {
+              // 取不到时静默降级。
+            }
+          },
+          watchChange(id) {
+            if (!isTt || !this.meta.watchMode) {
+              return;
+            }
+            const configPath = path.normalize(id.split("?")[0].split("#")[0]);
+            const isPageConfig = taroCompilerContext?.pages?.some(
+              (page: { configPath?: string }) =>
+                typeof page?.configPath === "string" &&
+                path.normalize(page.configPath) === configPath,
+            );
+            if (configPath === path.normalize(appConfigPath) || isPageConfig) {
+              shouldRefreshTtConfig = true;
+            }
+          },
+          handleHotUpdate({ file, server }) {
+            if (!isH5) {
+              return;
+            }
+            if (file === appConfigPath) {
+              server.config.logger.info(
+                "[refresh-on-app-config-change] app.config 变化，重启 dev server...",
+                { timestamp: true },
+              );
+              const ctx = taroCompilerContext;
+              if (ctx) {
+                try {
+                  refreshTaroCompilerContext(ctx, { resetLoaderMeta: true });
+                } catch {
+                  // 刷新失败时退回到「仅重启」。
+                }
+              }
+              server.restart();
+              return [];
+            }
+          },
+        },
+        networkUrlAnalyzerPlugin(srcDir),
+        {
+          name: "inject-dev-scripts",
+          transform(code: string, id: string) {
+            if (!isH5 || process.env.NODE_ENV === "production") {
+              return null;
+            }
+            if (!isAppEntry(id)) {
+              return null;
+            }
+            return `${code}\n${injectedViteErrorReporter}\n${injectedRouteHealer}`;
+          },
+          transformIndexHtml(html: string) {
+            if (!isH5 || process.env.NODE_ENV === "production") {
+              return html;
+            }
+            return html.replace(
+              "</head>",
+              `  <script>window.__CONSOLE_BRIDGE_CONFIG__ = Object.assign({}, window.__CONSOLE_BRIDGE_CONFIG__, { appType: "microapp" });</script>\n  <script src="https://lf3-static.bytednsdoc.com/obj/eden-cn/lm_wwhpupt_ylwvslclk/ljhwZthlaukjlkulzlp/vibe-coding-inject/console-proxy.js?t=${Date.now()}"></script>\n  <script src="https://lf3-static.bytednsdoc.com/obj/eden-cn/lm_wwhpupt_ylwvslclk/ljhwZthlaukjlkulzlp/vibe-coding-inject/vite-overlay-observer.js?t=${Date.now()}"></script>\n</head>`,
+            );
+          },
+        },
+      ],
+    },
+    cache: {
+      enable: true, // Webpack 持久化缓存配置，建议开启。默认配置请参考：https://docs.taro.zone/docs/config-detail#cache
+    },
+    mini: {
+      postcss: {
+        pxtransform: {
+          enable: true,
+          config: {},
+        },
+        cssModules: {
+          enable: false, // 默认为 false，如需使用 css modules 功能，则设为 true
+          config: {
+            namingPattern: "module", // 转换模式，取值为 global/module
+            generateScopedName: "[name]__[local]___[hash:base64:5]",
+          },
+        },
+      },
+    },
+    h5: {
+      publicPath: "/",
+      staticDirectory: "static",
+      miniCssExtractPluginOption: {
+        ignoreOrder: true,
+        filename: "css/[name].[hash].css",
+        chunkFilename: "css/[name].[chunkhash].css",
+      },
+      postcss: {
+        autoprefixer: {
+          enable: true,
+          config: {},
+        },
+        cssModules: {
+          enable: false, // 默认为 false，如需使用 css modules 功能，则设为 true
+          config: {
+            namingPattern: "module", // 转换模式，取值为 global/module
+            generateScopedName: "[name]__[local]___[hash:base64:5]",
+          },
+        },
+      },
+    },
+    rn: {
+      appName: "taroDemo",
+      postcss: {
+        cssModules: {
+          enable: false, // 默认为 false，如需使用 css modules 功能，则设为 true
+        },
+      },
+    },
+  };
+  if (process.env.NODE_ENV === "development") {
+    // 本地开发构建配置（不混淆压缩）
+    const config = merge({}, baseConfig, devConfig)
+    return applyConfigOverrides(config, options.overrides, {
+      isH5,
+      isTt,
+      mode: process.env.NODE_ENV ?? '',
+      projectRoot,
+    })
+  }
+  // 生产构建配置（默认开启压缩混淆等）
+  const config = merge({}, baseConfig, prodConfig)
+  return applyConfigOverrides(config, options.overrides, {
+    isH5,
+    isTt,
+    mode: process.env.NODE_ENV ?? '',
+    projectRoot,
+  })
+ }) as UserConfigExport
+}