openyida 2026.9.14 → 2026.9.16

package/README.md

@@ -396,11 +396,12 @@ 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 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 design-plan patch <build-plan.json> --set <path=value> [--set <path=value> ...] [--materialize] [--output-dir <dir>] [--json]` | Patch a design plan; asset progress preserves existing approval |
+| `openyida update-app <appType> [--name "..."] [--desc "..."] [--icon <name>] [--icon-color <color>] [--colour <key>] [--theme-color <color>] [--theme-file <css>] [--nav-theme light\|dark\|white\|gray] [--logo-source appIcon\|customImage] [--layout side\|top\|l_shape] [--hide-app-nav\|--show-app-nav]` | Update app info |
 | `openyida app-online <appType> [--to-ding-app-center] [--show-app-center]` | Enable a Yida app |
 | `openyida app-offline <appType> [--to-ding-app-center] [--show-app-center]` | Disable a Yida app |
 | `openyida nav-group <list\|create\|rename\|delete\|move\|order\|auto-order\|hide\|show> <appType> ...` | Manage app sidebar navigation groups |
@@ -649,10 +650,14 @@ npx clawhub@latest install nicky1108/yida-app
 ```bash
 git clone https://github.com/openyida/openyida.git
 cd openyida
-npm install
+nvm install
+nvm use
+npm ci --ignore-scripts
 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/lib/app/canvas-compile.js

@@ -50,6 +50,7 @@ const {
 } = require('./form-detail-link-guard');
 const { t } = require('../core/i18n');
 const { assertInlineCssStructure } = require('./inline-css-guard');
