openxiangda 1.0.34 → 1.0.36

package/packages/sdk/dist/styles/tokens.css

@@ -1,4 +1,5 @@
 :root,
+:root,
 .sy-app-workspace {
   --sy-color-primary: #1677ff;
   --sy-color-primary-hover: #4096ff;

package/packages/sdk/src/build-source/scripts/build-forms.mjs

@@ -9,7 +9,7 @@ import path from "node:path";
 import { fileURLToPath } from "node:url";
 import { gzipSync } from "node:zlib";
 import { build } from "vite";
-import { rootDir } from "./utils/load-config.mjs";
+import { loadConfig, rootDir } from "./utils/load-config.mjs";
 import {
   cleanBuildCache,
   commitIncrementalBuild,
@@ -36,6 +36,7 @@ const tmpDir = path.join(rootDir, ".tmp");
 const runtimeVersionPlaceholder = "__SY_FORM_RUNTIME_VERSION__";
 const runtimeCacheFileName = "build-cache.json";
 const portalContainerResolverGlobal = "__OPENXIANGDA_GET_PORTAL_CONTAINER__";
+let workspaceConfigPromise = null;
 
 const runtimePackages = [
   "react",
@@ -73,6 +74,20 @@ function readTextIfExists(filePath) {
   return fs.readFileSync(filePath, "utf-8");
 }
 
+function normalizeCssIsolation(value) {
+  if (value === "namespace" || value === "shadow") return value;
+  return "none";
+}
+
+function usesNamespaceCss(cssIsolation) {
+  return cssIsolation === "namespace" || cssIsolation === "shadow";
+}
+
+function getWorkspaceConfig() {
+  if (!workspaceConfigPromise) workspaceConfigPromise = loadConfig();
+  return workspaceConfigPromise;
+}
+
 function readPackageVersion(packageName) {
   try {
     let current = path.dirname(require.resolve(packageName));
@@ -92,10 +107,11 @@ function readPackageVersion(packageName) {
   }
 }
 
-function createRuntimeInputHash(runtimeEntryContent) {
+function createRuntimeInputHash(runtimeEntryContent, cssIsolation) {
   const hash = crypto.createHash("sha256");
   const configFiles = [
     path.join(rootDir, "src/index.css"),
+    path.join(rootDir, "app-workspace.config.ts"),
     path.join(rootDir, "tailwind.config.cjs"),
     path.join(rootDir, "postcss.config.cjs"),
     fileURLToPath(import.meta.url),
@@ -107,6 +123,7 @@ function createRuntimeInputHash(runtimeEntryContent) {
 
   hash.update("sy-form-runtime-v2-input");
   hash.update(runtimeEntryContent);
+  hash.update(normalizeCssIsolation(cssIsolation));
   hash.update(JSON.stringify(packageVersions));
   configFiles.forEach((filePath) => {
     hash.update(filePath);
@@ -115,18 +132,21 @@ function createRuntimeInputHash(runtimeEntryContent) {
   return hash.digest("hex");
 }
 
-async function createCssOptions() {
+async function createCssOptions(cssIsolation = "none") {
   const tailwindcssModule = await import("tailwindcss");
   const autoprefixerModule = await import("autoprefixer");
   const tailwindcss = tailwindcssModule.default ?? tailwindcssModule;
   const autoprefixer = autoprefixerModule.default ?? autoprefixerModule;
+  const plugins = [
+    tailwindcss({ config: path.join(rootDir, "tailwind.config.cjs") }),
+  ];
+  if (usesNamespaceCss(normalizeCssIsolation(cssIsolation))) {
+    plugins.push(createNamespaceCssPlugin());
+  }
+  plugins.push(autoprefixer());
   return {
     postcss: {
-      plugins: [
-        tailwindcss({ config: path.join(rootDir, "tailwind.config.cjs") }),
-        createNamespaceCssPlugin(),
-        autoprefixer(),
-      ],
+      plugins,
     },
   };
 }
@@ -241,7 +261,7 @@ import { StyleProvider } from '@ant-design/cssinjs';
 import { App as AntdApp, ConfigProvider, message } from 'antd';
 import zhCN from 'antd/locale/zh_CN';
 import * as SyFormComponentsModule from 'openxiangda';
-import { antdTheme } from 'openxiangda/antd-theme';
+import { antdTheme, legacyAntdTheme } from 'openxiangda/antd-theme';
 import 'antd-mobile/es/global';
 import '../src/index.css';
 
@@ -256,6 +276,33 @@ const PORTAL_CONTAINER_RESOLVER_GLOBAL = '${portalContainerResolverGlobal}';
 const MESSAGE_PROXY_GLOBAL = '__OPENXIANGDA_ANTD_MESSAGE_PROXY__';
 const MESSAGE_METHODS = ['open', 'success', 'info', 'warning', 'error', 'loading', 'destroy'];
 const portalContainers = new WeakMap();
+const portalCssIsolations = new WeakMap();
+
+function normalizeRuntimeCssIsolation(value) {
+  return value === 'namespace' || value === 'shadow' ? value : 'none';
+}
+
+function getRuntimeCssIsolation(context = {}) {
+  return normalizeRuntimeCssIsolation(
+    context.cssIsolation ||
+      context.runtime?.cssIsolation ||
+      context.page?.capabilities?.cssIsolation,
+  );
+}
+
+function usesLegacyCssIsolation(cssIsolation) {
+  return cssIsolation === 'namespace' || cssIsolation === 'shadow';
+}
+
+function getAntdRuntimeOptions(cssIsolation) {
+  const legacy = usesLegacyCssIsolation(cssIsolation);
+  return {
+    prefixCls: legacy ? 'sy-ant' : 'ant',
+    iconPrefixCls: legacy ? 'sy-anticon' : 'anticon',
+    messagePrefixCls: legacy ? 'sy-ant-message' : 'ant-message',
+    theme: legacy ? legacyAntdTheme : antdTheme,
+  };
+}
 
 function getStyleContainer(el) {
   const rootNode = el.getRootNode?.();
@@ -291,14 +338,19 @@ function getTargetContainer(el) {
   return () => getRuntimeRoot(el);
 }
 
-function createAntdConfig(el, portalContainer) {
+function createAntdConfig(el, portalContainer, cssIsolation) {
+  const antdOptions = getAntdRuntimeOptions(cssIsolation);
   return {
     locale: zhCN,
-    prefixCls: 'sy-ant',
-    iconPrefixCls: 'sy-anticon',
-    theme: antdTheme,
-    getPopupContainer: getPopupContainer(el, portalContainer),
-    getTargetContainer: getTargetContainer(el),
+    prefixCls: antdOptions.prefixCls,
+    iconPrefixCls: antdOptions.iconPrefixCls,
+    theme: antdOptions.theme,
+    ...(usesLegacyCssIsolation(cssIsolation)
+      ? {
+          getPopupContainer: getPopupContainer(el, portalContainer),
+          getTargetContainer: getTargetContainer(el),
+        }
+      : {}),
   };
 }
 
@@ -352,12 +404,15 @@ function registerAntdMessageApi(api) {
   };
 }
 
-function installRuntimePortalContainer(el) {
-  const portalContainer = createPortalContainer(el);
+function installRuntimePortalContainer(el, cssIsolation) {
+  const portalContainer = usesLegacyCssIsolation(cssIsolation)
+    ? createPortalContainer(el)
+    : null;
   const stack = Array.isArray(globalThis[PORTAL_CONTAINER_STACK_GLOBAL])
     ? globalThis[PORTAL_CONTAINER_STACK_GLOBAL]
     : [];
-  stack.push(portalContainer);
+  const stackTarget = portalContainer || el.ownerDocument.body;
+  stack.push(stackTarget);
   globalThis[PORTAL_CONTAINER_STACK_GLOBAL] = stack;
   globalThis[PORTAL_CONTAINER_RESOLVER_GLOBAL] = () => {
     for (let index = stack.length - 1; index >= 0; index -= 1) {
@@ -375,39 +430,44 @@ function installRuntimePortalContainer(el) {
   return {
     container: portalContainer,
     release: () => {
-      const position = stack.lastIndexOf(portalContainer);
+      const position = stack.lastIndexOf(stackTarget);
       if (position >= 0) stack.splice(position, 1);
-      portalContainer.remove();
+      portalContainer?.remove();
     },
   };
 }
 
-function installAntdStaticHolder(el, portalContainer) {
+function installAntdStaticHolder(el, portalContainer, cssIsolation) {
   installAntdMessageProxy();
+  const antdOptions = getAntdRuntimeOptions(cssIsolation);
   const getMessageContainer = () =>
-    portalContainer?.isConnected ? portalContainer : getRuntimeRoot(el);
+    portalContainer?.isConnected
+      ? portalContainer
+      : usesLegacyCssIsolation(cssIsolation)
+        ? getRuntimeRoot(el)
+        : document.body;
 
   ConfigProvider.config({
-    prefixCls: 'sy-ant',
-    iconPrefixCls: 'sy-anticon',
-    theme: antdTheme,
+    prefixCls: antdOptions.prefixCls,
+    iconPrefixCls: antdOptions.iconPrefixCls,
+    theme: antdOptions.theme,
     holderRender: (children) => {
       if (!el.isConnected) {
         return (
-          <ConfigProvider prefixCls="sy-ant" iconPrefixCls="sy-anticon" theme={antdTheme}>
+          <ConfigProvider prefixCls={antdOptions.prefixCls} iconPrefixCls={antdOptions.iconPrefixCls} theme={antdOptions.theme}>
             {children}
           </ConfigProvider>
         );
       }
       return (
         <StyleProvider hashPriority="high" container={getStyleContainer(el)}>
-          <ConfigProvider {...createAntdConfig(el, portalContainer)}>{children}</ConfigProvider>
+          <ConfigProvider {...createAntdConfig(el, portalContainer, cssIsolation)}>{children}</ConfigProvider>
         </StyleProvider>
       );
     },
   });
   message.config({
-    prefixCls: 'sy-ant-message',
+    prefixCls: antdOptions.messagePrefixCls,
     getContainer: getMessageContainer,
   });
 }
@@ -422,42 +482,62 @@ function RuntimeMessageBridge({ children }) {
 
 function renderStandardForm(el, schemaInput, context = {}) {
   let root = roots.get(el);
-  el.classList.add(NAMESPACE_ROOT_CLASS);
+  const cssIsolation = getRuntimeCssIsolation(context);
+  if (usesLegacyCssIsolation(cssIsolation)) {
+    el.classList.add(NAMESPACE_ROOT_CLASS);
+  } else {
+    el.classList.remove(NAMESPACE_ROOT_CLASS);
+  }
   let portalContainer = portalContainers.get(el);
-  if (!portalContainer?.isConnected) {
+  const previousCssIsolation = portalCssIsolations.get(el);
+  if (
+    previousCssIsolation !== cssIsolation ||
+    (usesLegacyCssIsolation(cssIsolation) && !portalContainer?.isConnected) ||
+    (!usesLegacyCssIsolation(cssIsolation) && portalContainer)
+  ) {
     const cleanup = portalContainerCleanups.get(el);
     if (cleanup) cleanup();
-    const portalHandle = installRuntimePortalContainer(el);
+    const portalHandle = installRuntimePortalContainer(el, cssIsolation);
     portalContainer = portalHandle.container;
-    portalContainers.set(el, portalContainer);
+    if (portalContainer) {
+      portalContainers.set(el, portalContainer);
+    } else {
+      portalContainers.delete(el);
+    }
+    portalCssIsolations.set(el, cssIsolation);
     portalContainerCleanups.set(el, portalHandle.release);
   }
-  installAntdStaticHolder(el, portalContainer);
+  installAntdStaticHolder(el, portalContainer, cssIsolation);
   if (!root) {
     root = createRoot(el);
     roots.set(el, root);
   }
 
   const schema = defineFormSchema(schemaInput);
-  const antdConfig = createAntdConfig(el, portalContainer);
+  const antdConfig = createAntdConfig(el, portalContainer, cssIsolation);
+  const content = (
+    <StandardFormPage
+      schema={schema}
+      mode={context.mode || 'submit'}
+      initialValues={context.initialValues}
+      permissions={context.permissions}
+      formUuid={context.formUuid}
+      appType={context.appType}
+      formInstanceId={context.formInstanceId}
+      onSubmit={context.onSubmit}
+      inDrawer={context.inDrawer}
+    />
+  );
   root.render(
     <StyleProvider hashPriority="high" container={getStyleContainer(el)}>
       <ConfigProvider {...antdConfig}>
         <AntdApp>
           <RuntimeMessageBridge>
-            <div className="sy-app-workspace">
-              <StandardFormPage
-                schema={schema}
-                mode={context.mode || 'submit'}
-                initialValues={context.initialValues}
-                permissions={context.permissions}
-                formUuid={context.formUuid}
-                appType={context.appType}
-                formInstanceId={context.formInstanceId}
-                onSubmit={context.onSubmit}
-                inDrawer={context.inDrawer}
-              />
-            </div>
+            {usesLegacyCssIsolation(cssIsolation) ? (
+              <div className="sy-app-workspace">{content}</div>
+            ) : (
+              content
+            )}
           </RuntimeMessageBridge>
         </AntdApp>
       </ConfigProvider>
@@ -476,6 +556,7 @@ function unmountStandardForm(el) {
     releasePortalContainer();
     portalContainerCleanups.delete(el);
     portalContainers.delete(el);
+    portalCssIsolations.delete(el);
   }
 }
 
@@ -670,7 +751,9 @@ function logRuntimeAssetSummary(prefix = "共享 runtime") {
 async function buildSharedRuntime(options = {}) {
   const startedAt = Date.now();
   const entryContent = createRuntimeEntryContent();
-  const inputHash = createRuntimeInputHash(entryContent);
+  const config = await getWorkspaceConfig();
+  const cssIsolation = normalizeCssIsolation(config.defaults?.cssIsolation);
+  const inputHash = createRuntimeInputHash(entryContent, cssIsolation);
   if (options.runtimeCache !== false && isRuntimeCacheValid(inputHash)) {
     console.log("[build] 表单共享 runtime 缓存命中，跳过构建");
     logRuntimeAssetSummary("缓存 runtime");
@@ -681,7 +764,7 @@ async function buildSharedRuntime(options = {}) {
 
   try {
     console.log("[build] 构建表单共享 runtime");
-    const cssOptions = await createCssOptions();
+    const cssOptions = await createCssOptions(cssIsolation);
     const reactPlugin = await createReactPlugin();
     await build({
       configFile: false,
@@ -828,7 +911,9 @@ async function buildForm(form) {
 
   try {
     console.log(`[build] 构建表单: ${form.name} (shared runtime)`);
-    const cssOptions = await createCssOptions();
+    const config = await getWorkspaceConfig();
+    const cssIsolation = normalizeCssIsolation(config.defaults?.cssIsolation);
+    const cssOptions = await createCssOptions(cssIsolation);
     const reactPlugin = await createReactPlugin();
     await build({
       configFile: false,

package/packages/sdk/src/build-source/scripts/build-pages.mjs

@@ -23,6 +23,7 @@ import {
   formatExtractedAssetSummary,
 } from "./utils/static-assets.mjs";
 import { warnShadcnTailwindTokens } from "./utils/tailwind-token-warnings.mjs";
+import { loadConfig } from "./utils/load-config.mjs";
 
 process.env.NODE_ENV = "production";
 process.env.BABEL_ENV = "production";
@@ -40,6 +41,7 @@ const runtimeDistDir = path.join(distRoot, "page-runtime");
 const runtimeVersionPlaceholder = "__SY_PAGE_RUNTIME_VERSION__";
 const runtimeCacheFileName = "build-cache.json";
 const portalContainerResolverGlobal = "__OPENXIANGDA_GET_PORTAL_CONTAINER__";
+let workspaceConfigPromise = null;
 
 const runtimePackages = [
   "react",
@@ -115,6 +117,20 @@ function readTextIfExists(filePath) {
   return fsSync.readFileSync(filePath, "utf-8");
 }
 
+function normalizeCssIsolation(value) {
+  if (value === "namespace" || value === "shadow") return value;
+  return "none";
+}
+
+function usesNamespaceCss(cssIsolation) {
+  return cssIsolation === "namespace" || cssIsolation === "shadow";
+}
+
+function getWorkspaceConfig() {
+  if (!workspaceConfigPromise) workspaceConfigPromise = loadConfig();
+  return workspaceConfigPromise;
+}
+
 function readPackageVersion(packageName) {
   try {
     let current = path.dirname(require.resolve(packageName));
@@ -208,7 +224,7 @@ build-pages - 构建复杂代码页
 `);
 }
 
-function createRuntimeInputHash(runtimeEntryContent) {
+function createRuntimeInputHash(runtimeEntryContent, cssIsolation) {
   const hash = crypto.createHash("sha256");
   const packageVersions = runtimePackages.reduce((result, packageName) => {
     result[packageName] = readPackageVersion(packageName);
@@ -216,6 +232,7 @@ function createRuntimeInputHash(runtimeEntryContent) {
   }, {});
   const configFiles = [
     path.join(rootDir, "src/index.css"),
+    path.join(rootDir, "app-workspace.config.ts"),
     path.join(rootDir, "tailwind.config.cjs"),
     path.join(rootDir, "postcss.config.cjs"),
     fileURLToPath(import.meta.url),
@@ -223,6 +240,7 @@ function createRuntimeInputHash(runtimeEntryContent) {
 
   hash.update("sy-page-runtime-v1-input");
   hash.update(runtimeEntryContent);
+  hash.update(normalizeCssIsolation(cssIsolation));
   hash.update(JSON.stringify(packageVersions));
   configFiles.forEach((filePath) => {
     hash.update(filePath);
@@ -329,18 +347,21 @@ function isRuntimeCacheValid(inputHash) {
   return true;
 }
 
-async function createCssOptions() {
+async function createCssOptions(cssIsolation = "none") {
   const tailwindcssModule = await import("tailwindcss");
   const autoprefixerModule = await import("autoprefixer");
   const tailwindcss = tailwindcssModule.default ?? tailwindcssModule;
   const autoprefixer = autoprefixerModule.default ?? autoprefixerModule;
+  const plugins = [
+    tailwindcss({ config: path.join(rootDir, "tailwind.config.cjs") }),
+  ];
+  if (usesNamespaceCss(normalizeCssIsolation(cssIsolation))) {
+    plugins.push(createNamespaceCssPlugin());
+  }
+  plugins.push(autoprefixer());
   return {
     postcss: {
-      plugins: [
-        tailwindcss({ config: path.join(rootDir, "tailwind.config.cjs") }),
-        createNamespaceCssPlugin(),
-        autoprefixer(),
-      ],
+      plugins,
     },
   };
 }
@@ -375,7 +396,9 @@ function createResolveAlias() {
 async function buildSharedRuntime(options = {}) {
   const startedAt = Date.now();
   const entryContent = createRuntimeEntryContent();
-  const inputHash = createRuntimeInputHash(entryContent);
+  const config = await getWorkspaceConfig();
+  const cssIsolation = normalizeCssIsolation(config.defaults?.cssIsolation);
+  const inputHash = createRuntimeInputHash(entryContent, cssIsolation);
   if (options.runtimeCache !== false && isRuntimeCacheValid(inputHash)) {
     const manifest = readRuntimeManifest();
     console.log(`[build] 代码页共享 runtime 缓存命中: ${manifest.version}`);
@@ -386,7 +409,7 @@ async function buildSharedRuntime(options = {}) {
   await fs.writeFile(entryPath, entryContent, "utf8");
 
   try {
-    const cssOptions = await createCssOptions();
+    const cssOptions = await createCssOptions(cssIsolation);
     console.log("[build] 构建代码页共享 runtime");
     await build({
       configFile: false,
@@ -692,7 +715,11 @@ async function buildPage(page) {
   const outDir = path.join(distRoot, "pages", page.config.code);
   await fs.mkdir(outDir, { recursive: true });
 
-  const cssOptions = await createCssOptions();
+  const config = await getWorkspaceConfig();
+  const cssIsolation = normalizeCssIsolation(
+    page.config.cssIsolation || config.defaults?.cssIsolation,
+  );
+  const cssOptions = await createCssOptions(cssIsolation);
   await build({
     configFile: false,
     mode: "production",

package/packages/sdk/src/build-source/scripts/register.mjs

@@ -130,6 +130,7 @@ async function registerForms() {
         runtime,
         formCssPath: path.resolve(rootDir, `dist/forms/${formName}/style.css`),
       }),
+      cssIsolation: config.defaults.cssIsolation,
       version: config.version,
     };
     if (runtime) {
@@ -164,6 +165,7 @@ async function registerForms() {
           ? {
               bundleUrl: payload.bundleUrl,
               cssUrl: payload.cssUrl,
+              cssIsolation: payload.cssIsolation,
               version: payload.version,
               runtimeMode: payload.runtimeMode,
               runtime: payload.runtime,

package/packages/sdk/src/build-source/scripts/utils/form-api.mjs

@@ -52,6 +52,7 @@ function ensureResourceBuckets(bound) {
   bound.resources.automations = bound.resources.automations || {};
   bound.resources.menus = bound.resources.menus || {};
   bound.resources.roles = bound.resources.roles || {};
+  bound.resources.dataViews = bound.resources.dataViews || {};
   bound.resources.pagePermissionGroups = bound.resources.pagePermissionGroups || {};
   bound.resources.formPermissionGroups = bound.resources.formPermissionGroups || {};
 }

package/packages/sdk/src/build-source/scripts/utils/load-config.mjs

@@ -111,13 +111,14 @@ function normalizeBaseUrl(value) {
 
 function normalizeCssIsolation(value) {
   if (value === "none") return "none";
+  if (value === "namespace") return "namespace";
   if (value === "shadow") {
     console.warn(
-      "[lowcode-workspace] cssIsolation='shadow' is deprecated; use 'namespace' instead.",
+      "[lowcode-workspace] cssIsolation='shadow' is deprecated; use 'none' unless legacy isolation is required.",
     );
     return "shadow";
   }
-  return "namespace";
+  return "none";
 }
 
 export function resolveOpenXiangdaEndpointConfig(baseUrl) {

package/packages/sdk/src/build-source/scripts/utils/register-payload.test.ts

@@ -19,7 +19,7 @@ const config = {
   defaults: {
     frameworkVersion: "19.0.0",
     protocolVersion: "1.0",
-    cssIsolation: "namespace",
+    cssIsolation: "none",
     pageMenuParentId: "MENU_PARENT",
     pageMenuIcon: "dashboard",
   },
@@ -105,6 +105,7 @@ describe("register payload helpers", () => {
       hidePlatformNav: true,
       defaultRoute: "home",
     });
+    expect(payload.pages[0].runtime.cssIsolation).toBe("none");
     expect(JSON.stringify(payload)).not.toMatch(/manifest/i);
   });
 

package/packages/sdk/src/build-source/scripts/utils/tailwind-config.mjs

@@ -29,12 +29,10 @@ const layeredTailwindCss = `@layer tailwind-base {
 `;
 const canonicalPostcssConfig = `const tailwindcss = require("tailwindcss");
 const autoprefixer = require("autoprefixer");
-const { createOpenXiangdaNamespaceCssPlugin } = require("openxiangda/build");
 
 module.exports = {
   plugins: [
     tailwindcss(),
-    createOpenXiangdaNamespaceCssPlugin(),
     autoprefixer(),
   ],
 };
@@ -83,10 +81,10 @@ export function isWorkspaceTailwindCssCurrent(content) {
 
 export function isWorkspacePostcssConfigCurrent(content) {
   return Boolean(
-    content.includes("createOpenXiangdaNamespaceCssPlugin") &&
-      content.includes("openxiangda/build") &&
-      content.includes("tailwindcss") &&
-      content.includes("autoprefixer"),
+    !content.includes("createOpenXiangdaNamespaceCssPlugin") &&
+      /plugins\s*:\s*\[[\s\S]*tailwindcss\(\)[\s\S]*autoprefixer\(/s.test(
+        content,
+      ),
   );
 }
 
@@ -211,7 +209,11 @@ function isStandardPostcssConfig(content) {
 
 export function patchWorkspacePostcssConfig(content) {
   if (isWorkspacePostcssConfigCurrent(content)) return content;
-  if (!content.trim() || isStandardPostcssConfig(content)) {
+  if (
+    !content.trim() ||
+    isStandardPostcssConfig(content) ||
+    content.includes("createOpenXiangdaNamespaceCssPlugin")
+  ) {
     return canonicalPostcssConfig;
   }
   return content;

package/packages/sdk/src/build-source/scripts/utils/tailwind-config.test.ts

@@ -58,8 +58,10 @@ describe("workspace Tailwind config helpers", () => {
     expect(cssContent).toContain("@tailwind base;");
     expect(cssContent).toContain("@tailwind components;");
     expect(cssContent).toContain("@tailwind utilities;");
-    expect(postcssContent).toContain("createOpenXiangdaNamespaceCssPlugin");
-    expect(postcssContent).toContain('require("openxiangda/build")');
+    expect(postcssContent).toContain("tailwindcss()");
+    expect(postcssContent).toContain("autoprefixer()");
+    expect(postcssContent).not.toContain("createOpenXiangdaNamespaceCssPlugin");
+    expect(postcssContent).not.toContain('require("openxiangda/build")');
     expect(cssContent).not.toContain('@import "openxiangda/styles/tokens.css";');
     expect(validateWorkspaceTailwindConfig(workspaceRoot)).toEqual([]);
   });
@@ -176,7 +178,7 @@ module.exports = {
     expect(nextContent).toContain("#root");
   });
 
-  it("patches standard PostCSS config with openxiangda namespace css plugin", () => {
+  it("patches standard PostCSS config without the namespace css plugin", () => {
     const nextContent = patchWorkspacePostcssConfig(`module.exports = {
   plugins: {
     tailwindcss: {},
@@ -185,9 +187,9 @@ module.exports = {
 };
 `);
 
-    expect(nextContent).toContain("createOpenXiangdaNamespaceCssPlugin");
     expect(nextContent).toContain("tailwindcss()");
     expect(nextContent).toContain("autoprefixer()");
+    expect(nextContent).not.toContain("createOpenXiangdaNamespaceCssPlugin");
   });
 
   it("preserves custom PostCSS config when it cannot be patched safely", () => {

package/packages/sdk/src/build-source/src/cli.mjs

@@ -460,6 +460,22 @@ function rewriteLocalSdkConfig(workspaceRoot) {
   }
 }
 
+function rewriteCssIsolationDefault(workspaceRoot) {
+  const configPath = join(workspaceRoot, "app-workspace.config.ts");
+  if (!existsSync(configPath)) return;
+  replaceInFile(configPath, (content) =>
+    content.replace(
+      /cssIsolation:\s*\n\s*process\.env\.APP_PAGE_CSS_ISOLATION === ["']none["']\s*\n\s*\?\s*["']none["']\s*\n\s*:\s*process\.env\.APP_PAGE_CSS_ISOLATION === ["']shadow["']\s*\n\s*\?\s*["']shadow["']\s*\n\s*:\s*["']namespace["']/g,
+      `cssIsolation:
+      process.env.APP_PAGE_CSS_ISOLATION === "namespace"
+        ? "namespace"
+        : process.env.APP_PAGE_CSS_ISOLATION === "shadow"
+          ? "shadow"
+          : "none"`,
+    ),
+  );
+}
+
 function walkFiles(root, onFile) {
   for (const entry of readdirSync(root)) {
     if (ignoredDirs.has(entry)) continue;
@@ -675,6 +691,7 @@ async function updateWorkspace(argv, { migrate = false } = {}) {
 
   updatePackageJson(workspaceRoot, channel);
   rewriteImports(workspaceRoot);
+  rewriteCssIsolationDefault(workspaceRoot);
   ensureWorkspaceTailwindConfig(workspaceRoot);
   ensureWrapperScripts(workspaceRoot);
   rewriteLocalSdkConfig(workspaceRoot);

package/templates/sy-lowcode-app-workspace/app-workspace.config.ts

@@ -21,11 +21,11 @@ export default defineAppWorkspaceConfig({
     protocolVersion: process.env.APP_PAGE_PROTOCOL_VERSION || "1.0",
     frameworkVersion: process.env.APP_FRAMEWORK_VERSION || "18.3.1",
     cssIsolation:
-      process.env.APP_PAGE_CSS_ISOLATION === "none"
-        ? "none"
+      process.env.APP_PAGE_CSS_ISOLATION === "namespace"
+        ? "namespace"
         : process.env.APP_PAGE_CSS_ISOLATION === "shadow"
           ? "shadow"
-          : "namespace",
+          : "none",
     formMenuParentId: process.env.APP_FORM_MENU_PARENT_ID || "",
     formMenuIcon: process.env.APP_FORM_MENU_ICON || "",
     pageMenuParentId: process.env.APP_PAGE_MENU_PARENT_ID || "",

package/templates/sy-lowcode-app-workspace/examples/best-practices/decision-guide.md

@@ -42,8 +42,9 @@ Frontend code must not be responsible for data isolation or background jobs.
 For dynamic multi-role apps, create a business role table and synchronize it to
 platform app roles. User-facing scope fields should be maintainable controls:
 personnel/department fields for people and orgs, enum fields for fixed option
-sets, and association fields for classes, colleges, projects, customers, and
-other records maintained by forms. If the platform permission condition needs a
-scalar value, derive a hidden scope key such as `collegeScopeKey` or
+sets, and SDK-backed `SelectField` dropdowns for classes, colleges, projects,
+customers, and other records maintained by forms. Use `remoteSearch: true` when
+the source form can have many records. If the platform permission condition
+needs a scalar value, derive a hidden scope key such as `collegeScopeKey` or
 `ownerDeptScopeKey`. Use form permission groups with condition-style data
 permissions to enforce data isolation.