@xiaozhi-client/version 1.10.9 → 2.0.0-beta.1

package/README.md

@@ -0,0 +1,414 @@
+# @xiaozhi-client/version
+
+> 小智客户端版本管理工具，提供版本号获取、比较、验证等功能
+
+[![npm version](https://badge.fury.io/js/%40xiaozhi-client%2Fversion.svg)](https://www.npmjs.com/package/@xiaozhi-client/version)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+## 简介
+
+`@xiaozhi-client/version` 是一个轻量级的版本管理工具库，提供：
+
+- **版本号获取** - 支持构建时注入和运行时读取两种方式
+- **版本比较** - 语义化版本号比较功能
+- **版本验证** - 验证版本号格式是否符合语义化版本规范
+- **零依赖** - 无任何外部依赖
+- **TypeScript** - 完整的类型定义支持
+
+## 特性
+
+### 核心功能
+
+- **版本号常量** - `VERSION` 和 `APP_NAME` 常量，构建时自动注入
+- **运行时读取** - 支持从 `package.json` 动态读取版本信息
+- **版本比较** - 支持语义化版本号比较（如 `1.2.3` vs `1.2.4`）
+- **格式验证** - 验证版本号是否符合语义化版本规范
+- **缓存机制** - 内置缓存提升性能
+
+## 安装
+
+```bash
+# 使用 npm
+npm install @xiaozhi-client/version
+
+# 使用 pnpm
+pnpm add @xiaozhi-client/version
+
+# 使用 yarn
+yarn add @xiaozhi-client/version
+```
+
+## 快速开始
+
+### 使用版本常量
+
+```typescript
+import { VERSION, APP_NAME } from '@xiaozhi-client/version';
+
+console.log(`应用名称: ${APP_NAME}`);
+console.log(`版本号: ${VERSION}`);
+// 输出: 应用名称: xiaozhi-client
+// 输出: 版本号: 1.10.9
+```
+
+### 使用 VersionUtils
+
+#### 获取版本信息
+
+```typescript
+import { VersionUtils } from '@xiaozhi-client/version';
+
+// 获取版本号
+const version = VersionUtils.getVersion();
+console.log(`当前版本: ${version}`);
+
+// 获取完整版本信息
+const versionInfo = VersionUtils.getVersionInfo();
+console.log(versionInfo);
+// 输出: {
+//   version: '1.10.9',
+//   name: 'xiaozhi-client',
+//   description: '小智 AI 客户端',
+//   author: 'shenjingnan'
+// }
+```
+
+#### 比较版本号
+
+```typescript
+import { VersionUtils } from '@xiaozhi-client/version';
+
+const result = VersionUtils.compareVersions('1.2.3', '1.2.4');
+
+if (result === 1) {
+  console.log('第一个版本更新');
+} else if (result === -1) {
+  console.log('第二个版本更新');
+} else {
+  console.log('版本相同');
+}
+```
+
+#### 验证版本格式
+
+```typescript
+import { VersionUtils } from '@xiaozhi-client/version';
+
+// 验证标准版本号
+console.log(VersionUtils.isValidVersion('1.2.3'));        // true
+console.log(VersionUtils.isValidVersion('1.2.3-alpha'));   // true
+console.log(VersionUtils.isValidVersion('1.2.3-beta.1'));  // true
+console.log(VersionUtils.isValidVersion('1.2.3+build.1')); // true
+console.log(VersionUtils.isValidVersion('invalid'));       // false
+```
+
+#### 清除缓存
+
+```typescript
+import { VersionUtils } from '@xiaozhi-client/version';
+
+// 清除版本缓存（主要用于测试场景）
+VersionUtils.clearCache();
+
+// 重新获取版本信息
+const freshVersion = VersionUtils.getVersion();
+```
+
+## API 参考
+
+### 常量
+
+#### VERSION
+
+当前版本号常量，构建时自动注入。
+
+```typescript
+declare const VERSION: string;
+```
+
+#### APP_NAME
+
+应用名称常量，构建时自动注入。
+
+```typescript
+declare const APP_NAME: string;
+```
+
+### VersionUtils 类
+
+版本工具类，提供静态方法用于版本管理。
+
+#### getVersion()
+
+获取当前版本号。
+
+```typescript
+static getVersion(): string
+```
+
+**返回值**: 版本号字符串
+
+**说明**:
+- 优先使用构建时注入的版本号
+- 如果是占位符，则运行时从 `package.json` 读取
+- 内置缓存机制，重复调用不会重复读取
+
+#### getVersionInfo()
+
+获取完整版本信息。
+
+```typescript
+static getVersionInfo(): VersionInfo
+```
+
+**返回值**: 版本信息对象
+
+```typescript
+interface VersionInfo {
+  version: string;        // 版本号
+  name?: string;          // 应用名称
+  description?: string;   // 应用描述
+  author?: string;        // 作者信息
+}
+```
+
+#### compareVersions()
+
+比较两个版本号。
+
+```typescript
+static compareVersions(version1: string, version2: string): number
+```
+
+**参数**:
+- `version1` - 第一个版本号
+- `version2` - 第二个版本号
+
+**返回值**:
+- `1` - version1 > version2
+- `-1` - version1 < version2
+- `0` - 版本相等
+
+**示例**:
+```typescript
+VersionUtils.compareVersions('1.2.3', '1.2.4');  // -1
+VersionUtils.compareVersions('1.2.4', '1.2.3');  // 1
+VersionUtils.compareVersions('1.2.3', '1.2.3');  // 0
+VersionUtils.compareVersions('1.10.0', '1.2.0'); // 1
+```
+
+#### isValidVersion()
+
+检查版本号格式是否有效。
+
+```typescript
+static isValidVersion(version: string): boolean
+```
+
+**参数**:
+- `version` - 版本号字符串
+
+**返回值**: 是否为有效的语义化版本号
+
+**支持的格式**:
+- 标准版本号: `1.2.3`
+- 带预发布标识: `1.2.3-alpha`, `1.2.3-beta.1`
+- 带构建元数据: `1.2.3+build.123`
+- 完整格式: `1.2.3-alpha.1+build.123`
+
+#### clearCache()
+
+清除版本缓存。
+
+```typescript
+static clearCache(): void
+```
+
+**说明**: 主要用于测试场景，清除后下次调用会重新读取版本信息。
+
+## 类型定义
+
+### VersionInfo
+
+版本信息接口。
+
+```typescript
+interface VersionInfo {
+  version: string;        // 版本号（必需）
+  name?: string;          // 应用名称（可选）
+  description?: string;   // 应用描述（可选）
+  author?: string;        // 作者信息（可选）
+}
+```
+
+## 使用场景
+
+### 检查版本更新
+
+```typescript
+import { VersionUtils } from '@xiaozhi-client/version';
+
+async function checkForUpdates() {
+  const currentVersion = VersionUtils.getVersion();
+  const latestVersion = await fetchLatestVersion();
+
+  if (VersionUtils.compareVersions(latestVersion, currentVersion) === 1) {
+    console.log('发现新版本，请更新！');
+    showUpdateNotification(latestVersion);
+  }
+}
+```
+
+### 版本兼容性检查
+
+```typescript
+import { VersionUtils } from '@xiaozhi-client/version';
+
+function checkCompatibility(requiredVersion: string): boolean {
+  const currentVersion = VersionUtils.getVersion();
+
+  if (!VersionUtils.isValidVersion(requiredVersion)) {
+    throw new Error('无效的版本号格式');
+  }
+
+  return VersionUtils.compareVersions(currentVersion, requiredVersion) >= 0;
+}
+
+// 使用示例
+if (checkCompatibility('1.10.0')) {
+  console.log('版本兼容，可以继续');
+} else {
+  console.log('版本过低，请升级');
+}
+```
+
+### CLI 版本显示
+
+```typescript
+import { VERSION, APP_NAME, VersionUtils } from '@xiaozhi-client/version';
+
+function showVersion() {
+  const info = VersionUtils.getVersionInfo();
+
+  console.log(`${info.name} v${info.version}`);
+  if (info.description) {
+    console.log(info.description);
+  }
+  if (info.author) {
+    console.log(`作者: ${info.author}`);
+  }
+}
+
+// 输出示例:
+// xiaozhi-client v1.10.9
+// 小智 AI 客户端
+// 作者: shenjingnan
+```
+
+## 版本号注入机制
+
+本包支持两种版本号获取方式：
+
+### 构建时注入（推荐）
+
+构建时通过 `tsup` 的 `define` 选项注入版本号：
+
+```typescript
+// tsup.config.ts
+{
+  define: {
+    __VERSION__: `"${packageJson.version}"`,
+    __APP_NAME__: `"${packageJson.name}"`
+  }
+}
+```
+
+优点：
+- 构建后版本号固定
+- 无运行时文件读取开销
+- 适合生产环境
+
+### 运行时读取
+
+如果构建时未注入版本号，包会自动从 `package.json` 读取：
+
+```typescript
+// 逻辑：VERSION === "__VERSION__" → 运行时读取
+```
+
+优点：
+- 开发环境方便
+- 无需额外配置
+
+## 开发指南
+
+### 本地开发
+
+```bash
+# 克隆仓库
+git clone https://github.com/shenjingnan/xiaozhi-client.git
+cd xiaozhi-client/packages/version
+
+# 安装依赖
+pnpm install
+
+# 构建
+pnpm build
+
+# 运行测试
+pnpm test
+
+# 类型检查
+pnpm type-check
+```
+
+### 构建产物
+
+```bash
+dist/
+├── index.js           # ESM 格式的编译产物
+├── index.d.ts         # TypeScript 类型声明
+└── index.js.map       # Source Map
+```
+
+## 常见问题
+
+### Q: 如何获取当前运行时的版本号？
+
+A: 使用 `VersionUtils.getVersion()` 方法：
+
+```typescript
+const version = VersionUtils.getVersion();
+```
+
+### Q: 如何比较两个版本号？
+
+A: 使用 `VersionUtils.compareVersions()` 方法：
+
+```typescript
+const result = VersionUtils.compareVersions('1.2.3', '1.2.4');
+// result: -1 (表示 1.2.3 < 1.2.4)
+```
+
+### Q: 为什么版本号是 `__VERSION__` 占位符？
+
+A: 这表示构建时未正确注入版本号。请检查 `tsup.config.ts` 中的 `define` 配置，或使用运行时读取模式。
+
+### Q: 版本号是否支持预发布标识？
+
+A: 验证功能支持预发布标识格式（如 `1.2.3-alpha`），但比较功能仅比较数字部分。
+
+## 许可证
+
+[MIT](LICENSE)
+
+## 相关资源
+
+- [小智客户端](https://github.com/shenjingnan/xiaozhi-client)
+- [语义化版本规范](https://semver.org/lang/zh-CN/)
+- [问题反馈](https://github.com/shenjingnan/xiaozhi-client/issues)
+
+---
+
+**作者**: xiaozhi-client
+**版本**: 1.10.9

package/dist/index.d.ts

@@ -53,6 +53,14 @@ declare class VersionUtils {
      * @returns 是否为有效的语义化版本号
      */
     static isValidVersion(version: string): boolean;
+    /**
+     * 查找 package.json 文件路径
+     *
+     * 尝试从多个可能的路径中查找 package.json 文件
+     *
+     * @returns package.json 文件路径，如果找不到则返回 null
+     */
+    private static findPackageJsonPath;
     /**
      * 运行时从 package.json 读取版本号
      */

package/dist/index.js

@@ -2,7 +2,7 @@ var __defProp = Object.defineProperty;
 var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
 
 // src/version-constants.ts
-var VERSION = "1.10.9";
+var VERSION = "2.0.0-beta.1";
 var APP_NAME = "xiaozhi-client";
 
 // src/VersionUtils.ts
@@ -73,6 +73,31 @@ var VersionUtils = class _VersionUtils {
     const versionRegex = /^\d+\.\d+\.\d+(-[a-zA-Z0-9.-]+)?(\+[a-zA-Z0-9.-]+)?$/;
     return versionRegex.test(version);
   }
+  /**
+   * 查找 package.json 文件路径
+   *
+   * 尝试从多个可能的路径中查找 package.json 文件
+   *
+   * @returns package.json 文件路径，如果找不到则返回 null
+   */
+  static findPackageJsonPath() {
+    const __filename = fileURLToPath(import.meta.url);
+    const currentDir = path.dirname(__filename);
+    const possiblePaths = [
+      // 从 packages/version/dist/version/index.js 到项目根目录的 package.json
+      path.join(currentDir, "..", "..", "..", "package.json"),
+      // 从 dist/version/index.js 到项目根目录的 package.json
+      path.join(currentDir, "..", "..", "package.json"),
+      // 全局安装环境
+      path.join(currentDir, "..", "..", "..", "..", "package.json")
+    ];
+    for (const packagePath of possiblePaths) {
+      if (fs.existsSync(packagePath)) {
+        return packagePath;
+      }
+    }
+    return null;
+  }
   /**
    * 运行时从 package.json 读取版本号
    */
@@ -81,23 +106,12 @@ var VersionUtils = class _VersionUtils {
       return _VersionUtils.cachedVersion;
     }
     try {
-      const __filename = fileURLToPath(import.meta.url);
-      const currentDir = path.dirname(__filename);
-      const possiblePaths = [
-        // 从 packages/version/dist/version/index.js 到项目根目录的 package.json
-        path.join(currentDir, "..", "..", "..", "package.json"),
-        // 从 dist/version/index.js 到项目根目录的 package.json
-        path.join(currentDir, "..", "..", "package.json"),
-        // 全局安装环境
-        path.join(currentDir, "..", "..", "..", "..", "package.json")
-      ];
-      for (const packagePath of possiblePaths) {
-        if (fs.existsSync(packagePath)) {
-          const packageJson = JSON.parse(fs.readFileSync(packagePath, "utf8"));
-          if (packageJson.version) {
-            _VersionUtils.cachedVersion = packageJson.version;
-            return packageJson.version;
-          }
+      const packagePath = _VersionUtils.findPackageJsonPath();
+      if (packagePath) {
+        const packageJson = JSON.parse(fs.readFileSync(packagePath, "utf8"));
+        if (packageJson.version) {
+          _VersionUtils.cachedVersion = packageJson.version;
+          return packageJson.version;
         }
       }
       _VersionUtils.cachedVersion = "unknown";
@@ -113,26 +127,15 @@ var VersionUtils = class _VersionUtils {
    */
   static getRuntimeVersionInfo() {
     try {
-      const __filename = fileURLToPath(import.meta.url);
-      const currentDir = path.dirname(__filename);
-      const possiblePaths = [
-        // 从 packages/version/dist/version/index.js 到项目根目录的 package.json
-        path.join(currentDir, "..", "..", "..", "package.json"),
-        // 从 dist/version/index.js 到项目根目录的 package.json
-        path.join(currentDir, "..", "..", "package.json"),
-        // 全局安装环境
-        path.join(currentDir, "..", "..", "..", "..", "package.json")
-      ];
-      for (const packagePath of possiblePaths) {
-        if (fs.existsSync(packagePath)) {
-          const packageJson = JSON.parse(fs.readFileSync(packagePath, "utf8"));
-          return {
-            version: packageJson.version || "unknown",
-            name: packageJson.name,
-            description: packageJson.description,
-            author: packageJson.author
-          };
-        }
+      const packagePath = _VersionUtils.findPackageJsonPath();
+      if (packagePath) {
+        const packageJson = JSON.parse(fs.readFileSync(packagePath, "utf8"));
+        return {
+          version: packageJson.version || "unknown",
+          name: packageJson.name,
+          description: packageJson.description,
+          author: packageJson.author
+        };
       }
       return { version: "unknown" };
     } catch (error) {

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/version-constants.ts","../src/VersionUtils.ts"],"sourcesContent":["/**\n * 版本号常量（构建时注入）\n *\n * 如果构建时能读取到 package.json，则为真实版本号\n * 否则为占位符，运行时从 package.json 读取\n */\nexport const VERSION = __VERSION__;\nexport const APP_NAME = __APP_NAME__;\n","/**\n * 版本管理工具\n *\n * 提供版本号获取、比较、验证等功能\n */\n\nimport fs from \"node:fs\";\nimport path from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\nimport { VERSION, APP_NAME } from \"./version-constants.js\";\n\n/**\n * 版本信息接口\n */\nexport interface VersionInfo {\n  version: string;\n  name?: string;\n  description?: string;\n  author?: string;\n}\n\n/**\n * 版本工具类\n */\nexport class VersionUtils {\n  private static cachedVersion: string | null = null;\n  private static cachedVersionInfo: VersionInfo | null = null;\n\n  /**\n   * 获取版本号\n   *\n   * 优先使用构建时注入的版本号常量\n   * 如果是占位符，则运行时从 package.json 读取\n   */\n  static getVersion(): string {\n    // 如果版本号是占位符，则运行时读取\n    if (VERSION === \"__VERSION__\") {\n      return VersionUtils.getRuntimeVersion();\n    }\n\n    // 使用构建时注入的版本号\n    return VERSION;\n  }\n\n  /**\n   * 获取完整版本信息\n   */\n  static getVersionInfo(): VersionInfo {\n    // 如果有缓存，直接返回\n    if (VersionUtils.cachedVersionInfo) {\n      return VersionUtils.cachedVersionInfo;\n    }\n\n    // 如果版本号是占位符，则运行时读取\n    if (VERSION === \"__VERSION__\") {\n      VersionUtils.cachedVersionInfo = VersionUtils.getRuntimeVersionInfo();\n      return VersionUtils.cachedVersionInfo;\n    }\n\n    // 使用构建时注入的版本号\n    VersionUtils.cachedVersionInfo = {\n      version: VERSION,\n      name: APP_NAME === \"__APP_NAME__\" ? undefined : APP_NAME,\n    };\n\n    return VersionUtils.cachedVersionInfo;\n  }\n\n  /**\n   * 比较版本号\n   *\n   * @param version1 第一个版本号\n   * @param version2 第二个版本号\n   * @returns 返回值：1 表示 version1 > version2，-1 表示 version1 < version2，0 表示相等\n   */\n  static compareVersions(version1: string, version2: string): number {\n    const v1Parts = version1.split(\".\").map(Number);\n    const v2Parts = version2.split(\".\").map(Number);\n    const maxLength = Math.max(v1Parts.length, v2Parts.length);\n\n    for (let i = 0; i < maxLength; i++) {\n      const v1Part = v1Parts[i] || 0;\n      const v2Part = v2Parts[i] || 0;\n\n      if (v1Part > v2Part) return 1;\n      if (v1Part < v2Part) return -1;\n    }\n\n    return 0;\n  }\n\n  /**\n   * 检查版本是否有效\n   *\n   * @param version 版本号字符串\n   * @returns 是否为有效的语义化版本号\n   */\n  static isValidVersion(version: string): boolean {\n    // 支持语义化版本号：1.2.3 或 1.2.3-alpha.1 或 1.2.3-beta.1+build.123\n    const versionRegex = /^\\d+\\.\\d+\\.\\d+(-[a-zA-Z0-9.-]+)?(\\+[a-zA-Z0-9.-]+)?$/;\n    return versionRegex.test(version);\n  }\n\n  /**\n   * 运行时从 package.json 读取版本号\n   */\n  private static getRuntimeVersion(): string {\n    // 如果有缓存，直接返回\n    if (VersionUtils.cachedVersion) {\n      return VersionUtils.cachedVersion;\n    }\n\n    try {\n      // 在 ES 模块环境中获取当前目录\n      const __filename = fileURLToPath(import.meta.url);\n      const currentDir = path.dirname(__filename);\n\n      // 尝试多个可能的 package.json 路径\n      const possiblePaths = [\n        // 从 packages/version/dist/version/index.js 到项目根目录的 package.json\n        path.join(currentDir, \"..\", \"..\", \"..\", \"package.json\"),\n        // 从 dist/version/index.js 到项目根目录的 package.json\n        path.join(currentDir, \"..\", \"..\", \"package.json\"),\n        // 全局安装环境\n        path.join(currentDir, \"..\", \"..\", \"..\", \"..\", \"package.json\"),\n      ];\n\n      for (const packagePath of possiblePaths) {\n        if (fs.existsSync(packagePath)) {\n          const packageJson = JSON.parse(fs.readFileSync(packagePath, \"utf8\"));\n          if (packageJson.version) {\n            VersionUtils.cachedVersion = packageJson.version;\n            return packageJson.version;\n          }\n        }\n      }\n\n      // 如果都找不到，返回默认版本\n      VersionUtils.cachedVersion = \"unknown\";\n      return \"unknown\";\n    } catch (error) {\n      console.warn(\"无法从 package.json 读取版本信息:\", error);\n      VersionUtils.cachedVersion = \"unknown\";\n      return \"unknown\";\n    }\n  }\n\n  /**\n   * 运行时从 package.json 读取完整版本信息\n   */\n  private static getRuntimeVersionInfo(): VersionInfo {\n    try {\n      const __filename = fileURLToPath(import.meta.url);\n      const currentDir = path.dirname(__filename);\n\n      const possiblePaths = [\n        // 从 packages/version/dist/version/index.js 到项目根目录的 package.json\n        path.join(currentDir, \"..\", \"..\", \"..\", \"package.json\"),\n        // 从 dist/version/index.js 到项目根目录的 package.json\n        path.join(currentDir, \"..\", \"..\", \"package.json\"),\n        // 全局安装环境\n        path.join(currentDir, \"..\", \"..\", \"..\", \"..\", \"package.json\"),\n      ];\n\n      for (const packagePath of possiblePaths) {\n        if (fs.existsSync(packagePath)) {\n          const packageJson = JSON.parse(fs.readFileSync(packagePath, \"utf8\"));\n          return {\n            version: packageJson.version || \"unknown\",\n            name: packageJson.name,\n            description: packageJson.description,\n            author: packageJson.author,\n          };\n        }\n      }\n\n      return { version: \"unknown\" };\n    } catch (error) {\n      console.warn(\"无法读取版本信息:\", error);\n      return { version: \"unknown\" };\n    }\n  }\n\n  /**\n   * 清除版本缓存\n   *\n   * 主要用于测试场景\n   */\n  static clearCache(): void {\n    VersionUtils.cachedVersion = null;\n    VersionUtils.cachedVersionInfo = null;\n  }\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/version-constants.ts","../src/VersionUtils.ts"],"sourcesContent":["/**\n * 版本号常量（构建时注入）\n *\n * 如果构建时能读取到 package.json，则为真实版本号\n * 否则为占位符，运行时从 package.json 读取\n */\nexport const VERSION = __VERSION__;\nexport const APP_NAME = __APP_NAME__;\n","/**\n * 版本管理工具\n *\n * 提供版本号获取、比较、验证等功能\n */\n\nimport fs from \"node:fs\";\nimport path from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\nimport { APP_NAME, VERSION } from \"./version-constants.js\";\n\n/**\n * 版本信息接口\n */\nexport interface VersionInfo {\n  version: string;\n  name?: string;\n  description?: string;\n  author?: string;\n}\n\n/**\n * 版本工具类\n */\nexport class VersionUtils {\n  private static cachedVersion: string | null = null;\n  private static cachedVersionInfo: VersionInfo | null = null;\n\n  /**\n   * 获取版本号\n   *\n   * 优先使用构建时注入的版本号常量\n   * 如果是占位符，则运行时从 package.json 读取\n   */\n  static getVersion(): string {\n    // 如果版本号是占位符，则运行时读取\n    if (VERSION === \"__VERSION__\") {\n      return VersionUtils.getRuntimeVersion();\n    }\n\n    // 使用构建时注入的版本号\n    return VERSION;\n  }\n\n  /**\n   * 获取完整版本信息\n   */\n  static getVersionInfo(): VersionInfo {\n    // 如果有缓存，直接返回\n    if (VersionUtils.cachedVersionInfo) {\n      return VersionUtils.cachedVersionInfo;\n    }\n\n    // 如果版本号是占位符，则运行时读取\n    if (VERSION === \"__VERSION__\") {\n      VersionUtils.cachedVersionInfo = VersionUtils.getRuntimeVersionInfo();\n      return VersionUtils.cachedVersionInfo;\n    }\n\n    // 使用构建时注入的版本号\n    VersionUtils.cachedVersionInfo = {\n      version: VERSION,\n      name: APP_NAME === \"__APP_NAME__\" ? undefined : APP_NAME,\n    };\n\n    return VersionUtils.cachedVersionInfo;\n  }\n\n  /**\n   * 比较版本号\n   *\n   * @param version1 第一个版本号\n   * @param version2 第二个版本号\n   * @returns 返回值：1 表示 version1 > version2，-1 表示 version1 < version2，0 表示相等\n   */\n  static compareVersions(version1: string, version2: string): number {\n    const v1Parts = version1.split(\".\").map(Number);\n    const v2Parts = version2.split(\".\").map(Number);\n    const maxLength = Math.max(v1Parts.length, v2Parts.length);\n\n    for (let i = 0; i < maxLength; i++) {\n      const v1Part = v1Parts[i] || 0;\n      const v2Part = v2Parts[i] || 0;\n\n      if (v1Part > v2Part) return 1;\n      if (v1Part < v2Part) return -1;\n    }\n\n    return 0;\n  }\n\n  /**\n   * 检查版本是否有效\n   *\n   * @param version 版本号字符串\n   * @returns 是否为有效的语义化版本号\n   */\n  static isValidVersion(version: string): boolean {\n    // 支持语义化版本号：1.2.3 或 1.2.3-alpha.1 或 1.2.3-beta.1+build.123\n    const versionRegex = /^\\d+\\.\\d+\\.\\d+(-[a-zA-Z0-9.-]+)?(\\+[a-zA-Z0-9.-]+)?$/;\n    return versionRegex.test(version);\n  }\n\n  /**\n   * 查找 package.json 文件路径\n   *\n   * 尝试从多个可能的路径中查找 package.json 文件\n   *\n   * @returns package.json 文件路径，如果找不到则返回 null\n   */\n  private static findPackageJsonPath(): string | null {\n    const __filename = fileURLToPath(import.meta.url);\n    const currentDir = path.dirname(__filename);\n\n    const possiblePaths = [\n      // 从 packages/version/dist/version/index.js 到项目根目录的 package.json\n      path.join(currentDir, \"..\", \"..\", \"..\", \"package.json\"),\n      // 从 dist/version/index.js 到项目根目录的 package.json\n      path.join(currentDir, \"..\", \"..\", \"package.json\"),\n      // 全局安装环境\n      path.join(currentDir, \"..\", \"..\", \"..\", \"..\", \"package.json\"),\n    ];\n\n    for (const packagePath of possiblePaths) {\n      if (fs.existsSync(packagePath)) {\n        return packagePath;\n      }\n    }\n\n    return null;\n  }\n\n  /**\n   * 运行时从 package.json 读取版本号\n   */\n  private static getRuntimeVersion(): string {\n    // 如果有缓存，直接返回\n    if (VersionUtils.cachedVersion) {\n      return VersionUtils.cachedVersion;\n    }\n\n    try {\n      const packagePath = VersionUtils.findPackageJsonPath();\n      if (packagePath) {\n        const packageJson = JSON.parse(fs.readFileSync(packagePath, \"utf8\"));\n        if (packageJson.version) {\n          VersionUtils.cachedVersion = packageJson.version;\n          return packageJson.version;\n        }\n      }\n\n      // 如果都找不到，返回默认版本\n      VersionUtils.cachedVersion = \"unknown\";\n      return \"unknown\";\n    } catch (error) {\n      console.warn(\"无法从 package.json 读取版本信息:\", error);\n      VersionUtils.cachedVersion = \"unknown\";\n      return \"unknown\";\n    }\n  }\n\n  /**\n   * 运行时从 package.json 读取完整版本信息\n   */\n  private static getRuntimeVersionInfo(): VersionInfo {\n    try {\n      const packagePath = VersionUtils.findPackageJsonPath();\n      if (packagePath) {\n        const packageJson = JSON.parse(fs.readFileSync(packagePath, \"utf8\"));\n        return {\n          version: packageJson.version || \"unknown\",\n          name: packageJson.name,\n          description: packageJson.description,\n          author: packageJson.author,\n        };\n      }\n\n      return { version: \"unknown\" };\n    } catch (error) {\n      console.warn(\"无法读取版本信息:\", error);\n      return { version: \"unknown\" };\n    }\n  }\n\n  /**\n   * 清除版本缓存\n   *\n   * 主要用于测试场景\n   */\n  static clearCache(): void {\n    VersionUtils.cachedVersion = null;\n    VersionUtils.cachedVersionInfo = null;\n  }\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xiaozhi-client/version",
-  "version": "1.10.9",
+  "version": "2.0.0-beta.1",
   "private": false,
   "repository": {
     "type": "git",

package/src/VersionUtils.ts

@@ -7,7 +7,7 @@
 import fs from "node:fs";
 import path from "node:path";
 import { fileURLToPath } from "node:url";
-import { VERSION, APP_NAME } from "./version-constants.js";
+import { APP_NAME, VERSION } from "./version-constants.js";
 
 /**
  * 版本信息接口
@@ -101,6 +101,35 @@ export class VersionUtils {
     return versionRegex.test(version);
   }
 
+  /**
+   * 查找 package.json 文件路径
+   *
+   * 尝试从多个可能的路径中查找 package.json 文件
+   *
+   * @returns package.json 文件路径，如果找不到则返回 null
+   */
+  private static findPackageJsonPath(): string | null {
+    const __filename = fileURLToPath(import.meta.url);
+    const currentDir = path.dirname(__filename);
+
+    const possiblePaths = [
+      // 从 packages/version/dist/version/index.js 到项目根目录的 package.json
+      path.join(currentDir, "..", "..", "..", "package.json"),
+      // 从 dist/version/index.js 到项目根目录的 package.json
+      path.join(currentDir, "..", "..", "package.json"),
+      // 全局安装环境
+      path.join(currentDir, "..", "..", "..", "..", "package.json"),
+    ];
+
+    for (const packagePath of possiblePaths) {
+      if (fs.existsSync(packagePath)) {
+        return packagePath;
+      }
+    }
+
+    return null;
+  }
+
   /**
    * 运行时从 package.json 读取版本号
    */
@@ -111,27 +140,12 @@ export class VersionUtils {
     }
 
     try {
-      // 在 ES 模块环境中获取当前目录
-      const __filename = fileURLToPath(import.meta.url);
-      const currentDir = path.dirname(__filename);
-
-      // 尝试多个可能的 package.json 路径
-      const possiblePaths = [
-        // 从 packages/version/dist/version/index.js 到项目根目录的 package.json
-        path.join(currentDir, "..", "..", "..", "package.json"),
-        // 从 dist/version/index.js 到项目根目录的 package.json
-        path.join(currentDir, "..", "..", "package.json"),
-        // 全局安装环境
-        path.join(currentDir, "..", "..", "..", "..", "package.json"),
-      ];
-
-      for (const packagePath of possiblePaths) {
-        if (fs.existsSync(packagePath)) {
-          const packageJson = JSON.parse(fs.readFileSync(packagePath, "utf8"));
-          if (packageJson.version) {
-            VersionUtils.cachedVersion = packageJson.version;
-            return packageJson.version;
-          }
+      const packagePath = VersionUtils.findPackageJsonPath();
+      if (packagePath) {
+        const packageJson = JSON.parse(fs.readFileSync(packagePath, "utf8"));
+        if (packageJson.version) {
+          VersionUtils.cachedVersion = packageJson.version;
+          return packageJson.version;
         }
       }
 
@@ -150,28 +164,15 @@ export class VersionUtils {
    */
   private static getRuntimeVersionInfo(): VersionInfo {
     try {
-      const __filename = fileURLToPath(import.meta.url);
-      const currentDir = path.dirname(__filename);
-
-      const possiblePaths = [
-        // 从 packages/version/dist/version/index.js 到项目根目录的 package.json
-        path.join(currentDir, "..", "..", "..", "package.json"),
-        // 从 dist/version/index.js 到项目根目录的 package.json
-        path.join(currentDir, "..", "..", "package.json"),
-        // 全局安装环境
-        path.join(currentDir, "..", "..", "..", "..", "package.json"),
-      ];
-
-      for (const packagePath of possiblePaths) {
-        if (fs.existsSync(packagePath)) {
-          const packageJson = JSON.parse(fs.readFileSync(packagePath, "utf8"));
-          return {
-            version: packageJson.version || "unknown",
-            name: packageJson.name,
-            description: packageJson.description,
-            author: packageJson.author,
-          };
-        }
+      const packagePath = VersionUtils.findPackageJsonPath();
+      if (packagePath) {
+        const packageJson = JSON.parse(fs.readFileSync(packagePath, "utf8"));
+        return {
+          version: packageJson.version || "unknown",
+          name: packageJson.name,
+          description: packageJson.description,
+          author: packageJson.author,
+        };
       }
 
       return { version: "unknown" };

package/src/__tests__/VersionUtils.test.ts

@@ -2,7 +2,7 @@
  * VersionUtils 单元测试
  */
 
-import { describe, it, expect, beforeEach } from "vitest";
+import { beforeEach, describe, expect, it } from "vitest";
 import { VersionUtils } from "../VersionUtils.js";
 
 describe("VersionUtils", () => {
@@ -21,8 +21,7 @@ describe("VersionUtils", () => {
     it("应该返回有效的版本号格式", () => {
       const version = VersionUtils.getVersion();
       // 版本号应该是数字点分隔格式，或者 "unknown"
-      const isValid =
-        version === "unknown" || /^\d+\.\d+\.\d+/.test(version);
+      const isValid = version === "unknown" || /^\d+\.\d+\.\d+/.test(version);
       expect(isValid).toBe(true);
     });
 
@@ -151,7 +150,9 @@ describe("VersionUtils", () => {
 
     it("应该接受带预发布和构建元数据的版本号", () => {
       expect(VersionUtils.isValidVersion("1.0.0-alpha+001")).toBe(true);
-      expect(VersionUtils.isValidVersion("1.0.0-beta+exp.sha.5114f85")).toBe(true);
+      expect(VersionUtils.isValidVersion("1.0.0-beta+exp.sha.5114f85")).toBe(
+        true
+      );
     });
 
     it("应该拒绝无效的版本号", () => {
@@ -208,7 +209,9 @@ describe("VersionUtils", () => {
       // 获取版本号，即使在某些环境中无法读取 package.json
       // 也应该返回 "unknown" 或有效的版本号
       const version = VersionUtils.getVersion();
-      expect(["unknown", "1.9.7"].includes(version) || /^\d+\.\d+\.\d+/.test(version)).toBe(true);
+      expect(
+        ["unknown", "1.9.7"].includes(version) || /^\d+\.\d+\.\d+/.test(version)
+      ).toBe(true);
     });
 
     it("应该处理 getRuntimeVersionInfo 的错误情况", () => {

package/tsup.config.ts

@@ -15,7 +15,7 @@ export default defineConfig({
     index: resolve(__dirname, "src/index.ts"),
   },
   format: ["esm"],
-  target: "node18",
+  target: "node20",
   outDir: "dist",
   clean: true,
   sourcemap: true,