openyida 2026.9.15 → 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.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',

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、反爬挑战或超时后，将该来源标记为本次采集不可用，其他页面和后续轮次使用其他来源。',
+      '每页最多两轮；每个位置每轮选一张，同一候选尝试一次，成功即结束。第二轮只补失败的必需位置；换来源、换工具或恢复上传仍计入本轮预算。',
+      '来源信息获取失败时换用信息齐全的候选；真实房源、商品和人员保持真实素材要求。',
     ],
   };
 }

package/lib/asset/asset-cmd.js

@@ -8,13 +8,13 @@ const { resolveAssets, ASSET_SOURCES } = require('./asset-resolve');
 const { detectImageGenerator, getMaterialSourcingGuidance } = require('./ai-image');
 const { throwCommandError, throwStatus, throwUsage } = require('../core/command-errors');
 
-const RESOLVE_USAGE = '用法: openyida asset resolve (--input <manifest-draft.json> | --slot <slotId>=<路径或URL> ...) [--manifest <asset-manifest.json>] [--design <design.md>] [--source search|user|generated] [--app-type <appType>] [--upload-assets] [--offline] [--json]';
+const RESOLVE_USAGE = '用法: openyida asset resolve (--input <manifest-draft.json> | --slot <slotId>=<路径或URL> ...) [--manifest <asset-manifest.json>] [--design <design.md>] [--page-id <pageId>] [--source search|user|generated] [--app-type <appType>] [--upload-assets] [--offline] [--json]';
 
 function printHelp() {
   console.log(`
 用法:
   openyida asset status [--offline] [--json]
-  openyida asset resolve (--input <manifest-draft.json> | --slot <slotId>=<路径或URL> ...) [--manifest <asset-manifest.json>] [--design <design.md>] [--source search|user|generated] [--app-type <appType>] [--upload-assets] [--offline] [--json]
+  openyida asset resolve (--input <manifest-draft.json> | --slot <slotId>=<路径或URL> ...) [--manifest <asset-manifest.json>] [--design <design.md>] [--page-id <pageId>] [--source search|user|generated] [--app-type <appType>] [--upload-assets] [--offline] [--json]
   openyida asset sources [--json]
 
 子命令:
@@ -23,6 +23,7 @@ function printHelp() {
 
 图片不超过 20 MiB 时上传；超过限制的外链保留原地址。
 --app-type 指定目标应用，省略时读取项目 config.json。
+--page-id 只处理该页槽位；按页并发时，每页使用独立的 --manifest 文件。
 --upload-assets 仅兼容旧命令，默认已上传；--offline 不联网、不上传。
   sources   输出 Unsplash/Pexels 使用规则
 `);
@@ -85,6 +86,10 @@ function parseArgs(args) {
       parsed.usedOptions.push('--design');
       parsed.design = args[++i] || '';
       if (!parsed.design || parsed.design.startsWith('--')) {parsed.errors.push('ASSET_DESIGN_REQUIRED');}
+    } else if (arg === '--page-id') {
+      parsed.usedOptions.push('--page-id');
+      parsed.pageId = args[++i] || '';
+      if (!parsed.pageId.trim() || parsed.pageId.startsWith('--')) {parsed.errors.push('ASSET_PAGE_ID_REQUIRED');}
     } else if (arg === '--manifest') {
       parsed.usedOptions.push('--manifest');
       parsed.manifest = args[++i] || '';
@@ -158,6 +163,7 @@ async function runResolve(options) {
 
   const result = await resolveAssets(assets, {
     assetStrategy,
+    pageId: options.pageId,
     online: !options.offline,
     appType: options.appType,
     assetSource: options.source,

package/lib/asset/asset-plan.js

@@ -1,6 +1,7 @@
 'use strict';
 
 const fs = require('fs');
+const path = require('path');
 const { CliError } = require('../core/cli-error');
 
 function invalid(code, details = {}) {
@@ -18,7 +19,7 @@ function nonempty(value) {
 function minimumSize(asset) {
   const match = typeof asset.minSize === 'string' && asset.minSize.match(/^(\d+)x(\d+)$/i);
   if (asset.minSize !== undefined && !match) {
-    invalid('ASSET_INVALID_SIZE', { slotId: asset.slotId, minSize: asset.minSize });
+    invalid('ASSET_INVALID_SIZE', { slotId: asset.slotId, field: 'minSize', minSize: asset.minSize, expected: 'widthxheight string, e.g. 1600x900' });
   }
   const values = [asset.minWidth ?? 0, asset.minHeight ?? 0];
   const declared = match ? [Number(match[1]), Number(match[2])] : [0, 0];
@@ -42,7 +43,7 @@ function readDesignAssetStrategy(file) {
 }
 
 // The design owns page membership, required slots and minimum dimensions.
-function prepareAssetPlan(assets, assetStrategy) {
+function prepareAssetPlan(assets, assetStrategy, pageId) {
   if (!Array.isArray(assets)) {invalid('ASSET_INPUT_INVALID', { field: 'assets' });}
   const seen = new Set();
   const entries = assets.map(asset => {
@@ -53,10 +54,15 @@ function prepareAssetPlan(assets, assetStrategy) {
     minimumSize(asset);
     return { ...asset, slotId };
   });
-  if (assetStrategy === undefined) {return { entries, pages: [], assetStrategy: undefined };}
+  if (assetStrategy === undefined) {
+    if (pageId !== undefined) {invalid('ASSET_PAGE_REQUIRES_DESIGN', { pageId });}
+    return { entries, pages: [], assetStrategy: undefined };
+  }
   if (!object(assetStrategy) || !Array.isArray(assetStrategy.pages)) {
     invalid('ASSET_DESIGN_INVALID', { field: 'assetStrategy.pages' });
   }
+  assetStrategy = { ...assetStrategy, pages: assetStrategy.pages.map(page =>
+    object(page) && page.imageNeed === 'none' && page.slots === undefined ? { ...page, slots: [] } : page) };
   const pageIds = new Set();
   const slots = new Map();
   const pages = assetStrategy.pages.map(page => {
@@ -99,7 +105,43 @@ function prepareAssetPlan(assets, assetStrategy) {
       minHeight: Math.max(designSize.minHeight, inputSize.minHeight),
     };
   });
+  if (pageId !== undefined) {
+    if (!nonempty(pageId) || !pageIds.has(pageId.trim())) {invalid('ASSET_PAGE_NOT_FOUND', { pageId });}
+    const selectedId = pageId.trim();
+    return {
+      entries: planned.filter(entry => entry.pageId === selectedId),
+      pages: pages.filter(page => page.pageId === selectedId),
+      assetStrategy: { ...assetStrategy, pages: assetStrategy.pages.filter(page => page.pageId.trim() === selectedId) },
+    };
+  }
   return { entries: planned, pages, assetStrategy };
 }
 
-module.exports = { minimumSize, prepareAssetPlan, readDesignAssetStrategy };
+// The host executes search tasks; the CLI provides concrete inputs and independent output paths.
+function buildAssetTasks(assetStrategy, outputDir) {
+  const plan = prepareAssetPlan([], assetStrategy);
+  const guidance = require('./ai-image').getMaterialSourcingGuidance();
+  return plan.pages.filter(page => page.imageNeed !== 'none' && page.slotIds.length).map(page => {
+    const basename = path.join(outputDir, 'asset-manifests', encodeURIComponent(page.pageId));
+    const draft = `${basename}.draft.json`;
+    const manifest = `${basename}.json`;
+    return {
+      pageId: page.pageId, skillId: 'yida-image-assets', startWhen: 'plan_confirmed',
+      ...guidance.schedulingPolicy,
+      collectionPolicy: guidance.collectionPolicy,
+      failurePolicy: guidance.failurePolicy,
+      draft, manifest,
+      searches: plan.entries.filter(slot => slot.pageId === page.pageId).map(slot => ({
+        slotId: slot.slotId, usage: slot.usage, ...minimumSize(slot),
+        required: slot.required, generationAllowed: slot.generationAllowed === true, dependsOn: [],
+      })),
+      resolve: {
+        startWhen: 'page_draft_and_app_type_ready', appTypeRequired: true,
+        argv: ['asset', 'resolve', '--input', draft, '--manifest', manifest,
+          '--design', path.join(outputDir, 'design.md'), '--page-id', page.pageId, '--app-type', '<appType>', '--json'],
+      },
+    };
+  });
+}
+
+module.exports = { minimumSize, prepareAssetPlan, readDesignAssetStrategy, buildAssetTasks };

package/lib/asset/asset-resolve.js

@@ -10,6 +10,7 @@ const { minimumSize, prepareAssetPlan } = require('./asset-plan');
 const { readImageMetadata, parseImageMetadata } = require('./image-metadata');
 const { MAX_IMAGE_BYTES, uploadAttachment } = require('./attachment-upload');
 const { getAssetStatus } = require('./asset-status');
+const { t } = require('../core/i18n');
 
 const ALLOWED_STOCK_IMAGE_PROVIDERS = Object.freeze({
   unsplash: Object.freeze(['images.unsplash.com']),
@@ -258,7 +259,9 @@ async function resolveOne(candidate, ctx = {}) {
     }
   }
 
-  return { resolved: false, url: raw, source: 'unknown', reason: 'NOT_FOUND' };
+  return { resolved: false, url: raw, source: 'unknown', reason: 'NOT_FOUND',
+    message: t('asset.localFileUnavailable', path.resolve(raw)),
+    details: { input: raw, resolvedPath: path.resolve(raw), baseDir: process.cwd(), pathBase: 'cwd' } };
 }
 
 function normalizeSource(source, fallback) {
@@ -284,7 +287,7 @@ function metadataGaps(asset) {
 }
 
 async function resolveAssets(assets = [], options = {}) {
-  const plan = prepareAssetPlan(assets, options.assetStrategy);
+  const plan = prepareAssetPlan(assets, options.assetStrategy, options.pageId);
   const entries = plan.entries;
   const online = options.online !== false;
   const status = options.status || getAssetStatus({ online, env: options.env, runtime: options.runtime });
@@ -363,7 +366,8 @@ async function resolveAssets(assets = [], options = {}) {
         slotId: slotId || `slot-${index + 1}`,
         pageId: output.pageId,
         code: result.reason,
-        message: `图片未落地：${result.reason}`,
+        message: result.message || `图片未落地：${result.reason}`,
+        ...(result.details ? { details: result.details } : {}),
       });
       gaps.push(...output.gaps.map(gap => ({ ...gap })));
       return;

package/lib/core/agent-capabilities.js

@@ -146,6 +146,7 @@ const BUILDER_CORE_COMMAND_IDS = Object.freeze([
   'get-permission',
   'save-permission',
   'create-app',
+  'design-plan.catalog',
   'design-plan.init',
   'design-plan.materialize',
   'design-plan.preview',
@@ -176,6 +177,7 @@ function commandBriefs(manifest, commandIds) {
       examples: entry.examples || [],
       args: entry.args || [],
       canonical: entry.canonical || null,
+      notes: entry.notes || [],
     }));
 }
 
@@ -466,9 +468,15 @@ function buildFullAppArtifactRoute(manifest) {
     orchestrator_skill_id: workflow.orchestrator_skill_id,
     requirement_analysis_skill_id: workflow.requirement_analysis_skill_id,
     requirement_brief_path: workflow.requirement_brief_path,
+    user_visible_expression_policy: workflow.user_visible_expression_policy,
     optional_asset_branch: workflow.optional_asset_branch,
     design_mode_policy: workflow.design_mode_policy,
     navigation_policy: workflow.navigation_policy,
+    entry_navigation_contract: workflow.entry_navigation_contract,
+    application_entry_policy: workflow.application_entry_policy,
+    default_nav_order_policy: workflow.default_nav_order_policy,
+    final_link_policy: workflow.final_link_policy,
+    product_design_policy: workflow.product_design_policy,
     plan_command_ids: workflow.plan_command_ids,
     theme_command_ids: workflow.theme_command_ids,
     navigation_command_ids: workflow.navigation_command_ids,
@@ -489,7 +497,7 @@ function buildApplicationEntryPolicy(builderPath, env = process.env) {
     resource_delivery: 'summary_only',
     internal_artifact_delivery: 'never',
     entries: {
-      workbench: 'always',
+      workbench: 'when_workspace_in_scope',
       custom: 'when_entry_mode_standalone_and_is_render_nav_false_readback',
       admin: injectedAuthUsable ? 'omit' : 'include',
     },
@@ -539,6 +547,7 @@ function buildCommandManifestDigest(manifest) {
       permission_effect: entry.permission && entry.permission.effect,
       args: entry.args || [],
       canonical: entry.canonical || null,
+      notes: entry.notes || [],
     })),
   };