openyida 2026.4.2 → 2026.4.14-beta.1

package/README.md

@@ -99,7 +99,9 @@ openyida create-form          # Create / update a form page
 openyida create-page          # Create a custom display page
 openyida create-process       # Create a process form (integrated)
 openyida create-report        # Create a Yida report
+openyida process preview      # Preview process instance (generate visual flowchart)
 openyida data                 # Unified data management (form/process/task/subform)
+openyida data check <appType> <formUuid> <rules.json> [options]  # Detect anomalous records in process forms based on custom rules
 openyida doctor               # Environment diagnostics and auto-repair
 openyida dws <command> [args]                              # DingTalk CLI (Contacts/Calendar/Todo/Approval, etc.)
 openyida env                  # Detect current AI tool environment and login status
@@ -205,6 +207,7 @@ Thanks to everyone who has contributed to OpenYida! Read the [Contributing Guide
   <a href="https://github.com/liug0911"><img src="https://avatars.githubusercontent.com/u/1578814?v=4&s=48" width="48" height="48" alt="LIUG" title="LIUG"/></a>
   <a href="https://github.com/sunliz-xiuli"><img src="https://avatars.githubusercontent.com/u/76982855?v=4&s=48" width="48" height="48" alt="sunliz-xiuli" title="sunliz-xiuli"/></a>
   <a href="https://github.com/M12REDX"><img src="https://avatars.githubusercontent.com/u/22703542?v=4&s=48" width="48" height="48" alt="M12REDX" title="M12REDX"/></a>
+  <a href="https://github.com/key-668"><img src="https://avatars.githubusercontent.com/u/270536058?v=4&s=48" width="48" height="48" alt="再不喝汽水" title="再不喝汽水"/></a>
 </p>
 
 ---

package/bin/yida.js

@@ -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 update-app <appType> --name "新名称" [--desc "描述"] [--icon "图标"]  更新应用信息
  *   openyida data <action> <resource> [args]            统一数据管理（表单/流程/任务/子表单）
  *   openyida task-center <type> [--page N] [--size N] [--keyword TEXT]  全局任务中心（待办/我创建的/我已处理/抄送/代提交）
  *   openyida doctor [选项]                              检查环境依赖，诊断应用问题
@@ -33,6 +34,7 @@
  *   openyida import <file> [name]                       导入迁移包，在目标环境重建应用
  *   openyida get-permission <appType> <formUuid>        查询表单权限配置
  *   openyida save-permission <appType> <formUuid> [--data-permission <json>] [--action-permission <json>]  保存表单权限配置
+ *   openyida process preview <appType> <processInstanceId> [--output <path>]  预览流程实例（生成可视化流程图）
  *   openyida connector list [选项]                       列出 HTTP 连接器
  *   openyida connector create "名称" "域名" --operations <file> [选项]  创建连接器
  *   openyida connector detail <connector-id>             查看连接器详情
@@ -50,6 +52,7 @@
  *   openyida create-report <appType> "<报表名称>" <图表定义JSON或文件路径>  创建宜搭报表
  *   openyida append-chart <appType> <reportId> <图表定义JSON或文件路径>    向已有报表追加图表
  *   openyida dws <command> [args]                        钉钉 CLI（通讯录/日历/待办/审批等）
+ *   openyida update                                       检查并更新 openyida 到最新版本
  */
 
 'use strict';
@@ -65,106 +68,127 @@ 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> 更新表单配置
-  data <action> <resource> [args]                              统一数据管理（表单/流程/任务/子表单）
-  doctor [选项]                                                检查环境依赖，诊断应用问题
-    --fix / --repair                                           诊断并自动修复
-    --production --app <appId>                                 线上应用诊断
-    --monitor                                                  启动实时健康度监控
-    --report <format>                                          生成诊断报告（json | markdown | html）
-    --create-ticket                                            根据诊断结果创建工单
-    --create-voc                                               创建 VOC（需求反馈）
-    --auto-submit                                              自动判断并提交工单或 VOC
-  auth status                                                  查看当前登录状态
-  auth login                                                   执行登录
-  auth refresh                                                 刷新登录态
-  auth logout                                                  退出登录
-  org list                                                     列出可访问的组织
-  org switch --corp-id <corpId>                                切换组织（无需重新登录）
-  get-permission <appType> <formUuid>                          查询表单权限配置
-  save-permission <appType> <formUuid> [--data-permission <json>] [--action-permission <json>]  保存表单权限配置
-  configure-process <appType> <formUuid> <processDefinitionFile> [processCode]  配置并发布流程
-  create-process <appType> <formTitle> <fieldsJsonFile> <processDefinitionFile>  创建流程表单（一体化）
-  create-process <appType> --formUuid <formUuid> <processDefinitionFile>         复用已有表单创建流程
-  connector list [选项]                                          列出 HTTP 连接器
-  connector create "名称" "域名" --operations <file> [选项]      创建连接器
-  connector detail <connector-id>                               查看连接器详情
-  connector delete <connector-id> [--force]                     删除连接器
-  connector add-action --operations <file> --connector-id <id>  添加执行动作到连接器
-  connector list-actions <connector-id>                         列出执行动作
-  connector delete-action <connector-id> <operation-id>         删除执行动作
-  connector test --connector-id <id> --action <actionId>        测试执行动作
-  connector list-connections <connector-id>                     列出鉴权账号
-  connector create-connection <connector-id> <name> [选项]      创建鉴权账号
-  connector smart-create --curl "curl命令" [选项]               智能创建连接器
-  connector parse-api [选项]                                    解析接口信息
-  connector gen-template [输出路径]                              生成接口文档模板
-  dws <command> [args]                                          钉钉 CLI（通讯录/日历/待办/审批等）
-  create-report <appType> "<报表名称>" <图表定义 JSON 或文件路径>   创建宜搭报表
-  append-chart <appType> <reportId> <图表定义 JSON 或文件路径>      向已有报表追加图表
-  export-conversation [选项]                                      导出 AI 对话记录
-    --output, -o <path>                                           指定输出文件路径
-    --input, -i <file>                                            指定输入对话文件
-    --latest                                                      只导出最新对话（默认）
-    --list                                                        列出可用的对话记录
-
-示例：
-  openyida login
-  openyida logout
-  openyida create-app "考勤管理"
-  openyida create-app "考勤管理" "员工考勤系统" "xian-daka" "#00B853" "deepBlue" "dark" "slide"
-  openyida create-app "党建管理" "党员管理系统" "xian-zhengfu" "#FF4D4F" "red" "light" "ver"
-  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 data query form APP_XXX FORM-XXX --page 1 --size 20
-  openyida dws contact user search --keyword "悟空"
-  openyida dws calendar event list
-  openyida dws todo task create --title "任务"
-  openyida create-report APP_XXX "销售报表" charts.json
-  openyida append-chart APP_XXX REPORT-XXX charts.json
-  openyida configure-process APP_XXX FORM-YYY process-def.json
-  openyida create-process APP_XXX "订单处理表" fields.json process-def.json
-  openyida create-process APP_XXX --formUuid FORM-YYY process-def.json
-  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                   自动判断并提交
-  openyida export-conversation                   导出当前对话记录
-  openyida export-conversation -o output.md     指定输出路径
-  openyida export-conversation --list            列出可用对话
-`);
-  console.log(t('cli.help'));
+  const RESET   = '\x1b[0m';
+  const BOLD    = '\x1b[1m';
+  const DIM     = '\x1b[2m';
+  const CYAN    = '\x1b[36m';
+  const GREEN   = '\x1b[32m';
+  const YELLOW  = '\x1b[33m';
+
+  const SEP = `${DIM}${'─'.repeat(60)}${RESET}`;
+
+  /**
+   * 渲染一组命令列表。
+   * @param {string} groupTitle - 分组标题
+   * @param {Array<[string, string]>} commands - [命令, 描述] 数组
+   */
+  function renderGroup(groupTitle, commands) {
+    console.log(`\n  ${BOLD}${CYAN}${groupTitle}${RESET}`);
+    const maxCmdLen = Math.max(...commands.map(([cmd]) => cmd.length));
+    const padWidth = Math.min(maxCmdLen + 2, 50);
+    for (const [cmd, desc] of commands) {
+      console.log(`    ${GREEN}${cmd.padEnd(padWidth)}${RESET}${DIM}${desc}${RESET}`);
+    }
+  }
+
+  // ── 标题 ──
+  console.log('');
+  console.log(`  ${BOLD}${CYAN}OpenYida${RESET} ${DIM}v${currentVersion}${RESET}`);
+  console.log(`  ${DIM}${t('help.subtitle')}${RESET}`);
+  console.log('');
+  console.log(`  ${YELLOW}${t('help.usage')}${RESET}  openyida <command> [args...]`);
+  console.log(`  ${DIM}${t('help.alias')}${RESET}  yida`);
+  console.log(SEP);
+
+  // ── 环境 & 认证 ──
+  renderGroup(t('help.group_auth'), [
+    ['login [--qr]',                          t('help.cmd_login')],
+    ['logout',                                 t('help.cmd_logout')],
+    ['auth <status|login|refresh|logout>',     t('help.cmd_auth')],
+    ['org <list|switch>',                      t('help.cmd_org')],
+    ['env',                                    t('help.cmd_env')],
+  ]);
+
+  // ── 应用管理 ──
+  renderGroup(t('help.group_app'), [
+    ['create-app "<name>" [options]',          t('help.cmd_create_app')],
+    ['update-app <appType> --name "..."',      t('help.cmd_update_app')],
+    ['export <appType> [output]',              t('help.cmd_export')],
+    ['import <file> [name]',                   t('help.cmd_import')],
+  ]);
+
+  // ── 表单 & 页面 ──
+  renderGroup(t('help.group_form'), [
+    ['create-form create <appType> ...',       t('help.cmd_create_form')],
+    ['create-form update <appType> ...',       t('help.cmd_update_form')],
+    ['get-schema <appType> <formUuid>',        t('help.cmd_get_schema')],
+    ['create-page <appType> "<name>"',         t('help.cmd_create_page')],
+    ['publish <src> <appType> <formUuid>',     t('help.cmd_publish')],
+    ['update-form-config <appType> ...',       t('help.cmd_update_form_config')],
+  ]);
+
+  // ── 数据 & 权限 ──
+  renderGroup(t('help.group_data'), [
+    ['data <action> <resource> [args]',        t('help.cmd_data')],
+    ['task-center <type> [options]',           t('help.cmd_task_center')],
+    ['get-permission <appType> <formUuid>',    t('help.cmd_get_permission')],
+    ['save-permission <appType> <formUuid> ...', t('help.cmd_save_permission')],
+  ]);
+
+  // ── 流程 ──
+  renderGroup(t('help.group_process'), [
+    ['configure-process <appType> ...',        t('help.cmd_configure_process')],
+    ['create-process <appType> ...',           t('help.cmd_create_process')],
+    ['process preview <appType> ...',          t('help.cmd_process_preview')],
+  ]);
+
+  // ── 页面配置 & 分享 ──
+  renderGroup(t('help.group_share'), [
+    ['verify-short-url <appType> ...',         t('help.cmd_verify_url')],
+    ['save-share-config <appType> ...',        t('help.cmd_save_share')],
+    ['get-page-config <appType> <formUuid>',   t('help.cmd_get_page_config')],
+  ]);
+
+  // ── 报表 ──
+  renderGroup(t('help.group_report'), [
+    ['create-report <appType> "<name>" ...',   t('help.cmd_create_report')],
+    ['append-chart <appType> <reportId> ...',  t('help.cmd_append_chart')],
+  ]);
+
+  // ── 连接器 ──
+  renderGroup(t('help.group_connector'), [
+    ['connector list',                         t('help.cmd_connector_list')],
+    ['connector create "name" "domain" ...',   t('help.cmd_connector_create')],
+    ['connector detail <id>',                  t('help.cmd_connector_detail')],
+    ['connector delete <id>',                  t('help.cmd_connector_delete')],
+    ['connector smart-create --curl "..."',    t('help.cmd_connector_smart')],
+    ['connector <sub-command> --help',         t('help.cmd_connector_more')],
+  ]);
+
+  // ── 集成 & 钉钉 ──
+  renderGroup(t('help.group_integration'), [
+    ['integration create <appType> ...',       t('help.cmd_integration')],
+    ['dws <command> [args]',                   t('help.cmd_dws')],
+  ]);
+
+  // ── 工具 ──
+  renderGroup(t('help.group_utility'), [
+    ['copy [--force]',                         t('help.cmd_copy')],
+    ['doctor [--fix]',                         t('help.cmd_doctor')],
+    ['update',                                 t('help.cmd_update')],
+    ['export-conversation [options]',          t('help.cmd_export_conversation')],
+    ['cdn-config / cdn-upload / cdn-refresh',  t('help.cmd_cdn')],
+  ]);
+
+  // ── 快速上手 ──
+  console.log(SEP);
+  console.log(`\n  ${BOLD}${CYAN}${t('help.quickstart_title')}${RESET}`);
+  console.log(`    ${DIM}${RESET} openyida login`);
+  console.log(`    ${DIM}${RESET} openyida create-app "${t('help.quickstart_app_name')}"`);
+  console.log(`    ${DIM}${RESET} openyida create-form create APP_XXX "${t('help.quickstart_form_name')}" fields.json`);
+  console.log('');
+  console.log(`  ${DIM}${t('help.docs')} https://github.com/openyida/openyida${RESET}`);
+  console.log('');
 }
 
 /**
@@ -432,6 +456,17 @@ async function main() {
       break;
     }
 
+    case 'update-app': {
+      if (args.length < 2) {
+        console.error(t('cli.update_app_usage'));
+        console.error(t('cli.update_app_example'));
+        process.exit(1);
+      }
+      const { run: runUpdateApp } = require('../lib/app/update-app');
+      await runUpdateApp(args);
+      break;
+    }
+
     case 'data': {
       if (args.length < 2) {
         console.error('用法: openyida data <action> <resource> [args] [options]');
@@ -517,6 +552,25 @@ async function main() {
       break;
     }
 
+    case 'process': {
+      const subCommand = args[0];
+      const subArgs = args.slice(1);
+
+      if (subCommand === 'preview') {
+        if (subArgs.length < 2) {
+          console.error(t('cli.process_preview_usage'));
+          console.error(t('cli.process_preview_example'));
+          process.exit(1);
+        }
+        const { run: runPreviewProcess } = require('../lib/process/preview-process');
+        await runPreviewProcess(subArgs);
+      } else {
+        console.error(t('cli.process_usage'));
+        process.exit(1);
+      }
+      break;
+    }
+
     case 'create-report': {
       const { run } = require('../lib/report/create-report');
       await run(args);
@@ -659,6 +713,12 @@ async function main() {
       break;
     }
 
+    case 'update': {
+      const { runUpdate } = require('../lib/core/update');
+      await runUpdate(currentVersion);
+      break;
+    }
+
     default: {
       console.error(t('cli.unknown_command', command));
       console.error(t('cli.run_help'));

package/lib/app/app-list.js

@@ -0,0 +1,133 @@
+/**
+ * app-list.js - 查询我的应用列表
+ *
+ * 用法：openyida app-list [--page <页码>] [--size <每页数量>]
+ *
+ * 输出字段：
+ *   appName    - 应用名称（zh_CN）
+ *   appType    - 应用唯一标识
+ *   systemLink - 应用访问地址
+ */
+
+'use strict';
+
+const {
+  loadCookieData,
+  triggerLogin,
+  resolveBaseUrl,
+  extractInfoFromCookies,
+  httpGet,
+  requestWithAutoLogin,
+} = require('../core/utils');
+const { t } = require('../core/i18n');
+
+const API_PATH = '/query/app/getAppList.json';
+
+/**
+ * 拉取单页应用列表
+ */
+function fetchAppListPage(auth, pageIndex, pageSize) {
+  const queryParams = {
+    _api: 'nattyFetch',
+    _mock: 'false',
+    pageIndex,
+    pageSize,
+    creator: auth.userId,
+    _csrf_token: auth.csrfToken,
+    _stamp: Date.now(),
+  };
+  return httpGet(auth.baseUrl, API_PATH, queryParams, auth.cookies);
+}
+
+/**
+ * 拉取全量应用列表（自动翻页）
+ */
+async function fetchAllApps(auth, pageSize) {
+  const firstResult = await fetchAppListPage(auth, 1, pageSize);
+
+  if (!firstResult.success) {
+    throw new Error(firstResult.errorMsg || '查询应用列表失败');
+  }
+
+  const { data: firstPageData, totalCount } = firstResult.content;
+  const allApps = [...firstPageData];
+
+  const totalPages = Math.ceil(totalCount / pageSize);
+  const remainingFetches = [];
+
+  for (let pageIndex = 2; pageIndex <= totalPages; pageIndex++) {
+    remainingFetches.push(fetchAppListPage(auth, pageIndex, pageSize));
+  }
+
+  const remainingResults = await Promise.all(remainingFetches);
+  for (const result of remainingResults) {
+    if (result.success && result.content && result.content.data) {
+      allApps.push(...result.content.data);
+    }
+  }
+
+  return allApps;
+}
+
+/**
+ * 将应用原始数据提取为输出字段
+ */
+function formatApp(app) {
+  return {
+    appName: (app.appName && app.appName.zh_CN) || '',
+    appType: app.appType || '',
+    systemLink: app.systemLink || '',
+  };
+}
+
+/**
+ * app-list 命令主入口
+ * @param {string[]} args
+ */
+async function run(args) {
+  const pageSizeIndex = args.indexOf('--size');
+  const pageSize = pageSizeIndex !== -1 && args[pageSizeIndex + 1]
+    ? parseInt(args[pageSizeIndex + 1], 10)
+    : 20;
+
+  let cookieData = await loadCookieData();
+  if (!cookieData) {
+    cookieData = await triggerLogin();
+  }
+
+  const baseUrl = resolveBaseUrl(cookieData);
+  const { csrfToken, userId } = extractInfoFromCookies(cookieData.cookies);
+  const authRef = { baseUrl, cookies: cookieData.cookies, csrfToken, userId };
+
+  let apps;
+  try {
+    apps = await requestWithAutoLogin(
+      (auth) => fetchAllApps(
+        { baseUrl: auth.baseUrl, cookies: auth.cookies, csrfToken: auth.csrfToken, userId: auth.userId },
+        pageSize
+      ),
+      authRef
+    );
+  } catch (err) {
+    console.error(`查询应用列表失败：${err.message}`);
+    process.exit(1);
+  }
+
+  if (!apps || apps.length === 0) {
+    console.log('暂无应用');
+    return;
+  }
+
+  const formattedApps = apps.map(formatApp);
+
+  // stdout 输出 JSON，方便 AI 工具解析
+  console.log(JSON.stringify(formattedApps, null, 2));
+
+  // stderr 输出人类可读摘要
+  console.error(`\n共找到 ${formattedApps.length} 个应用：`);
+  for (const app of formattedApps) {
+    console.error(`  • ${app.appName}  [${app.appType}]  ${app.systemLink}`);
+  }
+}
+
+module.exports = { run };

