openyida 2026.3.24 → 2026.3.28-2

package/README.md

@@ -17,7 +17,7 @@
 [![Node.js ≥18](https://img.shields.io/badge/node-%3E%3D18-brightgreen)](https://nodejs.org)
 
 **Languages:**
-[English](./README.md) · [简体中文](./README.zh-CN.md) · [繁體中文（台灣）](./README.zh-TW.md) · [繁體中文（香港）](./README.zh-HK.md) · [日本語](./README.ja.md) · [한국어](./README.ko.md) · [Français](./README.fr.md) · [Deutsch](./README.de.md) · [Español](./README.es.md) · [Português (BR)](./README.pt-BR.md) · [Tiếng Việt](./README.vi.md) · [हिन्दी](./README.hi.md) · [العربية](./README.ar.md)
+[English](https://openyida.ai/docs/en) · [简体中文](https://openyida.ai/docs) · [繁體中文（香港）](https://openyida.ai/docs/zh-Hant/) · [日本語](https://openyida.ai/docs/ja/) · [한국어](https://openyida.ai/docs/ko/) · [Français](https://openyida.ai/docs/fr/) · [Deutsch](https://openyida.ai/docs/de/) · [Español](https://openyida.ai/docs/es/) · [Português (BR)](https://openyida.ai/docs/pt/) · [Tiếng Việt](https://openyida.ai/docs/vi/) · [हिन्दी](https://openyida.ai/docs/hi/) · [العربية](https://openyida.ai/docs/ar/)
 
 </div>
 
@@ -72,76 +72,46 @@ Create a personal salary calculator app
 |------------|---------|---------|
 | Node.js | ≥ 18 | CLI runtime & page publishing |
 
-### ⚠️ JSX Compilation Notes
-
-When developing custom pages, the code must be compatible with **React 16 + Babel ES2015**. Avoid using:
-- ❌ Class fields syntax (`count = 0`)
-- ❌ `import` / `export default`
-- ❌ Optional chaining (`obj?.prop`) / Nullish coalescing (`a ?? b`)
-- ⚠️ Event handlers must use arrow functions: `onClick={(e) => { this.handle(e); }}`
-
-See `skills/yida-custom-page/SKILL.md` for detailed guidelines and troubleshooting.
-
 ---
 
 ## CLI Commands
 
 ```bash
-# Environment & Auth
-openyida env                                   # Detect current AI tool environment and login status
-openyida login                                 # Log in to Yida (uses cache, falls back to QR code)
-openyida logout                                # Log out / switch account
-openyida copy                                  # Initialize project working directory for current AI tool
-openyida auth status                           # View current login status
-openyida auth login                            # Perform login
-openyida auth refresh                          # Refresh login session
-openyida auth logout                           # Log out
-openyida org list                              # List accessible organizations
-openyida org switch                            # Switch organization (--corp-id <corpId>)
-openyida doctor                                # Environment diagnostics & auto-fix (--fix, --report, etc.)
-
-# App & Form Management
-openyida create-app                            # Create application
-openyida create-page                           # Create custom display page
-openyida create-form                           # Create or update form page
-openyida get-schema                            # Fetch form schema
-openyida publish                               # Compile and publish custom page
-openyida update-form-config                    # Update form configuration
-openyida export                                # Export app
-openyida import                                # Import migration package
-
-# Page Config & Sharing
-openyida verify-short-url                      # Verify short URL accessibility
-openyida save-share-config                     # Save public access / sharing config
-openyida get-page-config                       # Query page sharing config
-
-# Data Management
-openyida data                                  # Unified data management
-openyida query-data                            # Query form instance data
-
-# Permissions & Process
-openyida get-permission                        # Query form permission config
-openyida save-permission                       # Save form permission config
-openyida configure-process                     # Configure and publish process
-openyida create-process                        # Create process form
-
-# Connector (HTTP)
-openyida connector list                        # List HTTP connectors
-openyida connector create                      # Create a connector
-openyida connector detail                      # View connector details
-openyida connector delete                      # Delete a connector
-openyida connector add-action                  # Add an action to a connector
-openyida connector test                        # Test a connector action
-openyida connector smart-create                # Smart create from curl command
-
-# Report
-openyida create-report                         # Create Yida report with charts
-openyida append-chart                          # Append charts to existing report
-
-# CDN
-openyida cdn-config                            # Configure CDN image upload
-openyida cdn-upload                            # Upload images to CDN
-openyida cdn-refresh                           # Refresh CDN cache
+openyida append-chart         # Append chart to an existing report
+openyida auth                 # Login status management (status/login/refresh/logout)
+openyida cdn-config           # Configure CDN image upload (Aliyun OSS + CDN)
+openyida cdn-refresh          # Refresh CDN cache
+openyida cdn-upload           # Upload images to CDN
+openyida configure-process    # Configure and publish process rules
+openyida connector            # HTTP connector management
+openyida copy                 # Initialize project working directory for current AI tool
+openyida create-app           # Create a Yida application
+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 data                 # Unified data management (form/process/task/subform)
+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
+openyida export               # Export application migration package
+openyida export-conversation [format]                      # Export AI conversation history
+openyida flash-to-prd <appType> [options]                  # Flash note to PRD (supports meeting recognition)
+openyida get-page-config      # Query page public access / sharing config
+openyida get-permission       # Query form permission configuration
+openyida get-schema           # Fetch form schema
+openyida import               # Import migration package to rebuild application
+openyida integration create <appType> [options]             # Create integration & automation flow
+openyida login                # Log in to Yida (uses cache, falls back to QR code)
+openyida logout               # Log out / switch account
+openyida org                  # Organization management (list/switch)
+openyida publish              # Compile and publish a custom page
+openyida query-data           # Query form instance data
+openyida save-permission      # Save form permission configuration
+openyida save-share-config    # Save public access / sharing config
+openyida task-center [filter]                              # Global task center (Todo/Created/Processed/CC/Submit)
+openyida update-form-config   # Update form configuration
+openyida verify-short-url     # Verify if a short URL is accessible
 ```
 
 ---
@@ -211,7 +181,7 @@ Scan the QR code to join the OpenYida user group on DingTalk for the latest upda
 
 Thanks to everyone who has contributed to OpenYida! Read the [Contributing Guide](./CONTRIBUTING.md) to get involved.
 
-<p align="left" id="contributors">
+<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="九神" 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>
@@ -222,7 +192,10 @@ Thanks to everyone who has contributed to OpenYida! Read the [Contributing Guide
   <a href="https://github.com/ElZe98"><img src="https://avatars.githubusercontent.com/u/35736727?v=4&s=48" width="48" height="48" alt="ElZe98" title="ElZe98"/></a>
   <a href="https://github.com/OAHyuhao"><img src="https://avatars.githubusercontent.com/u/99954323?v=4&s=48" width="48" height="48" alt="OAHyuhao" title="OAHyuhao"/></a>
   <a href="https://github.com/xiaofu704"><img src="https://avatars.githubusercontent.com/u/209416122?v=4&s=48" width="48" height="48" alt="xiaofu704" title="xiaofu704"/></a>
-  <a href="https://github.com/guchenglin111"><img src="https://avatars.githubusercontent.com/u/10860875?v=4&s=48" width="48" height="48" alt="guchenglin111" title="guchenglin111"/></a> <a href="https://github.com/liug0911"><img src="https://avatars.githubusercontent.com/u/15044477?v=4&s=48" width="48" height="48" alt="liug0911" title="liug0911"/></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/guchenglin111"><img src="https://avatars.githubusercontent.com/u/10860875?v=4&s=48" width="48" height="48" alt="guchenglin111" title="guchenglin111"/></a>
+  <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>
 </p>
 
 ---

package/bin/yida.js

@@ -21,13 +21,13 @@
  *   openyida create-form create <appType> "<表单名>" <字段JSON> [--layout <布局>] [--theme <主题>] [--label-align <对齐>]  创建表单页面
  *   openyida create-form update <appType> <formUuid> <修改JSON>  更新表单页面
  *   openyida get-schema <appType> <formUuid>            获取表单 Schema
- *   openyida compile <源文件路径>                        仅编译自定义页面（不发布，产物输出到 pages/dist/）
  *   openyida publish <源文件路径> <appType> <formUuid>   编译并发布自定义页面
  *   openyida verify-short-url <appType> <formUuid> <url>           验证短链接 URL 是否可用
  *   openyida save-share-config <appType> <formUuid> <url> <isOpen> [openAuth]  保存公开访问/分享配置
  *   openyida get-page-config <appType> <formUuid>       查询页面公开访问/分享配置
  *   openyida update-form-config <appType> <formUuid> <isRenderNav> <title>  更新表单配置
  *   openyida data <action> <resource> [args]            统一数据管理（表单/流程/任务/子表单）
+ *   openyida task-center <type> [--page N] [--size N] [--keyword TEXT]  全局任务中心（待办/我创建的/我已处理/抄送/代提交）
  *   openyida doctor [选项]                              检查环境依赖，诊断应用问题
  *   openyida export <appType> [output]                  导出应用所有表单 Schema（生成迁移包）
  *   openyida import <file> [name]                       导入迁移包，在目标环境重建应用
@@ -46,8 +46,10 @@
  *   openyida connector smart-create --curl "curl命令" [选项]  智能创建连接器
  *   openyida connector parse-api [选项]                  解析接口信息
  *   openyida connector gen-template [输出路径]            生成接口文档模板
+ *   openyida integration create <appType> <formUuid> <flowName> [选项]  创建集成&自动化逻辑流
  *   openyida create-report <appType> "<报表名称>" <图表定义JSON或文件路径>  创建宜搭报表
  *   openyida append-chart <appType> <reportId> <图表定义JSON或文件路径>    向已有报表追加图表
+ *   openyida dws <command> [args]                        钉钉 CLI（通讯录/日历/待办/审批等）
  */
 
 'use strict';
@@ -63,6 +65,104 @@ 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" "red"
+  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'));
 }
 
@@ -80,7 +180,7 @@ function handleFirstRunGuide() {
   const FIRST_RUN_FLAG = path.join(OPENYIDA_DIR, 'first-run-done');
 
   // 已运行过，跳过引导
-  if (fs.existsSync(FIRST_RUN_FLAG)) { return; }
+  if (fs.existsSync(FIRST_RUN_FLAG)) {return;}
 
   // 写入标记，避免重复展示
   try {
@@ -266,30 +366,24 @@ async function main() {
       break;
     }
 
-    case 'compile': {
-      // 参数顺序：<源文件路径>
-      if (args.length < 1) {
-        console.error(t('cli.compile_usage'));
-        console.error(t('cli.compile_example'));
-        process.exit(1);
-      }
-      const { run: runCompile } = require('../lib/app/compile');
-      await runCompile(args);
-      break;
-    }
-
     case 'publish': {
       // 参数顺序：<源文件路径> <appType> <formUuid>
       // publish.js 内部读取顺序：argv[2]=appType, argv[3]=formUuid, argv[4]=sourceFile
-      if (args.length < 3) {
+      const skipLint = args.includes('--skip-lint');
+      const filteredArgs = args.filter(arg => arg !== '--skip-lint');
+      if (filteredArgs.length < 3) {
         console.error(t('cli.publish_usage'));
         console.error(t('cli.publish_example'));
         process.exit(1);
       }
-      const [sourceFile, appType, formUuid] = args;
-      process.argv = [process.argv[0], process.argv[1], appType, formUuid, sourceFile];
-      const { run: publishRun } = require('../lib/app/publish');
-      await publishRun();
+      const [sourceFile, appType, formUuid] = filteredArgs;
+      process.argv = [
+        process.argv[0], process.argv[1],
+        appType, formUuid, sourceFile,
+        ...(skipLint ? ['--skip-lint'] : [])
+      ];
+      const publishMain = require('../lib/app/publish');
+      await publishMain();
       break;
     }
 
@@ -339,8 +433,8 @@ async function main() {
 
     case 'data': {
       if (args.length < 2) {
-        console.error(t('cli.data_usage'));
-        console.error(t('cli.data_example'));
+        console.error('用法: openyida data <action> <resource> [args] [options]');
+        console.error('示例: openyida data query form APP_XXX FORM_XXX --page 1 --size 20');
         process.exit(1);
       }
       const { run: runDataManagement } = require('../lib/core/query-data');
@@ -473,14 +567,33 @@ async function main() {
       };
 
       if (!subCommand || subCommand === '--help' || subCommand === '-h') {
-        console.log(t('cli.connector_help'));
+        console.log(`
+用法: openyida connector <子命令> [参数]
+
+子命令:
+  list                                         列出 HTTP 连接器
+  create "名称" "域名" --operations <file>      创建连接器
+  detail <connector-id>                        查看连接器详情
+  delete <connector-id> [--force]              删除连接器
+  add-action --operations <file> --connector-id <id>  添加执行动作
+  list-actions <connector-id>                  列出执行动作
+  delete-action <connector-id> <operation-id>  删除执行动作
+  test --connector-id <id> --action <actionId> 测试执行动作
+  list-connections <connector-id>              列出鉴权账号
+  create-connection <connector-id> <name>      创建鉴权账号
+  smart-create --curl "curl命令"               智能创建连接器
+  parse-api [选项]                             解析接口信息
+  gen-template [输出路径]                       生成接口文档模板
+
+使用 openyida connector <子命令> --help 查看详细帮助
+`);
         break;
       }
 
       const modulePath = connectorSubCommands[subCommand];
       if (!modulePath) {
-        console.error(t('cli.connector_unknown', subCommand));
-        console.error(t('cli.connector_help_hint'));
+        console.error(`未知的 connector 子命令: ${subCommand}`);
+        console.error('使用 openyida connector --help 查看可用子命令');
         process.exit(1);
       }
 
@@ -489,8 +602,15 @@ async function main() {
       break;
     }
 
+    case 'flash-to-prd': {
+      const { run: runFlashToPrd } = require('../lib/flash-note/flash-to-prd');
+      await runFlashToPrd(args);
+      break;
+    }
+
     case 'integration': {
       const subCommand = args[0];
+      const subArgs = args.slice(1);  // 路由层消费 subCommand，传递剩余参数
 
       if (!subCommand || subCommand === '--help' || subCommand === '-h') {
         console.error(t('cli.integration_help'));
@@ -499,7 +619,7 @@ async function main() {
 
       if (subCommand === 'create') {
         const { run: runIntegration } = require('../lib/integration/integration-create');
-        await runIntegration(args);
+        await runIntegration(subArgs);
       } else {
         console.error(t('cli.integration_unknown', subCommand));
         console.error(t('cli.integration_help_hint'));
@@ -508,6 +628,36 @@ async function main() {
       break;
     }
 
+    case 'dws': {
+      const { run: runDws } = require('../lib/dws/dws-wrapper');
+      await runDws(args);
+      break;
+    }
+    case 'export-conversation': {
+      const { exportConversation } = require('../lib/conversation/export-conversation');
+      // 解析选项
+      const options = {};
+      for (let i = 0; i < args.length; i++) {
+        if (args[i] === '--output' || args[i] === '-o') {
+          options.output = args[++i];
+        } else if (args[i] === '--input' || args[i] === '-i') {
+          options.input = args[++i];
+        } else if (args[i] === '--latest') {
+          options.latest = true;
+        } else if (args[i] === '--list') {
+          options.list = true;
+        }
+      }
+      await exportConversation(options);
+      break;
+    }
+
+    case 'task-center': {
+      const { run: runTaskCenter } = require('../lib/core/task-center');
+      await runTaskCenter(args);
+      break;
+    }
+
     default: {
       console.error(t('cli.unknown_command', command));
       console.error(t('cli.run_help'));