openyida 2026.9.17 → 2026.9.18-1

package/README.md

@@ -399,8 +399,8 @@ Run `openyida --help` or `openyida <command> --help` for detailed usage.
 | `openyida design-plan catalog [--json]` | List available planning themes and page patterns |
 | `openyida design-plan init <requirement-brief.json> [--theme-id <id>] [--output-dir <dir>] [--json]` | Initialize a plan draft from confirmed requirements |
 | `openyida design-plan preview <build-plan.json> --part-file <module.json> [--json]` | Update plan drafts by module |
-| `openyida design-plan materialize <build-plan.json> [--from-preview \| --business-file <json> --visual-file <json>] [--output-dir <dir>] [--check] [--json]` | Generate and validate design-plan artifacts from build-plan.json |
-| `openyida design-plan patch <build-plan.json> --set <path=value> [--set <path=value> ...] [--materialize] [--output-dir <dir>] [--json]` | Patch a design plan; asset progress preserves existing approval |
+| `openyida design-plan materialize <build-plan.json> [--from-preview \| --business-file <json> --visual-file <json>] [--output-dir <dir>] [--check] [--json]` | Generate or update plan documents and theme with consistency checks |
+| `openyida design-plan patch <build-plan.json> --set <path=value> [--set <path=value> ...] [--materialize] [--output-dir <dir>] [--json]` | Patch plan fields and optionally sync documents and theme |
 | `openyida update-app <appType> [--name "..."] [--desc "..."] [--icon <name>] [--icon-color <color>] [--colour <key>] [--theme-color <color>] [--theme-file <css>] [--nav-theme light\|dark\|white\|gray] [--logo-source appIcon\|customImage] [--layout side\|top\|l_shape] [--hide-app-nav\|--show-app-nav]` | Update app info |
 | `openyida app-online <appType> [--to-ding-app-center] [--show-app-center]` | Enable a Yida app |
 | `openyida app-offline <appType> [--to-ding-app-center] [--show-app-center]` | Disable a Yida app |
@@ -430,12 +430,13 @@ Run `openyida --help` or `openyida <command> --help` for detailed usage.
 | `openyida aggregate-table <list\|create-empty\|inspect\|preview\|save\|publish\|status> <appType> ...` | Manage aggregate tables (virtualView) |
 | `openyida get-schema <appType> <formUuid\|--all> [--summary-json\|--field-map-json\|--analysis-json]` | Get one form Schema or all form Schemas |
 | `openyida check-prd-completeness <prd.md> --app-type <appType> [--build-manifest <file>] [--json]` | Check PRD page/resource count risk |
+| `openyida check-design <design.md> [--prd <prd.md>] [--base-dir <dir>] [--json]` | Validate design documents, theme tokens and PRD handoff |
 | `openyida er <appType> [--format mermaid\|json] [--output file] [--include-system] [--include-pages]` | Export app entity relationship diagram |
 | `openyida create-page <appType> "<name>" [--mode dashboard] [--hide-nav] [--locale zh_CN\|en_US\|ja_JP] [--open\|--no-open]` | Create a custom display page |
 | `openyida build-page <sourceFile> [--output file\|--write]` | Build Yida-compatible page source |
-| `openyida check-page <src> [--compat]` | Check custom page standards |
-| `openyida compile <src> [--canvas] [--json]` | Compile custom page locally |
-| `openyida publish <src> <appType> <formUuid> [--health-check] [--force] [--canvas] [--auto-nav-order] [--open\|--no-open]` | Compile and publish custom page |
+| `openyida check-page <src> [--compat] [--json]` | Check custom page standards |
+| `openyida compile <src> [--canvas] [--compat] [--skip-lint] [--json]` | Compile custom page locally |
+| `openyida publish <src> <appType> <formUuid> [--health-check] [--force] [--canvas] [--compat] [--skip-lint] [--auto-nav-order] [--open\|--no-open] [--json]` | Compile and publish custom page |
 | `openyida update-form-config <appType> <formUuid> <true\|false\|keep> "<title>" [--locale zh_CN\|en_US\|ja_JP]` | Update form configuration |
 | `openyida get-form-config <appType> <formUuid> [--json]` | Query form configuration |
 
