openyida 2026.4.2-beta.0 → 2026.4.2-beta.12

package/README.md

@@ -31,6 +31,15 @@ npm install -g openyida
 
 **Zero config, works out of the box.** After installation, just chat in Claude Code / OpenCode / Aone Copilot:
 
+### Wukong Installation
+
+Wukong uses manual skill package installation instead of npm:
+
+1. Download the latest skill package (`.zip`) from [GitHub Releases](https://github.com/openyida/openyida/releases)
+2. Open Wukong → **Skill Center** → **Upload Skill**, then select the downloaded package
+
+
+
 ```
 Build me an IPD system on Yida to manage the full chip production workflow
 Help me set up a CRM

package/lib/auth/login.js

@@ -1,6 +1,11 @@
 /**
  * login.js - 宜搭登录态管理（Playwright 扫码登录）
  *
+ * 登录策略（按优先级）：
+ *   1. 本地 Cookie 缓存（最快）
+ *   2. 本地 Chrome（channel: 'chrome'）
+ *   3. Playwright 内置 Chromium（兜底）
+ *
  * 导出函数：
  *   ensureLogin()          - 确保有效登录态（优先缓存，否则扫码）
  *   checkLoginOnly()       - 仅检查登录态，不触发登录
@@ -228,7 +233,14 @@ const { chromium } = playwright;
 const { URL } = require('url');
 
 (async () => {
-  const browser = await chromium.launch({ headless: false });
+  // 优先使用本地已安装的 Chrome，避免下载 Playwright 内置 Chromium
+  let browser;
+  try {
+    browser = await chromium.launch({ channel: 'chrome', headless: false });
+  } catch {
+    // 本地未安装 Chrome，降级为 Playwright 内置 Chromium
+    browser = await chromium.launch({ headless: false });
+  }
   const context = await browser.newContext();
   const page = await context.newPage();
   await page.goto(${JSON.stringify(loginUrl)}, { timeout: 120000 });

package/lib/core/copy.js

@@ -194,7 +194,7 @@ function resolveDestBaseFromEnv(activeToolName, activeProjectRoot, envResults) {
   if (isWukong) {
     return activeProjectRoot
       ? path.dirname(activeProjectRoot)
-      : path.join(os.homedir(), '.real', 'workspace');
+      : path.join(process.env.AGENT_WORK_ROOT || path.join(os.homedir(), '.real', 'workspace'));
   }
 
   if (activeToolName) {
@@ -274,13 +274,24 @@ function run() {
   const results = [];
 
   if (shouldCopyProject) {
-    const count = copyItem(
-      'project/',
-      packageProjectDir,
-      path.join(destBase, 'project'),
-      isForce
-    );
-    results.push({ label: 'project/', dest: path.join(destBase, 'project'), count, type: 'copy' });
+    // 检查 destBase 是否为空目录：
+    //   - 空目录（如悟空新工作区）→ 直接把 project/ 内容铺进 destBase，不创建 project/ 这层
+    //   - 非空目录（已有其他文件）→ 复制整个 project/ 目录（含目录本身）
+    const destBaseEntries = fs.existsSync(destBase)
+      ? fs.readdirSync(destBase).filter((name) => name !== '.DS_Store')
+      : [];
+    const isDestBaseEmpty = destBaseEntries.length === 0;
+
+    const projectDestDir = isDestBaseEmpty
+      ? destBase
+      : path.join(destBase, 'project');
+
+    if (isDestBaseEmpty) {
+      console.log(t('copy.dest_empty_flatten'));
+    }
+
+    const count = copyItem('project/', packageProjectDir, projectDestDir, isForce);
+    results.push({ label: 'project/', dest: projectDestDir, count, type: 'copy' });
   }
 
   if (shouldLinkSkills) {

package/lib/core/doctor.js

@@ -212,7 +212,7 @@ class EnvironmentChecker {
         severity: Severity.ERROR,
         message: 'Playwright 未安装',
         fixType: FixType.COMMAND,
-        fixCommand: 'npm install playwright && npx playwright install chromium',
+        fixCommand: 'npm install playwright',
       };
     }
   }
@@ -426,7 +426,12 @@ class ProjectInitChecker {
   }
 
   async check() {
-    const projectDir = path.join(this.projectRoot, 'project');
+    // 若 projectRoot 本身就是 project 目录（AI 工具将工作区根识别为 project/ 子目录时），
+    // 则直接检测 projectRoot/config.json，避免拼出 project/project 的错误路径。
+    const rootBasename = path.basename(this.projectRoot);
+    const projectDir = rootBasename === 'project'
+      ? this.projectRoot
+      : path.join(this.projectRoot, 'project');
     const configPath = path.join(projectDir, 'config.json');
     const passed = fs.existsSync(projectDir) && fs.existsSync(configPath);
 
@@ -434,10 +439,10 @@ class ProjectInitChecker {
       id: 'project-init',
       label: passed ? 'project/ 工作目录已初始化' : 'project/ 工作目录检测',
       passed,
-      severity: passed ? Severity.INFO : Severity.WARNING,
-      message: passed ? null : 'project/ 目录未初始化，将自动执行 openyida copy',
-      fixType: passed ? null : FixType.COMMAND,
-      fixCommand: passed ? null : 'openyida copy',
+      severity: passed ? Severity.INFO : Severity.ERROR,
+      message: passed ? null : 'project/ 目录未初始化，将自动初始化',
+      fixType: passed ? null : FixType.AUTO,
+      fixAction: passed ? null : 'init-project',
     }];
   }
 }
@@ -657,7 +662,7 @@ class FixEngine {
 
     for (const issue of issues) {
       if (issue.fixType === FixType.AUTO) {
-        const result = this.applyAutoFix(issue);
+        const result = await this.applyAutoFix(issue);
         this.fixResults.push(result);
       } else if (issue.fixType === FixType.COMMAND) {
         this.fixResults.push({
@@ -680,9 +685,9 @@ class FixEngine {
   /**
    * 执行自动修复动作。
    * @param {object} issue
-   * @returns {object}
+   * @returns {Promise<object>}
    */
-  applyAutoFix(issue) {
+  async applyAutoFix(issue) {
     switch (issue.fixAction) {
       case 'create-config': {
         const configPath = path.join(this.projectRoot, 'config.json');
@@ -710,6 +715,24 @@ class FixEngine {
         };
       }
 
+      case 'init-project': {
+        try {
+          const copy = require('./copy');
+          await copy([]);
+          return {
+            id: issue.id,
+            fixed: true,
+            message: '已自动初始化 project/ 工作目录',
+          };
+        } catch (error) {
+          return {
+            id: issue.id,
+            fixed: false,
+            message: `project/ 初始化失败，请手动运行：openyida copy（${error.message}）`,
+          };
+        }
+      }
+
       default:
         return {
           id: issue.id,

package/lib/core/env.js

@@ -55,7 +55,7 @@ function detectEnvironment() {
     const isActive = activeTool && activeTool.dirName === dirName;
     // path.join 在 Windows 上自动使用反斜杠，兼容所有平台
     const workspaceRoot = isWukong
-      ? path.join(home, '.real', 'workspace', 'project')
+      ? path.join(process.env.AGENT_WORK_ROOT || path.join(home, '.real', 'workspace'), 'project')
       : cwdProject;
     const hasProject = fs.existsSync(workspaceRoot);
 

package/lib/core/locales/ar.js

@@ -203,6 +203,7 @@ module.exports = {
     title: '  openyida copy - تهيئة دليل عمل Yida',
     package_root: '\n📦 جذر الحزمة: {0}',
     dest_root: '🤖 الدليل الهدف: {0}',
+    dest_empty_flatten: '📂 الدليل الهدف فارغ، سيتم نسخ محتويات project/ مباشرةً (بدون إنشاء مجلد project/ فرعي)',
     force_mode: '⚠️  وضع --force: سيتم مسح الدليل الهدف قبل النسخ',
     no_package: '\n❌ لم يتم العثور على دليل حزمة openyida',
     no_package_hint1: '   تأكد من تثبيت openyida بشكل عام:',

package/lib/core/locales/de.js

@@ -203,6 +203,7 @@ module.exports = {
     title: '  openyida copy - Yida-Arbeitsverzeichnis initialisieren',
     package_root: '\n📦 Paketstamm: {0}',
     dest_root: '🤖 Zielverzeichnis: {0}',
+    dest_empty_flatten: '📂 Zielverzeichnis ist leer, project/-Inhalte werden direkt hineinkopiert (kein project/-Unterverzeichnis)',
     force_mode: '⚠️  --force-Modus: Zielverzeichnis wird vor dem Kopieren geleert',
     no_package: '\n❌ openyida-Paketverzeichnis nicht gefunden',
     no_package_hint1: '   Stellen Sie sicher, dass openyida global installiert ist:',

package/lib/core/locales/en.js

@@ -575,6 +575,7 @@ Examples:
     package_root: '\n📦 Package root: {0}',
     dest_base: '🤖 Target root: {0}',
     dest_root: '🤖 Target root: {0}',
+    dest_empty_flatten: '📂 Target directory is empty, flattening project/ contents directly into it (no project/ subdirectory)',
     force_mode: '⚠️  --force mode: target directory will be cleared before copying',
     no_package: '\n❌ openyida package directory not found',
     no_package_hint1: '   Please ensure openyida is installed globally:',

package/lib/core/locales/es.js

@@ -203,6 +203,7 @@ module.exports = {
     title: '  openyida copy - Inicializar directorio de trabajo Yida',
     package_root: '\n📦 Raíz del paquete: {0}',
     dest_root: '🤖 Directorio destino: {0}',
+    dest_empty_flatten: '📂 El directorio destino está vacío, los contenidos de project/ se copiarán directamente (sin crear subdirectorio project/)',
     force_mode: '⚠️  Modo --force: el directorio destino será vaciado antes de copiar',
     no_package: '\n❌ Directorio del paquete openyida no encontrado',
     no_package_hint1: '   Asegúrese de que openyida esté instalado globalmente:',

package/lib/core/locales/fr.js

@@ -203,6 +203,7 @@ module.exports = {
     title: '  openyida copy - Initialisation du répertoire de travail Yida',
     package_root: '\n📦 Racine du package : {0}',
     dest_root: '🤖 Répertoire cible : {0}',
+    dest_empty_flatten: '📂 Le répertoire cible est vide, les contenus de project/ seront copiés directement (sans créer de sous-répertoire project/)',
     force_mode: '⚠️  Mode --force : le répertoire cible sera vidé avant la copie',
     no_package: '\n❌ Répertoire du package openyida introuvable',
     no_package_hint1: "   Vérifiez qu'openyida est installé globalement :",

package/lib/core/locales/hi.js

@@ -203,6 +203,7 @@ module.exports = {
     title: '  openyida copy - Yida कार्य निर्देशिका प्रारंभ करें',
     package_root: '\n📦 पैकेज रूट: {0}',
     dest_root: '🤖 लक्ष्य निर्देशिका: {0}',
+    dest_empty_flatten: '📂 लक्ष्य निर्देशिका खाली है, project/ की सामग्री सीधे कॉपी की जाएगी (project/ उपनिर्देशिका नहीं बनेगी)',
     force_mode: '⚠️  --force मोड: कॉपी करने से पहले लक्ष्य निर्देशिका साफ की जाएगी',
     no_package: '\n❌ openyida पैकेज निर्देशिका नहीं मिली',
     no_package_hint1: '   सुनिश्चित करें कि openyida वैश्विक रूप से स्थापित है:',

package/lib/core/locales/ja.js

@@ -560,6 +560,7 @@ openyida - Yida CLI ツール
     package_root: '\n📦 パッケージルート: {0}',
     dest_base: '🤖 ターゲットルート: {0}',
     dest_root: '🤖 ターゲットルート: {0}',
+    dest_empty_flatten: '📂 ターゲットディレクトリが空のため、project/ の内容を直接コピーします（project/ サブディレクトリは作成しません）',
     force_mode: '⚠️  --force モード：ターゲットディレクトリをクリアしてからコピーします',
     no_package: '\n❌ openyida パッケージディレクトリが見つかりません',
     no_package_hint1: '   openyida がグローバルにインストールされていることを確認してください：',

package/lib/core/locales/ko.js

@@ -206,6 +206,7 @@ module.exports = {
     title: '  openyida copy - Yida 작업 디렉토리 초기화',
     package_root: '\n📦 패키지 루트: {0}',
     dest_root: '🤖 대상 루트: {0}',
+    dest_empty_flatten: '📂 대상 디렉토리가 비어 있어 project/ 내용을 직접 복사합니다 (project/ 하위 디렉토리 생성 안 함)',
     force_mode: '⚠️  --force 모드: 대상 디렉토리를 초기화 후 복사합니다',
     no_package: '\n❌ openyida 패키지 디렉토리를 찾을 수 없습니다',
     no_package_hint1: '   openyida가 전역으로 설치되어 있는지 확인하세요:',

package/lib/core/locales/pt.js

@@ -203,6 +203,7 @@ module.exports = {
     title: '  openyida copy - Inicializar diretório de trabalho Yida',
     package_root: '\n📦 Raiz do pacote: {0}',
     dest_root: '🤖 Diretório destino: {0}',
+    dest_empty_flatten: '📂 O diretório destino está vazio, os conteúdos de project/ serão copiados diretamente (sem criar subdiretório project/)',
     force_mode: '⚠️  Modo --force: o diretório destino será esvaziado antes de copiar',
     no_package: '\n❌ Diretório do pacote openyida não encontrado',
     no_package_hint1: '   Certifique-se de que o openyida está instalado globalmente:',

package/lib/core/locales/vi.js

@@ -203,6 +203,7 @@ module.exports = {
     title: '  openyida copy - Khởi tạo thư mục làm việc Yida',
     package_root: '\n📦 Thư mục gốc gói: {0}',
     dest_root: '🤖 Thư mục đích: {0}',
+    dest_empty_flatten: '📂 Thư mục đích trống, nội dung project/ sẽ được sao chép trực tiếp (không tạo thư mục con project/)',
     force_mode: '⚠️  Chế độ --force: thư mục đích sẽ được xóa trước khi sao chép',
     no_package: '\n❌ Không tìm thấy thư mục gói openyida',
     no_package_hint1: '   Hãy đảm bảo openyida đã được cài đặt toàn cục:',

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

@@ -469,6 +469,7 @@ openyida - 宜搭命令列工具
     package_root: '\n📦 套件根目錄：{0}',
     dest_base: '🤖 目標根目錄：{0}',
     dest_root: '🤖 目標根目錄：{0}',
+    dest_empty_flatten: '📂 目標目錄為空，將 project/ 內容直接鋪入（不建立 project/ 子目錄）',
     force_mode: '⚠️  --force 模式：目標目錄將被清空後重新複製',
     no_package: '\n❌ 未找到 openyida 安裝套件目錄',
     no_package_hint1: '   請確認 openyida 已正確全域安裝：',

package/lib/core/locales/zh.js

@@ -531,6 +531,7 @@ openyida - 宜搭命令行工具
     package_root: '\n📦 包根目录: {0}',
     dest_base: '🤖 目标根目录: {0}',
     dest_root: '🤖 目标根目录: {0}',
+    dest_empty_flatten: '📂 目标目录为空，将 project/ 内容直接铺入（不创建 project/ 子目录）',
     force_mode: '⚠️  --force 模式：目标目录将被清空后重新复制',
     no_package: '\n❌ 未找到 openyida 安装包目录',
     no_package_hint1: '   请确认 openyida 已正确全局安装：',

package/lib/core/utils.js

@@ -87,7 +87,8 @@ function detectActiveTool() {
       tool: 'wukong',
       displayName: '悟空（Wukong）',
       dirName: '.real',
-      workspaceRoot: path.join(home, '.real', 'workspace', 'project'),
+      // 直接使用 AGENT_WORK_ROOT，悟空工作区路径是动态的（含 uuid），不能硬编码
+      workspaceRoot: path.join(env.AGENT_WORK_ROOT, 'project'),
     };
   }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openyida",
-  "version": "2026.04.02-beta.0",
+  "version": "2026.04.02-beta.12",
   "description": "OpenYida CLI - 宜搭低代码 AI 开发工具（安装即用，零配置）",
   "bin": {
     "openyida": "./bin/yida.js",

package/scripts/postinstall.js

@@ -132,47 +132,10 @@ safeExec(() => {
   }
 });
 
-// ── 2. Wukong integration ─────────────────────────────────────────────
+// ── 2. Wukong ────────────────────────────────────────────────────────
+// 悟空通过手动上传技能，无需 postinstall 安装。
 
-safeExec(() => {
-  if (fs.existsSync(path.join(HOME_DIR, '.real'))) {
-    installSkills(path.join(HOME_DIR, '.real'));
-  }
-});
-
-// ── 3. Chromium 按需安装 ─────────────────────────────────────────────
-
-safeExec(() => {
-  const { execSync } = require('child_process');
-
-  let chromiumPath = null;
-  try {
-    // 通过 playwright 内置 API 获取 Chromium 可执行文件路径
-    const { chromium } = require('playwright');
-    chromiumPath = chromium.executablePath();
-  } catch {
-    // playwright 未安装或 API 不可用，跳过
-    return;
-  }
-
-  if (chromiumPath && fs.existsSync(chromiumPath)) {
-    // Chromium 已存在，无需重复安装
-    return;
-  }
-
-  console.log('\n  🌐 正在安装 Chromium 浏览器（首次安装需要下载，请稍候）...');
-  try {
-    execSync('npx playwright install chromium', {
-      stdio: 'inherit',
-      timeout: 300_000, // 5 分钟超时
-    });
-    console.log('  ✅ Chromium 安装完成！\n');
-  } catch {
-    console.warn('  ⚠️  Chromium 安装失败，可手动执行：npx playwright install chromium\n');
-  }
-});
-
-// ── 4. 首次安装欢迎引导 ──────────────────────────────────────────────
+// ── 3. 首次安装欢迎引导 ──────────────────────────────────────────────
 
 safeExec(() => {
   const FIRST_INSTALL_FLAG = path.join(HOME_DIR, '.openyida', 'installed');

package/yida-skills/SKILL.md

@@ -4,7 +4,7 @@ description: >
   宜搭低代码平台 AI 开发入口。一句话生成完整应用：创建应用、表单设计、自定义页面、流程配置、数据管理。
   当用户提到"宜搭"、"yida"、"低代码"、"创建应用"、"创建表单"、"发布页面"、"搭建"、"系统"、"应用"时触发。
 metadata:
-  version: 2026.04.02-beta.0
+  version: 2026.04.02-beta.12
 ---
 
 # 宜搭 AI 应用开发指南

package/yida-skills/skills/yida-custom-page/SKILL.md

@@ -301,6 +301,43 @@ this.forceUpdate();
 
    > **生成代码时的自检清单**：检查 `renderJsx` 中所有 `onClick`、`onChange`、`onSubmit` 等事件属性，确保每一个都是 `(e) => { this.xxx(e) }` 形式，不存在任何 `onClick={this.xxx}` 的写法。
 
+   // ❌ 错误③：在 .map(function(){}) 普通函数回调中使用箭头函数事件处理器，this 已在 function 回调里丢失，箭头函数捕获的 this 是 undefined！
+   export function renderJsx() {
+     return (
+       <div>
+         {quickBtns.map(function(btn, idx) {
+           return (
+             <button
+               key={idx}
+               onClick={(e) => { this.goToForm(btn.form); }}  // ❌ this 是 undefined，运行时报错
+             >
+               {btn.label}
+             </button>
+           );
+         })}
+       </div>
+     );
+   }
+
+   // ✅ 正确：.map() 回调必须使用箭头函数，确保 this 正确捕获
+   export function renderJsx() {
+     return (
+       <div>
+         {quickBtns.map((btn, idx) => (
+           <button
+             key={idx}
+             onClick={(e) => { this.goToForm(btn.form); }}  // ✅ 箭头函数回调 + 箭头函数事件处理器，this 正确
+           >
+             {btn.label}
+           </button>
+         ))}
+       </div>
+     );
+   }
+   ```
+
+   > **补充自检项**：检查 `renderJsx` 中所有 `.map()`、`.filter()`、`.forEach()` 等数组方法的回调，确保全部使用**箭头函数**形式 `(item) => ...`，不存在任何 `.map(function(item) {...})` 的写法，否则回调内部的 `this` 会丢失。
+
 3. **输入法组合输入处理**：使用 `_isComposing` 标记配合 `compositionstart` / `compositionend` 事件，正确处理中文输入法的组合输入状态，避免输入过程中触发提交
 4. **定时器清理**：在 `didUnmount` 中必须清理所有通过 `setInterval` / `setTimeout` 创建的定时器，防止内存泄漏
 5. **错误处理**：所有 API 调用（`this.utils.yida.*`、`fetch`）必须使用 `.catch()` 处理异常，并通过 `this.utils.toast({ title: message, type: 'error' })` 向用户展示错误提示

package/yida-skills/skills/yida-login/SKILL.md

@@ -29,8 +29,6 @@ description: 宜搭登录态管理。扫码登录，Cookie 持久化到 .cache/c
 
 ## 命令
 
-### 标准环境
-
 ```bash
 openyida login
 ```