@zhin.js/cli 1.0.0

package/dist/utils/process.js

@@ -0,0 +1,308 @@
+import { spawn, exec } from 'child_process';
+import fs from 'fs-extra';
+import path from 'path';
+import { logger } from './logger.js';
+import os from 'os';
+const PID_FILE = '.zhin.pid';
+/**
+ * 检查进程是否存在的跨平台实现
+ */
+async function isProcessRunning(pid) {
+    return new Promise((resolve) => {
+        const platform = os.platform();
+        if (platform === 'win32') {
+            // Windows: 使用 tasklist 命令
+            exec(`tasklist /FI "PID eq ${pid}" /FO CSV /NH`, (error, stdout) => {
+                if (error) {
+                    resolve(false);
+                    return;
+                }
+                // tasklist 输出包含进程信息表示进程存在
+                resolve(stdout.trim().length > 0 && !stdout.includes('INFO: No tasks'));
+            });
+        }
+        else {
+            // Linux/macOS: 使用 ps 命令
+            exec(`ps -p ${pid} -o pid=`, (error, stdout) => {
+                if (error) {
+                    resolve(false);
+                    return;
+                }
+                // ps 输出包含 PID 表示进程存在
+                resolve(stdout.trim().length > 0);
+            });
+        }
+    });
+}
+/**
+ * 终止进程的跨平台实现
+ */
+async function killProcess(pid, signal = 'SIGTERM') {
+    return new Promise((resolve) => {
+        const platform = os.platform();
+        if (platform === 'win32') {
+            // Windows: 使用 taskkill 命令
+            const forceFlag = signal === 'SIGKILL' ? '/F' : '';
+            exec(`taskkill /PID ${pid} ${forceFlag}`, (error) => {
+                resolve(!error);
+            });
+        }
+        else {
+            // Linux/macOS: 使用 kill 命令
+            const signalFlag = signal === 'SIGKILL' ? '-9' : '-15';
+            exec(`kill ${signalFlag} ${pid}`, (error) => {
+                resolve(!error);
+            });
+        }
+    });
+}
+export async function startProcess(command, args, cwd, daemon) {
+    return new Promise((resolve, reject) => {
+        const child = spawn(command, args, {
+            cwd,
+            detached: daemon,
+            stdio: 'ignore',
+            env: { ...process.env }
+        });
+        if (daemon)
+            child.unref();
+        child.on('spawn', () => {
+            // 保存进程ID
+            const pidFile = path.join(cwd, PID_FILE);
+            fs.writeFileSync(pidFile, child.pid.toString());
+            logger.success(`机器人已启动，PID: ${child.pid}`);
+            resolve(child);
+        });
+        child.on('error', (error) => {
+            logger.error(`启动失败: ${error.message}`);
+            reject(error);
+        });
+        // 设置超时检查
+        setTimeout(() => {
+            if (child.killed) {
+                reject(new Error('进程启动超时'));
+            }
+        }, 5000);
+    });
+}
+export async function stopProcess(cwd) {
+    const pidFile = path.join(cwd, PID_FILE);
+    if (!fs.existsSync(pidFile)) {
+        logger.warn('没有找到运行中的机器人进程');
+        return;
+    }
+    try {
+        const pid = parseInt(fs.readFileSync(pidFile, 'utf8'));
+        // 检查进程是否存在
+        const isRunning = await isProcessRunning(pid);
+        if (!isRunning) {
+            logger.warn('进程已不存在，清理PID文件');
+            fs.removeSync(pidFile);
+            return;
+        }
+        // 终止进程
+        const killed = await killProcess(pid, 'SIGTERM');
+        if (!killed) {
+            logger.warn('无法终止进程，可能进程已结束');
+            fs.removeSync(pidFile);
+            return;
+        }
+        // 等待进程结束
+        let attempts = 0;
+        while (attempts < 30) {
+            const stillRunning = await isProcessRunning(pid);
+            if (!stillRunning) {
+                break;
+            }
+            await new Promise(resolve => setTimeout(resolve, 100));
+            attempts++;
+        }
+        // 如果进程仍然存在，强制结束
+        if (attempts >= 30) {
+            logger.warn('进程未响应，尝试强制结束');
+            await killProcess(pid, 'SIGKILL');
+            // 再次等待
+            attempts = 0;
+            while (attempts < 10) {
+                const stillRunning = await isProcessRunning(pid);
+                if (!stillRunning) {
+                    break;
+                }
+                await new Promise(resolve => setTimeout(resolve, 100));
+                attempts++;
+            }
+        }
+        fs.removeSync(pidFile);
+        logger.success('机器人已停止');
+    }
+    catch (error) {
+        logger.error(`停止进程时发生错误: ${error}`);
+        // 清理PID文件
+        fs.removeSync(pidFile);
+    }
+}
+export async function getProcessStatus(cwd) {
+    const pidFile = path.join(cwd, PID_FILE);
+    if (!fs.existsSync(pidFile)) {
+        return { running: false };
+    }
+    try {
+        const pid = parseInt(fs.readFileSync(pidFile, 'utf8'));
+        // 检查进程是否存在
+        const isRunning = await isProcessRunning(pid);
+        if (!isRunning) {
+            // 进程不存在，清理PID文件
+            fs.removeSync(pidFile);
+            return { running: false };
+        }
+        return { running: true, pid };
+    }
+    catch {
+        return { running: false };
+    }
+}
+/**
+ * 获取进程详细状态信息
+ */
+export async function getProcessStatusDetailed(cwd) {
+    const pidFile = path.join(cwd, PID_FILE);
+    if (!fs.existsSync(pidFile)) {
+        return { running: false };
+    }
+    try {
+        const pid = parseInt(fs.readFileSync(pidFile, 'utf8'));
+        // 检查进程是否存在
+        const isRunning = await isProcessRunning(pid);
+        if (!isRunning) {
+            // 进程不存在，清理PID文件
+            fs.removeSync(pidFile);
+            return { running: false };
+        }
+        // 获取进程详细信息
+        const info = await getProcessInfo(pid);
+        return { running: true, pid, info: info || undefined };
+    }
+    catch {
+        return { running: false };
+    }
+}
+/**
+ * 获取进程详细信息的跨平台实现
+ */
+async function getProcessInfo(pid) {
+    return new Promise((resolve) => {
+        const platform = os.platform();
+        if (platform === 'win32') {
+            // Windows: 使用 tasklist 命令获取详细信息
+            exec(`tasklist /FI "PID eq ${pid}" /FO CSV /NH`, (error, stdout) => {
+                if (error || !stdout.trim() || stdout.includes('INFO: No tasks')) {
+                    resolve(null);
+                    return;
+                }
+                // 解析 CSV 格式输出: "进程名","PID","会话名","会话#","内存使用"
+                const lines = stdout.trim().split('\n');
+                if (lines.length > 0) {
+                    const parts = lines[0].split(',');
+                    if (parts.length >= 5) {
+                        const name = parts[0].replace(/"/g, '');
+                        const memory = parts[4].replace(/"/g, '');
+                        resolve({ name, memory });
+                    }
+                    else {
+                        resolve({ name: 'Unknown' });
+                    }
+                }
+                else {
+                    resolve(null);
+                }
+            });
+        }
+        else {
+            // Linux/macOS: 使用 ps 命令获取详细信息
+            exec(`ps -p ${pid} -o comm=,rss=,pcpu=`, (error, stdout) => {
+                if (error || !stdout.trim()) {
+                    resolve(null);
+                    return;
+                }
+                const lines = stdout.trim().split('\n');
+                if (lines.length > 0) {
+                    const parts = lines[0].trim().split(/\s+/);
+                    if (parts.length >= 3) {
+                        const name = parts[0];
+                        const memory = `${(parseInt(parts[1]) / 1024).toFixed(1)}MB`;
+                        const cpu = `${parseFloat(parts[2]).toFixed(1)}%`;
+                        resolve({ name, memory, cpu });
+                    }
+                    else {
+                        resolve({ name: 'Unknown' });
+                    }
+                }
+                else {
+                    resolve(null);
+                }
+            });
+        }
+    });
+}
+/**
+ * 获取所有相关进程的列表
+ */
+async function getRelatedProcessesInternal(processName) {
+    return new Promise((resolve) => {
+        const platform = os.platform();
+        if (platform === 'win32') {
+            // Windows: 使用 tasklist 命令
+            exec(`tasklist /FI "IMAGENAME eq ${processName}*" /FO CSV /NH`, (error, stdout) => {
+                if (error || !stdout.trim() || stdout.includes('INFO: No tasks')) {
+                    resolve([]);
+                    return;
+                }
+                const processes = [];
+                const lines = stdout.trim().split('\n');
+                for (const line of lines) {
+                    const parts = line.split(',');
+                    if (parts.length >= 5) {
+                        const name = parts[0].replace(/"/g, '');
+                        const pid = parseInt(parts[1].replace(/"/g, ''));
+                        const memory = parts[4].replace(/"/g, '');
+                        if (!isNaN(pid)) {
+                            processes.push({ pid, name, memory });
+                        }
+                    }
+                }
+                resolve(processes);
+            });
+        }
+        else {
+            // Linux/macOS: 使用 ps 命令
+            exec(`ps -C "${processName}" -o pid=,comm=,rss=,pcpu=`, (error, stdout) => {
+                if (error || !stdout.trim()) {
+                    resolve([]);
+                    return;
+                }
+                const processes = [];
+                const lines = stdout.trim().split('\n');
+                for (const line of lines) {
+                    const parts = line.trim().split(/\s+/);
+                    if (parts.length >= 4) {
+                        const pid = parseInt(parts[0]);
+                        const name = parts[1];
+                        const memory = `${(parseInt(parts[2]) / 1024).toFixed(1)}MB`;
+                        const cpu = `${parseFloat(parts[3]).toFixed(1)}%`;
+                        if (!isNaN(pid)) {
+                            processes.push({ pid, name, memory, cpu });
+                        }
+                    }
+                }
+                resolve(processes);
+            });
+        }
+    });
+}
+/**
+ * 获取所有相关进程列表
+ */
+export async function getRelatedProcesses(processName) {
+    return await getRelatedProcessesInternal(processName);
+}
+//# sourceMappingURL=process.js.map

package/dist/utils/process.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"process.js","sourceRoot":"","sources":["../../src/utils/process.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "@zhin.js/cli",
+  "version": "1.0.0",
+  "description": "Zhin机器人框架CLI工具",
+  "type": "module",
+  "main": "./dist/index.js",
+  "bin": {
+    "zhin": "./dist/cli.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "dependencies": {
+    "commander": "^11.1.0",
+    "inquirer": "^9.2.12",
+    "chalk": "^5.3.0",
+    "ora": "^7.0.1",
+    "fs-extra": "^11.1.1",
+    "cross-spawn": "^7.0.3",
+    "dotenv": "^16.3.1"
+  },
+  "devDependencies": {
+    "@types/fs-extra": "^11.0.4",
+    "@types/cross-spawn": "^6.0.6",
+    "@types/inquirer": "^9.0.7",
+    "@types/node": "^20.0.0",
+    "typescript": "^5.3.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "clean": "rm -rf dist"
+  }
+}

package/src/cli.ts

@@ -0,0 +1,25 @@
+#!/usr/bin/env node
+
+import { Command } from 'commander';
+import { initCommand } from './commands/init.js';
+import { startCommand, restartCommand } from './commands/start.js';
+import { stopCommand } from './commands/stop.js';
+import { devCommand } from './commands/dev.js';
+import { buildCommand } from './commands/build.js';
+
+const program = new Command();
+
+program
+  .name('zhin')
+  .description('Zhin机器人框架CLI工具')
+  .version('1.0.0');
+
+// 注册命令
+program.addCommand(initCommand);
+program.addCommand(startCommand);
+program.addCommand(restartCommand);
+program.addCommand(stopCommand);
+program.addCommand(devCommand);
+program.addCommand(buildCommand);
+
+program.parse(); 

package/src/commands/build.ts

@@ -0,0 +1,68 @@
+import { Command } from 'commander';
+import { logger } from '../utils/logger.js';
+import { spawn } from 'child_process';
+import fs from 'fs-extra';
+import path from 'path';
+
+export const buildCommand = new Command('build')
+  .description('构建机器人项目')
+  .option('--clean', '清理输出目录', false)
+  .action(async (options: { clean: boolean }) => {
+    try {
+      const cwd = process.cwd();
+      
+      // 检查是否是Zhin项目
+      if (!isZhinProject(cwd)) {
+        logger.error('当前目录不是Zhin项目');
+        process.exit(1);
+      }
+      
+      const distPath = path.join(cwd, 'dist');
+      
+      // 清理输出目录
+      if (options.clean && fs.existsSync(distPath)) {
+        logger.info('正在清理输出目录...');
+        await fs.remove(distPath);
+      }
+      
+      logger.info('正在构建项目...');
+      
+      // 使用TypeScript编译
+      const child = spawn('npx', ['tsc'], {
+        cwd,
+        stdio: 'inherit'
+      });
+      
+      child.on('close', (code) => {
+        if (code === 0) {
+          logger.info('构建完成！');
+        } else {
+          logger.error(`构建失败，退出码: ${code}`);
+          process.exit(1);
+        }
+      });
+      
+      child.on('error', (error) => {
+        logger.error(`构建失败: ${error.message}`);
+        process.exit(1);
+      });
+      
+    } catch (error) {
+      logger.error(`构建失败: ${error}`);
+      process.exit(1);
+    }
+  });
+
+function isZhinProject(cwd: string): boolean {
+  const packageJsonPath = path.join(cwd, 'package.json');
+  if (!fs.existsSync(packageJsonPath)) {
+    return false;
+  }
+  
+  try {
+    const packageJson = fs.readJsonSync(packageJsonPath);
+    return packageJson.dependencies && packageJson.dependencies['zhin.js'];
+  } catch {
+    return false;
+  }
+} 

package/src/commands/dev.ts

@@ -0,0 +1,188 @@
+import { Command } from 'commander';
+import { logger } from '../utils/logger.js';
+import { loadEnvFiles } from '../utils/env.js';
+import { spawn, ChildProcess } from 'child_process';
+import fs from 'fs-extra';
+import path from 'path';
+
+export const devCommand = new Command('dev')
+  .option('-p, --port [port]', 'HMR服务端口', '3000')
+  .option('--verbose', '显示详细日志', false)
+  .option('--bun', '使用 bun 运行（默认使用 node', false)
+  .action(async (options: { port: string; verbose: boolean; bun: boolean }) => {
+    try {
+      const cwd = process.cwd();
+
+      // 检查是否是Zhin项目
+      if (!isZhinProject(cwd)) {
+        logger.error('当前目录不是Zhin项目');
+        logger.info('请在Zhin项目根目录运行此命令，或使用 zhin init 初始化项目');
+        process.exit(1);
+      }
+
+      // 加载环境变量文件
+      logger.info('🔍 正在加载环境变量...');
+      loadEnvFiles(cwd, 'development');
+
+      // 检查src目录是否存在
+      const srcPath = path.join(cwd, 'src');
+      if (!fs.existsSync(srcPath)) {
+        logger.error('src目录不存在');
+        logger.info('请确保项目结构正确，src目录包含入口文件');
+        process.exit(1);
+      }
+
+      // 检查入口文件
+      const entryFile = path.join(srcPath, 'index.ts');
+      if (!fs.existsSync(entryFile)) {
+        logger.error('入口文件 src/index.ts 不存在');
+        process.exit(1);
+      }
+
+      logger.info('📦 开发模式启动中...');
+
+      // 启动机器人的函数
+      const startBot = (): ChildProcess => {
+        // 设置环境变量
+        const env = {
+          ...process.env,
+          NODE_ENV: 'development',
+          ZHIN_DEV_MODE: 'true',
+          ZHIN_HMR_PORT: options.port,
+          ZHIN_VERBOSE: options.verbose ? 'true' : 'false'
+        };
+        
+        // 选择运行时
+        const runtime = options.bun ? 'bun' : 'tsx';
+        const args = options.bun ? ['src/index.ts'] : ['--expose-gc', 'src/index.ts'];
+        
+        logger.info(`📦 启动命令: ${runtime} ${args.join(' ')}`);
+        
+        // 启动机器人
+        return spawn(runtime, args, {
+          cwd,
+          stdio: 'inherit',
+          env
+        });
+      };
+
+      let child = startBot();
+      let isRestarting = false;
+      let isKilling = false;
+
+      // 重启函数
+      const restartBot = async () => {
+        if (isRestarting || isKilling) return;
+        isRestarting = true;
+
+        logger.info('🔄 正在重启开发服务器...');
+
+        // 优雅关闭当前进程
+        if (child && !child.killed) {
+          const oldChild=child
+          oldChild.kill('SIGTERM');
+          // 如果5秒后还没关闭，强制杀掉
+          setTimeout(() => {
+            if (oldChild && !oldChild.killed) {
+              oldChild.kill('SIGKILL');
+            }
+          }, 5000);
+        }
+
+        child = startBot();
+        setupChildHandlers(child);
+        isRestarting = false;
+      };
+
+      // 设置子进程处理器
+      const setupChildHandlers = (childProcess: ChildProcess) => {
+        childProcess.on('error', (error) => {
+          if (!isRestarting) {
+            logger.error(`❌ 启动失败: ${error.message}`);
+            // 提供常见问题的解决建议
+            if (error.message.includes('ENOENT')) {
+              if (options.bun) {
+                  logger.info('💡 请确保已安装 bun: https://bun.sh/');
+              } else {
+                logger.info('💡 请确保已安装 tsx: npm install -D tsx');
+              }
+            }
+
+            process.exit(1);
+          }
+        });
+
+        childProcess.on('exit', (code) => {
+          if (!isRestarting && !isKilling) {
+            if (code === 51) {
+              return restartBot();
+            }
+            if (code !== 0) {
+              logger.error(`🔄 进程退出，代码: ${code}`);
+            }
+          }
+        });
+      };
+
+      // 设置初始子进程处理器
+      setupChildHandlers(child);
+
+      // 保存主进程PID文件（虽然开发模式不提供CLI重启，但保留用于进程管理）
+      const pidFile = path.join(cwd, '.zhin-dev.pid');
+      fs.writeFileSync(pidFile, process.pid.toString());
+
+      // 处理退出信号
+      const cleanup = () => {
+        if (isKilling) return;
+        logger.info('🛑 正在关闭开发服务器...');
+        isKilling = true;
+
+        if (child && !child.killed) {
+          child.kill('SIGTERM');
+        }
+
+        // 给子进程一些时间优雅退出
+        setTimeout(() => {
+          if (child && !child.killed) {
+            child.kill('SIGKILL');
+          }
+
+          // 清理PID文件
+          if (fs.existsSync(pidFile)) {
+            fs.removeSync(pidFile);
+          }
+
+          logger.info('✅ 开发服务器已关闭');
+          process.exit(0);
+        }, 3000);
+      };
+
+      process.on('SIGINT', cleanup);
+      process.on('SIGTERM', cleanup);
+
+      // 显示开发模式提示
+      logger.info('💡 开发模式运行中，按 Ctrl+C 退出');
+      logger.info('💡 重启方式: 在插件中调用 process.exit(51)');
+
+    } catch (error) {
+      logger.error(`❌ 开发模式启动失败: ${error}`);
+      process.exit(1);
+    }
+  });
+
+function isZhinProject(cwd: string): boolean {
+  const packageJsonPath = path.join(cwd, 'package.json');
+  if (!fs.existsSync(packageJsonPath)) {
+    return false;
+  }
+
+  try {
+    const packageJson = fs.readJsonSync(packageJsonPath);
+    return packageJson.dependencies && (
+      packageJson.dependencies['zhin.js'] ||
+      packageJson.devDependencies?.['zhin.js']
+    );
+  } catch {
+    return false;
+  }
+}