openyida 2026.9.13 → 2026.9.14

package/lib/core/locales/en.js

@@ -915,6 +915,15 @@ Examples:
     response_body: '  Response body: {0}',
     response_detail: '  Response detail: {0}',
     response_not_json: 'response is not JSON',
+    code_bundle_download_failed: 'CodeBundle download failed: {0} ({1})',
+    code_bundle_forbidden: 'permission verification or OSS access was denied',
+    code_bundle_not_found: 'the file does not exist or has been removed',
+    code_bundle_http_error: 'HTTP {0}',
+    code_bundle_html_response: 'received an HTML error page; the environment or route may be incorrect',
+    code_bundle_json_response: 'the service returned a JSON error response: {0}',
+    code_bundle_unexpected_content_type: 'unexpected response Content-Type: {0}',
+    code_bundle_invalid_utf8: 'the response is not valid UTF-8 text',
+    code_bundle_integrity_failed: 'CodeBundle {0} integrity verification failed ({1})',
     login_expired: '  Login session expired: {0}',
     csrf_expired: '  CSRF token expired: {0}',
     csrf_refreshed: '  csrf_token refreshed',

package/lib/core/locales/zh.js

@@ -886,6 +886,15 @@ openyida - 宜搭命令行工具
     response_body: '  响应内容: {0}',
     response_detail: '  响应详情: {0}',
     response_not_json: '响应非 JSON',
+    code_bundle_download_failed: 'CodeBundle 下载失败：{0}（{1}）',
+    code_bundle_forbidden: '权限校验或 OSS 访问被拒绝',
+    code_bundle_not_found: '文件不存在或已被清理',
+    code_bundle_http_error: 'HTTP {0}',
+    code_bundle_html_response: '返回了 HTML 错误页，可能是环境或路由错误',
+    code_bundle_json_response: '服务端返回 JSON 错误响应：{0}',
+    code_bundle_unexpected_content_type: '响应 Content-Type 不符合预期：{0}',
+    code_bundle_invalid_utf8: '响应内容不是有效 UTF-8 文本',
+    code_bundle_integrity_failed: 'CodeBundle {0} 完整性校验失败（{1}）',
     login_expired: '  检测到登录过期: {0}',
     csrf_expired: '  检测到 csrf_token 过期: {0}',
     csrf_refreshed: '  csrf_token 已刷新',

package/lib/core/utils.js

@@ -1080,6 +1080,362 @@ function createNonJsonResponseResult(statusCode, data) {
   };
 }
 
