openyida 1.0.0-beta.0 → 1.0.0-beta.2

package/README.md

@@ -1,3 +1,21 @@
+<div align="center">
+
+# 🚀 OpenYida
+
+**Build Yida low-code apps with AI — zero config, instant deploy.**
+
+[快速开始](#快速开始) · [CLI 命令](#cli-命令一览) · [Demo](#demo-展示) · [贡献指南](./CONTRIBUTING.md) · [更新日志](./CHANGELOG.md)
+
+[![npm version](https://img.shields.io/npm/v/openyida?color=brightgreen&label=npm)](https://www.npmjs.com/package/openyida)
+[![npm downloads](https://img.shields.io/npm/dm/openyida?color=blue)](https://www.npmjs.com/package/openyida)
+[![CI](https://github.com/openyida/openyida/actions/workflows/ci.yml/badge.svg)](https://github.com/openyida/openyida/actions/workflows/ci.yml)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](./LICENSE)
+[![Node.js ≥16](https://img.shields.io/badge/node-%3E%3D16-brightgreen)](https://nodejs.org)
+
+</div>
+
+---
+
 ## 快速开始
 
 ```bash
@@ -6,19 +24,25 @@ npm install -g openyida
 
 **安装即用，零配置。** 安装后在 Claude Code / OpenCode / Aone Copilot 中直接对话：
 
-- `帮我用宜搭创建一个 IPD 系统，需要管理芯片生产全流程`
-- `帮我搭建一个 CRM`
-- `帮我搭建个人薪资计算器应用`
+```
+帮我用宜搭创建一个 IPD 系统，需要管理芯片生产全流程
+帮我搭建一个 CRM
+帮我搭建个人薪资计算器应用
+```
 
 ---
 
 ## 支持的 AI 编程工具
 
-- [Claude Code](https://claude.ai/code)
-- [OpenCode](https://opencode.ai)
-- [Aone Copilot](https://copilot.code.alibaba-inc.com)
-- [Cursor](https://cursor.com/)
-- [Visual Studio Code](https://code.visualstudio.com/)
+| 工具 | 支持状态 |
+|------|----------|
+| [Claude Code](https://claude.ai/code) | ✅ 完整支持 |
+| [Aone Copilot](https://copilot.code.alibaba-inc.com) | ✅ 完整支持 |
+| [OpenCode](https://opencode.ai) | ✅ 完整支持 |
+| [Cursor](https://cursor.com/) | ✅ 完整支持 |
+| [Visual Studio Code](https://code.visualstudio.com/) | ✅ 完整支持 |
+| [Qoder](https://qoder.com) | ✅ 完整支持 |
+| [悟空](https://dingtalk.com/wukong) | ✅ 完整支持 |
 
 ---
 
@@ -41,7 +65,9 @@ npm install -g openyida
 |------|----------|------|
 | Node.js | ≥ 16 | CLI 运行、页面发布 |
 
-### CLI 命令一览
+---
+
+## CLI 命令一览
 
 ```bash
 openyida env                  # 检测当前 AI 工具环境和登录态
@@ -57,80 +83,86 @@ openyida verify-short-url     # 验证短链接 URL 是否可用
 openyida save-share-config    # 保存公开访问 / 分享配置
 openyida get-page-config      # 查询页面公开访问 / 分享配置
 openyida update-form-config   # 更新表单配置
+openyida cdn-config           # 配置 CDN 图片上传（阿里云 OSS + CDN）
+openyida cdn-upload           # 上传图片到 CDN
+openyida cdn-refresh          # 刷新 CDN 缓存
 ```
 
 ---
 
-## DEMO 展示
+## Demo 展示
 
-### 业务系统 - IPD/CRM
+### 🏢 业务系统 — IPD / CRM
+
+一句话描述需求，AI 自动生成完整的多表单业务系统。
 
 ![IPD](https://img.alicdn.com/imgextra/i2/O1CN01YBEMa929J7sD9v8U1_!!6000000008046-2-tps-3840-3366.png)
 
 ![CRM](https://img.alicdn.com/imgextra/i3/O1CN01kn0Vcn1H5OkbQaizA_!!6000000000706-2-tps-3840-2168.png)
 
-### 💰 小工具 - 个人薪资计算器
+### 💰 小工具 — 个人薪资计算器
 
 ![薪资计算器](https://gw.alicdn.com/imgextra/i2/O1CN017TeJuE1reVH2Dj7b7_!!6000000005656-2-tps-5114-2468.png)
 
----
-
-### 🌐  Landing Page - 智联协同
+### 🌐 Landing Page — 智联协同
 
 企业级产品介绍页，一句话生成完整 Landing Page。
 
 ![智联协同](https://gw.alicdn.com/imgextra/i1/O1CN01EZtvfs1cxXV00UaXi_!!6000000003667-2-tps-5118-2470.png)
 
----
-
-### 🏮 运营场景 - 看图猜灯谜
+### 🏮 运营场景 — 看图猜灯谜
 
 AI 生成灯谜图片，用户猜答案，猜错了有 AI 幽默提示。
 
-![看图猜灯谜-2](https://img.alicdn.com/imgextra/i3/O1CN01dCoscP25jSAtAB9o3_!!6000000007562-2-tps-2144-1156.png)
+![看图猜灯谜](https://img.alicdn.com/imgextra/i3/O1CN01dCoscP25jSAtAB9o3_!!6000000007562-2-tps-2144-1156.png)
 
 ---
 
 ## 常用问法
 
-1. 帮我搭建一个 xxx 应用
-2. 根据需求文档生成应用
-3. 帮我创建一个 xxx 表单页面
-4. 帮我给 xxx 页面添加一个 xxx 字段，字段名称：字段类型 xxx
-5. 帮我给 xxx 页面 xxx 字段改为必填
-6. 帮我发布 xxx 页面
-7. 帮我把页面发布为公开访问
-8. 重新登录
-9. 退出登录
+```
+帮我搭建一个 xxx 应用
+根据需求文档生成应用
+帮我创建一个 xxx 表单页面
+帮我给 xxx 页面添加一个 xxx 字段，字段名称：字段类型 xxx
+帮我给 xxx 页面 xxx 字段改为必填
+帮我发布 xxx 页面
+帮我把页面发布为公开访问
+重新登录 / 退出登录
+```
 
 ---
 
-## OpenClaw
+## OpenClaw 集成
 
-通过 [yida-app](https://clawhub.ai/nicky1108/yida-app) 在 OpenClaw 中使用。
+通过 [yida-app](https://clawhub.ai/nicky1108/yida-app) 在 OpenClaw 中使用：
 
-安装：
 ```bash
 npx clawhub@latest install nicky1108/yida-app
 ```
 
 ---
 
-## OpenYida 社区
+## 社区
 
-钉钉扫描加入 OpenYida 社区
+钉钉扫码加入 OpenYida 用户群，获取最新动态和技术支持。
 
 ![扫描加入 OpenYida 社区](https://img.alicdn.com/imgextra/i4/O1CN01RAlxmO1qF1cxRguyj_!!6000000005465-2-tps-350-356.png)
 
+---
+
 ## 贡献者
 
-感谢所有为 OpenYida 做出贡献的开发者！
+感谢所有为 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/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/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/nicky1108"><img src="https://avatars.githubusercontent.com/u/4279283?v=4&s=48" width="48" height="48" alt="nicky1108" title="nicky1108"/></a>
 </p>
 
+---
+
 ## License
 
 [MIT](./LICENSE) © 2026 Alibaba Group

package/bin/yida.js

@@ -8,8 +8,14 @@
  * 命令列表：
  *   openyida env                                        检测当前 AI 工具环境和登录态
  *   openyida copy [--force]                             复制 project 工作目录到当前 AI 工具环境
- *   openyida login                                      登录态管理
+ *   openyida login [--qr]                               登录态管理（--qr 使用终端二维码扫码）
  *   openyida logout                                     退出登录
+ *   openyida auth status                                查看当前登录状态
+ *   openyida auth login                                 执行登录
+ *   openyida auth refresh                               刷新登录态
+ *   openyida auth logout                                退出登录
+ *   openyida org list                                   列出可访问的组织
+ *   openyida org switch --corp-id <corpId>              切换组织（无需重新登录）
  *   openyida create-app "<名称>" [desc] [icon] [color]  创建应用
  *   openyida create-page <appType> "<页面名>"            创建自定义页面
  *   openyida create-form create <appType> "<表单名>" <字段JSON>  创建表单页面
@@ -20,12 +26,15 @@
  *   openyida save-share-config <appType> <formUuid> <url> <isOpen> [openAuth]  保存公开访问/分享配置
  *   openyida get-page-config <appType> <formUuid>       查询页面公开访问/分享配置
  *   openyida update-form-config <appType> <formUuid> <isRenderNav> <title>  更新表单配置
+ *   openyida export <appType> [output]                  导出应用所有表单 Schema（生成迁移包）
+ *   openyida import <file> [name]                       导入迁移包，在目标环境重建应用
  */
 
 "use strict";
 
 const { checkUpdate } = require('../lib/check-update');
 const { version: currentVersion } = require('../package.json');
+const { t } = require('../lib/i18n');
 
 // 异步检查更新，fire-and-forget，不阻塞主流程
 const updateCheckPromise = checkUpdate(currentVersion);
@@ -34,46 +43,84 @@ 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>            创建表单页面
-  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> 更新表单配置
-
-示例：
-  openyida login
-  openyida logout
-  openyida create-app "考勤管理"
-  openyida create-page APP_XXX "游戏主页"
-  openyida create-form create APP_XXX "员工信息" fields.json
-  openyida create-form update APP_XXX FORM-XXX '[{"action":"add","field":{"type":"TextField","label":"备注"}}]'
-  openyida get-schema APP_XXX FORM-XXX
-  openyida publish pages/src/home.jsx APP_XXX FORM-XXX
-  openyida verify-short-url APP_XXX FORM-XXX /o/myapp
-  openyida save-share-config APP_XXX FORM-XXX /o/myapp y n
-  openyida get-page-config APP_XXX FORM-XXX
-  openyida update-form-config APP_XXX FORM-XXX false "页面标题"
-`);
+  console.log(t('cli.help'));
+}
+
+/**
+ * 检测是否首次运行（安装后第一次执行 openyida 命令）。
+ * 通过 ~/.openyida/first-run-done 标记文件判断。
+ * 若是首次运行，打印新手引导并写入标记文件。
+ */
+function handleFirstRunGuide() {
+  const os = require('os');
+  const path = require('path');
+  const fs = require('fs');
+
+  const OPENYIDA_DIR = path.join(os.homedir(), '.openyida');
+  const FIRST_RUN_FLAG = path.join(OPENYIDA_DIR, 'first-run-done');
+
+  // 已运行过，跳过引导
+  if (fs.existsSync(FIRST_RUN_FLAG)) return;
+
+  // 写入标记，避免重复展示
+  try {
+    fs.mkdirSync(OPENYIDA_DIR, { recursive: true });
+    fs.writeFileSync(FIRST_RUN_FLAG, new Date().toISOString(), 'utf8');
+  } catch {
+    // 写入失败不影响主流程
+  }
+
+  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 BLUE    = '\x1b[34m';
+  const MAGENTA = '\x1b[35m';
+  const BG_CYAN = '\x1b[46m';
+  const WHITE   = '\x1b[37m';
+
+  const SEP = `${DIM}${'─'.repeat(60)}${RESET}`;
+
+  console.log('');
+  console.log(`${BG_CYAN}${WHITE}${BOLD}${t('cli.first_run_title')}${RESET}`);
+  console.log(SEP);
+  console.log(t('cli.first_run_welcome', `${GREEN}${BOLD}`, RESET));
+  console.log('');
+  console.log(`${BOLD}${CYAN}${t('cli.first_run_way1_title')}${RESET}`);
+  console.log(t('cli.first_run_way1_desc'));
+  console.log('');
+  console.log(`  ${YELLOW}${t('cli.first_run_prompt1')}${RESET}`);
+  console.log(`  ${YELLOW}${t('cli.first_run_prompt2')}${RESET}`);
+  console.log(`  ${YELLOW}${t('cli.first_run_prompt3')}${RESET}`);
+  console.log('');
+  console.log(`${BOLD}${CYAN}${t('cli.first_run_way2_title')}${RESET}`);
+  console.log('');
+  console.log(`  ${YELLOW}${t('cli.first_run_prompt4')}${RESET}`);
+  console.log('');
+  console.log(`${BOLD}${CYAN}${t('cli.first_run_examples_title')}${RESET}`);
+  console.log('');
+  console.log(`  ${MAGENTA}•${RESET} ${t('cli.first_run_examples')}`);
+  console.log('');
+  console.log(SEP);
+  console.log(`${BOLD}${BLUE}${t('cli.first_run_tips_title')}${RESET}`);
+  console.log('');
+  console.log(t('cli.first_run_tip1', CYAN, RESET));
+  console.log(t('cli.first_run_tip2', CYAN, RESET));
+  console.log(t('cli.first_run_tip3'));
+  console.log('');
+  console.log(SEP);
+  console.log(`  ${DIM}${t('cli.first_run_footer1')}${RESET}`);
+  console.log(`  ${DIM}${t('cli.first_run_footer2')}${RESET}`);
+  console.log('');
+  console.log(`  ${DIM}${t('cli.first_run_footer3')}${RESET}`);
+  console.log('');
 }
 
 async function main() {
   if (!command || command === '--help' || command === '-h') {
+    handleFirstRunGuide();
     printHelp();
     process.exit(0);
   }
@@ -101,6 +148,10 @@ async function main() {
       if (args[0] === '--check-only') {
         const result = checkLoginOnly();
         console.log(JSON.stringify(result, null, 2));
+      } else if (args[0] === '--qr') {
+        const { qrLogin } = require('../lib/qr-login');
+        const result = await qrLogin();
+        console.log(JSON.stringify(result));
       } else {
         const result = ensureLogin();
         console.log(JSON.stringify(result));
@@ -114,6 +165,62 @@ async function main() {
       break;
     }
 
+    case 'auth': {
+      const subCommand = args[0];
+      const { authStatus, authLogin, authRefresh, authLogout } = require('../lib/auth');
+
+      if (subCommand === 'status') {
+        authStatus();
+      } else if (subCommand === 'login') {
+        authLogin({ type: 'qrcode' });
+      } else if (subCommand === 'refresh') {
+        authRefresh();
+      } else if (subCommand === 'logout') {
+        authLogout();
+      } else {
+        console.error(t('cli.auth_usage'));
+        console.error(t('cli.auth_example'));
+        process.exit(1);
+      }
+      break;
+    }
+
+    case 'org': {
+      const subCommand = args[0];
+      const { listOrganizations, switchOrganization, interactiveSwitch } = require('../lib/org');
+      const { loadCookieData } = require('../lib/utils');
+
+      if (subCommand === 'list') {
+        const cookieData = loadCookieData();
+        if (!cookieData || !cookieData.cookies) {
+          console.error(t('org.no_login'));
+          process.exit(1);
+        }
+        await listOrganizations(cookieData);
+      } else if (subCommand === 'switch') {
+        const cookieData = loadCookieData();
+        if (!cookieData || !cookieData.cookies) {
+          console.error(t('org.no_login'));
+          process.exit(1);
+        }
+
+        // 解析 --corp-id 参数
+        const corpIdIndex = args.indexOf('--corp-id');
+        if (corpIdIndex !== -1 && args[corpIdIndex + 1]) {
+          const targetCorpId = args[corpIdIndex + 1];
+          await switchOrganization(targetCorpId, cookieData);
+        } else {
+          // 交互式选择
+          await interactiveSwitch(cookieData);
+        }
+      } else {
+        console.error(t('cli.org_usage'));
+        console.error(t('cli.org_example'));
+        process.exit(1);
+      }
+      break;
+    }
+
     case 'create-app': {
       const { run } = require('../lib/create-app');
       await run(args);
@@ -143,8 +250,8 @@ async function main() {
       // 参数顺序：<源文件路径> <appType> <formUuid>
       // publish.js 内部读取顺序：argv[2]=appType, argv[3]=formUuid, argv[4]=sourceFile
       if (args.length < 3) {
-        console.error('用法: openyida publish <源文件路径> <appType> <formUuid>');
-        console.error('示例: openyida publish pages/src/home.jsx APP_XXX FORM-XXX');
+        console.error(t('cli.publish_usage'));
+        console.error(t('cli.publish_example'));
         process.exit(1);
       }
       const [sourceFile, appType, formUuid] = args;
@@ -155,8 +262,8 @@ async function main() {
 
     case 'verify-short-url': {
       if (args.length < 3) {
-        console.error('用法: openyida verify-short-url <appType> <formUuid> <url>');
-        console.error('示例: openyida verify-short-url APP_XXX FORM-XXX /o/myapp');
+        console.error(t('cli.verify_usage'));
+        console.error(t('cli.verify_example'));
         process.exit(1);
       }
       process.argv = [process.argv[0], process.argv[1], ...args];
@@ -166,8 +273,8 @@ async function main() {
 
     case 'save-share-config': {
       if (args.length < 4) {
-        console.error('用法: openyida save-share-config <appType> <formUuid> <url> <isOpen> [openAuth]');
-        console.error('示例: openyida save-share-config APP_XXX FORM-XXX /o/myapp y n');
+        console.error(t('cli.share_usage'));
+        console.error(t('cli.share_example'));
         process.exit(1);
       }
       process.argv = [process.argv[0], process.argv[1], ...args];
@@ -177,8 +284,8 @@ async function main() {
 
     case 'get-page-config': {
       if (args.length < 2) {
-        console.error('用法: openyida get-page-config <appType> <formUuid>');
-        console.error('示例: openyida get-page-config APP_XXX FORM-XXX');
+        console.error(t('cli.page_config_usage'));
+        console.error(t('cli.page_config_example'));
         process.exit(1);
       }
       process.argv = [process.argv[0], process.argv[1], ...args];
@@ -188,8 +295,8 @@ async function main() {
 
     case 'update-form-config': {
       if (args.length < 4) {
-        console.error('用法: openyida update-form-config <appType> <formUuid> <isRenderNav> <title>');
-        console.error('示例: openyida update-form-config APP_XXX FORM-XXX false "页面标题"');
+        console.error(t('cli.form_config_usage'));
+        console.error(t('cli.form_config_example'));
         process.exit(1);
       }
       process.argv = [process.argv[0], process.argv[1], ...args];
@@ -197,9 +304,51 @@ async function main() {
       break;
     }
 
+    case 'export': {
+      if (args.length < 1) {
+        console.error(t('cli.export_usage'));
+        console.error(t('cli.export_example1'));
+        console.error(t('cli.export_example2'));
+        process.exit(1);
+      }
+      const { run: runExport } = require('../lib/export-app');
+      await runExport(args);
+      break;
+    }
+
+    case 'import': {
+      if (args.length < 1) {
+        console.error(t('cli.import_usage'));
+        console.error(t('cli.import_example1'));
+        console.error(t('cli.import_example2'));
+        process.exit(1);
+      }
+      const { run: runImport } = require('../lib/import-app');
+      await runImport(args);
+      break;
+    }
+
+    case 'cdn-config': {
+      const { run: runCdnConfig } = require('../lib/cdn-config-cmd');
+      await runCdnConfig(args);
+      break;
+    }
+
+    case 'cdn-upload': {
+      const { run: runCdnUpload } = require('../lib/cdn-upload');
+      await runCdnUpload(args);
+      break;
+    }
+
+    case 'cdn-refresh': {
+      const { run: runCdnRefresh } = require('../lib/cdn-refresh');
+      await runCdnRefresh(args);
+      break;
+    }
+
     default: {
-      console.error(`未知命令: ${command}`);
-      console.error('运行 openyida --help 查看帮助');
+      console.error(t('cli.unknown_command', command));
+      console.error(t('cli.run_help'));
       process.exit(1);
     }
   }
@@ -208,7 +357,7 @@ async function main() {
 main()
   .then(() => updateCheckPromise)
   .catch((err) => {
-    console.error(`\n❌ 执行失败: ${err.message}`);
+    console.error(t('cli.exec_failed', err.message));
     process.exit(1);
   });