openyida 2026.9.7 → 2026.9.8-1

package/README.md

@@ -174,6 +174,8 @@ openyida update-app APP_XXX --theme-file .cache/openyida/crm/app-theme.css --nav
 openyida corp-efficiency
 openyida create-form create APP_XXX "Customer" .cache/openyida/forms/customer-fields.json
 openyida create-form update APP_XXX FORM_XXX .cache/openyida/forms/customer-changes.json
+openyida create-form update APP_XXX FORM_XXX --data-file .cache/openyida/forms/customer-changes.json
+openyida create-form resume APP_XXX FORM_XXX .cache/openyida/forms/customer-fields.json --json
 openyida sample openyida-page-template form-fields --output .cache/openyida/forms/customer-fields.json
 openyida sample openyida-page-template canvas-form-drawer --output project/pages/src/customer-entry.canvas.jsx --var APP_TYPE=APP_XXX --var FORM_UUID=FORM_XXX
 openyida get-schema APP_XXX FORM_XXX
@@ -413,7 +415,8 @@ Run `openyida --help` or `openyida <command> --help` for detailed usage.
 | `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> ... [--locale zh_CN\|en_US\|ja_JP] [--open\|--no-open]` | Update a form page |
+| `openyida create-form update <appType> <formUuid> (<changesJsonOrFile> \| --data-file <changesJsonOrFile>) [--locale zh_CN\|en_US\|ja_JP] [--open\|--no-open]` | Update a form page |
+| `openyida create-form resume <appType> <formUuid> <fieldsJsonOrFile> [--json]` | Update a form page |
 | `openyida create-form patch <appType> <formUuid> <patchJsonOrFile> [--open\|--no-open]` | Update a form page |
 | `openyida create-form rule <appType> <formUuid> <rulesJsonOrFile> [--open\|--no-open]` | Update a form page |
 | `openyida create-form validation <appType> <formUuid> <validationsJsonOrFile> [--open\|--no-open]` | Update a form page |

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

@@ -89,6 +89,7 @@ function createParseArgs(dependencies) {
       contentLocale: null,
       browserOpenMode: openOption.mode,
     };
+    let dataFileInput;
 
     const args = [...rawArgs];
 
