@xiaozhi-client/cli 1.9.4-beta.10

package/src/commands/ProjectCommandHandler.ts

@@ -0,0 +1,254 @@
+/**
+ * 项目管理命令处理器
+ */
+
+import path from "node:path";
+import chalk from "chalk";
+import ora from "ora";
+import type { CommandOption } from "../interfaces/Command";
+import { BaseCommandHandler } from "../interfaces/Command";
+import type { IDIContainer } from "../interfaces/Config";
+
+/**
+ * 项目管理命令处理器
+ */
+export class ProjectCommandHandler extends BaseCommandHandler {
+  override name = "create";
+  override description = "创建项目";
+
+  override options: CommandOption[] = [
+    {
+      flags: "-t, --template <templateName>",
+      description: "使用指定模板创建项目",
+    },
+  ];
+
+  constructor(container: IDIContainer) {
+    super(container);
+  }
+
+  /**
+   * 执行创建项目命令
+   */
+  async execute(args: any[], options: any): Promise<void> {
+    this.validateArgs(args, 1);
+    const projectName = args[0];
+
+    await this.handleCreate(projectName, options);
+  }
+
+  /**
+   * 处理创建项目命令
+   */
+  protected async handleCreate(
+    projectName: string,
+    options: any
+  ): Promise<void> {
+    const spinner = ora("初始化项目...").start();
+
+    try {
+      const templateManager = this.getService<any>("templateManager");
+      const fileUtils = this.getService<any>("fileUtils");
+
+      // 确定目标目录
+      const targetPath = path.join(process.cwd(), projectName);
+
+      // 检查目标目录是否已存在
+      if (await fileUtils.exists(targetPath)) {
+        spinner.fail(`目录 "${projectName}" 已存在`);
+        console.log(
+          chalk.yellow("💡 提示: 请选择不同的项目名称或删除现有目录")
+        );
+        return;
+      }
+
+      if (options.template) {
+        // 使用模板创建项目
+        await this.createFromTemplate(
+          projectName,
+          options.template,
+          targetPath,
+          spinner,
+          templateManager
+        );
+      } else {
+        // 创建基本项目（只有配置文件）
+        await this.createBasicProject(
+          projectName,
+          targetPath,
+          spinner,
+          templateManager
+        );
+      }
+    } catch (error) {
+      spinner.fail(
+        `创建项目失败: ${error instanceof Error ? error.message : String(error)}`
+      );
+      this.handleError(error as Error);
+    }
+  }
+
+  /**
+   * 从模板创建项目
+   */
+  private async createFromTemplate(
+    projectName: string,
+    templateName: string,
+    targetPath: string,
+    spinner: any,
+    templateManager: any
+  ): Promise<void> {
+    spinner.text = "检查模板...";
+
+    // 获取可用模板列表
+    const availableTemplates = await templateManager.getAvailableTemplates();
+
+    if (availableTemplates.length === 0) {
+      spinner.fail("找不到可用模板");
+      console.log(chalk.yellow("💡 提示: 请确保 xiaozhi-client 正确安装"));
+      return;
+    }
+
+    // 使用局部变量避免重新赋值函数参数
+    let actualTemplateName = templateName;
+
+    // 验证模板是否存在
+    const isValidTemplate =
+      await templateManager.validateTemplate(actualTemplateName);
+    if (!isValidTemplate) {
+      spinner.fail(`模板 "${actualTemplateName}" 不存在`);
+
+      // 尝试找到相似的模板
+      const similarTemplate = this.findSimilarTemplate(
+        actualTemplateName,
+        availableTemplates
+      );
+
+      if (similarTemplate) {
+        console.log(
+          chalk.yellow(`💡 你是想使用模板 "${similarTemplate}" 吗？`)
+        );
+        const confirmed = await this.askUserConfirmation(
+          chalk.cyan("确认使用此模板？(y/n): ")
+        );
+
+        if (confirmed) {
+          actualTemplateName = similarTemplate;
+        } else {
+          this.showAvailableTemplates(availableTemplates);
+          return;
+        }
+      } else {
+        this.showAvailableTemplates(availableTemplates);
+        return;
+      }
+    }
+
+    spinner.text = `从模板 "${actualTemplateName}" 创建项目 "${projectName}"...`;
+
+    // 使用模板管理器创建项目
+    await templateManager.createProject({
+      templateName: actualTemplateName,
+      targetPath,
+      projectName,
+    });
+
+    spinner.succeed(`项目 "${projectName}" 创建成功`);
+
+    console.log(chalk.green("✅ 项目创建完成!"));
+    console.log(chalk.yellow("📝 接下来的步骤:"));
+    console.log(chalk.gray(`   cd ${projectName}`));
+    console.log(chalk.gray("   pnpm install  # 安装依赖"));
+    console.log(chalk.gray("   # 编辑 xiaozhi.config.json 设置你的 MCP 端点"));
+    console.log(chalk.gray("   xiaozhi start  # 启动服务"));
+  }
+
+  /**
+   * 创建基本项目
+   */
+  private async createBasicProject(
+    projectName: string,
+    targetPath: string,
+    spinner: any,
+    templateManager: any
+  ): Promise<void> {
+    spinner.text = `创建基本项目 "${projectName}"...`;
+
+    // 使用模板管理器创建基本项目
+    await templateManager.createProject({
+      templateName: null, // 表示创建基本项目
+      targetPath,
+      projectName,
+    });
+
+    spinner.succeed(`项目 "${projectName}" 创建成功`);
+
+    console.log(chalk.green("✅ 基本项目创建完成!"));
+    console.log(chalk.yellow("📝 接下来的步骤:"));
+    console.log(chalk.gray(`   cd ${projectName}`));
+    console.log(
+      chalk.gray("   # 编辑 xiaozhi.config.json 设置你的 MCP 端点和服务")
+    );
+    console.log(chalk.gray("   xiaozhi start  # 启动服务"));
+    console.log(
+      chalk.yellow("💡 提示: 使用 --template 选项可以从模板创建项目")
+    );
+  }
+
+  /**
+   * 显示可用模板
+   */
+  private showAvailableTemplates(templates: string[]): void {
+    console.log(chalk.yellow("可用的模板:"));
+    for (const template of templates) {
+      console.log(chalk.gray(`  - ${template}`));
+    }
+  }
+
+  /**
+   * 查找相似模板
+   */
+  private findSimilarTemplate(
+    input: string,
+    templates: string[]
+  ): string | null {
+    const formatUtils = this.getService<any>("formatUtils");
+
+    let bestMatch = null;
+    let bestSimilarity = 0;
+
+    for (const template of templates) {
+      const similarity = formatUtils.calculateSimilarity(
+        input.toLowerCase(),
+        template.toLowerCase()
+      );
+      if (similarity > bestSimilarity && similarity > 0.6) {
+        bestSimilarity = similarity;
+        bestMatch = template;
+      }
+    }
+
+    return bestMatch;
+  }
+
+  /**
+   * 询问用户确认
+   */
+  private async askUserConfirmation(prompt: string): Promise<boolean> {
+    const readline = await import("node:readline");
+    const rl = readline.createInterface({
+      input: process.stdin,
+      output: process.stdout,
+    });
+
+    return new Promise((resolve) => {
+      rl.question(prompt, (answer) => {
+        rl.close();
+        resolve(
+          answer.toLowerCase().trim() === "y" ||
+            answer.toLowerCase().trim() === "yes"
+        );
+      });
+    });
+  }
+}

