feat: 更新文档以推荐使用生成器创建新项目，并添加模板选择功能

Author: hotlong

README.md

@@ -45,7 +45,20 @@ ObjectQL is organized as a Monorepo to ensure modularity and universal compatibi
 
 ## ⚡ Quick Start
 
-### 1. Installation
+### 0. Use the Generator (Recommended)
+
+The fastest way to start is using the CLI to scaffold a new project.
+
+```bash
+# Create a new project
+npm create @objectql@latest my-app
+
+# Choose a template when prompted (hello-world or starter)
+```
+
+### 1. Manual Installation
+
+If you prefer to install manually:
 
 ```bash
 # Install core and a driver (e.g., Postgres or SQLite)

docs/guide/cli.md

@@ -16,26 +16,30 @@ You can then run it via `npx objectql` or add scripts to your `package.json`.
 
 ### 2.1 `init` (Create Project)
 
-Create a new ObjectQL project from a starter template.
+The recommended way to create a new ObjectQL project is using the initialization package.
 
 ```bash
-npx objectql init [options]
+npm create @objectql@latest [name] [options]
 ```
 
 **Options:**
 
 | Option | Alias | Default | Description |
 | :--- | :--- | :--- | :--- |
 | `--template <template>` | `-t` | `starter` | Template to use (`starter`, `hello-world`). |
-| `--name <name>` | `-n` | - | Project name. |
-| `--dir <path>` | `-d` | - | Target directory. |
 | `--skip-install` | | `false` | Skip dependency installation. |
 | `--skip-git` | | `false` | Skip git initialization. |
 
 **Example:**
 
 ```bash
-npx objectql init -t starter -n my-app
+npm create @objectql@latest my-app -- --template showcase
+```
+
+Alternatively, if you already have the CLI installed globally or in a project, you can use the legacy `init` command:
+
+```bash
+npx objectql init [options]
 ```
 
 ### 2.2 `generate` (Type Generation)

docs/guide/getting-started.md

@@ -12,29 +12,26 @@
 
 The fastest way to get started is using the CLI to scaffold a project.
 
-### 1. Minimal Setup (Hello World)
+### 1. Create a New Project
 
-Create a single-file project to learn the basics.
+The easiest way to start is using the generator.
 
 ```bash
-# Initialize a new project
-npx @objectql/cli init --template hello-world --name my-first-app
+# Standard Setup (Recommended) - Full Project Tracker Demo
+npm create @objectql@latest my-app -- --template starter
 
-# Enter directory
-cd my-first-app
-
-# Start the app
-npm start
+# Minimal Setup - Single File
+npm create @objectql@latest my-app -- --template hello-world
 ```
 
-This will create an `index.ts` file that defines a schema, initializes an in-memory SQLite database, and runs some queries.
+This will create a new project with all necessary dependencies.
 
 ### 2. Standard Setup (Project Tracker)
 
-For building real applications, use the `starter` template. This sets up a proper folder structure with YAML metadata, TypeScript logic hooks, and relationship management.
+For building real applications, use the `showcase` template. This sets up a proper folder structure with YAML metadata, TypeScript logic hooks, and relationship management.
 
 ```bash
