openyida 2026.7.17 → 2026.7.18

package/README.md

@@ -18,6 +18,8 @@ OpenYida connects AI coding agents with Yida's low-code platform, so developers
 
 **Documentation:** [English](https://openyida.ai/docs/en) · [简体中文](https://openyida.ai/docs) · [繁體中文](https://openyida.ai/docs/zh-Hant/) · [日本語](https://openyida.ai/docs/ja/) · [한국어](https://openyida.ai/docs/ko/) · [Français](https://openyida.ai/docs/fr/) · [Deutsch](https://openyida.ai/docs/de/) · [Español](https://openyida.ai/docs/es/) · [Português](https://openyida.ai/docs/pt/) · [Tiếng Việt](https://openyida.ai/docs/vi/) · [हिन्दी](https://openyida.ai/docs/hi/) · [العربية](https://openyida.ai/docs/ar/)
 
+[English README](./README.md) · [简体中文 README](./README_zhCN.md)
+
 </div>
 
 ---
@@ -175,19 +177,28 @@ openyida get-schema APP_XXX FORM_XXX
 openyida get-schema APP_XXX --all --output-dir .cache/schemas
 ```
 
+Form definitions support 19 business field types plus verified `@ali/vc-deep-yida` 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
 
 ```bash
 openyida create-page APP_XXX "Dashboard" --mode dashboard
-openyida generate-page product-homepage --spec .cache/openyida/page-specs/home.json --output pages/src/home.oyd.jsx --compile
-openyida generate-page todo-mvc --output pages/src/todo-mvc.oyd.jsx --compile
-openyida check-page pages/src/home.oyd.jsx
-openyida compile pages/src/home.oyd.jsx
-openyida publish pages/src/home.oyd.jsx APP_XXX FORM_XXX
+openyida generate-page product-homepage --scene workbench --theme-profile yida-app-theme --theme-scope page --spec .cache/openyida/page-specs/home.json --output pages/src/home.canvas.jsx --compile
+openyida generate-page official-homepage --theme-profile yida-app-theme --spec .cache/openyida/page-specs/official-home.json --resolve-assets --upload-assets --output pages/src/official-home.canvas.jsx --compile
+openyida generate-page data-screen --theme-profile yida-app-theme --output pages/src/data-screen.canvas.jsx --compile
+openyida generate-page split-pane-detail --theme-profile yida-app-theme --output pages/src/split-pane-detail.canvas.jsx --compile
+openyida generate-page portal-shell-home --theme-profile yida-app-theme --output pages/src/portal-shell-home.canvas.jsx --compile
+openyida sample yida-canvas-custom-page dashboard-starter --output pages/src/dashboard-starter.canvas.jsx
+openyida sample yida-canvas-custom-page native-components-smoke --output pages/src/native-components-smoke.canvas.jsx
+openyida sample yida-canvas-custom-page portal-native-components --output pages/src/portal-native-components.canvas.jsx
+openyida generate-page todo-mvc --output pages/src/todo-mvc.canvas.jsx --compile
+openyida publish pages/src/home.canvas.jsx APP_XXX FORM_XXX
 ```
 
-`generate-page` turns a structured spec into a Page IR, renders a curated React 16-compatible template, writes a `.openyida-page.json` manifest, and optionally compiles the result. The manifest makes follow-up AI edits safer because agents can update known blocks instead of rewriting a large JSX file by hand.
-Built-in templates currently include `product-homepage` for product/portal pages and `todo-mvc` for a full interaction smoke page covering events, custom state, list rendering, editing, filtering, and localStorage persistence.
+`generate-page` turns a structured spec into a Page IR, renders a curated template, writes a `.openyida-page.json` manifest, and optionally compiles the result. Code Canvas is the default output (`.canvas.jsx`); pass `--native` or output `.oyd.jsx` only when the page must use the 普通自定义页面 JSX/Jsx 组件链路. Pass `--scene workbench|dashboard|list|detail|landing|screen` and `--theme-profile <name-or-json>` / `--visual-profile <name-or-json>` to preserve the visual direction decision in both source comments and the manifest. The user-facing default theme profile is `yida-app-theme`, which follows Yida application theme styling, compact business density, and layered 12/8/6/4 radii. `--theme-scope page` only injects theme variables into the generated page root; `--theme-scope app` additionally calls `window.__YIDA__.updateShellConfig({ themeConfig })` so the application shell can adopt the same theme. Landing pages should declare `spec.assets.heroImage` / `productImages`; use `--resolve-assets` to verify public image URLs and `--upload-assets` to mirror local or verified external images to CDN when CDN is configured. Use `--offline-assets` only for draft/offline gating. The manifest makes follow-up AI edits safer because agents can update known blocks and visual constraints instead of rewriting a large JSX file by hand.
+Built-in templates currently include `official-homepage` for brand/law-firm/product official sites, `data-screen` for immersive monitoring screens, `dashboard-overview` for business dashboards, `workbench-home` for task/entry workbenches, `business-list` for list management pages, `detail-profile` for single-object detail pages, `split-pane-detail` for left-list/right-detail processing consoles, `portal-shell-home` for in-page portal shells, `native-components-smoke` for runtime probing existing Yida host components without changing `vc-deep-yida`, `portal-native-components` for runtime-bridged portal, member, department, and upload components, `product-homepage` for legacy workbench-style pages, and `todo-mvc` for a full interaction smoke page covering events, custom state, list rendering, editing, filtering, and localStorage persistence.
+
+For member, department, attachment, and image upload components, choose the page chain first. Code Canvas pages should start with `native-components-smoke` or `portal-native-components` and follow `yida-canvas-custom-page/references/native-components-bridge.md` for feature detection, fallback, and value normalization. 普通自定义页面 JSX/Jsx pages should use `.oyd.jsx`, read `yida-custom-page/references/component-jsx-guide.md`, and read `attachment-upload-guide.md` when upload fields are involved.
 
 ### Workflow, Data, and Permissions
 
@@ -270,7 +281,7 @@ npm run eval:routing
 # sub-skill, adds guardrail assertions, screenshots the published page, and writes a
 # human scoring template. Runs deterministic CLI commands (no agent) so it serves as
 # a control that proves the build→publish→screenshot→score plumbing itself works.
-# Requires OPENYIDA_E2E=1 and a valid cookie cache.
+# Requires OPENYIDA_E2E=1 and a valid token session.
 OPENYIDA_E2E=1 npm run eval:e2e -- --skill yida-dashboard --screenshot
 
 # Same, plus automatic screenshot scoring via the local multimodal `claude -p`.
@@ -375,6 +386,7 @@ Run `openyida --help` or `openyida <command> --help` for detailed usage.
 | `openyida compile <src>` | Compile custom page locally |
 | `openyida publish <src> <appType> <formUuid> [--health-check] [--force] [--canvas] [--open\|--no-open]` | Compile and publish custom page |
 | `openyida update-form-config <appType> ...` | Update form configuration |
+| `openyida get-form-config <appType> <formUuid> [--json]` | Query form configuration |
 
 ### Data & Permissions
 
@@ -464,6 +476,7 @@ Run `openyida --help` or `openyida <command> --help` for detailed usage.
 | `openyida batch <file>\|--commands "cmd1 ; cmd2" [--stop-on-error] [--json]` | Run OpenYida commands in batch |
 | `openyida flash-to-prd --file <path> --name "<project>"` | Convert flash notes or meeting notes to a PRD prompt |
 | `openyida ai <text\|image> [options]` | Call Yida AI text and image recognition APIs |
+| `openyida asset <status\|verify-url\|resolve\|generate> [options]` | Detect asset capability / verify image URLs / resolve materials |
 | `openyida cdn-config [options]` | Configure CDN / OSS upload |
 | `openyida cdn-upload <image-path>` | Upload image to CDN |
 | `openyida cdn-refresh [options]` | Refresh CDN cache |
@@ -472,6 +485,8 @@ Run `openyida --help` or `openyida <command> --help` for detailed usage.
 
 ### CLI Notes
 
+`openyida asset resolve --hero <path-or-url> --product <path-or-url> --require-hero --upload-assets --json` is the preferred preflight for homepage visuals. It verifies public image URLs, uploads local images when CDN is configured, mirrors verified external images to CDN when `--upload-assets` is passed, and returns `materialStatus: final|draft|none` so agents do not claim an unfinished visual page is final.
+
 #### Environment and Localization
 
 Environment selectors such as `--env intl`, `--intl`, `--overseas`, `--global`, and `--yidaapps` can be used on login-required commands to choose the target Yida environment for that run. The `intl` preset uses `https://www.yidaapps.com` as the built-in Global YiDA entrypoint (not the bare `https://yidaapps.com` domain) and DingTalk International OAuth at `https://login.dingtalk.io`; business API requests still use the authenticated environment `baseUrl`, so customer custom subdomains are supported.

package/bin/yida.js

@@ -707,6 +707,12 @@ async function main() {
       break;
     }
 
+    case 'get-form-config': {
+      const { run: runGetFormConfig } = require('../lib/app/get-form-config');
+      await runGetFormConfig(args);
+      break;
+    }
+
     case 'update-app': {
       if (args.length < 2) {
         throwCliUsage(t('cli.update_app_usage'), t('cli.update_app_example'));
@@ -867,6 +873,12 @@ async function main() {
       break;
     }
 
+    case 'asset': {
+      const { run: runAsset } = require('../lib/asset/asset-cmd');
+      await runAsset(args);
+      break;
+    }
+
     case 'connector': {
       const subCommand = args[0];
       const subArgs = args.slice(1);

package/lib/app/canvas-compile.js

@@ -59,6 +59,12 @@ const IMPORT_SIDE_EFFECT_PATTERN = /import\s+['"]([^'"]+)['"]/g;
 const REQUIRE_PATTERN = /require\(\s*['"]([^'"]+)['"]\s*\)/g;
 const DYNAMIC_IMPORT_PATTERN = /import\(\s*['"]([^'"]+)['"]\s*\)/g;
 
+function stripJsComments(code) {
+  return String(code || '')
+    .replace(/\/\*[\s\S]*?\*\//g, '')
+    .replace(/(^|[^:])\/\/.*$/gm, '$1');
+}
+
 /**
  * 从源码里正则抽取裸包名（过滤相对/绝对路径），去重排序。
  * 对齐 dingtalk-ai-app 的 _extract_imported_modules 行为。
@@ -67,11 +73,12 @@ const DYNAMIC_IMPORT_PATTERN = /import\(\s*['"]([^'"]+)['"]\s*\)/g;
  */
 function extractImportedModules(code) {
   const modules = new Set();
+  const source = stripJsComments(code);
   const patterns = [IMPORT_PATTERN, IMPORT_SIDE_EFFECT_PATTERN, REQUIRE_PATTERN, DYNAMIC_IMPORT_PATTERN];
   for (const pattern of patterns) {
     pattern.lastIndex = 0;
     let match;
-    while ((match = pattern.exec(code)) !== null) {
+    while ((match = pattern.exec(source)) !== null) {
       const name = match[1];
       if (name && !name.startsWith('.') && !name.startsWith('/')) {
         modules.add(name);

package/lib/app/create-app.js

@@ -17,15 +17,59 @@ const { createAuthRef } = require('../core/yida-client');
 const { t } = require('../core/i18n');
 const { buildYidaI18n, normalizeYidaLocale, resolveContentLocale } = require('../core/yida-i18n');
 const { parseOpenOption, withBrowserHandoff } = require('../core/browser-handoff');
+const { assertPresetThemeKey } = require('./theme-presets');
 
 const DEFAULT_APP_OPTIONS = {
   icon: 'xian-yingyong',
   iconColor: '#0089FF',
   colour: 'deepBlue',
-  navTheme: 'dark',
-  layoutDirection: 'slide',
 };
 
+const INDUSTRY_APP_DEFAULTS = [
+  {
+    name: 'legal',
+    pattern: /(律所|律师|法律|法务|合规|仲裁|知识产权|诉讼|legal|law\s*firm|lawyer)/i,
+    options: {
+      icon: 'xian-falv',
+      iconColor: '#5C72FF',
+      colour: 'greyBlue',
+    },
+  },
+  {
+    name: 'tea-ecology',
+    pattern: /(茶叶|茶园|茶业|茶庄|茶文化|农业|生态|环保|有机|健康|tea|agri|eco|green)/i,
+    options: {
+      icon: 'xian-diqiu',
+      iconColor: '#00B853',
+      colour: 'teal',
+    },
+  },
+  {
+    name: 'command-screen',
+    pattern: /(数据大屏|大屏|实时监控|监测预警|预警系统|态势|指挥舱|水质|物联网|iot|screen|monitoring|command\s*center)/i,
+    options: {
+      icon: 'xian-baogao',
+      iconColor: '#14A9FF',
+      colour: 'greyBlue',
+    },
+  },
+  {
+    name: 'professional-service',
+    pattern: /(咨询|审计|会计|投顾|专业服务|企业服务|consulting|audit|advisory)/i,
+    options: {
+      icon: 'xian-qiye',
+      iconColor: '#5C72FF',
+      colour: 'royalBlue',
+    },
+  },
+];
+
+function inferAppDefaults(appName, description) {
+  const text = `${appName || ''} ${description || ''}`;
+  const matched = INDUSTRY_APP_DEFAULTS.find((item) => item.pattern.test(text));
+  return matched ? { industry: matched.name, ...matched.options } : { industry: 'default', ...DEFAULT_APP_OPTIONS };
+}
+
 // ── prd 文档更新 ──────────────────────────────────────
 
 function findPrdFile() {
@@ -177,11 +221,15 @@ function parseCreateAppArgs(args) {
 
   params.appName = params.appName || positional[0] || null;
   params.description = params.description || positional[1] || params.appName;
-  params.icon = params.icon || positional[2] || DEFAULT_APP_OPTIONS.icon;
-  params.iconColor = params.iconColor || positional[3] || DEFAULT_APP_OPTIONS.iconColor;
-  params.colour = params.colour || positional[4] || DEFAULT_APP_OPTIONS.colour;
-  params.navTheme = params.navTheme || positional[5] || DEFAULT_APP_OPTIONS.navTheme;
-  params.layoutDirection = params.layoutDirection || positional[6] || DEFAULT_APP_OPTIONS.layoutDirection;
+
+  const inferredDefaults = inferAppDefaults(params.appName, params.description);
+  params.icon = params.icon || positional[2] || inferredDefaults.icon;
+  params.iconColor = params.iconColor || positional[3] || inferredDefaults.iconColor;
+  params.colour = params.colour || positional[4] || inferredDefaults.colour;
+  assertPresetThemeKey(params.colour);
+  params.navTheme = params.navTheme || positional[5] || null;
+  params.layoutDirection = params.layoutDirection || positional[6] || null;
+  params.industry = inferredDefaults.industry;
 
   return params;
 }
@@ -196,6 +244,40 @@ function printUsage() {
   process.stderr.write(`  ${c.dim}${t('create_app.colors_list')}${c.reset}\n`);
 }
 
+function buildCreateAppPayload(params, auth, contentLocale, openExclusive, openPhysicColumn) {
+  const {
+    appName,
+    description,
+    icon,
+    iconColor,
+    colour,
+    navTheme,
+    layoutDirection,
+  } = params;
+  const iconValue = `${icon}%%${iconColor}`;
+  const payload = {
+    _csrf_token: auth.csrfToken,
+    appName: JSON.stringify(buildYidaI18n(appName, { en_US: appName, ja_JP: appName })),
+    description: JSON.stringify(buildYidaI18n(description, { en_US: description, ja_JP: description })),
+    icon: iconValue,
+    iconUrl: iconValue,
+    colour,
+    defaultLanguage: contentLocale,
+    openExclusive,
+    openPhysicColumn,
+    openIsolationDatabase: 'n',
+    openExclusiveUnit: 'n',
+    group: 'ALL',
+  };
+  if (navTheme) {
+    payload.navTheme = navTheme;
+  }
+  if (layoutDirection) {
+    payload.layoutDirection = layoutDirection;
+  }
+  return payload;
+}
+
 async function run(args) {
   const openOption = parseOpenOption(args);
   args = openOption.args;
@@ -220,13 +302,13 @@ async function run(args) {
 
   const { appName, description, icon, iconColor, colour, navTheme, layoutDirection } = params;
 
-  const { c, banner, step, label, info, success: chalkSuccess, result: chalkResult } = require('../core/chalk');
+  const { c, banner, step, label, success: chalkSuccess, result: chalkResult } = require('../core/chalk');
 
   banner(t('create_app.title'));
   label('Name', appName);
   label('Desc', description);
   label('Icon', `${icon} ${c.dim}(${iconColor})${c.reset}`);
-  label('Theme', `${colour} / ${navTheme} / ${layoutDirection}`);
+  label('Theme', `${colour} / ${navTheme || 'default'} / ${layoutDirection || 'default'}`);
 
   // Step 1: 读取登录态
   step(1, t('common.step_login', 1));
@@ -257,23 +339,9 @@ async function run(args) {
     // 查询失败时使用默认值，不影响主流程
   }
 
-  const iconValue = `${icon}%%${iconColor}`;
   const response = await requestWithAutoLogin((auth) => {
-    const postData = querystring.stringify({
-      appName: JSON.stringify(buildYidaI18n(appName, { en_US: appName, ja_JP: appName })),
-      description: JSON.stringify(buildYidaI18n(description, { en_US: description, ja_JP: description })),
-      icon: iconValue,
-      iconUrl: iconValue,
-      colour,
-      navTheme,
-      layoutDirection,
-      defaultLanguage: contentLocale,
-      openExclusive: openExclusive,
-      openPhysicColumn: openPhysicColumn,
-      openIsolationDatabase: 'n',
-      openExclusiveUnit: 'n',
-      group: 'ALL',
-    });
+    const payload = buildCreateAppPayload(params, auth, contentLocale, openExclusive, openPhysicColumn);
+    const postData = querystring.stringify(payload);
     return httpPost(auth.baseUrl, '/query/app/registerApp.json', postData);
   }, authRef);
 
@@ -306,4 +374,4 @@ async function run(args) {
   }
 }
 
-module.exports = { run, parseCreateAppArgs };
+module.exports = { run, parseCreateAppArgs, inferAppDefaults, buildCreateAppPayload };

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

@@ -0,0 +1,263 @@
+'use strict';
+
+function parseMaybeJsonValue(value) {
+  if (typeof value !== 'string') {
+    return value;
+  }
+  const trimmed = value.trim();
+  if (!trimmed) {
+    return value;
+  }
+  if (
+    (trimmed.startsWith('{') && trimmed.endsWith('}')) ||
+    (trimmed.startsWith('[') && trimmed.endsWith(']'))
+  ) {
+    try {
+      return JSON.parse(trimmed);
+    } catch {
+      return value;
+    }
+  }
+  return value;
+}
+
+function parseInlineValidationOptions(tokens) {
+  if (!Array.isArray(tokens) || tokens.length === 0) {
+    return null;
+  }
+
+  const rule = {};
+  for (let index = 0; index < tokens.length; index++) {
+    const token = tokens[index];
+    if (!token || !token.startsWith('--')) {
+      continue;
+    }
+    const key = token.slice(2).replace(/-/g, '_');
+    const next = tokens[index + 1];
+    if (next && !next.startsWith('--')) {
+      rule[key] = parseMaybeJsonValue(next);
+      index++;
+    } else {
+      rule[key] = true;
+    }
+  }
+
+  if (!rule.field && !rule.field_id && !rule.label && !rule.target && !rule.type) {
+    return null;
+  }
+
+  if (rule.field_id && !rule.fieldId) {
+    rule.fieldId = rule.field_id;
+  }
+  if (rule.domain_whitelist && !rule.domainWhitelist) {
+    rule.domainWhitelist = String(rule.domain_whitelist).split(',').map(function (item) {
+      return item.trim();
+    }).filter(Boolean);
+  }
+  if (rule.compare_to && !rule.compareTo) {
+    rule.compareTo = rule.compare_to;
+  }
+  if (rule.other_field && !rule.otherField) {
+    rule.otherField = rule.other_field;
+  }
+
+  return rule;
+}
+
+function createParseArgs(dependencies) {
+  const {
+    parseOpenOption,
+    normalizeYidaLocale,
+    usage,
+    hint,
+    error,
+    t,
+    throwCreateFormError,
+  } = dependencies;
+
+  return function parseArgs(inputArgs) {
+    const openOption = parseOpenOption(inputArgs || process.argv.slice(2));
+    const rawArgs = openOption.args;
+
+    const options = {
+      layout: 'single',
+      theme: 'default',
+      labelAlign: 'top',
+      contentLocale: null,
+      browserOpenMode: openOption.mode,
+    };
+
+    const args = [...rawArgs];
+
+    for (let i = 0; i < args.length; i++) {
+      if (args[i] === '--layout' && i + 1 < args.length) {
+        options.layout = args[i + 1];
+        args.splice(i, 2);
+        i--;
+      } 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' && i + 1 < args.length) {
+        options.labelAlign = args[i + 1];
+        args.splice(i, 2);
+        i--;
+      } 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');
+        }
+        process.env.OPENYIDA_CONTENT_LOCALE = normalizeYidaLocale(options.contentLocale);
+        args.splice(i, 2);
+        i--;
+      } else if (args[i] === '--force') {
+        options.force = true;
+        args.splice(i, 1);
+        i--;
+      }
+    }
+
+    const mode = args[0];
+
+    if (mode === 'create') {
+      if (args.length < 4) {
+        usage(t('create_form.usage_create'), t('create_form.example_create'));
+        throwCreateFormError(t('create_form.usage_create'), 'CREATE_FORM_INVALID_ARGUMENTS');
+      }
+      return {
+        mode: 'create',
+        appType: args[1],
+        formTitle: args[2],
+        fieldsJsonOrFile: args[3],
+        ...options
+      };
+    }
+
+    if (mode === 'update') {
+      if (args.length < 4) {
+        usage(t('create_form.usage_update'), t('create_form.example_update'));
+        throwCreateFormError(t('create_form.usage_update'), 'CREATE_FORM_INVALID_ARGUMENTS');
+      }
+      return {
+        mode: 'update',
+        appType: args[1],
+        formUuid: args[2],
+        changesJsonOrFile: args[3],
+        ...options
+      };
+    }
+
+    if (mode === 'patch') {
+      if (args.length < 4) {
+        usage(
+          'openyida create-form patch <appType> <formUuid> <patchJsonOrFile>',
+          'openyida create-form patch APP_XXX FORM-XXX .cache/openyida/forms/form-patch.json'
+        );
+        throwCreateFormError('openyida create-form patch <appType> <formUuid> <patchJsonOrFile>', 'CREATE_FORM_INVALID_ARGUMENTS');
+      }
+      return {
+        mode: 'patch',
+        appType: args[1],
+        formUuid: args[2],
+        patchJsonOrFile: args[3],
+        ...options
+      };
+    }
+
+    if (mode === 'rule' || mode === 'rules') {
+      if (args.length < 4) {
+        usage(
+          'openyida create-form rule <appType> <formUuid> <rulesJsonOrFile>',
+          'openyida create-form rule APP_XXX FORM-XXX .cache/openyida/forms/form-rules.json'
+        );
+        throwCreateFormError('openyida create-form rule <appType> <formUuid> <rulesJsonOrFile>', 'CREATE_FORM_INVALID_ARGUMENTS');
+      }
+      return {
+        mode: 'rule',
+        appType: args[1],
+        formUuid: args[2],
+        rulesJsonOrFile: args[3],
+        ...options
+      };
+    }
+
+    if (mode === 'validation' || mode === 'validate' || mode === 'validations') {
+      const inlineRule = parseInlineValidationOptions(args.slice(3));
+      if (args.length < 4 && !inlineRule) {
+        usage(
+          'openyida create-form validation <appType> <formUuid> <validationsJsonOrFile>',
+          'openyida create-form validation APP_XXX FORM-XXX .cache/openyida/forms/form-validations.json'
+        );
+        hint('openyida add-validation APP_XXX FORM-XXX --field "手机号" --type phone --message "请输入正确的手机号"');
+        throwCreateFormError('openyida create-form validation <appType> <formUuid> <validationsJsonOrFile>', 'CREATE_FORM_INVALID_ARGUMENTS');
+      }
+      return {
+        mode: 'validation',
+        appType: args[1],
+        formUuid: args[2],
+        validationJsonOrFile: inlineRule ? '' : args[3],
+        inlineValidationRule: inlineRule,
+        ...options
+      };
+    }
+
+    if (mode === 'bind-datasource' || mode === 'datasource' || mode === 'data-source') {
+      if (args.length < 5) {
+        usage(
+          'openyida create-form bind-datasource <appType> <formUuid> <fieldLabelOrId> <dataSourceJsonOrFile>',
+          'openyida create-form bind-datasource APP_XXX FORM-XXX "客户" .cache/openyida/forms/customer-datasource.json'
+        );
+        throwCreateFormError('openyida create-form bind-datasource <appType> <formUuid> <fieldLabelOrId> <dataSourceJsonOrFile>', 'CREATE_FORM_INVALID_ARGUMENTS');
+      }
+      return {
+        mode: 'bind-datasource',
+        appType: args[1],
+        formUuid: args[2],
+        fieldLabel: args[3],
+        dataSourceJsonOrFile: args[4],
+        ...options
+      };
+    }
+
+    if (mode === 'add-option') {
+      if (args.length < 5) {
+        usage(
+          'openyida create-form add-option <appType> <formUuid> <fieldLabel> <option1> [option2] ...',
+          'openyida create-form add-option APP_XXX FORM-XXX "优先级" "P0" "P1"'
+        );
+        throwCreateFormError('openyida create-form add-option <appType> <formUuid> <fieldLabel> <option1> [option2] ...', 'CREATE_FORM_INVALID_ARGUMENTS');
+      }
+      return {
+        mode: 'add-option',
+        appType: args[1],
+        formUuid: args[2],
+        fieldLabel: args[3],
+        newOptions: args.slice(4).filter(function (arg) { return !arg.startsWith('--'); }),
+        ...options
+      };
+    }
+
+    if (args.length >= 3 && mode !== 'create' && mode !== 'update' && mode !== 'patch' && mode !== 'rule' && mode !== 'rules' && mode !== 'validation' && mode !== 'validate' && mode !== 'validations' && mode !== 'bind-datasource' && mode !== 'datasource' && mode !== 'data-source') {
+      return {
+        mode: 'create',
+        appType: args[0],
+        formTitle: args[1],
+        fieldsJsonOrFile: args[2],
+        ...options
+      };
+    }
+
+    usage(t('create_form.usage_create_short'));
+    hint(t('create_form.usage_update_short'));
+    hint(t('create_form.example_create'));
+    hint(t('create_form.example_update'));
+    throwCreateFormError(t('create_form.usage_create_short'), 'CREATE_FORM_INVALID_ARGUMENTS');
+  };
+}
+
+module.exports = {
+  createParseArgs,
+  parseInlineValidationOptions,
+  parseMaybeJsonValue,
+};

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

@@ -0,0 +1,27 @@
+'use strict';
+
+function dispatchCreateFormCommand(parsedArgs, authContext, handlers) {
+  const args = [parsedArgs, authContext];
+
+  switch (parsedArgs.mode) {
+    case 'update':
+      return handlers.update(...args);
+    case 'patch':
+      return handlers.patch(...args);
+    case 'rule':
+      return handlers.rule(...args);
+    case 'validation':
+      return handlers.validation(...args);
+    case 'bind-datasource':
+      return handlers.bindDataSource(...args);
+    case 'add-option':
+      return handlers.addOption(...args);
+    case 'create':
+    default:
+      return handlers.create(...args);
+  }
+}
+
+module.exports = {
+  dispatchCreateFormCommand,
+};