package/src/commands/ServiceCommandHandler.ts

@@ -0,0 +1,182 @@
+/**
+ * 服务管理命令处理器
+ */
+
+import consola from "consola";
+import type { SubCommand } from "../interfaces/Command";
+import { BaseCommandHandler } from "../interfaces/Command";
+import type { IDIContainer } from "../interfaces/Config";
+
+/**
+ * 服务管理命令处理器
+ */
+export class ServiceCommandHandler extends BaseCommandHandler {
+  override name = "service";
+  override description = "服务管理命令";
+
+  override subcommands: SubCommand[] = [
+    {
+      name: "start",
+      description: "启动服务",
+      options: [
+        { flags: "-d, --daemon", description: "在后台运行服务" },
+        { flags: "--debug", description: "启用调试模式 (输出DEBUG级别日志)" },
+        {
+          flags: "--stdio",
+          description: "以 stdio 模式运行 MCP Server (用于 Cursor 等客户端)",
+        },
+      ],
+      execute: async (args: any[], options: any) => {
+        await this.handleStart(options);
+      },
+    },
+    {
+      name: "stop",
+      description: "停止服务",
+      execute: async (args: any[], options: any) => {
+        await this.handleStop();
+      },
+    },
+    {
+      name: "status",
+      description: "检查服务状态",
+      execute: async (args: any[], options: any) => {
+        await this.handleStatus();
+      },
+    },
+    {
+      name: "restart",
+      description: "重启服务",
+      options: [{ flags: "-d, --daemon", description: "在后台运行服务" }],
+      execute: async (args: any[], options: any) => {
+        await this.handleRestart(options);
+      },
+    },
+    {
+      name: "attach",
+      description: "连接到后台服务查看日志",
+      execute: async (args: any[], options: any) => {
+        await this.handleAttach();
+      },
+    },
+  ];
+
+  constructor(container: IDIContainer) {
+    super(container);
+  }
+
+  /**
+   * 主命令执行（显示帮助）
+   */
+  async execute(args: any[], options: any): Promise<void> {
+    console.log("服务管理命令。使用 --help 查看可用的子命令。");
+  }
+
+  /**
+   * 处理启动命令
+   */
+  private async handleStart(options: any): Promise<void> {
+    try {
+      // 处理--debug参数
+      if (options.debug) {
+        consola.level = "debug";
+      }
+
+      const serviceManager = this.getService<any>("serviceManager");
+
+      if (options.stdio) {
+        // stdio 模式已迁移到 HTTP 方式
+        this.showStdioMigrationGuide();
+        return;
+      }
+
+      // 传统模式
+      await serviceManager.start({
+        daemon: options.daemon || false,
+      });
+    } catch (error) {
+      this.handleError(error as Error);
+    }
+  }
+
+  /**
+   * 处理停止命令
+   */
+  private async handleStop(): Promise<void> {
+    try {
+      const serviceManager = this.getService<any>("serviceManager");
+      await serviceManager.stop();
+    } catch (error) {
+      this.handleError(error as Error);
+    }
+  }
+
+  /**
+   * 处理状态检查命令
+   */
+  private async handleStatus(): Promise<void> {
+    try {
+      const serviceManager = this.getService<any>("serviceManager");
+      const status = await serviceManager.getStatus();
+
+      if (status.running) {
+        console.log(`✅ 服务正在运行 (PID: ${status.pid})`);
+        if (status.uptime) {
+          console.log(`⏱️  运行时间: ${status.uptime}`);
+        }
+        if (status.mode) {
+          console.log(`🔧 运行模式: ${status.mode}`);
+        }
+      } else {
+        console.log("❌ 服务未运行");
+      }
+    } catch (error) {
+      this.handleError(error as Error);
+    }
+  }
+
+  /**
+   * 处理重启命令
+   */
+  private async handleRestart(options: any): Promise<void> {
+    try {
+      const serviceManager = this.getService<any>("serviceManager");
+      await serviceManager.restart({
+        daemon: options.daemon || false,
+      });
+    } catch (error) {
+      this.handleError(error as Error);
+    }
+  }
+
+  /**
+   * 处理附加命令
+   */
+  private async handleAttach(): Promise<void> {
+    try {
+      const daemonManager = this.getService<any>("daemonManager");
+      await daemonManager.attachToLogs();
+    } catch (error) {
+      this.handleError(error as Error);
+    }
+  }
+
+  /**
+   * 显示 stdio 模式迁移指南
+   */
+  private showStdioMigrationGuide(): void {
+    console.log("\n❌ stdio 模式已废弃\n");
+    console.log("小智客户端已迁移到纯 HTTP 架构，请使用以下方式：\n");
+
+    console.log("1. 启动 Web 服务：");
+    console.log("   xiaozhi start\n");
+
+    console.log("2. 在 Cursor 中配置 HTTP 端点：");
+    console.log('   "mcpServers": {');
+    console.log('     "xiaozhi-client": {');
+    console.log('       "type": "streamableHttp",');
+    console.log('       "url": "http://localhost:9999/mcp"');
+    console.log("     }");
+    console.log("   }\n");
+  }
+}