openyida 1.0.0-beta.2 → 1.0.0-beta.5

package/README.md

@@ -156,9 +156,13 @@ npx clawhub@latest install nicky1108/yida-app
 感谢所有为 OpenYida 做出贡献的开发者！欢迎阅读 [贡献指南](./CONTRIBUTING.md) 参与共建。
 
 <p align="left">
-  <a href="https://github.com/yize"><img src="https://avatars.githubusercontent.com/u/1578814?v=4&s=48" width="48" height="48" alt="yize" title="yize"/></a>
-  <a href="https://github.com/alex-mm"><img src="https://avatars.githubusercontent.com/u/3302053?v=4&s=48" width="48" height="48" alt="alex-mm" title="alex-mm"/></a>
+  <a href="https://github.com/yize"><img src="https://avatars.githubusercontent.com/u/1578814?v=4&s=48" width="48" height="48" alt="九神" title="九神"/></a>
+  <a href="https://github.com/alex-mm"><img src="https://avatars.githubusercontent.com/u/3302053?v=4&s=48" width="48" height="48" alt="天晟" title="天晟"/></a>
   <a href="https://github.com/nicky1108"><img src="https://avatars.githubusercontent.com/u/4279283?v=4&s=48" width="48" height="48" alt="nicky1108" title="nicky1108"/></a>
+  <a href="https://github.com/angelinheys"><img src="https://avatars.githubusercontent.com/u/49426983?v=4&s=48" width="48" height="48" alt="angelinheys" title="angelinheys"/></a>
+  <a href="https://github.com/yipengmu"><img src="https://avatars.githubusercontent.com/u/3232735?v=4&s=48" width="48" height="48" alt="yipengmu" title="yipengmu"/></a>
+  <a href="https://github.com/Waawww"><img src="https://avatars.githubusercontent.com/u/31886449?v=4&s=48" width="48" height="48" alt="Waawww" title="Waawww"/></a>
+  <a href="https://github.com/kangjiano"><img src="https://avatars.githubusercontent.com/u/54129385?v=4&s=48" width="48" height="48" alt="kangjiano" title="kangjiano"/></a>
 </p>
 
 ---

package/bin/yida.js

@@ -18,7 +18,7 @@
  *   openyida org switch --corp-id <corpId>              切换组织（无需重新登录）
  *   openyida create-app "<名称>" [desc] [icon] [color]  创建应用
  *   openyida create-page <appType> "<页面名>"            创建自定义页面
- *   openyida create-form create <appType> "<表单名>" <字段JSON>  创建表单页面
+ *   openyida create-form create <appType> "<表单名>" <字段JSON> [--layout <布局>] [--theme <主题>] [--label-align <对齐>]  创建表单页面
  *   openyida create-form update <appType> <formUuid> <修改JSON>  更新表单页面
  *   openyida get-schema <appType> <formUuid>            获取表单 Schema
  *   openyida publish <源文件路径> <appType> <formUuid>   编译并发布自定义页面
@@ -26,6 +26,7 @@
  *   openyida save-share-config <appType> <formUuid> <url> <isOpen> [openAuth]  保存公开访问/分享配置
  *   openyida get-page-config <appType> <formUuid>       查询页面公开访问/分享配置
  *   openyida update-form-config <appType> <formUuid> <isRenderNav> <title>  更新表单配置
+ *   openyida doctor [选项]                              检查环境依赖，诊断应用问题
  *   openyida export <appType> [output]                  导出应用所有表单 Schema（生成迁移包）
  *   openyida import <file> [name]                       导入迁移包，在目标环境重建应用
  */