-npx @objectql/cli init --template starter --name project-tracker
+npm create @objectql@latest project-tracker -- --template showcase
 ```
 
 This structure follows our **Best Practices**:

packages/tools/cli/package.json

@@ -26,7 +26,7 @@
   },
   "scripts": {
     "build": "tsc && pnpm run copy-templates",
-    "copy-templates": "rm -rf templates && mkdir -p templates && cp -r ../../../examples/quickstart/hello-world templates/ && cp -r ../../../examples/showcase/project-tracker templates/ && rm -rf templates/*/node_modules templates/*/dist",
+    "copy-templates": "rm -rf templates && mkdir -p templates && cp -r ../../../examples/quickstart/hello-world templates/ && cp -r ../../../examples/showcase/project-tracker templates/starter && rm -rf templates/*/node_modules templates/*/dist",
     "watch": "tsc -w",
     "test": "jest"
   },

packages/tools/create/README.md

@@ -0,0 +1,28 @@
+# @objectql/create
+
+The easiest way to get started with ObjectQL.
+
+## Usage
+
+```bash
+npm create @objectql@latest
+```
+
+Follow the prompts to create your new ObjectQL application.
+
+## Arguments
+
+You can also pass arguments directly:
+
+```bash
+npm create @objectql@latest <project-name> --template <template-name>
+```
+
+- `<project-name>`: Name of the project directory.
+- `--template`: Template to use (e.g. `hello-world` or `showcase`).
+
+## Features
+
+- **Embedded Templates**: No internet connection required to fetch templates.
+- **Auto-Cleanup**: Automatically cleans up `package.json` configurations (strips `private: true`, resolves workspace versions).
+- **Interactive**: Uses `enquirer` for a smooth interactive experience if no arguments are provided.

packages/tools/create/package.json

@@ -10,8 +10,8 @@
     "templates"
   ],
   "scripts": {
-    "build": "tsc && pnpm run copy-templates",
-    "copy-templates": "rm -rf templates && mkdir -p templates && cp -r ../../../examples/quickstart/hello-world templates/ && cp -r ../../../examples/showcase/project-tracker templates/ && rm -rf templates/*/node_modules templates/*/dist"
+    "build": "tsc && node scripts/copy-templates.js",
+    "copy-templates": "node scripts/copy-templates.js"
   },
   "dependencies": {
     "chalk": "^4.1.2",

packages/tools/create/scripts/copy-templates.js

@@ -0,0 +1,51 @@
+const fs = require('fs-extra');
+const path = require('path');
+
+async function copyTemplates() {
+  const root = path.resolve(__dirname, '..');
+  const templatesDir = path.join(root, 'templates');
+  const examplesDir = path.resolve(root, '../../../examples');
+
+  // Clean
+  await fs.remove(templatesDir);
+  await fs.ensureDir(templatesDir);
+
+  const filterFunc = (src, dest) => {
+    const stats = fs.statSync(src);
+    const filename = path.basename(src);
+    
+    // Directory exclusions
+    if (stats.isDirectory()) {
+      return !['node_modules', 'dist', '.turbo', '.git'].includes(filename);
+    }
+    // File exclusions
+    return !['.DS_Store', 'pnpm-lock.yaml', 'yarn.lock', 'package-lock.json'].includes(filename);
+  };
+
+  const tasks = [
+    {
+      src: path.join(examplesDir, 'quickstart/hello-world'),
+      dest: path.join(templatesDir, 'hello-world')
+    },
+    {
+      src: path.join(examplesDir, 'showcase/project-tracker'),
+      dest: path.join(templatesDir, 'starter')
+    }
+  ];
+
+  for (const task of tasks) {
+    if (!fs.existsSync(task.src)) {
+      console.warn(`Warning: Source not found: ${task.src}`);
+      continue;
+    }
+    console.log(`Copying ${task.src} -> ${task.dest}`);
+    await fs.copy(task.src, task.dest, { filter: filterFunc });
+  }
+  
+  console.log('Templates copied successfully.');
+}
+
+copyTemplates().catch(err => {
+  console.error(err);
+  process.exit(1);
+});

packages/tools/create/src/bin.ts

@@ -13,7 +13,7 @@ program
   .name('create-objectql')
   .description('Scaffold a new ObjectQL project')
   .argument('[directory]', 'Directory to create the project in')
-  .option('-t, --template <name>', 'Template to use (hello-world, starter)', 'starter')
+  .option('-t, --template <name>', 'Template to use (hello-world, starter)')
   .action(async (directory, options) => {
     console.log(chalk.bold.blue('⚡ ObjectStack AI - Project Scaffolder'));
 
@@ -33,14 +33,23 @@ program
     // 2. Resolve Template Source (Embedded)
     // The templates are located in ../templates relative to the dist/bin.js file
     // dist/bin.js -> ../templates -> package-root/templates
-    // Map 'project-tracker' to 'starter' if needed, or rely on correct copying
     let templateName = options.template;
-    if (templateName === 'basic') templateName = 'starter';
-    // If user says "starter", we expect "project-tracker" to be copied to "starter" folder, OR we adjust here.
-    // Let's assume we copy "project-tracker" to "starter" in build script.
+
+    if (!templateName) {
+      const response = await prompt<{ template: string }>({
+        type: 'select',
+        name: 'template',
+        message: 'Select a starter template:',
+        choices: [
+          { message: 'Standard Project (Recommended)', name: 'starter' },
+          { message: 'Minimal (Hello World)', name: 'hello-world' }
+        ]
+      });
+      templateName = response.template;
+    }
 
-    // Fallback mapping if build script copies to original names
-    if (templateName === 'starter') templateName = 'project-tracker';
+    // Legacy mapping or aliasing if needed
+    if (templateName === 'project-tracker') templateName = 'starter';
 
     const templatePath = path.resolve(__dirname, '../templates', templateName);