nodebbs 0.0.3 → 0.0.5

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
@@ -342,23 +340,7 @@ npx nodebbs db:seed
 npx nodebbs shell:db
 ```
 
-## 🔄 从 Makefile 迁移
-
-如果你之前使用 Makefile，这里是命令对照表：
 
-| Makefile 命令 | NodeBBS CLI 命令 |
-|--------------|-----------------|
-| `make up` | `npx nodebbs start` |
-| `make build` | `npx nodebbs start --build` |
-| `make rebuild` | `npx nodebbs start --build` |
-| `ENV=prod make rebuild` | `npx nodebbs start -e production --build` |
-| `make down` | `npx nodebbs stop` |
-| `make ps` | `npx nodebbs status` |
-| `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 +375,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/pack/index.d.ts

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

package/dist/commands/pack/index.js

@@ -0,0 +1,150 @@
+import { Command, Flags } from '@oclif/core';
+import { execa } from 'execa';
+import * as fs from 'fs';
+import * as path from 'path';
+import * as os from 'os';
+import { getTemplatePath } from '../../utils/template.js';
+export default class Pack extends Command {
+    static description = '生成离线部署包';
+    static flags = {
+        output: Flags.string({ char: 'o', description: '输出文件名', default: 'nodebbs-offline.tar.gz' }),
+    };
+    async run() {
+        const { flags } = await this.parse(Pack);
+        const outputPath = path.resolve(flags.output);
+        // 检查 docker 是否可用
+        try {
+            await execa('docker', ['--version']);
+        }
+        catch {
+            this.error('无法执行 docker 命令，请确保 Docker 已安装并运行。');
+        }
+        // 1. 准备临时目录
+        const tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), 'nodebbs-pack-'));
+        this.log(`正在准备构建环境: ${tmpDir}`);
+        try {
+            // 2. 导出配置文件
+            // 这里我们需要获取当前的 docker-compose.yml 和 prod 配置
+            // 假设用户当前目录下有这些文件，或者我们就用内置模板？
+            // 更好的方式是：如果在当前目录找到了配置文件，就用当前的；否则用内置模板。
+            // 但既然是打包，通常是想把当前开发好的代码打包。
+            // 所以我们假设在项目根目录运行。
+            if (!fs.existsSync('docker-compose.yml')) {
+                this.warn('当前目录未找到 docker-compose.yml，将使用内置模板。');
+                // TODO: 从 templates 复制 (简化起见，我们假设用户在项目根目录，或者我们强制要求)
+                // 如果没找到，我们实际上无法 build api/web，因为 build context 需要源码。
+                // 所以必须要求在项目根目录运行。
+                this.error('请在 NodeBBS 项目根目录下运行此命令 (需要包含 docker-compose.yml 和源代码)。');
+            }
+            // 3. 构建镜像
+            this.log('正在构建应用镜像 (这可能通过需要几分钟)...');
+            await execa('docker', ['compose', 'build'], { stdio: 'inherit' });
+            // 4. 拉取依赖镜像
+            this.log('正在确保数据库镜像已下载...');
+            await execa('docker', ['pull', 'postgres:16-alpine'], { stdio: 'inherit' });
+            await execa('docker', ['pull', 'redis:7-alpine'], { stdio: 'inherit' });
+            // 5. 导出镜像
+            this.log('正在导出镜像到文件 (nodebbs-images.tar)...');
+            // 获取实际的镜像名，这里假设 docker-compose build 生成的镜像名符合预期
+            // 通常是 <dir>_api 和 <dir>_web，或者我们在 compose 文件里指定了 image name?
+            // 查看 template: 没有指定 image name，所以默认为 ${dirname}-api。
+            // 为了确保准确，我们可以解析 docker compose config 的输出，或者强制指定 image name。
+            // 更稳妥的方式：直接 save 指定的服务镜像。
+            // docker compose images -q 可以获取 ID。
+            // 获取所有相关镜像的列表
+            const projectName = path.basename(process.cwd()).toLowerCase().replace(/[^a-z0-9]/g, '');
+            const images = [
+                'postgres:16-alpine',
+                'redis:7-alpine',
+                `${projectName}-api`, // 默认命名规则
+                `${projectName}-web`
+            ];
+            // 我们最好通过 docker compose config 来确认镜像名，但这比较复杂。
+            // 简单策略：先 save postgres 和 redis，对于 api 和 web，我们先 tag 一下以确保名字固定。
+            await execa('docker', ['tag', `${projectName}-api`, 'nodebbs-api:latest']);
+            await execa('docker', ['tag', `${projectName}-web`, 'nodebbs-web:latest']);
+            const imagesToSave = ['postgres:16-alpine', 'redis:7-alpine', 'nodebbs-api:latest', 'nodebbs-web:latest'];
+            await execa('docker', ['save', '-o', path.join(tmpDir, 'nodebbs-images.tar'), ...imagesToSave], { stdio: 'inherit' });
+            // 6. 复制配置文件 (并进行修改)
+            // 读取 docker-compose.yml 并移除开发环境的源码挂载
+            // 这是一个关键步骤，因为在离线/生产环境中，我们不应该挂载 ./apps/xxx/src，
+            // 否则会覆盖掉镜像内构建好的代码，导致 "Cannot find module" 错误。
+            let composeContent = fs.readFileSync('docker-compose.yml', 'utf-8');
+            const lines = composeContent.split('\n');
+            const cleanedLines = lines.map(line => {
+                // 移除 api 和 web 的源码挂载
+                if (line.includes('./apps/api/src') || line.includes('./apps/web/src')) {
+                    return line.replace(/^/, '# [OFFLINE-PACK-REMOVED] ');
+                }
+                return line;
+            });
+            fs.writeFileSync(path.join(tmpDir, 'docker-compose.yml'), cleanedLines.join('\n'));
+            if (fs.existsSync('docker-compose.prod.yml')) {
+                fs.copyFileSync('docker-compose.prod.yml', path.join(tmpDir, 'docker-compose.prod.yml'));
+            }
+            if (fs.existsSync('.env')) {
+                this.warn('检测到 .env 文件，出于安全考虑，不会默认打包 .env 文件。请在部署时手动配置环境变量。');
+            }
+            // 创建 .env.example
+            // 创建 .env.example
+            const envTemplatePath = getTemplatePath('env');
+            let envExample = '';
+            try {
+                envExample = fs.readFileSync(envTemplatePath, 'utf-8');
+            }
+            catch (e) {
+                this.warn(`读取 env 模板失败: ${envTemplatePath}，将使用空模板`);
+            }
+            fs.writeFileSync(path.join(tmpDir, '.env.example'), envExample);
+            // 7. 创建安装脚本
+            const installScript = `#!/bin/bash
+echo "正在加载 Docker 镜像..."
+docker load -i nodebbs-images.tar
+
+echo "正在启动服务..."
+if [ ! -f .env ]; then
+    echo "警告: 未找到 .env 文件，将使用默认配置或报错。请先复制 .env.example 为 .env 并修改配置。"
+fi
+
+# 修改 image 名称以匹配 load 进来的 tag (如果 compose 文件里没写 image，它会尝试 build)
+# 为了避免 build，我们需要修改 docker-compose.yml 或者使用环境变量 override
+# 最简单的办法：我们在 install 脚本里，强制用 docker run 或者修改 compose 文件?
+# 这里的难点是 compose file 里写的是 build: .
+# 离线环境没法 build。
+# 解决方案：生成一个专门的 docker-compose.offline.yml
+
+cat > docker-compose.override.yml <<EOF
+services:
+  api:
+    build: !reset
+    image: nodebbs-api:latest
+  web:
+    build: !reset
+    image: nodebbs-web:latest
+EOF
+
+docker compose -f docker-compose.yml -f docker-compose.prod.yml -f docker-compose.override.yml up -d
+
+echo "部署完成！"
+`;
+            fs.writeFileSync(path.join(tmpDir, 'install.sh'), installScript);
+            fs.chmodSync(path.join(tmpDir, 'install.sh'), '755');
+            // 8. 打包最终的 tar.gz
+            this.log(`正在生成最终压缩包: ${outputPath}`);
+            await execa('tar', ['-czf', outputPath, '-C', tmpDir, '.']);
+            this.log(`\n🎉 离线包生成成功: ${outputPath}`);
+            this.log('使用方法:');
+            this.log('1. 将压缩包上传到服务器');
+            this.log('2. 解压: tar -xzf nodebbs-offline.tar.gz');
+            this.log('3. 配置 .env');
+            this.log('4. 运行: ./install.sh');
+        }
+        catch (error) {
+            this.error(`打包失败: ${error.message}`);
+        }
+        finally {
+            // 清理临时目录
+            fs.rmSync(tmpDir, { recursive: true, force: true });
+        }
+    }
+}

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', 'pack', '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,10 +126,10 @@
         "generate.js"
       ]
     },
