重构 CLI 命令，添加生成、检查、添加、医生和工作室功能，优化开发脚本和依赖管理

Author: hotlong

package.json

@@ -14,12 +14,11 @@
     "docs"
   ],
   "scripts": {
-    "dev": "node scripts/start-app.mjs examples/showcase",
-    "runner": "pnpm --filter @object-ui/runner dev",
-    "dev:dashboard": "node scripts/start-app.mjs examples/dashboard",
-    "dev:crm": "node scripts/start-app.mjs examples/crm-app",
-    "dev:showcase": "node scripts/start-app.mjs examples/showcase",
-    "start:app": "node scripts/start-app.mjs",
+    "dev": "pnpm dev:showcase",
+    "dev:dashboard": "node packages/cli/dist/cli.js dev examples/dashboard/index.json",
+    "dev:crm": "node packages/cli/dist/cli.js dev examples/crm-app/app.json",
+    "dev:showcase": "node packages/cli/dist/cli.js dev examples/showcase/app.json",
+    "showcase": "node packages/cli/dist/cli.js showcase",
     "start": "pnpm dev",
     "build": "pnpm --filter './packages/*' -r build && pnpm --filter './examples/*' -r build",
     "pretest": "pnpm --filter @object-ui/types build && pnpm --filter @object-ui/core build && pnpm --filter @object-ui/react build && pnpm --filter @object-ui/components build",
@@ -33,6 +32,11 @@
     "lint": "pnpm -r lint",
     "cli": "node packages/cli/dist/cli.js",
     "objectui": "node packages/cli/dist/cli.js",
+    "doctor": "node packages/cli/dist/cli.js doctor",
+    "studio": "node packages/cli/dist/cli.js studio",
+    "check": "node packages/cli/dist/cli.js check",
+    "generate": "node packages/cli/dist/cli.js generate",
+    "g": "node packages/cli/dist/cli.js generate",
     "changeset": "changeset",
     "changeset:version": "changeset version",
     "changeset:publish": "changeset publish"
@@ -49,6 +53,7 @@
     "@types/react-dom": "18.3.1",
     "@vitest/coverage-v8": "^4.0.17",
     "@vitest/ui": "^4.0.17",
+    "autoprefixer": "^10.4.23",
     "eslint": "^9.39.2",
     "eslint-plugin-react-hooks": "^7.0.1",
     "eslint-plugin-react-refresh": "^0.4.24",

packages/cli/package.json

@@ -31,20 +31,22 @@
   "author": "ObjectQL Team",
   "license": "MIT",
   "dependencies": {
-    "commander": "^14.0.2",
-    "chalk": "^5.4.1",
-    "vite": "^7.3.1",
+    "@object-ui/components": "workspace:*",
+    "@object-ui/react": "workspace:*",
+    "@types/glob": "^9.0.0",
     "@vitejs/plugin-react": "^4.2.1",
+    "chalk": "^5.4.1",
+    "commander": "^14.0.2",
     "express": "^4.21.2",
     "express-rate-limit": "^7.4.1",
+    "glob": "^13.0.0",
     "js-yaml": "^4.1.0",
-    "@object-ui/react": "workspace:*",
-    "@object-ui/components": "workspace:*"
+    "vite": "^7.3.1"
   },
   "devDependencies": {
     "@types/express": "^4.17.21",
-    "@types/node": "^25.0.8",
     "@types/js-yaml": "^4.0.9",
+    "@types/node": "^25.0.8",
     "tsup": "^8.0.0",
     "typescript": "^5.9.3"
   }

packages/cli/src/cli.ts

@@ -8,6 +8,11 @@ import { buildApp } from './commands/build.js';
 import { start } from './commands/start.js';
 import { lint } from './commands/lint.js';
 import { test } from './commands/test.js';
+import { generate } from './commands/generate.js';
+import { doctor } from './commands/doctor.js';
+import { add } from './commands/add.js';
+import { studio } from './commands/studio.js';
+import { check } from './commands/check.js';
 import { readFileSync } from 'fs';
 import { fileURLToPath } from 'url';
 import { dirname, join } from 'path';
@@ -130,4 +135,85 @@ program
     }
   });
 
