openyida 2026.9.20 → 2026.9.21

package/lib/design-plan/parallel.js

@@ -2,6 +2,7 @@
 
 const { createHash } = require('crypto');
 const { CliError } = require('../core/cli-error');
+const { t } = require('../core/i18n');
 const { readJson } = require('./files');
 const { assertVisualFieldObjects } = require('./normalize');
 
@@ -11,13 +12,14 @@ function planBase(plan) {
   return { revision: plan.meta?.revision, digest: createHash('sha256').update(JSON.stringify(plan)).digest('hex') };
 }
 
-function readPart(file, role, base, allowed) {
-  const part = readJson(file, `${role} 规划片段`);
+function readPart(file, role, base, allowed, supplied) {
+  const part = supplied || readJson(file, `${role} 规划片段`);
   if (!object(part) || part.ready !== true || !object(part.facts)) {
     throw new CliError(`${role} 规划尚未完成，请补齐 facts 并设置 ready=true`, { code: 'DESIGN_PLAN_PART_NOT_READY' });
   }
   if (part.base?.revision !== base.revision || part.base?.digest !== base.digest) {
-    throw new CliError(`${role} 规划来自旧版本，请根据当前计划重新整理`, { code: 'DESIGN_PLAN_STALE_PART' });
+    throw new CliError(`${role} 规划来自旧版本，请根据当前计划重新整理`, { code: 'DESIGN_PLAN_STALE_PART',
+      details: { sourcePath: file, expectedBase: base, actualBase: part.base, nextStep: t('design_plan.rebase_required') } });
   }
   const unknown = Object.keys(part.facts).filter(key => !allowed.includes(key));
   if (unknown.length) {
@@ -26,10 +28,63 @@ function readPart(file, role, base, allowed) {
   return part.facts;
 }
 
-function mergeParts(source, businessFile, visualFile) {
+// Report all binding defects at once so agents can repair the existing part.
+function assertPageBindings(pages, applications, visualFile, businessFile) {
+  const prefix = 'facts.visualStyle.forUser.pageApplications';
+  const issues = [];
+  const pageIds = [];
+  pages.forEach((page, index) => {
+    const field = `facts.pages.customPageDetails[${index}].pageId`;
+    if (!object(page) || typeof page.pageId !== 'string' || !page.pageId.trim()) {
+      issues.push({ sourcePath: businessFile, path: field, code: 'expected_nonempty_string' });
+    } else if (pageIds.includes(page.pageId)) {
+      issues.push({ sourcePath: businessFile, path: field, code: 'duplicate_page', pageId: page.pageId });
+    } else { pageIds.push(page.pageId); }
+  });
+  const seen = new Set();
+  if (!Array.isArray(applications)) {
+    issues.push({ sourcePath: visualFile, path: prefix, code: 'expected_array' });
+  } else {
+    applications.forEach((item, index) => {
+      const field = `${prefix}[${index}]`;
+      if (!object(item)) {
+        issues.push({ sourcePath: visualFile, path: field, code: 'expected_object' });
+        return;
+      }
+      if (typeof item.pageId !== 'string' || !item.pageId.trim()) {
+        issues.push({ sourcePath: visualFile, path: `${field}.pageId`, code: 'expected_nonempty_string' });
+      } else {
+        if (!pageIds.includes(item.pageId)) {
+          issues.push({ sourcePath: visualFile, path: `${field}.pageId`, code: 'unexpected_page', pageId: item.pageId });
+        }
+        if (seen.has(item.pageId)) {
+          issues.push({ sourcePath: visualFile, path: `${field}.pageId`, code: 'duplicate_page', pageId: item.pageId });
+        }
+        seen.add(item.pageId);
+      }
+      if (!Array.isArray(item.visualMemoryApplications)) {
+        issues.push({ sourcePath: visualFile, path: `${field}.visualMemoryApplications`, code: 'expected_array' });
+      }
+    });
+  }
+  pageIds.filter(pageId => !seen.has(pageId)).forEach(pageId => {
+    issues.push({ sourcePath: visualFile, path: prefix, code: 'missing_page', pageId });
+  });
+  if (issues.length) {
+    const nextStep = t('design_plan.repair_page_bindings');
+    const summary = issues.map(issue => `${issue.path}: ${issue.code}${issue.pageId ? ` (${issue.pageId})` : ''}`).join('; ');
+    throw new CliError(`${nextStep} ${summary}`, {
+      code: 'DESIGN_PLAN_PAGE_BINDINGS_REQUIRED',
+      details: { sourcePath: visualFile, expectedPageIds: pageIds, issues, nextStep },
+    });
+  }
+}
+
+function mergeParts(source, businessFile, visualFile, options = {}) {
   const base = planBase(source);
-  const business = readPart(businessFile, 'business', base, ['overview', 'dataModels', 'businessFlows', 'pages', 'execution', 'meta']);
-  const visual = readPart(visualFile, 'visual', base, ['visualStyle']);
+  const rebased = options.rebaseParts ? require('./rebase').rebaseParts(source, options.input, businessFile, visualFile) : [];
+  const business = readPart(businessFile, 'business', base, ['overview', 'dataModels', 'businessFlows', 'pages', 'execution', 'meta'], rebased[0]);
+  const visual = readPart(visualFile, 'visual', base, ['visualStyle'], rebased[1]);
   assertVisualFieldObjects(visual.visualStyle?.forUser, { prefix: 'facts.visualStyle.forUser', sourcePath: visualFile });
   if (!object(business.overview) || !Array.isArray(business.dataModels) || !Array.isArray(business.businessFlows)
     || !Array.isArray(business.pages?.customPageDetails) || !object(visual.visualStyle)) {
@@ -39,13 +94,7 @@ function mergeParts(source, businessFile, visualFile) {
     || Object.keys(business.meta).some(key => !['businessDomain', 'experienceTopology'].includes(key)))) {
     throw new CliError('业务 meta 仅填写 businessDomain/experienceTopology，版本由 CLI 维护', { code: 'DESIGN_PLAN_PART_CONFLICT' });
   }
-  const pageIds = business.pages.customPageDetails.map(page => page.pageId);
-  const applications = visual.visualStyle.forUser?.pageApplications;
-  if (!Array.isArray(applications) || applications.length !== pageIds.length
-    || new Set(applications.map(item => item.pageId)).size !== pageIds.length
-    || applications.some(item => !pageIds.includes(item.pageId) || !Array.isArray(item.visualMemoryApplications))) {
-    throw new CliError('视觉规划需按业务页面逐一完成 pageApplications，再合并产物', { code: 'DESIGN_PLAN_PAGE_BINDINGS_REQUIRED' });
-  }
+  assertPageBindings(business.pages.customPageDetails, visual.visualStyle.forUser?.pageApplications, visualFile, businessFile);
   const plan = JSON.parse(JSON.stringify({ ...source, ...business, ...visual, meta: { ...source.meta, ...business.meta },
     ...(source.execution || business.execution ? { execution: { ...source.execution, ...business.execution,
       ...(source.execution?.appConfig || business.execution?.appConfig

package/lib/design-plan/patch.js

@@ -12,10 +12,13 @@ const PROTECTED_PATHS = [
   'meta.updatedAt',
   'meta.planState',
   'visualStyle.forUser.themeProfile',
+  'visualStyle.forUser.navigationStyle.tone',
+  'visualStyle.forUser.navigationStyle.toneSource',
+  'execution.appConfig.navTheme',
 ];
 const DANGEROUS_SEGMENTS = new Set(['__proto__', 'prototype', 'constructor']);
 
-function parsePath(pathExpression) {
+function parsePath(pathExpression, options = {}) {
   const expression = String(pathExpression || '').trim();
   if (!expression || !/^[A-Za-z_$][\w$-]*(?:(?:\.(?:[A-Za-z_$][\w$-]*|--[\w-]+))|(?:\[\d+\]))*$/.test(expression)) {
     throw new CliError(`无效字段路径：${expression || '(empty)'}`, {
@@ -28,11 +31,16 @@ function parsePath(pathExpression) {
       code: 'DESIGN_PLAN_UNSAFE_PATH',
     });
   }
-  if (PROTECTED_PATHS.some(protectedPath => expression === protectedPath
+  const protectedPaths = options.creative ? PROTECTED_PATHS.filter(field => field !== 'visualStyle.forUser.navigationStyle.tone') : PROTECTED_PATHS;
+  if (protectedPaths.some(protectedPath => expression === protectedPath
     || expression.startsWith(`${protectedPath}.`)
     || expression.startsWith(`${protectedPath}[`)
     || protectedPath.startsWith(`${expression}.`))) {
-    const hint = expression.includes('themeProfile') ? '；themeProfile 只读，请改 visualStyle.tokens 或 colorStrategy.primaryColor' : '';
+    const hint = expression.includes('themeProfile')
+      ? '；themeProfile 只读，请改 visualStyle.tokens 或 colorStrategy.primaryColor'
+      : /(?:navigationStyle\.(?:tone|toneSource)|appConfig\.navTheme)/.test(expression)
+        ? '；导航明暗由所选主题模板派生，请改选主题'
+        : '';
     throw new CliError(`字段 ${expression} 由 design-plan patch 自动维护，不能通过 --set 修改${hint}`, {
       code: 'DESIGN_PLAN_PROTECTED_PATH',
     });
@@ -49,7 +57,7 @@ function parseValue(rawValue) {
   }
 }
 
-function parseSetExpression(expression) {
+function parseSetExpression(expression, options = {}) {
   const separator = String(expression || '').indexOf('=');
   if (separator <= 0) {
     throw new CliError(`--set 必须使用 path=value 格式：${expression || '(empty)'}`, {
@@ -59,7 +67,7 @@ function parseSetExpression(expression) {
   const pathExpression = expression.slice(0, separator).trim();
   return {
     path: pathExpression,
-    segments: parsePath(pathExpression),
+    segments: parsePath(pathExpression, options),
     value: parseValue(expression.slice(separator + 1)),
   };
 }
@@ -67,7 +75,7 @@ function parseSetExpression(expression) {
 const OPTIONAL_PATHS = [
   /^execution$/,
   /^execution\.(resourceBlueprint|resourceCreationOrder|pageImplementationOrder|navigationOrder|navigationFallback|entryRecommendation|sampleDataPlan|interactionStates|acceptanceCriteria|explicitScope|appConfig)$/,
-  /^execution\.appConfig\.(appType|corpId|baseUrl|navigationType|hideAppNav|layoutDirection|navTheme|logoSource)$/,
+  /^execution\.appConfig\.(appType|corpId|baseUrl|navigationType|hideAppNav|layoutDirection|logoSource)$/,
   /^execution\.interactionStates\.(empty|loading|error|formEntry|detail)$/,
   /^visualStyle\.tokens(?:\.--[\w-]+)?$/,
   /^visualStyle\.forUser\.iconSystem(?:\.(library|mappings|colorPairs))?$/,
@@ -154,12 +162,17 @@ function patchPlan(inputPath, setExpressions, options = {}) {
   }
   const original = readJson(resolvedInput);
   const patched = JSON.parse(JSON.stringify(original));
-  const changes = expressions.map(parseSetExpression).map(change => ({
+  const selectedTheme = original.visualStyle?.internal?.selectedTheme || original.visualStyle?.forUser?.selectedTheme;
+  const creative = selectedTheme?.themeId === 'free-creative';
+  const changes = expressions.map(expression => parseSetExpression(expression, { creative })).map(change => ({
     ...change,
     previousValue: setExistingPath(patched, change),
   }));
   const effectiveChanges = changes.filter(change => JSON.stringify(change.previousValue) !== JSON.stringify(change.value));
   if (JSON.stringify(original) === JSON.stringify(patched)) {
+    if (options.materialize) {
+      return { ...require('./materialize').materialize(resolvedInput, { outputDir: options.outputDir }), changed: false, materialized: true, changedPaths: [], confirmationInvalidated: false };
+    }
     return {
       success: true,
       changed: false,
@@ -195,6 +208,7 @@ function patchPlan(inputPath, setExpressions, options = {}) {
     confirmationInvalidated: !assetProgressOnly,
     materialized: options.materialize === true,
     outputs: options.materialize ? artifacts.outputs : undefined,
+    ...(options.materialize ? { confirmation: require('./confirmation').confirmationPayload(artifacts.outputs, artifacts.revision) } : {}),
     updated: updates?.updated || [],
   };
 }

package/lib/design-plan/rebase.js

@@ -0,0 +1,60 @@
+'use strict';
+
+const path = require('path');
+const fs = require('fs');
+const { CliError } = require('../core/cli-error');
+const { readJson } = require('./files');
+const { t } = require('../core/i18n');
+
+const BASE_FILE = '.build-plan-base.json';
+const equal = (a, b) => JSON.stringify(a) === JSON.stringify(b);
+const object = value => value && typeof value === 'object' && !Array.isArray(value);
+
+// Arrays represent ordered business facts; conflicting edits require a decision.
+function reconcile(base, current, proposed, field, conflicts) {
+  if (equal(current, proposed) || equal(proposed, base)) { return current; }
+  if (equal(current, base)) { return proposed; }
+  if (object(base) && object(current) && object(proposed)) {
+    const result = {};
+    for (const key of new Set([...Object.keys(base), ...Object.keys(current), ...Object.keys(proposed)])) {
+      const value = reconcile(base[key], current[key], proposed[key], field ? `${field}.${key}` : key, conflicts);
+      if (value !== undefined) { result[key] = value; }
+    }
+    return result;
+  }
+  conflicts.push(field);
+  return proposed;
+}
+
+function rebaseParts(source, input, businessFile, visualFile) {
+  const { planBase } = require('./parallel');
+  const baselinePath = path.join(path.dirname(path.resolve(input)), BASE_FILE);
+  const fail = (code, details) => { throw new CliError(t('design_plan.rebase_required'), { code, details: { baselinePath, ...details } }); };
+  if (!fs.existsSync(baselinePath)) { fail('DESIGN_PLAN_BASELINE_MISSING', { nextStep: t('design_plan.baseline_missing') }); }
+  const saved = readJson(baselinePath);
+  if (saved.schemaVersion !== 1 || !object(saved.plan) || !equal(saved.base, planBase(saved.plan))) {
+    fail('DESIGN_PLAN_BASELINE_INVALID', { nextStep: t('design_plan.baseline_missing') });
+  }
+  if (source.meta?.status !== 'draft' || source.meta?.planState?.presentedRevision
+      || source.meta?.planState?.planConfirmed || !equal(source.meta, saved.plan.meta)) {
+    fail('DESIGN_PLAN_REBASE_STAGE_INVALID', { nextStep: t('design_plan.rebase_stage_invalid') });
+  }
+  const parts = [businessFile, visualFile].map(file => readJson(file));
+  for (const [index, part] of parts.entries()) {
+    if (!equal(part.base, saved.base) || !object(part.facts)) {
+      fail('DESIGN_PLAN_BASELINE_MISMATCH', { sourcePath: [businessFile, visualFile][index], nextStep: t('design_plan.baseline_missing') });
+    }
+  }
+  return parts.map((part, index) => {
+    const conflicts = [];
+    const facts = Object.fromEntries(Object.keys(part.facts).map(key => [key,
+      reconcile(saved.plan[key], source[key], part.facts[key], key, conflicts),
+    ]));
+    if (conflicts.length) {
+      fail('DESIGN_PLAN_REBASE_CONFLICT', { sourcePath: [businessFile, visualFile][index], conflicts, nextStep: t('design_plan.rebase_conflict') });
+    }
+    return { ...part, facts, base: planBase(source) };
+  });
+}
+
+module.exports = { BASE_FILE, rebaseParts };

package/lib/design-plan/themes.js

@@ -4,6 +4,7 @@ const fs = require('fs');
 const path = require('path');
 const { CliError } = require('../core/cli-error');
 const { readJson } = require('./files');
+const { parseDesignDocument } = require('../design/document');
 
 const DESIGN_SKILL_ROOT = path.resolve(__dirname, '../../yida-skills/skills/yida-design');
 const PLAN_SKILL_ROOT = path.join(DESIGN_SKILL_ROOT, 'sub_skill/yida-design-plan');
@@ -21,6 +22,20 @@ function themeTemplatePath(theme) {
   return file;
 }
 
+function themeNavTheme(theme) {
+  if (theme.mode === 'creative') {return undefined;}
+  const file = themeTemplatePath(theme);
+  const metadata = parseDesignDocument(fs.readFileSync(file, 'utf8')).metadata;
+  const navTheme = metadata.themeProfile?.navTheme || metadata.navTheme;
+  if (!['light', 'dark'].includes(navTheme)) {
+    throw new CliError(`主题模板 navTheme 无效：${theme.themeId}`, {
+      code: 'DESIGN_PLAN_THEME_NAV_THEME_INVALID',
+      details: { themeId: theme.themeId, navTheme: metadata.navTheme, templatePath: theme.templatePath },
+    });
+  }
+  return navTheme;
+}
+
 // Color recipes live with the visual theme. Resolve their token dependencies rather
 // than duplicating per-theme palettes in JavaScript.
 function resolveThemeColors(source) {
@@ -83,4 +98,4 @@ function resolveColorToken(tokens, name, seen = new Set()) {
   return alias ? resolveColorToken(tokens, alias[1], seen) || alias[2] || null : null;
 }
 
-module.exports = { DESIGN_SKILL_ROOT, PLAN_SKILL_ROOT, loadThemeIndex, themeTemplatePath, resolveThemeColors, resolveColorToken };
+module.exports = { DESIGN_SKILL_ROOT, PLAN_SKILL_ROOT, loadThemeIndex, themeTemplatePath, themeNavTheme, resolveThemeColors, resolveColorToken };

package/lib/design-plan/validate.js

@@ -6,6 +6,8 @@ const { CliError } = require('../core/cli-error');
 const { derivePageContent } = require('./normalize');
 const { PLAN_SKILL_ROOT: ROOT, loadThemeIndex } = require('./themes');
 const { concretePageText } = require('../design/page-content');
+const { ENTRY_MODES } = require('./entry-navigation');
+const { t } = require('../core/i18n');
 
 const object = value => value !== null && typeof value === 'object' && !Array.isArray(value);
 const filled = value => typeof value === 'string' && value.trim().length > 0;
@@ -74,8 +76,11 @@ function collectIssues(plan) {
   const pages = plan.pages?.customPageDetails;
   const recommendation = plan.execution?.entryRecommendation;
   if (recommendation !== undefined && check(object(recommendation), 'execution.entryRecommendation', '填写访问态入口方案')) {
-    check(['unified', 'service-management', 'frontend-only'].includes(recommendation.mode), 'execution.entryRecommendation.mode', '明确统一工作区、前后台或仅前台');
+    check(ENTRY_MODES.includes(recommendation.mode), 'execution.entryRecommendation.mode', t('cli.design_plan_entry_mode_required'));
     if (array(recommendation.entries, 'execution.entryRecommendation.entries', true)) {
+      if (recommendation.mode === 'backend-only') {
+        check(recommendation.entries.every(entry => entry?.role === 'management'), 'execution.entryRecommendation.entries', t('cli.design_plan_backend_only_roles'));
+      }
       recommendation.entries.forEach((entry, index) => {
         const p = `execution.entryRecommendation.entries[${index}]`;
         strings(entry, p, ['key', 'name', 'defaultMenuKey']);

package/lib/design-plan/visual-policy.js

@@ -4,6 +4,20 @@ function getVisualDecisionPolicy() {
   return {
     reference: 'yida-skills/skills/yida-design/references/theme-selection.md#设计方向比较',
     preserve: 'explicit_user_direction_brand_and_existing_app_theme',
+    applicationStyle: {
+      scope: ['navigation', 'application_shell', 'native_form', 'custom_page', 'record_detail'],
+      navigationTokens: 'tokens.application-global.appearance.navigation',
+      navigationRoles: ['surface', 'text', 'hover', 'selected', 'disabled', 'logo', 'group', 'search', 'popup', 'action', 'border', 'radius', 'shadow', 'density'],
+      navigationShape: {
+        reference: 'yida-skills/skills/yida-design/references/application-theme-consistency.md#导航形状与密度的案例经验',
+        inputs: ['radius', 'normal_hover_selected_borders', 'selected_shadow', 'item_height', 'padding', 'gap', 'shell_spacing'],
+        authoring: { fast: 'design.md tokens.application-global.appearance.navigation', plan: 'visualStyle.tokens' },
+        layout: 'preserve_business_navigation_type_independently_of_theme_appearance',
+        verification: ['native_data_management', 'custom_page', 'submission', 'record_detail', 'long_labels', 'collapsed_navigation'],
+      },
+      delivery: 'one_design_document_and_application_theme_css',
+      verification: 'read_back_app_settings_and_verify_rendered_navigation_form_custom_page_and_detail',
+    },
     nativeFormLayout: {
       model: 'component_based_native_form_layout',
       regions: ['top', 'left', 'main', 'right', 'between_fields'],
@@ -15,13 +29,13 @@ function getVisualDecisionPolicy() {
     creativeOption: { alwaysAvailable: true, themeId: 'free-creative', selectionRequired: false,
       source: 'independent_business_reasoning_not_preset_matching',
       authoringReference: 'yida-skills/skills/yida-design/references/application-style-library.md' },
-    comparison: { baseline: 'first_instinct', alternatives: 2, distinctDimensions: 2,
-      dimensions: ['composition', 'typography', 'surface_hierarchy', 'color_relationships'] },
+    comparison: { candidateCount: 3, baseline: 'first_instinct', alternatives: 2, distinctDimensions: 2,
+      dimensions: ['composition', 'typography', 'surface_hierarchy', 'color_relationships', 'navigation_shape_and_density'] },
     selection: 'refine_and_choose_a_supported_alternative_within_business_constraints',
     quality: ['task_efficiency', 'readability_and_contrast', 'consistent_spacing_and_alignment', 'coherent_visual_identity'],
-    execution: 'one_internal_comparison_in_current_planning_pass',
+    execution: 'one_shared_three_direction_generation_pass_for_fast_and_plan',
     handoff: ['visualSelection.visualDirection.description', 'visualSelection.colorStrategy.usage'],
-    presentation: 'selected_style_and_business_fit; show_alternatives_when_requested',
+    presentation: 'fast_selects_internally; plan_asks_user_when_no_explicit_visual_direction',
   };
 }
 

package/lib/samples/openyida-scaffold/canvas-form-drawer.canvas.jsx

@@ -61,7 +61,7 @@ function buildYidaFormUrl(request, currentAppType) {
   return '';
 }
 
-/** 抽屉外壳默认跟随应用主题，background 可为当前抽屉指定颜色、渐变或 CSS token。 */
+/** 抽屉默认使用内容画布与正文文字，background 可为当前抽屉指定颜色、渐变或 CSS token。 */
 function CanvasDrawer({
   open, title, onClose, onOpenInNewWindow, extra, children,
   contentMode = 'content',
@@ -138,7 +138,7 @@ function CanvasDrawer({
           border: 0;
           border-radius: 8px;
           background: transparent;
-          color: var(--drawer-close-color, var(--pod-page-header-text-color, var(--color-text1-3, #666)));
+          color: var(--drawer-close-color, var(--pod-page-header-text-color, var(--color-text1-4, #1f2329)));
           cursor: pointer;
         }
         .openyida-form-drawer .oy-drawer-action:hover {
@@ -215,7 +215,7 @@ function CanvasDrawer({
           },
           content: {
             background,
-            color: 'var(--drawer-content-color, var(--color-text1-4, #1f2329))',
+            color: 'var(--drawer-content-color, var(--pod-page-header-text-color, var(--color-text1-4, #1f2329)))',
             borderLeft: 'var(--drawer-border-width, 0px) var(--drawer-border-style, solid) var(--drawer-border-color, transparent)',
             borderRadius: fullScreen ? 0 : 'var(--pod-drawer-border-radius, var(--pod-drawer-radius, var(--drawer-corner, 20px))) 0 0 var(--pod-drawer-border-radius, var(--pod-drawer-radius, var(--drawer-corner, 20px)))',
             overflow: 'hidden',

package/lib/samples/openyida-scaffold/canvas-nav/mixed.jsx

@@ -4,12 +4,14 @@ function CanvasNav({ items = [], activeKey, onSelect, title, logo, actions, chil
   return <div className="oy-canvas-nav oy-nav-mixed">
     <style>{CANVAS_NAV_CSS + `
       .oy-nav-mixed { display: flex; flex-direction: column; }
-      .oy-nav-mixed .oy-nav-header { display: flex; flex-wrap: wrap; align-items: center; gap: var(--pod-nav-l-header-gap, 24px); padding: var(--pod-nav-l-header-padding, 8px 16px); border-bottom: 1px solid var(--pod-nav-sub-divider-color, var(--color-line1-1, #ddd)); }
-      .oy-nav-mixed .oy-nav-groups { display: flex; flex: 1; min-width: 0; overflow-x: auto; }
+      .oy-nav-mixed .oy-nav-header { box-sizing: border-box; min-height: var(--pod-nav-platform-header-height, 48px); display: flex; flex-wrap: wrap; align-items: center; gap: var(--pod-nav-l-header-gap, 24px); padding: var(--pod-nav-l-header-padding, 8px 16px); border-bottom: 1px solid var(--pod-nav-sub-divider-color, var(--color-line1-1, #ddd)); }
+      .oy-nav-mixed .oy-nav-groups { display: flex; flex: 1; min-width: 0; gap: var(--pod-nav-menu-gap, 8px); padding: calc(var(--pod-nav-menu-gap, 8px) / 2); overflow-x: auto; }
+      .oy-nav-mixed .oy-nav-groups .oy-nav-item { min-height: var(--pod-nav-top-tab-height, 40px); padding: var(--pod-nav-top-tab-item-padding, 0 12px); max-width: var(--pod-nav-top-tab-item-max-width, 240px); }
+      .oy-nav-mixed .oy-nav-groups .oy-nav-item > span { overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
       .oy-nav-mixed .oy-nav-body { display: flex; flex: 1; }
+      .oy-canvas-nav.oy-nav-mixed .oy-nav-sidebar { padding: var(--pod-nav-l-aside-padding, 8px); }
       .oy-nav-mixed .oy-nav-content { flex: 1; }
-      .oy-nav-mixed .oy-nav-menu { display: flex; flex-direction: column; gap: var(--pod-nav-slide-aside-gap, 12px); }
-      .oy-nav-mixed .oy-nav-item[aria-current="page"] { box-shadow: inset 0 -2px var(--pod-nav-tab-line-selected-color, var(--color-brand1-6, #1677ff)); }
+      .oy-nav-mixed .oy-nav-menu { display: flex; flex-direction: column; gap: var(--pod-nav-menu-gap, 8px); }
       @media (max-width: 767px) {
         .oy-nav-mixed .oy-nav-groups { flex-basis: 100%; }
         .oy-nav-mixed .oy-nav-body { display: block; }

package/lib/samples/openyida-scaffold/canvas-nav/shared.jsx

@@ -14,12 +14,12 @@ const CANVAS_NAV_CSS = `
   .oy-canvas-nav .oy-nav-brand > span { overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
   .oy-canvas-nav .oy-nav-item {
     box-sizing: border-box; display: flex; flex-shrink: 0; align-items: center; gap: var(--pod-nav-logo-gap, 8px);
-    min-height: var(--pod-nav-menu-item-height, 40px); padding: var(--pod-nav-top-tab-item-padding, 0 12px);
-    border: 0; border-radius: var(--pod-nav-menu-item-radius, 8px); background: transparent;
-    color: var(--pod-nav-item-text-color, var(--color-text1-4, #1f2329)); font: inherit; font-size: var(--pod-nav-menu-font-size, 14px); text-decoration: none; text-align: start; cursor: pointer;
+    min-height: var(--pod-nav-menu-item-height, 40px); padding: var(--pod-nav-menu-item-padding, 8px 12px);
+    border: var(--pod-nav-menu-item-border, none); border-radius: var(--pod-nav-menu-item-radius, 8px); background: transparent;
+    color: var(--pod-nav-item-text-color, var(--color-text1-4, #1f2329)); font: inherit; font-size: var(--pod-nav-menu-font-size, 14px); line-height: var(--pod-nav-menu-line-height, 20px); text-decoration: none; text-align: start; cursor: pointer;
   }
-  .oy-canvas-nav .oy-nav-item:hover:not(:disabled) { background: var(--pod-nav-menu-bg-hover-color, var(--color-fill1-2, #f2f3f5)); color: var(--pod-nav-item-text-hover-color, inherit); }
-  .oy-canvas-nav .oy-nav-item[aria-current="page"] { background: var(--pod-nav-menu-bg-selected-color, var(--color-brand1-1, #e8f2ff)); color: var(--pod-nav-item-text-selected-color, var(--color-brand1-6, #1677ff)); font-weight: var(--pod-nav-menu-item-selected-font-weight, 600); }
+  .oy-canvas-nav .oy-nav-item:hover:not(:disabled) { border: var(--pod-nav-menu-item-hover-border, var(--pod-nav-menu-item-border, none)); background: var(--pod-nav-menu-bg-hover-color, var(--color-fill1-2, #f2f3f5)); color: var(--pod-nav-item-text-hover-color, inherit); }
+  .oy-canvas-nav .oy-nav-item[aria-current="page"], .oy-canvas-nav .oy-nav-item[aria-current="page"]:hover { border: var(--pod-nav-menu-item-selected-border, var(--pod-nav-menu-item-border, none)); box-shadow: var(--pod-nav-menu-item-selected-shadow, none); background: var(--pod-nav-menu-bg-selected-color, var(--color-brand1-1, #e8f2ff)); color: var(--pod-nav-item-text-selected-color, var(--color-brand1-6, #1677ff)); font-weight: var(--pod-nav-menu-item-selected-font-weight, 600); }
   .oy-canvas-nav .oy-nav-item:disabled { color: var(--pod-nav-item-text-disabled-color, var(--color-text1-1, #999)); cursor: not-allowed; }
   .oy-canvas-nav .oy-nav-item:focus-visible { outline: 2px solid var(--pod-nav-tab-line-selected-color, var(--color-brand1-6, #1677ff)); outline-offset: -2px; }
   .oy-canvas-nav .oy-nav-item svg { flex-shrink: 0; width: var(--pod-nav-platform-action-icon-size, 18px); height: var(--pod-nav-platform-action-icon-size, 18px); }

package/lib/samples/openyida-scaffold/canvas-nav/side.jsx

@@ -5,8 +5,7 @@ function CanvasNav({ items = [], activeKey, onSelect, title, logo, actions, chil
       .oy-nav-side { display: flex; }
       .oy-nav-side .oy-nav-content { flex: 1; }
       .oy-nav-side .oy-nav-brand { min-height: var(--pod-nav-platform-header-height, 48px); }
-      .oy-nav-side .oy-nav-menu { display: flex; flex-direction: column; gap: var(--pod-nav-slide-aside-gap, 12px); }
-      .oy-nav-side .oy-nav-item[aria-current="page"] { box-shadow: inset 3px 0 var(--pod-nav-tab-line-selected-color, var(--color-brand1-6, #1677ff)); }
+      .oy-nav-side .oy-nav-menu { display: flex; flex-direction: column; gap: var(--pod-nav-menu-gap, 8px); }
       @media (max-width: 767px) { .oy-nav-side { display: block; } }
     `}</style>
     <CanvasSidebar title={title} logo={logo} actions={actions} activeKey={activeKey} defaultWidth={sidebarWidth} defaultCollapsed={defaultCollapsed}>

package/lib/samples/openyida-scaffold/canvas-nav/sidebar.jsx

@@ -41,7 +41,7 @@ function CanvasSidebar({ children, title, logo, actions, activeKey, defaultWidth
     onClick={event => { if (mobile && event.target.closest('.oy-nav-menu .oy-nav-item')) setMobileOpen(false); }}
     style={{ '--oy-sidebar-width': width === null ? (typeof defaultWidth === 'number' ? `${defaultWidth}px` : defaultWidth) : `${clamp(width)}px`, '--oy-sidebar-max-width': `${maxWidth}px` }}>
     <style>{`
-      .oy-canvas-nav .oy-nav-sidebar { position: relative; box-sizing: border-box; flex: 0 0 auto; min-width: 0; width: clamp(180px, var(--oy-sidebar-width, var(--shell-dark-aside-width, 216px)), var(--oy-sidebar-max-width, 400px)); padding: var(--pod-nav-l-aside-padding, 8px); border-right: 1px solid var(--pod-nav-sub-divider-color, var(--color-line1-1, #ddd)); }
+      .oy-canvas-nav .oy-nav-sidebar { position: relative; box-sizing: border-box; flex: 0 0 auto; min-width: 0; width: clamp(180px, var(--oy-sidebar-width, var(--shell-dark-aside-width, 216px)), var(--oy-sidebar-max-width, 400px)); padding: var(--pod-nav-slide-aside-padding, 8px); border-right: 1px solid var(--pod-nav-sub-divider-color, var(--color-line1-1, #ddd)); }
       .oy-canvas-nav .oy-sidebar-toggle { margin-left: auto; flex-shrink: 0; justify-content: center; padding: 0 8px; }
       .oy-canvas-nav .oy-sidebar-items { min-width: 0; }
       .oy-canvas-nav .oy-nav-sidebar .oy-nav-item > span { overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }

package/lib/samples/openyida-scaffold/canvas-nav/top.jsx

@@ -7,16 +7,17 @@ function CanvasNav({ items = [], activeKey, onSelect, title, logo, actions, chil
   React.useEffect(() => setExpanded(false), [activeKey]);
   return <div className={'oy-canvas-nav oy-nav-top' + (floating ? ' is-floating' : '') + (headerOnly ? ' is-header-only' : '') + (overlay ? ' is-overlay' : '')}>
     <style>{CANVAS_NAV_CSS + `
-      .oy-nav-top .oy-nav-header { display: flex; flex-wrap: wrap; align-items: center; gap: var(--pod-nav-top-header-gap, 24px); padding: var(--pod-nav-top-header-padding, 8px 16px); border-bottom: 1px solid var(--pod-nav-sub-divider-color, var(--color-line1-1, #ddd)); }
+      .oy-nav-top .oy-nav-header { box-sizing: border-box; min-height: var(--pod-nav-platform-header-height, 48px); display: flex; flex-wrap: wrap; align-items: center; gap: var(--pod-nav-top-header-gap, 24px); padding: var(--pod-nav-top-header-padding, 8px 16px); border-bottom: 1px solid var(--pod-nav-sub-divider-color, var(--color-line1-1, #ddd)); }
       .oy-nav-top.is-header-only { min-height: 0; background: transparent; }
       .openyida-nav-layout[data-layout="document"][data-scrolled="false"] .oy-nav-top.is-overlay .oy-nav-header:not(.is-expanded) { background: transparent; color: var(--openyida-navigation-overlay-color, #fff); border-color: transparent; }
       .openyida-nav-layout[data-layout="document"][data-scrolled="false"] .oy-nav-top.is-overlay .oy-nav-header:not(.is-expanded) .oy-nav-brand,
       .openyida-nav-layout[data-layout="document"][data-scrolled="false"] .oy-nav-top.is-overlay .oy-nav-header:not(.is-expanded) .oy-nav-item:not(:disabled) { color: inherit; }
       .openyida-nav-layout[data-layout="document"][data-scrolled="false"] .oy-nav-top.is-overlay .oy-nav-header:not(.is-expanded) .oy-nav-item:is(:hover,[aria-current="page"]):not(:disabled) { background: var(--openyida-navigation-overlay-active-bg, rgba(255,255,255,.16)); }
       .oy-nav-top.is-floating { padding-top: 16px; box-sizing: border-box; }
-      .oy-nav-top.is-floating .oy-nav-header { position: sticky; top: 16px; z-index: 10; margin: 0 16px; border: 1px solid var(--pod-nav-sub-divider-color, var(--color-line1-1, #ddd)); border-radius: var(--pod-nav-menu-container-radius, 16px); box-shadow: var(--pod-nav-popup-shadow, 0 8px 24px rgba(0,0,0,.12)); }
-      .oy-nav-top .oy-nav-menu { display: flex; flex: 1; min-width: 0; overflow-x: auto; }
-      .oy-nav-top .oy-nav-item[aria-current="page"] { box-shadow: inset 0 -2px var(--pod-nav-tab-line-selected-color, var(--color-brand1-6, #1677ff)); }
+      .oy-nav-top.is-floating .oy-nav-header { position: sticky; top: 16px; z-index: 10; margin: 0 16px; border: 1px solid var(--pod-nav-sub-divider-color, var(--color-line1-1, #ddd)); border-radius: var(--pod-shell-lshape-border-radius, 16px); box-shadow: var(--pod-nav-popup-shadow, 0 8px 24px rgba(0,0,0,.12)); }
+      .oy-nav-top .oy-nav-menu { display: flex; flex: 1; min-width: 0; gap: var(--pod-nav-menu-gap, 8px); padding: calc(var(--pod-nav-menu-gap, 8px) / 2); overflow-x: auto; }
+      .oy-nav-top .oy-nav-menu .oy-nav-item { min-height: var(--pod-nav-top-tab-height, 40px); padding: var(--pod-nav-top-tab-item-padding, 0 12px); max-width: var(--pod-nav-top-tab-item-max-width, 240px); }
+      .oy-nav-top .oy-nav-menu .oy-nav-item > span { overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
       .oy-nav-top .oy-nav-toggle { display: none; margin-left: auto; }
       @media (max-width: 767px) {
         .oy-nav-top .oy-nav-header { gap: var(--pod-nav-logo-gap, 8px); }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openyida",
-  "version": "2026.9.20",
+  "version": "2026.9.21",
   "description": "OpenYida CLI - 宜搭低代码 AI 开发工具（安装即用，零配置）",
   "bin": {
     "openyida": "bin/yida.js",

package/yida-skills/SKILL.md

@@ -195,9 +195,9 @@ description: >
 - 不把 OpenYida 业务中间文件写到仓库根目录或系统临时目录。
 
 20. **报表和可视化先分流**：标准统计与原生报表用 `yida-report`；定制图表页面默认用 `yida-rechart`；只有明确 ECharts、维护旧 ECharts 页面或复杂 option 超出 Recharts 能力时用 `yida-chart`。
-21. **应用主题只有一份**：涉及应用蓝图、页面视觉、应用主题色、品牌色、全局换肤或 `--color-brand1-*` 时先读 `yida-design`。`app-theme.css` 只在应用级统一配置，由平台作用于应用壳、原生表单、详情页和自定义页面外层。严禁在页面级重复写入、同步或向上层注入主题样式；`YidaCodeCanvas` 源码只在 `YidaComp` 内消费现有主题 token。
+21. **应用主题只有一份**：涉及应用蓝图、页面视觉、应用主题色、品牌色、全局换肤或 `--color-brand1-*` 时先读 `yida-design`。导航、应用框架、提交/编辑表单、记录详情和自定义页面按[整体主题规则](skills/yida-design/references/application-theme-consistency.md#导航与应用框架)一起设计。`app-theme.css` 只在应用级统一配置，各类页面消费同一份主题 token。严禁在页面级重复写入、同步或向上层注入主题样式；`YidaCodeCanvas` 源码只在 `YidaComp` 内消费现有主题 token。
 22. **默认完成即停止**：完整应用默认以资源发布成功、轻量导航排序完成、示例数据就绪并输出一组有明确名称的应用入口与业务交付总结为 doneWhen；截图、精细导航整理和额外深读属于 optionalAfterDone，除非用户明确要求。
-23. **说清楚做什么**：对话、任务列表、步骤标题、进度和提问面向非技术用户。用日常用语和短句，一句话说一件事，先说结果或动作，再补必要原因。功能写谁能做什么；进度写当前动作和下一步；失败写问题、影响和处理办法；待核实的结果如实说明。文件名、路径、技能名和调用方式留在内部执行。PRD 业务说明、HTML 和消息使用功能与体验描述；接口参数、配置键值及内部 ID 留在 Agent 实施交接，遵循[用户可见表达契约](skills/yida-design/references/ask-human-interaction-contract.md)。交付卡片的 `description` 写 2-3 句业务交付总结、核验结果与剩余事项，卡片包含一组“应用访问入口”；宿主没有交付工具时，在最终回复中给出相同内容。不得把需求信息文件、PRD、视觉设计、build manifest、资源清单、Schema 或每个表单/流程/报表分别登记成用户可见交付物；含统一工作区或业务管理范围时给工作台入口，前台页面经 PRD 标记为 `standalone` 且导航配置回读通过时给独立业务入口；完整应用默认再提供开发者管理后台 `adminUrl`，不因云端登录方式省略；明确仅前台时不追加业务后台，仍交付前台与开发者管理后台两个地址。有前后台时交付前台、业务后台、开发者管理后台三个地址；统一工作区交付工作台与开发者管理后台。用户明确排除的入口和单页任务范围优先。
+23. **说清楚做什么**：对话、任务列表、步骤标题、进度和提问面向非技术用户。用日常用语和短句，一句话说一件事，先说结果或动作，再补必要原因。功能写谁能做什么；进度写当前动作和下一步；失败写问题、影响和处理办法；待核实的结果如实说明。文件名、路径、技能名和调用方式留在内部执行。PRD 业务说明、HTML 和消息使用功能与体验描述；接口参数、配置键值及内部 ID 留在 Agent 实施交接，遵循[用户可见表达契约](skills/yida-design/references/ask-human-interaction-contract.md)。交付卡片的 `description` 写 2-3 句业务交付总结、核验结果与剩余事项，卡片包含一组“应用访问入口”；宿主没有交付工具时，在最终回复中给出相同内容。不得把需求信息文件、PRD、视觉设计、build manifest、资源清单、Schema 或每个表单/流程/报表分别登记成用户可见交付物；不分前后台或包含业务后台时，给出经验证的业务页面入口，前台页面经 PRD 标记为 `standalone` 且导航配置回读通过时给独立业务入口；完整应用默认再提供开发者管理后台 `adminUrl`，不因云端登录方式省略；明确仅业务后台时交付业务后台与开发者管理后台，不追加前台；明确仅前台时不追加业务后台，仍交付前台与开发者管理后台两个地址。有前后台时交付前台、业务后台、开发者管理后台三个地址；不分前后台时交付系统入口与开发者管理后台。用户明确排除的入口和单页任务范围优先。
 24. **任务复盘沉淀**：用户多次纠正、平台接口假成功、页面骨架共性质量问题、线上回读验收方法、一次性脚本可产品化等情况，完成前判断是否需要沉淀到 CLI、测试或 skill。
 
 常见问题见 [常见问题解决方案](references/execution-rules.md)。

package/yida-skills/references/yida-api.md

@@ -192,6 +192,10 @@ this.utils.yida.saveFormData({
 });
 ```
 
+> ⚠️ **匿名态限制**：该 API 与 `window.__OPENYIDA_YIDA_API__.saveFormData` 依赖登录态。页面运行在公开链接 `/o/...`（`FREELOGIN` / `loginUser.userId === 'FREEUSER'`）时，即使桥对象存在，调用 `saveFormData` 仍会返回 `LOGIN FAILED`；必须优先改走 `window.pageConfig.RECEIPT_SAVE_FORM_DATA` 网关，并同时满足显示页 `isOpen === 'y'`、目标表单 `isOpen === 'y'`、目标表单 DEFAULT 权限包含 `FREE_LOGIN` 三项门禁。
+>
+> 匿名网关使用 `POST application/x-www-form-urlencoded` 和 `X-Requested-With: XMLHttpRequest`，CSRF 优先读取 `window.g_config._csrf_token` 并作为 `_csrf_token` 参数传递。`value` 必须是字段数组，每项使用 `{ componentName, fieldId, fieldData: { value } }`；`componentName` 从目标表单 Schema 获取，标准名称见[字段定义 JSON 指南](../skills/yida-create-form-page/references/field-definition-guide.md#支持的字段类型)，`fieldData.value` 的值结构见[数据格式指南](../skills/yida-data-management/references/data-format-guide.md#常见字段值格式)。这些通用字段文档不代表对应组件均支持匿名提交；匿名能力边界以公开页面实际限制和实例回读为准。不得把字段 ID 放进 `fieldData`；网关返回 `success: true` 和 `formInstId` 仍可能创建空记录，验收必须按该实例 ID 回读代表性字段值。完整分流和请求契约见 [`yida-canvas-custom-page/references/data-bridge-guide.md`](../skills/yida-canvas-custom-page/references/data-bridge-guide.md) 的"公开访问（匿名态）提交"章节。
+
 ---
 
 ### updateFormData

package/yida-skills/skills/yida-app/SKILL.md

@@ -7,15 +7,23 @@ description: 创建完整宜搭应用，或补齐已有应用时使用。先确
 
 完整应用编排技能。它负责把一次“创建/搭建/补齐应用”的需求拆成资源解析、产品设计、资源落地、页面发布和结果输出。全局 CLI、ID、存储、发布和输出规则以主入口 `SKILL.md` 为准；按步骤执行该步骤所需 `use_skill(...)`。
 
-完整应用交付默认保留开发者管理后台（CLI `adminUrl`），与业务后台区分：有前后台时共三个地址；仅前台或统一工作区时共两个地址。登录态来源不影响 `/admin` 的交付；单页任务保持单页范围，用户明确排除的入口优先。详见 Step 9。
+完整应用交付默认保留开发者管理后台（CLI `adminUrl`），与业务后台区分：有前后台时共三个地址；仅前台、仅业务后台或不分前后台时共两个地址。登录态来源不影响 `/admin` 的交付；单页任务保持单页范围，用户明确排除的入口优先。详见 Step 9。
 
 ## 模式入口（先按这里路由）
 
 首次需求澄清优先进入 Step 2 的 2.0；首问前不执行 Step 1 的环境和资源预检，已有明确资源引用作为需求上下文保留。澄清完成后再按需核验资源、补齐规划输入。
 
-`intake.designMode` 沿用用户最后一次明确选择，其他问题的回答只更新对应字段。Plan 收到与当前 revision 匹配的 `confirm_build` 后进入资源实施；选择 `continue_editing` 时修改当前计划，生成新 revision 后再确认。素材进度同步保留已有确认。
+已有任务先按 [续做与恢复](#续做与恢复) 定位当前阶段。
 
-Plan 模式只读取 `workflow/step-1-resource-context.md`、`workflow/step-2-design.md` 和精确路径 `workflow/plan/workflow.md`；后者已经包含完整 Plan 入口。禁止用 Glob 查找 Plan 文件，也不要额外读取 `workflow/plan/step-1-understand.md` 或 `workflow/plan/step-2-confirm.md`。Plan 确认恢复后，若 `explicitScope.allowInferredResources=false`，直接读取 `workflow/step-4-forms-processes.md` 实施范围内资源，不再重读 Step 1、调用 list-forms 或做应用设置预检。
+需求确认不能替代当前 Plan revision 的批准或工具权限确认。`intake.designMode` 沿用用户最后一次明确选择，其他问题的回答只更新对应字段。Plan 收到与当前 revision 匹配的 `confirm_build` 后进入资源实施；选择 `continue_editing` 时修改当前计划，生成新 revision 后再确认。素材进度更新不改变已有的需求确认和模式选择。
+
+Plan 规划阶段的工作流入口只读取 `workflow/step-1-resource-context.md`、`workflow/step-2-design.md` 和精确路径 `workflow/plan/workflow.md`；后者已经包含完整 Plan 入口。禁止用 Glob 查找 Plan 文件，也不要额外读取 `workflow/plan/step-1-understand.md` 或 `workflow/plan/step-2-confirm.md`。此读取范围不限制确认后的实施、验收和交付，各阶段按需读取对应 workflow。Plan 确认恢复后，若 `explicitScope.allowInferredResources=false`，直接读取 `workflow/step-4-forms-processes.md` 实施范围内资源，不再重读 Step 1、调用 list-forms 或做应用设置预检。
+
+## 续做与恢复
+
+先判断本轮是否已有有效需求确认：历史回答或同任务 `intake.confirmed=true` 覆盖当前范围且未被撤回时，复用答案、PRD、设计和资源回执，从未完成阶段继续。刷新、恢复、压缩或用户说“继续”不触发重新首问；仅应用已存在也不代表需求已确认。状态不明时先只读核对当前任务材料；范围变更、材料缺失或冲突按 [需求分析的适用阶段与续做](../yida-requirement-analysis/workflow/prepare-brief.md#适用阶段与续做) 处理。
+
+已发布但尚未完成本轮导航、验收或交付时，按缺项进入 [Step 8](workflow/step-8-publish-navigation.md) 或 [Step 9](workflow/step-9-output-finish.md)，不返回需求首问。发布成功回执不能替代实际验收。
 
 ## 执行步骤（进行时展示给用户）
 
@@ -86,7 +94,7 @@ Plan 模式只读取 `workflow/step-1-resource-context.md`、`workflow/step-2-de
 
 1. **资源判断以 Step 1 为准**：已有 app/page/form/process 默认复用；只有用户明确从零创建，或目标缺失且本轮允许创建时，才创建缺失资源。
 2. **显式目标优先**：本轮用户给出的 `appType`、`formUuid`、URL、页面名或流程标识，优先级高于绑定上下文和历史缓存；同级冲突或无法唯一识别时才问用户。
-3. **产品与视觉分工**：`yida-requirement-analysis` 先统一整理用户需求；业务目标、资源蓝图、页面结构、导航顺序和验收标准由 `yida-prd` 写入 `prd.md`；主题 token、布局、材质、圆角、密度、组件和状态规则由 `yida-design` 写入 `design.md`。两份文件校验通过前不得创建资源。
+3. **产品与视觉分工**：`yida-requirement-analysis` 先统一整理用户需求；业务目标、资源蓝图、页面结构、导航顺序和验收标准由 `yida-prd` 写入 `prd.md`；`yida-design` 将导航、应用框架、表单、详情和自定义页面的主题 token、布局、材质、形状、密度与状态规则写入 `design.md`。两份文件校验通过前不得创建资源。
 4. **阶段技能按需加载**：进入应用壳、表单、流程、页面、发布、数据写入等阶段时，才执行对应 `use_skill(...)`。
 5. **真实 ID 和真实数据**：不编造 `appType`、`formUuid`、`fieldId`、`processCode`、`reportId`。无显式窄范围的完整应用默认给核心普通表单写入 1-3 条业务化 seed records 并 query 抽查；`explicitScope.allowInferredResources=false` 时不得增加未点名的 seed records 或页面。
 6. **自定义页面开发技能固定**：完整应用页面源码按 Step 7 执行；管理端仅需原生视图时不创建 display 首页。前后台按 [访问态入口契约](references/entry-navigation.md) 分别规划菜单及分组顺序、默认页面、首屏任务和权限；平台导航与自定义导航都要落实排序并验收。