openyida 1.0.0-beta.3 → 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>   编译并发布自定义页面
@@ -57,7 +57,7 @@ openyida - 宜搭命令行工具
   logout                                                       退出登录 / 切换账号
   create-app "<名称>" [描述] [图标] [颜色]                      创建应用，输出 appType
   create-page <appType> "<页面名>"                             创建自定义页面，输出 pageId
-  create-form create <appType> "<表单名>" <字段JSON>            创建表单页面
+  create-form create <appType> "<表单名>" <字段JSON> [--layout <布局>] [--theme <主题>] [--label-align <对齐>]  创建表单页面
   create-form update <appType> <formUuid> <修改JSON>           更新表单页面
   get-schema <appType> <formUuid>                              获取表单 Schema
   publish <源文件路径> <appType> <formUuid>                    编译并发布自定义页面

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);
 
   // 输出结果

package/lib/env.js

@@ -17,6 +17,7 @@ const home = os.homedir();
 /**
  * 获取所有已安装的 AI 工具列表（用于展示）。
  * 不判断当前是否活跃，只判断是否安装过。
+ * 使用 path.join 拼接路径，兼容 Windows 和 macOS/Linux。
  * 
  * @returns {Array} 已安装工具列表
  */
@@ -49,6 +50,7 @@ function detectEnvironment() {
   const results = installedTools.map(({ dirName, displayName }) => {
     const isWukong = dirName === ".real";
     const isActive = activeTool && activeTool.dirName === dirName;
+    // path.join 在 Windows 上自动使用反斜杠，兼容所有平台
     const workspaceRoot = isWukong
       ? path.join(home, ".real", "workspace", "project")
       : cwdProject;

package/lib/locales/en.js

@@ -586,6 +586,12 @@ Examples:
     files_copied: "   Files copied: {0}",
     files_count: "{0} files",
     symlinks_created: "   Symlinks created: {0}",
+    wukong_skills_cleanup: "\n🗑️  Wukong env: Cleaning up yida-skills/ symlink (Wukong uses manual skill upload, no symlink needed)...",
+    wukong_skills_cleaned: "cleaned up",
+    wukong_skills_not_found: "    ℹ️  No yida-skills/ symlink or directory found, nothing to clean: {0}",
+    remove_failed: "    ❌ Remove failed: {0} ({1})",
+    symlink_fallback_copy: "    ⚠️  Windows symlink creation failed (requires admin privileges), falling back to directory copy: {0}",
+    symlink_failed: "    ❌ Symlink creation failed: {0} ({1})",
     result_symlink: "   {0} → {1} (symlink)",
     result_copy: "   {0} → {1} ({2} files)",
   },

package/lib/locales/ja.js

@@ -584,6 +584,12 @@ openyida - Yida CLI ツール
     files_copied: "   コピーしたファイル: {0} 個",
     files_count: "{0} ファイル",
     symlinks_created: "   作成したシンボリックリンク: {0} 個",
+    wukong_skills_cleanup: "\n🗑️  悟空環境：yida-skills/ シンボリックリンクを削除中（悟空はスキルを手動アップロードするため、シンボリックリンク不要）...",
+    wukong_skills_cleaned: "削除済み",
+    wukong_skills_not_found: "    ℹ️  yida-skills/ シンボリックリンクまたはディレクトリが見つかりません: {0}",
+    remove_failed: "    ❌ 削除失敗: {0} ({1})",
+    symlink_fallback_copy: "    ⚠️  Windows でシンボリックリンク作成失敗（管理者権限が必要）、ディレクトリコピーにフォールバック: {0}",
+    symlink_failed: "    ❌ シンボリックリンク作成失敗: {0} ({1})",
     result_symlink: "   {0} → {1}（シンボリックリンク）",
     result_copy: "   {0} → {1}（{2} ファイル）",
   },

package/lib/locales/zh.js

@@ -487,6 +487,12 @@ openyida - 宜搭命令行工具
     symlinks_created: "   创建软链接: {0} 个",
     result_symlink: "   {0} → {1} (软链接)",
     result_copy: "   {0} → {1} ({2} 个文件)",
+    wukong_skills_cleanup: "\n🗑️  悟空环境：清理 yida-skills/ 软链（悟空通过手动上传技能，不需要软链）...",
+    wukong_skills_cleaned: "已清理",
+    wukong_skills_not_found: "    ℹ️  未找到 yida-skills/ 软链或目录，无需清理: {0}",
+    remove_failed: "    ❌ 删除失败: {0} ({1})",
+    symlink_fallback_copy: "    ⚠️  Windows 软链创建失败（需要管理员权限），降级为目录复制: {0}",
+    symlink_failed: "    ❌ 软链接创建失败: {0} ({1})",
   },
 
   // ── lib/publish.js ─────────────────────────────────