@@ -458,7 +459,7 @@ Run `openyida --help` or `openyida <command> --help` for detailed usage.
 | Command | Description |
 |---------|-------------|
 | `openyida configure-process <appType> <formUuid> <definition> [processCode] [--replace]` | Configure and publish process rules; Supports append/forward via JSON nodes[].actions.normalActions/appendActions |
-| `openyida create-process <appType> ... [--replace]` | Create process form (all-in-one); Supports append/forward via JSON nodes[].actions.normalActions/appendActions |
+| `openyida create-process <appType> <formTitle> <fieldsJsonFile> <processDefinitionFile> [--replace] \| create-process <appType> --formUuid <formUuid> <processDefinitionFile> [--replace]` | Create process form (all-in-one); Supports append/forward via JSON nodes[].actions.normalActions/appendActions |
 | `openyida ai-form-setting <get\|fields\|models\|enable\|disable\|save> <appType> ...` | Manage process form AI approval prompts |
 | `openyida process preview <appType> ...` | Preview process instance (visual flowchart) |
 

package/bin/yida.js

@@ -526,6 +526,7 @@ function printManifestCommandHelp(commandName) {
   printCommandUsage(...entries.flatMap((entry) => [
     entry.usage,
     entry.description,
+    ...(entry.notes || []),
     ...(entry.examples || []),
   ]));
   return true;
@@ -798,6 +799,12 @@ async function main() {
       break;
     }
 
+    case 'check-design': {
+      const { run } = require('../lib/design/check-design');
+      await run(args);
+      break;
+    }
+
     case 'er': {
       const { run } = require('../lib/app/er');
       await run(args);
@@ -1009,9 +1016,6 @@ async function main() {
     }
 
     case 'create-process': {
-      if (args.length < 2) {
-        throwCliUsage(t('cli.create_process_usage'), t('cli.create_process_example'));
-      }
       const { run: runCreateProcess } = require('../lib/process/create-process');
       await runCreateProcess(args);
       break;

package/lib/app/canvas-compile.js

@@ -940,29 +940,29 @@ function compileCanvasLocal(source, options = {}) {
       },
     });
   }
