openyida 2026.4.2-beta.9 → 2026.4.2

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/core/copy.js

@@ -1,11 +1,11 @@
 /**
- * copy.js - 复制 project 工作目录模板 / 创建 yida-skills 软链接到当前 AI 工具环境
+ * copy.js - 复制 project 工作目录模板 / 复制 yida-skills 到当前 AI 工具环境
  *
  * 用法：
  *   openyida copy                → 复制 project/ 目录模板（默认，合并模式）
  *   openyida copy --force        → 复制 project/ 目录模板（强制覆盖，先清空目标目录）
- *   openyida copy -skills        → 创建 yida-skills/ 软链接（如果存在实际目录则先删除）
- *                                  悟空环境下：删除已有软链（悟空通过手动上传技能，不需要软链）
+ *   openyida copy -skills        → 复制 yida-skills/ 到当前 AI 工具的 skills 目录
+ *                                  悟空环境下：删除已有 yida-skills/（悟空通过手动上传技能）
  *   openyida copy -project       → 复制 project/ 目录模板（与默认行为相同，显式指定）
  *   openyida copy -project --force → 复制 project/ 目录模板（强制覆盖）
  *
@@ -17,12 +17,8 @@
  *
  * project/ 合并模式（默认）：已存在的文件强制覆盖，目标目录中多余的文件保留不动
  * project/ 强制模式（--force）：先清空目标目录，再完整复制
- * yida-skills/（非悟空）：始终创建软链接，如目标存在实际目录则先删除
- * yida-skills/（悟空）：删除已有软链或目录（悟空通过手动上传技能，不需要软链）
- *
- * Windows 兼容说明：
- *   - 软链接在 Windows 上需要管理员权限或开发者模式，失败时自动降级为目录复制
- *   - 路径分隔符统一使用 path.join 处理
+ * yida-skills/（非悟空）：复制到 <cwd>/yida-skills/，如目标已存在则先清理
+ * yida-skills/（悟空）：删除已有软链或目录（悟空通过手动上传技能，不需要复制）
  */
 
 'use strict';
