openyida 2026.4.2-beta.1 → 2026.4.2-beta.13

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,18 +426,23 @@ 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);
 
     return [{
       id: 'project-init',
-      label: passed ? 'project/ 工作目录已初始化' : `project/ 工作目录检测（检测路径：${projectDir}）`,
+      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

@@ -82,12 +82,13 @@ function detectActiveTool() {
 
   // 悟空（Wukong）
   // Windows 路径可能使用反斜杠，需同时兼容正斜杠和反斜杠
+  // AGENT_WORK_ROOT 指向 ~/.real/users/user-{uuid}/，workspace 在其下的 workspace/ 子目录
   if (env.AGENT_WORK_ROOT && (env.AGENT_WORK_ROOT.includes('.real') || env.AGENT_WORK_ROOT.includes(path.join('.real')))) {
     return {
       tool: 'wukong',
       displayName: '悟空（Wukong）',
       dirName: '.real',
-      workspaceRoot: path.join(home, '.real', 'workspace', 'project'),
+      workspaceRoot: path.join(env.AGENT_WORK_ROOT, 'workspace', 'project'),
     };
   }
 

package/package.json

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

package/project/pages/src/demo-birthday-game.js

@@ -233,7 +233,6 @@ export function requestMicrophone() {
     // 开始检测吹气
     self.startBlowDetection();
   }).catch(function(err) {
-    console.log('麦克风权限被拒绝:', err);
     _customState.micPermission = 'denied';
     // 即使麦克风失败，用户仍可以点击蜡烛
   });

package/scripts/postinstall.js

@@ -1,19 +1,20 @@
 #!/usr/bin/env node
 /**
- * postinstall hook: auto-configure IDE integration after `npm install -g openyida`
+ * postinstall hook: skills installation + welcome guide after `npm install -g openyida`
  *
- * Copies the yida-skills/ folder into each AI tool's config directory.
- * Each tool discovers the skill pack by scanning its own config directory.
+ * 职责：
+ *   1. 清理旧版本遗留的错误安装（~/.xxx/yida-skills/，缺少 skills/ 中间层级）
+ *   2. 将 yida-skills/ 安装到各 AI 工具的正确 skills 目录
+ *   3. 首次安装欢迎引导
  *
- * Supported tools: Claude Code / OpenCode / Aone Copilot / Cursor / Qoder / Wukong
+ * 正确的 skills 安装路径（所有工具统一使用 skills/ 子目录）：
+ *   ~/.claude/skills/yida-skills/          ← <package>/yida-skills (copy)
+ *   ~/.opencode/skills/yida-skills/        ← <package>/yida-skills (copy)
+ *   ~/.aone_copilot/skills/yida-skills/    ← <package>/yida-skills (copy)
+ *   ~/.cursor/skills/yida-skills/          ← <package>/yida-skills (copy)
+ *   ~/.qoder/skills/yida-skills/           ← <package>/yida-skills (copy)
  *
- * Symlink layout (no extra "skills/" subdirectory needed):
- *   ~/.claude/yida-skills          → <package>/yida-skills
- *   ~/.opencode/yida-skills        → <package>/yida-skills
- *   ~/.aone_copilot/yida-skills    → <package>/yida-skills
- *   ~/.cursor/yida-skills          → <package>/yida-skills
- *   ~/.qoder/yida-skills           → <package>/yida-skills
- *   ~/.real/yida-skills            → <package>/yida-skills  (Wukong)
+ * 悟空（Wukong）通过手动上传技能，不在此安装。
  */
 
 'use strict';
@@ -37,15 +38,6 @@ function safeExec(fn) {
   }
 }
 
-/**
- * Ensure a directory exists (mkdir -p).
- */
-function ensureDir(dirPath) {
-  if (!fs.existsSync(dirPath)) {
-    fs.mkdirSync(dirPath, { recursive: true });
-  }
-}
-
 /**
  * Recursively copy a directory, overwriting existing files.
  */
@@ -65,114 +57,86 @@ function copyDirRecursive(src, dest) {
 }
 
 /**
- * Install yida-skills by copying files into `ideConfigDir`.
- *
- * Uses file copy instead of symlink to ensure AI tools can always
- * discover skills on the first run (fixes #186).
- *
- * - If an old symlink exists → remove it first, then copy.
- * - If a real directory exists → remove and do a clean copy.
+ * 清理旧版遗留的错误路径（软链接或目录）。
  */
-function installSkills(ideConfigDir) {
-  const destPath = path.join(ideConfigDir, 'yida-skills');
-
-  ensureDir(ideConfigDir);
-
-  let existingStat = null;
+function cleanupLegacy(dirPath) {
   try {
-    existingStat = fs.lstatSync(destPath);
+    const stat = fs.lstatSync(dirPath);
+    if (stat.isSymbolicLink()) {
+      fs.unlinkSync(dirPath);
+    } else if (stat.isDirectory()) {
+      fs.rmSync(dirPath, { recursive: true, force: true });
+    }
   } catch {
-    /* does not exist, will create */
+    /* not exists, ok */
   }
+}
 
-  if (existingStat) {
-    if (existingStat.isSymbolicLink()) {
-      // Remove old symlink left by previous versions
-      fs.unlinkSync(destPath);
-    } else {
-      fs.rmSync(destPath, { recursive: true, force: true });
-    }
-  }
+/**
+ * 将 yida-skills 安装到 AI 工具的 skills 目录。
+ * 正确路径：~/<tool-config>/skills/yida-skills/
+ *
+ * 同时清理旧版遗留在根目录的错误安装：~/<tool-config>/yida-skills/
+ */
+function installSkillsToTool(toolConfigDir) {
+  // 清理旧版遗留在根目录的错误安装（缺少 skills/ 中间层级）
+  cleanupLegacy(path.join(toolConfigDir, 'yida-skills'));
+
+  // 安装到正确路径：~/<tool-config>/skills/yida-skills/
+  const skillsDir = path.join(toolConfigDir, 'skills');
+  const destPath = path.join(skillsDir, 'yida-skills');
 
+  fs.mkdirSync(skillsDir, { recursive: true });
+
+  // 如果已存在，先清理（旧软链接或旧目录）
+  cleanupLegacy(destPath);
+
+  // 复制文件（不用软链接，确保 AI 工具首次扫描就能发现）
   copyDirRecursive(SKILLS_DIR, destPath);
 }
 
-// ── 1. Skills installation (copy to each tool's config root) ─────────
+// ── 1. Skills 安装 ───────────────────────────────────────────────────
+// 安装到各 AI 工具的正确 skills 目录（悟空跳过，悟空通过手动上传技能）
 
-// Claude Code
+// Claude Code — 始终安装（Claude Code 是主要目标用户）
 safeExec(() => {
-  installSkills(path.join(HOME_DIR, '.claude'));
+  installSkillsToTool(path.join(HOME_DIR, '.claude'));
 });
 
-// OpenCode
+// OpenCode — 仅在已安装时安装
 safeExec(() => {
   if (fs.existsSync(path.join(HOME_DIR, '.opencode'))) {
-    installSkills(path.join(HOME_DIR, '.opencode'));
+    installSkillsToTool(path.join(HOME_DIR, '.opencode'));
   }
 });
 
-// Aone Copilot
+// Aone Copilot — 仅在已安装时安装
 safeExec(() => {
   if (fs.existsSync(path.join(HOME_DIR, '.aone_copilot'))) {
-    installSkills(path.join(HOME_DIR, '.aone_copilot'));
+    installSkillsToTool(path.join(HOME_DIR, '.aone_copilot'));
   }
 });
 
-// Cursor
+// Cursor — 仅在已安装时安装
 safeExec(() => {
   if (fs.existsSync(path.join(HOME_DIR, '.cursor'))) {
-    installSkills(path.join(HOME_DIR, '.cursor'));
+    installSkillsToTool(path.join(HOME_DIR, '.cursor'));
   }
 });
 
-// Qoder
+// Qoder — 仅在已安装时安装
 safeExec(() => {
   if (fs.existsSync(path.join(HOME_DIR, '.qoder'))) {
-    installSkills(path.join(HOME_DIR, '.qoder'));
+    installSkillsToTool(path.join(HOME_DIR, '.qoder'));
   }
 });
 
-// ── 2. Wukong integration ─────────────────────────────────────────────
-
+// 悟空（Wukong）— 跳过安装，只清理旧版遗留
 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');
-  }
+  cleanupLegacy(path.join(HOME_DIR, '.real', 'yida-skills'));
 });
 
-// ── 4. 首次安装欢迎引导 ──────────────────────────────────────────────
+// ── 2. 首次安装欢迎引导 ──────────────────────────────────────────────
 
 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.1
+  version: 2026.04.02-beta.13
 ---
 
 # 宜搭 AI 应用开发指南
@@ -30,10 +30,10 @@ metadata:
 ## ⚡ 首要步骤（每次必须先执行）
 
 ```bash
-# 1. 确保 openyida 已安装（未安装则自动安装）
+# 1. 确保 openyida 已安装（未安装则自动安装，已安装则跳过）
 openyida -v 2>/dev/null || npm install -g openyida@latest
 
-# 2. 一键诊断并自动修复：版本升级 + 环境检测 + project 目录初始化
+# 2. 一键诊断并自动修复：环境检测 + project 目录初始化
 openyida doctor --fix
 ```
 

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
 ```