+program
+  .command('generate')
+  .alias('g')
+  .description('Generate new resources (objects, pages, plugins)')
+  .argument('<type>', 'Type of resource to generate (resource/object, page, plugin)')
+  .argument('<name>', 'Name of the resource')
+  .action(async (type, name) => {
+    try {
+      await generate(type, name);
+    } catch (error) {
+      console.error(chalk.red('Error:'), error instanceof Error ? error.message : error);
+      process.exit(1);
+    }
+  });
+
+program
+  .command('doctor')
+  .description('Diagnose and fix common issues')
+  .action(async () => {
+    try {
+      await doctor();
+    } catch (error) {
+      console.error(chalk.red('Error:'), error instanceof Error ? error.message : error);
+      process.exit(1);
+    }
+  });
+
+program
+  .command('add')
+  .description('Add a new component renderer to your project')
+  .argument('<component>', 'Component name (e.g. Input, Grid)')
+  .action(async (component) => {
+    try {
+      await add(component);
+    } catch (error) {
+      console.error(chalk.red('Error:'), error instanceof Error ? error.message : error);
+      process.exit(1);
+    }
+  });
+
+program
+  .command('studio')
+  .description('Start the visual designer')
+  .action(async () => {
+    try {
+      await studio();
+    } catch (error) {
+      console.error(chalk.red('Error:'), error instanceof Error ? error.message : error);
+      process.exit(1);
+    }
+  });
+
+program
+  .command('check')
+  .description('Validate schema files')
+  .action(async () => {
+    try {
+      await check();
+    } catch (error) {
+      console.error(chalk.red('Error:'), error instanceof Error ? error.message : error);
+      process.exit(1);
+    }
+  });
+
+program
+  .command('showcase')
+  .description('Start the built-in showcase example')
+  .option('-p, --port <port>', 'Port to run the server on', '3000')
+  .option('-h, --host <host>', 'Host to bind the server to', 'localhost')
+  .option('--no-open', 'Do not open browser automatically')
+  .action(async (options) => {
+    try {
+      // Locate repository root relative to this file and point to examples/showcase/app.json
+      const showcaseSchema = join(__dirname, '../../..', 'examples', 'showcase', 'app.json');
+      await dev(showcaseSchema, options);
+    } catch (error) {
+      console.error(chalk.red('Error:'), error instanceof Error ? error.message : error);
+      process.exit(1);
+    }
+  });
+
 program.parse();

packages/cli/src/commands/add.ts

@@ -0,0 +1,9 @@
+import chalk from 'chalk';
+import { existsSync, mkdirSync, writeFileSync } from 'fs';
+import { join } from 'path';
+
+export async function add(component: string) {
+  console.log(chalk.bold(`Object UI Add: ${component}`));
+  console.log(chalk.yellow('Feature not implemented yet.'));
+  console.log(`This command will download the source code for ${component}Renderer to your project.`);
+}

packages/cli/src/commands/check.ts

@@ -0,0 +1,39 @@
+import chalk from 'chalk';
+import { globSync } from 'glob';
+import { readFileSync } from 'fs';
+import { join } from 'path';
+
+export async function check() {
+  console.log(chalk.bold('Object UI Schema Check'));
+  const cwd = process.cwd();
+  
+  // 1. Find all JSON/YAML files
+  const files = globSync('**/*.{json,yaml,yml}', { 
+    cwd, 
+    ignore: ['node_modules/**', 'dist/**', '.git/**'] 
+  });
+  
+  console.log(`Analyzing ${files.length} files...`);
+  
+  let errors = 0;
+  
+  for (const file of files) {
+    try {
+      // Basic JSON parsing check
+      if (file.endsWith('.json')) {
+        JSON.parse(readFileSync(join(cwd, file), 'utf-8'));
+      }
+      // TODO: Schema validation logic
+    } catch (e) {
+      console.log(chalk.red(`x Invalid JSON in ${file}: ${(e as Error).message}`));
+      errors++;
+    }
+  }
+  
+  if (errors === 0) {
+    console.log(chalk.green('✓ All checks passed'));
+  } else {
+    console.log(chalk.red(`Found ${errors} errors`));
+    process.exit(1);
+  }
+}

packages/cli/src/commands/dev.ts

@@ -1,9 +1,10 @@
 import { createServer } from 'vite';
 import react from '@vitejs/plugin-react';
-import { existsSync, mkdirSync } from 'fs';
-import { join, resolve } from 'path';
+import { existsSync, mkdirSync, unlinkSync, statSync } from 'fs';
+import { join, resolve, dirname } from 'path';
 import chalk from 'chalk';
 import { execSync } from 'child_process';
