Cherry Studio Code Mate 变更指南Gemini CLI 下线与 Antigravity CLI 迁移【免费下载链接】cherry-studio Cherry Studio 是一款支持多个 LLM 提供商的桌面客户端项目地址: https://gitcode.com/CherryHQ/cherry-studio导读自 2026-08-26 起Cherry Studio 的 Code Mate 不再向新用户提供 Gemini CLI转而推荐使用 Antigravity CLIagy。本文基于仓库变更记录 2026-08-26-gemini-cli-replaced.md结合 codeCliTools.ts、CodeCliService.ts、antigravity.ts 等源码实现说明该变更对用户的具体影响、界面表现以及新用户与存量用户各自的处理建议帮助读者完成从 Gemini CLI 到 Antigravity CLI 的平滑过渡。变更内容What changed本次变更的核心结论可以概括为两点Code Mate 对新用户不再提供 Gemini CLI 的安装入口工具列表中由Antigravity CLI可执行文件agy取而代之已有 Gemini CLI 安装的用户不受强制迁移影响已安装的 Gemini CLI 依然在工具列表中可见、可正常使用。该变更被标记为category: changed、severity: notice属于面向用户的行为变更通知而非破坏性变更breaking change 目录中的 low-severity 级别。它不涉及数据结构或配置文件的破坏也不要求用户立即执行任何操作。变更在源码中的落点工具列表的展示顺序在 cliTools.ts 中定义ANTIGRAVITY_CLI已排在GEMINI_CLI之前{ value: CodeCli.ANTIGRAVITY_CLI, label: code.cli_tools.antigravity_cli, icon: AntigravityCli }, { value: CodeCli.GEMINI_CLI, label: code.cli_tools.gemini_cli, icon: GeminiCli },而Code Mate 工具预设可执行文件名、npm 包名、安装方式、内置 Skill 目录名等元数据统一收敛在 codeCliTools.ts 的CODE_CLI_TOOL_PRESETS单一声明源中。其中两个关键预设对比如下字段Gemini CLIAntigravity CLI枚举 idCodeCli.GEMINI_CLIgemini-cliCodeCli.ANTIGRAVITY_CLIantigravity-cli可执行文件geminiagy包名google/gemini-cligoogle-antigravity/antigravity-cli安装方式npmaquaSkill 目录code-mate-geminicode-mate-antigravity可见 Gemini CLI 的预设并未被删除——它仍是预设表中的合法成员只是在新用户视角下不再作为默认推荐入口展示。这也印证了文档中现有安装依然可见可用的表述。对用户的影响Why this matters新用户看到的是 Antigravity CLI未安装过 Gemini CLI 的用户在 Code Mate 工具列表中将直接看到Antigravity CLI。这包括工具卡片与图标的展示Antigravity CLI 图标见 antigravity-cli.tsx安装、升级、卸载、启动等版本状态卡片VersionStatusCard提供商Provider与模型选择流程内置 Skill 的自动同步对应 code-mate-antigravity。存量用户详情页出现下线通知但功能保留已安装 Gemini CLI 的用户打开其详情页时页面顶部会渲染一条警示横幅。该逻辑位于 CodeCliContentPanel.tsx{selectedCliTool CodeCli.GEMINI_CLI ( Alert typewarning showIcon description{t(code.gemini_cli_discontinued)} classNameshadow-none / )}对应的多语言文案zh-cn.jsoncode.gemini_cli_discontinued: Gemini CLI 已下线请使用 Antigravity CLI。英文en-us.jsonGemini CLI has been discontinued. Use Antigravity CLI instead.该横幅同样被组件测试覆盖CodeCliPage.test.tsx选中 Gemini CLI 时断言横幅出现切换到其他工具时断言横幅消失。需要注意的是横幅只是提示不阻止任何操作——存量用户依然可以对该工具执行启动Launch、升级Upgrade、卸载Remove。为什么同时保留两类工具从 codeCli.ts 可以看到Gemini CLI 与 Antigravity CLI 都被同时列入两个能力集合LOGIN_CAPABLE_CLI_TOOLS两者都支持使用 CLI 自身账号登录own-login的无凭证运行模式GATEWAY_CAPABLE_CLI_TOOLS两者都能经由 Cherry API 网关Unified Gateway路由因为网关暴露了 Gemini 方言/v1beta/models/*。也就是说两者在登录与网关路由能力上完全等价。保留 Gemini CLI 预设是为了让已安装用户在过渡期内不受打扰移除新用户入口则是为了让新装机用户默认采用官方推荐的新工具。用户应该怎么做What the user should do新用户直接使用 Antigravity CLI对于全新安装无需任何额外操作打开 Code Mate 工具列表选择Antigravity CLI点击安装由 BinaryManager 通过 aqua 拉取google-antigravity/antigravity-cli见 codeCliTools.ts选择提供商与模型后即可启动。启动后内置 Skill 也会随安装自动同步reconcileCliSkills见 CodeCliService.tsCode Mate 的 Agent 可以通过 SKILL.md 描述的方式以无头模式调用agy完成仓库分析与编码任务。存量用户继续使用或按需迁移继续使用无需任何操作Gemini CLI 保持可见、可用可继续启动、升级、卸载按需迁移在方便时安装 Antigravity CLI 并切换到新工具即可。迁移不涉及配置文件破坏Gemini CLI与Antigravity CLI是相互独立的工具条目互不依赖、互不冲突。源码纵深Antigravity CLI 在 Code Mate 中的启动链路了解启动链路有助于判断迁移后的行为差异。Code Mate 的统一启动入口是CodeCliService.run()CodeCliService.ts对 Antigravity CLI 走专用分支if (cliTool CodeCli.ANTIGRAVITY_CLI normal) { const launchConfig await prepareAntigravityLaunch(normal) ... Object.assign(env, launchConfig.env) const geminiDirArg ... const modelArg ... baseCommand ${baseCommand} ${geminiDirArg} --model ${modelArg} }prepareAntigravityLaunch()antigravity.ts负责三件事凭证注入从所选提供商获取轮换后的 API Key写入GEMINI_API_KEY环境变量地址注入直连模式通过resolveGeminiBaseUrl推导 Gemini 兼容端点写入GOOGLE_GEMINI_BASE_URL网关模式下则把模型格式化为gemini-api://providerId/modelId形式指向本地 API 网关地址隔离配置在专用目录下写入一份隔离的 settings 文件强制modelProvider: geminiensureGeminiModeSettings文件权限为0o600并以--gemini_dir参数传给 CLI避免污染用户主目录下的全局配置。几点值得注意的安全设计模型 ID 在拼接进 shell 命令前会经过isShellSafeModelId校验拒绝包含 shell 元字符的非法 IDantigravity.ts网关模式下若 providerId 包含分隔符/会直接拒绝启动防止寻址错误antigravity.ts校验失败发生在写入 settings 之前保证一次失败的启动不会残留配置源码注释明确说明了该顺序。作为对比Gemini CLI 分支CodeCliService.ts设置了GEMINI_CLI_TRUST_WORKSPACEtrue绕过新目录不被信任导致的交互式 API Key 输入并通过--model参数显式传递模型网关模式下还会强制GOOGLE_GENAI_API_VERSIONv1beta防止用户 shell 中过期的v1版本变量重定向请求路径。无头调用方式Agent 视角内置 Skill code-mate-antigravity/SKILL.md 给出了agy的无头调用约定agy -p prompt --output-format json要点包括先command -v agy确认可用性以单个带引号参数传入 prompt解析 JSON 输出的status字段判断成败非成功状态即失败error字段携带原因绝不启动交互式会话或认证流程——未登录时agy会返回authentication failed or timed out此时应请用户在 Code Mate 中完成 Antigravity 设置而不是代替用户输入凭证。无头模式继承用户设置中的权限模式默认自动批准工作区内读写因此对只读任务应使用可丢弃副本或只读副本且禁止传入--dangerously-skip-permissions。常见疑问Q1下线的横幅会不会拦截我的操作不会。横幅仅是Alert提示组件CodeCliContentPanel.tsx详情页的版本状态卡片安装/升级/卸载/启动照常渲染可用。Q2我可以用自己的账号登录 Antigravity CLI 吗可以。Antigravity CLI 与 Gemini CLI 一样属于LOGIN_CAPABLE_CLI_TOOLScodeCli.ts支持使用 CLI 自身登录的无凭证运行模式own-login此时不注入 Cherry 提供商凭证CLI 回退到其自身保存的账号登录。Q3Antigravity CLI 可以走 Cherry 统一网关吗可以。两者都属于GATEWAY_CAPABLE_CLI_TOOLScodeCli.ts网关模式下模型以gemini-api://形式寻址真实提供商密钥不会落盘任何模型都能经由网关的 Gemini 方言转换访问。Q4迁移会导致我的 Gemini CLI 配置文件丢失吗不会。两者是独立的工具条目各自的配置目录与二进制互不共享本次变更不涉及任何配置文件迁移或数据结构破坏。小结本次变更是一次低影响度的默认推荐切换Code Mate 对新用户以Antigravity CLIagy取代Gemini CLI作为默认推荐存量用户的 Gemini CLI 安装保持完全可用仅在详情页展示一条已下线请使用 Antigravity CLI的提示横幅。从源码实现看两者在提供商注入、网关路由、自带登录等能力上完全等价因此迁移成本极低——新用户直接选用 Antigravity CLI存量用户可继续使用或按需迁移无需任何破坏性操作。【免费下载链接】cherry-studio Cherry Studio 是一款支持多个 LLM 提供商的桌面客户端项目地址: https://gitcode.com/CherryHQ/cherry-studio创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考