Cherry Lite

轻量桌面 AI 助手：对话 + 翻译。
反馈 · 下载

Cherry Lite 从 Cherry Studio 裁剪而来，只保留助手对话和翻译。除了你自己配置的模型服务（以及你主动打开的可选能力），应用不会向其它云端发业务请求。

功能

• 对话：多模型、多话题、Markdown、代码高亮、附件
• 翻译：独立翻译页，历史记录留在本地
• 自备模型：自行绑定 OpenAI、Anthropic、Gemini、兼容接口、Ollama 等，不预置账号
• 可选能力：MCP、网页搜索、文档转 Markdown、OCR、划词助手、快捷助手
• 数据：本地备份 / 恢复 / 导入；可改数据目录
• 界面：浅色 / 深色；语言为简体中文、English

当前仓库的发布流水线只打 macOS（Apple Silicon 与 Intel）.dmg，用 Developer ID 签名并公证后发到 GitHub Releases。Windows / Linux 的打包脚本还在，但没有对应的云构建。

和完整版的差别

本仓库不是 Cherry Studio 官方产品，也不是功能超集。下面这些上游能力已经拿掉：

已移除	说明
知识库、笔记、绘图、MiniApp	产品面不再提供
Agent 会话 / 通道 / Skills、Claude Code、本地模型网关	运行时已裁掉
WebDAV / S3 / 坚果云	只留本地备份
会话导出（Notion、语雀、Joplin 等）	已删除
内置分析、匿名崩溃上报、测试通道	已删除
多语言界面	只保留 zh-CN、en-US

开发

需要 Node.js（见 .node-version）和 pnpm（见 package.json 的 packageManager）。

corepack enable
pnpm install
cp .env.example .env
pnpm dev

常用命令：

pnpm test          # 单元测试
pnpm test:e2e      # Electron e2e（需先构建）
pnpm typecheck
pnpm lint
pnpm build:mac     # 本地打 macOS 包

提交前跑通 pnpm lint、pnpm test、pnpm format。请从 main 开分支，提交用 git commit -S --signoff（至少 --signoff）做 DCO 签署。

macOS 云构建签名

签过并公证的包，用户下载后可以直接打开，不用再执行 xattr -cr。本地 pnpm build:mac 如果没有这些环境变量，仍会打未签名包。

在仓库 Settings → Secrets and variables → Actions 配置：

Secret	内容
CSC_LINK	Developer ID Application 的 .p12，整文件 base64
CSC_KEY_PASSWORD	导出 .p12 时的密码
APPLE_TEAM_ID	Apple Team ID
APPLE_API_KEY_P8	App Store Connect API Key（.p8）整文件 base64
APPLE_API_KEY_ID	该密钥的 10 位 Key ID
APPLE_API_ISSUER	App Store Connect 密钥页上的 Issuer UUID

Bundle ID 是 com.loadchange.CherryStudioLite。证书必须是 Developer ID Application，公证走 App Store Connect API Key，不需要应用专用密码。

贡献

欢迎针对本仓库提 Issue 和 PR。

上游与许可

本项目基于 CherryHQ/cherry-studio，沿用 GNU AGPL v3.0。

• 完整版官网、企业版、打赏和社区渠道属于上游，不适用于本仓库
• 商业咨询请走上游渠道，不要发到本仓库