-  const directFormOpenIssues = findDirectFormOpenIssues(source);
-  if (directFormOpenIssues.length > 0) {
-    const firstIssue = directFormOpenIssues[0];
-    throw new CliError(formatDirectFormOpenMessage(), {
-      code: 'OPENYIDA_CANVAS_FORM_OPEN_CONTAINER_REQUIRED',
+  const formDetailLinkIssues = findFormDetailLinkIssues(source);
+  if (formDetailLinkIssues.length > 0) {
+    const firstIssue = formDetailLinkIssues[0];
+    throw new CliError(formatFormDetailLinkMessage(firstIssue), {
+      code: 'OPENYIDA_CANVAS_FORM_DETAIL_LINK_INVALID',
       details: {
         stage: 'canvas_compile',
         sourcePath: options.sourcePath || '',
         line: firstIssue.line,
-        callee: firstIssue.callee,
+        issueType: firstIssue.type,
       },
     });
   }
-  const formDetailLinkIssues = findFormDetailLinkIssues(source);
-  if (formDetailLinkIssues.length > 0) {
-    const firstIssue = formDetailLinkIssues[0];
-    throw new CliError(formatFormDetailLinkMessage(firstIssue), {
-      code: 'OPENYIDA_CANVAS_FORM_DETAIL_LINK_INVALID',
+  const directFormOpenIssues = findDirectFormOpenIssues(source);
+  if (directFormOpenIssues.length > 0) {
+    const firstIssue = directFormOpenIssues[0];
+    throw new CliError(formatDirectFormOpenMessage(), {
+      code: 'OPENYIDA_CANVAS_FORM_OPEN_CONTAINER_REQUIRED',
       details: {
         stage: 'canvas_compile',
         sourcePath: options.sourcePath || '',
         line: firstIssue.line,
-        issueType: firstIssue.type,
+        callee: firstIssue.callee,
       },
     });
   }

package/lib/app/create-form.js

@@ -101,6 +101,8 @@ const { SMART_VALIDATION_BLOCK_END, SMART_VALIDATION_BLOCK_START } = require('./
 const { createFieldNormalizers } = require('./create-form/field-normalizers');
 const {
   validateFormFieldDefinitions: collectFormFieldValidationDiagnostics,
+  DIVIDER_TYPES,
+  DEFAULT_DIVIDER_TYPE,
 } = require('./form-field-validator');
 
 function parseOpenOption(inputArgs) {
@@ -293,21 +295,6 @@ const FORM_PRESENTATION_TYPE_ALIAS = {
 };
 
 const FORM_PRESENTATION_COMPONENTS = ['Divider', 'ColumnsLayout', 'Column', 'PageSection'];
-const DIVIDER_TYPE_PRIORITY = [
-  'bold-with-thin',
-  'double-color-trapezoid',
-  'left-dot-title',
-  'solid',
-  'dashed',
-  'thick',
-  'dotted',
-];
-const DEFAULT_DIVIDER_TYPE = DIVIDER_TYPE_PRIORITY[0];
-const LEGACY_STRONG_DIVIDER_TYPE = 'multi-parallelograms-end';
-const ALLOWED_DIVIDER_TYPES = new Set([
-  ...DIVIDER_TYPE_PRIORITY,
-  LEGACY_STRONG_DIVIDER_TYPE,
-]);
 
 const COMPONENT_ALIAS_META = Symbol('openyida.componentAlias');
 
@@ -574,7 +561,12 @@ function normalizeDividerType(type) {
     return DEFAULT_DIVIDER_TYPE;
   }
   const normalized = String(type).trim();
-  return ALLOWED_DIVIDER_TYPES.has(normalized) ? normalized : DEFAULT_DIVIDER_TYPE;
+  if (!DIVIDER_TYPES.includes(normalized)) {
+    throwCreateFormError(t('create_form.divider_type_invalid', normalized, DIVIDER_TYPES.join(', ')), 'CREATE_FORM_INVALID_DIVIDER_TYPE', {
+      actual: type, expected: DIVIDER_TYPES,
+    });
+  }
+  return normalized;
 }
 
 function buildDividerComponent(field) {

package/lib/app/create-page.js

@@ -19,6 +19,7 @@ const { buildYidaI18n, buildYidaTitleI18n, normalizeYidaLocale, resolveContentLo
 const { parseOpenOption, withBrowserHandoff } = require('../core/browser-handoff');
 const { throwCommandError } = require('../core/command-errors');
 const { buildApiPath } = require('./create-form/api-path');
+const { fetchFormSchemaInfo } = require('./get-form-config');
 
 function parseArgs(args) {
   const openOption = parseOpenOption(args);
@@ -91,13 +92,13 @@ function parseBooleanOption(value, optionName) {
   throw new Error(`Invalid boolean value for ${optionName}: ${value}`);
 }
 
-function buildPageInfoPostData(formUuid, pageName, isRenderNav, csrfToken) {
+function buildPageInfoPostData(formUuid, pageName, isRenderNav, csrfToken, currentConfig) {
   const titleJson = JSON.stringify(buildYidaTitleI18n(pageName, {
     en_US: pageName,
     ja_JP: pageName,
   }));
 
-  return querystring.stringify({
+  const payload = {
     _api: 'Form.updateFormSchemaInfo',
     _csrf_token: csrfToken,
     _locale_time_zone_offset: '28800000',
@@ -125,17 +126,64 @@ function buildPageInfoPostData(formUuid, pageName, isRenderNav, csrfToken) {
     displayType: 'RE',
     isRenderNav: isRenderNav ? 'true' : 'false',
     manageCustomActionInfo: '[]',
-  });
+  };
+  // 与 update-form-config 一样，保留当前配置，只覆盖标题和导航。
+  for (const key of Object.keys(payload)) {
+    if (key.startsWith('_') || ['formUuid', 'title', 'isRenderNav'].includes(key)) {continue;}
+    const value = currentConfig?.[key];
+    if (value !== undefined && value !== null) {
+      payload[key] = typeof value === 'object' ? JSON.stringify(value) : value;
+    }
+  }
+  return querystring.stringify(payload);
+}
+
+function readRenderNav(config) {
+  const value = config && Object.prototype.hasOwnProperty.call(config, 'renderNav')
+    ? config.renderNav : config?.isRenderNav;
+  if (value === false || value === 'false') {return false;}
+  if (value === true || value === 'true') {return true;}
+  return null;
 }
 
 async function configureNavigationVisibility(authRef, appType, pageId, pageName, isRenderNav) {
-  return requestWithAutoLogin((auth) => {
-    return httpPost(
-      auth.baseUrl,
-      `/dingtalk/web/${appType}/query/formdesign/updateFormSchemaInfo.json`,
-      buildPageInfoPostData(pageId, pageName, isRenderNav, auth.csrfToken)
-    );
-  }, authRef);
+  const verification = { requestedRenderNav: isRenderNav, renderNav: null, verified: false, attempts: 0 };
+  let currentConfig = null;
+  const readConfig = async () => {
+    const response = await fetchFormSchemaInfo(authRef, appType, pageId);
+    if (!response || response.success === false || response.__needLogin || response.__csrfExpired) {
+      throw new Error(response?.errorMsg || t('common.request_failed'));
+    }
+    currentConfig = response.content || response.result || response.data || {};
+    verification.renderNav = readRenderNav(currentConfig);
+  };
+  try {
+    await readConfig();
+    for (let attempt = 0; attempt < 2; attempt++) {
+      verification.attempts++;
+      // 写入后旧读值不再证明当前状态；回读失败必须报告未知。
+      verification.renderNav = null;
+      const response = await requestWithAutoLogin((auth) => httpPost(
+        auth.baseUrl,
+        buildApiPath(appType, 'updateFormSchemaInfo'),
+        buildPageInfoPostData(pageId, pageName, isRenderNav, auth.csrfToken, currentConfig)
+      ), authRef);
+      await readConfig();
+      if (verification.renderNav === isRenderNav) {
+        verification.verified = true;
+        return verification;
+      }
+      if (!response?.success || response.__needLogin || response.__csrfExpired) {
+        verification.error = response?.errorMsg || t('common.request_failed');
+        return verification;
+      }
+      // 只补写已创建页面的配置，不重试创建；未知状态也不能当作隐藏成功。
+    }
+    verification.error = t('create_page.navigation_unverified');
+  } catch (err) {
+    verification.error = err.message;
+  }
+  return verification;
 }
 
 async function run(args) {
@@ -213,30 +261,49 @@ async function run(args) {
     const workbenchUrl = `${authRef.baseUrl}/${appType}/workbench/${pageId}`;
     let pageUrl = workbenchUrl;
     let dashboardConfigWarning = null;
+    let navigationVerification = null;
 
     if (options.hideNav) {
       step(3, t('create_page.step_dashboard_config'));
-      const configResponse = await configureNavigationVisibility(authRef, appType, pageId, pageName, false);
-      if (configResponse && configResponse.success) {
+      navigationVerification = await configureNavigationVisibility(authRef, appType, pageId, pageName, false);
+      if (navigationVerification.verified) {
         chalkSuccess(t('create_page.dashboard_config_ok'));
         pageUrl = `${authRef.baseUrl}/${appType}/custom/${pageId}?isRenderNav=false`;
       } else {
-        dashboardConfigWarning = configResponse ? configResponse.errorMsg || t('common.unknown_error') : t('common.request_failed');
+        dashboardConfigWarning = navigationVerification.error;
         warn(t('create_page.dashboard_config_failed', dashboardConfigWarning));
       }
     }
 
-    chalkResult(true, t('create_page.success'), [
+    const complete = !options.hideNav || navigationVerification.verified;
+    const result = {
+      success: complete, pageCreated: true, pageId, pageName, appType, mode,
+      hideNavRequested: options.hideNav,
+      hideNav: options.hideNav ? (navigationVerification.renderNav === null ? null : !navigationVerification.renderNav) : false,
+      chromeless: options.hideNav && navigationVerification.verified,
+      navigationVerification, url: pageUrl, workbenchUrl, dashboardConfigWarning,
+    };
+    if (!complete) {
+      result.errorCode = 'CREATE_PAGE_NAVIGATION_NOT_VERIFIED';
+      result.recovery = {
+        command: 'update-form-config', args: [appType, pageId, 'false', pageName],
+        verifyCommand: 'get-form-config', verifyArgs: [appType, pageId, '--json'],
+      };
+    }
+    chalkResult(complete, complete ? t('create_page.success') : t('create_page.navigation_unverified'), [
       ['Page ID', pageId],
       ['URL', `${c.cyan}${pageUrl}${c.reset}`],
     ]);
 
-    console.log(JSON.stringify(withBrowserHandoff(
-      { success: true, pageId, pageName, appType, mode, hideNav: options.hideNav, chromeless: options.hideNav && !dashboardConfigWarning, url: pageUrl, workbenchUrl, dashboardConfigWarning },
+    console.log(JSON.stringify(complete ? withBrowserHandoff(
+      result,
       pageUrl,
       { stage: 'create_page_success', title: pageName },
       options.openMode
-    )));
+    ) : result));
+    if (!complete) {
+      throwCommandError(t('create_page.navigation_unverified'), { code: result.errorCode, details: result });
+    }
   } else {
     const errorMsg = response ? response.errorMsg || response.error || t('common.unknown_error') : t('common.request_failed');
     const errorCode = response && response.errorCode ? response.errorCode : 'CREATE_PAGE_FAILED';

package/lib/app/custom-theme.js

@@ -3,6 +3,9 @@
 const fs = require('fs');
 const path = require('path');
 const { getAccessToken } = require('../auth/token-auth');
+const { CliError } = require('../core/cli-error');
+const { t } = require('../core/i18n');
+const { findCssStructureIssue } = require('../core/css-structure');
 
 const MAX_THEME_FILE_BYTES = 20 * 1024 * 1024;
 const REQUIRED_BRAND_SCALE_TOKENS = Object.freeze([
@@ -147,6 +150,14 @@ function extractThemeColor(cssText) {
 
 function validateThemeCssContent(cssText) {
   const source = String(cssText || '');
+  // Check the original text before stripping comments or rewriting token scopes.
+  const issue = findCssStructureIssue(source);
+  if (issue) {
+    const line = source.slice(0, issue.index).split('\n').length;
+    throw new CliError(t('design_document.theme_css_invalid', line), {
+      code: 'THEME_CSS_STRUCTURE_INVALID', details: { line, ...issue },
+    });
+  }
   const sourceWithoutComments = source.replace(/\/\*[\s\S]*?\*\//g, '');
   for (const rule of UNSAFE_THEME_PATTERNS) {
     if (rule.pattern.test(sourceWithoutComments)) {

package/lib/app/form-field-validator.js

@@ -1,5 +1,19 @@
 'use strict';
 
+const { t } = require('../core/i18n');
+
+// vc-deep-yida: components/vs-divider-style + components/yida-divider.
+// 这里只定义平台能力，不按业务场景排序；样式由页面设计选择。
+const DIVIDER_TYPES = Object.freeze([
+  'solid', 'dashed', 'thick', 'dotted', 'bold-with-thin',
+  'solid-center', 'solid-left', 'left-dot-title', 'light-left-bar',
+  'light-bar', 'dark-bar', 'light-left-title', 'light-center-title',
+  'light-house-title', 'light-hexagon-title', 'hexagon-title', 'badge-line',
+  'multi-parallelograms-end', 'center-title-with-bar', 'double-color-trapezoid',
+  'arrow-right-title', 'square-blocks-title', 'inner-ellipse-title',
+]);
+const DEFAULT_DIVIDER_TYPE = 'bold-with-thin';
+
 const FIELD_TYPE_ALIAS = Object.freeze({
   TextAreaField: 'TextareaField',
   Textareafield: 'TextareaField',
@@ -232,14 +246,19 @@ function validateDivider(field, path, diagnostics) {
       'Use a plain string title or omit title.'
     );
   }
-  if (field.dividerType !== undefined && typeof field.dividerType !== 'string') {
+  const styleInputs = ['dividerType', 'dividerStyle', 'styleType', 'typeStyle']
+    .map(key => [key, field[key]]);
+  styleInputs.push(['props.type', field.props?.type]);
+  for (const [key, value] of styleInputs) {
+    if (value === undefined || value === null || value === '') {continue;}
+    if (typeof value === 'string' && DIVIDER_TYPES.includes(value.trim())) {continue;}
     pushDiagnostic(
       diagnostics,
       'INVALID_DIVIDER_TYPE',
-      path + '.dividerType',
-      'string',
-      describeActual(field.dividerType),
-      'Divider.dividerType must be a string when provided.',
+      path + '.' + key,
+      DIVIDER_TYPES.join(' | '),
+      typeof value === 'string' ? value : describeActual(value),
+      t('create_form.divider_type_invalid', String(value), DIVIDER_TYPES.join(', ')),
       'Use a supported divider style string or omit dividerType.'
     );
   }
@@ -557,4 +576,6 @@ module.exports = {
   normalizeDefinitionType,
   BUSINESS_FIELD_TYPES,
   PRESENTATION_FIELD_TYPES,
+  DIVIDER_TYPES,
+  DEFAULT_DIVIDER_TYPE,
 };

package/lib/app/form-open-guard.js

@@ -1,6 +1,7 @@
 'use strict';
 
 const Babel = require('@babel/standalone');
+const { t } = require('../core/i18n');
 
 const parser = Babel.packages.parser;
 const traverse = Babel.packages.traverse.default || Babel.packages.traverse;
@@ -77,6 +78,13 @@ function isWindowOpenCall(callee) {
   );
 }
 
+function isLocationCall(callee) {
+  return callee?.type === 'MemberExpression'
+    && ['assign', 'replace'].includes(callee.property?.name)
+    && (callee.object?.name === 'location'
+      || (callee.object?.object?.name === 'window' && callee.object?.property?.name === 'location'));
+}
+
 function isOpenPageCall(callee) {
   return !!(
     callee &&
@@ -114,18 +122,26 @@ function isLocationHrefAssignment(node) {
 }
 
 function isMobileGuarded(pathRef, sourceCode) {
+  const mobileCondition = node => {
+    if (node?.type === 'UnaryExpression' && node.operator === '!') {return -mobileCondition(node.argument);}
+    const text = getNodeText(sourceCode, node);
+    if (node?.type === 'Identifier' || node?.type === 'MemberExpression' || node?.type === 'CallExpression') {
+      return MOBILE_GUARD_PATTERN.test(text) && !/min-width/.test(text) ? 1 : 0;
+    }
+    return 0;
+  };
   let cursor = pathRef;
   while (cursor && cursor.parentPath) {
     const parent = cursor.parentPath;
-    if (parent.node && parent.node.type === 'IfStatement' && nodeContains(parent.node.consequent, pathRef.node)) {
-      if (MOBILE_GUARD_PATTERN.test(getNodeText(sourceCode, parent.node.test))) {
-        return true;
-      }
+    if (['IfStatement', 'ConditionalExpression'].includes(parent.node?.type)) {
+      const direction = mobileCondition(parent.node.test);
+      if ((direction === 1 && nodeContains(parent.node.consequent, pathRef.node))
+        || (direction === -1 && nodeContains(parent.node.alternate, pathRef.node))) {return true;}
     }
-    if (parent.node && parent.node.type === 'ConditionalExpression') {
-      if (MOBILE_GUARD_PATTERN.test(getNodeText(sourceCode, parent.node.test))) {
-        return true;
-      }
+    if (parent.node?.type === 'LogicalExpression' && nodeContains(parent.node.right, pathRef.node)) {
+      const direction = mobileCondition(parent.node.left);
+      if ((parent.node.operator === '&&' && direction === 1)
+        || (parent.node.operator === '||' && direction === -1)) {return true;}
     }
     cursor = parent;
   }
@@ -161,9 +177,17 @@ function findDirectFormOpenIssues(sourceCode, options = {}) {
   }
 
   const knownFormUrlNames = new Set();
+  const containerNames = new Set(['formOpenContainer']);
   traverse(ast, {
     VariableDeclarator(pathRef) {
       const id = pathRef.node.id;
+      if (id?.type === 'ObjectPattern' && pathRef.node.init?.callee?.name === 'useYidaFormOpen') {
+        for (const property of id.properties) {
+          if (property.key?.name === 'formOpenContainer' && property.value?.type === 'Identifier') {
+            containerNames.add(property.value.name);
+          }
+        }
+      }
       if (!id || id.type !== 'Identifier') {
         return;
       }
@@ -174,10 +198,30 @@ function findDirectFormOpenIssues(sourceCode, options = {}) {
   });
 
   const issues = [];
+  const templateParts = new Map();
+  const templateUses = [];
+  let containerRendered = false;
+  const functionName = pathRef => {
+    const owner = pathRef.getFunctionParent();
+    return owner?.node.id?.name || owner?.parentPath?.node.id?.name;
+  };
+  const addTemplatePart = (owner, part) => {
+    if (!templateParts.has(owner)) {templateParts.set(owner, new Set());}
+    templateParts.get(owner).add(part);
+  };
   traverse(ast, {
     CallExpression(pathRef) {
       const callee = pathRef.node.callee;
-      if (!isWindowOpenCall(callee) && !isOpenPageCall(callee)) {
+      if (callee.type === 'Identifier' && callee.name === 'useYidaFormOpen') {
+        templateUses.push(pathRef.node);
+      }
+      if (callee.type === 'Identifier' && ['openForm', 'setFormRequest'].includes(callee.name)
+        && pathRef.node.arguments[0]?.type === 'ObjectExpression'
+        && pathRef.node.arguments[0].properties.some(property => (property.key?.name || property.key?.value) === 'type'
+          && ['submission', 'detail'].includes(property.value?.value))) {
+        templateUses.push(pathRef.node);
+      }
+      if (!isWindowOpenCall(callee) && !isOpenPageCall(callee) && !isLocationCall(callee)) {
         return;
       }
       const firstArg = pathRef.node.arguments && pathRef.node.arguments[0];
@@ -207,13 +251,56 @@ function findDirectFormOpenIssues(sourceCode, options = {}) {
         callee: getNodeText(sourceCode, pathRef.node.left),
       });
     },
+    JSXExpressionContainer(pathRef) {
+      if ((pathRef.parentPath.isJSXElement() || pathRef.parentPath.isJSXFragment())
+        && containerNames.has(pathRef.node.expression?.name)) {
+        containerRendered = true;
+      }
+    },
+    JSXOpeningElement(pathRef) {
+      const name = pathRef.node.name?.name;
+      const owner = functionName(pathRef);
+      addTemplatePart(owner, name);
+      if (name === 'FormOpenContainer' && owner !== 'useYidaFormOpen') {
+        templateUses.push(pathRef.node);
+        containerRendered = true;
+      }
+      const attribute = key => pathRef.node.attributes.find(item => item.type === 'JSXAttribute' && item.name?.name === key)?.value;
+      const value = node => node?.type === 'JSXExpressionContainer' ? node.expression : node;
+      if (owner === 'CanvasDrawer' && attribute('className')?.value === 'oy-drawer-resize'
+        && attribute('onPointerDown') && attribute('onPointerMove') && attribute('onPointerUp') && attribute('onKeyDown')) {
+        addTemplatePart(owner, 'resize-handle');
+      }
+      if (name === 'a' && expressionLooksLikeFormUrl(value(attribute('href')), sourceCode, knownFormUrlNames)) {
+        issues.push({ line: getNodeLine(pathRef.node), callee: 'a[href]' });
+      }
+      if (!['iframe', 'YidaCanvasIframe'].includes(name) || owner === 'FormOpenContainer') {return;}
+      if (!expressionLooksLikeFormUrl(value(attribute('src')), sourceCode, knownFormUrlNames)) {return;}
+      // 导航主内容可以嵌原生页；弹层内的表单必须使用提供的容器。
+      const overlay = pathRef.findParent(parent => parent.isJSXElement() && (
+        ['Drawer', 'Modal', 'CanvasDrawer'].includes(parent.node.openingElement.name?.name)
+        || parent.node.openingElement.attributes.some(item => item.type === 'JSXAttribute'
+          && ((item.name?.name === 'role' && item.value?.value === 'dialog')
+            || (item.name?.name === 'style' && /position\s*:\s*['"]fixed['"]/.test(getNodeText(sourceCode, item.value)))))));
+      if (overlay) {issues.push({ line: getNodeLine(pathRef.node), callee: `${name} outside FormOpenContainer` });}
+    },
   });
 
+  if (templateUses.length) {
+    const hasParts = (owner, parts) => parts.every(part => templateParts.get(owner)?.has(part));
+    const complete = hasParts('FormOpenContainer', ['CanvasDrawer', 'iframe'])
+      && hasParts('CanvasDrawer', ['Drawer', 'ExternalLink', 'Maximize2', 'Minimize2', 'X', 'resize-handle'])
+      && hasParts('useYidaFormOpen', ['FormOpenContainer']) && containerRendered;
+    if (!complete) {
+      issues.push({ line: getNodeLine(templateUses[0]), callee: 'incomplete FormOpenContainer template' });
+    }
+  }
+
   return issues;
 }
 
 function formatDirectFormOpenMessage() {
-  return '自定义页内打开表单提交/详情只能使用 FormOpenContainer：PC 端用 50vw 抽屉 iframe，移动端才整页或新页打开。按钮事件请调用 openForm({ type: "submission" | "detail", ... })。';
+  return t('publish.lint_form_open_container');
 }
 
 module.exports = {

package/lib/app/get-form-config.js

@@ -24,6 +24,7 @@ const { throwCommandError } = require('../core/command-errors');
 
 // 常用配置字段白名单（人读摘要），--json 会输出完整对象
 const SUMMARY_FIELDS = [
+  'renderNav',
   'isRenderNav',
   'submissionRule',
   'defaultOrder',

package/lib/app/inline-css-guard.js

@@ -4,37 +4,7 @@ const Babel = require('@babel/standalone');
 const { CliError } = require('../core/cli-error');
 const { t } = require('../core/i18n');
 
-// 检查 CSS 的结构闭合，避免一个未闭合 var() 吞掉后续规则。
-// 不执行页面代码，也不把动态插值当成完整 CSS 进行猜测性校验。
-function findCssStructureIssue(css) {
-  const stack = [];
-  const pairs = { '(': ')', '[': ']', '{': '}' };
-  for (let index = 0; index < css.length; index++) {
-    const char = css[index];
-    if (char === '\\') { index++; continue; }
-    if (char === '/' && css[index + 1] === '*') {
-      const end = css.indexOf('*/', index + 2);
-      if (end < 0) { return { index, type: 'unclosed_comment' }; }
-      index = end + 1;
-    } else if (char === '"' || char === "'") {
-      const start = index;
-      for (index++; index < css.length; index++) {
-        if (css[index] === '\\') { index++; continue; }
-        if (css[index] === char) { break; }
-      }
-      if (index >= css.length) { return { index: start, type: 'unclosed_string' }; }
-    } else if (pairs[char]) {
-      stack.push({ char, index });
-    } else if (')]}'.includes(char)) {
-      const open = stack.pop();
-      if (!open || pairs[open.char] !== char) {
-        return { index: open ? open.index : index, type: 'mismatched_delimiter', expected: open && pairs[open.char], actual: char };
-      }
-    }
-  }
-  const open = stack.pop();
-  return open ? { index: open.index, type: 'unclosed_delimiter', expected: pairs[open.char] } : null;
-}
+const { findCssStructureIssue } = require('../core/css-structure');
 
 function resolveStaticCss(pathRef, seen = new Set()) {
   if (pathRef.isStringLiteral()) { return { text: pathRef.node.value, node: pathRef.node }; }