+const { assertCanvasThemeStructure } = require('./canvas-theme-guard');
 
 /**
  * 依赖 → window 别名白名单，用于把 import 改写到运行时全局对象。
@@ -967,6 +968,7 @@ function compileCanvasLocal(source, options = {}) {
   assertNoBareDependencyGlobals(source, options);
   assertNoManualDependencyGlobals(source, options);
   assertInlineCssStructure(source, options);
+  assertCanvasThemeStructure(source, options);
 
   const importedModules = extractImportedModules(source);
 

package/lib/app/canvas-theme-guard.js

@@ -0,0 +1,117 @@
+'use strict';
+
+const Babel = require('@babel/standalone');
+const { CliError } = require('../core/cli-error');
+const { t } = require('../core/i18n');
+
+// Check the maintained theme contract without executing business code.
+// Dynamic component factories and runtime branches still need browser verification.
+function assertCanvasThemeStructure(source, options = {}) {
+  if (!/CanvasThemeProvider|useCanvasThemeContext|CanvasThemeContext/.test(source)) { return; }
+  let ast;
+  try {
+    ast = Babel.packages.parser.parse(source, { sourceType: 'module', plugins: ['jsx', 'typescript'] });
+  } catch { return; } // Let the compiler report syntax errors.
+  const traverse = Babel.packages.traverse.default || Babel.packages.traverse;
+  const functions = new Map();
+  let program;
+  let defaultExport;
+  const fail = (kind, node) => {
+    const line = node?.loc?.start.line || 1;
+    throw new CliError(t(`publish.canvas_theme_${kind}`, line), {
+      code: 'OPENYIDA_CANVAS_THEME_PROVIDER_INVALID',
+      details: { stage: 'canvas_compile', sourcePath: options.sourcePath || '', line, issueType: kind },
+    });
+  };
+
+  traverse(ast, {
+    Program(p) { program = p; },
+    ExportDefaultDeclaration(p) { defaultExport = p.get('declaration'); },
+    Function(p) {
+      const name = p.node.id?.name || (p.parentPath.isVariableDeclarator() ? p.parentPath.node.id.name : '');
+      functions.set(p.node, { name, calls: [], renders: [], hooks: [] });
+    },
+    VariableDeclarator(p) {
+      if (p.node.id.name === 'CanvasThemeContext' && p.getFunctionParent()) {
+        fail('context_scope', p.node);
+      }
+    },
+  });
+
+  function resolveFunction(p, seen = new Set()) {
+    if (!p?.node || seen.has(p.node)) { return null; }
+    seen.add(p.node);
+    if (p.isFunction()) { return p.node; }
+    if (p.isVariableDeclarator()) { return resolveFunction(p.get('init'), seen); }
+    if (p.isIdentifier() || p.isJSXIdentifier()) {
+      return resolveFunction(p.scope.getBinding(p.node.name)?.path, seen);
+    }
+    // React.memo/forwardRef retain the wrapped component's theme requirements.
+    if (p.isCallExpression()) {
+      const callee = p.node.callee;
+      const name = callee.type === 'Identifier' ? callee.name : callee.property?.name;
+      if (['memo', 'forwardRef'].includes(name)) { return resolveFunction(p.get('arguments.0'), seen); }
+    }
+    return null;
+  }
+
+  traverse(ast, {
+    CallExpression(p) {
+      const owner = functions.get(p.getFunctionParent()?.node);
+      const target = resolveFunction(p.get('callee'));
+      const targetName = functions.get(target)?.name || p.node.callee.name;
+      if (targetName === 'useCanvasThemeContext') {
+        if (!owner) { fail('root_hook', p.node); }
+        owner.hooks.push(p.node);
+      }
+      if (!owner) { return; }
+      if (target) { owner.calls.push(target); }
+      const callee = p.node.callee;
+      if (callee.type === 'MemberExpression' && callee.object.name === 'React' && callee.property.name === 'createElement') {
+        const component = resolveFunction(p.get('arguments.0'));
+        if (component) { owner.renders.push(component); }
+      }
+    },
+    JSXOpeningElement(p) {
+      const owner = functions.get(p.getFunctionParent()?.node);
+      const component = resolveFunction(p.get('name'));
+      if (owner && component) { owner.renders.push(component); }
+    },
+  });
+
+  const entry = resolveFunction(program.scope.getBinding('YidaComp')?.path) || resolveFunction(defaultExport);
+  if (!entry) { return; }
+
+  // Calling a hook before returning a Provider cannot read that Provider.
+  const directSeen = new Set();
+  function checkEntryCalls(node) {
+    if (directSeen.has(node)) { return; }
+    directSeen.add(node);
+    const info = functions.get(node);
+    if (info.hooks.length) { fail('root_hook', info.hooks[0]); }
+    info.calls.forEach(checkEntryCalls);
+  }
+  checkEntryCalls(entry);
+
+  const seen = new Set();
+  let providerMounted = false;
+  let firstHook;
+  function visit(node) {
+    if (seen.has(node)) { return; }
+    seen.add(node);
+    const info = functions.get(node);
+    firstHook = firstHook || info.hooks[0];
+    info.renders.forEach(child => {
+      if (functions.get(child).name === 'CanvasThemeProvider') { providerMounted = true; }
+      visit(child);
+    });
+    info.calls.forEach(visit);
+  }
+  visit(entry);
+  const hasProvider = [...functions.values()].some(info => info.name === 'CanvasThemeProvider');
+  if (!providerMounted && (hasProvider || firstHook)) {
+    fail('provider_missing', firstHook || entry);
+  }
+}
+
+module.exports = { assertCanvasThemeStructure };

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

@@ -225,6 +225,25 @@ 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'], {
@@ -317,13 +336,15 @@ 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'); }
-    await call(['login', '--check-only', '--json']);
+    const loginStatus = await call(['login', '--check-only', '--json']);
+    const baseUrl = loginStatus?.base_url || loginStatus?.baseUrl || '';
     // 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];
@@ -336,6 +357,7 @@ 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'];
@@ -344,6 +366,12 @@ async function run(args, dependencies = {}) {
           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')) {
@@ -357,25 +385,43 @@ async function run(args, dependencies = {}) {
       save(state);
       let resumed = false;
       if (shouldResume) {
-        await call(['create-form', 'resume', options.appType, formUuid, JSON.stringify(resolvedFields), '--json']);
+        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 } : {}),
+        };
         resumed = true;
       }
       let schema = await call(['get-schema', options.appType, formUuid, '--field-map-json']);
       if (!readbackMatchesExpectedFields(schema, resolvedFields) && !resumed && !form.formUuid) {
-        await call(['create-form', 'resume', options.appType, formUuid, JSON.stringify(resolvedFields), '--json']);
+        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 } : {}),
+        };
         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 };
+      return { formUuid, fields: schema.fields, ...delivery };
     }, () => save(state));
     const success = Object.values(state.results).every(item => item.status === 'success');
-    const output = { success, groups, stateFile, results: state.results };
+    const output = {
+      success,
+      groups,
+      stateFile,
+      results: state.results,
+      ...((baseUrl && options.appType) ? { appUrl: `${String(baseUrl).replace(/\/+$/, '')}/${options.appType}/workbench` } : {}),
+    };
     if (!success) {
       output.errorCode = 'FORM_BATCH_PARTIAL_FAILURE';
-      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.';
+      Object.assign(output, buildPartialFailureRecovery(state.results));
     }
     console.log(JSON.stringify(output));
     if (!output.success) { process.exitCode = 1; }
@@ -397,5 +443,7 @@ module.exports = {
   execute,
   expectedReadbackFields,
   readbackMatchesExpectedFields,
+  buildPartialFailureRecovery,
+  buildDeliveryUrls,
   validateStaticDefinition,
 };

package/lib/app/create-form.js

@@ -1719,7 +1719,7 @@ function buildFormSchema(formTitle, fields, formUuid, corpId, appType, layout, t
       id: nextNodeId(),
       props: {
         contentBgColor: 'white',
-        pageStyle: { backgroundColor: '#f2f3f5' },
+        pageStyle: { backgroundColor: 'transparent' },
         contentMargin: '20',
         contentPadding: '20',
         showTitle: false,
@@ -1742,7 +1742,7 @@ function buildFormSchema(formTitle, fields, formUuid, corpId, appType, layout, t
         labelWeightMobile: 'normal',
       },
       condition: true,
-      css: 'body{background-color:#f2f3f5}',
+      css: 'body{background-color:transparent}',
       methods: {
         __initMethods__: {
           type: 'js',
@@ -1941,7 +1941,7 @@ function buildEmptyFormSchema() {
           id: nextNodeId(),
           props: {
             contentBgColor: 'white',
-            pageStyle: { backgroundColor: '#f2f3f5' },
+            pageStyle: { backgroundColor: 'transparent' },
             contentMargin: '20',
             contentPadding: '20',
             showTitle: false,
@@ -1952,7 +1952,7 @@ function buildEmptyFormSchema() {
             contentBgColorMobile: 'white',
           },
           condition: true,
-          css: 'body{background-color:#f2f3f5}',
+          css: 'body{background-color:transparent}',
           methods: {
             __initMethods__: {
               type: 'js',
@@ -4858,7 +4858,10 @@ async function saveFormSchema(authRef, appType, formUuid, schema, version, stepO
       formUuid,
       result: sanitizeFailureResult(saveResult),
     });
-    if (failureContext) {
+    if (failureContext && failureContext.deferFailureOutput) {
+      // Resume may safely resolve an HTTP 5xx by exact readback. Defer the
+      // failure payload so a recovered command emits one authoritative result.
+    } else if (failureContext) {
       emitCreateFormPostCreateFailure(Object.assign({}, failureContext, {
         stage: 'saveFormSchema',
         error: saveError,
@@ -4879,6 +4882,13 @@ async function saveFormSchema(authRef, appType, formUuid, schema, version, stepO
 
 // ── create 模式主流程 ─────────────────────────────────
 
+function buildFormDeliveryUrls(baseUrl, appType, formUuid) {
+  return {
+    appUrl: baseUrl + '/' + appType + '/workbench',
+    formUrl: baseUrl + '/' + appType + '/workbench/' + formUuid,
+  };
+}
+
 async function mainValidateFields(parsedArgs) {
   const { fieldsJsonOrFile } = parsedArgs;
   assertNoEmojiInDefinitionFileName(fieldsJsonOrFile);
@@ -5034,13 +5044,13 @@ async function mainCreate(parsedArgs, authRef) {
   }
 
   // 输出结果
-  const formUrl = authRef.baseUrl + '/' + appType + '/workbench/' + formUuid;
+  const { appUrl, formUrl } = buildFormDeliveryUrls(authRef.baseUrl, appType, formUuid);
   result(true, t('create_form.create_success'), [
     ['Form UUID', formUuid],
     ['URL', formUrl],
   ]);
   console.log(JSON.stringify(withBrowserHandoff(
-    { success: true, formUuid, formTitle, appType, fieldCount, icon: formIcon, iconSource: iconResolution.source, url: formUrl },
+    { success: true, formUuid, formTitle, appType, fieldCount, icon: formIcon, iconSource: iconResolution.source, url: formUrl, formUrl, appUrl },
     formUrl,
     { stage: 'create_form_success', title: formTitle },
     parsedArgs.browserOpenMode
@@ -5127,6 +5137,7 @@ async function createFormForLegacyProcessQuiet(context, input) {
   }
   const saveResult = await saveFormSchema(authRef, appType, formUuid, schema, serverRevision, 4);
   const navIconResult = await updateCreatedFormNavigationIcon(authRef, appType, formUuid, formIcon);
+  const { appUrl, formUrl } = buildFormDeliveryUrls(authRef.baseUrl, appType, formUuid);
   return {
     success: true,
     appType,
@@ -5138,7 +5149,9 @@ async function createFormForLegacyProcessQuiet(context, input) {
     navIconResult,
     icon: formIcon,
     iconSource: iconResolution.source,
-    url: authRef.baseUrl + '/' + appType + '/workbench/' + formUuid,
+    url: formUrl,
+    formUrl,
+    appUrl,
   };
 }
 
@@ -5319,7 +5332,7 @@ async function mainAddOption(parsedArgs, authRef) {
   // Step 4: 保存 Schema
   await saveFormSchema(authRef, appType, formUuid, schema, version, 4);
 
-  const formUrl = authRef.baseUrl + '/' + appType + '/workbench/' + formUuid;
+  const { appUrl, formUrl } = buildFormDeliveryUrls(authRef.baseUrl, appType, formUuid);
   result(true, '选项追加成功', [
     ['Form UUID', formUuid],
     ['Field', fieldLabel],
@@ -5339,6 +5352,8 @@ async function mainAddOption(parsedArgs, authRef) {
     skipped: skippedOptions,
     totalOptions: existingDataSource.length,
     url: formUrl,
+    formUrl,
+    appUrl,
   }));
 }
 
@@ -5438,7 +5453,7 @@ async function mainBindDataSource(parsedArgs, authRef) {
 
   await saveFormSchema(authRef, appType, formUuid, schema, version, 4);
 
-  const formUrl = authRef.baseUrl + '/' + appType + '/workbench/' + formUuid;
+  const { appUrl, formUrl } = buildFormDeliveryUrls(authRef.baseUrl, appType, formUuid);
   result(true, '字段数据源保存成功', [
     ['Form UUID', formUuid],
     ['Field', fieldLabel],
@@ -5459,6 +5474,8 @@ async function mainBindDataSource(parsedArgs, authRef) {
       options: normalized.options.length,
       filterLocal: targetComponent.props.filterLocal,
       pageUrl: formUrl,
+      formUrl,
+      appUrl,
     },
     formUrl,
     { stage: 'bind_datasource_success', title: formUuid },
@@ -6109,6 +6126,59 @@ async function readResumeSchema(authRef, appType, formUuid) {
   return { schemaResult, schema, version: extractSchemaServerRevision(schemaResult) };
 }
 
+function isRetryableResumeSaveServerFailure(errorObject) {
+  const status = Number(errorObject?.details?.result?.__httpStatus);
+  return errorObject?.code === 'CREATE_FORM_SAVE_SCHEMA_FAILED' &&
+    Number.isInteger(status) && status >= 500 && status <= 599;
+}
+
+async function saveResumeSchemaWithSafeRetry(authRef, appType, formUuid, schema, version, fields) {
+  const save = (value, revision) => saveFormSchema(
+    authRef, appType, formUuid, value, revision, 4, { deferFailureOutput: true }
+  );
+  try {
+    await save(schema, version);
+    return '';
+  } catch (originalError) {
+    if (!isRetryableResumeSaveServerFailure(originalError)) { throw originalError; }
+
+    let readback;
+    try { readback = await readResumeSchema(authRef, appType, formUuid); } catch (_) { throw originalError; }
+    const root = readback.schema.pages[0].componentsTree && readback.schema.pages[0].componentsTree[0];
+    const container = root ? findFormContainer(root) : null;
+    if (!container) { throw originalError; }
+    const evidence = collectResumeFieldEvidence(container.children);
+    const verified = buildResumeChanges(
+      evidence,
+      collectResumeDesiredFields(fields, { verifyNestedFields: true })
+    );
+    if (verified.conflicts.length > 0) { throw originalError; }
+    if (verified.missing.length === 0) { return 'save_schema_recovered_by_readback'; }
+    const retryPlan = buildResumeChanges(evidence, collectResumeDesiredFields(fields));
+    if (retryPlan.conflicts.length > 0 || retryPlan.missing.length === 0) { throw originalError; }
+    const applied = applyChangesToSchema(
+      readback.schema,
+      retryPlan.missing.map(function (field) { return { action: 'add', field }; }),
+      { verbose: true }
+    );
+    if ((applied.diagnostics || []).length > 0) { throw originalError; }
+    const updatedContainer = findFormContainer(readback.schema.pages[0].componentsTree[0]);
+    fillSerialNumberFormulas(updatedContainer.children, resolveCorpId(authRef.authData), appType, formUuid);
+
+    try {
+      await save(readback.schema, readback.version);
+    } catch (retryError) {
+      originalError.details = Object.assign({}, originalError.details, {
+        safeRetryAttempted: true,
+        retryErrorCode: retryError?.code || 'CREATE_FORM_SAVE_SCHEMA_FAILED',
+        retryResult: sanitizeFailureResult(retryError?.details?.result),
+      });
+      throw originalError;
+    }
+    return 'save_schema_retried';
+  }
+}
+
 async function mainResume(parsedArgs, authRef) {
   const { appType, formUuid, fieldsJsonOrFile } = parsedArgs;
   assertNoEmojiInDefinitionFileName(fieldsJsonOrFile);
@@ -6139,8 +6209,11 @@ async function mainResume(parsedArgs, authRef) {
     if (resumeValidationRules.length > 0) {
       applySmartValidations(firstRead.schema, resumeValidationRules);
     }
-    await saveFormSchema(authRef, appType, formUuid, firstRead.schema, firstRead.version, 4);
+    const saveRecoveryStage = await saveResumeSchemaWithSafeRetry(
+      authRef, appType, formUuid, firstRead.schema, firstRead.version, fields
+    );
     completedStages.push('rebuild_blank_schema', 'save_schema');
+    if (saveRecoveryStage) { completedStages.push(saveRecoveryStage); }
     recoveredBlankShell = true;
     plan = {
       existing: [],
@@ -6189,8 +6262,11 @@ async function mainResume(parsedArgs, authRef) {
     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);
+    const saveRecoveryStage = await saveResumeSchemaWithSafeRetry(
+      authRef, appType, formUuid, firstRead.schema, firstRead.version, fields
+    );
     completedStages.push('add_missing_fields', 'save_schema');
+    if (saveRecoveryStage) { completedStages.push(saveRecoveryStage); }
   }
 
   const finalRead = await readResumeSchema(authRef, appType, formUuid);
@@ -6211,7 +6287,7 @@ async function mainResume(parsedArgs, authRef) {
     });
   }
   completedStages.push('verify_final_schema');
-  const formUrl = authRef.baseUrl + '/' + appType + '/workbench/' + formUuid;
+  const { appUrl, formUrl } = buildFormDeliveryUrls(authRef.baseUrl, appType, formUuid);
   const output = {
     success: true,
     appType,
@@ -6223,6 +6299,8 @@ async function mainResume(parsedArgs, authRef) {
     finalFieldCount: collectResumeFieldEvidence(finalContainer.children).length,
     recoveredBlankShell,
     url: formUrl,
+    formUrl,
+    appUrl,
   };
   console.log(JSON.stringify(withBrowserHandoff(
     output,
@@ -6384,14 +6462,14 @@ async function mainUpdate(parsedArgs, authRef) {
   await saveFormSchema(authRef, appType, formUuid, schema, version, 6);
 
   // 输出结果
-  const formUrl = authRef.baseUrl + '/' + appType + '/workbench/' + formUuid;
+  const { appUrl, formUrl } = buildFormDeliveryUrls(authRef.baseUrl, appType, formUuid);
   result(true, t('create_form.update_success'), [
     ['Form UUID', formUuid],
     ['URL', formUrl],
     ['Changes', String(appliedChanges.length)],
   ]);
   console.log(JSON.stringify(withBrowserHandoff(
-    { success: true, formUuid, appType, changesApplied: appliedChanges.length, changes: appliedChanges, url: formUrl },
+    { success: true, formUuid, appType, changesApplied: appliedChanges.length, changes: appliedChanges, url: formUrl, formUrl, appUrl },
     formUrl,
     { stage: 'update_form_success', title: formUuid },
     parsedArgs.browserOpenMode

package/lib/app/services/form-compiler.js

@@ -1615,7 +1615,7 @@ function buildFormSchema(formTitle, fields, formUuid, corpId, appType, layout, t
       id: nextNodeId(),
       props: {
         contentBgColor: 'white',
-        pageStyle: { backgroundColor: '#f2f3f5' },
+        pageStyle: { backgroundColor: 'transparent' },
         contentMargin: '20',
         contentPadding: '20',
         showTitle: false,
@@ -1638,7 +1638,7 @@ function buildFormSchema(formTitle, fields, formUuid, corpId, appType, layout, t
         labelWeightMobile: 'normal',
       },
       condition: true,
-      css: 'body{background-color:#f2f3f5}',
+      css: 'body{background-color:transparent}',
       methods: {
         __initMethods__: {
           type: 'js',
@@ -1833,7 +1833,7 @@ function buildEmptyFormSchema() {
           id: nextNodeId(),
           props: {
             contentBgColor: 'white',
-            pageStyle: { backgroundColor: '#f2f3f5' },
+            pageStyle: { backgroundColor: 'transparent' },
             contentMargin: '20',
             contentPadding: '20',
             showTitle: false,
@@ -1844,7 +1844,7 @@ function buildEmptyFormSchema() {
             contentBgColorMobile: 'white',
           },
           condition: true,
-          css: 'body{background-color:#f2f3f5}',
+          css: 'body{background-color:transparent}',
           methods: {
             __initMethods__: {
               type: 'js',

package/lib/app/theme-from-design.js

@@ -76,9 +76,15 @@ function applyDesignTokens(template, markdown, previousMarkdown) {
   let body = root[1].replace(declarations, (line, name, value) => line.replace(value, () => changed[name] || replaceBrand(value)));
   const extra = Object.entries(changed).filter(([name]) => !(name in original));
   body += extra.map(([name, value]) => `  ${name}: ${value};\n`).join('');
-  // Keep scoped nav/light/dark selectors and their variable relationships intact.
-  const tail = template.slice(root.index + root[0].length).replace(declarations,
+  let tail = template.slice(root.index + root[0].length).replace(declarations,
     (line, name, value) => line.replace(value, () => replaceBrand(value)));
+  // Platform navigation modes bind independently; the root shell remains the custom-page default.
+  if (changed['--pod-shell-theme-bg-color']) {
+    tail = tail.replace(/(\.pod-premium\.nav-(light|dark)\s*\{)([^}]*)(\})/g,
+      (block, selector, tone, body, close) => selector + body.replace(declarations,
+        (line, name, value) => ['--pod-shell-theme-bg-color', '--pod-page-header-bg-color'].includes(name)
+          ? line.replace(value, `var(--color-brand1-${tone === 'dark' ? 5 : 3})`) : line) + close);
+  }
   const css = `${template.slice(0, root.index)}:root {${body}}${tail}`;
   validateThemeCssContent(css);
   extractThemeColor(css);

package/lib/app/theme-presets.js

@@ -122,7 +122,7 @@ function assertPresetThemeKey(themeKey) {
   throw new Error(
     `Unsupported theme: ${themeKey}. Use one of: ${formatPresetThemeKeys()}. ` +
     'For custom colors or application theme token profiles that are not platform --theme keys, ' +
-    'upload an application theme CSS file with update-app --theme-file and pass --theme-color instead.'
+    'upload an application theme CSS file with update-app --theme-file.'
   );
 }
 

package/lib/asset/ai-image.js

@@ -73,18 +73,52 @@ function getFreeStockLibraries() {
 function getMaterialSourcingGuidance() {
   return {
     steps: [
-      '1. 先用用户提供的素材。',
-      '2. 再从 Unsplash / Pexels 搜图。',
-      '3. 仍有缺口时使用宿主生图。',
-      '4. 最后使用中性占位并保持 draft。',
-      '5. 所有候选图通过 asset resolve 写入 manifest。',
+      '1. Plan 确认后、Fast 设计就绪后启动素材任务，同时推进应用、表单和无图页面；先复用用户图片和已完成位置。',
+      '2. 同一页面的图片位置也并发搜索，最多同时四个；每个位置选一张来源完整的图片并查看。',
+      '3. 第二轮只补第一轮失败的必需位置，换一张图片或使用设计允许的生成图。',
+      '4. 两轮结束后，可选位置采用设计允许的无图布局，必需位置保留缺口；已就绪页面直接继续。',
+      '5. 每页使用 asset resolve --page-id 并发下载上传，写入独立清单并交接该页。',
     ],
+    schedulingPolicy: {
+      owner: 'host_agent',
+      searchConcurrency: 4,
+      concurrencyScope: 'collection_run',
+      searchUnit: 'slot',
+      resumePolicy: 'reuse_final_slots_and_remaining_round_budget',
+      runAlongside: ['app_creation', 'form_creation', 'pages_without_images'],
+      waitAt: 'own_page_image_binding_and_acceptance',
+      resultWriter: 'one_per_page',
+    },
+    collectionPolicy: {
+      maxRoundsPerPage: 2,
+      imagesPerSlot: 1,
+      candidatesPerSlotPerRound: 1,
+      secondRound: 'failed_required_slots_only',
+      concurrency: 'independent_pages_and_assets',
+      roundOwner: 'host_agent',
+      pageSelector: '--page-id',
+    },
+    completionPolicy: {
+      resultSource: 'asset-manifests/<pageId>.json',
+      planApproval: 'reuse_existing_approval',
+      progressFields: ['visualStyle.forUser.assetStrategy.materialStatus', 'visualStyle.forUser.assetStrategy.missingAssets'],
+      nextStep: 'continue_ready_pages',
+    },
+    failurePolicy: {
+      attemptsPerCandidate: 1,
+      sourceUnavailable: 'switch_source_for_remaining_slots',
+      candidateFailed: 'replace_input',
+      exhausted: 'planned_optional_layout_or_required_gap',
+      retryCondition: 'within_two_rounds_or_explicit_request',
+    },
     libraries: getFreeStockLibraries(),
     rules: [
       '不编造图片 URL；按 manifest 的页面状态继续，只使用当前页 materialStatus=final 的图片。',
       '默认下载并上传宜搭图片附件；超过 20 MiB 保留原链接；不额外探测 URL，下载失败跳过并记录缺口。',
       '联网搜图仅使用 Unsplash / Pexels。',
-      '来源不明时使用中性占位或宿主生成图。',
+      '401、403、429、反爬挑战或超时后，将该来源标记为本次采集不可用，其他页面和后续轮次使用其他来源。',
+      '每页最多两轮；每个位置每轮选一张，同一候选尝试一次，成功即结束。第二轮只补失败的必需位置；换来源、换工具或恢复上传仍计入本轮预算。',
+      '来源信息获取失败时换用信息齐全的候选；真实房源、商品和人员保持真实素材要求。',
     ],
   };
 }