package/lib/app/create-app.js

@@ -1,7 +1,7 @@
 /**
  * create-app.js - 宜搭应用创建命令
  *
- * 用法：yidacli create-app "<appName>" [description] [icon] [iconColor] [colour] [navTheme] [layoutDirection]
+ * 用法：openyida create-app "<appName>" [description] [icon] [iconColor] [colour] [navTheme] [layoutDirection]
  */
 
 'use strict';

package/lib/app/create-form.js

@@ -101,7 +101,7 @@ function parseArgs() {
   // 复制一份 args 用于解析（避免修改原始数组影响后续处理）
   const args = [...rawArgs];
 
-  // 解析 --layout, --theme, --label-align 参数
+  // 解析 --layout, --theme, --label-align, --force 参数
   for (let i = 0; i < args.length; i++) {
     if (args[i] === '--layout' && i + 1 < args.length) {
       options.layout = args[i + 1];
@@ -115,6 +115,10 @@ function parseArgs() {
       options.labelAlign = args[i + 1];
       args.splice(i, 2);
       i--;
+    } else if (args[i] === '--force') {
+      options.force = true;
+      args.splice(i, 1);
+      i--;
     }
   }
 
@@ -1463,8 +1467,11 @@ function buildFormSchema(formTitle, fields, formUuid, corpId, appType, layout, t
       type: 'FUNCTION',
       list: [
         {
-          id: 'didMount',
-          title: 'didMount',
+          id: nextNodeId(),
+          type: 'lifeCycleEvent',
+          name: 'didMount',
+          relatedEventId: 'lifecycle:didMount',
+          params: {},
         },
       ],
     },
@@ -2404,8 +2411,48 @@ async function mainUpdate(parsedArgs, csrfToken, cookies, baseUrl, cookieData) {
     console.error(t('create_form.schema_got_empty'));
   }
 
-  // Step 3: 读取修改定义
-  console.error(t('create_form.step_read_changes', 3));
+  // Step 3: 检查表单是否已有数据
+  console.error(t('create_form.step_check_data', 3));
+  const dataCheckResult = await requestWithAutoLogin(function (auth) {
+    return sendGetRequest(
+      auth.baseUrl, auth.cookies,
+      '/dingtalk/web/' + appType + '/v1/form/searchFormDatas.json',
+      { formUuid: formUuid, appType: appType, currentPage: '1', pageSize: '1' }
+    );
+  }, authRef);
+
+  let existingDataCount = 0;
+  if (dataCheckResult && dataCheckResult.content && typeof dataCheckResult.content.totalCount === 'number') {
+    existingDataCount = dataCheckResult.content.totalCount;
+  } else if (dataCheckResult && typeof dataCheckResult.totalCount === 'number') {
+    existingDataCount = dataCheckResult.totalCount;
+  }
+
+  if (existingDataCount > 0) {
+    console.error(t('create_form.data_exists_warning', existingDataCount));
+    console.error(t('create_form.data_exists_impact'));
+
+    if (!parsedArgs.force) {
+      console.error(t('create_form.data_exists_abort'));
+      console.log(JSON.stringify({
+        success: false,
+        requiresConfirmation: true,
+        formUuid: formUuid,
+        appType: appType,
+        existingDataCount: existingDataCount,
+        message: t('create_form.data_exists_confirm_message', existingDataCount),
+        hint: t('create_form.data_exists_force_hint'),
+      }));
+      process.exit(0);
+    }
+
+    console.error(t('create_form.data_exists_force_proceed', existingDataCount));
+  } else {
+    console.error(t('create_form.data_check_empty'));
+  }
+
+  // Step 4: 读取修改定义
+  console.error(t('create_form.step_read_changes', 4));
   const changes = readChangesDefinition(changesJsonOrFile);
   console.error(t('create_form.changes_loaded', changes.length));
   changes.forEach(function (change, changeIndex) {
@@ -2418,8 +2465,8 @@ async function mainUpdate(parsedArgs, csrfToken, cookies, baseUrl, cookieData) {
     }
   });
 
-  // Step 4: 应用修改
-  console.error(t('create_form.step_apply_changes', 4));
+  // Step 5: 应用修改
+  console.error(t('create_form.step_apply_changes', 5));
   const appliedChanges = applyChangesToSchema(schema, changes);
 
   // 为 SerialNumberField 补全 formula（若尚未设置）
@@ -2433,8 +2480,8 @@ async function mainUpdate(parsedArgs, csrfToken, cookies, baseUrl, cookieData) {
     fillSerialNumberFormulas(formContainerUpdate.children, corpId, appType, formUuid);
   }
 
-  // Step 5 & 6: 保存 Schema 并更新表单配置
-  const { configResult } = await saveSchemaAndUpdateConfig(authRef, appType, formUuid, schema, version, 5);
+  // Step 6 & 7: 保存 Schema 并更新表单配置
+  const { configResult } = await saveSchemaAndUpdateConfig(authRef, appType, formUuid, schema, version, 6);
 
   // 输出结果
   const SEP2 = '='.repeat(50);

package/lib/app/create-page.js

@@ -1,7 +1,7 @@
 /**
  * create-page.js - 宜搭自定义页面创建命令
  *
- * 用法：yidacli create-page <appType> "<pageName>"
+ * 用法：openyida create-page <appType> "<pageName>"
  */
 
 'use strict';
@@ -81,7 +81,7 @@ async function run(args) {
 
     console.log(JSON.stringify({ success: true, pageId, pageName, appType, url: pageUrl }));
   } else {
-    const errorMsg = response ? response.errorMsg || t('common.unknown_error') : t('common.request_failed');
+    const errorMsg = response ? response.errorMsg || response.error || t('common.unknown_error') : t('common.request_failed');
     console.error(t('create_page.failed', errorMsg));
     console.error(SEP2);
     console.log(JSON.stringify({ success: false, error: errorMsg }));

package/lib/app/get-schema.js

@@ -1,7 +1,7 @@
 /**
  * get-schema.js - 宜搭表单 Schema 获取命令
  *
- * 用法：yidacli get-schema <appType> <formUuid>
+ * 用法：openyida get-schema <appType> <formUuid>
  */
 
 'use strict';