openyida 2026.9.20 → 2026.9.22-beta.1

package/README.md

@@ -183,7 +183,7 @@ openyida get-schema APP_XXX FORM_XXX --compact --resolve-fields "Customer Name,S
 openyida get-schema APP_XXX --all --output-dir .cache/schemas
 ```
 
-Native forms use a component tree: business fields capture data, tabs switch content, action groups trigger business actions, images establish visual focus, status areas provide feedback, and `Divider` plus `ColumnContainer` organize hierarchy and columns. `create-form` field definitions create 19 business field types plus `Divider` and `ColumnContainer` (mapped to `ColumnsLayout` + `Column`), while updates retain other existing components.
+Form definitions support 19 business field types plus verified presentation/layout components. Prefer `Divider` for section titles and `ColumnContainer` (mapped to `ColumnsLayout` + `Column`) for multi-column layout; use `GroupContainer` / `PageSection` only when an actual grouping container is needed.
 
 ### Custom Page Development
 
@@ -385,7 +385,7 @@ Run `openyida --help` or `openyida <command> --help` for detailed usage.
 |---------|-------------|
 | `openyida login [target-url] [--env <name>\|--intl\|--overseas\|--global\|--yidaapps\|--alibaba] [--client-id <clientId>] [--endpoint <url>] [--no-browser]` | Login with OAuth token mode |
 | `openyida logout` | Logout / unbind current project auth |
-| `openyida auth <status\|login\|refresh\|logout\|profiles\|profile switch>` | Token login state and profile management |
+| `openyida auth <status\|login\|sync-dws\|refresh\|logout\|profiles\|profile switch>` | Token login state and profile management |
 | `openyida org <list\|switch> [--json] [--corp-id <corpId>]` | Organization management (list / switch existing profiles first) |
 | `openyida env [--json\|setup\|list\|show\|switch\|add\|remove] [options]` | Detect AI tool environment & token login state |
 
@@ -396,12 +396,11 @@ Run `openyida --help` or `openyida <command> --help` for detailed usage.
 | `openyida app-list [--type managed\|created] [--page N] [--size N]` | Page through apps I manage or created |
 | `openyida corp-efficiency [overview\|details\|detail\|groups\|notify] [options] [--open\|--no-open]` | Query enterprise efficiency overview and detail reports |
 | `openyida create-app "<name>"\|--name <name> [options] [--locale zh_CN\|en_US\|ja_JP] [--open\|--no-open]` | Create a Yida app |
-| `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 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 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 by field path and invalidate prior confirmation |
+| `openyida update-app <appType> [--name "..."] [--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 |
 | `openyida nav-group <list\|create\|rename\|delete\|move\|order\|auto-order\|hide\|show> <appType> ...` | Manage app sidebar navigation groups |
@@ -415,7 +414,7 @@ Run `openyida --help` or `openyida <command> --help` for detailed usage.
 | Command | Description |
 |---------|-------------|
 | `openyida create-form batch <appType> <plan.json> [--concurrency 1..4] [--check] [--json]` | Create forms concurrently by dependency |
-| `openyida create-form create <appType> "<formTitle>" <fieldsJsonFile> [--layout single\|double\|card\|section] [--theme default\|compact\|comfortable] [--label-align top\|left\|right] [--icon auto\|<iconName>] [--locale zh_CN\|en_US\|ja_JP] [--open\|--no-open]` | Create a form page |
+| `openyida create-form create <appType> "<formTitle>" <fieldsJsonFile> [--icon auto\|<iconName>] [--locale zh_CN\|en_US\|ja_JP] [--open\|--no-open]` | Create a form page |
 | `openyida create-form icons [--json]` | List available form navigation icons |
 | `openyida create-form validate-fields <fieldsJsonOrFile> [--json]` | Validate form field JSON locally |
 | `openyida create-form update <appType> <formUuid> (<changesJsonOrFile> \| --data-file <changesJsonOrFile>) [--locale zh_CN\|en_US\|ja_JP] [--open\|--no-open]` | Update a form page |
@@ -430,13 +429,12 @@ 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] [--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 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 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 |
 
@@ -459,7 +457,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> <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 create-process <appType> ... [--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) |
 
@@ -492,7 +490,7 @@ Run `openyida --help` or `openyida <command> --help` for detailed usage.
 | `openyida connector update-action --connector-id <id> --action <operationId> --query-json JSON --confirm` | Safely update action query defaults |
 | `openyida connector list-actions <id>` | List actions |
 | `openyida connector delete-action <id> <operation-id>` | Delete an action |
-| `openyida connector test --connector-id <id> --action <actionId> [--path-json JSON] [--query-json JSON] [--header-json JSON] [--body-json JSON] [--account-id <id>] [--system-token-app <appType>] [--ignore-defaults]` | Test an action |
+| `openyida connector test --connector-id <id> --action <actionId> [--path-json JSON] [--query-json JSON] [--header-json JSON] [--body-json JSON] [--account-id <id>] [--system-token-app <appType>]` | Test an action |
 | `openyida connector list-connections <id>` | List auth connections |
 | `openyida connector create-connection <id> <name> [--interactive]` | Create an auth connection |
 | `openyida connector smart-create --curl "..."` | Generate a redacted action draft from cURL (no remote create) |
@@ -523,7 +521,7 @@ Run `openyida --help` or `openyida <command> --help` for detailed usage.
 | `openyida a2a <serve\|agent-card> [options]` | Start local read-only A2A adapter or print Agent Card |
 | `openyida bridge start [--token <pair-token>] [--port 6736] [--origin https://demo.aliwork.com] [--open\|--no-open]` | Start OpenYida local web bridge service |
 | `openyida copy [--force]` | Copy project working directory |
-| `openyida sample [--list] [<skill> <name>] [--output <file-or-directory>] [--var KEY=VALUE ...] [--design-file <design.md>] [--style-id <themeId\|free-creative>]` | Output code samples/templates |
+| `openyida sample [--list] [<skill> <name>] [--output <file>] [--var KEY=VALUE ...] [--design-file <design.md>]` | Output code samples/templates |
 | `openyida doctor [--fix]` | Environment diagnostics & auto-fix |
 | `openyida db-seq-fix [--fix]` | Detect and repair PostgreSQL sequence drift |
 | `openyida formula evaluate <formula\|file> [--schema file]` | Static-check Yida formula syntax and field refs |
@@ -544,7 +542,7 @@ Run `openyida --help` or `openyida <command> --help` for detailed usage.
 
 #### Connector Safety and Real E2E
 
-`connector test` keeps the legacy flat `--params` option, but dispatches each key only to the location proven by the action schema. Unknown or ambiguous keys fail closed. Authenticated connectors require `--account-id`, and that account must belong to the selected connector. The test response follows the frontend canonical contract `{statusLine,responseHeaders,content}`; unknown envelopes and non-2xx status lines are failures. With `--ignore-defaults`, the test starts from empty parameter sets: saved default values from the action definition (including sensitive placeholder values such as documented `***` samples) are ignored for the run, and a warning is printed when a non-empty systemToken default exists. Declared systemToken actions still require `--system-token-app`, target-trust checks still apply, and explicitly provided systemToken values are still rejected.
+`connector test` keeps the legacy flat `--params` option, but dispatches each key only to the location proven by the action schema. Unknown or ambiguous keys fail closed. Authenticated connectors require `--account-id`, and that account must belong to the selected connector. The test response follows the frontend canonical contract `{statusLine,responseHeaders,content}`; unknown envelopes and non-2xx status lines are failures.
 
 `connector update-action --connector-id <id> --action <operationId> --query-json '{"currentPage":"1"}' --confirm` is the narrow safe path for editing existing query defaults. It requires a complete connector/action preflight, changes only declared query defaults mirrored in `inputs` and `parameters`, submits the complete action collection once, and verifies an unchanged connector fingerprint, action count, non-target actions, and stable IDs. Missing/empty/unknown parameters, duplicate IDs, incomplete readback, and unknown write outcomes fail closed without automatic retry. `add-action` no longer overwrites an existing action ID; use `update-action` for query-only edits.
 
@@ -651,14 +649,10 @@ npx clawhub@latest install nicky1108/yida-app
 ```bash
 git clone https://github.com/openyida/openyida.git
 cd openyida
-nvm install
-nvm use
-npm ci --ignore-scripts
+npm install
 npm run check:ci
 ```
 
-Use the Node.js version in `.nvmrc` to match CI validation. If you do not use nvm, install that version directly.
-
 Useful checks:
 
 | Command | Purpose |

package/bin/yida.js

@@ -526,7 +526,6 @@ function printManifestCommandHelp(commandName) {
   printCommandUsage(...entries.flatMap((entry) => [
     entry.usage,
     entry.description,
-    ...(entry.notes || []),
     ...(entry.examples || []),
   ]));
   return true;
@@ -691,6 +690,8 @@ async function main() {
       const { tokenLogin, tokenLogout, tokenRefresh } = require('../lib/auth/token-auth');
       if (!subCommand || subCommand === '--help' || subCommand === '-h') {
         printAuthHelp();
+      } else if (subCommand === 'sync-dws') {
+        await require('../lib/auth/dws-sync').run(authArgs, buildTokenLoginOptions(authArgs));
       } else if (subCommand === 'status') {
         console.log(JSON.stringify(getAuthStatus(buildTokenLoginOptions(authArgs)), null, 2));
       } else if (subCommand === 'profiles') {
@@ -698,10 +699,7 @@ async function main() {
         console.log(JSON.stringify(listAuthProfiles(buildTokenLoginOptions(authArgs)), null, 2));
       } else if (subCommand === 'profile') {
         const profileSubCommand = authArgs[0];
-        if (profileSubCommand === 'list') {
-          const { listAuthProfiles } = require('../lib/auth/profile');
-          console.log(JSON.stringify(listAuthProfiles(buildTokenLoginOptions(authArgs.slice(1))), null, 2));
-        } else if (profileSubCommand === 'switch') {
+        if (profileSubCommand === 'switch') {
           const target = getFirstPositionalArg(authArgs, 1);
           const { switchAuthProfile } = require('../lib/auth/profile');
           console.log(JSON.stringify(switchAuthProfile(target, buildTokenLoginOptions(authArgs)), null, 2));
@@ -799,12 +797,6 @@ 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);
@@ -1016,6 +1008,9 @@ 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/app-list.js

@@ -6,16 +6,13 @@
  * 输出字段：
  *   appName    - 应用名称（zh_CN）
  *   appType    - 应用唯一标识
- *   systemLink - 平台返回的应用访问地址
- *   appUrl / workbenchUrl - 应用工作台地址
- *   adminUrl   - 开发者管理后台地址（不表示已验证访问权限）
+ *   systemLink - 应用访问地址
  */
 
 'use strict';
 
 const { createAuthRef, createYidaClient } = require('../core/yida-client');
 const { t } = require('../core/i18n');
-const { buildApplicationEntryUrls } = require('./application-entry-urls');
 const { throwCommandError, throwUsage } = require('../core/command-errors');
 
 const API_PATH = '/query/app/getAppList.json';
@@ -79,12 +76,11 @@ function parseArgs(args = []) {
 /**
  * 将应用原始数据提取为输出字段
  */
-function formatApp(app, baseUrl) {
+function formatApp(app) {
   return {
     appName: (app.appName && app.appName.zh_CN) || '',
     appType: app.appType || '',
     systemLink: app.systemLink || '',
-    ...buildApplicationEntryUrls({ appType: app.appType, systemLink: app.systemLink, baseUrl }),
   };
 }
 
@@ -145,7 +141,7 @@ async function run(args) {
   const totalCount = Number.isFinite(Number(content.totalCount)) ? Number(content.totalCount) : apps.length;
   const totalPages = Math.max(1, Math.ceil(totalCount / options.pageSize));
   const scopeLabel = t(`app_list.scope_${options.type}`);
-  const formattedApps = apps.map(app => formatApp(app, authRef.baseUrl));
+  const formattedApps = apps.map(formatApp);
 
   // stdout 输出 JSON，方便 AI 工具解析
   console.log(JSON.stringify(formattedApps, null, 2));

package/lib/app/canvas-compile.js

@@ -49,12 +49,7 @@ const {
   formatFormDetailLinkMessage,
 } = require('./form-detail-link-guard');
 const { t } = require('../core/i18n');
-const { assertFormDataResponse } = require('./form-data-response-guard');
 const { assertInlineCssStructure } = require('./inline-css-guard');
-const { assertCanvasThemeStructure } = require('./canvas-theme-guard');
-const { assertCanvasIconExports } = require('./canvas-icon-guard');
-const { assertCanvasNavigationStructure } = require('./canvas-navigation-guard');
-const { assertCanvasNavigationPaths } = require('./canvas-path-guard');
 
 /**
  * 依赖 → window 别名白名单，用于把 import 改写到运行时全局对象。
@@ -941,42 +936,37 @@ function compileCanvasLocal(source, options = {}) {
       },
     });
   }
-  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,
       },
     });
   }
-  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,
       },
     });
   }
-  assertFormDataResponse(source, options);
   assertNoUnavailableCanvasInstanceApis(source, options);
   assertNoSelfReferentialDependencyBindings(source, options);
   assertNoBareDependencyGlobals(source, options);
   assertNoManualDependencyGlobals(source, options);
-  assertCanvasIconExports(source, options);
-  assertCanvasNavigationStructure(source, options);
-  assertCanvasNavigationPaths(source, options);
   assertInlineCssStructure(source, options);
-  assertCanvasThemeStructure(source, options);
 
   const importedModules = extractImportedModules(source);
 

package/lib/app/check-prd-completeness.js

@@ -5,7 +5,6 @@ const path = require('path');
 const { createAuthRef, isAuthRefReady } = require('../core/yida-client');
 const { t } = require('../core/i18n');
 const { throwCommandError, throwUsage } = require('../core/command-errors');
-const { auditAssetExecution } = require('../asset/asset-execution');
 const { fetchFormPageList } = require('./form-navigation');
 
 const CHECKABLE_RESOURCE_KINDS = new Set(['display-page', 'normal-form', 'process-form']);
@@ -440,7 +439,6 @@ async function evaluatePrdCompleteness(markdown, options = {}, deps = {}) {
   const parsedPrd = parsePrdMarkdown(markdown);
   const parsedManifest = parseBuildManifest(options.buildManifest);
   const items = [];
-  const assetExecution = auditAssetExecution(options.buildManifest?.assetExecution, options.buildManifest?.assetTasks);
 
   function addItem(id, source, status, severity, message, details = {}) {
     items.push(makeRiskItem(id, source, status, severity, message, details));
@@ -454,7 +452,6 @@ async function evaluatePrdCompleteness(markdown, options = {}, deps = {}) {
       success: true,
       verdict,
       mode: 'delivery_risk_radar',
-      assetExecution,
       appType,
       prdPath: options.prdPath || '',
       buildManifestPath: options.buildManifestPath || '',
@@ -493,10 +490,6 @@ async function evaluatePrdCompleteness(markdown, options = {}, deps = {}) {
     };
   }
 
-  for (const issue of assetExecution.issues) {
-    addItem('asset_execution_' + issue.code, 'build_manifest.assetExecution', 'needs_review', 'warning',
-      t('asset.executionReview', issue.code), { actual: issue });
-  }
   const fetchForms = deps.fetchForms || fetchFormPageList;
   let forms = [];
   try {

package/lib/app/create-app.js

@@ -16,7 +16,6 @@ const {
 } = require('../core/utils');
 const { createAuthRef } = require('../core/yida-client');
 const { t } = require('../core/i18n');
-const { buildApplicationEntryUrls } = require('./application-entry-urls');
 const { buildYidaI18n, normalizeYidaLocale, resolveContentLocale } = require('../core/yida-i18n');
 const { parseOpenOption, withBrowserHandoff } = require('../core/browser-handoff');
 const { throwCommandError } = require('../core/command-errors');
@@ -370,8 +369,7 @@ async function run(args) {
   // 输出结果
   if (response && response.success && response.content) {
     const appType = response.content;
-    const entryUrls = buildApplicationEntryUrls({ appType, baseUrl: authRef.baseUrl });
-    const appUrl = entryUrls.appUrl;
+    const appUrl = `${authRef.baseUrl}/${appType}/workbench`;
     const corpId = authRef.corpId || (authRef.authData && authRef.authData.corp_id) || '';
 
     chalkResult(true, t('create_app.success'), [
@@ -390,7 +388,6 @@ async function run(args) {
         appName,
         corpId,
         url: appUrl,
-        ...entryUrls,
       },
       appUrl,
       { stage: 'create_app_success', title: appName },

package/lib/app/create-form/args.js

@@ -2,10 +2,6 @@
 
 const { detectDeprecatedCreateFormInvocation } = require('../../core/command-contract');
 
-const CREATE_FORM_LAYOUTS = new Set(['single', '1', 'double', '2', 'card', 'section']);
-const CREATE_FORM_THEMES = new Set(['default', 'compact', 'comfortable']);
-const CREATE_FORM_LABEL_ALIGNS = new Set(['top', 'left', 'right']);
-
 function parseMaybeJsonValue(value) {
   if (typeof value !== 'string') {
     return value;
@@ -98,38 +94,24 @@ function createParseArgs(dependencies) {
     const args = [...rawArgs];
 
     for (let i = 0; i < args.length; i++) {
-      if (args[i] === '--layout') {
-        const value = args[i + 1];
-        if (!value || value.startsWith('--') || !CREATE_FORM_LAYOUTS.has(value)) {
-          throwCreateFormError('--layout must be one of: single, double, card, section', 'CREATE_FORM_INVALID_ARGUMENTS');
-        }
-        options.layout = value;
+      if (args[i] === '--layout' && i + 1 < args.length) {
+        options.layout = args[i + 1];
         args.splice(i, 2);
         i--;
-      } else if (args[i] === '--theme') {
-        const value = args[i + 1];
-        if (!value || value.startsWith('--') || !CREATE_FORM_THEMES.has(value)) {
-          throwCreateFormError('--theme must be one of: default, compact, comfortable', 'CREATE_FORM_INVALID_ARGUMENTS');
-        }
-        options.theme = value;
+      } else if (args[i] === '--theme' && i + 1 < args.length) {
+        options.theme = args[i + 1];
         args.splice(i, 2);
         i--;
-      } else if (args[i] === '--label-align') {
-        const value = args[i + 1];
-        if (!value || value.startsWith('--') || !CREATE_FORM_LABEL_ALIGNS.has(value)) {
-          throwCreateFormError('--label-align must be one of: top, left, right', 'CREATE_FORM_INVALID_ARGUMENTS');
-        }
-        options.labelAlign = value;
+      } else if (args[i] === '--label-align' && i + 1 < args.length) {
+        options.labelAlign = args[i + 1];
         args.splice(i, 2);
         i--;
-      } else if (args[i] === '--icon') {
-        const value = args[i + 1];
-        if (!value || value.startsWith('--')) {
-          throwCreateFormError('--icon requires a value', 'CREATE_FORM_INVALID_ARGUMENTS');
-        }
-        options.icon = value;
+      } else if (args[i] === '--icon' && i + 1 < args.length) {
+        options.icon = args[i + 1];
         args.splice(i, 2);
         i--;
+      } else if (args[i] === '--icon') {
+        throwCreateFormError('--icon requires a value', 'CREATE_FORM_INVALID_ARGUMENTS');
       } else if (args[i] === '--data-file') {
         const next = args[i + 1];
         if (dataFileInput !== undefined || !next || next.startsWith('--')) {
@@ -138,12 +120,8 @@ function createParseArgs(dependencies) {
         dataFileInput = next;
         args.splice(i, 2);
         i--;
-      } else if (args[i] === '--locale' || args[i] === '--content-locale' || args[i] === '--lang') {
-        const value = args[i + 1];
-        if (!value || value.startsWith('--')) {
-          throwCreateFormError(`${args[i]} requires a value`, 'CREATE_FORM_INVALID_ARGUMENTS');
-        }
-        options.contentLocale = value;
+      } else if ((args[i] === '--locale' || args[i] === '--content-locale' || args[i] === '--lang') && i + 1 < args.length) {
+        options.contentLocale = args[i + 1];
         if (!normalizeYidaLocale(options.contentLocale)) {
           error(`Unsupported locale: ${options.contentLocale}`);
           throwCreateFormError(`Unsupported locale: ${options.contentLocale}`, 'CREATE_FORM_INVALID_ARGUMENTS');
@@ -383,7 +361,4 @@ module.exports = {
   createParseArgs,
   parseInlineValidationOptions,
   parseMaybeJsonValue,
-  CREATE_FORM_LAYOUTS,
-  CREATE_FORM_THEMES,
-  CREATE_FORM_LABEL_ALIGNS,
 };

package/lib/app/create-form/batch.js

@@ -9,15 +9,10 @@ const { t } = require('../../core/i18n');
 const { usage, hint } = require('../../core/chalk');
 const { assertNoEmojiInText, assertNoEmojiInValue } = require('../../core/no-emoji-guard');
 const { normalizeYidaLocale } = require('../../core/yida-i18n');
-const {
-  CREATE_FORM_LAYOUTS,
-  CREATE_FORM_THEMES,
-  CREATE_FORM_LABEL_ALIGNS,
-} = require('./args');
 const { FORM_NAV_ICONS, resolveFormNavIcon } = require('./nav-icon');
 
 const BATCH_USAGE = 'openyida create-form batch <appType> <plan.json> [--concurrency 1..4] [--check] [--json]';
-const BATCH_PLAN_EXAMPLE = '{"forms":[{"key":"customer","title":"客户","fieldsFile":"customer-fields.json","layout":"section","theme":"comfortable","labelAlign":"left"},{"key":"order","title":"订单","fieldsFile":"order-fields.json","dependsOn":["customer"]}]}';
+const BATCH_PLAN_EXAMPLE = '{"forms":[{"key":"customer","title":"客户","fieldsFile":"customer-fields.json"},{"key":"order","title":"订单","fieldsFile":"order-fields.json","dependsOn":["customer"]}]}';
 
 function invalid(reason) {
   throw new CliError(t('create_form.batch_invalid'), { code: 'FORM_BATCH_INVALID', details: { reason } });
@@ -51,20 +46,6 @@ function validateStaticDefinition(form, fields) {
       locale: form.locale,
     });
   }
-  for (const [key, values] of [
-    ['layout', CREATE_FORM_LAYOUTS],
-    ['theme', CREATE_FORM_THEMES],
-    ['labelAlign', CREATE_FORM_LABEL_ALIGNS],
-  ]) {
-    if (form[key] !== undefined && !values.has(form[key])) {
-      invalid({
-        formKey: form.key,
-        errorCode: 'CREATE_FORM_INVALID_ARGUMENTS',
-        errorMsg: `Unsupported ${key}: ${form[key]}`,
-        [key]: form[key],
-      });
-    }
-  }
 }
 
 function parseArgs(args) {
@@ -145,9 +126,9 @@ function loadPlan(file, options = {}) {
     if (!form || !/^[a-zA-Z][\w-]*$/.test(form.key || '') || typeof form.title !== 'string' || !form.title.trim() ||
       (form.fields === undefined) === (form.fieldsFile === undefined) ||
       (form.dependsOn !== undefined && (!Array.isArray(form.dependsOn) || form.dependsOn.some(key => typeof key !== 'string')))) { invalid('form'); }
-    if (Object.keys(form).some(key => !['key', 'title', 'fields', 'fieldsFile', 'dependsOn', 'formUuid', 'layout', 'theme', 'labelAlign', 'icon', 'locale'].includes(key))) { invalid(form.key); }
+    if (Object.keys(form).some(key => !['key', 'title', 'fields', 'fieldsFile', 'dependsOn', 'formUuid', 'icon', 'locale'].includes(key))) { invalid(form.key); }
     if (form.formUuid !== undefined && (typeof form.formUuid !== 'string' || !form.formUuid.startsWith('FORM'))) { invalid(form.key); }
-    for (const key of ['layout', 'theme', 'labelAlign', 'icon', 'locale']) { if (form[key] !== undefined && typeof form[key] !== 'string') { invalid(key); } }
+    for (const key of ['icon', 'locale']) { if (form[key] !== undefined && typeof form[key] !== 'string') { invalid(key); } }
     const rawFields = form.fieldsFile === undefined ? form.fields : JSON.parse(fs.readFileSync(path.resolve(path.dirname(file), form.fieldsFile), 'utf8'));
     const fields = normalizeAssociationReferences(rawFields, options.appType);
     validateStaticDefinition(form, fields);
@@ -211,7 +192,7 @@ function expectedReadbackFields(fields) {
       expected.push(...expectedReadbackFields(field.children));
       continue;
     }
-    if (['Divider', 'RichText'].includes(field.type)) { continue; }
+    if (['Divider', 'RichText', 'PageSection', 'GroupContainer'].includes(field.type)) { continue; }
     if (typeof field.label === 'string' && field.label.trim()) {
       expected.push({ label: field.label.trim(), componentName: field.type });
     }
@@ -244,25 +225,6 @@ function readbackMismatch(formUuid, form, schema) {
   });
 }
 
-function buildPartialFailureRecovery(results) {
-  const items = Object.values(results || {});
-  const hasUnknownWrite = items.some(item =>
-    item && (item.status === 'running' || (item.status === 'failed' && !item.formUuid))
-  );
-  const recoveryAction = hasUnknownWrite
-    ? 'inspect_unknown_write_then_reconcile'
-    : 'rerun_unchanged_plan';
-  return { recoveryAction, nextAction: recoveryAction };
-}
-
-function buildDeliveryUrls(baseUrl, appType, formUuid) {
-  const normalizedBaseUrl = String(baseUrl || '').replace(/\/+$/, '');
-  if (!normalizedBaseUrl || !appType || !formUuid) { return {}; }
-  const appUrl = `${normalizedBaseUrl}/${appType}/workbench`;
-  const formUrl = `${appUrl}/${formUuid}`;
-  return { url: formUrl, formUrl, appUrl };
-}
-
 function execute(args, { execFile: execFileImpl = execFile } = {}) {
   return new Promise((resolve, reject) => {
     execFileImpl(process.execPath, [path.resolve(__dirname, '../../../bin/yida.js'), ...args, '--quiet'], {
@@ -355,15 +317,13 @@ async function run(args, dependencies = {}) {
   try {
     const state = fs.existsSync(stateFile) ? JSON.parse(fs.readFileSync(stateFile, 'utf8')) : { fingerprint, appType: options.appType, results: {} };
     if (state.fingerprint !== fingerprint) { invalid('state belongs to a different plan; reconcile existing resources before preparing a new batch'); }
-    const loginStatus = await call(['login', '--check-only', '--json']);
-    const baseUrl = loginStatus?.base_url || loginStatus?.baseUrl || '';
+    await call(['login', '--check-only', '--json']);
     // Read back completed resources before their IDs can be used by dependent forms.
     for (const form of forms.filter(item => state.results[item.key]?.status === 'success')) {
       const item = state.results[form.key];
       const schema = await call(['get-schema', options.appType, item.formUuid, '--field-map-json']);
       if (schema.formUuid !== item.formUuid || !Array.isArray(schema.fields)) { invalid(`schema: ${form.key}`); }
       item.fields = schema.fields;
-      Object.assign(item, buildDeliveryUrls(baseUrl, options.appType, item.formUuid));
     }
     const resolve = (key, field) => {
       const item = state.results[key];
@@ -376,29 +336,14 @@ async function run(args, dependencies = {}) {
     await schedule(forms, options.concurrency, state.results, async form => {
       let formUuid = form.formUuid || state.results[form.key]?.formUuid;
       let shouldResume = Boolean(!form.formUuid && formUuid);
-      let delivery = buildDeliveryUrls(baseUrl, options.appType, formUuid);
       const resolvedFields = mapReferences(form.fields, resolve);
       if (!formUuid) {
         const argv = ['create-form', 'create', options.appType, form.title, JSON.stringify(resolvedFields), '--no-open'];
-        for (const [key, option] of Object.entries({
-          layout: '--layout',
-          theme: '--theme',
-          labelAlign: '--label-align',
-          icon: '--icon',
-          locale: '--locale',
-        })) {
-          if (form[key]) { argv.push(option, form[key]); }
-        }
+        for (const key of ['icon', 'locale']) { if (form[key]) { argv.push(`--${key}`, form[key]); } }
         try {
           const created = await call(argv);
           if (typeof created.formUuid !== 'string' || !created.formUuid.startsWith('FORM')) { invalid(`create result: ${form.key}`); }
           formUuid = created.formUuid;
-          delivery = {
-            ...buildDeliveryUrls(baseUrl, options.appType, formUuid),
-            ...(created.url ? { url: created.url } : {}),
-            ...(created.formUrl ? { formUrl: created.formUrl } : {}),
-            ...(created.appUrl ? { appUrl: created.appUrl } : {}),
-          };
         } catch (error) {
           const createdFormUuid = error.output?.formUuid || error.output?.details?.formUuid;
           if (typeof createdFormUuid !== 'string' || !createdFormUuid.startsWith('FORM')) {
@@ -412,43 +357,25 @@ async function run(args, dependencies = {}) {
       save(state);
       let resumed = false;
       if (shouldResume) {
-        const resumeOutput = await call(['create-form', 'resume', options.appType, formUuid, JSON.stringify(resolvedFields), '--json']);
-        delivery = {
-          ...buildDeliveryUrls(baseUrl, options.appType, formUuid),
-          ...(resumeOutput.url ? { url: resumeOutput.url } : {}),
-          ...(resumeOutput.formUrl ? { formUrl: resumeOutput.formUrl } : {}),
-          ...(resumeOutput.appUrl ? { appUrl: resumeOutput.appUrl } : {}),
-        };
+        await call(['create-form', 'resume', options.appType, formUuid, JSON.stringify(resolvedFields), '--json']);
         resumed = true;
       }
       let schema = await call(['get-schema', options.appType, formUuid, '--field-map-json']);
       if (!readbackMatchesExpectedFields(schema, resolvedFields) && !resumed && !form.formUuid) {
-        const resumeOutput = await call(['create-form', 'resume', options.appType, formUuid, JSON.stringify(resolvedFields), '--json']);
-        delivery = {
-          ...buildDeliveryUrls(baseUrl, options.appType, formUuid),
-          ...(resumeOutput.url ? { url: resumeOutput.url } : {}),
-          ...(resumeOutput.formUrl ? { formUrl: resumeOutput.formUrl } : {}),
-          ...(resumeOutput.appUrl ? { appUrl: resumeOutput.appUrl } : {}),
-        };
+        await call(['create-form', 'resume', options.appType, formUuid, JSON.stringify(resolvedFields), '--json']);
         resumed = true;
         schema = await call(['get-schema', options.appType, formUuid, '--field-map-json']);
       }
       if (schema.formUuid !== formUuid || !readbackMatchesExpectedFields(schema, resolvedFields)) {
         throw readbackMismatch(formUuid, { ...form, fields: resolvedFields }, schema);
       }
-      return { formUuid, fields: schema.fields, ...delivery };
+      return { formUuid, fields: schema.fields };
     }, () => save(state));
     const success = Object.values(state.results).every(item => item.status === 'success');
-    const output = {
-      success,
-      groups,
-      stateFile,
-      results: state.results,
-      ...((baseUrl && options.appType) ? { appUrl: `${String(baseUrl).replace(/\/+$/, '')}/${options.appType}/workbench` } : {}),
-    };
+    const output = { success, groups, stateFile, results: state.results };
     if (!success) {
       output.errorCode = 'FORM_BATCH_PARTIAL_FAILURE';
-      Object.assign(output, buildPartialFailureRecovery(state.results));
+      output.nextAction = 'Inspect the saved state and child error, then fix the batch input or recover known formUuid values. Do not fall back to create-form create.';
     }
     console.log(JSON.stringify(output));
     if (!output.success) { process.exitCode = 1; }
@@ -470,7 +397,5 @@ module.exports = {
   execute,
   expectedReadbackFields,
   readbackMatchesExpectedFields,
-  buildPartialFailureRecovery,
-  buildDeliveryUrls,
   validateStaticDefinition,
 };