@mindbase/cli 1.0.5 → 1.0.8

package/package.json

@@ -1,13 +1,14 @@
 {
   "name": "@mindbase/cli",
-  "version": "1.0.5",
+  "version": "1.0.8",
   "type": "module",
   "bin": {
-    "mindbase": "./dist/bin/mindbase.js"
+    "mindbase": "./src/bin/mindbase.ts"
   },
   "files": [
+    "src",
     "assets",
-    "dist"
+    "tsconfig.json"
   ],
   "engines": {
     "node": ">=20.0.0"
@@ -19,13 +20,10 @@
   },
   "devDependencies": {
     "@types/prompts": "^2.4.9",
-    "tsup": "^8.0.0",
     "typescript": "^5.1.3"
   },
   "scripts": {
-    "build": "tsup",
-    "build:watch": "tsup --watch",
-    "prepublishOnly": "npm run build"
+    "prepare": "tsc --noEmit"
   },
   "publishConfig": {
     "access": "public"

package/src/bin/mindbase.ts

@@ -0,0 +1,39 @@
+#!/usr/bin/env node
+import { init } from "../commands/init";
+
+const args = process.argv.slice(2);
+const command = args[0];
+const type = args[1];
+
+async function main() {
+  switch (command) {
+    case "init":
+      await init(type);
+      break;
+    default:
+      showHelp();
+      break;
+  }
+}
+
+function showHelp() {
+  console.log(`
+用法: mindbase <command> [type]
+
+命令:
+  init [type]      初始化新项目
+    backend        后端项目
+    frontend       前端项目
+    admin          管理后台前后端
+
+示例:
+  mindbase init backend       # 交互式选择后端模块
+  mindbase init frontend      # 交互式选择前端应用形态
+  mindbase init admin         # 一键初始化完整管理后台
+  `);
+}
+
+main().catch((err) => {
+  console.error("❌ 执行失败:", err);
+  process.exit(1);
+});

package/src/commands/init/backend.ts

@@ -0,0 +1,34 @@
+import {
+  collectBackendConfig,
+  setupBackendPackageJson,
+  setupAppConfig,
+  setupDrizzleConfig,
+  setupTsConfig,
+  setupAppEntry,
+  copyAssets,
+  setupPrepareScript,
+} from "../../utils/BackendInitializer";
+import logger from "../../utils/Logger";
+
+export async function initBackend() {
+  const cwd = process.cwd();
+  logger.info(`\n🚀 正在初始化 MindBase 后端项目: ${cwd}\n`);
+
+  try {
+    // 1. 交互式收集配置
+    const config = await collectBackendConfig(cwd);
+
+    // 2. 执行各个初始化步骤
+    setupBackendPackageJson(cwd, config);
+    setupAppConfig(cwd, config);
+    setupDrizzleConfig(cwd, config);
+    setupTsConfig(cwd);
+    setupAppEntry(cwd, config);
+    copyAssets(cwd);
+    setupPrepareScript(cwd);
+
+    logger.info("\n✨ 后端项目初始化成功！建议运行: npm install\n");
+  } catch (err) {
+    throw err;
+  }
+}

package/src/commands/init/frontend.ts

@@ -0,0 +1,34 @@
+import {
+  collectFrontendConfig,
+  setupFrontendPackageJson,
+  setupViteConfig,
+  setupFrontendTsConfig,
+  setupIndexHtml,
+  setupAppFiles,
+  setupPublicDir,
+  copyAdminAssets,
+} from "../../utils/FrontendInitializer";
+import logger from "../../utils/Logger";
+
+export async function initFrontend() {
+  const cwd = process.cwd();
+  logger.info(`\n🚀 正在初始化 MindBase 前端项目: ${cwd}\n`);
+
+  try {
+    // 1. 交互式收集配置
+    const config = await collectFrontendConfig(cwd);
+
+    // 2. 执行各个初始化步骤
+    setupFrontendPackageJson(cwd, config);
+    setupViteConfig(cwd, config);
+    setupFrontendTsConfig(cwd);
+    setupIndexHtml(cwd, config);
+    setupAppFiles(cwd, config);
+    setupPublicDir(cwd);
+    copyAdminAssets(cwd, config);
+
+    logger.info("\n✨ 前端项目初始化成功！建议运行: npm install\n");
+  } catch (err) {
+    throw err;
+  }
+}

package/src/commands/init/index.ts

@@ -0,0 +1,50 @@
+import { initBackend } from "./backend";
+import { initFrontend } from "./frontend";
+
+export async function init(type?: string) {
+  switch (type) {
+    case "backend":
+      await initBackend();
+      break;
+    case "frontend":
+      await initFrontend();
+      break;
+    case "admin":
+      await initAdmin();
+      break;
+    default:
+      console.log(`
+用法: mindbase init <type>
+
+类型:
+  backend   初始化后端项目
+  frontend  初始化前端项目
+  admin     快捷：初始化完整管理后台（前后端一体）
+      `);
+      break;
+  }
+}
+
+/**
+ * 快捷方式：初始化完整管理后台
+ * 先初始化后端，再初始化前端，前端自动配置代理到后端
+ */
+async function initAdmin() {
+  console.log("\n🎯 正在初始化完整管理后台...\n");
+
+  // 1. 初始化后端（使用默认配置）
+  console.log("第一步：初始化后端");
+  await initBackend();
+
+  // 2. 初始化前端（使用默认配置）
+  console.log("\n第二步：初始化前端");
+  await initFrontend();
+
+  console.log("\n✨ 完整管理后台初始化成功！");
+  console.log("\n后续步骤：");
+  console.log("  1. cd backend && npm install && npm run dev");
+  console.log("  2. cd frontend && npm install && npm run dev");
+  console.log("  3. 前端会自动代理 API 到后端 http://localhost:3000\n");
+}
+
+export default init;

package/src/commands/sdk-docs.ts

@@ -0,0 +1,138 @@
+#!/usr/bin/env node
+/**
+ * SDK 文档复制命令
+ *
+ * 从已安装的 @mindbase/* 包中复制 sdk-docs 到宿主项目的 docs/sdk/ 目录
+ */
+
+import { copyFileSync, readdirSync, existsSync, mkdirSync, readFileSync, writeFileSync } from 'fs';
+import { join } from 'path';
+
+interface PackageMeta {
+  name: string;
+  category: 'frontend' | 'server';
+  description: string;
+}
+
+// ==================== 主函数 ====================
+
+function copySdkDocs(targetDir: string = process.cwd()): void {
+  const nodeModules = join(targetDir, 'node_modules');
+  const outputDir = join(targetDir, 'docs/sdk');
+
+  console.log('🔍 扫描已安装的 @mindbase 包...');
+
+  // 检查 node_modules 是否存在
+  if (!existsSync(nodeModules)) {
+    console.error('❌ 未找到 node_modules 目录');
+    return;
+  }
+
+  // 扫描 @mindbase 作用域下的包
+  const mindbaseScope = join(nodeModules, '@mindbase');
+  if (!existsSync(mindbaseScope)) {
+    console.warn('⚠️  未找到 @mindbase 包');
+    return;
+  }
+
+  const packages = readdirSync(mindbaseScope)
+    .filter((name) => {
+      const pkgPath = join(mindbaseScope, name);
+      return existsSync(join(pkgPath, 'dist/sdk-docs/README.md'));
+    })
+    .map((name) => {
+      const pkgPath = join(mindbaseScope, name);
+      const metaPath = join(pkgPath, 'sdk-meta.json');
+
+      let meta: PackageMeta = {
+        name: `@mindbase/${name}`,
+        category: name.includes('vue3') || name === 'ajax' || name === 'client' || name === 'types' ? 'frontend' : 'server',
+        description: '',
+      };
+
+      // 尝试读取 sdk-meta.json
+      if (existsSync(metaPath)) {
+        try {
+          meta = JSON.parse(readFileSync(metaPath, 'utf-8'));
+        } catch {
+          // 解析失败，使用默认值
+        }
+      }
+
+      return { name, meta };
+    });
+
+  console.log(`✅ 找到 ${packages.length} 个包含文档的包`);
+
+  if (packages.length === 0) {
+    console.warn('⚠️  没有找到包含 SDK 文档的包');
+    return;
+  }
+
+  // 创建输出目录
+  mkdirSync(join(outputDir, 'frontend'), { recursive: true });
+  mkdirSync(join(outputDir, 'server'), { recursive: true });
+
+  // 复制各包文档
+  console.log('📝 复制 SDK 文档...');
+  for (const { name, meta } of packages) {
+    const category = meta.category;
+    const srcFile = join(mindbaseScope, name, 'dist/sdk-docs/README.md');
+    const destFile = join(outputDir, category, `@mindbase-${name}.md`);
+
+    copyFileSync(srcFile, destFile);
+    console.log(`  ✅ ${meta.name} -> ${category}/@mindbase-${name}.md`);
+  }
+
+  // 生成总入口文档
+  console.log('📝 生成总入口文档...');
+  generateIndexDocs(outputDir, packages);
+
+  console.log('✅ SDK 文档复制完成！');
+  console.log(`📁 输出目录: ${outputDir}`);
+}
+
+// ==================== 生成总入口文档 ====================
+
+function generateIndexDocs(outputDir: string, packages: Array<{ name: string; meta: PackageMeta }>): void {
+  const frontendPkgs = packages.filter((p) => p.meta.category === 'frontend');
+  const serverPkgs = packages.filter((p) => p.meta.category === 'server');
+
+  // 生成前端总入口
+  const frontendDoc = generateCategoryDoc(frontendPkgs, 'frontend');
+  writeFileSync(join(outputDir, 'FRONTEND_SDK_REFERENCE.md'), frontendDoc);
+
+  // 生成后端总入口
+  const serverDoc = generateCategoryDoc(serverPkgs, 'server');
+  writeFileSync(join(outputDir, 'SERVER_SDK_REFERENCE.md'), serverDoc);
+}
+
+function generateCategoryDoc(packages: Array<{ name: string; meta: PackageMeta }>, category: string): string {
+  const categoryName = category === 'frontend' ? '前端' : '后端';
+
+  let doc = `# @mindbase ${categoryName} SDK 参考文档\n\n`;
+  doc += `> 自动生成于: ${new Date().toISOString().split('T')[0]}\n`;
+  doc += `> 由 @mindbase/cli 自动从已安装的包中提取\n\n`;
+
+  if (packages.length === 0) {
+    doc += `> 暂无 ${categoryName} SDK 文档\n`;
+    return doc;
+  }
+
+  // 包索引
+  doc += `## 已安装的包\n\n`;
+  doc += packages.map((p) => `- [\`${p.meta.name}\`](./${category}/@mindbase-${p.name}.md) - ${p.meta.description}`).join('\n');
+  doc += `\n`;
+
+  return doc;
+}
+
+// ==================== CLI 入口 ====================
+
+// 如果直接运行此脚本
+if (import.meta.url === `file://${process.argv[1]}`) {
+  const targetDir = process.argv[2] || process.cwd();
+  copySdkDocs(targetDir);
+}
+
+export { copySdkDocs };

package/src/index.ts

@@ -0,0 +1,33 @@
+// 导出工具函数供外部使用
+export { logger as default, type LogLevel } from "./utils/Logger";
+export {
+  BACKEND_MODULES,
+  FRONTEND_APP_TYPES,
+  resolveDependencies,
+  getFrontendPackage,
+  getAvailableFrontendApps,
+} from "./utils/prompts";
+export {
+  type BackendConfig,
+  collectBackendConfig,
+  setupBackendPackageJson,
+  setupAppConfig,
+  setupDrizzleConfig,
+  setupTsConfig,
+  setupAppEntry,
+  copyAssets,
+  setupPrepareScript,
+} from "./utils/BackendInitializer";
+export {
+  type FrontendConfig,
+  collectFrontendConfig,
+  setupFrontendPackageJson,
+  setupViteConfig,
+  setupFrontendTsConfig,
+  setupIndexHtml,
+  setupAppFiles,
+  setupPublicDir,
+} from "./utils/FrontendInitializer";
+
+// 导出命令
+export { init } from "./commands/init";