openyida 2026.4.2 → 2026.4.14-beta.0

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';
@@ -86,6 +89,7 @@ openyida - 宜搭命令行工具
   save-share-config <appType> <formUuid> <url> <isOpen> [auth] 保存公开访问/分享配置
   get-page-config <appType> <formUuid>                         查询页面公开访问/分享配置
   update-form-config <appType> <formUuid> <isRenderNav> <title> 更新表单配置
+  update-app <appType> --name "新名称" [--desc "描述"] [--icon "图标"] 更新应用信息
   data <action> <resource> [args]                              统一数据管理（表单/流程/任务/子表单）
   doctor [选项]                                                检查环境依赖，诊断应用问题
     --fix / --repair                                           诊断并自动修复
@@ -106,6 +110,7 @@ openyida - 宜搭命令行工具
   configure-process <appType> <formUuid> <processDefinitionFile> [processCode]  配置并发布流程
   create-process <appType> <formTitle> <fieldsJsonFile> <processDefinitionFile>  创建流程表单（一体化）
   create-process <appType> --formUuid <formUuid> <processDefinitionFile>         复用已有表单创建流程
+  process preview <appType> <processInstanceId> [--output <path>]                预览流程实例（生成可视化流程图）
   connector list [选项]                                          列出 HTTP 连接器
   connector create "名称" "域名" --operations <file> [选项]      创建连接器
   connector detail <connector-id>                               查看连接器详情
@@ -120,6 +125,7 @@ openyida - 宜搭命令行工具
   connector parse-api [选项]                                    解析接口信息
   connector gen-template [输出路径]                              生成接口文档模板
   dws <command> [args]                                          钉钉 CLI（通讯录/日历/待办/审批等）
+  update                                                       检查并更新 openyida 到最新版本
   create-report <appType> "<报表名称>" <图表定义 JSON 或文件路径>   创建宜搭报表
   append-chart <appType> <reportId> <图表定义 JSON 或文件路径>      向已有报表追加图表
   export-conversation [选项]                                      导出 AI 对话记录
@@ -432,6 +438,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 +534,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 +695,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';

package/lib/app/publish.js

@@ -71,6 +71,12 @@ function lintYidaSource(sourceCode, _filePath) {
   // 警告级别：使用 const 或 let 声明变量
   const constLetRegex = /\b(const|let)\s+/;
 
+  // 警告级别：ES6 计算属性名 { [expr]: value } — 宜搭 JS 引擎会静默失败
+  const computedPropertyRegex = /\{\s*\[/;
+
+  // 警告级别：padStart / padEnd — 宜搭 JS 引擎不支持，会静默中断
+  const padMethodRegex = /\.(padStart|padEnd)\s*\(/;
+
   // 用于排除注释和字符串内的简单检测
   function isInCommentOrString(line, matchIndex) {
     const beforeMatch = line.substring(0, matchIndex);
@@ -83,6 +89,69 @@ function lintYidaSource(sourceCode, _filePath) {
     return quotes % 2 !== 0;
   }
 
+  // 警告级别：Promise .then() 回调代码量过大（超过 50 行会被静默截断）
+  const THEN_CALLBACK_LINE_LIMIT = 50;
+  const thenStartRegex = /\.then\s*\(\s*(function\s*\(|(\([^)]*\)|[a-zA-Z_$]\w*)\s*=>)/;
+
+  /**
+   * 检测 .then() 回调是否超过行数限制。
+   * 通过简单的花括号计数来追踪回调体的起止。
+   */
+  function detectLargeThenCallbacks(lines) {
+    const results = [];
+    let inThenCallback = false;
+    let braceDepth = 0;
+    let thenStartLine = 0;
+    let thenBodyStartLine = 0;
+
+    for (let i = 0; i < lines.length; i++) {
+      const line = lines[i];
+      const trimmed = line.trim();
+
+      // 跳过注释行
+      if (trimmed.startsWith('//') || trimmed.startsWith('*') || trimmed.startsWith('/*')) {
+        continue;
+      }
+
+      if (!inThenCallback) {
+        const thenMatch = line.match(thenStartRegex);
+        if (thenMatch && !isInCommentOrString(line, thenMatch.index)) {
+          // 找到 .then( 的起始，开始追踪花括号
+          inThenCallback = true;
+          thenStartLine = i + 1;
+          braceDepth = 0;
+
+          // 统计当前行的花括号
+          const afterMatch = line.substring(thenMatch.index);
+          for (const char of afterMatch) {
+            if (char === '{') braceDepth++;
+            if (char === '}') braceDepth--;
+          }
+          thenBodyStartLine = i + 1;
+        }
+      } else {
+        for (const char of line) {
+          if (char === '{') braceDepth++;
+          if (char === '}') braceDepth--;
+        }
+
+        if (braceDepth <= 0) {
+          // 回调结束
+          const callbackLineCount = (i + 1) - thenBodyStartLine;
+          if (callbackLineCount > THEN_CALLBACK_LINE_LIMIT) {
+            results.push({
+              line: thenStartLine,
+              lineCount: callbackLineCount,
+            });
+          }
+          inThenCallback = false;
+        }
+      }
+    }
+
+    return results;
+  }
+
   lines.forEach((line, index) => {
     const lineNumber = index + 1;
 
@@ -109,6 +178,42 @@ function lintYidaSource(sourceCode, _filePath) {
         });
       }
     }
+
+    // 检查 ES6 计算属性名
+    const computedMatch = line.match(computedPropertyRegex);
+    if (computedMatch && !isInCommentOrString(line, computedMatch.index)) {
+      const trimmed = line.trim();
+      if (!trimmed.startsWith('*') && !trimmed.startsWith('/*')) {
+        warnings.push({
+          line: lineNumber,
+          type: 'warning',
+          message: t('publish.lint_computed_property'),
+        });
+      }
+    }
+
+    // 检查 padStart / padEnd 调用
+    const padMatch = line.match(padMethodRegex);
+    if (padMatch && !isInCommentOrString(line, padMatch.index)) {
+      const trimmed = line.trim();
+      if (!trimmed.startsWith('*') && !trimmed.startsWith('/*')) {
+        warnings.push({
+          line: lineNumber,
+          type: 'warning',
+          message: t('publish.lint_pad_method', padMatch[1]),
+        });
+      }
+    }
+  });
+
+  // 检查 .then() 回调代码量过大
+  const largeThenCallbacks = detectLargeThenCallbacks(lines);
+  largeThenCallbacks.forEach(({ line, lineCount }) => {
+    warnings.push({
+      line,
+      type: 'warning',
+      message: t('publish.lint_large_then_callback', lineCount, THEN_CALLBACK_LINE_LIMIT),
+    });
   });
 
   return { errors, warnings };