+import { createRequire } from 'module';
 import { scanPagesDirectory, createTempAppWithRouting, createTempApp, parseSchemaFile, type RouteInfo } from '../utils/app-generator.js';
 
 interface DevOptions {
@@ -15,22 +16,62 @@ interface DevOptions {
 export async function dev(schemaPath: string, options: DevOptions) {
   const cwd = process.cwd();
 
-  // Check if pages directory exists for file-system routing
-  const pagesDir = join(cwd, 'pages');
-  const hasPagesDir = existsSync(pagesDir);
+  // Resolve the actual project root and schema file
+  let projectRoot = cwd;
+  let targetSchemaPath = schemaPath;
+  let hasPagesDir = false;
+  let pagesDir = '';
+  let appConfig: unknown = null;
+
+  // 1. Determine Project Root & Mode
+  const absoluteSchemaPath = resolve(cwd, schemaPath);
+  
+  if (existsSync(absoluteSchemaPath) && statSync(absoluteSchemaPath).isFile()) {
+    // If input is a file (e.g. examples/showcase/app.json)
+    const fileDir = dirname(absoluteSchemaPath);
+    const potentialPagesDir = join(fileDir, 'pages');
+
+    if (existsSync(potentialPagesDir)) {
+      console.log(chalk.blue(`📂 Detected project structure at ${fileDir}`));
+      projectRoot = fileDir;
+      hasPagesDir = true;
+      pagesDir = potentialPagesDir;
+      
+      // Try to load app.json as config
+      try {
+        appConfig = parseSchemaFile(absoluteSchemaPath);
+        console.log(chalk.blue('⚙️  Loaded App Config from app.json'));
+      } catch (e) {
+        console.warn('Failed to parse app config');
+      }
+    }
+  } 
+  
+  // Fallback: Check detect pages dir in current cwd if not found above
+  if (!hasPagesDir) {
+     const localPagesDir = join(cwd, 'pages');
+     if (existsSync(localPagesDir)) {
+        hasPagesDir = true;
+        pagesDir = localPagesDir;
+        // Try to find app.json in cwd
+        // TODO: Load app.json if exists
+     }
+  }
+
+  const require = createRequire(join(cwd, 'package.json'));
 
   let routes: RouteInfo[] = [];
   let schema: unknown = null;
   let useFileSystemRouting = false;
 
   if (hasPagesDir) {
     // File-system based routing
-    console.log(chalk.blue('📁 Detected pages/ directory - using file-system routing'));
+    console.log(chalk.blue(`📁 Using file-system routing from ${pagesDir}`));
     routes = scanPagesDirectory(pagesDir);
     useFileSystemRouting = true;
 
     if (routes.length === 0) {
-      throw new Error('No schema files found in pages/ directory');
+      throw new Error(`No schema files found in ${pagesDir}`);
     }
 
     console.log(chalk.green(`✓ Found ${routes.length} route(s)`));
@@ -40,33 +81,30 @@ export async function dev(schemaPath: string, options: DevOptions) {
   } else {
     // Single schema file mode
     const fullSchemaPath = resolve(cwd, schemaPath);
-
-    // Check if schema file exists
+    // ... (rest of the logic)
     if (!existsSync(fullSchemaPath)) {
       throw new Error(`Schema file not found: ${schemaPath}\nRun 'objectui init' to create a sample schema.`);
     }
-
     console.log(chalk.blue('📋 Loading schema:'), chalk.cyan(schemaPath));
-
-    // Read and validate schema
     try {
       schema = parseSchemaFile(fullSchemaPath);
     } catch (error) {
-      throw new Error(`Invalid schema file: ${error instanceof Error ? error.message : error}`);
+       throw new Error(`Invalid schema file: ${error instanceof Error ? error.message : error}`);
     }
   }
 
-  // Create temporary app directory
+  // Create temporary app directory (always in cwd to keep node_modules access)
   const tmpDir = join(cwd, '.objectui-tmp');
   mkdirSync(tmpDir, { recursive: true });
 
   // Create temporary app files
   if (useFileSystemRouting) {
-    createTempAppWithRouting(tmpDir, routes);
+    createTempAppWithRouting(tmpDir, routes, appConfig);
   } else {
     createTempApp(tmpDir, schema);
   }
 
+
   // Install dependencies
   const isMonorepo = existsSync(join(cwd, 'pnpm-workspace.yaml'));
 
@@ -90,16 +128,61 @@ export async function dev(schemaPath: string, options: DevOptions) {
   console.log(chalk.blue('🚀 Starting development server...\n'));
 
   // Create Vite config
-  const viteConfig = {
+  const viteConfig: any = {
     root: tmpDir,
     server: {
       port: parseInt(options.port),
       host: options.host,
       open: options.open !== false,
+      fs: {
+        // Allow serving files from workspace root
+        allow: [cwd],
+      }
+    },
+    resolve: {
+      alias: {}
     },
     plugins: [react()],
   };
 
+  if (isMonorepo) {
+    console.log(chalk.blue('📦 Detected monorepo - configuring workspace aliases'));
+    
+    // Remove postcss.config.js to prevent interference with programmatic config
+    const postcssPath = join(tmpDir, 'postcss.config.js');
+    if (existsSync(postcssPath)) {
+      unlinkSync(postcssPath);
+    }
+
+    // Add aliases for workspace packages
+    viteConfig.resolve.alias = {
+      '@object-ui/react': join(cwd, 'packages/react/src/index.ts'),
+      '@object-ui/components': join(cwd, 'packages/components/src/index.ts'),
+      '@object-ui/core': join(cwd, 'packages/core/src/index.ts'),
+      '@object-ui/types': join(cwd, 'packages/types/src/index.ts'),
+    };
+    
+    // Debug aliases
+    // console.log('Aliases:', viteConfig.resolve.alias);
+
+    // Configure PostCSS programmatically reusing root dependencies
+    try {
+      const tailwindcss = require('tailwindcss');
+      const autoprefixer = require('autoprefixer');
+      
+      viteConfig.css = {
+        postcss: {
+          plugins: [
+            tailwindcss(join(tmpDir, 'tailwind.config.js')),
+            autoprefixer(),
+          ],
+        },
+      };
+    } catch (e) {
+      console.warn(chalk.yellow('⚠️ Failed to load PostCSS plugins from root node_modules. Styles might not work correctly.'));
+    }
+  }
+
   // Create Vite server
   const server = await createServer(viteConfig);