-    "db": {
+    "db:migrate": {
       "aliases": [],
       "args": {},
-      "description": "数据库管理命令",
+      "description": "执行数据库迁移 (db:migrate)",
       "flags": {
         "env": {
           "char": "e",
@@ -147,7 +147,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "db",
+      "id": "db:migrate",
       "pluginAlias": "nodebbs",
       "pluginName": "nodebbs",
       "pluginType": "core",
@@ -158,13 +158,13 @@
         "dist",
         "commands",
         "db",
-        "index.js"
+        "migrate.js"
       ]
     },
-    "db:migrate": {
+    "db:push": {
       "aliases": [],
       "args": {},
-      "description": "执行数据库迁移 (db:migrate)",
+      "description": "推送数据库 schema (db:push)",
       "flags": {
         "env": {
           "char": "e",
@@ -182,7 +182,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "db:migrate",
+      "id": "db:push",
       "pluginAlias": "nodebbs",
       "pluginName": "nodebbs",
       "pluginType": "core",
@@ -193,13 +193,13 @@
         "dist",
         "commands",
         "db",
-        "migrate.js"
+        "push.js"
       ]
     },
-    "db:push": {
+    "db:reset": {
       "aliases": [],
       "args": {},
-      "description": "推送数据库 schema (db:push)",
+      "description": "重置数据库 (db:reset) - 危险操作！",
       "flags": {
         "env": {
           "char": "e",
@@ -217,7 +217,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "db:push",
+      "id": "db:reset",
       "pluginAlias": "nodebbs",
       "pluginName": "nodebbs",
       "pluginType": "core",
@@ -228,13 +228,13 @@
         "dist",
         "commands",
         "db",
-        "push.js"
+        "reset.js"
       ]
     },
-    "db:reset": {
+    "db:seed": {
       "aliases": [],
       "args": {},
-      "description": "重置数据库 (db:reset) - 危险操作！",
+      "description": "填充种子数据 (db:seed)",
       "flags": {
         "env": {
           "char": "e",
@@ -252,7 +252,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "db:reset",
+      "id": "db:seed",
       "pluginAlias": "nodebbs",
       "pluginName": "nodebbs",
       "pluginType": "core",
@@ -263,31 +263,27 @@
         "dist",
         "commands",
         "db",
-        "reset.js"
+        "seed.js"
       ]
     },
-    "db:seed": {
+    "pack": {
       "aliases": [],
       "args": {},
-      "description": "填充种子数据 (db:seed)",
+      "description": "生成离线部署包",
       "flags": {
-        "env": {
-          "char": "e",
-          "description": "部署环境 (production, lowmem, basic)",
-          "name": "env",
+        "output": {
+          "char": "o",
+          "description": "输出文件名",
+          "name": "output",
+          "default": "nodebbs-offline.tar.gz",
           "hasDynamicHelp": false,
           "multiple": false,
-          "options": [
-            "production",
-            "lowmem",
-            "basic"
-          ],
           "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "db:seed",
+      "id": "pack",
       "pluginAlias": "nodebbs",
       "pluginName": "nodebbs",
       "pluginType": "core",
@@ -297,8 +293,8 @@
       "relativePath": [
         "dist",
         "commands",
-        "db",
-        "seed.js"
+        "pack",
+        "index.js"
       ]
     },
     "logs:api": {
@@ -476,6 +472,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": {},
@@ -654,7 +671,7 @@
     "start": {
       "aliases": [],
       "args": {},
-      "description": "启动 NodeBBS (部署模式)",
+      "description": "开始部署",
       "flags": {
         "env": {
           "char": "e",
@@ -771,5 +788,5 @@
       ]
     }
   },
-  "version": "0.0.3"
+  "version": "0.0.5"
 }

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.5",
   "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);
-    }
-}