@xiaozhi-client/cli 1.9.8-beta.1 → 1.9.8

package/README.md

@@ -49,7 +49,7 @@ packages/cli/
 
 CLI 包通过 external 配置引用 backend 模块：
 
-- `@root/WebServer` → `dist/backend/WebServer.js` (通过 WebServerLauncher)
+- `@/WebServer` → `dist/backend/WebServer.js` (通过 WebServerLauncher)
 - `@/lib/config/manager` → `dist/backend/lib/config/manager.js`
 
 ## 导入方式

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xiaozhi-client/cli",
-  "version": "1.9.8-beta.1",
+  "version": "1.9.8",
   "private": false,
   "repository": {
     "type": "git",
@@ -17,8 +17,12 @@
     "xiaozhi-client": "../../dist/cli/index.js"
   },
   "dependencies": {
+    "chalk": "^5.6.0",
+    "cli-table3": "^0.6.5",
+    "commander": "^14.0.0",
     "consola": "^3.4.2",
-    "@xiaozhi-client/config": "1.9.8-beta.1"
+    "ora": "^8.2.0",
+    "@xiaozhi-client/config": "1.9.8"
   },
   "devDependencies": {
     "@types/node": "^24.3.0",

package/src/commands/McpCommandHandler.ts

@@ -634,6 +634,30 @@ export class McpCommandHandler extends BaseCommandHandler {
     }
   }
 
+  /**
+   * 验证服务是否存在
+   * @param serverName 服务名称
+   * @param spinner Ora 加载动画实例
+   * @returns 服务是否存在
+   * @private
+   */
+  private validateServerExists(
+    serverName: string,
+    spinner: ReturnType<typeof ora>
+  ): boolean {
+    const mcpServers = configManager.getMcpServers();
+
+    if (!mcpServers[serverName]) {
+      spinner.fail(`服务 '${serverName}' 不存在`);
+      console.log(
+        chalk.yellow("💡 提示: 使用 'xiaozhi mcp list' 查看所有可用服务")
+      );
+      return false;
+    }
+
+    return true;
+  }
+
   /**
    * 列出指定服务的工具
    */
