Cherry Studio 命令行实战6步跑起最新版一条 curl 让脚本用上 AI【免费下载链接】cherry-studioAI productivity studio with smart chat, autonomous agents, and 300 assistants. Unified access to frontier LLMs项目地址: https://gitcode.com/GitHub_Trending/ch/cherry-studioCherry Studio 是个桌面 AI 效率应用能聊天、跑 Agent、接 300 多个助手平时你基本靠鼠标就能搞定一切。但有三件事绕不开终端想跑最新源码、想让自己的脚本调用 Cherry Studio 里配好的模型、出了问题想抓现场。这篇只讲这两件正事——用 pnpm 把项目跑起来以及用 API Gateway 从命令行驱动它命令全部来自仓库真实配置没有一条是编的。在终端把项目跑起来什么时候需要这一步你想体验仓库里比正式包新的功能或者要参与开发、二次打包。Cherry Studio 基于 Electron整个开发流程围绕 pnpm 脚本组织官方流程在 开发指南 里写得很清楚。怎么做先装对 Node.js——版本固定在仓库的.node-version文件里用 nvm 会自动装对pnpm 版本锁在package.json的packageManager字段corepack 会自动切换不用手动管。然后就是安装依赖、建环境文件、启动git clone https://gitcode.com/GitHub_Trending/ch/cherry-studio cd cherry-studio nvm install corepack enable pnpm install pnpm devpnpm dev启动的是开发态应用它会往 Electron 的数据目录后面追加Dev后缀和你正式安装的 Cherry Studio 数据互不干扰放心跑。日常开发会用到的命令其实就这几个命令干什么pnpm dev启动开发实例自动下载二进制依赖pnpm test跑全部单测main / renderer / 各子包pnpm debug带远程调试端口启动浏览器输chrome://inspect抓界面现场pnpm build:mac/build:win/build:linux按你的系统打包正式安装版注意三处坑。第一Windows 用户克隆前要先开启开发者模式并执行git config --global core.symlinks true否则仓库里的符号链接文件会出错——这是开发指南里单独列出来的前置步骤。第二同时跑多个开发实例时别撞数据目录给每个实例设个独立后缀就行比如CS_DEV_USER_DATA_SUFFIXDevParis pnpm dev规则很简单单一路径段别用路径分隔符。第三改完代码别只靠眼看pnpm test覆盖主进程、渲染进程和各个packages子包提交前跑一遍能拦下大部分低级问题。一条 curl让外部工具用上 Cherry Studio什么时候需要这一步你在用某个只认 OpenAI 接口的开源工具或者写了个脚本想批量调用模型但密钥和模型都配在 Cherry Studio 里。这时候别到处建中转服务——Cherry Studio 自带的 API Gateway 就是干这个的它在本地起一个 HTTP 服务默认监听127.0.0.1:23333同时说 OpenAI、Anthropic、Gemini 三种语言外加 Cherry 自己的 REST 和 MCP 端点。你可以把它理解成一个翻译前台后面接的是你在 Cherry Studio 里配好的所有提供商和模型。三步启用在设置里找到工具下的 API 网关入口开启它。第一次启动会自动生成一个cs-sk-开头的 API 密钥界面上可以直接复制或重新生成端口默认 23333可改。确认服务活着curl http://127.0.0.1:23333/health返回里带status、timestamp和version看到正常响应就说明网关在跑了。 3. 发第一个请求。所有受保护的路由都要带密钥Bearer或x-api-key都行模型写提供商ID:模型ID的形式curl http://127.0.0.1:23333/v1/chat/completions \ -H Authorization: Bearer 你的API密钥 \ -H Content-Type: application/json \ -d {model:anthropic:claude-sonnet-4-6, messages:[{role:user,content:你好}]}常用端点就记这几个完整的在 API Gateway 参考文档 里端点用途GET /health健康检查不用密钥GET /v1/models列出可用模型格式就是providerId:modelIdPOST /v1/chat/completionsOpenAI 对话接口支持流式POST /v1/messagesAnthropic 风格接口GET /v1/knowledge-bases/search跨知识库语义检索注意什么网关和界面共用同一套消息引擎但它的请求不落库——从网关发起的对话不会存进你的 Cherry Studio 会话里这是设计使然不是 bug。另外两个超时参数心里有数就行单请求上限 5 分钟流式响应空闲超过 20 分钟会被掐断。想要完整的接口文档浏览器打开http://127.0.0.1:23333/openapi有交互式文档页只想要机器可读的 JSON 规格就访问/openapi/json这个完全离线可用。打包和排查发布前必走的两条命令线功能开发完、接口联调通离能给别人用的安装包还差一步验证和打包。测试方面pnpm test是全量入口也可以按子包跑比如pnpm test:renderer只测界面层改数据层代码后建议先跑pnpm test:main因为主进程测前会重建better-sqlite3原生模块耗时最长。调试方面前面提过pnpm debug会以 9222 端口开远程调试启动后在浏览器地址栏输chrome://inspect就能像调试网页一样看界面进程流式渲染卡顿、状态不同步这类问题在这里最好抓。最后按系统选一条打包命令产物就在这个平台对应的安装包里pnpm test pnpm build:mac # macOS pnpm build:win # Windows pnpm build:linux # Linux注意什么打包前脚本会先跑类型检查报错会在打包前就拦住你这是好事别急着绕过去。Linux 下的架构选择和原生模块预构建有些细节仓库里的 Linux 打包说明有专节讲按自己发行版对号入座即可。小结核心收获就五条跑源码认准nvm installcorepack enablepnpm installpnpm dev这条线版本管理都是自动的Windows 克隆前先开符号链接支持能省掉一大类诡异问题API Gateway 默认端口 23333密钥自动生成/health是最快的自检手段网关请求的模型格式是提供商ID:模型ID且这类请求不写入 Cherry Studio 的会话记录交付前走pnpm testpnpm build:xxx两步调试用pnpm debug配合chrome://inspect想再深一层的话两个方向值得看一是 docs/references/ai/ 下的系列文档讲清了AiStreamManager和消息流在界面、IM 渠道、API 网关之间是怎么共享的二是src/main/features/apiGateway/源码请求怎么被翻译成各厂商协议的适配逻辑全在那读完你对网关这两个字会有完全不同的体感。【免费下载链接】cherry-studioAI productivity studio with smart chat, autonomous agents, and 300 assistants. Unified access to frontier LLMs项目地址: https://gitcode.com/GitHub_Trending/ch/cherry-studio创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考