openyida 2026.3.28-2 → 2026.4.2-beta.0

package/README.md

@@ -8,7 +8,7 @@
 
 **Build Yida low-code apps with AI — zero config, instant deploy.**
 
-[Get Started](#get-started) · [CLI Commands](#cli-commands) · [Demo](#demo) · [Contributing](./CONTRIBUTING.md) · [Changelog](./CHANGELOG.md)
+[Get Started](#get-started) · [CLI Commands](#cli-commands) · [Demo](https://www.aliwork.com/o/OpenYidaAppShowcase) · [Contributing](./CONTRIBUTING.md) · [Changelog](./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)

package/bin/yida.js

@@ -16,7 +16,7 @@
  *   openyida auth logout                                退出登录
  *   openyida org list                                   列出可访问的组织
  *   openyida org switch --corp-id <corpId>              切换组织（无需重新登录）
- *   openyida create-app "<名称>" [desc] [icon] [color] [themeColor]  创建应用
+ *   openyida create-app "<名称>" [desc] [icon] [color] [colour] [navTheme] [layout]  创建应用
  *   openyida create-page <appType> "<页面名>"            创建自定义页面
  *   openyida create-form create <appType> "<表单名>" <字段JSON> [--layout <布局>] [--theme <主题>] [--label-align <对齐>]  创建表单页面
  *   openyida create-form update <appType> <formUuid> <修改JSON>  更新表单页面
@@ -76,7 +76,7 @@ openyida - 宜搭命令行工具
   copy [--force]                                               复制 project 工作目录到当前 AI 工具环境
   login                                                        登录态管理（优先缓存，否则扫码）
   logout                                                       退出登录 / 切换账号
-  create-app "<名称>" [描述] [图标] [颜色] [主题色]             创建应用，输出 appType
+  create-app "<名称>" [描述] [图标] [颜色] [主题色] [导航风格] [布局]   创建应用，输出 appType
   create-page <appType> "<页面名>"                             创建自定义页面，输出 pageId
   create-form create <appType> "<表单名>" <字段JSON> [--layout <布局>] [--theme <主题>] [--label-align <对齐>]  创建表单页面
   create-form update <appType> <formUuid> <修改JSON>           更新表单页面
@@ -132,7 +132,8 @@ openyida - 宜搭命令行工具
   openyida login
   openyida logout
   openyida create-app "考勤管理"
-  openyida create-app "考勤管理" "员工考勤系统" "xian-daka" "#00B853" "red"
+  openyida create-app "考勤管理" "员工考勤系统" "xian-daka" "#00B853" "deepBlue" "dark" "slide"
+  openyida create-app "党建管理" "党员管理系统" "xian-zhengfu" "#FF4D4F" "red" "light" "ver"
   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":"备注"}}]'

package/lib/app/create-app.js

@@ -1,7 +1,7 @@
 /**
  * create-app.js - 宜搭应用创建命令
  *
- * 用法：yidacli create-app "<appName>" [description] [icon] [iconColor]
+ * 用法：yidacli create-app "<appName>" [description] [icon] [iconColor] [colour] [navTheme] [layoutDirection]
  */
 
 'use strict';
@@ -93,7 +93,9 @@ async function run(args) {
   const description = args[1] || appName;
   const icon = args[2] || 'xian-yingyong';
   const iconColor = args[3] || '#0089FF';
-  const themeColor = args[4] || 'blue';
+  const colour = args[4] || 'deepBlue';
+  const navTheme = args[5] || 'dark';
+  const layoutDirection = args[6] || 'slide';
 
   const SEP = '='.repeat(50);
   console.error(SEP);
@@ -102,7 +104,7 @@ async function run(args) {
   console.error(t('create_app.app_name', appName));
   console.error(t('create_app.app_desc', description));
   console.error(t('create_app.app_icon', icon, iconColor));
-  console.error(t('create_app.app_theme', themeColor));
+  console.error(t('create_app.app_theme', colour, navTheme, layoutDirection));
 
   // Step 1: 读取登录态
   console.error(t('common.step_login', 1));
@@ -150,7 +152,9 @@ async function run(args) {
       description: JSON.stringify({ zh_CN: description, en_US: description, type: 'i18n' }),
       icon: iconValue,
       iconUrl: iconValue,
-      colour: themeColor,
+      colour,
+      navTheme,
+      layoutDirection,
       defaultLanguage: 'zh_CN',
       openExclusive: openExclusive,
       openPhysicColumn: openPhysicColumn,

package/lib/app/create-form.js

@@ -1337,6 +1337,7 @@ function buildFormSchema(formTitle, fields, formUuid, corpId, appType, layout, t
           compiled: constructorCode,
           source: constructorCode,
         },
+        componentDidMount: { name: 'didMount', id: 'didMount', params: {}, type: 'actionRef' },
       },
       hidden: false,
       title: '',

package/lib/app/get-schema.js

@@ -35,11 +35,6 @@ function extractFieldSummary(schemaResult) {
     return fields;
   }
 
-  const tree = pages[0].componentsTree && pages[0].componentsTree[0];
-  if (!tree) {
-    return fields;
-  }
-
   const FIELD_COMPONENT_NAMES = new Set([
     'TextField', 'TextareaField', 'SelectField', 'DateField', 'NumberField',
     'RadioField', 'CheckboxField', 'EmployeeField', 'PhoneField', 'EmailField',
@@ -69,7 +64,14 @@ function extractFieldSummary(schemaResult) {
     }
   }
 
-  traverse(tree);
+  // 遍历所有页面，避免多页面表单遗漏字段
+  for (const page of pages) {
+    const tree = page.componentsTree && page.componentsTree[0];
+    if (tree) {
+      traverse(tree);
+    }
+  }
+
   return fields;
 }
 

package/lib/app/publish.js

@@ -205,10 +205,15 @@ function compileSource(sourcePath) {
 
 // ── ID 生成工具 ──────────────────────────────────────
 
-let nodeIdCounter = 1;
-
-function nextNodeId() {
-  return 'node_oc' + Date.now().toString(36) + (nodeIdCounter++).toString(36);
+/**
+ * 创建一个独立的 nodeId 生成器，每次调用 buildSchemaContent 时应创建新实例，
+ * 避免模块级全局计数器在多次调用时累加导致 ID 不可预期。
+ */
+function createNodeIdGenerator() {
+  let counter = 1;
+  return function nextNodeId() {
+    return 'node_oc' + Date.now().toString(36) + (counter++).toString(36);
+  };
 }
 
 function generateSuffix() {
@@ -219,6 +224,7 @@ function generateSuffix() {
 
 function buildSchemaContent(sourceCode, compiledCode, formUuid) {
   console.error(t('publish.building_schema'));
+  const nextNodeId = createNodeIdGenerator();
 
   // 构造函数代码（固定模板）
   const constructorCode = "function constructor() {\nvar module = { exports: {} };\nvar _this = this;\nthis.__initMethods__(module.exports, module);\nObject.keys(module.exports).forEach(function(item) {\n  if(typeof module.exports[item] === 'function'){\n    _this[item] = module.exports[item];\n  }\n});\n\n}";

package/lib/core/check-update.js

@@ -37,10 +37,13 @@ function fetchLatestVersion() {
 
 /**
  * 比较版本号，返回 latestVersion 是否比 currentVersion 更新。
- * 仅支持 semver 格式（major.minor.patch）。
+ * 支持 semver 格式（major.minor.patch），pre-release 标签（如 -beta.1）会被忽略，
+ * 仅比较数字部分。
  */
 function isNewer(currentVersion, latestVersion) {
-  const parseParts = (v) => (v || '').split('.').map((n) => parseInt(n, 10) || 0);
+  // 截取 '-' 前的纯数字版本部分，兼容 pre-release 格式（如 1.2.3-beta.1）
+  const parseStableVersion = (v) => (v || '').split('-')[0];
+  const parseParts = (v) => parseStableVersion(v).split('.').map((n) => parseInt(n, 10) || 0);
   const [cMajor, cMinor, cPatch] = parseParts(currentVersion);
   const [lMajor, lMinor, lPatch] = parseParts(latestVersion);
 

package/lib/core/doctor.js

@@ -148,10 +148,7 @@ class EnvironmentChecker {
       this.checkNodeVersion(),
       this.checkNpmVersion(),
       this.checkPlaywrightInstalled(),
-      this.checkGhCli(),
-      this.checkGhAuth(),
       this.checkConfig(),
-      this.checkSkills(),
       this.checkLoginStatus(),
       await this.checkNetwork(),
     ];
@@ -220,51 +217,6 @@ class EnvironmentChecker {
     }
   }
 
-  checkGhCli() {
-    try {
-      const ghVersion = execSync('gh --version 2>&1', { encoding: 'utf-8' }).split('\n')[0].trim();
-      return {
-        id: 'env-gh',
-        label: ghVersion,
-        passed: true,
-        severity: Severity.INFO,
-        fixType: null,
-      };
-    } catch {
-      return {
-        id: 'env-gh',
-        label: 'gh CLI 安装检测',
-        passed: false,
-        severity: Severity.ERROR,
-        message: 'gh CLI 未安装，请安装：https://cli.github.com/',
-        fixType: null,
-      };
-    }
-  }
-
-  checkGhAuth() {
-    try {
-      execSync('gh auth status 2>&1', { encoding: 'utf-8', stdio: 'pipe' });
-      return {
-        id: 'env-gh-auth',
-        label: 'gh CLI 已登录',
-        passed: true,
-        severity: Severity.INFO,
-        fixType: null,
-      };
-    } catch {
-      return {
-        id: 'env-gh-auth',
-        label: 'gh CLI 登录状态',
-        passed: false,
-        severity: Severity.WARNING,
-        message: 'gh CLI 未登录',
-        fixType: FixType.COMMAND,
-        fixCommand: 'gh auth login',
-      };
-    }
-  }
-
   checkConfig() {
     const configPath = path.join(this.projectRoot, 'config.json');
     if (!fs.existsSync(configPath)) {
@@ -301,30 +253,6 @@ class EnvironmentChecker {
     }
   }
 
-  checkSkills() {
-    const skillsPath = path.join(this.projectRoot, '.claude', 'skills', 'skills');
-    if (fs.existsSync(skillsPath)) {
-      const skills = fs.readdirSync(skillsPath).filter((name) =>
-        fs.statSync(path.join(skillsPath, name)).isDirectory()
-      );
-      return {
-        id: 'env-skills',
-        label: `Skills 已安装（${skills.length} 个）`,
-        passed: true,
-        severity: Severity.INFO,
-        fixType: null,
-      };
-    }
-    return {
-      id: 'env-skills',
-      label: 'Skills 安装检测',
-      passed: false,
-      severity: Severity.WARNING,
-      message: 'Skills 未安装，运行 bash install-skills.sh 安装',
-      fixType: FixType.MANUAL,
-    };
-  }
-
   checkLoginStatus() {
     const cookiePath = path.join(this.projectRoot, '.cache', 'cookies.json');
     if (!fs.existsSync(cookiePath)) {
@@ -399,6 +327,121 @@ class EnvironmentChecker {
   }
 }
 
+// ── VersionChecker ───────────────────────────────────
+
+/**
+ * openyida 版本检查器。
+ * 检测当前安装版本是否与 SKILL.md 中的 metadata.version 一致，
+ * 不一致时在 --fix 模式下自动升级到最新版。
+ */
+class VersionChecker {
+  constructor({ projectRoot } = {}) {
+    this.projectRoot = projectRoot || findProjectRoot();
+  }
+
+  /**
+   * 读取 SKILL.md 中 metadata.version 字段。
+   * @returns {string|null}
+   */
+  readSkillVersion() {
+    const skillPaths = [
+      path.join(this.projectRoot, 'yida-skills', 'SKILL.md'),
+      path.join(require('os').homedir(), '.claude', 'yida-skills', 'SKILL.md'),
+      path.join(require('os').homedir(), '.aone_copilot', 'yida-skills', 'SKILL.md'),
+    ];
+    for (const skillPath of skillPaths) {
+      if (!fs.existsSync(skillPath)) {continue;}
+      const content = fs.readFileSync(skillPath, 'utf-8');
+      const match = content.match(/^metadata:\s*\n\s*version:\s*(.+)$/m);
+      if (match) {return match[1].trim();}
+    }
+    return null;
+  }
+
+  /**
+   * 获取当前安装的 openyida 版本。
+   * @returns {string|null}
+   */
+  getInstalledVersion() {
+    try {
+      return execSync('openyida -v 2>/dev/null', { encoding: 'utf-8' }).trim();
+    } catch {
+      return null;
+    }
+  }
+
+  async check() {
+    const skillVersion = this.readSkillVersion();
+    const installedVersion = this.getInstalledVersion();
+
+    if (!skillVersion) {
+      return [{
+        id: 'version-skill',
+        label: 'openyida 版本检测',
+        passed: true,
+        severity: Severity.INFO,
+        message: '无法读取 SKILL.md 版本，跳过版本比对',
+        fixType: null,
+      }];
+    }
+
+    if (!installedVersion) {
+      return [{
+        id: 'version-installed',
+        label: 'openyida 版本检测',
+        passed: false,
+        severity: Severity.ERROR,
+        message: 'openyida 未安装，请运行：npm install -g openyida',
+        fixType: FixType.COMMAND,
+        fixCommand: 'npm install -g openyida@latest',
+      }];
+    }
+
+    // 比较主版本号（忽略 -beta.x 等预发布后缀）
+    const installedMain = installedVersion.replace(/-.+$/, '');
+    const skillMain = skillVersion.replace(/-.+$/, '');
+    const passed = installedMain === skillMain;
+
+    return [{
+      id: 'version-match',
+      label: `openyida 版本：${installedVersion}（SKILL 期望：${skillVersion}）`,
+      passed,
+      severity: passed ? Severity.INFO : Severity.WARNING,
+      message: passed ? null : `版本不匹配，建议升级到最新版`,
+      fixType: passed ? null : FixType.COMMAND,
+      fixCommand: passed ? null : 'npm install -g openyida@latest',
+    }];
+  }
+}
+
+// ── ProjectInitChecker ────────────────────────────────
+
+/**
+ * project 工作目录初始化检查器。
+ * 检测 project/ 目录是否存在，不存在时在 --fix 模式下自动执行 openyida copy。
+ */
+class ProjectInitChecker {
+  constructor({ projectRoot } = {}) {
+    this.projectRoot = projectRoot || findProjectRoot();
+  }
+
+  async check() {
+    const projectDir = 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/ 工作目录检测',
+      passed,
+      severity: passed ? Severity.INFO : Severity.WARNING,
+      message: passed ? null : 'project/ 目录未初始化，将自动执行 openyida copy',
+      fixType: passed ? null : FixType.COMMAND,
+      fixCommand: passed ? null : 'openyida copy',
+    }];
+  }
+}
+
 // ── ApplicationChecker ────────────────────────────────
 
 /**
@@ -1410,6 +1453,8 @@ async function run(args) {
 
   // ── 主诊断流程 ──
   const engine = new DiagnosticEngine({ projectRoot });
+  engine.registerChecker(new VersionChecker({ projectRoot }));
+  engine.registerChecker(new ProjectInitChecker({ projectRoot }));
   engine.registerChecker(new EnvironmentChecker({ projectRoot }));
   engine.registerChecker(new ApplicationChecker({ projectRoot, appId: options.app }));
 
@@ -1451,6 +1496,8 @@ async function run(args) {
 
 module.exports = {
   DiagnosticEngine,
+  VersionChecker,
+  ProjectInitChecker,
   EnvironmentChecker,
   ApplicationChecker,
   FixEngine,

package/lib/core/locales/ar.js

@@ -42,6 +42,9 @@ module.exports = {
     example: 'مثال: openyida create-app "تطبيقي"',
     title: '  create-app - أداة إنشاء تطبيق Yida',
     app_name: '\n  اسم التطبيق: {0}',
+    app_desc: '  الوصف:      {0}',
+    app_icon: '  الأيقونة:   {0} ({1})',
+    app_theme: '  السمة:      colour={0} navTheme={1} layout={2}',
     step_create: '\n🚀 جارٍ إنشاء التطبيق...',
     sending_request: '  جارٍ إرسال طلب createApp...',
     success: '  ✅ تم إنشاء التطبيق بنجاح!',

package/lib/core/locales/de.js

@@ -42,6 +42,9 @@ module.exports = {
     example: 'Beispiel: openyida create-app "Meine App"',
     title: '  create-app - Yida-App-Erstellungstool',
     app_name: '\n  App-Name: {0}',
+    app_desc: '  Beschreibung: {0}',
+    app_icon: '  Symbol:       {0} ({1})',
+    app_theme: '  Thema:        colour={0} navTheme={1} layout={2}',
     step_create: '\n🚀 App wird erstellt...',
     sending_request: '  createApp-Anfrage wird gesendet...',
     success: '  ✅ App erfolgreich erstellt!',

package/lib/core/locales/en.js

@@ -230,7 +230,7 @@ Examples:
     app_name: '  App name:    {0}',
     app_desc: '  Description: {0}',
     app_icon: '  Icon:        {0} ({1})',
-    app_theme: '  Theme:       {0}',
+    app_theme: '  Theme:       colour={0} navTheme={1} layout={2}',
     step_create: '\n📦 Step 2: Create App\n',
     success: '  ✅ App created successfully!',
     app_type_label: '  appType: {0}',

package/lib/core/locales/es.js

@@ -42,6 +42,9 @@ module.exports = {
     example: 'Ejemplo: openyida create-app "Mi App"',
     title: '  create-app - Herramienta de creación de aplicaciones Yida',
     app_name: '\n  Nombre de la app: {0}',
+    app_desc: '  Descripción:       {0}',
+    app_icon: '  Icono:             {0} ({1})',
+    app_theme: '  Tema:              colour={0} navTheme={1} layout={2}',
     step_create: '\n🚀 Creando la aplicación...',
     sending_request: '  Enviando solicitud createApp...',
     success: '  ✅ ¡Aplicación creada exitosamente!',

package/lib/core/locales/fr.js

@@ -42,6 +42,9 @@ module.exports = {
     example: 'Exemple : openyida create-app "Mon App"',
     title: "  create-app - Outil de création d'application Yida",
     app_name: "\n  Nom de l'app : {0}",
+    app_desc: '  Description : {0}',
+    app_icon: '  Icône :       {0} ({1})',
+    app_theme: '  Thème :       colour={0} navTheme={1} layout={2}',
     step_create: "\n🚀 Création de l'application...",
     sending_request: '  Envoi de la requête createApp...',
     success: '  ✅ Application créée avec succès !',

package/lib/core/locales/hi.js

@@ -42,6 +42,9 @@ module.exports = {
     example: 'उदाहरण: openyida create-app "मेरा ऐप"',
     title: '  create-app - Yida ऐप निर्माण टूल',
     app_name: '\n  ऐप नाम: {0}',
+    app_desc: '  विवरण:  {0}',
+    app_icon: '  आइकॉन:   {0} ({1})',
+    app_theme: '  थीम:     colour={0} navTheme={1} layout={2}',
     step_create: '\n🚀 ऐप बनाया जा रहा है...',
     sending_request: '  createApp अनुरोध भेजा जा रहा है...',
     success: '  ✅ ऐप सफलतापूर्वक बनाया गया!',

package/lib/core/locales/ja.js

@@ -215,7 +215,7 @@ openyida - Yida CLI ツール
     app_name: '  アプリ名:   {0}',
     app_desc: '  説明:       {0}',
     app_icon: '  アイコン:   {0} ({1})',
-    app_theme: '  テーマカラー: {0}',
+    app_theme: '  テーマ:     colour={0} navTheme={1} layout={2}',
     step_create: '\n📦 Step 2: アプリを作成\n',
     success: '  ✅ アプリが正常に作成されました！',
     app_type_label: '  appType: {0}',

package/lib/core/locales/ko.js

@@ -42,6 +42,9 @@ module.exports = {
     example: '예시: openyida create-app "내 앱"',
     title: '  create-app - Yida 앱 생성 도구',
     app_name: '\n  앱 이름: {0}',
+    app_desc: '  설명:     {0}',
+    app_icon: '  아이콘:   {0} ({1})',
+    app_theme: '  테마:     colour={0} navTheme={1} layout={2}',
     step_create: '\n🚀 앱 생성 중...',
     sending_request: '  createApp 요청 전송 중...',
     success: '  ✅ 앱 생성 성공!',

package/lib/core/locales/pt.js

@@ -42,6 +42,9 @@ module.exports = {
     example: 'Exemplo: openyida create-app "Meu App"',
     title: '  create-app - Ferramenta de criação de aplicativos Yida',
     app_name: '\n  Nome do app: {0}',
+    app_desc: '  Descrição:   {0}',
+    app_icon: '  Ícone:        {0} ({1})',
+    app_theme: '  Tema:         colour={0} navTheme={1} layout={2}',
     step_create: '\n🚀 Criando o aplicativo...',
     sending_request: '  Enviando requisição createApp...',
     success: '  ✅ Aplicativo criado com sucesso!',

package/lib/core/locales/vi.js

@@ -42,6 +42,9 @@ module.exports = {
     example: 'Ví dụ: openyida create-app "Ứng dụng của tôi"',
     title: '  create-app - Công cụ tạo ứng dụng Yida',
     app_name: '\n  Tên ứng dụng: {0}',
+    app_desc: '  Mô tả:         {0}',
+    app_icon: '  Biểu tượng:    {0} ({1})',
+    app_theme: '  Chủ đề:        colour={0} navTheme={1} layout={2}',
     step_create: '\n🚀 Đang tạo ứng dụng...',
     sending_request: '  Đang gửi yêu cầu createApp...',
     success: '  ✅ Tạo ứng dụng thành công!',

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

@@ -222,7 +222,7 @@ openyida - 宜搭命令列工具
     app_name: '  應用名稱：{0}',
     app_desc: '  應用描述：{0}',
     app_icon: '  圖示：     {0} ({1})',
-    app_theme: '  主題色：   {0}',
+    app_theme: '  主題：     colour={0} navTheme={1} layout={2}',
     step_create: '\n📦 Step 2：建立應用\n',
     success: '  ✅ 應用建立成功！',
     app_type_label: '  appType：{0}',

package/lib/core/locales/zh.js

@@ -222,7 +222,7 @@ openyida - 宜搭命令行工具
     app_name: '  应用名称: {0}',
     app_desc: '  应用描述: {0}',
     app_icon: '  图标:     {0} ({1})',
-    app_theme: '  主题色:   {0}',
+    app_theme: '  主题:     colour={0} navTheme={1} layout={2}',
     step_create: '\n📦 Step 2: 创建应用\n',
     success: '  ✅ 应用创建成功！',
     app_type_label: '  appType: {0}',

package/lib/core/utils.js

@@ -5,7 +5,7 @@
  *   findProjectRoot()         - 查找项目根目录（兼容悟空环境）
  *   extractInfoFromCookies()  - 从 Cookie 列表中提取 csrf_token / corp_id / user_id
  *   loadCookieData()          - 读取 .cache/cookies.json 登录态缓存
- *   triggerLogin()            - 触发登录（自动区分标准/悟空环境）
+ *   triggerLogin()            - 触发登录
  *   refreshCsrfToken()        - 刷新 csrf_token
  *   resolveBaseUrl()          - 从 cookieData 中解析 base_url
  *   isLoginExpired()          - 检测响应体是否表示登录过期

package/lib/flash-note/flash-to-prd.js

@@ -24,6 +24,19 @@ const {
 } = require('../core/utils');
 const { t } = require('../core/i18n');
 
+// ── 路径常量 ──────────────────────────────────────────
+
+/** Prompt 构建模块文件名（与本文件同目录） */
+const PROMPT_BUILDER_FILE = 'build-flash-note-prompt.js';
+
+/** 闪记转 PRD 技能在工作目录软链中的相对路径（用户自定义覆盖场景） */
+const FLASH_NOTE_SKILL_RELATIVE_PATH = path.join(
+  'yida-skills', 'skills', 'yida-flash-note-to-prd', PROMPT_BUILDER_FILE
+);
+
+/** PRD 输出目录名（相对于项目工作目录） */
+const PRD_OUTPUT_DIR = 'prd';
+
 // ── 参数解析 ──────────────────────────────────────────
 
 function parseArgs(args) {
@@ -117,28 +130,26 @@ function extractProjectNameFromPrd(prdContent) {
 // ── Prompt 构建模块加载 ───────────────────────────────
 
 function loadPromptBuilder() {
+  // 优先：与本文件同目录的内置模块（npm 包安装后的标准路径）
+  const builtinModulePath = path.join(__dirname, PROMPT_BUILDER_FILE);
+
+  // 备用：用户工作目录下的 yida-skills 软链（openyida copy -skills 创建的软链）
   const projectRoot = findProjectRoot();
-  const skillsModulePath = path.join(
-    __dirname, '..', '..', 'yida-skills', 'skills',
-    'yida-flash-note-to-prd', 'build-flash-note-prompt.js'
-  );
-  const localModulePath = path.join(
-    projectRoot, 'skills', 'yida-flash-note-to-prd', 'build-flash-note-prompt.js'
-  );
+  const linkedModulePath = path.join(projectRoot, FLASH_NOTE_SKILL_RELATIVE_PATH);
 
-  if (fs.existsSync(skillsModulePath)) {
+  if (fs.existsSync(builtinModulePath)) {
     console.error(t('flashNote.toPrd.module_loaded_builtin'));
-    return require(skillsModulePath);
+    return require(builtinModulePath);
   }
 
-  if (fs.existsSync(localModulePath)) {
-    console.error(t('flashNote.toPrd.module_loaded_local', localModulePath));
-    return require(localModulePath);
+  if (fs.existsSync(linkedModulePath)) {
+    console.error(t('flashNote.toPrd.module_loaded_local', linkedModulePath));
+    return require(linkedModulePath);
   }
 
   console.error(t('flashNote.toPrd.module_not_found'));
-  console.error(t('flashNote.toPrd.module_path_tried', '1', skillsModulePath));
-  console.error(t('flashNote.toPrd.module_path_tried', '2', localModulePath));
+  console.error(t('flashNote.toPrd.module_path_tried', '1', builtinModulePath));
+  console.error(t('flashNote.toPrd.module_path_tried', '2', linkedModulePath));
   process.exit(1);
 }
 
@@ -268,7 +279,7 @@ async function run(args) {
   const projectName = parsed.name || extractProjectNameFromPrd(prdContent);
   const safeFileName = projectName.replace(/[<>:"/\\|?*\s]/g, '-').replace(/-+/g, '-');
   const projectRoot = findProjectRoot();
-  const prdDir = path.join(projectRoot, 'prd');
+  const prdDir = path.join(projectRoot, PRD_OUTPUT_DIR);
 
   if (!fs.existsSync(prdDir)) {
     fs.mkdirSync(prdDir, { recursive: true });