pandax 0.0.1 → 0.0.2-beta.0

package/README.md

@@ -24,11 +24,25 @@ npx pandax --tool codebuddy
 ## 初始化项目模板
 
 ```bash
-npx pandax --init vue3                    # 初始化 Vue3 单应用模板
+npx pandax --init                          # 交互式选择项目类型
+npx pandax --init ui-lib                   # 初始化独立组件库（交互式配置）
+npx pandax --init ui-lib --name my-ui --prefix A --no-i18n  # 全参数跳过交互
 npx pandax --init pandax-monorepo       # 初始化 Monorepo + 微前端模板
 npx pandax --init vue3 --with-skills    # 初始化模板并安装 skills
 ```
 
+### ui-lib 模式 CLI 参数
+
+| 参数 | 说明 | 默认值 |
+|------|------|--------|
+| `--name <pkg>` | npm 包名（小写，`^[a-z][a-z0-9-]*$`） | `my-ui-lib` |
+| `--prefix <Pascal>` | 组件前缀（PascalCase） | `My` |
+| `--i18n` / `--no-i18n` | 启用/关闭国际化 | 启用 |
+| `--element-plus` / `--no-element-plus` | 启用/关闭 Element Plus | 启用 |
+| `--pm <pnpm\|npm\|yarn>` | 包管理器 | `pnpm` |
+
+初始化后的组件库支持：独立 npm 发布、Monorepo 源码引用、组件与 CSS 按需引入、国际化（详见 [pandax-frontend-architecture](skills/pandax-frontend-architecture/SKILL.md)）。
+
 ## 卸载
 
 ```bash
@@ -43,7 +57,6 @@ npx pandax --uninstall
 |-------|------|
 | [pandax-frontend-architecture](skills/pandax-frontend-architecture/SKILL.md) | 设计前端项目架构与技术方案 |
 | [pandax-frontend-component-review](skills/pandax-frontend-component-review/SKILL.md) | 审查 Vue/React 组件代码 |
-| [pandax-frontend-chinese-copywriting](skills/pandax-frontend-chinese-copywriting/SKILL.md) | 检查并修正项目中的中文文案排版 |
 | [pandax-frontend-api-mock](skills/pandax-frontend-api-mock/SKILL.md) | 规范 API 对接与 Mock 数据管理 |
 | [pandax-frontend-requirement](skills/pandax-frontend-requirement/SKILL.md) | 梳理前端需求并输出可执行方案 |
 | [pandax-frontend-standards](skills/pandax-frontend-standards/SKILL.md) | 统一引用前端规范文档 |
@@ -71,13 +84,6 @@ npx pandax --uninstall
 node bin/pandax.js --tool trae
 ```
 