@@ -194,7 +190,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,19 +270,30 @@ 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) {
-    const destSkillsLink = path.join(destBase, 'yida-skills');
     if (isWukong) {
-      // 悟空环境：删除已有软链，不创建新软链
+      // 悟空环境：删除已有软链或目录，不安装（悟空手动上传技能）
+      const destSkillsLink = path.join(destBase, 'yida-skills');
       console.log(t('copy.wukong_skills_cleanup'));
       const removed = removeSkillsLink(destSkillsLink);
       results.push({
@@ -296,15 +303,44 @@ function run() {
         type: 'wukong-cleanup'
       });
     } else {
-      // 其他环境：创建软链接
-      console.log(t('copy.creating_symlink'));
-      const success = createSymlink(packageYidaSkillsDir, destSkillsLink);
-      results.push({
-        label: 'yida-skills/',
-        dest: destSkillsLink,
-        count: success ? 1 : 0,
-        type: 'symlink'
-      });
+      // 其他环境：复制到 AI 工具配置目录的 skills/yida-skills/
+      // 目标路径：~/<tool-config>/skills/yida-skills/（与 postinstall 保持一致）
+      const activeResult = envResults.find((r) => r.isActive);
+      const toolConfigDir = activeResult
+        ? path.join(os.homedir(), activeResult.dirName)
+        : null;
+
+      if (toolConfigDir) {
+        const skillsDir = path.join(toolConfigDir, 'skills');
+        const destSkillsDest = path.join(skillsDir, 'yida-skills');
+
+        // 清理旧版遗留在根目录的错误安装
+        removeSkillsLink(path.join(toolConfigDir, 'yida-skills'));
+
+        // 清理已有的 skills/yida-skills/（旧软链或旧目录）
+        removeSkillsLink(destSkillsDest);
+
+        // 复制文件
+        fs.mkdirSync(skillsDir, { recursive: true });
+        const count = mergeCopyDir(packageYidaSkillsDir, destSkillsDest);
+        results.push({
+          label: 'yida-skills/',
+          dest: destSkillsDest,
+          count,
+          type: 'copy'
+        });
+      } else {
+        // 未检测到 AI 工具，复制到当前目录下
+        const destSkillsDest = path.join(destBase, 'yida-skills');
+        removeSkillsLink(destSkillsDest);
+        const count = mergeCopyDir(packageYidaSkillsDir, destSkillsDest);
+        results.push({
+          label: 'yida-skills/',
+          dest: destSkillsDest,
+          count,
+          type: 'copy'
+        });
+      }
     }
   }
 

package/lib/core/doctor.js

@@ -718,7 +718,7 @@ class FixEngine {
       case 'init-project': {
         try {
           const copy = require('./copy');
-          await copy([]);
+          await copy.run([]);
           return {
             id: issue.id,
             fixed: true,

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.9",
+  "version": "2026.04.02",
   "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,82 +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'));
-  }
+  cleanupLegacy(path.join(HOME_DIR, '.real', 'yida-skills'));
 });
 
-// ── 3. 首次安装欢迎引导 ──────────────────────────────────────────────
+// ── 2. 首次安装欢迎引导 ──────────────────────────────────────────────
 
 safeExec(() => {
   const FIRST_INSTALL_FLAG = path.join(HOME_DIR, '.openyida', 'installed');

package/yida-skills/SKILL.md

@@ -1,10 +1,8 @@
 ---
 name: yida-skills
-description: >
-  宜搭低代码平台 AI 开发入口。一句话生成完整应用：创建应用、表单设计、自定义页面、流程配置、数据管理。
-  当用户提到"宜搭"、"yida"、"低代码"、"创建应用"、"创建表单"、"发布页面"、"搭建"、"系统"、"应用"时触发。
+description: "宜搭低代码平台 AI 开发入口。一句话生成完整应用：创建应用、表单设计、自定义页面、流程配置、数据管理。当用户提到「宜搭」「yida」「低代码」「创建应用」「创建表单」「发布页面」「搭建」「系统」「应用」时触发。"
 metadata:
-  version: 2026.04.02-beta.9
+  version: 2026.04.02
 ---
 
 # 宜搭 AI 应用开发指南
@@ -30,10 +28,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-chart/SKILL.md

@@ -1,7 +1,6 @@
 ---
 name: yida-chart
-description: >-
-  宜搭 ECharts 高级报表技能。通过 ECharts + 自定义页面 JSX 实现高度定制化、更美观的数据可视化报表。本技能不负责创建宜搭原生报表（标准报表由 yida-report 技能负责），但 ECharts 报表必须依赖宜搭原生报表的 getDataAsync.json 或 getCacheData.json 接口获取聚合数据，禁止前端聚合（当前仅支持单表数据源，暂不支持多表关联）。数据源获取方式：若用户已有原生报表，直接读取其信息作为数据源；若用户没有原生报表，则先调用 yida-report 技能创建原生报表作为数据源。当用户提供了已有报表 URL（如 https://www.aliwork.com/APP_XXX/admin/REPORT-XXX）时，解析现有报表 Schema 提取数据源参数，基于该数据源创建 ECharts 自定义页面（输出始终是 ECharts 自定义页面，而非优化后的原生报表）。当用户提到"更美观"、"高级"、"定制化"、"ECharts"、"echarts"、"Dashboard 大屏"、"数据大屏"等关键词，或用户提供了报表 URL 要求优化时，使用此技能。普通的"报表"、"统计"等需求默认由 yida-report 技能处理。
+description: "宜搭 ECharts 高级报表技能。通过 ECharts + 自定义页面 JSX 实现高度定制化、更美观的数据可视化报表。本技能不负责创建宜搭原生报表（标准报表由 yida-report 技能负责），但 ECharts 报表必须依赖宜搭原生报表的 getDataAsync.json 或 getCacheData.json 接口获取聚合数据，禁止前端聚合。当用户提到「更美观」「高级」「定制化」「ECharts」「echarts」「Dashboard 大屏」「数据大屏」等关键词，或用户提供了报表 URL 要求优化时，使用此技能。普通的「报表」「统计」等需求默认由 yida-report 技能处理。"
 ---
 
 # 宜搭 ECharts 高级报表技能

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-flash-note-to-prd/SKILL.md

@@ -1,10 +1,6 @@
 ---
 name: yida-flash-note-to-prd
-description: >
-  钉钉闪记转高质量 Prompt 技能。将钉钉闪记（会议录音转文字的会议纪要、AI 听记图文纪要）自动识别并转化为
-  高质量的结构化 prompt，输出到 prd/ 目录，可直接驱动后续宜搭应用开发流程。
-  支持文本、图片、闪记链接等多种输入方式。
-  当用户发送闪记内容（文本或图片）、提到"闪记"、"会议纪要"、"会议记录"等关键词时，自动触发此技能。
+description: "钉钉闪记转高质量 Prompt 技能。将钉钉闪记（会议录音转文字的会议纪要、AI 听记图文纪要）自动识别并转化为高质量的结构化 prompt，输出到 prd/ 目录，可直接驱动后续宜搭应用开发流程。支持文本、图片、闪记链接等多种输入方式。当用户发送闪记内容（文本或图片）、提到「闪记」「会议纪要」「会议记录」等关键词时，自动触发此技能。"
 ---
 
 # 钉钉闪记转高质量 Prompt 技能

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

@@ -1,8 +1,6 @@
 ---
 name: yida-formula
-description: >
-  宜搭公式编写规范。提供公式语法规则、字段引用方式、函数分类速查和常见场景示例。
-  当用户需要了解宜搭公式怎么写、有哪些函数可用、如何在字段中配置公式时，使用此技能。
+description: "宜搭公式编写规范。提供公式语法规则、字段引用方式、函数分类速查和常见场景示例。当用户需要了解宜搭公式怎么写、有哪些函数可用、如何在字段中配置公式时，使用此技能。"
 ---
 
 # 宜搭公式编写规范

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

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

package/yida-skills/skills/yida-ppt-slider/SKILL.md

@@ -1,9 +1,6 @@
 ---
 name: yida-ppt-slider
-description: >
-  宜搭自定义页面 PPT 幻灯片开发指南。用于在宜搭平台上创建全屏演示文稿式的幻灯片页面，
-  支持键盘翻页、移动端适配、演讲笔控制等功能。
-  适用于技术分享、产品路演、培训课件等场景。
+description: "宜搭自定义页面 PPT 幻灯片开发指南。用于在宜搭平台上创建全屏演示文稿式的幻灯片页面，支持键盘翻页、移动端适配、演讲笔控制等功能。适用于技术分享、产品路演、培训课件等场景。"
 ---
 
 # 宜搭 PPT 幻灯片开发指南

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

@@ -1,9 +1,6 @@
 ---
 name: yida-report
-description: >
-  宜搭原生报表技能，用于创建宜搭平台内置的原生报表页面（vc-yida-report 组件库），支持 16 种开箱即用的图表/表格/筛选器组件，通过 openyida create-report 命令生成报表 Schema 并发布。
-  本技能定位：创建宜搭原生报表（作为数据源），普通的「报表」「统计」需求默认使用本技能。
-  如需更美观的 ECharts 自定义可视化大屏，请使用 yida-chart 技能（依赖本技能创建的原生报表作为数据源）。
+description: "宜搭原生报表技能，用于创建宜搭平台内置的原生报表页面（vc-yida-report 组件库），支持 16 种开箱即用的图表/表格/筛选器组件，通过 openyida create-report 命令生成报表 Schema 并发布。本技能定位：创建宜搭原生报表（作为数据源），普通的「报表」「统计」需求默认使用本技能。如需更美观的 ECharts 自定义可视化大屏，请使用 yida-chart 技能（依赖本技能创建的原生报表作为数据源）。"
 ---
 
 # 宜搭原生报表 + ECharts 自定义看板 技能文档