如何高效升级 Cherry Studio：完整版本迭代与核心功能解析

【免费下载链接】cherry-studio 🍒 Cherry Studio is a desktop client that supports for multiple LLM providers. Support deepseek-r1 项目地址: https://gitcode.com/GitHub_Trending/ch/cherry-studio

Cherry Studio 是一款支持多 LLM 提供商的桌面客户端，支持 deepseek-r1 等模型。本文将详细解析 Cherry Studio 的版本迭代历史、升级路径以及新功能亮点，帮助用户快速掌握升级技巧，体验最新功能。

版本迭代路径解析

Cherry Studio 采用语义化版本控制，版本升级路径清晰可控。根据 docs/zh/references/app-upgrade.md 文档，主要版本迭代路径如下：

1.x 系列到 2.x 系列的升级

• v1.7.x 是 1.x 系列的最后版本
• v1.7.0 以下的用户必须先升级到 v1.7.0（或更高的 1.7.x 版本）
• v1.7.0 及以上的用户可以直接升级到 v2.x.x

2.x 系列到 3.x 系列的升级（未来规划）

未来将推出 v3.0 版本，用户需要先升级到 v2.8.0 作为中间版本，才能继续升级到 v3.x。这种分段升级策略确保了版本间的兼容性和数据迁移的安全性。

升级渠道与版本选择

Cherry Studio 提供多种升级渠道，满足不同用户的需求：

• 稳定版渠道（latest）：适合大多数用户，提供经过充分测试的稳定版本
• 测试版渠道（beta）：提供最新功能预览，适合喜欢尝鲜的用户
• 候选发布版渠道（rc）：发布前的候选版本，稳定性介于 beta 和正式版之间

用户可以根据自己的需求选择合适的渠道，系统会根据当前版本和请求渠道自动匹配最佳升级路径。

智能升级流程解析

Cherry Studio 的升级系统采用了智能匹配算法，确保用户能够顺利升级到合适的版本。以下是升级流程的核心步骤：

升级匹配逻辑

1. 获取用户当前版本和请求的渠道
2. 从配置文件中获取所有版本号，按语义化版本从大到小排序
3. 遍历排序后的版本列表，检查版本兼容性和渠道可用性
4. 返回最佳匹配的渠道配置

代码实现示例

function findCompatibleVersion(
  currentVersion: string,
  requestedChannel: UpgradeChannel,
  config: UpdateConfig
): ChannelConfig | null {
  // 获取所有版本号并从大到小排序
  const versions = Object.keys(config.versions).sort(semver.rcompare)

  for (const versionKey of versions) {
    const versionConfig = config.versions[versionKey]
    const channelConfig = versionConfig.channels[requestedChannel]

    // 检查版本兼容性和渠道可用性
    if (
      semver.gte(currentVersion, versionConfig.minCompatibleVersion) &&
      channelConfig !== null
    ) {
      return channelConfig
    }
  }

  return null // 没有找到兼容版本
}

常见升级场景示例

场景 1：v1.6.5 用户升级（低于 1.7）

• 当前版本: 1.6.5
• 请求渠道: latest
• 匹配结果: 1.7.0
• 操作: 提示用户升级到 1.7.0，这是升级到 v2.x 的必要中间版本

场景 2：v1.7.0 用户升级到最新版

• 当前版本: 1.7.0
• 请求渠道: latest
• 匹配结果: 2.0.0
• 操作: 直接升级到 2.0.0（当前最新稳定版）

场景 3：v1.7.2 用户升级到 RC 版本

• 当前版本: 1.7.2
• 请求渠道: rc
• 匹配结果: 2.0.0-rc.1
• 操作: 升级到 2.0.0-rc.1

升级配置文件解析

Cherry Studio 的升级配置文件采用 JSON 格式，包含版本信息、兼容性要求和渠道配置等内容。以下是配置文件的结构示例：

{
  "lastUpdated": "2025-01-05T00:00:00Z",
  "versions": {
    "1.6.7": {
      "minCompatibleVersion": "1.0.0",
      "description": "Last stable v1.7.x release - required intermediate version for users below v1.7",
      "channels": {
        "latest": {
          "version": "1.6.7",
          "feedUrls": {
            "github": "https://github.com/CherryHQ/cherry-studio/releases/download/v1.6.7",
            "gitcode": "https://gitcode.com/CherryHQ/cherry-studio/releases/download/v1.6.7"
          }
        },
        "rc": {
          "version": "1.6.0-rc.5",
          "feedUrls": {
            "github": "https://github.com/CherryHQ/cherry-studio/releases/download/v1.6.0-rc.5",
            "gitcode": "https://github.com/CherryHQ/cherry-studio/releases/download/v1.6.0-rc.5"
          }
        },
        "beta": {
          "version": "1.6.7-beta.3",
          "feedUrls": {
            "github": "https://github.com/CherryHQ/cherry-studio/releases/download/v1.7.0-beta.3",
            "gitcode": "https://github.com/CherryHQ/cherry-studio/releases/download/v1.7.0-beta.3"
          }
        }
      }
    },
    "2.0.0": {
      "minCompatibleVersion": "1.7.0",
      "description": "Major release v2.0 - required intermediate version for v2.x upgrades",
      "channels": {
        "latest": null,
        "rc": null,
        "beta": null
      }
    }
  }
}

升级优势与未来规划

升级系统优势

1. 灵活性: 支持任意复杂的升级路径
2. 可扩展性: 新增版本只需在配置文件中添加新条目
3. 可维护性: 配置与代码分离，无需发版即可调整升级策略
4. 多源支持: 自动根据地理位置选择最优配置源（GitHub/GitCode）
5. 版本控制: 强制中间版本升级，确保数据迁移和兼容性

未来扩展计划

• 支持更细粒度的版本范围控制（如 >=1.5.0 <1.8.0）
• 支持多步升级路径提示（如提示用户需要 1.5 → 1.8 → 2.0）
• 支持 A/B 测试和灰度发布
• 支持配置文件的本地缓存和过期策略

如何获取 Cherry Studio

要开始使用 Cherry Studio，只需克隆仓库并按照官方文档进行安装：

git clone https://gitcode.com/gh_mirrors/ch/cherry-studio
cd cherry-studio
# 按照安装说明进行操作

通过本文的介绍，相信您已经对 Cherry Studio 的版本迭代和升级流程有了全面的了解。选择合适的版本渠道，体验这款强大的多 LLM 提供商桌面客户端带来的高效 AI 辅助体验吧！

【免费下载链接】cherry-studio 🍒 Cherry Studio is a desktop client that supports for multiple LLM providers. Support deepseek-r1 项目地址: https://gitcode.com/GitHub_Trending/ch/cherry-studio