-### 发布到 npm
-
-```bash
-npm login
-npm publish --access public
-```
-
 ## 参考
 
 - [superpowers-zh](https://www.npmjs.com/package/superpowers-zh)

package/bin/pandax.js

@@ -19,6 +19,9 @@ const SKILLS_SRC = resolve(__dirname, '..', 'skills');
 const TEMPLATES_SRC = resolve(__dirname, '..', 'templates');
 const PROJECT_DIR = process.cwd();
 
+// 跳过这些目录/文件，避免复制 node_modules 等构建产物
+const SKIP_ENTRIES = new Set(['.DS_Store', 'node_modules', '.git', 'dist', '.turbo']);
+
 // 手动递归复制，避免 Windows npx 缓存 junction 问题
 function copyDirSync(src, dest) {
   let realSrc = src;
@@ -27,7 +30,7 @@ function copyDirSync(src, dest) {
   mkdirSync(dest, { recursive: true });
   const entries = readdirSync(realSrc, { withFileTypes: true });
   for (const entry of entries) {
-    if (entry.name === '.DS_Store') continue;
+    if (SKIP_ENTRIES.has(entry.name)) continue;
     const srcPath = join(realSrc, entry.name);
     const destPath = join(dest, entry.name);
     let stat;
@@ -61,6 +64,76 @@ function removeSync(p) {
   }
 }
 
+const readline = require('readline');
+
+function isInteractive() {
+  return process.stdin.isTTY === true;
+}
+
+function ask(question, defaultVal) {
+  const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+  return new Promise(resolve => {
+    const hint = defaultVal ? ` (${defaultVal})` : '';
+    rl.question(`  ? ${question}${hint}: `, ans => {
+      rl.close();
+      resolve((ans.trim() || defaultVal || '').trim());
+    });
+  });
+}
+
+async function askBool(question, defaultVal) {
+  const raw = await ask(question, defaultVal ? 'y' : 'n');
+  return /^(y|yes|true|1)$/i.test(raw);
+}
+
+const PKG_NAME_RE = /^[a-z][a-z0-9-]*$/;
+const PREFIX_RE = /^[A-Z][a-zA-Z0-9]*$/;
+
+async function collectUiLibConfig(flags) {
+  let name = flags.name;
+  if (!name) {
+    let attempts = 0;
+    do {
+      name = await ask('npm 包名', 'my-ui-lib');
+      attempts++;
+      if (!PKG_NAME_RE.test(name) && attempts >= 3) {
+        name = 'my-ui-lib';
+        break;
+      }
+    } while (!PKG_NAME_RE.test(name));
+  } else if (!PKG_NAME_RE.test(name)) {
+    console.error(`  ❌ 包名非法: ${name}（需匹配 ${PKG_NAME_RE}）`);
+    process.exit(1);
+  }
+  let prefix = flags.prefix || await ask('组件前缀 (PascalCase)', 'My');
+  if (!PREFIX_RE.test(prefix)) prefix = 'My';
+  const i18n = flags.i18n ?? await askBool('启用 i18n?', true);
+  const ep = flags.elementPlus ?? await askBool('启用 Element Plus?', true);
+  const pm = flags.pm || await ask('包管理器 (pnpm/npm/yarn)', 'pnpm');
+  return { name, prefix, i18n, elementPlus: ep, pm };
+}
+
+async function collectUiLibConfigSafe(flags) {
+  if (isInteractive()) return collectUiLibConfig(flags);
+  return {
+    name: flags.name || 'my-ui-lib',
+    prefix: flags.prefix || 'My',
+    i18n: flags.i18n ?? true,
+    elementPlus: flags.elementPlus ?? true,
+    pm: flags.pm || 'pnpm',
+  };
+}
+
+async function pickProjectType() {
+  const templates = listTemplates();
+  console.log('\n  选择项目类型:');
+  templates.forEach((t, i) => console.log(`    ${i + 1}. ${t}`));
+  const idx = await ask('输入序号', '1');
+  const i = parseInt(idx, 10) - 1;
+  if (i >= 0 && i < templates.length) return templates[i];
+  return templates[0];
+}
+
 function countDirs(dir) {
   if (!existsSync(dir)) return 0;
   return readdirSync(dir, { withFileTypes: true }).filter(e => e.isDirectory()).length;
@@ -330,6 +403,160 @@ function copyTemplateSync(templateName, destDir) {
   copyDirSync(src, destDir);
 }
 
+const { extname } = require('path');
+
+const TEXT_EXTS = new Set([
+  '.json', '.ts', '.tsx', '.vue', '.md', '.scss', '.css',
+  '.yaml', '.yml', '.js', '.cjs', '.mjs', '.html',
+]);
+
+function isTextFile(filePath) {
+  return TEXT_EXTS.has(extname(filePath).toLowerCase());
+}
+
+function buildPlaceholders(config) {
+  return {
+    __PACKAGE_NAME__: config.name,
+    __COMPONENT_PREFIX__: config.prefix,
+    __SCOPE_NAME__: config.name.replace(/^@/, '').split('/').pop(),
+  };
+}
+
+function renderContent(content, config) {
+  const placeholders = buildPlaceholders(config);
+  let out = content;
+  for (const [k, v] of Object.entries(placeholders)) {
+    out = out.split(k).join(v);
+  }
+  return out;
+}
+
+// 复制 ui-lib 模板并对文本文件做占位符替换
+function copyTemplateWithRender(templateName, destDir, config) {
+  const src = resolve(TEMPLATES_SRC, templateName);
+  if (!existsSync(src)) throw new Error(`模板不存在: ${templateName}`);
+  copyDirSyncWithRender(src, destDir, config);
+}
+
+function copyDirSyncWithRender(src, dest, config) {
+  let realSrc = src;
+  try { realSrc = realpathSync(src); } catch {}
+  mkdirSync(dest, { recursive: true });
+  for (const entry of readdirSync(realSrc, { withFileTypes: true })) {
+    if (SKIP_ENTRIES.has(entry.name)) continue;
+    const srcPath = join(realSrc, entry.name);
+    const destPath = join(dest, entry.name);
+    let stat;
+    try { stat = lstatSync(srcPath); } catch { continue; }
+    if (stat.isSymbolicLink()) {
+      try {
+        const real = realpathSync(srcPath);
+        const realStat = lstatSync(real);
+        if (realStat.isDirectory()) copyDirSyncWithRender(real, destPath, config);
+        else copyFileWithRender(real, destPath, config);
+      } catch {}
+    } else if (stat.isDirectory()) {
+      copyDirSyncWithRender(srcPath, destPath, config);
+    } else if (stat.isFile()) {
+      copyFileWithRender(srcPath, destPath, config);
+    }
+  }
+}
+
+function copyFileWithRender(srcPath, destPath, config) {
+  if (isTextFile(srcPath)) {
+    const content = readFileSync(srcPath, 'utf8');
+    writeFileSync(destPath, renderContent(content, config), 'utf8');
+  } else {
+    copyFileSync(srcPath, destPath);
+  }
+}
+
+function applyConditional(srcDir, config) {
+  if (!config.i18n) {
+    removeSync(resolve(srcDir, 'src/locales'));
+    removeSync(resolve(srcDir, 'src/composables/use-locale'));
+    removeSync(resolve(srcDir, 'src/vue-i18n.ts'));
+    cleanupI18nRefs(srcDir);
+  }
+  if (!config.elementPlus) {
+    cleanupElementPlusRefs(srcDir);
+  }
+}
+
+// 清理 i18n 引用：从 index.ts/install.ts 移除 i18n 相关 import 与调用
+function cleanupI18nRefs(srcDir) {
+  const indexPath = resolve(srcDir, 'src/index.ts');
+  if (existsSync(indexPath)) {
+    let content = readFileSync(indexPath, 'utf8');
+    content = content
+      .replace(/import\s+\{[^}]*useLocale[^}]*\}\s+from\s+'[^']*composables\/use-locale';?\n?/g, '')
+      .replace(/import\s+\{[^}]*provideLocale[^}]*\}\s+from[^;]*;\n?/g, '')
+      .replace(/import\s+\{[^}]*createTranslate[^}]*\}\s+from[^;]*;\n?/g, '')
+      .replace(/import\s+\{[^}]*useVueI18nLocale[^}]*\}\s+from\s+'[^']*vue-i18n';?\n?/g, '')
+      .replace(/import\s+\{\s*messages\s*\}\s+from\s+'[^']*locales';?\n?/g, '')
+      .replace(/\/\/ 组合式函数[\s\S]*?(?=\n\/\/ )/g, '')
+      .replace(/\/\/ 词条[\s\S]*?(?=\n\/\/ )/g, '')
+      .replace(/export\s+\{[^}]*useLocale[^}]*\};\n?/g, '')
+      .replace(/export\s+\{[^}]*messages[^}]*\};\n?/g, '')
+      .replace(/export\s+type\s+\{[^}]*Locale[^}]*\}\s+from\s+'[^']*locales';?\n?/g, '')
+      .replace(/export\s+type\s+\{[^}]*LocaleContext[^}]*\}\s+from[^;]*;\n?/g, '')
+      .replace(/provideLocale\([^)]*\);?\n?/g, '');
+    writeFileSync(indexPath, content, 'utf8');
+  }
+  const installPath = resolve(srcDir, 'src/install.ts');
+  if (existsSync(installPath)) {
+    let content = readFileSync(installPath, 'utf8');
+    content = content
+      // 兼容假设形态：import { provideLocale, messages } from ...; provideLocale(...)
+      .replace(/import\s+\{[^}]*provideLocale[^}]*messages[^}]*\}\s+from[^;]*;\n?/g, '')
+      .replace(/provideLocale\([^)]*\);?\n?/g, '')
+      // 实际模板：use-locale / locales / localeKey / createTranslate / Locale
+      .replace(/import\s+\{[^}]*\}\s+from\s+'[^']*composables\/use-locale';?\n?/g, '')
+      .replace(/import\s+type\s+\{\s*Locale[^}]*\}\s+from\s+'[^']*locales';?\n?/g, '')
+      .replace(/^\s*locale\?\s*:\s*Locale;?\s*\n/mg, '')
+      .replace(/const\s+locale\s*=\s*options\.locale[^;]*;?\n?/g, '')
+      .replace(/app\.provide\([\s\S]*?\}\);?\n?/g, '');
+    writeFileSync(installPath, content, 'utf8');
+  }
+  // 清理组件 vue 中的 useLocale 引用
+  for (const comp of ['button', 'card']) {
+    const vuePath = resolve(srcDir, `src/${comp}/index.vue`);
+    if (existsSync(vuePath)) {
+      let content = readFileSync(vuePath, 'utf8');
+      content = content
+        .replace(/import\s+\{\s*useLocale\s*\}\s+from\s+'[^']*composables\/use-locale';?\n?/g, '')
+        .replace(/const\s+\{\s*t\s*\}\s*=\s*useLocale\(\);?\n?/g, '')
+        .replace(/\{\{\s*t\([^)]*\)\s*\}\}/g, '');
+      writeFileSync(vuePath, content, 'utf8');
+    }
+  }
+}
+
+// 清理 Element Plus 引用：peerDependencies 移除、external 移除、示例改原生 button
+function cleanupElementPlusRefs(srcDir) {
+  const pkgPath = resolve(srcDir, 'package.json');
+  if (existsSync(pkgPath)) {
+    const pkg = JSON.parse(readFileSync(pkgPath, 'utf8'));
+    if (pkg.peerDependencies) delete pkg.peerDependencies['element-plus'];
+    writeFileSync(pkgPath, JSON.stringify(pkg, null, 2) + '\n', 'utf8');
+  }
+  const vitePath = resolve(srcDir, 'vite.config.ts');
+  if (existsSync(vitePath)) {
+    let content = readFileSync(vitePath, 'utf8');
+    content = content.replace(/'element-plus',?\s*/g, '');
+    writeFileSync(vitePath, content, 'utf8');
+  }
+  // 示例组件改用原生 button
+  const btnVue = resolve(srcDir, 'src/button/index.vue');
+  if (existsSync(btnVue)) {
+    let content = readFileSync(btnVue, 'utf8');
+    content = content
+      .replace(/<el-button[\s\S]*?>([\s\S]*?)<\/el-button>/g, '<button :class="$style.button" :disabled="props.disabled" @click="emit(\'click\', $event)">$1</button>');
+    writeFileSync(btnVue, content, 'utf8');
+  }
+}
+
 function mergeFileIfExists(filePath, content) {
   if (existsSync(filePath)) {
     const existing = readFileSync(filePath, 'utf8');
@@ -341,8 +568,8 @@ function mergeFileIfExists(filePath, content) {
   return true;
 }
 
-function init(templateName, withSkills) {
-  console.log(`\n  ${PKG.name} v${PKG.version} — 初始化 ${templateName} 模板\n`);
+async function init(templateName, withSkills, flags) {
+  console.log(`\n  ${PKG.name} v${PKG.version} — 初始化\n`);
 
   if (!existsSync(TEMPLATES_SRC)) {
     console.error('  ❌ 错误：templates 源目录不存在。');
@@ -355,9 +582,14 @@ function init(templateName, withSkills) {
     process.exit(1);
   }
 
+  // 无参数时交互式选择项目类型
   if (!templateName) {
-    console.error(`  ❌ --init 需要指定模板名。可用模板: ${templates.join(', ')}\n`);
-    process.exit(1);
+    if (isInteractive()) {
+      templateName = await pickProjectType();
+    } else {
+      console.error(`  ❌ --init 需要指定模板名。可用模板: ${templates.join(', ')}\n`);
+      process.exit(1);
+    }
   }
 
   if (!templates.includes(templateName)) {
@@ -377,8 +609,42 @@ function init(templateName, withSkills) {
     process.exit(1);
   }
 
-  copyTemplateSync(templateName, PROJECT_DIR);
-  console.log(`  ✅ ${templateName} 模板已初始化到: ${PROJECT_DIR}\n`);
+  // 目标非空且含 package.json 时报错（ui-lib 等需空目录）
+  const targetPkg = resolve(PROJECT_DIR, 'package.json');
+  if (templateName === 'ui-lib' && existsSync(targetPkg)) {
+    console.error('  ❌ 目标目录已存在 package.json，请换空目录初始化 ui-lib。\n');
+    process.exit(1);
+  }
+
+  if (templateName === 'ui-lib') {
+    const config = await collectUiLibConfigSafe(flags || {});
+    copyTemplateWithRender('ui-lib', PROJECT_DIR, config);
+    applyConditional(PROJECT_DIR, config);
+    console.log(`  ✅ ui-lib 模板已初始化到: ${PROJECT_DIR}\n`);
+    console.log(`  包名: ${config.name}`);
+    console.log(`  组件前缀: ${config.prefix}（生成 ${config.prefix}Button / ${config.prefix}Card）`);
+    console.log(`  i18n: ${config.i18n ? '启用' : '未启用'}`);
+    console.log(`  Element Plus: ${config.elementPlus ? '启用' : '未启用'}\n`);
+    console.log('  下一步:');
+    console.log(`    cd ${PROJECT_DIR}`);
+    console.log(`    ${config.pm} install`);
+    console.log(`    ${config.pm} dev        # 启动 playground 调试`);
+    console.log(`    ${config.pm} build      # 构建组件库`);
+    console.log(`    ${config.pm} lint       # 代码检查\n`);
+  } else if (templateName === 'pandax-monorepo') {
+    const wsConfig = await collectMonorepoConfigSafe(flags || {});
+    copyTemplateSync('pandax-monorepo', PROJECT_DIR);
+    applyMonorepoPlaceholders(PROJECT_DIR, wsConfig);
+    console.log(`  ✅ pandax-monorepo 模板已初始化到: ${PROJECT_DIR}\n`);
+    if (wsConfig.includeComponents) {
+      console.log(`  组件库包名: ${wsConfig.componentPkg}`);
+      console.log(`  组件前缀: ${wsConfig.prefix}`);
+    }
+    console.log(`\n  下一步: cd ${PROJECT_DIR} && pnpm install && pnpm dev\n`);
+  } else {
+    copyTemplateSync(templateName, PROJECT_DIR);
+    console.log(`  ✅ ${templateName} 模板已初始化到: ${PROJECT_DIR}\n`);
+  }
 
   if (withSkills) {
     console.log(`  继续安装 skills...\n`);
@@ -389,6 +655,35 @@ function init(templateName, withSkills) {
   }
 }
 
+async function collectMonorepoConfigSafe(flags) {
+  const projectName = flags.name || (isInteractive() ? await ask('monorepo 项目名', 'pandax-monorepo') : 'pandax-monorepo');
+  const includeComponents = flags.monorepoComponents ?? (isInteractive() ? await askBool('是否包含组件库 package?', true) : true);
+  const componentPkg = includeComponents
+    ? (flags.componentPkg || (isInteractive() ? await ask('组件库包名', 'pandax-components') : 'pandax-components'))
+    : 'pandax-components';
+  const prefix = flags.prefix || (isInteractive() ? await ask('组件前缀 (PascalCase)', 'Panda') : 'Panda');
+  return { projectName, includeComponents, componentPkg, prefix };
+}
+
+function applyMonorepoPlaceholders(destDir, config) {
+  // 替换根 package.json name
+  const rootPkg = resolve(destDir, 'package.json');
+  if (existsSync(rootPkg)) {
+    const pkg = JSON.parse(readFileSync(rootPkg, 'utf8'));
+    pkg.name = config.projectName;
+    writeFileSync(rootPkg, JSON.stringify(pkg, null, 2) + '\n', 'utf8');
+  }
+  // 替换组件库 package name 与组件前缀
+  if (config.includeComponents) {
+    const compPkg = resolve(destDir, 'packages/components/package.json');
+    if (existsSync(compPkg)) {
+      const pkg = JSON.parse(readFileSync(compPkg, 'utf8'));
+      pkg.name = config.componentPkg;
+      writeFileSync(compPkg, JSON.stringify(pkg, null, 2) + '\n', 'utf8');
+    }
+  }
+}
+
 function showHelp() {
   console.log(`
   ${PKG.name} v${PKG.version} — Pandax 全栈 AI 编程技能魔盒
@@ -396,12 +691,23 @@ function showHelp() {
   用法：
     npx ${PKG.name}                              项目级：自动检测工具并安装 skills
     npx ${PKG.name} --tool trae                  指定工具安装 skills
-    npx ${PKG.name} --init vue3                  初始化 Vue3 项目模板
-    npx ${PKG.name} --init vue3 --with-skills    初始化 Vue3 模板并安装 skills
+    npx ${PKG.name} --init                       交互式选择项目模板
+    npx ${PKG.name} --init ui-lib                初始化独立组件库（交互式配置）
+    npx ${PKG.name} --init ui-lib --name my-ui --prefix A --no-i18n
+    npx ${PKG.name} --init pandax-monorepo       初始化 Monorepo + 微前端模板
+    npx ${PKG.name} --init vue3                  初始化 Vue3 单应用模板
+    npx ${PKG.name} --init vue3 --with-skills    初始化模板并安装 skills
     npx ${PKG.name} --uninstall                  卸载当前项目 skills
     npx ${PKG.name} --help                       显示帮助
     npx ${PKG.name} --version                    显示版本
 
+  ui-lib 参数：
+    --name <pkg>          npm 包名（小写，^[a-z][a-z0-9-]*$）
+    --prefix <Pascal>     组件前缀（PascalCase）
+    --i18n / --no-i18n    启用/关闭 i18n（默认启用）
+    --element-plus / --no-element-plus  启用/关闭 Element Plus（默认启用）
+    --pm <pnpm|npm|yarn>  包管理器（默认 pnpm）
+
   支持的工具名：
     ${Object.keys(TOOL_ALIASES).join(', ')}
 
@@ -550,43 +856,72 @@ const initIdx = args.findIndex(a => a === '--init' || a === '-i');
 const uninstallIdx = args.findIndex(a => a === '--uninstall' || a === '-u');
 const forceIdx = args.findIndex(a => a === '--force' || a === '-f');
 const withSkillsIdx = args.findIndex(a => a === '--with-skills');
+
+// ui-lib 专用参数
+const nameIdx = args.findIndex(a => a === '--name');
+const prefixIdx = args.findIndex(a => a === '--prefix');
+const pmIdx = args.findIndex(a => a === '--pm');
+const hasNoI18n = args.includes('--no-i18n');
+const hasI18n = args.includes('--i18n');
+const hasNoEp = args.includes('--no-element-plus');
+const hasEp = args.includes('--element-plus');
+
 const force = forceIdx !== -1;
 const withSkills = withSkillsIdx !== -1;
 
 const KNOWN_FLAGS = new Set([
   '--help', '-h', '--version', '-v', '--uninstall', '-u', '--force', '-f',
-  '--tool', '-t', '--init', '-i', '--with-skills'
+  '--tool', '-t', '--init', '-i', '--with-skills',
+  '--name', '--prefix', '--pm', '--no-i18n', '--i18n',
+  '--no-element-plus', '--element-plus',
 ]);
 
-if (helpIdx !== -1) {
-  showHelp();
-} else if (versionIdx !== -1) {
-  console.log(PKG.version);
-} else if (uninstallIdx !== -1) {
-  uninstall();
-} else if (initIdx !== -1) {
-  const templateArg = args[initIdx + 1];
-  init(templateArg, withSkills);
-} else if (toolIdx !== -1) {
-  const toolArg = args[toolIdx + 1];
-  if (!toolArg) {
-    console.error('  ❌ --tool 需要指定工具名，例如: --tool trae\n');
-    showHelp();
-    process.exit(1);
-  }
-  const toolName = TOOL_ALIASES[toolArg.toLowerCase()];
-  if (!toolName) {
-    console.error(`  ❌ 未知工具: ${toolArg}`);
-    console.error(`  支持的工具: ${Object.keys(TOOL_ALIASES).join(', ')}\n`);
-    process.exit(1);
-  }
-  install(toolName, force);
-} else {
-  const unknown = args.find(a => a.startsWith('-') && !KNOWN_FLAGS.has(a));
-  if (unknown) {
-    console.warn(`  未知参数: ${unknown}\n`);
+function parseFlags() {
+  const flags = {};
+  if (nameIdx !== -1) flags.name = args[nameIdx + 1];
+  if (prefixIdx !== -1) flags.prefix = args[prefixIdx + 1];
+  if (pmIdx !== -1) flags.pm = args[pmIdx + 1];
+  if (hasI18n) flags.i18n = true;
+  if (hasNoI18n) flags.i18n = false;
+  if (hasEp) flags.elementPlus = true;
+  if (hasNoEp) flags.elementPlus = false;
+  return flags;
+}
+
+async function main() {
+  if (helpIdx !== -1) {
     showHelp();
-    process.exit(1);
+  } else if (versionIdx !== -1) {
+    console.log(PKG.version);
+  } else if (uninstallIdx !== -1) {
+    uninstall();
+  } else if (initIdx !== -1) {
+    const templateArg = args[initIdx + 1];
+    const flags = parseFlags();
+    await init(templateArg, withSkills, flags);
+  } else if (toolIdx !== -1) {
+    const toolArg = args[toolIdx + 1];
+    if (!toolArg) {
+      console.error('  ❌ --tool 需要指定工具名，例如: --tool trae\n');
+      showHelp();
+      process.exit(1);
+    }
+    const toolName = TOOL_ALIASES[toolArg.toLowerCase()];
+    if (!toolName) {
+      console.error(`  ❌ 未知工具: ${toolArg}`);
+      console.error(`  支持的工具: ${Object.keys(TOOL_ALIASES).join(', ')}\n`);
+      process.exit(1);
+    }
+    install(toolName, force);
+  } else {
+    const unknown = args.find(a => a.startsWith('-') && !KNOWN_FLAGS.has(a));
+    if (unknown) {
+      console.warn(`  未知参数: ${unknown}\n`);
+      showHelp();
+      process.exit(1);
+    }
+    install(undefined, force);
   }
-  install(undefined, force);
 }
+
+main();

package/package.json

@@ -1,12 +1,13 @@
 {
   "name": "pandax",
-  "version": "0.0.1",
+  "version": "0.0.2-beta.0",
   "description": "Pandax 全栈 AI 编程技能魔盒，支持通过 npx 安装 skills 到 Trae/Cursor/CodeBuddy 等工具",
   "bin": {
     "pandax": "bin/pandax.js"
   },
   "scripts": {
-    "test": "node bin/pandax.js --help"
+    "test": "node bin/pandax.js --help",
+    "verify": "node scripts/verify-init.js"
   },
   "keywords": [
     "pandax",