openyida 2026.9.2 → 2026.9.3

package/lib/app/create-form.js

@@ -82,6 +82,12 @@ const { createParseArgs } = require('./create-form/args');
 const { createDefinitionReaders } = require('./create-form/definition-reader');
 const { dispatchCreateFormCommand } = require('./create-form/commands');
 const { buildApiPath } = require('./create-form/api-path');
+const {
+  FORM_NAV_ICON_GROUPS,
+  FORM_NAV_ICONS,
+  resolveFormNavIcon,
+} = require('./create-form/nav-icon');
+const { createFormNavIconService } = require('./create-form/nav-icon-service');
 const { deepMerge, splitJsonPointer } = require('./create-form/schema-patch');
 const {
   actionRefName,
@@ -4647,11 +4653,13 @@ function applyChangesToSchema(schema, changes, options) {
 
 // ── 发送 POST 请求（支持 302 自动重登录） ────────────
 
-function sendPostRequest(baseUrl, requestPath, extraParams, formUuid, authRef) {
+function sendPostRequest(baseUrl, requestPath, extraParams, formUuid, authRef, requestOptions) {
+  requestOptions = requestOptions || {};
   const authParams = authRef && authRef.csrfToken ? { _csrf_token: authRef.csrfToken } : {};
   const postData = querystring.stringify(Object.assign(authParams, extraParams));
+  const refererAppType = requestOptions.appType || extraParams.appType || '';
   const referer = formUuid
-    ? `${baseUrl}/alibaba/web/${extraParams.appType || ''}/design/pageDesigner?formUuid=${formUuid}`
+    ? requestOptions.referer || `${baseUrl}/alibaba/web/${refererAppType}/design/pageDesigner?formUuid=${formUuid}`
     : baseUrl + '/';
   return httpPost(baseUrl, requestPath, postData, { referer });
 }
@@ -4678,6 +4686,19 @@ function sendCreateFormRequest(authRef, appType, formTitle) {
   );
 }
 
+const {
+  resolveFormNavigationNode,
+  updateCreatedFormNavigationIcon,
+} = createFormNavIconService({
+  buildApiPath,
+  requestWithAutoLogin,
+  sendGetRequest,
+  sendPostRequest,
+  throwCreateFormError,
+  sanitizeFailureResult,
+  candidateLimit: FIELD_RESOLUTION_CANDIDATE_LIMIT,
+});
+
 // ── 登录态辅助：从 authData 中提取 corpId ──────────
 
 function resolveCorpId(authData) {
@@ -4853,6 +4874,25 @@ async function mainValidateFields(parsedArgs) {
   return output;
 }
 
+async function mainListIcons(parsedArgs) {
+  const output = {
+    success: true,
+    count: FORM_NAV_ICONS.length,
+    default: 'auto',
+    groups: FORM_NAV_ICON_GROUPS.map(function (group) {
+      return {
+        key: group.key,
+        label: group.label,
+        icons: group.items.map(function (item) {
+          return { name: item[0], label: item[1] };
+        }),
+      };
+    }),
+  };
+  console.log(JSON.stringify(output, null, parsedArgs.json ? 2 : 0));
+  return output;
+}
+
 async function mainCreate(parsedArgs, authRef) {
   const { appType, formTitle, fieldsJsonOrFile, layout, theme, labelAlign } = parsedArgs;
 
@@ -4866,9 +4906,22 @@ async function mainCreate(parsedArgs, authRef) {
   const { fields, columns, validations } = readFieldsDefinition(fieldsJsonOrFile);
   assertNoEmojiInFormDefinition(formTitle, fields, validations);
   validateFormFieldDefinitions(fields);
+  const iconResolution = resolveFormNavIcon(parsedArgs.icon, formTitle, fields);
+  if (!iconResolution.icon) {
+    throwCreateFormError(
+      `Unsupported form navigation icon: ${parsedArgs.icon}. Run openyida create-form icons --json for the supported catalog.`,
+      'CREATE_FORM_NAV_ICON_INVALID',
+      {
+        icon: parsedArgs.icon,
+        availableIconCount: FORM_NAV_ICONS.length,
+      }
+    );
+  }
+  const formIcon = iconResolution.icon;
   const fieldCount = countDataFieldDefinitions(fields);
   success(t('create_form.fields_loaded', fieldCount));
   label('Columns:', String(columns));
+  label('Icon:', `${formIcon} (${iconResolution.source})`);
   fields.forEach(function (field, index) {
     listItem((index + 1) + '. ' + normalizeFormDefinitionType(field) + ': ' + getDefinitionDisplayName(field));
   });
@@ -4935,6 +4988,8 @@ async function mainCreate(parsedArgs, authRef) {
       formUuid,
       fieldCount,
     });
+    postCreateStage = 'updateFormNavigationIcon';
+    await updateCreatedFormNavigationIcon(authRef, appType, formUuid, formIcon);
   } catch (err) {
     emitCreateFormPostCreateFailure({
       appType,
@@ -4954,7 +5009,7 @@ async function mainCreate(parsedArgs, authRef) {
     ['URL', formUrl],
   ]);
   console.log(JSON.stringify(withBrowserHandoff(
-    { success: true, formUuid, formTitle, appType, fieldCount, url: formUrl },
+    { success: true, formUuid, formTitle, appType, fieldCount, icon: formIcon, iconSource: iconResolution.source, url: formUrl },
     formUrl,
     { stage: 'create_form_success', title: formTitle },
     parsedArgs.browserOpenMode
@@ -4991,6 +5046,7 @@ async function createFormForLegacyProcessQuiet(context, input) {
     layout: input.layout || 'single',
     theme: input.theme || 'default',
     labelAlign: input.labelAlign || 'top',
+    icon: input.icon || 'auto',
     contentLocale: input.contentLocale || null,
     browserOpenMode: 'off',
   };
@@ -5000,6 +5056,15 @@ async function createFormForLegacyProcessQuiet(context, input) {
   const { fields, validations } = readFieldsDefinition(fieldsJsonOrFile);
   assertNoEmojiInFormDefinition(formTitle, fields, validations, 'legacy create-form input');
   validateFormFieldDefinitions(fields);
+  const iconResolution = resolveFormNavIcon(parsedArgs.icon, formTitle, fields);
+  if (!iconResolution.icon) {
+    throwCreateFormError(
+      `Unsupported form navigation icon: ${parsedArgs.icon}. Run openyida create-form icons --json for the supported catalog.`,
+      'CREATE_FORM_NAV_ICON_INVALID',
+      { icon: parsedArgs.icon, availableIconCount: FORM_NAV_ICONS.length }
+    );
+  }
+  const formIcon = iconResolution.icon;
   const fieldCount = countDataFieldDefinitions(fields);
   const createResult = await sendCreateFormRequest(authRef, appType, formTitle);
 
@@ -5030,6 +5095,7 @@ async function createFormForLegacyProcessQuiet(context, input) {
     applySmartValidations(schema, createValidationRules);
   }
   const saveResult = await saveFormSchema(authRef, appType, formUuid, schema, serverRevision, 4);
+  const navIconResult = await updateCreatedFormNavigationIcon(authRef, appType, formUuid, formIcon);
   return {
     success: true,
     appType,
@@ -5038,6 +5104,9 @@ async function createFormForLegacyProcessQuiet(context, input) {
     fieldCount,
     createResult,
     saveResult,
+    navIconResult,
+    icon: formIcon,
+    iconSource: iconResolution.source,
     url: authRef.baseUrl + '/' + appType + '/workbench/' + formUuid,
   };
 }
@@ -6017,6 +6086,9 @@ async function run(args) {
   if (parsedArgs.mode === 'validate-fields') {
     return mainValidateFields(parsedArgs);
   }
+  if (parsedArgs.mode === 'icons') {
+    return mainListIcons(parsedArgs);
+  }
 
   step(1, t('common.step_login', 1));
   const authRef = createAuthRef();
@@ -6058,6 +6130,8 @@ module.exports = {
     normalizeFormDefinitionType,
     validateFormFieldDefinitions,
     collectFormFieldValidationDiagnostics,
+    resolveFormNavigationNode,
+    updateCreatedFormNavigationIcon,
     applyChangesToSchema,
     applyFormRules,
     applySchemaPatchOperations,

package/lib/app/nav-group.js

@@ -7,6 +7,7 @@ const {
   requestWithAutoLogin,
 } = require('../core/utils');
 const { createAuthRef, isAuthRefReady } = require('../core/yida-client');
+const { CliError } = require('../core/cli-error');
 const { parseYidaI18n } = require('../core/yida-i18n');
 
 const ROOT_NAV_UUID = 'NAV-SYSTEM-PARENT-UUID';
@@ -422,6 +423,92 @@ function autoOrderRootNodes(list) {
   };
 }
 
+function snapshotNavigationRoots(roots) {
+  const snapshot = [];
+
+  const visit = (nodes, parentNavUuid) => {
+    (nodes || []).forEach((node, siblingIndex) => {
+      snapshot.push({
+        navUuid: node.navUuid,
+        parentNavUuid,
+        siblingIndex,
+        navType: node.navType || '',
+      });
+      visit(node.children || [], node.navUuid);
+    });
+  };
+
+  visit(roots || [], ROOT_NAV_UUID);
+  return snapshot;
+}
+
+function buildNavigationSnapshot(list) {
+  return snapshotNavigationRoots(buildMutableForest(list).roots);
+}
+
+function navigationSnapshotsEqual(left, right) {
+  if (!Array.isArray(left) || !Array.isArray(right) || left.length !== right.length) {
+    return false;
+  }
+
+  return left.every((item, index) => {
+    const other = right[index];
+    return other &&
+      item.navUuid === other.navUuid &&
+      item.parentNavUuid === other.parentNavUuid &&
+      item.siblingIndex === other.siblingIndex &&
+      item.navType === other.navType;
+  });
+}
+
+function findFirstNavigationDifference(actual, expected) {
+  const actualItems = Array.isArray(actual) ? actual : [];
+  const expectedItems = Array.isArray(expected) ? expected : [];
+  const length = Math.max(actualItems.length, expectedItems.length);
+
+  for (let index = 0; index < length; index++) {
+    const actualItem = actualItems[index] || null;
+    const expectedItem = expectedItems[index] || null;
+    if (!actualItem || !expectedItem ||
+      actualItem.navUuid !== expectedItem.navUuid ||
+      actualItem.parentNavUuid !== expectedItem.parentNavUuid ||
+      actualItem.siblingIndex !== expectedItem.siblingIndex ||
+      actualItem.navType !== expectedItem.navType) {
+      return {
+        index,
+        actual: actualItem,
+        expected: expectedItem,
+      };
+    }
+  }
+
+  return null;
+}
+
+function summarizeNavigationOrderDiff(code, beforeOrder, expectedOrder, observedOrder) {
+  const hasObservedOrder = Array.isArray(observedOrder);
+  return {
+    beforeCount: Array.isArray(beforeOrder) ? beforeOrder.length : 0,
+    expectedCount: Array.isArray(expectedOrder) ? expectedOrder.length : 0,
+    observedCount: hasObservedOrder ? observedOrder.length : null,
+    firstPlannedChange: findFirstNavigationDifference(beforeOrder, expectedOrder),
+    ...(code === 'NAV_ORDER_READBACK_MISMATCH' && hasObservedOrder
+      ? { firstReadbackMismatch: findFirstNavigationDifference(observedOrder, expectedOrder) }
+      : {}),
+  };
+}
+
+function buildNavigationOrderPlan(list, ordered) {
+  const beforeOrder = buildNavigationSnapshot(list);
+  const expectedOrder = snapshotNavigationRoots(ordered.roots);
+  return {
+    beforeOrder,
+    expectedOrder,
+    targetNavUuids: ordered.orderedNavUuids.slice(),
+    changed: !navigationSnapshotsEqual(beforeOrder, expectedOrder),
+  };
+}
+
 function countChildren(list, navUuid) {
   return (list || []).filter((node) => node.parentNavUuid === navUuid).length;
 }
@@ -455,7 +542,7 @@ async function fetchNavigationList(appType, authRef) {
   return Array.isArray(result.content) ? result.content : [];
 }
 
-async function postNavAction(appType, action, payload, authRef) {
+async function postNavAction(appType, action, payload, authRef, options = {}) {
   const endpoints = {
     save: 'saveFormNavigation.json',
     update: 'updateFormNavigation.json',
@@ -475,21 +562,143 @@ async function postNavAction(appType, action, payload, authRef) {
     throw new Error(`Unknown nav action: ${action}`);
   }
 
-  const result = await requestWithAutoLogin((auth) => {
+  const requestFn = (auth) => {
     const path = `/dingtalk/web/${appType}/query/formnav/${endpoint}` +
       `?_api=${encodeURIComponent(apiNames[action])}` +
       '&_mock=false' +
       `&_stamp=${Date.now()}`;
     return httpPost(auth.baseUrl, path, querystring.stringify(payload));
-  }, authRef);
+  };
+  const result = options.oneShot === true
+    ? await requestFn(authRef)
+    : await requestWithAutoLogin(requestFn, authRef);
 
-  if (!result || result.success === false) {
+  if (!result || result.success === false || result.__needLogin || result.__csrfExpired) {
     throw new Error(result ? result.errorMsg || `Nav action failed: ${action}` : `Nav action failed: ${action}`);
   }
 
   return result;
 }
 
+function buildNavigationOrderSuccess(appType, action, ordered, observedList, plan, recoveredByReadback) {
+  const orderedNodes = ordered.orderedNavUuids.map((navUuid) => normalizeNavNode(
+    resolveNode(observedList, navUuid, { excludeSystem: true })
+  ));
+  return {
+    success: true,
+    appType,
+    action,
+    targetParentNavUuid: ROOT_NAV_UUID,
+    changed: plan.changed,
+    alreadyApplied: !plan.changed,
+    mutationPerformed: plan.changed,
+    readbackVerified: true,
+    recoveredByReadback: recoveredByReadback === true,
+    sideEffectState: plan.changed ? 'committed' : 'none',
+    orderedNavUuids: ordered.orderedNavUuids,
+    orderedNodes,
+    skipped: !plan.changed,
+  };
+}
+
+function buildNavigationOrderError(code, appType, action, plan, observedOrder, cause) {
+  const sideEffectState = code === 'NAV_ORDER_NOT_APPLIED' ? 'none' : 'unknown';
+  const retrySafe = code === 'NAV_ORDER_NOT_APPLIED';
+  const readbackVerified = code === 'NAV_ORDER_NOT_APPLIED';
+  const status = code === 'NAV_ORDER_NOT_APPLIED'
+    ? 'NOT_APPLIED'
+    : code === 'NAV_ORDER_READBACK_MISMATCH'
+      ? 'SEMANTIC_FAILURE'
+      : 'RESULT_UNKNOWN';
+  return new CliError(code, {
+    code,
+    details: {
+      target: {
+        type: 'navigationOrder',
+        appType,
+        action,
+        navUuids: plan.targetNavUuids,
+      },
+      changed: plan.changed,
+      ...(code === 'NAV_ORDER_NOT_APPLIED' ? { mutationPerformed: false } : {}),
+      readbackVerified,
+      retryable: retrySafe,
+      retrySafe,
+      sideEffectState,
+      status,
+      readbackAllowed: true,
+      orderDiff: summarizeNavigationOrderDiff(
+        code,
+        plan.beforeOrder,
+        plan.expectedOrder,
+        observedOrder
+      ),
+      cause: cause && cause.message ? cause.message : undefined,
+      nextStep: `openyida nav-group list ${appType} --flat`,
+    },
+  });
+}
+
+async function applyNavigationOrder(appType, action, list, ordered, authRef, dependencies = {}) {
+  const fetchList = dependencies.fetchNavigationList || fetchNavigationList;
+  const postAction = dependencies.postNavAction || postNavAction;
+  const plan = buildNavigationOrderPlan(list, ordered);
+
+  if (!plan.changed) {
+    return buildNavigationOrderSuccess(appType, action, ordered, list, plan, false);
+  }
+
+  const firstNode = resolveNode(list, ordered.orderedNavUuids[0], { excludeSystem: true });
+  let mutationError = null;
+  try {
+    await postAction(appType, 'updateOrderNew', {
+      currentId: firstNode.id,
+      parentNavUuid: ROOT_NAV_UUID,
+      navType: firstNode.navType,
+      ids: ordered.ids.join(','),
+    }, authRef, { oneShot: true });
+  } catch (error) {
+    mutationError = error;
+  }
+
+  let updatedList;
+  try {
+    updatedList = await fetchList(appType, authRef);
+  } catch (readbackError) {
+    throw buildNavigationOrderError(
+      'NAV_ORDER_RESULT_UNKNOWN',
+      appType,
+      action,
+      plan,
+      null,
+      readbackError
+    );
+  }
+
+  const observedOrder = buildNavigationSnapshot(updatedList);
+  if (navigationSnapshotsEqual(observedOrder, plan.expectedOrder)) {
+    return buildNavigationOrderSuccess(appType, action, ordered, updatedList, plan, !!mutationError);
+  }
+  if (navigationSnapshotsEqual(observedOrder, plan.beforeOrder)) {
+    throw buildNavigationOrderError(
+      'NAV_ORDER_NOT_APPLIED',
+      appType,
+      action,
+      plan,
+      observedOrder,
+      mutationError
+    );
+  }
+  throw buildNavigationOrderError(
+    'NAV_ORDER_READBACK_MISMATCH',
+    appType,
+    action,
+    plan,
+    observedOrder,
+    mutationError
+  );
+}
+
 function normalizeListOutput(list, options = {}) {
   const includeSystem = options.includeSystem === true;
   return (list || [])
@@ -647,62 +856,17 @@ async function orderRootNodes(appType, values, authRef) {
 
   const list = await fetchNavigationList(appType, authRef);
   const ordered = reorderRootNodes(list, values);
-  const firstNode = resolveNode(list, ordered.orderedNavUuids[0], { excludeSystem: true });
-
-  await postNavAction(appType, 'updateOrderNew', {
-    currentId: firstNode.id,
-    parentNavUuid: ROOT_NAV_UUID,
-    navType: firstNode.navType,
-    ids: ordered.ids.join(','),
-  }, authRef);
-
-  const updatedList = await fetchNavigationList(appType, authRef);
-  const orderedNodes = ordered.orderedNavUuids.map((navUuid) => normalizeNavNode(
-    resolveNode(updatedList, navUuid, { excludeSystem: true })
-  ));
-  return {
-    success: true,
-    appType,
-    action: 'order',
-    targetParentNavUuid: ROOT_NAV_UUID,
-    orderedNavUuids: ordered.orderedNavUuids,
-    orderedNodes,
-  };
+  return applyNavigationOrder(appType, 'order', list, ordered, authRef);
 }
 
 async function autoOrderNavigation(appType, authRef) {
   const list = await fetchNavigationList(appType, authRef);
   const ordered = autoOrderRootNodes(list);
   if (!ordered.orderedNavUuids.length) {
-    return {
-      success: true,
-      appType,
-      action: 'auto-order',
-      targetParentNavUuid: ROOT_NAV_UUID,
-      orderedNavUuids: [],
-      orderedNodes: [],
-      skipped: true,
-    };
+    const plan = buildNavigationOrderPlan(list, ordered);
+    return buildNavigationOrderSuccess(appType, 'auto-order', ordered, list, plan, false);
   }
-
-  const firstNode = resolveNode(list, ordered.orderedNavUuids[0], { excludeSystem: true });
-  await postNavAction(appType, 'updateOrderNew', {
-    currentId: firstNode.id,
-    parentNavUuid: ROOT_NAV_UUID,
-    navType: firstNode.navType,
-    ids: ordered.ids.join(','),
-  }, authRef);
-
-  const updatedList = await fetchNavigationList(appType, authRef);
-  const updatedOrdered = autoOrderRootNodes(updatedList);
-  return {
-    success: true,
-    appType,
-    action: 'auto-order',
-    targetParentNavUuid: ROOT_NAV_UUID,
-    orderedNavUuids: updatedOrdered.orderedNavUuids,
-    orderedNodes: updatedOrdered.orderedNodes,
-  };
+  return applyNavigationOrder(appType, 'auto-order', list, ordered, authRef);
 }
 
 async function setVisibility(appType, value, hidden, authRef) {
@@ -790,8 +954,11 @@ async function run(args) {
 
 module.exports = {
   ROOT_NAV_UUID,
+  applyNavigationOrder,
   autoOrderNavigation,
   autoOrderRootNodes,
+  buildNavigationOrderPlan,
+  buildNavigationSnapshot,
   buildI18nTitle,
   buildNavigationTree,
   compareNavigationNodes,
@@ -800,6 +967,7 @@ module.exports = {
   getNavigationPriority,
   moveNodeInTree,
   normalizeNavNode,
+  navigationSnapshotsEqual,
   orderRootNodes,
   parseArgs,
   reorderRootNodes,

package/lib/app/page-template-guard.js

@@ -0,0 +1,64 @@
+'use strict';
+
+const { CliError } = require('../core/cli-error');
+
+const TEMPLATE_RESIDUE_PATTERNS = [
+  {
+    pattern: /@openyida-page-template-base/,
+    residue: 'template-marker',
+  },
+  {
+    pattern: /\bSAMPLE_ROWS\b/,
+    residue: 'sample-data',
+  },
+  {
+    pattern: /\{\{(?:APP_TYPE|FORM_UUID)\}\}/,
+    residue: 'template-variable',
+  },
+];
+
+function findPageTemplateResidues(sourceCode) {
+  const source = String(sourceCode || '');
+  const lines = source.split('\n');
+  const issues = [];
+
+  TEMPLATE_RESIDUE_PATTERNS.forEach(({ pattern, residue }) => {
+    lines.forEach((line, index) => {
+      if (pattern.test(line)) {
+        issues.push({
+          line: index + 1,
+          residue,
+        });
+      }
+    });
+  });
+
+  return issues;
+}
+
+function assertPageTemplateCustomized(sourceCode, sourcePath) {
+  const issues = findPageTemplateResidues(sourceCode);
+  if (issues.length === 0) {
+    return;
+  }
+
+  throw new CliError('内置页面模板尚未完成业务化改写：请先替换示例数据、模板变量和占位文案，再发布。', {
+    code: 'OPENYIDA_PAGE_TEMPLATE_NOT_CUSTOMIZED',
+    details: {
+      sourcePath,
+      issues,
+      retryable: false,
+      retrySafe: true,
+      sideEffectState: 'none',
+      nextAction: {
+        type: 'edit_source_then_publish',
+        sourcePath,
+      },
+    },
+  });
+}
+
+module.exports = {
+  assertPageTemplateCustomized,
+  findPageTemplateResidues,
+};

package/lib/app/publish.js

@@ -28,12 +28,13 @@ const { createAuthRef, isTokenAuthRef } = require('../core/yida-client');
 const { requireSchemaServerRevision } = require('../core/server-revision');
 const { t } = require('../core/i18n');
 const { banner, step, label, success, fail, warn, info, error, result, usage, hint } = require('../core/chalk');
-const { CliError } = require('../core/cli-error');
+const { CliError, isCliError, toErrorPayload } = require('../core/cli-error');
 const { compileSource } = require('./page-compiler');
 const { compileCanvas } = require('./canvas-compile');
 const { runLintCheck } = require('./page-linter');
 const { buildPageFile, shouldBuildPageSource } = require('./page-compat');
 const { warnLargePageSource } = require('./page-size-guard');
+const { assertPageTemplateCustomized } = require('./page-template-guard');
 const { fetchFormPageList } = require('./form-navigation');
 const { parseOpenOption, withBrowserHandoff } = require('../core/browser-handoff');
 const { assertNoEmojiInValue } = require('../core/no-emoji-guard');
@@ -540,6 +541,7 @@ async function runMain(argv) {
   sourcePath = initialSource.absolutePath;
   const initialSourceCode = initialSource.source;
   warnLargePageSource(initialSourceCode, sourcePath);
+  assertPageTemplateCustomized(initialSourceCode, sourcePath);
 
   let sourceCode = initialSourceCode;
   let compiledCode = '';
@@ -723,6 +725,18 @@ async function runMain(argv) {
       success(t('publish.nav_order_ok', orderedNames || '-'));
     } catch (navOrderError) {
       navOrderWarning = navOrderError && navOrderError.message ? navOrderError.message : t('common.unknown_error');
+      navOrderResult = isCliError(navOrderError)
+        ? toErrorPayload(navOrderError)
+        : {
+          success: false,
+          errorCode: 'NAV_ORDER_RESULT_UNKNOWN',
+          errorMsg: navOrderWarning,
+          retryable: false,
+          retrySafe: false,
+          sideEffectState: 'unknown',
+          readbackVerified: false,
+          nextStep: `openyida nav-group list ${appType} --flat`,
+        };
       warn(t('publish.nav_order_failed', navOrderWarning));
     }
   }

package/lib/app/services/canvas-page-schema-builder.js

@@ -361,7 +361,7 @@ function buildCanvasPageSchemaObject(sourceCode, runtimeCode, importedModules, f
               contentBgColorMobile: 'var(--pod-page-bg-color, var(--color-white, #fff))',
             },
             condition: true,
-            css: 'body{background-color:var(--pod-page-bg-color,var(--color-white,#fff))}.vc-page-yida-page{--yida-form-content-padding:0;--yida-form-content-margin:0;--yida-layout-padding:0}.vc-deep-container-entry.vc-rootcontent{padding:0!important;margin-top:0!important;margin-right:0!important;margin-bottom:0!important;margin-left:0!important}',
+            css: '.vc-page-yida-page{--yida-form-content-padding:0;--yida-form-content-margin:0;--yida-layout-padding:0}.vc-deep-container-entry.vc-rootcontent{padding:0!important;margin-top:0!important;margin-right:0!important;margin-bottom:0!important;margin-left:0!important}',
             methods: {
               __initMethods__: {
                 type: 'js',

package/lib/asset/ai-image.js

@@ -11,8 +11,8 @@
  *      由 skill 文档引导它：能自己生成就生成，否则去免费素材库搜真实图片；
  *   3. 提供推荐的免费/可商用素材库清单与使用纪律，供 skill / agent 参考。
  *
- * 无论走哪条路，产出的候选 URL 都必须先经过 url-verify 校验真实可达，
- * 再（有 CDN 时）转存 CDN，绝不把未经校验或编造的 URL 直接写进页面。
+ * 无论走哪条路，候选素材都交给 asset resolve 统一解析；有 CDN 时再转存，
+ * 绝不把编造的 URL 直接写进页面。
  *
  * 用法：
  *   const { detectImageGenerator, getFreeStockLibraries, getMaterialSourcingGuidance } = require('./ai-image');
@@ -25,7 +25,7 @@
  * 推荐的免费 / 可商用图片素材库
  * 说明：这些站点提供免费可商用（多为 CC0 / 自有免费授权）的高质量图片，
  * 适合官网 Hero、产品图、场景配图。agent 应优先从这里取真实图片 URL，
- * 取到后必须用 `openyida asset verify-url` 校验可达且确为图片。
+ * 取到后交给 `openyida asset resolve` 统一处理。
  */
 const FREE_STOCK_LIBRARIES = [
   {
@@ -34,7 +34,7 @@ const FREE_STOCK_LIBRARIES = [
     license: 'Unsplash License（免费可商用，无需署名）',
     bestFor: '高质量摄影级 Hero 大图、生活方式/场景图',
     directImageHint:
-      'images.unsplash.com/photo-... 形式的直链可直接用于 <img>；页面链接需先取到直链再校验。',
+      'images.unsplash.com/photo-... 形式的直链可直接用于 <img>；页面链接需先取得图片直链。',
   },
   {
     name: 'Pexels',
@@ -82,7 +82,7 @@ function detectImageGenerator(options = {}) {
     reason:
       'openyida 无内置文生图能力（`openyida ai` 仅支持文生文/识图）。' +
       '图片素材应由智能体自行生成，或到免费素材库（Unsplash/Pexels 等）检索真实图片，' +
-      '再经 `openyida asset verify-url` 校验、（有 CDN 时）转存 CDN 后回填 spec。',
+      '再交给 `openyida asset resolve` 解析、（有 CDN 时）转存 CDN 后回填 spec。',
     delegateToAgent: true,
   };
 }
@@ -105,13 +105,12 @@ function getMaterialSourcingGuidance() {
       '1. 判断页面是否需要真实图片（官网 Hero / 产品图 / 场景图通常需要）。',
       '2. 优先：若智能体自身具备图片生成能力，按品牌调性生成图片并保存到本地。',
       '3. 备选：到免费可商用素材库（见 libraries）检索与主题匹配的真实图片，拿到图片直链。',
-      '4. 校验：对每个候选 URL 运行 `openyida asset verify-url <url>`，只保留 ok=true 的。',
-      '5. 转存：若已配置 CDN（`openyida asset status` 显示 cdn-upload），用 `openyida asset resolve --upload-assets` 把本地/外链图片转存为稳定 CDN URL 并回填 spec.assets。',
-      '6. 兜底：若既无生成能力又找不到可校验素材，交付「标注素材缺口」的低保真草稿，绝不编造图片 URL 或声称已上传。',
+      '4. 解析：把本地文件或外链交给 `openyida asset resolve` 统一处理并回填 spec.assets；已配置 CDN 时转存为稳定 URL。',
+      '5. 兜底：若既无生成能力又找不到可用素材，交付「标注素材缺口」的低保真草稿，绝不编造图片 URL 或声称已上传。',
     ],
     libraries: getFreeStockLibraries(),
     rules: [
-      '绝不编造图片 URL；未经 verify-url 校验的 URL 不得写进页面。',
+      '绝不编造图片 URL；素材经 `openyida asset resolve` 统一处理后再写进页面。',
       '无 CDN 时不得声称「已上传」或「已是最终版」。',
       '素材授权需为免费可商用；如不确定授权，改用文字排版/数据图示/插画（如 unDraw）替代。',
     ],