nodebbs 0.0.3 → 0.0.4

package/README.md

@@ -1,6 +1,6 @@
 # NodeBBS CLI
 
-> 全栈友好的 NodeBBS 部署和管理命令行工具
+> NodeBBS 论坛系统专业运维工具
 
 [![oclif](https://img.shields.io/badge/cli-oclif-brightgreen.svg)](https://oclif.io)
 [![Version](https://img.shields.io/npm/v/nodebbs.svg)](https://npmjs.org/package/nodebbs)
@@ -11,7 +11,8 @@ NodeBBS CLI 是一个专为全栈开发者设计的命令行工具，用于简
 
 ### 特性
 
-- 🚀 **快速启动** - 一键启动开发环境
+- �️ **交互式菜单** - 支持键盘导航的可视化命令选择（新增）
+- �🚀 **快速启动** - 一键启动开发环境
 - 🎯 **全栈友好** - 命令设计贴近开发者思维
 - 🔧 **服务级控制** - 可以单独管理每个服务
 - 📊 **实时日志** - 方便查看各服务日志
@@ -32,9 +33,13 @@ pnpm add -g nodebbs
 yarn global add nodebbs
 ```
 
-或者直接使用 npx（无需安装）：
+或者直接使用 npx（推荐）：
 
 ```bash
+# 进入交互式菜单（推荐）
+npx nodebbs
+
+# 运行特定命令
 npx nodebbs [command]
 ```
 
@@ -66,10 +71,10 @@ npx nodebbs status
 ## 📚 命令参考
 
 #### `nodebbs start`
-启动 NodeBBS 服务
+开始部署
 
 ```bash
-# 交互式启动（推荐初次使用）
+# 交互式启动
 npx nodebbs start
 
 # 指定环境启动
@@ -105,7 +110,7 @@ npx nodebbs restart -e production
 ```bash
 npx nodebbs stop
 npx nodebbs stop -e production
-```
+
 # 停止服务并删除数据卷（危险！）
 npx nodebbs stop --volumes
 npx nodebbs stop -v
@@ -198,12 +203,7 @@ npx nodebbs shell:redis
 
 ### 数据库管理
 
-#### `nodebbs db`
-打开数据库管理界面（Drizzle Studio）
 
-```bash
-npx nodebbs db
-```
 
 #### `nodebbs db:generate`
 生成数据库迁移文件
@@ -290,8 +290,7 @@ npx nodebbs logs:api
 # 进入 API 容器调试
 npx nodebbs shell:api
 
-# 打开数据库管理
-npx nodebbs db
+
 
 # 重置测试数据
 npx nodebbs db:reset
@@ -329,8 +328,7 @@ npx nodebbs db:migrate
 ### 场景 5：数据库操作
 
 ```bash
-# 打开数据库管理界面
-npx nodebbs db
+
 
 # 运行迁移
 npx nodebbs db:migrate
@@ -357,7 +355,7 @@ npx nodebbs shell:db
 | `make logs` | `npx nodebbs logs` |
 | `make logs-api` | `npx nodebbs logs:api` |
 | `make exec-api` | `npx nodebbs shell:api` |
-| `make db-studio` | `npx nodebbs db` |
+
 | `make clean-all` | `npx nodebbs stop --volumes` |
 
 ## ⚙️ 环境配置
@@ -393,6 +391,16 @@ CORS_ORIGIN=*
 
 > **提示**：可以使用 `openssl rand -hex 32` 命令生成安全的随机密钥。
 
+### 环境持久化
+
+CLI 会自动记住您上次启动的环境：
+
+1. 当您运行 `nodebbs start` 并选择环境（如 `production`）后，CLI 会在当前目录创建 `.nodebbs-env` 文件记录该选择。
+2. 后续运行 `nodebbs logs`, `nodebbs status` 等命令时，会自动使用该环境，无需再次指定 `-e production`。
+3. 运行 `nodebbs stop` 成功停止服务后，会自动删除 `.nodebbs-env` 文件。
+
+**注意**：如果您需要临时操作其他环境，仍然可以使用 `-e` 参数强制指定，例如 `nodebbs logs -e basic`。
+
 ## 🛠️ 高级用法
 
 ### 内置模板

package/bin/dev.js

@@ -2,4 +2,9 @@
 
 import {execute} from '@oclif/core'
 
-await execute({development: true, dir: import.meta.url})
+if (process.argv.length <= 2) {
+  const {runInteractive} = await import('../src/interactive.ts')
+  await runInteractive(import.meta.url)
+} else {
+  await execute({development: true, dir: import.meta.url})
+}

package/bin/run.js

@@ -2,4 +2,9 @@
 
 import {execute} from '@oclif/core'
 
-await execute({dir: import.meta.url})
+if (process.argv.length <= 2) {
+  const {runInteractive} = await import('../dist/interactive.js')
+  await runInteractive(import.meta.url)
+} else {
+  await execute({dir: import.meta.url})
+}

package/dist/commands/clean/index.js

@@ -27,7 +27,7 @@ export default class Clean extends Command {
     async run() {
         const { flags } = await this.parse(Clean);
         let targets = [];
-        // Determine targets from flags
+        // 根据标志确定清理目标
         if (flags.all) {
             targets = ['cache', 'images', 'networks'];
         }
@@ -37,7 +37,7 @@ export default class Clean extends Command {
             if (flags.images)
                 targets.push('images');
         }
-        // Interactive selection if no flags
+        // 如果未提供标志，进行交互式选择
         if (targets.length === 0) {
             targets = await checkbox({
                 message: '请选择要清理的项目：',
@@ -52,7 +52,7 @@ export default class Clean extends Command {
             logger.info('未选择任何清理项目。');
             return;
         }
-        // Confirmation
+        // 确认提示
         if (!flags.force) {
             logger.warning(`即将清理: ${targets.join(', ')}`);
             const confirmed = await confirm({
@@ -64,7 +64,7 @@ export default class Clean extends Command {
                 return;
             }
         }
-        // Execute
+        // 执行清理
         try {
             if (targets.includes('cache')) {
                 logger.info('正在清理构建缓存...');

package/dist/commands/db/backup.js

@@ -17,33 +17,33 @@ export default class DbBackup extends Command {
     };
     async run() {
         const { flags } = await this.parse(DbBackup);
-        // 1. Select Environment
+        // 1. 选择环境
         const env = await selectEnvironment(flags.env);
-        // 2. Determine Output File
+        // 2. 确定输出文件
         let outputFile = flags.output;
         if (!outputFile) {
             const timestamp = new Date().toISOString().replace(/[:.]/g, '-').slice(0, 19);
             outputFile = `backup_${timestamp}.sql`;
         }
-        // Ensure absolute path
+        // 确保绝对路径
         const outputPath = path.resolve(process.cwd(), outputFile);
-        // 3. Get Compose Files
+        // 3. 获取 Compose 文件
         const { files, isBuiltIn } = await getComposeFiles(env);
         logger.info(`正在备份数据库到: ${outputPath}`);
         logger.info('环境: ' + env);
-        // Load Env Config
+        // 加载环境配置
         const envConfig = dotenv.config().parsed || {};
         const dbUser = envConfig.POSTGRES_USER || 'postgres';
         const dbName = envConfig.POSTGRES_DB || 'nodebbs';
         const dbPassword = envConfig.POSTGRES_PASSWORD;
-        // 4. Construct Compose Args
+        // 4. 构建 Compose 参数
         const composeArgs = files.flatMap(f => ['-f', f]);
         if (isBuiltIn) {
             composeArgs.push('--project-directory', process.cwd());
         }
-        // 5. Run pg_dump
+        // 5. 运行 pg_dump
         const dumpArgs = [...composeArgs, 'exec', '-T'];
-        // Inject password if available
+        // 如果有密码则注入
         if (dbPassword) {
             dumpArgs.push('-e', `PGPASSWORD=${dbPassword}`);
         }
@@ -54,7 +54,7 @@ export default class DbBackup extends Command {
                 subprocess.stdout.pipe(fs.createWriteStream(outputPath));
             }
             await subprocess;
-            // check file size
+            // 检查文件大小
             const stats = fs.statSync(outputPath);
             if (stats.size === 0) {
                 logger.error('备份文件为空，备份可能失败。');
@@ -68,7 +68,7 @@ export default class DbBackup extends Command {
             if (error instanceof Error) {
                 logger.error(error.message);
             }
-            // Cleanup empty file if failed
+            // 如果失败则清理空文件
             if (fs.existsSync(outputPath) && fs.statSync(outputPath).size === 0) {
                 fs.unlinkSync(outputPath);
             }

package/dist/commands/rebuild/index.d.ts

@@ -0,0 +1,6 @@
+import { Command } from '@oclif/core';
+export default class Rebuild extends Command {
+    static description: string;
+    static strict: boolean;
+    run(): Promise<void>;
+}

package/dist/commands/rebuild/index.js

@@ -0,0 +1,11 @@
+import { Command } from '@oclif/core';
+import Start from '../start/index.js';
+export default class Rebuild extends Command {
+    static description = '重新构建并启动服务 (start --build)';
+    // Allow passing flags like -e to the underlying start command
+    static strict = false;
+    async run() {
+        // Invoke Start command with --build flag and any other arguments
+        await Start.run(['--build', ...this.argv]);
+    }
+}

package/dist/commands/restart/index.js

@@ -9,7 +9,7 @@ export default class Restart extends Command {
     };
     async run() {
         const { flags } = await this.parse(Restart);
-        // 1. Select Environment
+        // 1. 选择环境
         const env = await selectEnvironment(flags.env);
         const { files, isBuiltIn } = await getComposeFiles(env);
         logger.info('正在重启服务...');

package/dist/commands/start/index.js

@@ -4,9 +4,9 @@ import { checkDocker, runCompose, waitForHealth, execCompose, getComposeFiles }
 import { initEnv, checkEnv } from '../../utils/env.js';
 import { logger } from '../../utils/logger.js';
 import dotenv from 'dotenv';
-import { EnvFlag, selectEnvironment } from '../../utils/selection.js';
+import { EnvFlag, selectEnvironment, setStoredEnv } from '../../utils/selection.js';
 export default class Start extends Command {
-    static description = '启动 NodeBBS (部署模式)';
+    static description = '开始部署';
     static flags = {
         env: EnvFlag,
         build: Flags.boolean({
@@ -23,9 +23,10 @@ export default class Start extends Command {
         else {
             logger.header('NodeBBS Docker 部署');
         }
-        // 1. Select Environment
+        // 1. 选择环境
         const env = await selectEnvironment(flags.env);
-        // 2. Get Compose Files
+        await setStoredEnv(env);
+        // 2. 获取 Compose 文件
         const { files: composeFiles, isBuiltIn } = await getComposeFiles(env);
         if (isBuiltIn) {
             logger.info('使用内置 Docker Compose 模板...');
@@ -45,9 +46,9 @@ export default class Start extends Command {
                 logger.warning('注意：无资源限制，不推荐用于生产环境。');
             }
         }
-        // 3. Check Docker & Env
+        // 3. 检查 Docker 和环境变量
         await checkDocker();
-        // initEnv guarantees .env exists (or exits)
+        // initEnv 保证 .env 存在（或退出）
         await initEnv();
         await checkEnv(env);
         if (!flags.build) {
@@ -60,7 +61,7 @@ export default class Start extends Command {
                 this.exit(0);
             }
         }
-        // 4. Build & Start Services
+        // 4. 构建并启动服务
         if (flags.build) {
             logger.info('正在重新构建并启动服务...');
             await runCompose(composeFiles, ['up', '-d', '--build'], isBuiltIn);
@@ -74,7 +75,7 @@ export default class Start extends Command {
             await runCompose(composeFiles, ['up', '-d'], isBuiltIn);
             logger.success('服务启动指令已发送');
         }
-        // 5. Post-Start Actions (Full Deploy only)
+        // 5. 启动后操作 (仅完整部署)
         if (!flags.build) {
             await waitForHealth(composeFiles, isBuiltIn);
             const pushDb = await confirm({
@@ -97,7 +98,7 @@ export default class Start extends Command {
             }
         }
         logger.header(flags.build ? '启动成功！' : 'NodeBBS 启动成功！');
-        // 6. Show Info
+        // 6. 显示信息
         logger.info(`环境: ${env}`);
         const envConfig = dotenv.config().parsed || {};
         const webPort = envConfig.WEB_PORT || '3100';

package/dist/commands/stop/index.js

@@ -2,7 +2,7 @@ import { Command, Flags } from '@oclif/core';
 import { runCompose, getComposeFiles } from '../../utils/docker.js';
 import { logger } from '../../utils/logger.js';
 import { confirm } from '@inquirer/prompts';
-import { EnvFlag, selectEnvironment } from '../../utils/selection.js';
+import { EnvFlag, selectEnvironment, clearStoredEnv } from '../../utils/selection.js';
 export default class Stop extends Command {
     static description = '停止服务';
     static flags = {
@@ -15,7 +15,7 @@ export default class Stop extends Command {
     };
     async run() {
         const { flags } = await this.parse(Stop);
-        // 1. Select Environment
+        // 1. 选择环境
         const env = await selectEnvironment(flags.env, {
             prompt: '请选择运行环境(停止服务需匹配启动环境)：'
         });
@@ -32,11 +32,13 @@ export default class Stop extends Command {
             }
             logger.info('正在停止服务并删除数据卷...');
             await runCompose(files, ['down', '-v'], isBuiltIn);
+            await clearStoredEnv();
             logger.success('服务已停止，数据卷已删除');
         }
         else {
             logger.info('正在停止服务...');
             await runCompose(files, ['down'], isBuiltIn);
+            await clearStoredEnv();
             logger.success('服务已停止');
         }
     }

package/dist/interactive.d.ts

@@ -0,0 +1 @@
+export declare function runInteractive(root: string): Promise<void>;

package/dist/interactive.js

@@ -0,0 +1,171 @@
+import { Config } from '@oclif/core';
+import { select, Separator } from '@inquirer/prompts';
+import { fileURLToPath } from 'url';
+export async function runInteractive(root) {
+    // Config.load 需要文件路径而不是 URL
+    // 如果 root 是 import.meta.url，则进行转换
+    let rootPath = root.startsWith('file://') ? fileURLToPath(root) : root;
+    const config = await Config.load(rootPath);
+    // 构建命令树
+    const tree = { name: 'root', children: {} };
+    for (const cmd of config.commands) {
+        // 跳过隐藏命令
+        if (cmd.hidden)
+            continue;
+        const parts = cmd.id.split(':');
+        let currentNode = tree;
+        for (let i = 0; i < parts.length; i++) {
+            const part = parts[i];
+            if (!currentNode.children[part]) {
+                currentNode.children[part] = {
+                    name: part,
+                    children: {}
+                };
+            }
+            currentNode = currentNode.children[part];
+        }
+        // 将命令分配给叶节点
+        currentNode.command = cmd;
+    }
+    await navigate(tree, [], config);
+}
+async function navigate(node, breadcrumbs, config) {
+    const priorityOrder = ['start', 'rebuild', 'stop', 'restart', 'status', 'logs', 'shell', 'db'];
+    while (true) {
+        const keys = Object.keys(node.children).sort((a, b) => {
+            const indexA = priorityOrder.indexOf(a);
+            const indexB = priorityOrder.indexOf(b);
+            // If both are in priority list, sort by index
+            if (indexA !== -1 && indexB !== -1)
+                return indexA - indexB;
+            // If only A is in priority list, A comes first
+            if (indexA !== -1)
+                return -1;
+            // If only B is in priority list, B comes first
+            if (indexB !== -1)
+                return 1;
+            // Otherwise sort alphabetically
+            return a.localeCompare(b);
+        });
+        const choices = keys.map(key => {
+            const child = node.children[key];
+            const hasSubcommands = Object.keys(child.children).length > 0;
+            let label = key;
+            let description = '';
+            // 尝试获取命令描述
+            if (key === 'help') {
+                description = '显示帮助信息';
+            }
+            else if (child.command?.description) {
+                description = child.command.description;
+            }
+            // 或者获取主题描述
+            else if (hasSubcommands) {
+                const fullId = [...breadcrumbs, key].join(':');
+                const topic = config.topics.find(t => t.name === fullId);
+                if (topic) {
+                    description = topic.description || '';
+                }
+            }
+            if (description) {
+                const shortDesc = description.split('.')[0].substring(0, 50);
+                label = `${key.padEnd(12)}  ${shortDesc}`;
+            }
+            else {
+                label = key.padEnd(12);
+            }
+            if (hasSubcommands) {
+                label = `${label}  [+]`;
+            }
+            return {
+                name: label,
+                value: key,
+                short: key
+            };
+        });
+        // 添加导航选项
+        // 即使支持 Esc，保留显式选项也有助于发现性
+        if (breadcrumbs.length > 0) {
+            choices.push(new Separator());
+            choices.push({ name: '⬅️  返回', value: '__BACK__', short: '返回' });
+        }
+        choices.push({ name: '❌ 退出', value: '__EXIT__', short: '退出' });
+        const controller = new AbortController();
+        // 监听 Esc 键
+        const onKeypress = (_str, key) => {
+            if (key && key.name === 'escape') {
+                controller.abort();
+            }
+        };
+        // 确保 keypress 事件被触发（inquirer 内部也会这样做，但为了安全起见）
+        // 注意：process.stdin 可能已经是 raw mode，inquirer 会处理它
+        // 我们只需要监听
+        process.stdin.on('keypress', onKeypress);
+        try {
+            const selection = await select({
+                message: breadcrumbs.length ? `选择命令 (${breadcrumbs.join(' > ')}):` : '选择命令:',
+                choices,
+                pageSize: 15,
+                loop: true, // 允许循环导航
+                // @ts-ignore: prompt signal support might be strict on types
+                signal: controller.signal
+            });
+            if (selection === '__EXIT__') {
+                process.exit(0);
+            }
+            if (selection === '__BACK__') {
+                return;
+            }
+            const selectedNode = node.children[selection];
+            if (Object.keys(selectedNode.children).length > 0) {
+                // 有子命令，进入子菜单
+                await navigate(selectedNode, [...breadcrumbs, selection], config);
+            }
+            else if (selectedNode.command) {
+                // 可运行的命令
+                console.log(`正在运行: ${selectedNode.command.id}`);
+                try {
+                    await config.runCommand(selectedNode.command.id);
+                }
+                catch (error) {
+                    // Ctrl+C: 退出程序
+                    if (error.name === 'ExitPromptError') {
+                        console.log('\n用户退出。');
+                        process.exit(0);
+                    }
+                    // 手动取消: 返回菜单
+                    if (error.name === 'CancelError') {
+                        console.log('\n操作已取消。');
+                        continue;
+                    }
+                    console.error(error);
+                }
+                console.log('\n命令执行完成。');
+                // 动态导入 input 以保持轻量
+                const { input } = await import('@inquirer/prompts');
+                await input({ message: '按回车键继续...' });
+            }
+        }
+        catch (error) {
+            // 处理 AbortError (Esc)
+            if (error.name === 'AbortError' || error.message?.includes('aborted')) {
+                if (breadcrumbs.length > 0) {
+                    // 子菜单 -> 返回
+                    return;
+                }
+                else {
+                    // 顶级菜单 -> 退出
+                    process.exit(0);
+                }
+            }
+            // 处理 Ctrl+C (ExitPromptError)
+            if (error.name === 'ExitPromptError') {
+                process.exit(0);
+            }
+            throw error;
+        }
+        finally {
+            process.stdin.off('keypress', onKeypress);
+        }
+    }
+}

package/dist/utils/docker.js

@@ -8,11 +8,11 @@ const fileExists = promisify(exists);
 export async function getComposeFiles(env) {
     const workDir = process.cwd();
     let isBuiltIn = false;
-    // Check current directory for docker-compose.yml
+    // 检查当前目录是否存在 docker-compose.yml
     let baseFile = path.join(workDir, 'docker-compose.yml');
     let templateDir = workDir;
     if (!await fileExists(baseFile)) {
-        // Use built-in templates
+        // 使用内置模板
         isBuiltIn = true;
         templateDir = getTemplateDir();
         baseFile = getTemplatePath('docker-compose.yml');
@@ -42,12 +42,12 @@ export async function runCompose(files, args, isBuiltIn = false) {
     const composeArgs = files.flatMap(f => ['-f', f]);
     if (isBuiltIn) {
         composeArgs.push('--project-directory', process.cwd());
-        // Set INIT_DB_PATH to the built-in sql file
+        // 将 INIT_DB_PATH 设置为内置 sql 文件
         const templateDir = path.dirname(files[0]);
         process.env.INIT_DB_PATH = path.join(templateDir, 'init-db.sql');
     }
     composeArgs.push(...args);
-    // Use stdio: 'inherit' to show output in real-time
+    // 使用 stdio: 'inherit' 实时显示输出
     await execa('docker', ['compose', ...composeArgs], { stdio: 'inherit' });
 }
 export async function execCompose(files, service, command, isBuiltIn = false) {
@@ -60,7 +60,7 @@ export async function execCompose(files, service, command, isBuiltIn = false) {
 }
 export async function waitForHealth(files, isBuiltIn = false) {
     logger.info('正在等待服务就绪...');
-    // Wait for Postgres
+    // 等待 Postgres
     logger.info('等待 PostgreSQL...');
     const composeArgs = files.flatMap(f => ['-f', f]);
     if (isBuiltIn) {
@@ -82,11 +82,11 @@ export async function waitForHealth(files, isBuiltIn = false) {
     if (retries === 0) {
         logger.warning('PostgreSQL 可能尚未就绪');
     }
-    // Wait for Redis
+    // 等待 Redis
     logger.info('等待 Redis...');
     await new Promise(resolve => setTimeout(resolve, 5000));
     logger.success('Redis 已就绪');
-    // Wait for API
+    // 等待 API
     logger.info('等待 API 服务...');
     await new Promise(resolve => setTimeout(resolve, 10000));
     logger.success('API 服务已就绪');

package/dist/utils/env.js

@@ -18,7 +18,7 @@ export async function initEnv() {
         sourceFile = '.env.docker.example';
     }
     else {
-        // Use built-in template
+        // 使用内置模板
         sourceFile = getTemplatePath('env');
         isBuiltIn = true;
     }
@@ -49,7 +49,7 @@ export async function initEnv() {
 }
 export async function checkEnv(envType) {
     logger.info('正在检查环境配置...');
-    // Load .env
+    // 加载 .env
     const envConfig = dotenv.config().parsed || {};
     let warnings = 0;
     let errors = 0;

package/dist/utils/selection.d.ts

@@ -1,5 +1,7 @@
 export type EnvType = 'production' | 'lowmem' | 'basic';
 export declare const EnvFlag: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+export declare function setStoredEnv(env: EnvType): Promise<void>;
+export declare function clearStoredEnv(): Promise<void>;
 export declare function selectEnvironment(env?: string, options?: {
     prompt?: string;
 }): Promise<EnvType>;

package/dist/utils/selection.js

@@ -1,24 +1,68 @@
 import { Flags } from '@oclif/core';
 import { select } from '@inquirer/prompts';
 import { logger } from './logger.js';
+import fs from 'node:fs/promises';
+import path from 'node:path';
+const ENV_MARKER_FILE = '.nodebbs-env';
 export const EnvFlag = Flags.string({
     char: 'e',
     description: '部署环境 (production, lowmem, basic)',
     options: ['production', 'lowmem', 'basic'],
 });
+async function getStoredEnv() {
+    try {
+        const content = await fs.readFile(path.resolve(process.cwd(), ENV_MARKER_FILE), 'utf-8');
+        const env = content.trim();
+        if (['production', 'lowmem', 'basic'].includes(env)) {
+            return env;
+        }
+    }
+    catch { }
+    return null;
+}
+export async function setStoredEnv(env) {
+    try {
+        await fs.writeFile(path.resolve(process.cwd(), ENV_MARKER_FILE), env, 'utf-8');
+    }
+    catch (error) {
+        logger.warning(`无法保存环境标记: ${error}`);
+    }
+}
+export async function clearStoredEnv() {
+    try {
+        const filepath = path.resolve(process.cwd(), ENV_MARKER_FILE);
+        await fs.rm(filepath, { force: true });
+    }
+    catch (error) {
+        logger.warning(`无法清除环境标记: ${error}`);
+    }
+}
 export async function selectEnvironment(env, options = {}) {
     if (env) {
-        // oclif options validation handles valid values, but type casting is needed
+        // oclif 选项验证会处理有效值，但仍需类型转换
         return env;
     }
+    // 检查已存储的环境配置
+    const storedEnv = await getStoredEnv();
+    if (storedEnv) {
+        logger.info(`检测到运行环境: ${storedEnv}`);
+        return storedEnv;
+    }
     const selected = await select({
         message: options.prompt || '请选择运行环境：',
         choices: [
             { name: '标准生产环境 (2C4G+) [推荐]', value: 'production' },
             { name: '低配环境 (1C1G/1C2G)', value: 'lowmem' },
             { name: '基础环境 (仅用于测试)', value: 'basic' },
+            { name: '❌ 取消', value: '__CANCEL__' },
         ],
+        loop: true,
     });
+    if (selected === '__CANCEL__') {
+        const error = new Error('用户取消操作');
+        error.name = 'CancelError';
+        throw error;
+    }
     logger.info(`已选择环境: ${selected}`);
     return selected;
 }

package/dist/utils/template.d.ts

@@ -1,11 +1,11 @@
 /**
- * Get the absolute path to the templates directory.
- * In production (dist/utils), templates are in dist/templates.
- * In development (src/utils), templates are in src/templates.
+ * 获取模板目录的绝对路径。
+ * 在生产环境 (dist/utils) 中，模板位于 dist/templates。
+ * 在开发环境 (src/utils) 中，模板位于 src/templates。
  */
 export declare function getTemplateDir(): string;
 /**
- * Get the absolute path to a specific template file.
- * @param fileName The name of the template file (e.g., 'env', 'docker-compose.yml')
+ * 获取特定模板文件的绝对路径。
+ * @param fileName 模板文件名称 (例如 'env', 'docker-compose.yml')
  */
 export declare function getTemplatePath(fileName: string): string;

package/dist/utils/template.js

@@ -2,16 +2,16 @@ import path from 'node:path';
 import { fileURLToPath } from 'node:url';
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
 /**
- * Get the absolute path to the templates directory.
- * In production (dist/utils), templates are in dist/templates.
- * In development (src/utils), templates are in src/templates.
+ * 获取模板目录的绝对路径。
+ * 在生产环境 (dist/utils) 中，模板位于 dist/templates。
+ * 在开发环境 (src/utils) 中，模板位于 src/templates。
  */
 export function getTemplateDir() {
     return path.join(__dirname, '..', 'templates');
 }
 /**
- * Get the absolute path to a specific template file.
- * @param fileName The name of the template file (e.g., 'env', 'docker-compose.yml')
+ * 获取特定模板文件的绝对路径。
+ * @param fileName 模板文件名称 (例如 'env', 'docker-compose.yml')
  */
 export function getTemplatePath(fileName) {
     return path.join(getTemplateDir(), fileName);

package/oclif.manifest.json

@@ -126,41 +126,6 @@
         "generate.js"
       ]
     },
-    "db": {
-      "aliases": [],
-      "args": {},
-      "description": "数据库管理命令",
-      "flags": {
-        "env": {
-          "char": "e",
-          "description": "部署环境 (production, lowmem, basic)",
-          "name": "env",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "production",
-            "lowmem",
-            "basic"
-          ],
-          "type": "option"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "db",
-      "pluginAlias": "nodebbs",
-      "pluginName": "nodebbs",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "db",
-        "index.js"
-      ]
-    },
     "db:migrate": {
       "aliases": [],
       "args": {},
@@ -476,6 +441,27 @@
         "web.js"
       ]
     },
+    "rebuild": {
+      "aliases": [],
+      "args": {},
+      "description": "重新构建并启动服务 (start --build)",
+      "flags": {},
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "rebuild",
+      "pluginAlias": "nodebbs",
+      "pluginName": "nodebbs",
+      "pluginType": "core",
+      "strict": false,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "rebuild",
+        "index.js"
+      ]
+    },
     "restart": {
       "aliases": [],
       "args": {},
@@ -511,10 +497,10 @@
         "index.js"
       ]
     },
-    "shell:api": {
+    "start": {
       "aliases": [],
       "args": {},
-      "description": "进入 API 服务 shell",
+      "description": "开始部署",
       "flags": {
         "env": {
           "char": "e",
@@ -528,11 +514,18 @@
             "basic"
           ],
           "type": "option"
+        },
+        "build": {
+          "char": "b",
+          "description": "重新构建并启动服务 (跳过健康检查和数据初始化)",
+          "name": "build",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "shell:api",
+      "id": "start",
       "pluginAlias": "nodebbs",
       "pluginName": "nodebbs",
       "pluginType": "core",
@@ -542,14 +535,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "shell",
-        "api.js"
+        "start",
+        "index.js"
       ]
     },
-    "shell:db": {
+    "shell:api": {
       "aliases": [],
       "args": {},
-      "description": "进入数据库 shell (psql)",
+      "description": "进入 API 服务 shell",
       "flags": {
         "env": {
           "char": "e",
@@ -567,7 +560,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "shell:db",
+      "id": "shell:api",
       "pluginAlias": "nodebbs",
       "pluginName": "nodebbs",
       "pluginType": "core",
@@ -578,13 +571,13 @@
         "dist",
         "commands",
         "shell",
-        "db.js"
+        "api.js"
       ]
     },
-    "shell:redis": {
+    "shell:db": {
       "aliases": [],
       "args": {},
-      "description": "进入 Redis shell (redis-cli)",
+      "description": "进入数据库 shell (psql)",
       "flags": {
         "env": {
           "char": "e",
@@ -602,7 +595,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "shell:redis",
+      "id": "shell:db",
       "pluginAlias": "nodebbs",
       "pluginName": "nodebbs",
       "pluginType": "core",
@@ -613,13 +606,13 @@
         "dist",
         "commands",
         "shell",
-        "redis.js"
+        "db.js"
       ]
     },
-    "shell:web": {
+    "shell:redis": {
       "aliases": [],
       "args": {},
-      "description": "进入 Web 前端 shell",
+      "description": "进入 Redis shell (redis-cli)",
       "flags": {
         "env": {
           "char": "e",
@@ -637,7 +630,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "shell:web",
+      "id": "shell:redis",
       "pluginAlias": "nodebbs",
       "pluginName": "nodebbs",
       "pluginType": "core",
@@ -648,13 +641,13 @@
         "dist",
         "commands",
         "shell",
-        "web.js"
+        "redis.js"
       ]
     },
-    "start": {
+    "shell:web": {
       "aliases": [],
       "args": {},
-      "description": "启动 NodeBBS (部署模式)",
+      "description": "进入 Web 前端 shell",
       "flags": {
         "env": {
           "char": "e",
@@ -668,18 +661,11 @@
             "basic"
           ],
           "type": "option"
-        },
-        "build": {
-          "char": "b",
-          "description": "重新构建并启动服务 (跳过健康检查和数据初始化)",
-          "name": "build",
-          "allowNo": false,
-          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "start",
+      "id": "shell:web",
       "pluginAlias": "nodebbs",
       "pluginName": "nodebbs",
       "pluginType": "core",
@@ -689,8 +675,8 @@
       "relativePath": [
         "dist",
         "commands",
-        "start",
-        "index.js"
+        "shell",
+        "web.js"
       ]
     },
     "status": {
@@ -771,5 +757,5 @@
       ]
     }
   },
-  "version": "0.0.3"
+  "version": "0.0.4"
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "nodebbs",
-  "description": "A new CLI generated with oclif",
-  "version": "0.0.3",
+  "description": "NodeBBS 论坛系统专业运维工具",
+  "version": "0.0.4",
   "author": "wengqianshan",
   "bin": {
     "nodebbs": "./bin/run.js"
@@ -54,13 +54,18 @@
     "dirname": "nodebbs",
     "commands": "./dist/commands",
     "plugins": [
-      "@oclif/plugin-help",
-      "@oclif/plugin-plugins"
+      "@oclif/plugin-help"
     ],
     "topicSeparator": " ",
     "topics": {
       "hello": {
-        "description": "Say hello to the world and others"
+        "description": "向世界和他人问好"
+      },
+      "db": {
+        "description": "数据库操作 (备份, 迁移, 种子数据等)"
+      },
+      "shell": {
+        "description": "服务的交互式 Shell"
       }
     }
   },

package/dist/commands/db/index.d.ts

@@ -1,8 +0,0 @@
-import { Command } from '@oclif/core';
-export default class Db extends Command {
-    static description: string;
-    static flags: {
-        env: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
-    };
-    run(): Promise<void>;
-}

package/dist/commands/db/index.js

@@ -1,17 +0,0 @@
-import { Command } from '@oclif/core';
-import { execCompose, getComposeFiles } from '../../utils/docker.js';
-import { logger } from '../../utils/logger.js';
-import { EnvFlag, selectEnvironment } from '../../utils/selection.js';
-export default class Db extends Command {
-    static description = '数据库管理命令';
-    static flags = {
-        env: EnvFlag,
-    };
-    async run() {
-        const { flags } = await this.parse(Db);
-        const env = await selectEnvironment(flags.env);
-        const { files, isBuiltIn } = await getComposeFiles(env);
-        logger.info('正在进入数据库 shell...');
-        await execCompose(files, 'api', ['npm', 'run', 'db:studio'], isBuiltIn);
-    }
-}