openyida 2026.9.2 → 2026.9.3

package/lib/core/locales/zh.js

@@ -32,6 +32,7 @@ module.exports = {
     cmd_import: '导入迁移包，重建应用',
     group_form: '表单 & 页面',
     cmd_create_form: '创建表单页面',
+    cmd_list_form_icons: '列出可用的表单导航图标',
     cmd_validate_form: '本地校验表单字段 JSON',
     cmd_update_form: '更新表单页面',
     cmd_list_forms: '列出应用下的表单/页面',
@@ -102,7 +103,7 @@ module.exports = {
     cmd_a2a: '启动本地只读 A2A Adapter 或输出 Agent Card',
     cmd_bridge: '启动 OpenYida 本地网页桥接服务',
     cmd_copy: '复制 project 工作目录',
-    cmd_sample: '输出代码示例/骨架',
+    cmd_sample: '输出代码模板',
     cmd_doctor: '环境诊断与自动修复',
     cmd_db_seq_fix: 'PostgreSQL Sequence 漂移检测与修复',
     cmd_formula_evaluate: '静态检查宜搭公式语法和字段引用',
@@ -112,7 +113,7 @@ module.exports = {
     cmd_batch: '批量执行 OpenYida 命令',
     cmd_flash_to_prd: '闪记 / 会议纪要转 PRD prompt',
     cmd_ai: '调用 AI 文生文和识图能力',
-    cmd_asset: '检测素材能力 / 校验图片 URL / 解析回填素材',
+    cmd_asset: '检测素材能力 / 解析回填素材',
     cmd_cdn: 'CDN 图片管理（配置/上传/刷新）',
     cmd_cdn_config: '配置 CDN / OSS 上传',
     cmd_cdn_upload: '上传图片到 CDN',
@@ -136,7 +137,7 @@ openyida - 宜搭命令行工具
   copy [--force]                                               复制 project 工作目录到当前 AI 工具环境
   login                                                        OAuth token 登录态管理
   logout                                                       退出登录 / 切换账号
-  create-app --name "<名称>" [--theme-file <css> 及导航布局选项] 创建应用；推荐导入新版主题，输出 appType
+  create-app --name "<名称>" [--theme-file <css> 及导航布局选项] 创建应用；推荐导入应用主题文件，输出 appType
   create-page <appType> "<页面名>" [--mode dashboard] [--hide-nav] 创建自定义页面，输出 pageId
   update-app <appType> [--name "..."] [--hide-app-nav|--show-app-nav] 更新应用信息
   create-form create <appType> "<表单名>" <字段JSON> [--layout <布局>] [--theme <主题>] [--label-align <对齐>]  创建表单页面
@@ -1802,6 +1803,8 @@ openyida - 宜搭命令行工具
 };
 
 Object.assign(module.exports.query_data || (module.exports.query_data = {}), {
+  association_derived_field_read_only: '关联表单查询派生字段 {0} 只读，不能用于保存或更新。请写入不带 _id 后缀的原始关联表单字段。',
+  association_value_invalid: '关联表单字段 {0} 的写入值无效。必须使用对象数组，每项完整包含 appType、formUuid、formType、instanceId 和 title。',
   command_unsupported: '不支持的数据命令：{0} {1}。请使用 openyida commands --json 查询真实能力。',
   delete_confirmation_required: '删除表单实例前必须先查询并向用户展示目标摘要，获得明确确认后追加 --confirm。未执行删除。',
   delete_preflight_failed: '无法读取表单实例 {0} 完成删除前校验，未执行删除。',
@@ -1810,6 +1813,7 @@ Object.assign(module.exports.query_data || (module.exports.query_data = {}), {
   delete_result_unknown: '表单实例 {0} 的删除结果未知。请只读回查目标，不要自动重试删除。',
   delete_target_mismatch: '表单实例 {0} 不属于目标表单 {1}，已停止且未执行删除。',
   delete_target_unverified: '无法验证表单实例 {0} 的身份和归属，已停止且未执行删除。',
+  field_reference_unknown: '字段引用 {0} 不是当前表单的真实 fieldId 或组件别名，已在写入前停止。',
   form_mode_unverified: '无法验证表单 {0} 的类型，已停止创建；未执行任何数据写入。',
   instance_target_mismatch: '实例 {0} 不属于期望的业务资源 {1}，已在写入前停止。',
   instance_target_unverified: '无法验证实例 {0} 的业务资源归属，已在写入前停止。',

package/lib/core/query-data.js

@@ -334,6 +334,90 @@ function isPlainObject(value) {
   return Object.prototype.toString.call(value) === '[object Object]';
 }
 
+const ASSOCIATION_FORM_FIELD_PREFIX = 'associationFormField_';
+const ASSOCIATION_FORM_DERIVED_ID_RE = /^associationFormField_.+_id$/;
+const ASSOCIATION_FORM_REQUIRED_KEYS = [
+  'appType',
+  'formUuid',
+  'formType',
+  'instanceId',
+  'title',
+];
+
+function isAssociationFormField(fieldId, aliasContext) {
+  const fieldInfo = aliasContext && aliasContext.fieldInfoById[fieldId];
+  return fieldId.startsWith(ASSOCIATION_FORM_FIELD_PREFIX)
+    || (fieldInfo && fieldInfo.componentName === 'AssociationFormField');
+}
+
+function throwAssociationFormValueInvalid(fieldId, index, reason, missingFields = []) {
+  dataError(
+    'DATA_ASSOCIATION_FORM_VALUE_INVALID',
+    t('query_data.association_value_invalid', fieldId),
+    {
+      fieldId,
+      index,
+      reason,
+      missingFields,
+      retryable: false,
+      retrySafe: true,
+      sideEffectState: 'none',
+      nextStep: 'provide_complete_association_form_value',
+    }
+  );
+}
+
+function normalizeAssociationFormFields(data, aliasContext) {
+  if (!isPlainObject(data)) {
+    return data;
+  }
+
+  const normalized = {};
+  Object.entries(data).forEach(([fieldId, value]) => {
+    if (ASSOCIATION_FORM_DERIVED_ID_RE.test(fieldId)) {
+      dataError(
+        'DATA_ASSOCIATION_FORM_DERIVED_FIELD_READ_ONLY',
+        t('query_data.association_derived_field_read_only', fieldId),
+        {
+          fieldId,
+          retryable: false,
+          retrySafe: true,
+          sideEffectState: 'none',
+          nextStep: 'write_the_source_association_form_field',
+        }
+      );
+    }
+
+    if (!isAssociationFormField(fieldId, aliasContext)) {
+      normalized[fieldId] = value;
+      return;
+    }
+    if (!Array.isArray(value)) {
+      throwAssociationFormValueInvalid(fieldId, null, 'value_must_be_array');
+    }
+
+    normalized[fieldId] = value.map((item, index) => {
+      if (!isPlainObject(item)) {
+        throwAssociationFormValueInvalid(fieldId, index, 'item_must_be_object');
+      }
+      const missingFields = ASSOCIATION_FORM_REQUIRED_KEYS.filter((key) => (
+        typeof item[key] !== 'string' || item[key].trim() === ''
+      ));
+      if (missingFields.length > 0) {
+        throwAssociationFormValueInvalid(fieldId, index, 'required_fields_missing', missingFields);
+      }
+      if (item.subTitle !== undefined && typeof item.subTitle !== 'string') {
+        throwAssociationFormValueInvalid(fieldId, index, 'subtitle_must_be_string');
+      }
+      return {
+        ...item,
+        subTitle: item.subTitle === undefined ? '' : item.subTitle,
+      };
+    });
+  });
+  return normalized;
+}
+
 function buildFieldInfoById(schemaResult) {
   const fieldInfoById = {};
   const pages = schemaResult && schemaResult.content && schemaResult.content.pages;
@@ -373,6 +457,8 @@ async function fetchFormAliasContext(session, appType, formUuid) {
   return {
     ...buildComponentAliasMaps(result),
     fieldInfoById: buildFieldInfoById(result),
+    appType,
+    formUuid,
   };
 }
 
@@ -393,6 +479,24 @@ function resolveFieldRef(value, aliasContext) {
   return aliasContext.fieldIdByAlias[value] || value;
 }
 
+function requireKnownDataFieldRef(value, aliasContext) {
+  const fieldId = resolveFieldRef(value, aliasContext);
+  if (!aliasContext || aliasContext.fieldInfoById[fieldId]) {
+    return fieldId;
+  }
+  dataError(
+    'DATA_FIELD_REFERENCE_UNKNOWN',
+    t('query_data.field_reference_unknown', value),
+    {
+      fieldRef: value,
+      retryable: false,
+      retrySafe: true,
+      sideEffectState: 'none',
+      nextStep: `openyida get-schema ${aliasContext.appType} ${aliasContext.formUuid} --field-map-json`,
+    }
+  );
+}
+
 function translateSubformRows(value, aliasContext) {
   if (!Array.isArray(value)) {
     return value;
@@ -411,7 +515,7 @@ function translateFormDataObject(data, aliasContext) {
   }
   const translated = {};
   Object.entries(data).forEach(([key, value]) => {
-    const fieldId = resolveFieldRef(key, aliasContext);
+    const fieldId = requireKnownDataFieldRef(key, aliasContext);
     const fieldInfo = aliasContext && aliasContext.fieldInfoById[fieldId];
     translated[fieldId] = fieldInfo && fieldInfo.componentName === 'TableField'
       ? translateSubformRows(value, aliasContext)
@@ -444,12 +548,26 @@ function translateJsonWithAliases(jsonValue, aliasContext, translator) {
   if (!aliasContext || !jsonValue) {
     return jsonValue;
   }
+  let parsed;
   try {
-    return JSON.stringify(translator(JSON.parse(jsonValue), aliasContext));
+    parsed = JSON.parse(jsonValue);
   } catch (err) {
     parseError(`--resolve-aliases 只能处理合法 JSON：${err.message}`);
   }
-  return jsonValue;
+  return JSON.stringify(translator(parsed, aliasContext));
+}
+
+function prepareFormMutationJson(jsonValue, aliasContext) {
+  let data;
+  try {
+    data = JSON.parse(jsonValue);
+  } catch (err) {
+    parseError(`--data-json 只能处理合法 JSON：${err.message}`);
+  }
+  const translated = aliasContext
+    ? translateFormDataObject(data, aliasContext)
+    : data;
+  return JSON.stringify(normalizeAssociationFormFields(translated, aliasContext));
 }
 
 /**
@@ -923,7 +1041,7 @@ async function createForm(positionals, options, session) {
   const params = {
     appType,
     formUuid,
-    formDataJson: translateJsonWithAliases(dataJson, aliasContext, translateFormDataObject),
+    formDataJson: prepareFormMutationJson(dataJson, aliasContext),
   };
   if (options.dept_id) {params.deptId = options.dept_id;}
 
@@ -964,7 +1082,7 @@ async function updateForm(positionals, options, session) {
   const aliasContext = await resolveAliasContextIfNeeded(session, appType, options.form_uuid, options, dataJson);
   const params = {
     formInstId: options.inst_id,
-    updateFormDataJson: translateJsonWithAliases(dataJson, aliasContext, translateFormDataObject),
+    updateFormDataJson: prepareFormMutationJson(dataJson, aliasContext),
   };
   if (options.use_latest_version) {params.useLatestVersion = options.use_latest_version;}
   printResult(await sendPostOnce(session, appType, `/dingtalk/web/${appType}/v1/form/updateFormData.json`, params));
@@ -1233,7 +1351,7 @@ async function createProcess(positionals, options, session) {
   const params = {
     processCode: options.process_code,
     formUuid,
-    formDataJson: translateJsonWithAliases(dataJson, aliasContext, translateFormDataObject),
+    formDataJson: prepareFormMutationJson(dataJson, aliasContext),
   };
   if (options.dept_id) {params.deptId = options.dept_id;}
   printCreateResult(
@@ -1259,7 +1377,7 @@ async function updateProcess(positionals, options, session) {
   const aliasContext = await resolveAliasContextIfNeeded(session, appType, options.form_uuid, options, dataJson);
   printResult(await sendPostOnce(session, appType, `/dingtalk/web/${appType}/v1/process/updateInstance.json`, {
     processInstanceId: options.process_inst_id,
-    updateFormDataJson: translateJsonWithAliases(dataJson, aliasContext, translateFormDataObject),
+    updateFormDataJson: prepareFormMutationJson(dataJson, aliasContext),
   }));
 }
 
@@ -1294,7 +1412,7 @@ async function executeTask(positionals, options, session) {
   };
   const dataJson = readJsonOption(options, 'data_json', 'data_file', '数据');
   const aliasContext = await resolveAliasContextIfNeeded(session, appType, options.form_uuid, options, dataJson);
-  if (dataJson) {params.formDataJson = translateJsonWithAliases(dataJson, aliasContext, translateFormDataObject);}
+  if (dataJson) {params.formDataJson = prepareFormMutationJson(dataJson, aliasContext);}
   if (options.no_execute_expressions) {params.noExecuteExpressions = options.no_execute_expressions;}
   printResult(await sendPostOnce(session, appType, `/dingtalk/web/${appType}/v1/task/executeTask.json`, params));
 }

package/lib/core/sample.js

@@ -44,25 +44,60 @@ const SAMPLES = {
   'yida-canvas-table-form': {
     'table-form-batch-submit': 'table-form-batch-submit.canvas.jsx',
   },
-  'openyida-scaffold': {
+  'openyida-page-template': {
     'form-fields': 'form-fields.json',
     'canvas-form-drawer': 'canvas-form-drawer.canvas.jsx',
   },
+  'yida-design': {
+    'app-theme': 'app-custom-theme-template.css',
+  },
   'yida-table-form': {
     'table-form-batch-submit': 'table-form-batch-submit.js',
   },
 };
 
+const SAMPLE_SOURCE_DIRECTORIES = {
+  'openyida-page-template': 'openyida-scaffold',
+};
+
+const SAMPLE_SOURCE_FILES = {
+  'yida-design/app-theme': path.join(
+    __dirname,
+    '..',
+    '..',
+    'yida-skills',
+    'skills',
+    'yida-design',
+    'references',
+    'theme',
+    'app-custom-theme-template.css'
+  ),
+};
+
+const SAMPLE_OUTPUT_FILENAMES = {
+  'yida-design/app-theme': 'app-theme.css',
+};
+
+const SAMPLE_HINTS = {
+  'yida-design/app-theme': '已复制应用主题模板；请由 yida-design 按 design.md 定点修改需要变化的 token。',
+};
+
 // ── 工具函数 ──────────────────────────────────────────────────────────
 
 /**
  * 解析 sample 文件在 npm 包中的绝对路径
  * @param {string} skill
+ * @param {string} name
  * @param {string} filename
  * @returns {string}
  */
-function resolveSampleSourcePath(skill, filename) {
-  return path.join(__dirname, '..', 'samples', skill, filename);
+function resolveSampleSourcePath(skill, name, filename) {
+  const sourceFile = SAMPLE_SOURCE_FILES[`${skill}/${name}`];
+  if (sourceFile) {
+    return sourceFile;
+  }
+  const sourceDirectory = SAMPLE_SOURCE_DIRECTORIES[skill] || skill;
+  return path.join(__dirname, '..', 'samples', sourceDirectory, filename);
 }
 
 /**
@@ -175,23 +210,29 @@ async function run(args) {
   }
 
   // 解析源文件路径
-  const sourcePath = resolveSampleSourcePath(skill, filename);
+  const sampleKey = `${skill}/${name}`;
+  const sourcePath = resolveSampleSourcePath(skill, name, filename);
   if (!fs.existsSync(sourcePath)) {
     chalkError(`sample 文件不存在：${sourcePath}`, { hint: '请确认 openyida 已正确安装（npm install -g openyida@latest）' });
   }
 
   // 解析输出路径与模板变量
-  const defaultOutputPath = path.join(process.cwd(), '.cache', 'samples', filename);
+  const outputFilename = SAMPLE_OUTPUT_FILENAMES[sampleKey] || filename;
+  const defaultOutputPath = path.join(process.cwd(), '.cache', 'samples', outputFilename);
   const { outputPath, variables } = parseOptions(rest, defaultOutputPath);
 
   // 写入文件
   ensureDirectoryExists(outputPath);
-  const sourceContent = fs.readFileSync(sourcePath, 'utf-8');
-  const outputContent = applyTemplateVariables(sourceContent, variables);
-  fs.writeFileSync(outputPath, outputContent, 'utf-8');
+  if (Object.keys(variables).length === 0) {
+    fs.copyFileSync(sourcePath, outputPath);
+  } else {
+    const sourceContent = fs.readFileSync(sourcePath, 'utf-8');
+    const outputContent = applyTemplateVariables(sourceContent, variables);
+    fs.writeFileSync(outputPath, outputContent, 'utf-8');
+  }
 
-  chalkSuccess(`sample 已输出到：${c.cyan}${outputPath}${c.reset}`);
-  chalkHint('使用 read_file 读取该文件作为代码模板参考。可通过 --var KEY=VALUE 替换 {{KEY}} 模板变量。');
+  chalkSuccess(`模板文件已复制到：${c.cyan}${outputPath}${c.reset}`);
+  chalkHint(SAMPLE_HINTS[sampleKey] || '请读取文件并按当前业务需求修改；发布前移除模板标记、示例数据和占位文案。');
 }
 
 module.exports = { run, applyTemplateVariables, parseOptions };

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

@@ -1,15 +1,15 @@
 /**
- * OpenYida Code Canvas 表单入口脚手架。
+ * @openyida-page-template-base
+ * OpenYida Code Canvas 表单入口基准模板。
  *
- * 使用方式：
- * openyida sample openyida-scaffold canvas-form-drawer --output project/pages/src/customer-entry.canvas.jsx --var APP_TYPE=APP_XXX --var FORM_UUID=FORM_XXX
+ * 内部生成流程必须先复制本文件，再按 PRD、design.md 和真实数据契约改写。
+ * 发布前必须删除本标记、示例数据和全部占位内容。
  *
  * 关键约定：
  * - PC 端新增和详情使用 FormOpenContainer 右侧抽屉 iframe。
  * - 移动端才整页进入原生提交页或详情页。
  * - 详情页必须先解析真实 formInstId，缺少实例 ID 时禁用入口。
  * - 预览行不携带伪造 formInstId，接入 searchFormDatas 真实 rows 后才启用详情。
- * - 提交页和详情页由新版主题运行时自行加载应用级自定义主题 CSS。
  */
 
 import React, { useMemo, useState } from 'react';
@@ -347,7 +347,7 @@ function YidaComp(props) {
               <Text type="secondary">原生表单负责提交和详情，自定义页负责列表、筛选与当前页面交互。</Text>
             </div>
             <Space wrap>
-              <Tag color={isBound ? 'success' : 'warning'}>{isBound ? '已绑定真实表单' : '脚手架预览'}</Tag>
+              <Tag color={isBound ? 'success' : 'warning'}>{isBound ? '数据源已配置' : '数据源待配置'}</Tag>
               <Tag>{rows.length} 条记录</Tag>
             </Space>
           </div>
@@ -357,8 +357,8 @@ function YidaComp(props) {
               type="warning"
               showIcon
               style={{ marginBottom: 12 }}
-              message="当前仍是脚手架占位资源"
-              description="请通过 --var APP_TYPE=... --var FORM_UUID=... 替换模板变量，或在运行时 props 中传入 appType、formUuid 和 rows。"
+              message="页面数据尚未配置"
+              description="请先完成应用与表单绑定，并接入真实业务数据。"
             />
           ) : null}
 

package/package.json

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

package/scripts/postinstall.js

@@ -285,9 +285,9 @@ openyida copy
 
 用户说“按默认方案 / 不要追问 / 直接创建 / 尽快搭建”时，加载 \`yida-app\` 走完整应用统一编排。
 
-统一编排只做：解析资源上下文 → \`yida-design\` 输出 \`prd.md\` 和 \`design.md\` → 创建/复用应用 → 核心表单/流程 → 主页面 → 编写主页面源码 → 发布 + 轻量导航排序 → 返回 2-3 句业务交付总结和一个主入口链接。资源创建顺序按 PRD 执行：应用先落位，表单/流程先于自定义页面。发布主页面成功后，PRD 写明导航顺序时执行 \`openyida nav-group order <appType> <页面/表单...>\`；PRD 只写宽泛分组或缺少导航顺序时，执行 \`openyida publish ... --auto-nav-order\` 或 \`openyida nav-group auto-order <appType>\` 兜底，兜底顺序为门户/首页/工作台入口、业务办理、数据管理、经营分析、系统配置。
+统一编排只做：解析资源上下文并生成共享需求简报 → 并行调用 \`yida-prd\` 输出 \`prd.md\`、\`yida-design\` 输出 \`design.md\` → 由 \`yida-app\` join 两份产物 → 创建/复用应用 → 核心表单/流程 → 主页面 → 编写主页面源码 → 发布 + 轻量导航排序 → 返回 2-3 句业务交付总结和一个主入口链接。资源创建顺序按 PRD 执行：应用先落位，表单/流程先于自定义页面。发布主页面成功后，PRD 写明导航顺序时执行 \`openyida nav-group order <appType> <页面/表单...>\`；PRD 只写宽泛分组或缺少导航顺序时，执行 \`openyida publish ... --auto-nav-order\` 或 \`openyida nav-group auto-order <appType>\` 兜底，兜底顺序为门户/首页/工作台入口、业务办理、数据管理、经营分析、系统配置。
 
-表单页开发默认加载 \`yida-form-detail\` 做表单视觉引导，并把 Divider 分割线语义分组合并进字段 JSON。运行容器在自定义页面、表单、提交页、详情页和 \`FormOpenContainer\` iframe 中加载同一应用级自定义主题 CSS，确保主题变量一致。
+应用主题只在应用级统一配置。严禁页面代码向原生表单、详情页、父页面或平台容器写入主题样式；\`YidaCodeCanvas\` 页面只在 \`YidaComp\` 内消费现有主题 token。字段结构统一交给 \`yida-create-form-page\`。
 
 完整应用页面源码默认不得使用 \`this.dataSourceMap.*\`，除非本轮已经明确创建并绑定设计器数据源；默认使用入口型页面或 \`this.utils.yida.*\` 查询已创建表单。
 
@@ -297,7 +297,7 @@ openyida copy
 
 使用 \`YidaCodeCanvas\` 组件实现的自定义页面统一直接写最终 \`.canvas.jsx\`：先读 PRD 的页面场景、业务区块、数据来源和主操作，再读 design.md 的主题、布局、材质、组件和状态规则，然后用 \`compileCanvasLocal\` 快检或 \`openyida publish\` 的编译阶段验证发布。\`openyida check-page\` / \`openyida compile\` 只用于历史平台 JSX 组件页面维护。
 
-完整应用需求分析和产品设计由 \`yida-design\` 承担，并输出两份文件：\`prd/<项目名>/prd.md\` 写业务目标、数据结构、页面与功能、资源顺序、导航顺序和验收标准；\`prd/<项目名>/design.md\` 写主题色、themeProfile、tokens、视觉系统、组件和状态规则。页面实现先读 PRD 的页面场景、页面区块、数据来源、主操作和表单入口，再读 design.md 的主题、布局、材质、组件和状态规则，然后交给 \`yida-canvas-custom-page\` 落地。只有已识别为历史平台 JSX 组件页面维护时，才由 \`yida-custom-page\` 自身闭环处理。
+完整应用先由 \`yida-requirement-analysis\` 生成共享需求简报，再并行执行两个独立 artifact：\`yida-prd\` 写 \`prd/<项目名>/prd.md\`，负责业务目标、数据结构、页面与功能、资源顺序、导航顺序和验收标准；\`yida-design\` 写 \`prd/<项目名>/design.md\`，负责主题色、themeProfile、tokens、视觉系统、组件和状态规则。\`yida-app\` 必须等待两份产物完成并通过 join 后才能创建业务资源。页面实现先读 PRD 的页面场景、页面区块、数据来源、主操作和表单入口，再读 design.md 的主题、布局、材质、组件和状态规则，然后交给 \`yida-canvas-custom-page\` 落地。只有已识别为历史平台 JSX 组件页面维护时，才由 \`yida-custom-page\` 自身闭环处理。
 
 默认只加载当前阶段必需技能；示例数据、精细导航分组、截图验收、公开访问、数据源深接、数据管理和原生报表只在用户明确要求或 PRD 验收标准命中时执行。发布后的轻量导航排序是统一编排默认收尾，不等于精细导航分组。
 
@@ -309,8 +309,8 @@ openyida copy
 | --- | --- | --- |
 | \`yida-skills/context\` | 登录、退出、组织信息、Schema、fieldId、只读预检 | \`yida-login\`, \`yida-logout\`, \`yida-basic-info\`, \`yida-get-schema\`, \`yida-corp-efficiency\` |
 | \`yida-skills/app\` | 从零搭应用、导航、多语言 | \`yida-app\`, \`yida-create-app\`, \`yida-nav-group\`, \`yida-i18n\` |
-| \`yida-skills/design\` | 完整应用产品设计、单页 UI 改造、主页面视觉设计、应用主题色、全局换肤、PRD 和 design.md | \`yida-design\` |
-| \`yida-skills/form\` | 表单字段、公式、校验、业务规则、详情页、批量录入、数据记录 | \`yida-create-form-page\`, \`yida-formula\`, \`yida-formula-evaluate\`, \`yida-business-rule\`, \`yida-form-detail\`, \`yida-canvas-table-form\`, \`yida-table-form\`, \`yida-data-management\` |
+| \`yida-skills/design\` | 完整应用需求简报、产品 PRD、单页 UI 改造、主页面视觉设计、应用主题色、全局换肤 | \`yida-requirement-analysis\`, \`yida-prd\`, \`yida-design\` |
+| \`yida-skills/form\` | 表单字段、公式、校验、业务规则、批量录入、数据记录 | \`yida-create-form-page\`, \`yida-formula\`, \`yida-formula-evaluate\`, \`yida-business-rule\`, \`yida-canvas-table-form\`, \`yida-table-form\`, \`yida-data-management\` |
 | \`yida-skills/process\` | 审批、流程表单、流程规则、代理人 | \`yida-create-process\`, \`yida-process-rule\`, \`yida-agent-center\` |
 | \`yida-skills/page\` | 自定义展示页、YidaCodeCanvas 组件、历史平台 JSX 组件页面维护、发布、导航壳、PPT | \`yida-create-page\`, \`yida-canvas-custom-page\`, \`yida-custom-page\`, \`yida-canvas-data-binding\`, \`yida-canvas-upgrade\`, \`yida-publish-page\`, \`yida-openyida-publish-guard\`, \`yida-density\`, \`yida-nav-shell\`, \`yida-ppt-slider\` |
 | \`yida-skills/analytics\` | 报表、统计、图表、Recharts、ECharts、看板、驾驶舱 | \`yida-report\`, \`yida-rechart\`, \`yida-chart\`, \`yida-dashboard\` |

package/yida-skills/SKILL.md

@@ -2,7 +2,7 @@
 name: openyida
 description: >
   宜搭应用开发总入口技能。通过具备代码生成能力的智能体（千问办公/Claude/Open Code 等）+ 宜搭低代码平台，实现一句话搭建或修改完整应用。
-  当用户提到“宜搭”、“yida”、“低代码”、“创建应用”、“创建表单”、“发布页面”、“自定义页面脚手架”、“搭建”、“系统”等关键词时，使用此技能；只是讨论通用前端/后端代码、非宜搭平台产品、或只解释概念而不操作宜搭资源时不触发。
+  当用户提到“宜搭”、“yida”、“低代码”、“创建应用”、“创建表单”、“发布页面”、“自定义页面模板”、“搭建”、“系统”等关键词时，使用此技能；只是讨论通用前端/后端代码、非宜搭平台产品、或只解释概念而不操作宜搭资源时不触发。
   重要路由规则：完整应用/系统/平台的从零搭建、已有 app 但没有任何页面、或已有 app/page 需要补成完整业务系统时，必须先加载 yida-app 子技能作为编排入口。已有资源的单点改字段、改页面、发布、权限或数据任务按对应子技能路由。
 ---
 
@@ -70,8 +70,8 @@ description: >
 | --- | --- | --- |
 | `yida-skills/context` | 登录、退出、切换组织、组织版本/容量、Schema、fieldId、执行前检查 | `yida-login`、`yida-logout`、`yida-basic-info`、`yida-get-schema`、`yida-corp-efficiency` |
 | `yida-skills/app` | 从零搭应用、完整系统、应用启停、应用导航、多语言 | `yida-app`、`yida-create-app`、`yida-app-lifecycle`、`yida-nav-group`、`yida-i18n` |
-| `yida-skills/design` | 完整应用产品设计、单页 UI 改造、主页面视觉设计、应用主题色、全局换肤、PRD 和 design.md | `yida-design` |
-| `yida-skills/form` | 表单字段、公式、校验、业务关联规则、详情页、批量录入、数据记录 | `yida-create-form-page`、`yida-formula`、`yida-formula-evaluate`、`yida-business-rule`、`yida-form-detail`、`yida-canvas-table-form`、`yida-table-form`、`yida-data-management` |
+| `yida-skills/design` | 完整应用需求简报、PRD、视觉设计、单页 UI 改造、应用主题色、全局换肤 | `yida-requirement-analysis`、`yida-prd`、`yida-design` |
+| `yida-skills/form` | 表单字段、公式、校验、业务关联规则、批量录入、数据记录 | `yida-create-form-page`、`yida-formula`、`yida-formula-evaluate`、`yida-business-rule`、`yida-canvas-table-form`、`yida-table-form`、`yida-data-management` |
 | `yida-skills/process` | 审批、流程表单、流程规则、节点/分支/字段权限、流程代理 | `yida-create-process`、`yida-process-rule`、`yida-agent-center` |
 | `yida-skills/page` | 自定义展示页、页面源码开发、平台 JSX 组件页面维护、页面发布、页面内导航、PPT 页面 | `yida-create-page`、`yida-canvas-custom-page`、`yida-custom-page`、`yida-canvas-data-binding`、`yida-canvas-upgrade`、`yida-publish-page`、`yida-openyida-publish-guard`、`yida-density`、`yida-nav-shell`、`yida-ppt-slider` |
 | `yida-skills/analytics` | 聚合表、虚拟视图、报表、统计、图表、Recharts、ECharts、看板、驾驶舱、大屏 | `yida-aggregate-table`、`yida-report`、`yida-rechart`、`yida-chart`、`yida-dashboard` |
@@ -84,16 +84,16 @@ description: >
 
 | 用户意图 | 选哪个 |
 | --- | --- |
-| 从零搭一个完整应用/系统 | `yida-app`；统一编排，先由 `yida-design` 完成产品设计 |
+| 从零搭一个完整应用/系统 | `yida-app`；统一编排，先生成共享需求简报，再并行生成 `prd.md` 与 `design.md` 并 join |
 | 已有 app 但没有任何页面，需要补成完整系统 | `yida-app`；复用已有 `appType`，按 PRD 补齐表单、流程、页面（如需要）和导航 |
 | 读取钉钉在线文档正文 | `yida-document-markdown`，使用登录态接口获取 Markdown |
 | 按 taskUuid 读取钉钉听记 | `yida-tingji`，将听记任务 ID 原样传入命令 |
 | 用户给 taskUuid 并要求转 PRD | 先用 `yida-tingji` 读取听记内容，再把已有内容交给 `yida-flash-note-to-prd` 生成 PRD |
 | 已有会议纪要/闪记内容转 PRD | `yida-flash-note-to-prd`，只处理已有内容，不负责按 taskUuid 拉取听记 |
-| 只创建应用壳并拿 appType | `yida-create-app`；创建成功后把真实 `appType` 交给 `yida-design` 生成或更新 `prd/<项目名>/prd.md` 和 `prd/<项目名>/design.md`，后续表单、流程、页面和发布都消费这两份文件 |
+| 只创建应用壳并拿 appType | `yida-create-app`；若随后继续完整搭建，已 join 的共享需求简报、`prd.md` 与 `design.md` 保持冻结，真实 `appType` 只写入 schema 或当前任务资源上下文 |
 | 启用/上线或停用/下线已有应用 | `yida-app-lifecycle`；只有用户明确要求时执行，`app-offline` 执行前需再次确认目标应用 |
 | 创建自定义展示页资源 | `yida-create-page`，之后交给 `yida-canvas-custom-page` 编写页面源码，再交给 `yida-publish-page` 发布 |
-| 开发表单字段结构 / 增删改字段 | 先加载 `yida-form-detail` 做表单视觉引导并合并 Divider 分割线，再用 `yida-create-form-page` 落地字段结构 |
+| 开发表单字段结构 / 增删改字段 | 使用 `yida-create-form-page` 落地字段结构 |
 | 创建带审批的流程表单 | `yida-create-process` |
 | 修改已有流程节点/分支/字段权限 | `yida-process-rule` |
 | 查字段 ID / 保存 Schema 证据 | `yida-get-schema`；凡涉及 fieldId 的数据、流程、公式、页面代码先取证 |
@@ -108,8 +108,8 @@ description: >
 | 高级图表、可视化、看板图表 | 默认 `yida-rechart` |
 | 明确 ECharts、维护旧 ECharts 页面、复杂 option 超出 Recharts 能力 | `yida-chart` |
 | 产品化经营看板/驾驶舱交付 | `yida-dashboard` |
-| 批量录入、表格填写、多行编辑 | 默认 `yida-canvas-table-form`；只有已检测到平台 JSX 组件页面/native 页面源码直接依赖实例 `this.utils.yida.saveFormData` 时用 `yida-table-form` |
-| 页面视觉方向、页面美化、去 AI 味 | `yida-design` 产出 `prd/<项目名>/prd.md` 和 `prd/<项目名>/design.md`，或单页 PRD 章节 + design spec；实现阶段默认交给 `yida-canvas-custom-page` |
+| 批量录入、表格填写、多行编辑 | 默认 `yida-canvas-table-form`；已检测到平台 JSX 组件页面、native 页面或存量源码使用 `this.utils.yida.saveFormData` 时用 `yida-table-form` |
+| 页面视觉方向、页面美化、去 AI 味 | `yida-design` 只产出或更新 `prd/<项目名>/design.md`；若业务/页面契约也变化，由 `yida-prd` 更新 `prd.md`；实现阶段默认交给 `yida-canvas-custom-page` |
 | 应用级主题、品牌色、全局换肤 | `yida-design` |
 | 平台左侧导航树分组/排序 | `yida-nav-group` |
 | 应用导航隐藏后自绘导航壳 | `yida-nav-shell` |
@@ -137,9 +137,9 @@ description: >
 10. **读取与复核用合适工具**：读取或定位 workspace 文件优先用当前工具的 Read / Glob / Grep 或 `rg`；OpenYida CLI 已返回成功 JSON、URL、`appType`、`formUuid` 或 `fieldId` 时，以 CLI 结果作为证据。
 11. **资源 ID 必须精确**：`appType`、`formUuid`、`fieldId` 等应用、表单、字段 ID 必须来自 CLI/API/cache 证据并一字不差传入命令和源码；不得凭名称、截图、相似前缀或记忆补写、改写、截断。
 12. **字段和 Schema 以证据为准**：字段级表单操作优先交给 `create-form update/add-option/bind-datasource/validation/rule` 的 schema-aware 解析；页面代码、数据、流程、公式等需要字段映射时，每表单一次性执行 `openyida get-schema --field-map-json` 并缓存字段摘要。
-13. **设计事实源固定**：完整应用和真实业务页先由 `yida-design` 输出 `prd/<项目名>/prd.md` 与 `prd/<项目名>/design.md`；页面目标、区块、数据和交互以 PRD 为准，布局、主题、材质和状态视觉以 design.md 为准。
+13. **设计事实源固定**：完整应用先由 `yida-requirement-analysis` 生成共享简报，再由 `yida-prd` 与 `yida-design` 并行输出 `prd/<项目名>/prd.md` 与 `prd/<项目名>/design.md`，由 `yida-app` join；页面目标、区块、数据和交互以 PRD 为准，布局、主题、材质和状态视觉以 design.md 为准。
 14. **配置优先于页面代码**：字段、公式、联动、报表、审批和集成交给对应技能；自定义页面负责展示数据、放置业务入口，并串联表单、流程、报表和导航入口。
-15. **Canvas 脚手架桥统一口径**：`.canvas.jsx` / `.canvas.tsx` 发布为 `YidaCodeCanvas` 时，外层页面 `didMount` 默认注入 `window.__OPENYIDA_YIDA_API__` 和 `window.__OPENYIDA_UTILS__`。Canvas 组件内部不得直接写 `this.utils.yida.*`；表单/流程/表单设计 API 走 `window.__OPENYIDA_YIDA_API__`，`toast/dialog/openPage/router.push/isMobile` 等根级工具走 `window.__OPENYIDA_UTILS__`，且 `window.__OPENYIDA_UTILS__.yida` 指向同一个 yida API 桥。
+15. **Canvas 运行桥统一口径**：`.canvas.jsx` / `.canvas.tsx` 发布为 `YidaCodeCanvas` 时，外层页面 `didMount` 默认注入 `window.__OPENYIDA_YIDA_API__` 和 `window.__OPENYIDA_UTILS__`。Canvas 组件内部不得直接写 `this.utils.yida.*`；表单/流程/表单设计 API 走 `window.__OPENYIDA_YIDA_API__`，`toast/dialog/openPage/router.push/isMobile` 等根级工具走 `window.__OPENYIDA_UTILS__`，且 `window.__OPENYIDA_UTILS__.yida` 指向同一个 yida API 桥。
 16. **分页查询默认 pageSize 50**：生成表单、流程、任务、成员等分页查询代码时，一般显式写 `pageSize: 50` 或 `pageSize: '50'`。除非用户明确要求小页或大页，不写 `20`、`100` 等其他值；平台上限仍是 100。
 17. **数据性能优先**：统计聚合用 `yida-report` 服务端聚合，不在前端拉全量后自行聚合。
 18. **避免无效重试**：失败先查登录态、组织、参数和字段 ID；无修改不连续重试超 1 次。
@@ -157,9 +157,9 @@ description: >
 - 不把 OpenYida 业务中间文件写到仓库根目录或系统临时目录。
 
 20. **报表和可视化先分流**：标准统计与原生报表用 `yida-report`；定制图表页面默认用 `yida-rechart`；只有明确 ECharts、维护旧 ECharts 页面或复杂 option 超出 Recharts 能力时用 `yida-chart`。
-21. **UI 设计技能优先**：涉及应用蓝图、页面视觉、应用主题色、品牌色、全局换肤或 `--color-brand1-*` 时先读 `yida-design`；主题必须根据行业、品牌、业务情绪和视觉目标判断，不套用刻板配色。
-22. **默认完成即停止**：完整应用默认以资源发布成功、轻量导航排序完成、示例数据就绪并输出主入口 URL 与业务交付总结为 doneWhen；截图、精细导航整理和额外深读属于 optionalAfterDone，除非用户明确要求。
-23. **输出业务化**：最终回复先写 2-3 句业务交付总结，再给主入口链接；默认不输出资源 ID 表格、长列表、管理态链接、CDN 构建产物或中间文件 URL。
+21. **应用主题只有一份**：涉及应用蓝图、页面视觉、应用主题色、品牌色、全局换肤或 `--color-brand1-*` 时先读 `yida-design`。`app-theme.css` 只在应用级统一配置，由平台作用于应用壳、原生表单、详情页和自定义页面外层。严禁在页面级重复写入、同步或向上层注入主题样式；`YidaCodeCanvas` 源码只在 `YidaComp` 内消费现有主题 token。
+22. **默认完成即停止**：完整应用默认以资源发布成功、轻量导航排序完成、示例数据就绪并输出一组有明确名称的应用入口与业务交付总结为 doneWhen；截图、精细导航整理和额外深读属于 optionalAfterDone，除非用户明确要求。
+23. **输出业务化**：最终回复先写 2-3 句业务交付总结，再给一组“应用访问入口”。不得把需求简报、PRD、视觉设计、build manifest、资源清单、Schema 或每个表单/流程/报表分别登记成用户可见交付物；完整应用始终给工作台入口，主页面经 PRD 标记为 `standalone` 且导航配置回读通过时增加独立业务入口，非云端 Agent 再增加开发后台入口。
 24. **任务复盘沉淀**：用户多次纠正、平台接口假成功、页面骨架共性质量问题、线上回读验收方法、一次性脚本可产品化等情况，完成前判断是否需要沉淀到 CLI、测试或 skill。
 
 常见问题见 [常见问题解决方案](references/execution-rules.md)。

package/yida-skills/references/task-retrospective.md

@@ -17,7 +17,7 @@ OpenYida 任务完成后，除了交付当前结果，还要判断是否有可
 
 | 经验类型 | 首选落盘位置 | 示例 |
 | --- | --- | --- |
-| 命令行为、参数校验、平台 API 链路 | `lib/**` + `tests/**` | `update-app --theme` 不能只走 `updateAppName`，需回读详情后用 `updateApp` 保存 |
+| 应用主题文件生成 | `yida-design` + 主题模板 | 复制完整模板后只修改设计确定的 token |
 | 技能路由、工作流、验收纪律 | `yida-skills/SKILL.md` 或对应子技能 `SKILL.md` | 主题任务必须先读 `yida-design`，页面视觉先读 `yida-design` |
 | 页面视觉、Dribbble/优秀案例参考方法 | `yida-design` workflow/reference | 参考案例要转译为布局、视觉锚点、密度、色彩、组件细节 |
 | 自定义页面共性规则 | `yida-canvas-custom-page` | 独立页面按场景确定主题、演示数据有标识、发布后回读 Schema |
@@ -34,11 +34,11 @@ OpenYida 任务完成后，除了交付当前结果，还要判断是否有可
 1. **参考 Dribbble 不是一句话**
    用户要求参考 Dribbble / 优秀示例时，必须把参考转成可执行设计变量：页面类型、构图、视觉锚点、信息密度、色彩关系、组件细节、反默认点。交付时说明“参考转译成了什么”。
 
-2. **所有页面统一消费应用主题**
-   独立品牌页、活动页、沉浸页和应用导航隐藏后的自绘壳也统一加载应用主题文件；页面差异通过布局、材质、素材、构图和辅助视觉表达。
+2. **主题文件统一由 yida-design 生成**
+   页面实现读取 `design.md` 的布局、材质、素材、构图和辅助视觉规则，并使用当前应用主题变量。
 
 3. **`--theme` 只能填平台预置 key**
-   `deepBlue/podBlue/royalBlue/lightBlue/teal/podGreen/deepPurple/purple/podOrange/yellow/magenta/red/greyBlue/coffee/black` 才能作为 app `colour`。默认优先使用 `podBlue`、`podGreen`、`podOrange`；自定义“活力橙”“深玫红”“暗黑金”等应用主题统一生成应用级 CSS，并联合保存 `themeColor`、`navTheme` 与 `customThemeStyle.cssUrl`，由运行容器在各页面上下文加载。
+   `deepBlue/podBlue/royalBlue/lightBlue/teal/podGreen/deepPurple/purple/podOrange/yellow/magenta/red/greyBlue/coffee/black` 才能作为 app `colour`。应用级 CSS 由 `yida-design` 生成，应用创建或更新阶段直接消费；页面技能不处理主题保存链路。
 
 4. **CLI 成功不等于线上生效**
    修改应用主题后必须回读 `getAppIncludingAecpInfo`，确认 `colour` 和 `config.COLOUR`。如果接口回包成功但字段没变，要修 CLI 链路和测试，而不是只用一次性脚本绕过。

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

@@ -1,6 +1,6 @@
 ---
 name: yida-app
-description: 宜搭完整应用开发编排技能。对普通 OpenYida 应用做完整搭建或补齐时使用；先解析资源上下文并消费 yida-design 的 prd.md 与 design.md，再按 PRD 创建或复用应用、表单、流程和页面；页面阶段默认使用 Canvas 发布脚手架注入 yida/utils window 桥。
+description: 宜搭完整应用开发编排技能。对普通 OpenYida 应用做完整搭建或补齐时使用；先解析资源上下文并生成共享需求简报，再并行生成 prd.md 与 design.md，join 通过后按 PRD 创建或复用应用、表单、流程和页面；页面阶段默认复制 Canvas 页面基准模板并按业务改写。
 ---
 
 # yida-app
@@ -18,25 +18,26 @@ description: 宜搭完整应用开发编排技能。对普通 OpenYida 应用做
 | 步骤 | 名称 | 目标 | 产出 |
 | --- | --- | --- | --- |
 | 1 | [解析资源上下文](workflow/step-1-resource-context.md) | 合并本轮显式资源、绑定上下文、workspace 配置/缓存和会话历史，确认复用还是允许创建 | 目标 app/page/form/process 上下文 |
-| 2 | [产品设计](workflow/step-2-design.md) | 执行 `use_skill("yida-design", "完整应用产品设计")`，产出完整 PRD 和视觉契约 | `prd/<项目名>/prd.md` + `prd/<项目名>/design.md` |
+| 2 | [产品与视觉并行设计](workflow/step-2-design.md) | 先执行 `yida-requirement-analysis` 生成共享简报，再并行执行 `yida-prd` 与 `yida-design`，由本技能 join 两份内部产物 | 内部 `requirement-brief.json` + `prd.md` + `design.md` |
 | 3 | [创建或复用应用](workflow/step-3-create-or-reuse-app.md) | 已有 `appType` 直接复用；缺少 app 且允许创建时执行 `use_skill("yida-create-app")` | 真实目标 `appType` |
-| 4 | [创建或更新业务资源](workflow/step-4-forms-processes.md) | 执行 `use_skill("yida-form-detail")`、`use_skill("yida-create-form-page")`；按 PRD 执行 `use_skill("yida-create-process")`、`use_skill("yida-get-schema")`、`use_skill("yida-report")` 和 `use_skill("yida-integration")` | 真实 `formUuid`、`processCode`、必要 `fieldId/reportId` |
+| 4 | [创建或更新业务资源](workflow/step-4-forms-processes.md) | 执行 `use_skill("yida-create-form-page")`；按 PRD 执行 `use_skill("yida-create-process")`、`use_skill("yida-get-schema")`、`use_skill("yida-report")` 和 `use_skill("yida-integration")` | 真实 `formUuid`、`processCode`、必要 `fieldId/reportId` |
 | 5 | [写入初始表单数据](workflow/step-5-seed-records.md) | 执行 `use_skill("yida-data-management")`，为核心普通表单写入 1-3 条业务化 seed records 并 query 抽查 | 真实表单记录或明确跳过原因 |
 | 6 | [创建或复用主页面](workflow/step-6-main-page.md) | 已有 display 页面直接复用；缺少主页面且允许创建时执行 `use_skill("yida-create-page")` | 真实主页面 `formUuid` |
 | 7 | [编写或更新页面](workflow/step-7-page-code.md) | 执行 `use_skill("yida-canvas-custom-page")`；看板/工作台/驾驶舱必须再执行 `use_skill("yida-dashboard")`，读取表单数据时必须执行 `use_skill("yida-canvas-data-binding")` | 页面源码和真实 dataBinding 通过校验 |
 | 8 | [发布页面并排序导航](workflow/step-8-publish-navigation.md) | 执行 `use_skill("yida-publish-page")`，发布本轮源码到主页面并执行轻量导航排序 | 已发布主页面 URL |
-| 9 | [输出与收尾](workflow/step-9-output-finish.md) | 核对完成条件，按业务语言输出结果 | 2-3 句业务总结 + 一个主入口链接 |
+| 9 | [输出与收尾](workflow/step-9-output-finish.md) | 核对完成条件，按业务语言输出结果 | 2-3 句业务总结 + 一组应用访问入口 |
 
 ## 核心规则
 
 1. **资源判断以 Step 1 为准**：已有 app/page/form/process 默认复用；只有用户明确从零创建，或目标缺失且本轮允许创建时，才创建缺失资源。
 2. **显式目标优先**：本轮用户给出的 `appType`、`formUuid`、URL、页面名或流程标识，优先级高于绑定上下文和历史缓存；同级冲突或无法唯一识别时才问用户。
-3. **设计事实源唯一**：需求分析、资源蓝图、页面结构、导航顺序和验收标准由 `yida-design` 写入 `prd.md`；主题 token、布局、材质、圆角、密度、组件和状态规则由 `design.md` 承担。
+3. **双产物事实源分工**：`yida-requirement-analysis` 只提供共享输入；业务目标、资源蓝图、页面结构、导航顺序和验收标准由 `yida-prd` 写入 `prd.md`；主题 token、布局、材质、圆角、密度、组件和状态规则由 `yida-design` 写入 `design.md`。两份产物 join 通过前不得创建资源。
 4. **阶段技能按需加载**：进入应用壳、表单、流程、页面、发布、数据写入等阶段时，才执行对应 `use_skill(...)`。
 5. **真实 ID 和真实数据**：不编造 `appType`、`formUuid`、`fieldId`、`processCode`、`reportId`。完整应用默认给核心普通表单写入 1-3 条业务化 seed records 并 query 抽查；不适合造数时说明原因和空态方案。
 6. **自定义页面开发技能固定**：完整应用页面源码按 Step 7 执行。
 7. **删除必须确认**：用户要求删除应用时，先展示应用名称、应用 ID 和影响范围，等待明确“确认删除”后才能执行。
 8. **列表页选择**：默认使用普通表单的数据管理页；用户明确要求自定义列表页时才创建 display 页面。
+9. **交付物收口**：Step 2 的三个文件和 Step 9 的 build manifest 都是内部事实源，不是用户交付物。表单、流程、报表和页面只在业务总结中概述，不逐项调用宿主 artifact/交付工具；宿主支持交付工具时，final 只交付一次“应用访问入口”组。
 
 ## 关键决策树
 
@@ -51,7 +52,7 @@ description: 宜搭完整应用开发编排技能。对普通 OpenYida 应用做
 - 默认页面源码不得使用 `this.dataSourceMap.*`，除非本轮已经创建并绑定对应设计器数据源。
 - 真实表单数据默认通过页面数据桥或 `window.__OPENYIDA_YIDA_API__.searchFormDatas(params)` 读取；流程发起、流程列表、表单保存/更新等能力也通过发布层注入的同一个 yida API 桥调用；不要用前端 seedRows 冒充真实表单数据。
 - 页面根级运行态工具通过 `window.__OPENYIDA_UTILS__` 读取，`toast/dialog/openPage/router.push/isMobile` 等工具不能在 `YidaComp` 内直接写 `this.utils.*`。
-- 表单新建/提交/详情入口统一使用 `FormOpenContainer`，详情页必须从真实行数据解析 `formInstId`；新版主题由运行容器在自定义页面和提交页/详情页 iframe 分别加载同一应用主题文件。
+- 表单新建/提交/详情入口统一使用 `FormOpenContainer`，详情页必须从真实行数据解析 `formInstId`。
 - 用户明确要求的自定义列表、看板和详情页优先读取真实表单数据；`page-spec.json` 写 `dataBinding.mode=form`、真实 `appType/formUuid/fieldId` 和字段映射。表单数据管理页不另生成页面源码。
 - 完整应用默认先写入 1-3 条业务化 seed records 并 query 抽查；没写入成功时，页面展示空态、表单入口、刷新或登记按钮，并在 final 说明原因。
 - 若页面确实依赖 `this.dataSourceMap.*`，必须执行 `use_skill("yida-data-source-connectors")` 创建/绑定数据源，并在发布后确认页面 Schema 中存在对应数据源；发布输出出现 `No custom page data sources to preserve` 时，本次发布不能视为完成。
@@ -65,9 +66,9 @@ description: 宜搭完整应用开发编排技能。对普通 OpenYida 应用做
 | 文档 | 覆盖范围 | 何时阅读 |
 | --- | --- | --- |
 | [Step 1：解析资源上下文](workflow/step-1-resource-context.md) | 只读预检、资源优先级、命令选择、路径口径 | 必读 |
-| [Step 2：产品设计](workflow/step-2-design.md) | `yida-design` 产物边界、主题 key、PRD/design.md 消费 | 必读 |
+| [Step 2：产品与视觉并行设计](workflow/step-2-design.md) | 共享需求简报、PRD/视觉 artifact 生命周期、并行执行、join 与主题 key | 必读 |
 | [Step 3：创建或复用应用](workflow/step-3-create-or-reuse-app.md) | app 复用、app 创建、主题 key | 必读 |
-| [Step 4：创建或更新表单/流程](workflow/step-4-forms-processes.md) | 表单、流程、字段 ID、新版应用主题消费与 legacy formDetail 兼容 | 必读 |
+| [Step 4：创建或更新表单/流程](workflow/step-4-forms-processes.md) | 表单、流程、字段 ID 与表单结构规则 | 必读 |
 | [Step 5：写入初始表单数据](workflow/step-5-seed-records.md) | seed records、字段类型、query 抽查、跳过条件 | 必读 |
 | [Step 6：创建或复用主页面](workflow/step-6-main-page.md) | display 页面复用、页面创建、corpId 一致性检查 | 必读 |
 | [Step 7：编写或更新页面](workflow/step-7-page-code.md) | 页面源码、page-spec、dataBinding、本地校验 | 必读 |