@@ -641,13 +665,7 @@ export class McpCommandHandler extends BaseCommandHandler {
     const spinner = ora(`获取 ${serverName} 服务的工具列表...`).start();
 
     try {
-      const mcpServers = configManager.getMcpServers();
-
-      if (!mcpServers[serverName]) {
-        spinner.fail(`服务 '${serverName}' 不存在`);
-        console.log(
-          chalk.yellow("💡 提示: 使用 'xiaozhi mcp list' 查看所有可用服务")
-        );
+      if (!this.validateServerExists(serverName, spinner)) {
         return;
       }
 
@@ -729,13 +747,7 @@ export class McpCommandHandler extends BaseCommandHandler {
     const spinner = ora(`${action}工具 ${serverName}/${toolName}...`).start();
 
     try {
-      const mcpServers = configManager.getMcpServers();
-
-      if (!mcpServers[serverName]) {
-        spinner.fail(`服务 '${serverName}' 不存在`);
-        console.log(
-          chalk.yellow("💡 提示: 使用 'xiaozhi mcp list' 查看所有可用服务")
-        );
+      if (!this.validateServerExists(serverName, spinner)) {
         return;
       }
 

package/src/global.d.ts

@@ -16,8 +16,4 @@ declare global {
   }
 }
 
-// 构建时注入的版本号常量
-declare const __VERSION__: string;
-declare const __APP_NAME__: string;
-
 export {};

package/src/services/DaemonManager.ts

@@ -5,7 +5,7 @@
 import type { ChildProcess } from "node:child_process";
 import { spawn } from "node:child_process";
 import fs from "node:fs";
-import type { WebServer } from "@root/WebServer";
+import type { WebServer } from "@/WebServer";
 import consola from "consola";
 import { ProcessError, ServiceError } from "../errors/index";
 import type {

package/src/services/ProcessManager.ts

@@ -1,3 +1,15 @@
+/**
+ * 进程管理服务
+ *
+ * 负责管理 xiaozhi 服务的进程生命周期，包括：
+ * - 进程启动和停止
+ * - PID 文件管理
+ * - 进程状态查询
+ * - 优雅关闭进程
+ *
+ * @module packages/cli/src/services/ProcessManager
+ */
+
 import { FileError, ProcessError } from "../errors/index";
 import type {
   ProcessManager as IProcessManager,

package/src/services/ServiceManager.ts

@@ -264,7 +264,7 @@ export class ServiceManagerImpl implements IServiceManager {
       process.exit(0);
     } else {
       // 前台模式 - 直接启动 Web Server
-      const { WebServer } = await import("@root/WebServer.js");
+      const { WebServer } = await import("@/WebServer.js");
       const server = new WebServer(port);
 
       // 处理退出信号
@@ -323,7 +323,7 @@ export class ServiceManagerImpl implements IServiceManager {
    * 前台模式启动 WebServer
    */
   private async startWebServerInForeground(): Promise<void> {
-    const { WebServer } = await import("@root/WebServer.js");
+    const { WebServer } = await import("@/WebServer.js");
     const server = new WebServer();
 
     // 处理退出信号

package/src/services/__tests__/ServiceManager.test.ts

@@ -40,7 +40,7 @@ const mockMCPServerInstance = {
   stop: vi.fn().mockResolvedValue(undefined),
 };
 
-vi.mock("@root/WebServer.js", () => ({
+vi.mock("@/WebServer.js", () => ({
   WebServer: vi.fn().mockImplementation(() => mockWebServerInstance),
 }));
 
@@ -184,7 +184,7 @@ describe("ServiceManagerImpl 服务管理器实现", () => {
     );
 
     // Mock dynamic import for WebServer
-    vi.doMock("@root/WebServer.js", () => ({
+    vi.doMock("@/WebServer.js", () => ({
       WebServer: vi.fn().mockImplementation(() => mockWebServerInstance),
     }));
   });

package/src/types/backend.d.ts

@@ -39,10 +39,10 @@ declare module "@/lib/config/manager.js" {
   export const configManager: any;
 }
 
-declare module "@root/WebServer" {
+declare module "@/WebServer" {
   export class WebServer {}
 }
 
-declare module "@root/WebServer.js" {
+declare module "@/WebServer.js" {
   export class WebServer {}
 }

package/tsconfig.json

@@ -7,5 +7,9 @@
   },
   "include": ["src/**/*.ts"],
   "exclude": ["node_modules", "dist", "**/*.test.ts"],
-  "references": [{ "path": "../../apps/backend" }, { "path": "../config" }]
+  "references": [
+    { "path": "../../apps/backend" },
+    { "path": "../config" },
+    { "path": "../version" }
+  ]
 }

package/tsup.config.ts

@@ -66,8 +66,8 @@ export default defineConfig({
     "@xiaozhi-client/version",
     "@xiaozhi-client/version.js",
     // Backend 模块（运行时从 dist/backend 读取）
-    "@root/WebServer",
-    "@root/WebServer.js",
+    "@/WebServer",
+    "@/WebServer.js",
   ],
   outExtension: () => ({
     js: ".js",
@@ -77,24 +77,21 @@ export default defineConfig({
     const filePath = resolve("../../dist/cli/index.js");
     let content = readFileSync(filePath, "utf-8");
 
-    // 替换 @root/* 为指向正确位置的相对路径
+    // 替换 @/* 为指向正确位置的相对路径
     // 注意：@xiaozhi-client/config 现在从 node_modules 解析，不需要替换
     content = content
       .replace(
-        /from\s*["']@root\/WebServer\.js["']/g,
+        /from\s*["']@\/WebServer\.js["']/g,
         'from "../backend/WebServer.js"'
       )
+      .replace(/from\s*["']@\/WebServer["']/g, 'from "../backend/WebServer.js"')
+      // 替换动态导入中的 @/WebServer.js
       .replace(
-        /from\s*["']@root\/WebServer["']/g,
-        'from "../backend/WebServer.js"'
-      )
-      // 替换动态导入中的 @root/WebServer.js
-      .replace(
-        /import\(["']@root\/WebServer\.js["']\)/g,
+        /import\(["']@\/WebServer\.js["']\)/g,
         'import("../backend/WebServer.js")'
       )
       .replace(
-        /import\(["']@root\/WebServer["']\)/g,
+        /import\(["']@\/WebServer["']\)/g,
         'import("../backend/WebServer.js")'
       );
 

package/vitest.config.ts

@@ -54,8 +54,6 @@ export default defineConfig({
       // Backend 路径别名（从 packages/cli 向上到项目根目录）
       "@handlers": resolve(__dirname, "../../apps/backend/handlers"),
       "@handlers/*": resolve(__dirname, "../../apps/backend/handlers/*"),
-      "@middlewares": resolve(__dirname, "../../apps/backend/middlewares"),
-      "@middlewares/*": resolve(__dirname, "../../apps/backend/middlewares/*"),
       "@services": resolve(__dirname, "../../apps/backend/services"),
       "@services/*": resolve(__dirname, "../../apps/backend/services/*"),
       "@errors": resolve(__dirname, "../../apps/backend/errors"),
@@ -80,8 +78,8 @@ export default defineConfig({
       "@types/*": resolve(__dirname, "../../apps/backend/types/*"),
       "@/lib": resolve(__dirname, "../../apps/backend/lib"),
       "@/lib/*": resolve(__dirname, "../../apps/backend/lib/*"),
-      "@root": resolve(__dirname, "../../apps/backend"),
-      "@root/*": resolve(__dirname, "../../apps/backend/*"),
+      "@": resolve(__dirname, "../../apps/backend"),
+      "@/*": resolve(__dirname, "../../apps/backend/*"),
       "@routes": resolve(__dirname, "../../apps/backend/routes"),
       "@routes/*": resolve(__dirname, "../../apps/backend/routes/*"),
       "@constants": resolve(__dirname, "../../apps/backend/constants"),