openyida 2026.5.9-beta.8 → 2026.5.9

package/README.md

@@ -1,6 +1,6 @@
 <div align="center">
 
-![OpenYida](https://img.alicdn.com/imgextra/i4/O1CN017uyK3q1UUfbv7Z8oh_!!6000000002521-2-tps-2648-1382.png)
+![OpenYida](https://img.alicdn.com/imgextra/i3/O1CN01SKWbWu1aPzGXh293W_!!6000000003323-2-tps-1672-941.png)
 
 # OpenYida
 
@@ -69,12 +69,12 @@ OpenYida detects the active agent environment, workspace path, login state, and
 openyida login
 ```
 
-In Codex, Qoder, and Wukong, OpenYida returns a QR handoff when no valid cached login exists. The agent should show `qr_image_file` or `qr_url` in the conversation, ask the user to scan it with DingTalk, then run `poll_command` to finish the login and write the CLI Cookie cache. If the QR handoff is unavailable, use `openyida login --browser` as the fallback; it prefers local Chrome/Edge/Chromium CDP first and uses Playwright only as an optional fallback.
+In Codex, Qoder, Wukong, Claude Code, OpenCode, Cursor, and other detected AI tools, OpenYida first tries local Chrome/Edge/Chromium CDP when no valid cached login exists. If local CDP is unavailable, it falls back to an AI-dialog QR handoff. The agent should render `qr_image_markdown` or paste `agent_response_markdown` directly in the conversation so the QR code is visible, then run `poll_command` after the user scans it with DingTalk. If image rendering is unavailable, fall back to `qr_url`. The explicit `openyida login --browser` command still prefers CDP first and uses Playwright as an optional browser fallback.
 
 The explicit QR polling command remains available:
 
 ```bash
-openyida login --codex-qr
+openyida login --agent-qr
 ```
 
 For terminal QR login, use:
@@ -199,6 +199,40 @@ openyida get-permission APP_XXX FORM_XXX
 
 When creating or updating test data with `openyida data`, Yida date fields must use 13-digit millisecond timestamps, for example `"dateField_xxx": 1719705600000`. Do not submit `YYYY-MM-DD` strings for `DateField` or `CascadeDateField` values.
 
+### Real Environment E2E
+
+Most checks should stay offline, but OpenYida also includes an explicit real-environment smoke path for release and nightly validation:
+
+```bash
+OPENYIDA_E2E=1 npm run test:e2e:real
+OPENYIDA_E2E=1 npm run test:e2e:real:full
+npm run test:e2e:real:skills
+```
+
+The runner creates a disposable app, form, and custom page with an `OY_E2E_*` prefix, then verifies login, app listing, schema fetch, data query, and page publish. It writes a registry to `project/.cache/e2e-real/` so created resources can be audited later. To inject CI cookies without relying on a local login cache, pass `OPENYIDA_E2E_COOKIES_BASE64` as a base64 encoded cookie array or `{ "cookies": [...] }` object.
+
+`test:e2e:real:full` extends the smoke path into a broad deterministic feature matrix: auth/env, app update, form update and option mutation, page build/compile/generate/publish, data create/get/update/query, permission read, page config and short URL check, report create/append, dashboard skill verification, export/import, batch, task-center, formula/doctor/sample/CDN config, and local connector parsing/template generation. AI-backed commands such as `flash-to-prd` are available as the optional `ai` stage because they depend on remote model availability.
+
+`test:e2e:real:skills` enforces coverage for every directory under `yida-skills/skills/`. Each skill must be classified as real E2E, offline/unit, opt-in, or deprecated with an explicit reason. This prevents new skills from quietly bypassing the real-environment test plan.
+
+Each successful full run leaves a human-inspectable result app in the target organization. The final step publishes a dedicated `Full E2E Dashboard` custom page, renames the app to `OY_E2E_*_PASSED` by default, and prints direct links for the app, form, dashboard page, and report; the same links are saved under `resultApp` in the registry JSON.
+
+Useful options:
+
+| Env var | Purpose |
+|---------|---------|
+| `OPENYIDA_E2E_PREFIX` | Override the disposable resource name prefix |
+| `OPENYIDA_E2E_CORP_ID` | Switch to the dedicated test organization before creating resources |
+| `OPENYIDA_E2E_RESULT_APP_NAME` | Override the final app name shown as the full-run result |
+| `OPENYIDA_E2E_BASE_URL` | Override the Yida base URL for private deployments |
+| `OPENYIDA_E2E_FIELDS_FILE` | Use a custom form fields fixture |
+| `OPENYIDA_E2E_PAGE_SOURCE` | Use a custom page source for publish verification |
+| `OPENYIDA_E2E_SKIP_PUBLISH=1` | Skip custom page creation and publish |
+| `OPENYIDA_E2E_REGISTRY_DIR` | Write registries outside `project/.cache/e2e-real/` |
+| `OPENYIDA_E2E_FULL_STAGES` | Comma-separated stage list for `test:e2e:real:full`; use `all` or omit for the default broad matrix |
+
+Use `npm run test:e2e:real:cleanup` to list recorded disposable resources. OpenYida does not yet expose a safe app/form deletion command, so cleanup is intentionally a registry-backed audit step rather than an automatic destructive action.
+
 ### Connectors, Integrations, and Reports
 
 ```bash
@@ -220,7 +254,7 @@ Run `openyida --help` or `openyida <command> --help` for detailed usage.
 | `openyida env [--json]` | Detect the active AI tool environment and login state |
 | `openyida env <list\|show\|switch\|add\|remove>` | Manage public/private Yida environment profiles |
 | `openyida commands [--json]` | Emit the machine-readable command manifest |
-| `openyida login [--qr\|--codex\|--codex-qr\|--browser] [--corp-id <corpId>]` | Log in to Yida |
+| `openyida login [--qr\|--agent-qr\|--codex\|--browser] [--corp-id <corpId>]` | Log in to Yida |
 | `openyida logout` | Log out or switch account |
 | `openyida auth <status\|login\|refresh\|logout>` | Manage login status |
 | `openyida org list` | List accessible organizations |

package/bin/yida.js

@@ -245,26 +245,25 @@ function printLoginResult(result) {
   console.log(JSON.stringify(summary));
 }
 
-function isBrowserHandoffEnvironment() {
+function isAgentConversationEnvironment() {
   const { detectActiveTool } = require('../lib/core/utils');
-  const activeTool = detectActiveTool();
-  return !!activeTool && (activeTool.tool === 'codex' || activeTool.tool === 'qoder' || activeTool.tool === 'wukong');
+  return !!detectActiveTool();
 }
 
 function shouldUseBrowserHandoffLogin(cliArgs) {
-  if (cliArgs.includes('--qr') || cliArgs.includes('--codex-qr')) {return false;}
+  if (cliArgs.includes('--qr') || cliArgs.includes('--codex-qr') || cliArgs.includes('--agent-qr')) {return false;}
   if (cliArgs.includes('--browser') || cliArgs.includes('--codex') || cliArgs.includes('--qoder') || cliArgs.includes('--wukong')) {return true;}
   return false;
 }
 
-function shouldUseAgentQrLogin(cliArgs) {
-  if (cliArgs.includes('--qr') || cliArgs.includes('--codex-qr')) {return false;}
+function shouldUseAgentLogin(cliArgs) {
+  if (cliArgs.includes('--qr') || cliArgs.includes('--codex-qr') || cliArgs.includes('--agent-qr')) {return false;}
   if (shouldUseBrowserHandoffLogin(cliArgs)) {return false;}
-  return isBrowserHandoffEnvironment();
+  return isAgentConversationEnvironment();
 }
 
 function shouldUseCodexQrLogin(cliArgs) {
-  if (cliArgs.includes('--codex-qr')) {return true;}
+  if (cliArgs.includes('--codex-qr') || cliArgs.includes('--agent-qr')) {return true;}
   return false;
 }
 
@@ -338,15 +337,17 @@ async function main() {
 
     case 'login': {
       const { checkLoginOnly } = require('../lib/auth/login');
-      if (args.includes('--codex-poll')) {
+      if (args.includes('--agent-poll') || args.includes('--codex-poll')) {
+        const sessionFile = getArgValue(args, '--agent-poll') || getArgValue(args, '--codex-poll');
         const { pollCodexQrLogin } = require('../lib/auth/qr-login');
-        const result = await pollCodexQrLogin(getArgValue(args, '--codex-poll'), {
+        const result = await pollCodexQrLogin(sessionFile, {
           corpId: getArgValue(args, '--corp-id'),
         });
         printLoginResult(result);
-      } else if (args.includes('--codex-select')) {
+      } else if (args.includes('--agent-select') || args.includes('--codex-select')) {
+        const sessionFile = getArgValue(args, '--agent-select') || getArgValue(args, '--codex-select');
         const { selectCodexQrCorp } = require('../lib/auth/qr-login');
-        const result = await selectCodexQrCorp(getArgValue(args, '--codex-select'), {
+        const result = await selectCodexQrCorp(sessionFile, {
           corpId: getArgValue(args, '--corp-id'),
         });
         printLoginResult(result);
@@ -379,14 +380,20 @@ async function main() {
         const { qrLogin } = require('../lib/auth/qr-login');
         const result = await qrLogin({ corpId: getArgValue(args, '--corp-id') });
         console.log(JSON.stringify(result));
-      } else if (shouldUseAgentQrLogin(args)) {
+      } else if (shouldUseAgentLogin(args)) {
         const cachedResult = checkLoginOnly({ includeSecrets: true });
         if (cachedResult.status === 'ok') {
           printLoginResult(cachedResult);
         } else {
-          const { startCodexQrLogin } = require('../lib/auth/qr-login');
-          const result = await startCodexQrLogin({ corpId: getArgValue(args, '--corp-id') });
-          printLoginResult(result);
+          const { interactiveLogin } = require('../lib/auth/login');
+          const browserResult = interactiveLogin({ playwrightFallback: false });
+          if (browserResult) {
+            printLoginResult(browserResult);
+          } else {
+            const { startCodexQrLogin } = require('../lib/auth/qr-login');
+            const result = await startCodexQrLogin({ corpId: getArgValue(args, '--corp-id') });
+            printLoginResult(result);
+          }
         }
       } else if (shouldUseBrowserHandoffLogin(args)) {
         const cachedResult = checkLoginOnly({ includeSecrets: true });

package/lib/auth/login.js

@@ -10,7 +10,7 @@
  *   ensureLogin()          - 确保有效登录态（优先缓存，否则尝试可选浏览器登录）
  *   checkLoginOnly()       - 仅检查登录态，不触发登录
  *   refreshCsrfFromCache() - 从缓存 Cookie 重新提取 csrf_token
- *   interactiveLogin()     - 打开浏览器扫码登录（优先本地 Chrome CDP，失败时使用 Playwright 兜底）
+ *   interactiveLogin()     - 打开浏览器扫码登录（优先本地 Chrome CDP，可选 Playwright 兜底）
  *   saveCookieCache()      - 保存 Cookie 到本地缓存（供 qr-login.js 使用）
  *   logout()               - 退出登录，清空 Cookie 缓存
  */
@@ -183,7 +183,7 @@ function refreshCsrfFromCache() {
 
 /**
  * 确保拥有有效的登录态。优先从本地缓存 Cookie 中提取，否则尝试本地浏览器登录。
- * 默认 CLI 登录路径在 bin/yida.js 中优先使用终端二维码或 AI 工具二维码 handoff。
+ * 默认 CLI 登录路径在 bin/yida.js 中负责选择终端二维码、AI 工具 CDP 或二维码 handoff。
  * @returns {object} loginResult
  */
 function ensureLogin() {
@@ -257,20 +257,30 @@ function getPlaywrightPath() {
 
 /**
  * 打开有头浏览器让用户扫码登录。
- * 优先使用无依赖的 Chrome/Edge/Chromium CDP 登录；失败时再尝试用户安装的 Playwright。
+ * 优先使用无依赖的 Chrome/Edge/Chromium CDP 登录；失败时可选择再尝试用户安装的 Playwright。
+ * @param {object} [options]
+ * @param {boolean} [options.playwrightFallback=true] - CDP 失败后是否尝试 Playwright
  * @returns {object} loginResult
  */
-function interactiveLogin() {
+function interactiveLogin(options = {}) {
+  const playwrightFallback = options.playwrightFallback !== false;
   const config = loadConfig();
   const loginUrl = config.loginUrl || DEFAULT_LOGIN_URL;
 
   try {
+    if (process.env.OPENYIDA_DISABLE_CDP_LOGIN === '1') {
+      throw new Error('CDP login disabled by OPENYIDA_DISABLE_CDP_LOGIN');
+    }
     return cdpInteractiveLogin(loginUrl);
   } catch (err) {
     const { warn: chalkWarn3 } = require('../core/chalk');
     chalkWarn3(err.message);
   }
 
+  if (!playwrightFallback) {
+    return null;
+  }
+
   const playwrightPath = getPlaywrightPath();
   if (!playwrightPath) {
     const { error: chalkError3 } = require('../core/chalk');

package/lib/auth/qr-login.js

@@ -35,10 +35,43 @@ function getTargetCorpId(options = {}, session = {}) {
 }
 
 function buildCodexPollCommand(sessionFile, targetCorpId) {
-  const baseCommand = `openyida login --codex-poll ${shellQuote(sessionFile)}`;
+  const baseCommand = `openyida login --agent-poll ${shellQuote(sessionFile)}`;
   return targetCorpId ? `${baseCommand} --corp-id ${shellQuote(targetCorpId)}` : baseCommand;
 }
 
+function buildQrImageMarkdown(qrImageFile) {
+  if (!qrImageFile) {return null;}
+  return `![OpenYida login QR code](${String(qrImageFile).replace(/\\/g, '/')})`;
+}
+
+function buildAgentQrResponseMarkdown(result) {
+  const lines = [t('qr_login.scan_hint').trim(), ''];
+  if (result.qr_image_markdown) {
+    lines.push(result.qr_image_markdown, '');
+  }
+  lines.push(t('qr_login.qr_url_label', result.qr_url).trim());
+  lines.push('');
+  lines.push(`poll_command: \`${result.poll_command}\``);
+  return lines.join('\n');
+}
+
+function buildNeedQrScanResult({ qrUrl, qrImageFile, sessionFile, targetCorpId }) {
+  const qrImageMarkdown = buildQrImageMarkdown(qrImageFile);
+  const result = {
+    status: 'need_qr_scan',
+    handoff_type: 'qr',
+    can_auto_use: false,
+    qr_url: qrUrl,
+    qr_image_file: qrImageFile || null,
+    qr_image_markdown: qrImageMarkdown,
+    session_file: sessionFile,
+    poll_command: buildCodexPollCommand(sessionFile, targetCorpId),
+    message: 'Scan the QR code with DingTalk, then run poll_command.',
+  };
+  result.agent_response_markdown = buildAgentQrResponseMarkdown(result);
+  return result;
+}
+
 // ── HTTP 工具 ─────────────────────────────────────────
 
 /**
@@ -1088,16 +1121,12 @@ function buildFakeCodexQrLoginResult(options = {}) {
     createdAt: new Date().toISOString(),
   });
 
-  return {
-    status: 'need_qr_scan',
-    handoff_type: 'qr',
-    can_auto_use: false,
-    qr_url: 'https://login.example.test/qr?code=test',
-    qr_image_file: qrImageFile,
-    session_file: sessionFile,
-    poll_command: buildCodexPollCommand(sessionFile, targetCorpId),
-    message: 'Scan the QR code with DingTalk, then run poll_command.',
-  };
+  return buildNeedQrScanResult({
+    qrUrl: 'https://login.example.test/qr?code=test',
+    qrImageFile,
+    sessionFile,
+    targetCorpId,
+  });
 }
 
 async function startCodexQrLogin(options = {}) {
@@ -1139,16 +1168,12 @@ async function startCodexQrLogin(options = {}) {
     createdAt: new Date().toISOString(),
   });
 
-  return {
-    status: 'need_qr_scan',
-    handoff_type: 'qr',
-    can_auto_use: false,
-    qr_url: qrUrl,
-    qr_image_file: imageWritten ? qrImageFile : null,
-    session_file: sessionFile,
-    poll_command: buildCodexPollCommand(sessionFile, targetCorpId),
-    message: 'Scan the QR code with DingTalk, then run poll_command.',
-  };
+  return buildNeedQrScanResult({
+    qrUrl,
+    qrImageFile: imageWritten ? qrImageFile : null,
+    sessionFile,
+    targetCorpId,
+  });
 }
 
 async function pollCodexQrLogin(sessionFile, options = {}) {
@@ -1414,6 +1439,9 @@ module.exports = {
     isDingtalkOAuthPassResult,
     buildCodexCorpInteraction,
     buildCodexPollCommand,
+    buildQrImageMarkdown,
+    buildAgentQrResponseMarkdown,
+    buildNeedQrScanResult,
     getTargetCorpId,
   },
 };

package/lib/core/command-manifest.js

@@ -20,7 +20,7 @@ const COMMAND_GROUPS = [
     id: 'auth',
     titleKey: 'help.group_auth',
     commands: [
-      command('login', ['login'], 'login [--qr|--codex|--codex-qr|--browser] [--corp-id <corpId>]', 'help.cmd_login', {
+      command('login', ['login'], 'login [--qr|--agent-qr|--codex|--browser] [--corp-id <corpId>]', 'help.cmd_login', {
         requiresLogin: false,
         output: 'json',
       }),

package/lib/core/doctor.js

@@ -211,7 +211,7 @@ class EnvironmentChecker {
         label: '可选浏览器登录（Playwright 未安装）',
         passed: true,
         severity: Severity.INFO,
-        message: '默认登录使用终端二维码或 AI 工具内置浏览器 handoff，不需要 Playwright',
+        message: '默认登录优先使用终端二维码或本地 CDP；AI 工具在 CDP 不可用时返回对话框二维码 handoff，不需要 Playwright',
         fixType: null,
       };
     }

package/lib/core/locales/ar.js

@@ -10,7 +10,7 @@ module.exports = {
     usage: 'الاستخدام:',
     alias: 'الاسم المستعار:',
     group_auth: 'البيئة & المصادقة',
-    cmd_login: 'تسجيل الدخول (الذاكرة المؤقتة أولاً، --qr أو --codex لتسجيل دخول متصفح Codex)',
+    cmd_login: 'تسجيل الدخول (الذاكرة المؤقتة أولاً، استخدم --browser أو --agent-qr عند الحاجة)',
     cmd_logout: 'تسجيل الخروج / تبديل الحساب',
     cmd_auth: 'إدارة حالة تسجيل الدخول',
     cmd_org: 'إدارة المنظمات (عرض / تبديل)',

package/lib/core/locales/de.js

@@ -10,7 +10,7 @@ module.exports = {
     usage: 'Verwendung:',
     alias: 'Alias:',
     group_auth: 'Umgebung & Authentifizierung',
-    cmd_login: 'Anmelden (Cache bevorzugt, --qr oder --codex for browser login)',
+    cmd_login: 'Anmelden (Cache zuerst, bei Bedarf --browser oder --agent-qr)',
     cmd_logout: 'Abmelden / Konto wechseln',
     cmd_auth: 'Anmeldestatus-Verwaltung',
     cmd_org: 'Organisationsverwaltung (auflisten / wechseln)',

package/lib/core/locales/en.js

@@ -12,7 +12,7 @@ module.exports = {
     usage: 'Usage:',
     alias: 'Alias:',
     group_auth: 'Auth & Environment',
-    cmd_login: 'Login (cache first, --qr or --codex for browser login)',
+    cmd_login: 'Login (cache first, --browser or --agent-qr when needed)',
     cmd_logout: 'Logout / switch account',
     cmd_auth: 'Login state management',
     cmd_org: 'Organization management (list / switch)',

package/lib/core/locales/es.js

@@ -10,7 +10,7 @@ module.exports = {
     usage: 'Uso:',
     alias: 'Alias:',
     group_auth: 'Entorno & Autenticación',
-    cmd_login: 'Iniciar sesión (caché primero, --qr o --codex for browser login)',
+    cmd_login: 'Iniciar sesión (caché primero, --browser o --agent-qr si hace falta)',
     cmd_logout: 'Cerrar sesión / cambiar cuenta',
     cmd_auth: 'Gestión del estado de sesión',
     cmd_org: 'Gestión de organizaciones (listar / cambiar)',

package/lib/core/locales/fr.js

@@ -10,7 +10,7 @@ module.exports = {
     usage: 'Utilisation :',
     alias: 'Alias :',
     group_auth: 'Environnement & Authentification',
-    cmd_login: 'Connexion (cache prioritaire, --qr ou --codex pour navigateur Codex)',
+    cmd_login: 'Connexion (cache prioritaire, --browser ou --agent-qr si nécessaire)',
     cmd_logout: 'Déconnexion / changer de compte',
     cmd_auth: 'Gestion de l\'état de connexion',
     cmd_org: 'Gestion des organisations (lister / changer)',

package/lib/core/locales/hi.js

@@ -10,7 +10,7 @@ module.exports = {
     usage: 'उपयोग:',
     alias: 'उपनाम:',
     group_auth: 'वातावरण & प्रमाणीकरण',
-    cmd_login: 'लॉगिन (कैश प्राथमिकता, --qr या --codex for browser login)',
+    cmd_login: 'लॉगिन (पहले कैश, जरूरत हो तो --browser या --agent-qr)',
     cmd_logout: 'लॉगआउट / खाता बदलें',
     cmd_auth: 'लॉगिन स्थिति प्रबंधन',
     cmd_org: 'संगठन प्रबंधन (सूची / बदलें)',

package/lib/core/locales/ja.js

@@ -12,7 +12,7 @@ module.exports = {
     usage: '使用方法:',
     alias: 'エイリアス:',
     group_auth: '環境 & 認証',
-    cmd_login: 'ログイン（キャッシュ優先、--qr または --codex browser login）',
+    cmd_login: 'ログイン（キャッシュ優先、必要に応じて --browser または --agent-qr）',
     cmd_logout: 'ログアウト / アカウント切替',
     cmd_auth: 'ログイン状態管理',
     cmd_org: '組織管理（一覧 / 切替）',

package/lib/core/locales/ko.js

@@ -10,7 +10,7 @@ module.exports = {
     usage: '사용법:',
     alias: '별칭:',
     group_auth: '환경 & 인증',
-    cmd_login: '로그인 (캐시 우선, --qr 또는 --codex 스캔)',
+    cmd_login: '로그인 (캐시 우선, 필요 시 --browser 또는 --agent-qr)',
     cmd_logout: '로그아웃 / 계정 전환',
     cmd_auth: '로그인 상태 관리',
     cmd_org: '조직 관리 (목록 / 전환)',

package/lib/core/locales/pt.js

@@ -10,7 +10,7 @@ module.exports = {
     usage: 'Uso:',
     alias: 'Alias:',
     group_auth: 'Ambiente & Autenticação',
-    cmd_login: 'Login (cache primeiro, --qr ou --codex for browser login)',
+    cmd_login: 'Login (cache primeiro, use --browser ou --agent-qr se necessário)',
     cmd_logout: 'Logout / trocar conta',
     cmd_auth: 'Gerenciamento do estado de login',
     cmd_org: 'Gerenciamento de organizações (listar / trocar)',

package/lib/core/locales/vi.js

@@ -10,7 +10,7 @@ module.exports = {
     usage: 'Cách dùng:',
     alias: 'Bí danh:',
     group_auth: 'Môi trường & Xác thực',
-    cmd_login: 'Đăng nhập (ưu tiên cache, --qr hoặc --codex browser login)',
+    cmd_login: 'Đăng nhập (ưu tiên cache, dùng --browser hoặc --agent-qr khi cần)',
     cmd_logout: 'Đăng xuất / chuyển tài khoản',
     cmd_auth: 'Quản lý trạng thái đăng nhập',
     cmd_org: 'Quản lý tổ chức (liệt kê / chuyển)',

package/lib/core/locales/zh-HK.js

@@ -12,7 +12,7 @@ module.exports = {
     usage: '用法:',
     alias: '別名:',
     group_auth: '環境 & 認證',
-    cmd_login: '登入（優先緩存，--qr 或 --codex 瀏覽器登入）',
+    cmd_login: '登入（優先緩存，按需使用 --browser 或 --agent-qr）',
     cmd_logout: '登出 / 切換帳戶',
     cmd_auth: '登入態管理',
     cmd_org: '組織管理（列出 / 切換）',

package/lib/core/locales/zh.js

@@ -12,7 +12,7 @@ module.exports = {
     usage: '用法:',
     alias: '别名:',
     group_auth: '环境 & 认证',
-    cmd_login: '登录（优先缓存，--qr 或 --codex 浏览器登录）',
+    cmd_login: '登录（优先缓存，按需使用 --browser 或 --agent-qr）',
     cmd_logout: '退出登录 / 切换账号',
     cmd_auth: '登录态管理',
     cmd_org: '组织管理（列出 / 切换）',

package/lib/mcp/server.js

@@ -129,13 +129,13 @@ function listTools() {
     {
       name: SELECT_ORGANIZATION_TOOL,
       title: '选择宜搭登录组织',
-      description: '用 Codex 原生 MCP elicitation 单选控件选择宜搭组织，并完成 OpenYida Codex 二维码登录。',
+      description: '用 AI 工具原生 MCP elicitation 单选控件选择宜搭组织，并完成 OpenYida 二维码登录。',
       inputSchema: {
         type: 'object',
         properties: {
           session_file: {
             type: 'string',
-            description: 'openyida login --codex-poll 返回的 session_file 路径。',
+            description: 'openyida login --agent-poll 返回的 session_file 路径。兼容旧的 --codex-poll。',
           },
           message: {
             type: 'string',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openyida",
-  "version": "2026.5.9-beta.8",
+  "version": "2026.5.9",
   "description": "OpenYida CLI - 宜搭低代码 AI 开发工具（安装即用，零配置）",
   "bin": {
     "openyida": "bin/yida.js",
@@ -22,6 +22,10 @@
   "scripts": {
     "test": "jest",
     "test:unit": "jest",
+    "test:e2e:real": "node scripts/e2e-real/runner.js",
+    "test:e2e:real:full": "node scripts/e2e-real/full-runner.js",
+    "test:e2e:real:skills": "node scripts/e2e-real/skill-coverage.js",
+    "test:e2e:real:cleanup": "node scripts/e2e-real/cleanup.js",
     "test:coverage": "jest --coverage",
     "lint": "eslint bin/ lib/ scripts/ tests/ --ext .js",
     "lint:fix": "eslint bin/ lib/ scripts/ tests/ --ext .js --fix",

package/scripts/e2e-real/cleanup.js

@@ -0,0 +1,67 @@
+#!/usr/bin/env node
+
+'use strict';
+
+const fs = require('fs');
+const path = require('path');
+
+const ROOT = path.resolve(__dirname, '..', '..');
+const DEFAULT_REGISTRY_DIR = path.join(ROOT, 'project', '.cache', 'e2e-real');
+
+function getRegistryDir(env = process.env) {
+  return env.OPENYIDA_E2E_REGISTRY_DIR || DEFAULT_REGISTRY_DIR;
+}
+
+function listRegistries(registryDir = getRegistryDir()) {
+  if (!fs.existsSync(registryDir)) {return [];}
+  return fs.readdirSync(registryDir)
+    .filter((file) => file.endsWith('.json'))
+    .map((file) => {
+      const registryPath = path.join(registryDir, file);
+      const registry = JSON.parse(fs.readFileSync(registryPath, 'utf8'));
+      return { registryPath, registry };
+    })
+    .sort((a, b) => String(a.registry.startedAt || '').localeCompare(String(b.registry.startedAt || '')));
+}
+
+function printSummary(items) {
+  if (items.length === 0) {
+    console.log('No real E2E registries found.');
+    return;
+  }
+
+  for (const item of items) {
+    const registry = item.registry;
+    console.log(`\n${registry.runId || path.basename(item.registryPath)} [${registry.status || 'unknown'}]`);
+    console.log(`Registry: ${item.registryPath}`);
+    for (const resource of registry.resources || []) {
+      const id = resource.appType || resource.formUuid || resource.pageId || 'unknown';
+      const secondary = resource.formUuid || resource.pageId || '';
+      console.log(`- ${resource.type}: ${id}${secondary && secondary !== id ? ` / ${secondary}` : ''} ${resource.name || ''}`);
+    }
+  }
+
+  console.log('\nOpenYida does not yet expose a safe app/form deletion command, so this script lists disposable resources recorded by real E2E runs for manual cleanup.');
+}
+
+function run(options = {}) {
+  const registryDir = options.registryDir || getRegistryDir(options.env || process.env);
+  const items = listRegistries(registryDir);
+  printSummary(items);
+  return items;
+}
+
+if (require.main === module) {
+  try {
+    run();
+  } catch (error) {
+    console.error(error.message);
+    process.exit(1);
+  }
+}
+
+module.exports = {
+  getRegistryDir,
+  listRegistries,
+  run,
+};

package/scripts/e2e-real/fixtures/form-fields.json

@@ -0,0 +1,18 @@
+[
+  {
+    "type": "TextField",
+    "label": "E2E Text",
+    "required": true,
+    "placeholder": "Created by OpenYida real E2E"
+  },
+  {
+    "type": "NumberField",
+    "label": "E2E Number",
+    "placeholder": "123"
+  },
+  {
+    "type": "SelectField",
+    "label": "E2E Status",
+    "options": ["New", "Done"]
+  }
+]