@@ -43,6 +44,58 @@ const command = process.argv[2];
 const args = process.argv.slice(3);
 
 function printHelp() {
+  console.log(`
+openyida - 宜搭命令行工具
+
+用法：
+  openyida <命令> [参数...]（别名：yida）
+
+命令：
+  env                                                          检测当前 AI 工具环境和登录态
+  copy [--force]                                               复制 project 工作目录到当前 AI 工具环境
+  login                                                        登录态管理（优先缓存，否则扫码）
+  logout                                                       退出登录 / 切换账号
+  create-app "<名称>" [描述] [图标] [颜色]                      创建应用，输出 appType
+  create-page <appType> "<页面名>"                             创建自定义页面，输出 pageId
+  create-form create <appType> "<表单名>" <字段JSON> [--layout <布局>] [--theme <主题>] [--label-align <对齐>]  创建表单页面
+  create-form update <appType> <formUuid> <修改JSON>           更新表单页面
+  get-schema <appType> <formUuid>                              获取表单 Schema
+  publish <源文件路径> <appType> <formUuid>                    编译并发布自定义页面
+  verify-short-url <appType> <formUuid> <url>                  验证短链接 URL 是否可用
+  save-share-config <appType> <formUuid> <url> <isOpen> [auth] 保存公开访问/分享配置
+  get-page-config <appType> <formUuid>                         查询页面公开访问/分享配置
+  update-form-config <appType> <formUuid> <isRenderNav> <title> 更新表单配置
+  doctor [选项]                                                检查环境依赖，诊断应用问题
+    --fix / --repair                                           诊断并自动修复
+    --production --app <appId>                                 线上应用诊断
+    --monitor                                                  启动实时健康度监控
+    --report <format>                                          生成诊断报告（json | markdown | html）
+    --create-ticket                                            根据诊断结果创建工单
+    --create-voc                                               创建 VOC（需求反馈）
+    --auto-submit                                              自动判断并提交工单或 VOC
+
+示例：
+  openyida login
+  openyida logout
+  openyida create-app "考勤管理"
+  openyida create-page APP_XXX "游戏主页"
+  openyida create-form create APP_XXX "员工信息" fields.json
+  openyida create-form update APP_XXX FORM-XXX '[{"action":"add","field":{"type":"TextField","label":"备注"}}]'
+  openyida get-schema APP_XXX FORM-XXX
+  openyida publish pages/src/home.jsx APP_XXX FORM-XXX
+  openyida verify-short-url APP_XXX FORM-XXX /o/myapp
+  openyida save-share-config APP_XXX FORM-XXX /o/myapp y n
+  openyida get-page-config APP_XXX FORM-XXX
+  openyida update-form-config APP_XXX FORM-XXX false "页面标题"
+  openyida doctor                                 完整诊断
+  openyida doctor --fix                           诊断并自动修复
+  openyida doctor --production --app APP_XXX      线上应用诊断
+  openyida doctor --monitor                       实时监控
+  openyida doctor --report markdown               生成 Markdown 报告
+  openyida doctor --create-ticket                 创建工单
+  openyida doctor --create-voc                    创建 VOC
+  openyida doctor --auto-submit                   自动判断并提交
+`);
   console.log(t('cli.help'));
 }
 
@@ -304,6 +357,12 @@ async function main() {
       break;
     }
 