@@ -111,6 +112,14 @@ function createParseArgs(dependencies) {
         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('--')) {
+          throwCreateFormError('--data-file requires exactly one value', 'CREATE_FORM_INVALID_ARGUMENTS');
+        }
+        dataFileInput = next;
+        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)) {
@@ -145,6 +154,10 @@ function createParseArgs(dependencies) {
 
     const mode = args[0];
 
+    if (dataFileInput !== undefined && mode !== 'update') {
+      throwCreateFormError('--data-file is only supported by create-form update', 'CREATE_FORM_INVALID_ARGUMENTS');
+    }
+
     if (mode === 'icons' || mode === 'list-icons') {
       return {
         mode: 'icons',
@@ -182,7 +195,12 @@ function createParseArgs(dependencies) {
     }
 
     if (mode === 'update') {
-      if (args.length < 4) {
+      const positionalInput = args[3];
+      if (args.length > 4 || (positionalInput && dataFileInput !== undefined)) {
+        throwCreateFormError('Use either <changesJsonOrFile> or --data-file, not both', 'CREATE_FORM_INVALID_ARGUMENTS');
+      }
+      const changesJsonOrFile = dataFileInput !== undefined ? dataFileInput : positionalInput;
+      if (args.length < 3 || !changesJsonOrFile) {
         usage(t('create_form.usage_update'), t('create_form.example_update'));
         throwCreateFormError(t('create_form.usage_update'), 'CREATE_FORM_INVALID_ARGUMENTS');
       }
@@ -190,7 +208,23 @@ function createParseArgs(dependencies) {
         mode: 'update',
         appType: args[1],
         formUuid: args[2],
-        changesJsonOrFile: args[3],
+        changesJsonOrFile,
+        ...options
+      };
+    }
+
+    if (mode === 'resume') {
+      if (args.length !== 4) {
+        throwCreateFormError(
+          'openyida create-form resume <appType> <formUuid> <fieldsJsonOrFile> --json',
+          'CREATE_FORM_INVALID_ARGUMENTS'
+        );
+      }
+      return {
+        mode: 'resume',
+        appType: args[1],
+        formUuid: args[2],
+        fieldsJsonOrFile: args[3],
         ...options
       };
     }

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

@@ -101,7 +101,10 @@ function execute(args) {
 }
 
 async function schedule(forms, concurrency, results, worker, save) {
-  const pending = new Set(forms.filter(form => !results[form.key] || results[form.key].status === 'blocked').map(form => form.key));
+  const pending = new Set(forms.filter(form => {
+    const result = results[form.key];
+    return !result || result.status === 'blocked' || (result.status === 'failed' && result.formUuid);
+  }).map(form => form.key));
   const active = new Map();
   try {
     while (pending.size || active.size) {
@@ -114,7 +117,7 @@ async function schedule(forms, concurrency, results, worker, save) {
         }
         if (active.size >= concurrency || deps.some(status => status !== 'success')) { continue; }
         pending.delete(form.key);
-        results[form.key] = { status: 'running' };
+        results[form.key] = { ...results[form.key], status: 'running' };
         save(); // Record intent before the request; an interrupted create is never retried automatically.
         const task = Promise.resolve().then(() => worker(form)).then(output => {
           results[form.key] = { ...output, status: 'success' };
@@ -178,16 +181,30 @@ async function run(args, dependencies = {}) {
       return matches[0].fieldId;
     };
     await schedule(forms, options.concurrency, state.results, async form => {
-      let formUuid = form.formUuid;
+      let formUuid = form.formUuid || state.results[form.key]?.formUuid;
+      let shouldResume = Boolean(!form.formUuid && formUuid);
+      const resolvedFields = mapReferences(form.fields, resolve);
       if (!formUuid) {
-        const argv = ['create-form', 'create', options.appType, form.title, JSON.stringify(mapReferences(form.fields, resolve)), '--no-open'];
+        const argv = ['create-form', 'create', options.appType, form.title, JSON.stringify(resolvedFields), '--no-open'];
         for (const key of ['icon', 'locale']) { if (form[key]) { argv.push(`--${key}`, form[key]); } }
-        const created = await call(argv);
-        if (typeof created.formUuid !== 'string' || !created.formUuid.startsWith('FORM')) { invalid(`create result: ${form.key}`); }
-        formUuid = created.formUuid;
+        try {
+          const created = await call(argv);
+          if (typeof created.formUuid !== 'string' || !created.formUuid.startsWith('FORM')) { invalid(`create result: ${form.key}`); }
+          formUuid = created.formUuid;
+        } catch (error) {
+          const createdFormUuid = error.output?.formUuid || error.output?.details?.formUuid;
+          if (typeof createdFormUuid !== 'string' || !createdFormUuid.startsWith('FORM')) {
+            throw error;
+          }
+          formUuid = createdFormUuid;
+          shouldResume = true;
+        }
       }
       state.results[form.key].formUuid = formUuid;
       save(state);
+      if (shouldResume) {
+        await call(['create-form', 'resume', options.appType, formUuid, JSON.stringify(resolvedFields), '--json']);
+      }
       const schema = await call(['get-schema', options.appType, formUuid, '--field-map-json']);
       if (schema.formUuid !== formUuid || !Array.isArray(schema.fields)) { invalid(`schema: ${form.key}`); }
       return { formUuid, fields: schema.fields };

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

@@ -6,6 +6,8 @@ function dispatchCreateFormCommand(parsedArgs, authContext, handlers) {
   switch (parsedArgs.mode) {
     case 'update':
       return handlers.update(...args);
+    case 'resume':
+      return handlers.resume(...args);
     case 'patch':
       return handlers.patch(...args);
     case 'rule':

package/lib/app/create-form.js

@@ -5911,6 +5911,297 @@ async function mainValidation(parsedArgs, authRef) {
 
 // ── update 模式主流程 ─────────────────────────────────
 
+function collectResumeFieldEvidence(fields, output) {
+  const evidence = output || [];
+  (fields || []).forEach(function (field) {
+    if (!field || typeof field !== 'object') {
+      return;
+    }
+    const labelText = extractLabelText(field);
+    if (labelText && !isFormPresentationComponent(field.componentName)) {
+      evidence.push({
+        label: labelText,
+        componentName: field.componentName,
+        fieldId: field.props && field.props.fieldId ? field.props.fieldId : null,
+      });
+    }
+    if (Array.isArray(field.children)) {
+      collectResumeFieldEvidence(field.children.flat(), evidence);
+    }
+  });
+  return evidence;
+}
+
+function desiredResumeFieldIdentity(field) {
+  const labelValue = field && field.label;
+  const label = typeof labelValue === 'string'
+    ? labelValue
+    : labelValue && (labelValue.zh_CN || labelValue.ja_JP || labelValue.en_US || labelValue.pureEn_US);
+  return {
+    label: String(label || '').trim(),
+    componentName: normalizeFormDefinitionType(field),
+  };
+}
+
+function collectResumeDesiredFields(fields, options) {
+  const output = [];
+  const verifyNestedFields = Boolean(options && options.verifyNestedFields);
+
+  function visit(value) {
+    if (Array.isArray(value)) {
+      value.forEach(visit);
+      return;
+    }
+    if (!value || typeof value !== 'object') {
+      return;
+    }
+    const componentName = normalizeFormDefinitionType(value);
+    if (isSupportedBusinessFieldType(componentName)) {
+      output.push(value);
+      if (!verifyNestedFields) {
+        return;
+      }
+    }
+    if (Array.isArray(value.children)) {
+      value.children.forEach(visit);
+    }
+  }
+
+  visit(fields);
+  return output;
+}
+
+function isRecoverableBlankResumeSchema(schema) {
+  const allowedShellComponents = new Set(['Page', 'RootHeader', 'RootContent', 'RootFooter', 'FooterYida']);
+  const componentsTree = schema && schema.pages && schema.pages[0] && schema.pages[0].componentsTree;
+  if (!Array.isArray(componentsTree) || componentsTree.length === 0) {
+    return true;
+  }
+  let safe = true;
+  function visit(node) {
+    if (!node || typeof node !== 'object' || !safe) {
+      return;
+    }
+    if (node.componentName && !allowedShellComponents.has(node.componentName)) {
+      safe = false;
+      return;
+    }
+    if (Array.isArray(node.children)) {
+      node.children.forEach(visit);
+    }
+  }
+  componentsTree.forEach(visit);
+  return safe;
+}
+
+function buildResumeChanges(existingFields, desiredFields) {
+  const existingByLabel = new Map();
+  existingFields.forEach(function (field) {
+    const bucket = existingByLabel.get(field.label) || [];
+    bucket.push(field);
+    existingByLabel.set(field.label, bucket);
+  });
+
+  const desiredLabels = new Set();
+  const missing = [];
+  const existing = [];
+  const conflicts = [];
+  desiredFields.forEach(function (field) {
+    const identity = desiredResumeFieldIdentity(field);
+    if (!identity.label || desiredLabels.has(identity.label)) {
+      conflicts.push({
+        code: identity.label ? 'CREATE_FORM_RESUME_DUPLICATE_DESIRED_FIELD' : 'CREATE_FORM_RESUME_FIELD_LABEL_REQUIRED',
+        label: identity.label || null,
+      });
+      return;
+    }
+    desiredLabels.add(identity.label);
+    const matches = existingByLabel.get(identity.label) || [];
+    if (matches.length === 0) {
+      missing.push(field);
+      return;
+    }
+    if (matches.length !== 1 || matches[0].componentName !== identity.componentName) {
+      conflicts.push({
+        code: 'CREATE_FORM_RESUME_FIELD_CONFLICT',
+        label: identity.label,
+        requestedType: identity.componentName,
+        observedTypes: matches.map(function (item) { return item.componentName; }),
+      });
+      return;
+    }
+    existing.push({
+      label: identity.label,
+      componentName: identity.componentName,
+      fieldId: matches[0].fieldId,
+    });
+  });
+  return { missing, existing, conflicts };
+}
+
+async function readResumeSchema(authRef, appType, formUuid) {
+  const schemaResult = await requestWithAutoLogin(function (auth) {
+    return sendGetRequest(
+      auth.baseUrl,
+      buildApiPath(appType, 'getFormSchema', { prefix: '_view', namespace: 'alibaba' }),
+      { formUuid: formUuid, schemaVersion: 'V5' }
+    );
+  }, authRef);
+  if (!schemaResult || schemaResult.success === false || schemaResult.__needLogin || schemaResult.__csrfExpired) {
+    throwCreateFormError(t('create_form.resume_readback_failed'), 'CREATE_FORM_RESUME_READBACK_FAILED', {
+      appType,
+      formUuid,
+      result: sanitizeFailureResult(schemaResult),
+    });
+  }
+  if (schemaResult.appType && schemaResult.appType !== appType) {
+    throwCreateFormError(t('create_form.resume_ownership_unverified'), 'CREATE_FORM_RESUME_OWNERSHIP_UNVERIFIED', {
+      appType,
+      formUuid,
+    });
+  }
+  if (schemaResult.formUuid && schemaResult.formUuid !== formUuid) {
+    throwCreateFormError(t('create_form.resume_identity_mismatch'), 'CREATE_FORM_RESUME_OWNERSHIP_UNVERIFIED', {
+      appType,
+      formUuid,
+    });
+  }
+  const schema = schemaResult.content
+    ? (typeof schemaResult.content === 'string' ? JSON.parse(schemaResult.content) : schemaResult.content)
+    : schemaResult.pages ? schemaResult : null;
+  if (!schema || !Array.isArray(schema.pages) || schema.pages.length === 0) {
+    throwCreateFormError(t('create_form.resume_schema_invalid'), 'CREATE_FORM_RESUME_SCHEMA_INVALID', {
+      appType,
+      formUuid,
+    });
+  }
+  return { schemaResult, schema, version: extractSchemaServerRevision(schemaResult) };
+}
+
+async function mainResume(parsedArgs, authRef) {
+  const { appType, formUuid, fieldsJsonOrFile } = parsedArgs;
+  assertNoEmojiInDefinitionFileName(fieldsJsonOrFile);
+  const { fields, validations } = readFieldsDefinition(fieldsJsonOrFile);
+  assertNoEmojiInFormDefinition(formUuid, fields, [], 'create-form resume input');
+  validateFormFieldDefinitions(fields);
+
+  const firstRead = await readResumeSchema(authRef, appType, formUuid);
+  const root = firstRead.schema.pages[0].componentsTree && firstRead.schema.pages[0].componentsTree[0];
+  const formContainer = root ? findFormContainer(root) : null;
+  const completedStages = ['read_target', 'verify_ownership'];
+  let recoveredBlankShell = false;
+  let plan;
+
+  if (!formContainer) {
+    if (!isRecoverableBlankResumeSchema(firstRead.schema)) {
+      throwCreateFormError(t('create_form.resume_container_invalid'), 'CREATE_FORM_RESUME_SCHEMA_INVALID', {
+        appType,
+        formUuid,
+        retryable: false,
+        remoteWrites: 0,
+      });
+    }
+    const corpId = resolveCorpId(authRef.authData);
+    const formTitle = firstRead.schemaResult.formTitle || firstRead.schemaResult.title || formUuid;
+    firstRead.schema = buildFormSchema(formTitle, fields, formUuid, corpId, appType, 'single', 'default', 'top');
+    const resumeValidationRules = collectSmartValidationRulesFromFields(fields).concat(validations || []);
+    if (resumeValidationRules.length > 0) {
+      applySmartValidations(firstRead.schema, resumeValidationRules);
+    }
+    await saveFormSchema(authRef, appType, formUuid, firstRead.schema, firstRead.version, 4);
+    completedStages.push('rebuild_blank_schema', 'save_schema');
+    recoveredBlankShell = true;
+    plan = {
+      existing: [],
+      missing: collectResumeDesiredFields(fields, { verifyNestedFields: true }),
+      conflicts: [],
+    };
+  } else if (!Array.isArray(formContainer.children)) {
+    throwCreateFormError(t('create_form.resume_container_invalid'), 'CREATE_FORM_RESUME_SCHEMA_INVALID', {
+      appType,
+      formUuid,
+      retryable: false,
+      remoteWrites: 0,
+    });
+  } else {
+    plan = buildResumeChanges(
+      collectResumeFieldEvidence(formContainer.children),
+      collectResumeDesiredFields(fields)
+    );
+    if (plan.conflicts.length > 0) {
+      throwCreateFormError(t('create_form.resume_field_conflict'), 'CREATE_FORM_RESUME_CONFLICT', {
+        appType,
+        formUuid,
+        retryable: false,
+        remoteWrites: 0,
+        diagnostics: plan.conflicts,
+      });
+    }
+    completedStages.push('compare_fields');
+  }
+
+  if (!recoveredBlankShell && plan.missing.length > 0) {
+    const applied = applyChangesToSchema(
+      firstRead.schema,
+      plan.missing.map(function (field) { return { action: 'add', field }; }),
+      { verbose: true }
+    );
+    if ((applied.diagnostics || []).length > 0) {
+      throwCreateFormError(t('create_form.resume_field_resolution_failed'), 'CREATE_FORM_RESUME_CONFLICT', {
+        appType,
+        formUuid,
+        retryable: false,
+        remoteWrites: 0,
+        diagnostics: applied.diagnostics,
+      });
+    }
+    const corpId = resolveCorpId(authRef.authData);
+    const updatedContainer = findFormContainer(firstRead.schema.pages[0].componentsTree[0]);
+    fillSerialNumberFormulas(updatedContainer.children, corpId, appType, formUuid);
+    await saveFormSchema(authRef, appType, formUuid, firstRead.schema, firstRead.version, 4);
+    completedStages.push('add_missing_fields', 'save_schema');
+  }
+
+  const finalRead = await readResumeSchema(authRef, appType, formUuid);
+  const finalContainer = findFormContainer(finalRead.schema.pages[0].componentsTree[0]);
+  const finalPlan = buildResumeChanges(
+    collectResumeFieldEvidence(finalContainer && finalContainer.children),
+    collectResumeDesiredFields(fields, { verifyNestedFields: true })
+  );
+  if (finalPlan.missing.length > 0 || finalPlan.conflicts.length > 0) {
+    throwCreateFormError(t('create_form.resume_readback_mismatch'), 'CREATE_FORM_RESUME_READBACK_MISMATCH', {
+      appType,
+      formUuid,
+      retryable: false,
+      resultUnknown: true,
+      completedStages,
+      missingFieldCount: finalPlan.missing.length,
+      diagnostics: finalPlan.conflicts,
+    });
+  }
+  completedStages.push('verify_final_schema');
+  const formUrl = authRef.baseUrl + '/' + appType + '/workbench/' + formUuid;
+  const output = {
+    success: true,
+    appType,
+    formUuid,
+    completedStages,
+    requestedFieldCount: fields.length,
+    existingFieldCount: plan.existing.length,
+    addedFieldCount: plan.missing.length,
+    finalFieldCount: collectResumeFieldEvidence(finalContainer.children).length,
+    recoveredBlankShell,
+    url: formUrl,
+  };
+  console.log(JSON.stringify(withBrowserHandoff(
+    output,
+    formUrl,
+    { stage: 'resume_form_success', title: formUuid },
+    parsedArgs.browserOpenMode
+  )));
+  return output;
+}
+
 async function mainUpdate(parsedArgs, authRef) {
   const { appType, formUuid, changesJsonOrFile } = parsedArgs;
 
@@ -6102,6 +6393,7 @@ async function run(args) {
     {
       create: mainCreate,
       update: mainUpdate,
+      resume: mainResume,
       patch: mainPatch,
       rule: mainRule,
       validation: mainValidation,

package/lib/core/command-manifest.js

@@ -449,6 +449,7 @@ const COMMAND_SIDE_EFFECTS = new Map([
     'create-form.bind-datasource',
     'create-form.create',
     'create-form.patch',
+    'create-form.resume',
     'create-form.rule',
     'create-form.update',
     'create-form.validation',
@@ -689,6 +690,7 @@ const COMMAND_PERMISSIONS = new Map([
     'create-form.create',
     'create-form.batch',
     'create-form.patch',
+    'create-form.resume',
     'create-form.rule',
     'create-form.update',
     'create-form.validation',
@@ -1223,7 +1225,8 @@ const COMMAND_GROUPS = [
       command('create-form.validate-fields', ['create-form', 'validate-fields'], 'create-form validate-fields <fieldsJsonOrFile> [--json]', 'help.cmd_validate_form', {
         requiresLogin: false,
       }),
-      command('create-form.update', ['create-form', 'update'], 'create-form update <appType> ... [--locale zh_CN|en_US|ja_JP] [--open|--no-open]', 'help.cmd_update_form'),
+      command('create-form.update', ['create-form', 'update'], 'create-form update <appType> <formUuid> (<changesJsonOrFile> | --data-file <changesJsonOrFile>) [--locale zh_CN|en_US|ja_JP] [--open|--no-open]', 'help.cmd_update_form'),
+      command('create-form.resume', ['create-form', 'resume'], 'create-form resume <appType> <formUuid> <fieldsJsonOrFile> [--json]', 'help.cmd_update_form'),
       command('create-form.patch', ['create-form', 'patch'], 'create-form patch <appType> <formUuid> <patchJsonOrFile> [--open|--no-open]', 'help.cmd_update_form'),
       command('create-form.rule', ['create-form', 'rule'], 'create-form rule <appType> <formUuid> <rulesJsonOrFile> [--open|--no-open]', 'help.cmd_update_form'),
       command('create-form.validation', ['create-form', 'validation'], 'create-form validation <appType> <formUuid> <validationsJsonOrFile> [--open|--no-open]', 'help.cmd_update_form'),

package/lib/core/locales/en.js

@@ -414,9 +414,9 @@ Examples:
     create_opt_spec: '  --spec <file.json>            Use a structured flow spec for complex automation nodes (dataUpdate/route, etc.)',
     create_opt_data_form_uuid: '  --data-form-uuid <uuid>     Target form UUID for a get-single-data node',
     create_opt_data_condition: '  --data-condition <rule>     Get-data condition: targetField:label:triggerField[:component[:opCode[:valueType]]]',
-    create_opt_get_self: '  --get-self                    Insert a get-self node (pid equals trigger form instance ID)',
+    create_opt_get_self: '  --get-self                    Insert a get-self node (process runtime uses pid, designer uses proc_inst_id; ordinary forms use form_inst_id on both sides)',
     create_opt_get_self_field: '  --get-self-field <field>     Override the trigger-side system field, default __masterdata_form_inst_id',
-    create_opt_get_self_query_field: '  --get-self-query-field <f>  Override the query-side system field, default pid',
+    create_opt_get_self_query_field: '  --get-self-query-field <f>  Override the query-side system field (process: pid runtime / proc_inst_id designer; ordinary: form_inst_id)',
     create_opt_add_data_form_uuid: '  --add-data-form-uuid <uuid> Target form UUID for an add-data node',
     create_opt_add_data_assignment: '  --add-data-assignment <rule> Add-data assignment: targetField:valueType:value',
     create_opt_initiate_approval_form_uuid: '  --initiate-approval-form-uuid <uuid> Target process-form UUID for an initiate-approval node',
@@ -432,6 +432,11 @@ Examples:
     create_example2: '  openyida integration create APP_XXX FORM-XXX "Get self then notify" --get-self --publish',
     create_missing_args: 'Missing required arguments.',
     create_replace_required: 'Using --process-code fully replaces the existing flow. Pass --replace explicitly. Safe editing is not currently available; integration update only reports capability status.',
+    create_source_form_fetch_failed: 'Could not read the data-source form metadata; remote write stopped: {0}',
+    create_source_form_not_found: 'Could not find data-source form {0} in navigation; remote write stopped.',
+    create_source_form_type_unknown: 'Navigation did not return a verifiable data-source form type; remote write stopped.',
+    create_source_form_type_invalid: 'Navigation returned unsupported data-source form type "{0}"; remote write stopped.',
+    create_source_form_type_mismatch: 'Explicit formType={0} conflicts with navigation metadata {1}; remote write stopped.',
     create_flow_name_too_long: 'Logic-flow names cannot exceed {0} characters (received {1}).',
     create_invalid_events: 'No valid trigger event was recognized.',
     create_no_receivers: 'No notification receiver or user field specified; no message node will be generated.',
@@ -449,7 +454,7 @@ Examples:
     create_notify_content: 'Notification content: {0}',
     create_data_form: 'Get-data form: {0}',
     create_data_conditions: 'Get-data condition count: {0}',
-    create_get_self_summary: 'Get-self guardrail: {0} equals field {1}',
+    create_get_self_summary: 'Get-self guardrail: runtime query field {0} equals field {1}; process-form designer maps it to proc_inst_id, while ordinary forms keep the same field',
     create_op_mode_publish: 'Mode: save and publish',
     create_op_mode_draft: 'Mode: save draft only',
     create_step: '[{0}/{1}] {2}',
@@ -822,7 +827,15 @@ Examples:
     example_update: 'Example: openyida create-form update "APP_XXX" "FORM-YYY" \'[{"action":"add","field":{"type":"TextField","label":"Note"}}]\'',
     usage_label: 'Usage:',
     usage_create_short: '  create: openyida create-form create <appType> <formTitle> <fieldsJsonFile>',
-    usage_update_short: '  update: openyida create-form update <appType> <formUuid> <changesJsonOrFile>',
+    usage_update_short: '  update: openyida create-form update <appType> <formUuid> <changesJsonOrFile> or --data-file <changesJsonOrFile>',
+    resume_readback_failed: 'Unable to read the target form before resume.',
+    resume_ownership_unverified: 'The target form does not belong to the requested app; resume stopped.',
+    resume_identity_mismatch: 'The target form identity does not match the readback; resume stopped.',
+    resume_schema_invalid: 'The target form schema is unavailable.',
+    resume_container_invalid: 'The target form container is unavailable.',
+    resume_field_conflict: 'Existing fields conflict with the requested definition; resume stopped.',
+    resume_field_resolution_failed: 'Resume field resolution failed.',
+    resume_readback_mismatch: 'Resume readback did not confirm all requested fields.',
     example_label: '\nExamples:',
     fields_file_not_found: '  ❌ Fields definition file not found: ',
     fields_format_invalid: 'Invalid fields definition format',

package/lib/core/locales/zh.js

@@ -410,9 +410,9 @@ openyida - 宜搭命令行工具
     create_opt_spec: '  --spec <file.json>            使用结构化编排文件创建复杂自动化（dataUpdate/route 等）',
     create_opt_data_form_uuid: '  --data-form-uuid <uuid>     插入获取单条数据节点的目标表单 UUID',
     create_opt_data_condition: '  --data-condition <rule>     获取数据过滤条件：目标字段:字段名:触发字段[:组件[:操作符[:值类型]]]',
-    create_opt_get_self: '  --get-self                    自动插入获取自身节点（pid 等于触发事件表单实例ID）',
+    create_opt_get_self: '  --get-self                    自动插入获取自身节点（流程表单运行态使用 pid、设计器使用 proc_inst_id；普通表单两侧使用 form_inst_id）',
     create_opt_get_self_field: '  --get-self-field <field>     覆盖右侧触发事件系统字段，默认 __masterdata_form_inst_id',
-    create_opt_get_self_query_field: '  --get-self-query-field <f>  覆盖左侧查询系统字段，默认 pid',
+    create_opt_get_self_query_field: '  --get-self-query-field <f>  覆盖左侧查询系统字段（流程表单默认 pid，普通表单默认 form_inst_id）',
     create_opt_add_data_form_uuid: '  --add-data-form-uuid <uuid> 插入新增数据节点的目标表单 UUID',
     create_opt_add_data_assignment: '  --add-data-assignment <rule> 新增数据赋值：目标字段:valueType:value',
     create_opt_initiate_approval_form_uuid: '  --initiate-approval-form-uuid <uuid> 发起审批节点的目标流程表单 UUID',
@@ -428,6 +428,11 @@ openyida - 宜搭命令行工具
     create_example2: '  openyida integration create APP_XXX FORM-XXX "获取自身后通知" --get-self --publish',
     create_missing_args: '缺少必要参数。',
     create_replace_required: '使用 --process-code 会整图替换已有逻辑流；必须显式传入 --replace。安全二次编辑当前不可用，integration update 仅报告 capability 状态。',
+    create_source_form_fetch_failed: '获取取数来源表单信息失败，已停止远端写入: {0}',
+    create_source_form_not_found: '获取取数来源表单信息失败，导航中未找到表单 {0}，已停止远端写入',
+    create_source_form_type_unknown: '获取取数来源表单信息失败，导航未返回可确认的表单类型，已停止远端写入',
+    create_source_form_type_invalid: '获取取数来源表单信息失败，导航返回的表单类型“{0}”不是可取数表单，已停止远端写入',
+    create_source_form_type_mismatch: '获取取数来源表单信息失败，显式 formType={0} 与导航元数据 {1} 不一致，已停止远端写入',
     create_flow_name_too_long: '逻辑流名称不能超过 {0} 个字符（当前 {1} 个）。',
     create_invalid_events: '未识别到有效触发事件。',
     create_no_receivers: '未指定通知接收人或成员字段，将不会生成消息通知节点。',
@@ -445,7 +450,7 @@ openyida - 宜搭命令行工具
     create_notify_content: '通知内容: {0}',
     create_data_form: '获取数据表单: {0}',
     create_data_conditions: '获取数据条件数: {0}',
-    create_get_self_summary: '获取自身闭坑: {0} 等于 字段 {1}',
+    create_get_self_summary: '获取自身闭坑: 运行态查询字段 {0} 等于字段 {1}；流程表单设计器对应 proc_inst_id，普通表单设计器保持一致',
     create_op_mode_publish: '操作模式: 保存并发布',
     create_op_mode_draft: '操作模式: 仅保存草稿',
     create_step: '[{0}/{1}] {2}',
@@ -793,7 +798,15 @@ openyida - 宜搭命令行工具
     example_update: '示例：openyida create-form update "APP_XXX" "FORM-YYY" \'[{"action":"add","field":{"type":"TextField","label":"备注"}}]\'',
     usage_label: '用法:',
     usage_create_short: '  创建: openyida create-form create <appType> <formTitle> <fieldsJsonFile>',
-    usage_update_short: '  更新: openyida create-form update <appType> <formUuid> <changesJsonOrFile>',
+    usage_update_short: '  更新: openyida create-form update <appType> <formUuid> <changesJsonOrFile> 或 --data-file <changesJsonOrFile>',
+    resume_readback_failed: '恢复前无法回读目标表单。',
+    resume_ownership_unverified: '目标表单不属于指定应用，已停止恢复。',
+    resume_identity_mismatch: '目标表单身份与回读结果不一致，已停止恢复。',
+    resume_schema_invalid: '目标表单 Schema 不可用。',
+    resume_container_invalid: '目标表单容器不可用。',
+    resume_field_conflict: '已有字段与请求定义冲突，恢复已停止。',
+    resume_field_resolution_failed: '恢复字段解析失败。',
+    resume_readback_mismatch: '恢复后的回读未确认全部请求字段。',
     example_label: '\n示例:',
     fields_file_not_found: '  ❌ 字段定义文件不存在: ',
     fields_format_invalid: '字段定义格式不正确',