+function buildRequestUrl(baseUrl, requestPath, queryParams) {
+  const normalizedBaseUrl = String(baseUrl || '').replace(/\/+$/, '') + '/';
+  const requestUrl = new URL(requestPath, normalizedBaseUrl);
+  if (queryParams) {
+    Object.entries(queryParams).forEach(([key, value]) => {
+      if (value !== undefined && value !== null) {
+        requestUrl.searchParams.set(key, String(value));
+      }
+    });
+  }
+  return requestUrl;
+}
+
+async function fetchWithTimeout(requestUrl, requestOptions, timeout, readResponse) {
+  const controller = new AbortController();
+  const timer = setTimeout(() => controller.abort(), timeout || 30000);
+  try {
+    const response = await fetch(requestUrl, {
+      ...requestOptions,
+      signal: controller.signal,
+    });
+    return readResponse ? await readResponse(response) : response;
+  } catch (error) {
+    if (error && error.name === 'AbortError') {
+      throw new Error(t('common.request_timeout'));
+    }
+    throw error;
+  } finally {
+    clearTimeout(timer);
+  }
+}
+
+async function parseJsonFetchResponse(response, options = {}) {
+  const data = await response.text();
+  if (!options.silentStatus) {
+    warn(t('common.http_status', response.status));
+  }
+  if (isHttpRedirectStatus(response.status) || isHttpAuthStatus(response.status)) {
+    return {
+      __needLogin: true,
+      __httpStatus: response.status,
+      __location: response.headers.get('location') || '',
+    };
+  }
+  try {
+    const parsed = JSON.parse(data);
+    if (isLoginExpired(parsed)) {
+      return { __needLogin: true };
+    }
+    if (isCsrfTokenExpired(parsed)) {
+      return { __csrfExpired: true };
+    }
+    return parsed;
+  } catch {
+    if (!options.silentStatus) {
+      warn(t('common.http_response', data.substring(0, 500)));
+    }
+    return createNonJsonResponseResult(response.status, data);
+  }
+}
+
+function appendMultipartFile(form, fieldName, file) {
+  if (!file || file.content === undefined || file.content === null) {
+    throw new TypeError(`multipart file ${fieldName} is required`);
+  }
+  const content = Buffer.isBuffer(file.content)
+    ? file.content
+    : Buffer.from(String(file.content), 'utf8');
+  form.append(
+    fieldName,
+    new Blob([content], { type: file.contentType || 'application/octet-stream' }),
+    file.fileName || fieldName
+  );
+}
+
+/**
+ * 发送 multipart/form-data POST。Content-Type boundary 由 Node.js FormData 生成。
+ */
+async function httpPostMultipart(baseUrl, requestPath, fields, files, optionsOrLegacyCookies, maybeOptions) {
+  if (typeof fetch !== 'function' || typeof FormData !== 'function' || typeof Blob !== 'function') {
+    throw new Error('当前 Node.js 环境缺少 fetch/FormData/Blob，请使用 Node.js 18+');
+  }
+  const optionsOverride = resolveRequestOptions(optionsOrLegacyCookies, maybeOptions);
+  const authHeaders = await resolveRequestAuthHeaders(optionsOverride);
+  const form = new FormData();
+  Object.entries(fields || {}).forEach(([key, value]) => {
+    if (value !== undefined && value !== null) {
+      form.append(key, String(value));
+    }
+  });
+  Object.entries(files || {}).forEach(([key, file]) => appendMultipartFile(form, key, file));
+
+  const requestUrl = buildRequestUrl(baseUrl, requestPath);
+  return fetchWithTimeout(requestUrl, {
+    method: 'POST',
+    redirect: 'manual',
+    headers: {
+      Accept: 'application/json, text/plain, */*',
+      Origin: requestUrl.origin,
+      Referer: optionsOverride.referer || requestUrl.origin + '/',
+      'x-requested-with': 'XMLHttpRequest',
+      ...authHeaders,
+    },
+    body: form,
+  }, optionsOverride.timeout, response => parseJsonFetchResponse(response, optionsOverride));
+}
+
+async function readFetchResponseBuffer(response, maxBytes, timeout) {
+  const limit = Number(maxBytes);
+  const timeoutMs = Number(timeout) || 30000;
+  const contentLength = Number(response.headers.get('content-length') || 0);
+  if (Number.isFinite(limit) && limit > 0 && contentLength > limit) {
+    const error = new Error(`响应内容超过允许大小 ${limit} bytes`);
+    error.code = 'HTTP_RESPONSE_TOO_LARGE';
+    throw error;
+  }
+
+  if (!response.body || typeof response.body.getReader !== 'function') {
+    let timer;
+    const arrayBuffer = await Promise.race([
+      response.arrayBuffer(),
+      new Promise((resolve, reject) => {
+        void resolve;
+        timer = setTimeout(() => reject(new Error(t('common.request_timeout'))), timeoutMs);
+      }),
+    ]).finally(() => clearTimeout(timer));
+    const buffer = Buffer.from(arrayBuffer);
+    if (Number.isFinite(limit) && limit > 0 && buffer.length > limit) {
+      const error = new Error(`响应内容超过允许大小 ${limit} bytes`);
+      error.code = 'HTTP_RESPONSE_TOO_LARGE';
+      throw error;
+    }
+    return buffer;
+  }
+
+  const chunks = [];
+  let size = 0;
+  const reader = response.body.getReader();
+  let timedOut = false;
+  const timer = setTimeout(() => {
+    timedOut = true;
+    void reader.cancel();
+  }, timeoutMs);
+  try {
+    for (;;) {
+      const { done, value } = await reader.read();
+      if (done) {
+        break;
+      }
+      const chunk = Buffer.from(value);
+      size += chunk.length;
+      if (Number.isFinite(limit) && limit > 0 && size > limit) {
+        await reader.cancel();
+        const error = new Error(`响应内容超过允许大小 ${limit} bytes`);
+        error.code = 'HTTP_RESPONSE_TOO_LARGE';
+        throw error;
+      }
+      chunks.push(chunk);
+    }
+    if (timedOut) {
+      throw new Error(t('common.request_timeout'));
+    }
+  } finally {
+    clearTimeout(timer);
+    reader.releaseLock();
+  }
+  return Buffer.concat(chunks, size);
+}
+
+function normalizeResponseContentType(value) {
+  return String(value || '').split(';')[0].trim().toLowerCase();
+}
+
+function responseRequestId(response) {
+  return response.headers.get('x-request-id') || '';
+}
+
+function buildCodeBundleResponseMetadata(requestUrl, response) {
+  const metadata = {
+    baseUrl: requestUrl.origin,
+    finalHost: requestUrl.host,
+    status: response.status,
+    contentType: normalizeResponseContentType(response.headers.get('content-type')),
+    eagleeyeTraceId: response.headers.get('eagleeye-traceid') || '',
+    requestId: responseRequestId(response),
+  };
+  metadata.context = [
+    `baseUrl=${metadata.baseUrl}`,
+    `finalHost=${metadata.finalHost}`,
+    `status=${metadata.status}`,
+    `contentType=${metadata.contentType || 'missing'}`,
+    metadata.eagleeyeTraceId ? `eagleeyeTraceId=${metadata.eagleeyeTraceId}` : '',
+    metadata.requestId ? `requestId=${metadata.requestId}` : '',
+  ].filter(Boolean).join(', ');
+  return metadata;
+}
+
+function createCodeBundleDownloadError(code, reason, metadata, responsePreview) {
+  const suffix = responsePreview ? `; response=${responsePreview}` : '';
+  const error = new Error(t('common.code_bundle_download_failed', reason, metadata.context) + suffix);
+  error.code = code;
+  error.details = {
+    ...metadata,
+    responsePreview: responsePreview || undefined,
+  };
+  return error;
+}
+
+function compactResponsePreview(buffer) {
+  return buffer.toString('utf8').replace(/\s+/g, ' ').trim().substring(0, 500);
+}
+
+async function readErrorResponsePreview(response, timeout) {
+  try {
+    return compactResponsePreview(await readFetchResponseBuffer(response, 4096, timeout));
+  } catch {
+    return '';
+  }
+}
+
+function looksLikeHtml(buffer) {
+  const prefix = buffer.toString('utf8', 0, Math.min(buffer.length, 256)).trimStart().toLowerCase();
+  return prefix.startsWith('<!doctype html')
+    || prefix.startsWith('<html')
+    || prefix.startsWith('<head')
+    || prefix.startsWith('<body');
+}
+
+function expectedContentTypeMatches(actualContentType, expectedContentTypes) {
+  if (!Array.isArray(expectedContentTypes) || expectedContentTypes.length === 0) {
+    return true;
+  }
+  return expectedContentTypes.some(value => normalizeResponseContentType(value) === actualContentType);
+}
+
+function jsonResponseReason(preview) {
+  if (!preview) {
+    return t('common.code_bundle_json_response', t('common.unknown_error'));
+  }
+  try {
+    const payload = JSON.parse(preview);
+    const message = payload && (payload.errorMsg || payload.message || payload.throwable || payload.errorCode);
+    return t('common.code_bundle_json_response', message || t('common.unknown_error'));
+  } catch {
+    return t('common.code_bundle_json_response', t('common.unknown_error'));
+  }
+}
+
+/**
+ * 从宜搭首方接口直接获取 CodeBundle 文本。
+ */
+async function httpGetCodeBundleText(baseUrl, requestPath, queryParams, optionsOrLegacyCookies, maybeOptions) {
+  if (typeof fetch !== 'function') {
+    throw new Error('当前 Node.js 环境缺少 fetch，请使用 Node.js 18+');
+  }
+  const optionsOverride = resolveRequestOptions(optionsOrLegacyCookies, maybeOptions);
+  const authHeaders = await resolveRequestAuthHeaders(optionsOverride);
+  const requestUrl = buildRequestUrl(baseUrl, requestPath, queryParams);
+  const maxBytes = Number(optionsOverride.maxBytes) || 5 * 1024 * 1024;
+  const response = await fetchWithTimeout(requestUrl, {
+    method: 'GET',
+    redirect: 'manual',
+    headers: {
+      Accept: 'text/plain, application/javascript, */*',
+      Origin: requestUrl.origin,
+      Referer: requestUrl.origin + '/',
+      'x-requested-with': 'XMLHttpRequest',
+      ...authHeaders,
+    },
+  }, optionsOverride.timeout);
+  const metadata = buildCodeBundleResponseMetadata(requestUrl, response);
+
+  if (response.status === 401) {
+    return { __needLogin: true, __httpStatus: response.status };
+  }
+  if (response.status < 200 || response.status >= 300) {
+    const preview = await readErrorResponsePreview(response, optionsOverride.timeout);
+    if (response.status === 403) {
+      throw createCodeBundleDownloadError(
+        'CODE_BUNDLE_DOWNLOAD_FORBIDDEN',
+        t('common.code_bundle_forbidden'),
+        metadata,
+        preview
+      );
+    }
+    if (response.status === 404) {
+      throw createCodeBundleDownloadError(
+        'CODE_BUNDLE_DOWNLOAD_NOT_FOUND',
+        t('common.code_bundle_not_found'),
+        metadata,
+        preview
+      );
+    }
+    throw createCodeBundleDownloadError(
+      'CODE_BUNDLE_DOWNLOAD_HTTP_ERROR',
+      t('common.code_bundle_http_error', response.status),
+      metadata,
+      preview
+    );
+  }
+
+  const contentType = metadata.contentType;
+  const htmlResponse = contentType === 'text/html' || contentType === 'application/xhtml+xml';
+  const jsonResponse = contentType === 'application/json' || contentType.endsWith('+json');
+  if (htmlResponse || jsonResponse
+    || !expectedContentTypeMatches(contentType, optionsOverride.expectedContentTypes)) {
+    const preview = await readErrorResponsePreview(response, optionsOverride.timeout);
+    if (htmlResponse) {
+      throw createCodeBundleDownloadError(
+        'CODE_BUNDLE_DOWNLOAD_HTML_RESPONSE',
+        t('common.code_bundle_html_response'),
+        metadata,
+        preview
+      );
+    }
+    if (jsonResponse) {
+      throw createCodeBundleDownloadError(
+        'CODE_BUNDLE_DOWNLOAD_JSON_RESPONSE',
+        jsonResponseReason(preview),
+        metadata,
+        preview
+      );
+    }
+    throw createCodeBundleDownloadError(
+      'CODE_BUNDLE_DOWNLOAD_UNEXPECTED_CONTENT_TYPE',
+      t('common.code_bundle_unexpected_content_type', contentType || 'missing'),
+      metadata,
+      preview
+    );
+  }
+
+  const buffer = await readFetchResponseBuffer(response, maxBytes, optionsOverride.timeout);
+  if (looksLikeHtml(buffer)) {
+    throw createCodeBundleDownloadError(
+      'CODE_BUNDLE_DOWNLOAD_HTML_RESPONSE',
+      t('common.code_bundle_html_response'),
+      metadata,
+      compactResponsePreview(buffer)
+    );
+  }
+  let value;
+  try {
+    value = new TextDecoder('utf-8', { fatal: true }).decode(buffer);
+  } catch {
+    throw createCodeBundleDownloadError(
+      'CODE_BUNDLE_DOWNLOAD_INVALID_UTF8',
+      t('common.code_bundle_invalid_utf8'),
+      metadata
+    );
+  }
+  if (typeof optionsOverride.onResponseMetadata === 'function') {
+    optionsOverride.onResponseMetadata(metadata);
+  }
+  return value;
+}
+
 /**
  * 发送 HTTP POST 请求（application/x-www-form-urlencoded）
  * @param {string} baseUrl
@@ -1504,8 +1860,10 @@ module.exports = {
   isLoginExpired,
   isCsrfTokenExpired,
   httpPost,
+  httpPostMultipart,
   httpPostJson,
   httpGet,
+  httpGetCodeBundleText,
   requestWithAutoLogin,
   requestNonIdempotentWithAuthPreflight,
   getNpmExecutable,

package/package.json

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

package/yida-skills/skills/yida-app/workflow/plan/step-4-deliver.md

@@ -37,7 +37,7 @@ HTML 保留“需求总览、数据模型、业务流程、页面规划”四章
 按 [用户交互契约](../../../yida-design/references/ask-human-interaction-contract.md) 执行：
 
 1. 在会话中展示“当前这版方案”，并用 3–7 条业务摘要说明方案内容。
-2. 必须实际调用 `ask_human` 创建结构化提问，并通过同一次调用的 `attachments` 携带可打开的 `prd/<项目名>/build-plan.html`；附件对象固定使用 `name: "build-plan.html"`，并将 `revision` 设为当前 `meta.revision`。只输出方案正文或普通 assistant 文本后结束本轮属于未完成，严禁用它替代 `ask_human`；也不得改成项目标题，或先发普通文本附件、再单独提问。
+2. 必须实际调用 `ask_human` 创建结构化提问，并通过同一次调用的 `attachments` 携带可打开的 `prd/<项目名>/build-plan.html`；附件对象固定使用 `name: "build-plan.html"`，并将 `revision` 设为当前 `meta.revision`。调用必须遵守交互契约中的实际参数模板：一个顶层 `question`、恰好两个顶层 `options`（value 只能是 `confirm_build`、`continue_editing`）、同次调用的 `attachments`、`revision` 和 `submitLabel`。禁止使用 `fields`、`text`、`textarea`，禁止增加“调整说明”或其他条件式输入。只输出方案正文或普通 assistant 文本后结束本轮属于未完成，严禁用它替代 `ask_human`；也不得改成项目标题，或先发普通文本附件、再单独提问。
 3. 结构化交互成功创建后内部记录 `presentedRevision=meta.revision`。询问“确认并开始搭建”或“继续调整”，提交时由宿主原样回传 revision，将确认结果绑定到本次展示版本。用户可见版本称为“第 N 版方案”，展示序号与内部 revision 绑定。
 
 只有以下条件同时成立才交接；它们由本轮 ask_human 请求和回传在运行时判定，不要求把确认状态写回 workspace 文件：
@@ -50,6 +50,8 @@ HTML 保留“需求总览、数据模型、业务流程、页面规划”四章
 
 ## 4. 处理调整
 
+用户选择“继续调整”后保持在 Plan Design，本轮不创建应用、表单、流程或页面。下一轮再单独询问需要修改的内容；不要把调整说明、自由文本或 textarea 塞进最终确认卡。收到具体调整后才执行下面的 patch，物化新 revision 并重新展示最终确认。
+
 按字段更新源事实并重新生成，例如同时调整品牌色和圆角：
 
 ```bash

package/yida-skills/skills/yida-app/workflow/step-2-design.md

@@ -8,11 +8,11 @@
 
 ## 2.0 先分析并确认需求
 
-调用 `yida-requirement-analysis`，按 [需求分析与首次搭建确认](../../yida-requirement-analysis/workflow/prepare-brief.md) 整理来源、复用资源及用户已有计划，在同一轮一次性确认尚未明确的 Fast / Plan、业务模块、页面与表单、导航归属及风格。导航 `ask_human` 仅提供“宜搭原生导航”和“自定义导航”两个选项，原生导航就是平台导航，并按 [导航选项说明](../../yida-requirement-analysis/workflow/prepare-brief.md#导航选项说明) 备注实现方式，不标记“推荐”。顶部、侧边、L 型等布局在用户所选归属内根据场景确定，不询问布局或样式；用户已明确的要求优先，后续阶段复用归属选择和布局依据。首次搭建在必要回答写回、`intake.confirmed=true` 后继续。
+调用 `yida-requirement-analysis`，按 [需求分析与首次搭建确认](../../yida-requirement-analysis/workflow/prepare-brief.md) 整理来源、复用资源及用户已有计划，在同一轮一次性确认尚未明确的 Fast / Plan、业务模块、页面与表单及风格。导航方式与布局按 [导航设计](../../yida-requirement-analysis/workflow/prepare-brief.md#导航设计) 确定；用户已明确要求优先，后续阶段复用判断和依据。首次搭建在必要回答与导航判断写回、`intake.confirmed=true` 后继续。
 
 回答齐全后直接保存内部需求记录并进入 2.1；不把“生成需求简报”列为独立任务，不再扩写或展示简报请用户确认。已有确认记录且需求未变化时直接复用。记录粒度、保存和校验规则统一遵守上述需求分析流程。
 
-显式搭建方式属于本次任务的粘性输入。若用户在首次消息已选择 Plan，澄清业务模块、页面、导航或风格时不得再次询问模式，也不得在合并回答后改写为 Fast；进入 2.1 前必须以用户最后一次明确选择校验 `intake.designMode`。Fast 同理。
+显式搭建方式属于本次任务的粘性输入。若用户在首次消息已选择 Plan，澄清业务模块、页面或风格时不得再次询问模式，也不得在合并回答后改写为 Fast；进入 2.1 前必须以用户最后一次明确选择校验 `intake.designMode`。Fast 同理。
 
 执行规划前读取 `constraints.prohibitedActions`。PRD 与 design 必须把禁止项写成实现门禁：`theme-file` 禁止时沿用现有平台主题且不安排主题文件任务；`page-source` 禁止时只允许只读核查与非源码配置；`publish` 禁止时把发布明确标记为跳过。不得为了满足默认九步流程静默删除这些约束。
 

package/yida-skills/skills/yida-create-form-page/SKILL.md

@@ -37,6 +37,7 @@ description: 表单页面创建与更新；支持 19 种业务字段和 Divider
 - update / add-option / bind-datasource / validation / rule 等字段级操作不要求先执行外部 `get-schema`；直接提交 compact JSON 或字段 label/fieldId，CLI 会内部读取 schema、定位字段，并在成功 JSON 中输出 compact `resolved`/`updatedProps` evidence。字段解析失败/歧义时按 `diagnostics[].candidates` 补 `tableLabel`、修正 label 或再执行一次 compact `get-schema`。
 - 字段定义或变更定义需要落盘时，必须使用 agent 的结构化文件写入工具创建到 `<projectRoot>/.cache/openyida/<项目名或任务名>/`，例如 `<projectRoot>/.cache/openyida/pm/pm-fields-team.json`
 - 普通表单分组必须优先使用 `Divider`，多列排版必须通过字段 JSON 中的 `ColumnContainer` 局部表达
+- **重复结构化记录默认使用 `TableField`**：用户未指定具体字段类型时，凡一个业务字段承载多条同构记录，且每条记录由一组固定子字段组成，必须用 `TableField + children` 建模，不以字段名称或业务领域作为判断依据；用户明确指定具体字段类型时按用户要求执行，不将模型推断、跨会话记忆或历史兼容性说法视为用户指定。未在当前应用、当前提交链路验证的限制不能作为字段改型依据。
 - **本技能不读写 memory**：formUuid 等信息输出到 stdout，通过 `.cache/<项目名>-schema.json` 持久化，不依赖跨会话的 memory 状态
 
 ## 适用场景

package/yida-skills/skills/yida-design/references/ask-human-interaction-contract.md

@@ -60,7 +60,7 @@
 1. 进度消息使用业务结果和下一步动作。结构化问题紧随其后时，不额外发送内部分析结论；多个问题确需共同背景时，只在整组交互的引导中说明一次，不写入每个问题的 `title` 或 `prompt`。
 2. `title`、`prompt`、`label`、`description` 和普通对话只使用用户能直接理解的业务词。
 3. `interactionId`、`questionType`、`value`、`writeBackPath`、`reason`、状态字段和文件路径仅供内部执行，不进入用户可见内容。
-4. `title` 只写确认主题，`prompt` 只写用户当前需要回答的问题；搭建模式、导航归属保持中性，不标记“推荐”或“默认”，不预选、不按偏好排序，也不在引导或描述中推荐。导航布局和呈现样式根据场景确定，不进入提问选项；用户明确的布局和样式优先。其他问题存在合理默认值时可标记。只有某个选择会产生重要且难以撤销的影响时，才在对应选项的 `description` 中说明影响。
+4. `title` 只写确认主题，`prompt` 只写用户当前需要回答的问题；搭建模式保持中性，不标记“推荐”或“默认”，不预选、不按偏好排序，也不在引导或描述中推荐。导航方式、布局和呈现样式由 AI 根据场景确定，用户明确要求优先。其他问题存在合理默认值时可标记。只有某个选择会产生重要且难以撤销的影响时，才在对应选项的 `description` 中说明影响。
 5. 用户已经提供的信息直接写入内部事实，不重复总结成“缺口分析”或再次追问。
 6. PRD 的业务说明、HTML、进度消息和交付总结使用功能、体验和验收结果描述配置。接口参数、配置键值、内部 ID 和 CLI 选项保留在 Agent 实施交接中；访问链接使用业务名称，链接目标保留必需参数。用户明确询问实现细节时，再解释对应技术内容。
 7. 规划写预期行为，进度写正在进行的动作，完成总结依据实际验证结果。导航方案写“采用自定义导航，支持各业务页面间切换”；完成配置并验证跳转后写“已启用自定义导航，可在各业务页面间切换”。
@@ -100,7 +100,6 @@ Fast / Plan 是面向用户的模式名称，可以展示。已有详细计划
 | ---------------- | ---------------------------------------------- | ---------------------------- | ----------------------------- |
 | 搭建方式 | `single_choice` | 按需求详细程度提供 PRD 是/否或 Fast/Plan | brief 的 `intake.designMode` |
 | 业务模块与页面范围 | `multi_choice` | 具体业务模块、对应页面、表单及用途，可合为一题 | brief 的 `coreFunctions/businessObjects/pageScenes/explicitScope` |
-| 导航归属 | `single_choice` | 仅“宜搭原生导航”和“自定义导航”两个选项；原生导航就是平台导航，布局根据场景确定 | brief 的 `navigation`（按场景补齐 `type`，自定义含 `variant`，`reason` 区分用户归属选择与布局依据） |
 | 应用设计风格 | `single_choice` | 面向业务的风格选项与自定义偏好 | brief 的 `visualSelection` |
 | 来源补齐         | `free_text`                                    | 可读正文、链接或附件         | `meta.source`                 |
 | 最新搭建计划确认 | `confirm`                                      | 当前版本、确认生成、继续调整 | `meta.planState`              |
@@ -124,9 +123,9 @@ Fast / Plan 是面向用户的模式名称，可以展示。已有详细计划
 
 ## 首次搭建确认
 
-先完成需求分析，再按 [首次搭建确认表](../../yida-requirement-analysis/workflow/prepare-brief.md#2-确认首次搭建的未决事项) 询问尚未明确的事项。该表统一维护详细计划复用、搭建方式、业务模块、导航归属、风格和页面范围；已有业务应用的局部增改按本次疑问澄清。
+先完成需求分析，再按 [首次搭建确认表](../../yida-requirement-analysis/workflow/prepare-brief.md#2-确认首次搭建的未决事项) 询问尚未明确的事项。该表统一维护详细计划复用、搭建方式、业务模块、风格和页面范围；已有业务应用的局部增改按本次疑问澄清。
 
-首次搭建的全部未决事项在一次结构化提问调用中呈现并一次性作答，Fast / Plan、导航归属、业务模块和页面范围不得分轮收集。导航仅提供“宜搭原生导航”和“自定义导航”两个选项，按 [导航选项说明](../../yida-requirement-analysis/workflow/prepare-brief.md#导航选项说明) 附带实现方式说明；宜搭原生导航就是平台导航。支持 `description` 时写入该字段，否则在选项后括号备注。顶部、侧边、L 型、浮导、底部菜单等布局或样式不进入 `ask_human`；Agent 在已选归属内根据场景确定，记录布局依据并交给后续规划，不补问位置。用户已明确的归属、布局或样式直接沿用。工具限制问题数量时合并为复合问题，多选能力不足时使用同组自由输入；没有可用结构化工具时，在一条消息中展示全部问题。具体合并方式遵守首次搭建确认表，全部必要回答写回后才开始后续规划。
+首次搭建的全部未决事项在一次结构化提问调用中呈现并一次性作答，Fast / Plan、业务模块和页面范围不得分轮收集。导航按 [导航设计](../../yida-requirement-analysis/workflow/prepare-brief.md#导航设计) 确定，用户已明确的方式、布局或样式直接沿用。工具限制问题数量时合并为复合问题，多选能力不足时使用同组自由输入；没有可用结构化工具时，在一条消息中展示全部问题。具体合并方式遵守首次搭建确认表，全部必要回答写回后才开始后续规划。
 
 视觉映射统一写入 brief 的 `visualSelection`，由后续计划沿用 visualDirection、selectedTheme、colorStrategy、navigationStyle；未选候选保留在会话中。
 
@@ -141,7 +140,7 @@ Plan Design 完成当前版本后，按以下顺序与用户交互：
 
 `build-plan.html` 不承载对话控件或确认按钮；用户在会话中完成确认。
 
-最终确认使用以下逻辑问题，其中 `{revision}` 替换为当前版本号：
+最终确认是一个 `single_select` 语义问题：只使用一个顶层 `question` 和恰好两个顶层 `options`，附件与版本必须放在同一次调用中。下面先记录内部逻辑身份；`interactionId`、`questionType`、`prompt`、`allowCustom` 和 `writeBackPath` 只用于状态理解，不是可传给工具的参数：
 
 ```json
 {
@@ -173,6 +172,41 @@ Plan Design 完成当前版本后，按以下顺序与用户交互：
 }
 ```
 
+#### 实际 `ask_human` 调用参数
+
+模型必须直接复制下面的可调用结构，并将路径、`{revision}` 替换为本次 materialize 返回的真实值：
+
+```json
+{
+  "question": "是否按当前这版方案开始搭建？",
+  "title": "确认整体方案",
+  "options": [
+    {
+      "value": "confirm_build",
+      "label": "确认并开始搭建",
+      "description": "按当前方案创建应用、表单、流程和页面。"
+    },
+    {
+      "value": "continue_editing",
+      "label": "继续调整",
+      "description": "继续完善当前方案，确认后再开始搭建。"
+    }
+  ],
+  "attachments": [
+    {
+      "name": "build-plan.html",
+      "path": "prd/<项目名>/build-plan.html"
+    }
+  ],
+  "revision": "{revision}",
+  "submitLabel": "提交选择"
+}
+```
+
+最终确认 payload 禁止使用 `fields`、`text`、`textarea`，也禁止增加“调整说明”或其他条件式补充问题；`options` 的 value 集合必须恰好为 `confirm_build`、`continue_editing`。确认与调整内容不能合并收集。
+
+用户选择 `continue_editing` 后保持在 Plan Design，本次确认恢复不创建任何应用资源；在下一轮用新的问题单独收集要修改的内容，完成 patch/materialize、生成新 revision 后，再展示同样结构的最终确认。用户选择 `confirm_build` 且回传 revision 匹配时，才进入资源实施。
+
 ## 版本与确认状态
 
 `build-plan.json` 使用 `meta.revision`、`meta.status` 和 `meta.planState` 共同记录当前计划状态：
@@ -198,4 +232,4 @@ Plan Design 完成当前版本后，按以下顺序与用户交互：
 3. 计划展示完成后设置 `meta.status=awaiting_confirmation` 和 `presentedRevision=meta.revision`。
 4. 用户在最终确认交互中选择“确认并开始搭建”时，设置 `meta.status=confirmed`、`planConfirmed=true`、`confirmedRevision=meta.revision`，同时记录交互 ID 和确认时间。
 5. 只有 `meta.status=confirmed`、`planConfirmed=true` 且 `meta.revision=presentedRevision=confirmedRevision` 时，Plan Design 才能返回 `yida-app` Step 3。
-6. 用户选择“继续调整”时保持在 Plan Design；用户取消或关闭交互时停止执行，不创建应用资源。
+6. 用户选择“继续调整”时保持在 Plan Design，本轮不创建应用资源；下一轮单独收集调整内容，生成新 revision 并重新确认。用户取消或关闭交互时停止执行，不创建应用资源。

package/yida-skills/skills/yida-design/sub_skill/yida-design-plan/references/build-plan-schema.md

@@ -142,7 +142,7 @@
 
 约束：
 
-- 计划生成前先确定应用范围与导航类型，再选择视觉方向。范围和导航归属不明时可合并询问，导航选项仅为“宜搭原生导航”和“自定义导航”；原生导航即平台导航，顶部、侧边、L 型等布局由 Agent 按场景确定，不进入 `ask_human`。回答后生成遵守导航决策的视觉候选；每个问题必须有 `interactionId` 和 `writeBackPath`。
+- 计划生成前先确定应用范围，导航方式与布局按 [导航设计](../../../../yida-requirement-analysis/workflow/prepare-brief.md#导航设计) 写入 brief，用户明确要求优先。视觉候选沿用该导航决策，随整体方案确认。其余必要问题必须有 `interactionId` 和 `writeBackPath`。
 - `questionType` 只取 `single_choice`、`multi_choice`、`free_text` 或最终计划使用的 `confirm`，不设置 AI 代填项中间确认类型。
 - 只有宽泛应用名称且缺少模块、场景、任务、流程和可读需求时才问应用范围。
 - 审批、角色权限、字段、首页、看板、页面和常规流程细节不进入 `ask_human`；用户已提供时承接，未提供时基于业务推断并在最终计划统一呈现。

package/yida-skills/skills/yida-design/workflow/step-4-wireframe-interaction.md

@@ -13,7 +13,7 @@
 
 ## 自定义导航设计
 
-沿用需求阶段用户选择的导航归属，以及根据场景确定或用户指定的布局；不再询问顶部、侧边等布局选项。参考 [导航壳形态目录](../../yida-nav-shell/references/nav-shell-patterns.md) 设计位置、比例、留白与选中态，代码示例只按需参考。顶部默认浮导；侧导及顶部＋侧边布局写清折叠/展开、恢复宽度、拖拽边界、内容区联动和移动端收起方式。已有满意的导航保留外观，只补缺失交互。
+沿用 brief 中 AI 判断或用户明确指定的导航方式与布局。参考 [导航壳形态目录](../../yida-nav-shell/references/nav-shell-patterns.md) 设计位置、比例、留白与选中态，代码示例只按需参考。顶部默认浮导；侧导及顶部＋侧边布局写清折叠/展开、恢复宽度、拖拽边界、内容区联动和移动端收起方式。已有满意的导航保留外观，只补缺失交互。
 
 区分三种操作：本页视图切换、保留导航并更新主内容 iframe、当前标签跨页跳转。管理入口使用 workbench，办理入口使用 submission；不要把应用级办理导航设计为每次弹抽屉。页面内新增/详情按钮才采用下面的抽屉规则。设计结果写入当前 `design.md`；Plan 模式先更新计划源事实再物化。
 

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

@@ -421,6 +421,7 @@ openyida integration diagnose --file project/tickets/automation-error.txt --json
 - 流水号：新增/编辑触发时，触发 payload 中的流水号可能为空或不是最新值；需要先获取自身，再引用获取节点里的流水号。
 - 定时自动化：定时触发值可能是历史数据；需要最新值时先获取自身或获取目标数据。
 - 直接更新：匹配字段只能消费当前触发表字段，不能随意匹配前置节点字段；文本字段不要匹配单选/多选字段。直接更新不会触发被更新表单上的集成自动化。
+- 跨应用写入不级联触发（阻塞项）：A 应用表单的集成自动化通过内置新增/编辑/删除数据节点写 B 应用表单（跨应用）时，B 表单上已配置的新增/编辑/删除自动触发集成业务流不会生效。涉及跨应用链式联动时这是阻塞项，不得假设 B 表自动化会被接力触发。
 - 条件分支：空值判断优先用公式 `ISEMPTY()`，不要只依赖“没有值”选项。
 - 异常重试：重试通常会从头执行，已执行过的新增/更新节点可能再次写入或覆盖数据；重试前先确认幂等性。
 

package/yida-skills/skills/yida-nav-shell/SKILL.md

@@ -1,13 +1,13 @@
 ---
 name: yida-nav-shell
-description: 自定义页明确要自绘应用级导航时使用；先隐藏应用导航 hideAppNav。页面级 isRenderNav=false 不等于应用导航隐藏。
+description: 需求规划采用自定义应用导航或用户明确要求自绘时使用；先隐藏应用导航 hideAppNav。页面级 isRenderNav=false 不等于应用导航隐藏。
 ---
 
 # yida-nav-shell
 
 ## 先判断
 
-默认不用本技能。宜搭应用的页面切换优先交给平台导航和 `yida-nav-group`。
+按 brief/PRD 的导航决策路由：采用自定义应用导航时使用本技能；采用宜搭原生导航时使用 `yida-nav-group`。导航方式由 [需求分析](../yida-requirement-analysis/workflow/prepare-brief.md#导航设计) 判断，用户明确要求优先。
 
 | 用户需求 | 怎么处理 |
 | --- | --- |
@@ -26,7 +26,7 @@ description: 自定义页明确要自绘应用级导航时使用；先隐藏应
 
 ## 必做配置
 
-用户确认自定义导航后，就将应用导航隐藏纳入应用基础设置更新：新建应用时，等 `app-theme.css` 生成后，将 `--hide-app-nav` 与主题、Logo、布局等设置合并到同一次 `update-app`，按 [应用设置同步](../yida-app/workflow/step-3-create-or-reuse-app.md) 执行并回读。已有应用只需切换导航时执行：
+需求规划采用自定义导航后，就将应用导航隐藏纳入应用基础设置更新：新建应用时，等 `app-theme.css` 生成后，将 `--hide-app-nav` 与主题、Logo、布局等设置合并到同一次 `update-app`，按 [应用设置同步](../yida-app/workflow/step-3-create-or-reuse-app.md) 执行并回读。已有应用只需切换导航时执行：
 
 ```bash
 openyida update-app <appType> --hide-app-nav
@@ -50,7 +50,7 @@ openyida get-form-config <appType> <formUuid> --json
 - **画布与浮导间距**：平台宿主继续消费 `--pod-page-bg-color`；自绘导航页的内部画布由 `design.md` 定义，可采用浅灰、浅彩、渐变或局部纹理，不强制跟随白色平台底色。浅色非白画布上，顶部浮导默认白色或近白半透明，卡片默认白色无框；品牌色集中于选中态和主操作，深色方案单独设计。只作用于当前页面选择器，不修改应用全局变量。根节点使用 `display:flow-root` 或 flex/grid，让浮导上边距留在根节点内。
 
 - **先选形态，再写 UI**：根据已确认的 PRD、`design.md` 和用户参考确定布局。模块多用侧栏，模块少且内容需要宽度用顶部，两级业务用顶部＋侧边，沉浸展示可用悬浮 Dock，同模块视图用标签。已确认的选择直接沿用，不重新提问。
-- 自定义顶部导航默认推荐浮导，可按内容宽度设计为紧凑胶囊或悬浮栏；“顶部导航”不等于贴边通栏。位置、比例、留白、材质和选中态根据业务与设计实现，不由现成组件决定。此推荐只针对顶部样式，“平台导航 / 自定义导航”选项保持中性。
+- 自定义顶部导航默认推荐浮导，可按内容宽度设计为紧凑胶囊或悬浮栏；“顶部导航”不等于贴边通栏。位置、比例、留白、材质和选中态根据业务与设计实现，不由现成组件决定。此推荐只针对顶部样式，不改变已确定的导航方式。
 - 需要布局方向和小段代码时读 [导航壳形态目录](references/nav-shell-patterns.md)。按场景设计和手写实现，不强制复制任何导航组件。已有导航符合设计时直接复用，只补缺失功能；不能仅因存在新示例而替换现有外观。
 - 自定义侧边导航（含顶部＋侧边）的 PC 端必须支持折叠/展开和拖拽调宽；展开恢复折叠前宽度，宽度变化时内容区同步调整。移动端改为可展开/收起的菜单，详见 [侧栏交互](references/nav-shell-patterns.md#侧栏交互)。
 - 菜单数量、名称、顺序、分组和入口用途来自 PRD，通常工作台在首位；用当前访问者的 `getAccessableNavs.json` 过滤可见范围，详见 [导航数据来源](references/nav-shell-patterns.md#导航数据来源)。数据逻辑可直接复用，不要求采用同一套 UI。

package/yida-skills/skills/yida-prd/workflow/output-prd.md

@@ -24,11 +24,11 @@
 
 | 配置项 | 值 |
 | --- | --- |
-| 导航类型 | <平台L型导航 / 平台顶部导航 / 平台侧边导航 / 自定义导航；按用户选择的归属和场景确定具体布局> |
+| 导航类型 | <平台L型导航 / 平台顶部导航 / 平台侧边导航 / 自定义导航；沿用需求阶段的导航判断和用户明确要求> |
 | 是否使用平台应用导航 | <前三种为是，自定义导航为否> |
 | 页面导航配置 | <自定义导航：列出本轮全部表单、流程表单、自定义页面及需配置的其他页面，统一隐藏平台页面导航；平台导航：保留页面设置，明确独立入口例外> |
 
-用户仅选择宜搭原生导航（即平台导航）或自定义导航；上表记录可执行方案，平台顶部、侧边、L 型以及自定义布局由 Agent 根据场景确定，用户已指定的布局优先。导航方案区分用户选择的归属与布局判断依据，说明页面入口和跨页切换方式；导航配色单独说明深色或浅色。
+导航方式与布局沿用 brief 中的决策，判断规则见 [导航设计](../../yida-requirement-analysis/workflow/prepare-brief.md#导航设计)。上表记录可执行方案和依据，区分用户明确要求与 AI 判断，说明页面入口和跨页切换方式；导航配色单独说明深色或浅色。
 
 ## 3. 数据结构（业务语义，不含细节 ID）