+    case 'doctor': {
+      const { run } = require('../lib/doctor');
+      await run(args);
+      break;
+    }
+
     case 'export': {
       if (args.length < 1) {
         console.error(t('cli.export_usage'));

package/lib/copy.js

@@ -5,6 +5,7 @@
  *   openyida copy                → 复制 project/ 目录模板（默认，合并模式）
  *   openyida copy --force        → 复制 project/ 目录模板（强制覆盖，先清空目标目录）
  *   openyida copy -skills        → 创建 yida-skills/ 软链接（如果存在实际目录则先删除）
+ *                                  悟空环境下：删除已有软链（悟空通过手动上传技能，不需要软链）
  *   openyida copy -project       → 复制 project/ 目录模板（与默认行为相同，显式指定）
  *   openyida copy -project --force → 复制 project/ 目录模板（强制覆盖）
  *
@@ -16,7 +17,12 @@
  *
  * project/ 合并模式（默认）：已存在的文件强制覆盖，目标目录中多余的文件保留不动
  * project/ 强制模式（--force）：先清空目标目录，再完整复制
- * yida-skills/：始终创建软链接，如目标存在实际目录则先删除
+ * yida-skills/（非悟空）：始终创建软链接，如目标存在实际目录则先删除
+ * yida-skills/（悟空）：删除已有软链或目录（悟空通过手动上传技能，不需要软链）
+ *
+ * Windows 兼容说明：
+ *   - 软链接在 Windows 上需要管理员权限或开发者模式，失败时自动降级为目录复制
+ *   - 路径分隔符统一使用 path.join 处理
  */
 
 "use strict";
@@ -94,15 +100,22 @@ function forceCopyDir(sourceDir, destDir) {
 }
 
 /**
- * 创建软链接：如果目标存在实际目录则先删除，再创建软链接。
- * @returns {boolean} 是否成功创建
+ * 删除已有的 yida-skills 软链接或目录（悟空环境专用）。
+ * 悟空通过手动上传技能，不需要软链，执行 -skills 时只做清理。
+ * 使用 lstatSync 而非 existsSync，可以检测到悬空软链（目标不存在但链接本身存在）。
+ * @returns {boolean} 是否执行了删除操作
  */
-function createSymlink(sourceDir, destLink) {
-  if (!fs.existsSync(sourceDir)) return false;
+function removeSkillsLink(destLink) {
+  let stats;
+  try {
+    stats = fs.lstatSync(destLink);
+  } catch {
+    // 路径不存在（包括悬空软链也不存在的情况）
+    console.log(t("copy.wukong_skills_not_found", destLink));
+    return false;
+  }
 
-  // 如果目标已存在，判断是目录还是软链接
-  if (fs.existsSync(destLink)) {
-    const stats = fs.lstatSync(destLink);
+  try {
     if (stats.isSymbolicLink()) {
       fs.unlinkSync(destLink);
       console.log(t("copy.symlink_removed", destLink));
@@ -113,20 +126,69 @@ function createSymlink(sourceDir, destLink) {
       fs.unlinkSync(destLink);
       console.log(t("copy.removed", destLink));
     }
+    return true;
+  } catch (error) {
+    console.error(t("copy.remove_failed", destLink, error.message));
+    return false;
   }
+}
 
-  fs.symlinkSync(sourceDir, destLink, "junction");
-  console.log(t("copy.symlink_created", destLink, sourceDir));
-  return true;
+/**
+ * 创建软链接：如果目标存在实际目录则先删除，再创建软链接。
+ * Windows 上软链需要管理员权限或开发者模式，失败时自动降级为目录复制。
+ * @returns {boolean} 是否成功创建
+ */
+function createSymlink(sourceDir, destLink) {
+  if (!fs.existsSync(sourceDir)) return false;
+
+  // 如果目标已存在，判断是目录还是软链接
+  if (fs.existsSync(destLink)) {
+    try {
+      const stats = fs.lstatSync(destLink);
+      if (stats.isSymbolicLink()) {
+        fs.unlinkSync(destLink);
+        console.log(t("copy.symlink_removed", destLink));
+      } else if (stats.isDirectory()) {
+        fs.rmSync(destLink, { recursive: true, force: true });
+        console.log(t("copy.dir_deleted", destLink));
+      } else {
+        fs.unlinkSync(destLink);
+        console.log(t("copy.removed", destLink));
+      }
+    } catch (error) {
+      console.error(t("copy.remove_failed", destLink, error.message));
+      return false;
+    }
+  }
+
+  // Windows 上 junction 只支持目录，且需要管理员权限或开发者模式
+  // 失败时降级为目录复制
+  const symlinkType = process.platform === "win32" ? "junction" : "dir";
+  try {
+    fs.symlinkSync(sourceDir, destLink, symlinkType);
+    console.log(t("copy.symlink_created", destLink, sourceDir));
+    return true;
+  } catch (error) {
+    if (process.platform === "win32" && error.code === "EPERM") {
+      console.log(t("copy.symlink_fallback_copy", destLink));
+      const count = mergeCopyDir(sourceDir, destLink);
+      console.log(t("copy.files_copied", count));
+      return true;
+    }
+    console.error(t("copy.symlink_failed", destLink, error.message));
+    return false;
+  }
 }
 
 /**
- * 检测 AI 工具环境，返回目标根目录。
+ * 根据已检测的环境信息返回目标根目录，避免重复调用 detectEnvironment()。
+ * @param {string|null} activeToolName
+ * @param {string|null} activeProjectRoot
+ * @param {Array} envResults
  * @returns {string} 目标根目录路径
  */
-function resolveDestBase() {
-  const { activeToolName, activeProjectRoot, results } = detectEnvironment();
-  const activeResult = results.find((r) => r.displayName === activeToolName);
+function resolveDestBaseFromEnv(activeToolName, activeProjectRoot, envResults) {
+  const activeResult = envResults.find((r) => r.displayName === activeToolName);
   const isWukong = activeResult && activeResult.dirName === ".real";
 
   if (isWukong) {
@@ -141,7 +203,7 @@ function resolveDestBase() {
 
   // 未检测到活跃工具
   console.error(t("copy.no_ai_tool"));
-  results.forEach((r) => {
+  envResults.forEach((r) => {
     console.error(`     ${r.isActive ? "✅" : "⬜"} ${r.displayName}`);
   });
   console.error(t("copy.force_hint"));
@@ -188,17 +250,24 @@ function run() {
   console.log(t("copy.package_root", packageRoot));
 
   // 2. 确定目标根目录（检测 AI 工具环境）
-  const destBase = resolveDestBase();
+  // 同时获取 isWukong 标志，避免后续重复调用 detectEnvironment()
+  const { activeToolName, activeProjectRoot, results: envResults } = detectEnvironment();
+  const activeEnvResult = envResults.find((r) => r.isActive);
+  const isWukong = activeEnvResult && activeEnvResult.dirName === ".real";
+  const destBase = resolveDestBaseFromEnv(activeToolName, activeProjectRoot, envResults);
   console.log(t("copy.dest_base", destBase));
   if (isForce) {
     console.log(t("copy.force_mode"));
   }
 
   // 3. 确定要复制/链接的内容
-  //    - 指定了 -skills：只创建 yida-skills/ 软链接
+  //    - 指定了 -skills：
+  //        悟空环境：删除已有的 yida-skills/ 软链（悟空手动上传技能，不需要软链）
+  //        其他环境：创建 yida-skills/ 软链接（如果存在实际目录则先删除）
   //    - 指定了 -project：只复制 project/
   //    - 两者都没指定（默认）：只复制 project/
   //    - 两者都指定：同时处理两项
+
   const shouldCopyProject = wantsProject || (!wantsSkills);
   const shouldLinkSkills = wantsSkills;
 
@@ -215,17 +284,28 @@ function run() {
   }
 
   if (shouldLinkSkills) {
-    console.log(t("copy.creating_symlink"));
-    const success = createSymlink(
-      packageYidaSkillsDir,
-      path.join(destBase, "yida-skills")
-    );
-    results.push({
-      label: "yida-skills/",
-      dest: path.join(destBase, "yida-skills"),
-      count: success ? 1 : 0,
-      type: "symlink"
-    });
+    const destSkillsLink = path.join(destBase, "yida-skills");
+    if (isWukong) {
+      // 悟空环境：删除已有软链，不创建新软链
+      console.log(t("copy.wukong_skills_cleanup"));
+      const removed = removeSkillsLink(destSkillsLink);
+      results.push({
+        label: "yida-skills/",
+        dest: destSkillsLink,
+        count: removed ? 1 : 0,
+        type: "wukong-cleanup"
+      });
+    } else {
+      // 其他环境：创建软链接
+      console.log(t("copy.creating_symlink"));
+      const success = createSymlink(packageYidaSkillsDir, destSkillsLink);
+      results.push({
+        label: "yida-skills/",
+        dest: destSkillsLink,
+        count: success ? 1 : 0,
+        type: "symlink"
+      });
+    }
   }
 
   // 4. 打印汇总
@@ -242,6 +322,9 @@ function run() {
   results.forEach((r) => {
     if (r.type === "symlink") {
       console.log(`   ${r.label.padEnd(14)} → ${r.dest} (${t("copy.symlink_label")})`);
+    } else if (r.type === "wukong-cleanup") {
+      const statusText = r.count > 0 ? t("copy.wukong_skills_cleaned") : t("copy.wukong_skills_not_found", r.dest);
+      console.log(`   ${r.label.padEnd(14)} → ${r.dest} (${statusText})`);
     } else {
       console.log(`   ${r.label.padEnd(14)} → ${r.dest} (${t("copy.files_count", r.count)})`);
     }

package/lib/create-form.js

@@ -95,7 +95,35 @@ function buildApiPath(appType, apiName, options = {}) {
 // ── 参数解析 ─────────────────────────────────────────
 
 function parseArgs() {
-  const args = process.argv.slice(2);
+  const rawArgs = process.argv.slice(2);
+  
+  // 解析可选参数
+  const options = {
+    layout: "single",  // 布局：single/double/card/section
+    theme: "default",  // 主题：default/compact/comfortable
+    labelAlign: "top", // 标签对齐：top/left/right
+  };
+
+  // 复制一份 args 用于解析（避免修改原始数组影响后续处理）
+  const args = [...rawArgs];
+  
+  // 解析 --layout, --theme, --label-align 参数
+  for (let i = 0; i < args.length; i++) {
+    if (args[i] === "--layout" && i + 1 < args.length) {
+      options.layout = args[i + 1];
+      args.splice(i, 2);
+      i--;
+    } else if (args[i] === "--theme" && i + 1 < args.length) {
+      options.theme = args[i + 1];
+      args.splice(i, 2);
+      i--;
+    } else if (args[i] === "--label-align" && i + 1 < args.length) {
+      options.labelAlign = args[i + 1];
+      args.splice(i, 2);
+      i--;
+    }
+  }
+
   const mode = args[0];
 
   if (mode === "create") {
@@ -104,7 +132,13 @@ function parseArgs() {
       console.error(t("create_form.example_create"));
       process.exit(1);
     }
-    return { mode: "create", appType: args[1], formTitle: args[2], fieldsJsonOrFile: args[3] };
+    return { 
+      mode: "create", 
+      appType: args[1], 
+      formTitle: args[2], 
+      fieldsJsonOrFile: args[3],
+      ...options
+    };
   }
 
   if (mode === "update") {
@@ -113,12 +147,24 @@ function parseArgs() {
       console.error(t("create_form.example_update"));
       process.exit(1);
     }
-    return { mode: "update", appType: args[1], formUuid: args[2], changesJsonOrFile: args[3] };
+    return { 
+      mode: "update", 
+      appType: args[1], 
+      formUuid: args[2], 
+      changesJsonOrFile: args[3],
+      ...options
+    };
   }
 
   // 兼容旧用法（无 mode 参数，默认 create 模式）
   if (args.length >= 3 && mode !== "create" && mode !== "update") {
-    return { mode: "create", appType: args[0], formTitle: args[1], fieldsJsonOrFile: args[2] };
+    return { 
+      mode: "create", 
+      appType: args[0], 
+      formTitle: args[1], 
+      fieldsJsonOrFile: args[2],
+      ...options
+    };
   }
 
   console.error(t("create_form.usage_label"));
@@ -1007,10 +1053,160 @@ function resolveFieldIdReferences(fieldComponents) {
   });
 }
 
+// ── 布局配置映射 ─────────────────────────────────────
+
+/**
+ * 获取布局配置
+ * @param {string} layout - 布局类型：single/double/card/section
+ * @returns {object} 布局配置对象 { columns, formLayout, groupFields }
+ */
+function getLayoutConfig(layout) {
+  const layoutMap = {
+    single: { columns: 1, formLayout: "default", groupFields: false },
+    "1": { columns: 1, formLayout: "default", groupFields: false },
+    double: { columns: 2, formLayout: "default", groupFields: false },
+    "2": { columns: 2, formLayout: "default", groupFields: false },
+    card: { columns: 1, formLayout: "card", groupFields: true },
+    section: { columns: 1, formLayout: "section", groupFields: true },
+  };
+  return layoutMap[layout] || layoutMap.single;
+}
+
+/**
+ * 获取主题样式配置
+ * @param {string} theme - 主题类型：default/compact/comfortable
+ * @param {string} labelAlign - 标签对齐：top/left/right
+ * @returns {object} 样式配置对象
+ */
+function getThemeConfig(theme, labelAlign) {
+  const baseConfig = {
+    labelAlignPc: labelAlign || "top",
+    labelWidthPc: labelAlign === "left" || labelAlign === "right" ? "130px" : "auto",
+    labelWeightPc: "normal",
+    contentMargin: "20",
+    contentPadding: "20",
+    fieldSpacing: "medium",
+  };
+
+  const themeMap = {
+    default: {
+      ...baseConfig,
+      contentMargin: "20",
+      contentPadding: "20",
+    },
+    compact: {
+      ...baseConfig,
+      contentMargin: "12",
+      contentPadding: "12",
+      fieldSpacing: "small",
+    },
+    comfortable: {
+      ...baseConfig,
+      contentMargin: "32",
+      contentPadding: "32",
+      fieldSpacing: "large",
+    },
+  };
+
+  return themeMap[theme] || themeMap.default;
+}
+
+// ── 按 group 分组字段 ─────────────────────────────────
+
+/**
+ * 将字段按 group 属性分组
+ * @param {Array} fields - 字段定义数组
+ * @returns {Array} 分组后的字段数组，每个元素是 { groupName, fields }
+ */
+function groupFieldsByGroup(fields) {
+  const groups = [];
+  const groupMap = new Map();
+  
+  fields.forEach((field) => {
+    const groupName = field.group || "基本信息";
+    if (!groupMap.has(groupName)) {
+      groupMap.set(groupName, []);
+    }
+    groupMap.get(groupName).push(field);
+  });
+
+  groupMap.forEach((groupFields, groupName) => {
+    groups.push({ groupName, fields: groupFields });
+  });
+
+  return groups;
+}
+
+// ── 构建分组字段组件 ─────────────────────────────────
+
+/**
+ * 构建分组/卡片布局的字段组件
+ * @param {Array} fields - 字段定义数组
+ * @param {string} formLayout - 布局类型：card/section
+ * @returns {Array} 分组后的组件数组
+ */
+function buildGroupedFieldComponents(fields, formLayout) {
+  const groups = groupFieldsByGroup(fields);
+  
+  return groups.map((group, groupIndex) => {
+    // 构建分组内的字段组件
+    const groupFieldComponents = group.fields.map((field) => buildFieldComponent(field));
+    
+    if (formLayout === "card") {
+      // 卡片式布局：每个分组是一个卡片容器
+      return {
+        componentName: "CardContainer",
+        id: nextNodeId(),
+        props: {
+          title: i18n(group.groupName, group.groupName),
+          collapsible: true,
+          defaultCollapsed: false,
+          showTitle: true,
+          cardStyle: "default",
+          headerStyle: "default",
+          __gridSpan: 1,
+        },
+        condition: true,
+        hidden: false,
+        title: "",
+        isLocked: false,
+        conditionGroup: "",
+        children: groupFieldComponents,
+      };
+    } else {
+      // 分组式布局：每个分组是一个区块
+      return {
+        componentName: "SectionContainer",
+        id: nextNodeId(),
+        props: {
+          title: i18n(group.groupName, group.groupName),
+          collapsible: true,
+          defaultCollapsed: false,
+          showTitle: true,
+          sectionStyle: "default",
+          divider: groupIndex > 0, // 第一个分组不显示分隔线
+          __gridSpan: 1,
+        },
+        condition: true,
+        hidden: false,
+        title: "",
+        isLocked: false,
+        conditionGroup: "",
+        children: groupFieldComponents,
+      };
+    }
+  });
+}
+
 // ── 生成表单 Schema ──────────────────────────────────
 
-function buildFormSchema(formTitle, fields, formUuid, corpId, appType, columns) {
-  columns = columns || 1;
+function buildFormSchema(formTitle, fields, formUuid, corpId, appType, layout, theme, labelAlign) {
+  // 解析布局配置
+  const layoutConfig = getLayoutConfig(layout || "single");
+  const columns = layoutConfig.columns;
+  
+  // 解析主题配置
+  const themeConfig = getThemeConfig(theme || "default", labelAlign || "top");
   const fieldComponents = fields.map(function (field) {
     return buildFieldComponent(field);
   });
@@ -1070,12 +1266,12 @@ function buildFormSchema(formTitle, fields, formUuid, corpId, appType, columns)
         titleColor: "light",
         titleBg: "https://img.alicdn.com/imgextra/i2/O1CN0143ATPP1wIa9TrVvzN_!!6000000006285-2-tps-3360-400.png_.webp",
         backgroundColorCustom: "#f1f2f3",
-        sizePc: "medium",
-        labelAlignPc: "top",
-        labelWidthPc: "130px",
-        labelWeightPc: "normal",
-        labelAlignMobile: "top",
-        labelWidthMobile: "80px",
+        sizePc: themeConfig.fieldSpacing === "small" ? "small" : themeConfig.fieldSpacing === "large" ? "large" : "medium",
+        labelAlignPc: themeConfig.labelAlignPc,
+        labelWidthPc: themeConfig.labelWidthPc,
+        labelWeightPc: themeConfig.labelWeightPc,
+        labelAlignMobile: labelAlign || "top",
+        labelWidthMobile: labelAlign === "left" || labelAlign === "right" ? "80px" : "auto",
         labelWeightMobile: "normal",
       },
       condition: true,
@@ -1150,15 +1346,36 @@ function buildFormSchema(formTitle, fields, formUuid, corpId, appType, columns)
                 afterSubmit: false,
                 onProcessActionValidate: false,
                 afterFormDataInit: false,
-              },
-              condition: true,
-              hidden: false,
-              title: "",
-              isLocked: false,
-              conditionGroup: "",
-              // ★ 核心：FormContainer 内层的字段组件
-              children: fieldComponents,
-            },
+              },              children: [
+                {
+                  componentName: "FormContainer",
+                  id: nextNodeId(),
+                  props: {
+                    formLabel: i18n(formTitle, formTitle),
+                    formLabelVisible: true,
+                    columns: columns,
+                    labelAlign: labelAlign || "top",
+                    submitText: i18n("提交", "Submit"),
+                    stageText: i18n("暂存", "Stage"),
+                    submitAndNewText: i18n("提交并继续", "Submit and New"),
+                    fieldId: "formContainer_" + Date.now().toString(36),
+                    aiFormConfig: { systemPrompt: "", model: "qwen" },
+                    beforeSubmit: false,
+                    afterSubmit: false,
+                    onProcessActionValidate: false,
+                    afterFormDataInit: false,
+                  },
+                  condition: true,
+                  hidden: false,
+                  title: "",
+                  isLocked: false,
+                  conditionGroup: "",
+                  // ★ 核心：FormContainer 内层的字段组件（支持分组布局）
+                  children: layoutConfig.groupFields 
+                    ? buildGroupedFieldComponents(fields, layoutConfig.formLayout)
+                    : fieldComponents,
+                },
+              ],            },
           ],
         },
         {
@@ -1974,7 +2191,7 @@ async function saveSchemaAndUpdateConfig(authRef, appType, formUuid, schema, ver
 // ── create 模式主流程 ─────────────────────────────────
 
 async function mainCreate(parsedArgs, csrfToken, cookies, baseUrl, cookieData) {
-  const { appType, formTitle, fieldsJsonOrFile } = parsedArgs;
+  const { appType, formTitle, fieldsJsonOrFile, layout, theme, labelAlign } = parsedArgs;
 
   const SEP = "=".repeat(50);
   console.error(SEP);
@@ -2025,7 +2242,7 @@ async function mainCreate(parsedArgs, csrfToken, cookies, baseUrl, cookieData) {
     console.error(t("create_form.corp_id_ok", corpId));
   }
 
-  const schema = buildFormSchema(formTitle, fields, formUuid, corpId, appType, columns);
+  const schema = buildFormSchema(formTitle, fields, formUuid, corpId, appType, layout, theme, labelAlign);
   var { configResult } = await saveSchemaAndUpdateConfig(authRef, appType, formUuid, schema, 1, 4);
 
   // 输出结果