package/lib/publish.js

@@ -23,7 +23,7 @@ const http = require("http");
 const querystring = require("querystring");
 const { default: babelTransform } = require("./babel-transform");
 const UglifyJS = require("uglify-js");
-const { isLoginExpired, isCsrfTokenExpired } = require("./utils");
+const { findProjectRoot, isLoginExpired, isCsrfTokenExpired, loadCookieData, triggerLogin, refreshCsrfToken } = require("./utils");
 const { t } = require("./i18n");
 
 // ── 配置读取 ──────────────────────────────────────────

package/lib/utils.js

@@ -88,7 +88,8 @@ function detectActiveTool() {
   }
   
   // 悟空（Wukong）
-  if (env.AGENT_WORK_ROOT && env.AGENT_WORK_ROOT.includes(".real")) {
+  // Windows 路径可能使用反斜杠，需同时兼容正斜杠和反斜杠
+  if (env.AGENT_WORK_ROOT && (env.AGENT_WORK_ROOT.includes(".real") || env.AGENT_WORK_ROOT.includes(path.join(".real")))) {
     return {
       tool: "wukong",
       displayName: "悟空（Wukong）",

package/package.json

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

package/yida-skills/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: Yida
+name: yida
 description: >
   宜搭 AI 应用开发总入口技能。通过有 AI Coding 能力的智能体（悟空/Claude/Open Code 等）+ 宜搭低代码平台，实现一句话生成完整应用。
   包含应用创建、表单设计、自定义页面开发、页面发布、登录态管理等完整开发流程。

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

@@ -48,17 +48,30 @@ openyida create-form create <appType> <formTitle> <fieldsJsonOrFile>
 | `appType` | 是 | 应用 ID，如 `APP_XXX` |
 | `formTitle` | 是 | 表单名称 |
 | `fieldsJsonOrFile` | 是 | 字段定义，支持两种格式：JSON 字符串（以 `[` 开头）或 JSON 文件路径 |
+#### 示例 1：创建简单表单
 
-**示例（JSON 字符串，推荐）**：
+```bash
+openyida create-form create "APP_CQ2P5NRFI5L1D6PB8Q7J" "员工信息登记" fields.json
+```
+
+#### 示例 2：创建双列表单
 
 ```bash
-openyida create-form create "APP_XXX" "用户信息表" '[{"type":"TextField","label":"姓名","required":true},{"type":"SelectField","label":"部门","dataSource":[{"text":{"zh_CN":"技术部","en_US":"技术部","type":"i18n"},"value":"技术部","sid":"serial_xxx","disable":false,"defaultChecked":false},{"text":{"zh_CN":"产品部","en_US":"产品部","type":"i18n"},"value":"产品部","sid":"serial_xxx","disable":false,"defaultChecked":false}]}]'
+openyida create-form create "APP_CQ2P5NRFI5L1D6PB8Q7J" "员工信息登记" fields.json --layout double
 ```
-**示例（JSON 文件）**：
+
+#### 示例 3：创建卡片式分组表单
+
 ```bash
-openyida create-form create "APP_xxx" "用户信息表" .cache/user-info-fields.json
+# fields.json 中包含 group 字段分组
+openyida create-form create "APP_CQ2P5NRFI5L1D6PB8Q7J" "员工信息登记" fields.json --layout card --theme comfortable
 ```
 
+#### 示例 4：创建紧凑主题、左对齐标签的表单
+
+```bash
+openyida create-form create "APP_CQ2P5NRFI5L1D6PB8Q7J" "员工信息登记" fields.json --layout double --theme compact --label-align left
+```
 **输出**：日志输出到 stderr，JSON 结果输出到 stdout：
 
 ```json