Cherry Studio 命令行实战手册:从开发到构建
Cherry Studio 命令行实战手册从开发到构建【免费下载链接】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 是一个统一接入 300 大模型的 AI 桌面工作台支持智能聊天、自主 Agent 和知识库。它没有独立的cherry-studio可执行文件真正的命令行入口是仓库自带的 pnpm 脚本集——开发、测试、打包、文档校验全靠它们完成。想把它跑起来、改起来、发出去下面这套流程够用了。五分钟跑通第一条命令先确认环境。项目要求 Node.js 24.11.1以.node-version文件为准包管理器锁定为 pnpm# 安装 Node 24.11.1读取 .node-version 自动匹配 nvm install # 启用 corepack让 pnpm 版本与 package.json 锁定一致 corepack enable # 安装依赖含 better-sqlite3 等原生模块编译 pnpm install装完依赖后启动开发模式# 拉取二进制资源并重建 electron 原生依赖然后启动 pnpm devElectron 窗口弹出、控制台出现 vite 就绪日志就说明环境通了。跑通了就行。⚠️ 默认开发模式会在 userData 目录追加Dev后缀与正式安装版的数据隔离不用担心污染日常使用的配置。核心任务场景并行跑多个开发实例改 UI 时经常需要一边跑主分支、一边试新改动。在.env里设置CS_DEV_USER_DATA_SUFFIX即可为每个实例指定独立数据目录# 两个终端同时跑各自独立的数据目录 CS_DEV_USER_DATA_SUFFIXDevQuito pnpm dev CS_DEV_USER_DATA_SUFFIXDevParis pnpm dev后缀必须是单段路径不能含分隔符或特殊字符。验证方式两个实例的会话互不可见说明隔离生效。调试渲染进程pnpm debug会开启--inspect和远程调试端口 9222# 以可调试模式启动应用 pnpm debug然后打开任意 Chrome 内核浏览器访问chrome://inspect点进主窗口的 DevTools 就能打断点。确认成功能在 Sources 面板加载out/下的源码并对渲染进程设断点。验证代码质量再提交CI 的完整检查链是pnpm ci本地建议先跑快速三连pnpm typecheck # 三个工程node/web/aiCore并行类型检查 pnpm test:main # 仅跑主进程测试 pnpm docs:check # 文档链接、结构、frontmatter、索引四项校验三条命令全部退出码为 0 才算干净。docs:check这类脚本能拦住改了文档忘了同步索引这类低级失误。构建目标平台的安装包按平台选择构建命令产物输出到dist/pnpm build:linux # 或 build:mac / build:win⚠️ 打包前先执行pnpm download:binariesdev脚本会自动做纯构建不会。验证方式dist/下出现对应平台的安装包文件。自动化工作流一个实用的提交前自检脚本把散落的检查串成一条流水线#!/usr/bin/env bash # precommit-gate.sh提交前完整自检 set -euo pipefail # 1. 格式与 lintbiome eslint oxlint echo 检查代码风格... pnpm lint # 2. 类型检查覆盖 node、web、aiCore 三个工程 echo 类型检查... pnpm typecheck # 3. 文档完整性链接/结构/frontmatter/索引 echo 文档校验... pnpm docs:check # 4. 按改动范围选择测试子集全量留给 CI echo 主进程测试... pnpm test:main echo ✅ 自检通过可以提交每段输出都有独立阶段名哪一步挂了从日志一眼能定位。把脚本放在你本地克隆目录之外比如 home 目录的 scripts 文件夹避免污染仓库——仓库本身是只读的别往里加文件。问题速查现象pnpm install卡在 better-sqlite3 编译。原因本地 Node 版本与.node-version不一致electron-rebuild 找不到匹配 ABI。解法nvm install重新装 24.11.1 后再pnpm install。现象pnpm dev直接报 pnpm 版本错误。原因没启用 corepack系统里是旧版 pnpm。解法corepack enable后重跑corepack 会按packageManager字段自动拉对版本。现象两个开发实例会话串了。原因没设CS_DEV_USER_DATA_SUFFIX都落到默认Dev目录。解法给每个实例设不同的单段后缀比如DevA、DevB。现象Windows 上 symlink 报错导致安装失败。原因未开启符号链接权限。解法开启开发者模式并执行git config --global core.symlinks true然后重新 clone。继续深入Cherry Studio 的命令行本质上是脚本驱动的工程化工作台pnpm dev出窗口、pnpm ci出结论、pnpm build:*出产物。更多细节看 docs/contrib/development.md想理解消息在主进程与渲染进程间怎么流转这张架构图值得细看命令体系的设计说明在 docs/references/command/README.md内部应用的命令注册机制快捷键、菜单、分发都写在那里。【免费下载链接】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),仅供参考

相关新闻

ChatGPT个人AGI智能体实战:Codex CLI配置与工作流搭建

ChatGPT个人AGI智能体实战:Codex CLI配置与工作流搭建

把 ChatGPT 当作个人 AGI 智能体来用,已经不是概念验证,而是不少开发者正在实践的日常。很多人对 AGI 智能体的理解还停留在“会聊天”的阶段,但真正能承担个人助手任务的系统,需要把大模型、工具调用、任务分解、结果验证和错误恢…

2026/11/14 23:43:30 阅读更多 →
DeepSeek Harness接入ModLens视觉插件,配置GLM-5.3 Flash识图技能全指南

DeepSeek Harness接入ModLens视觉插件,配置GLM-5.3 Flash识图技能全指南

1. 这篇文章真正要解决的问题 做过 Agent 开发的人应该都有同感:文本对话模型再聪明,遇到图纸、截图、UI 原型、表单图片、验证码图片时,一下子就失明了。你辛辛苦苦把上下文喂进去,模型只能说“我无法查看图片”。在真实项目里&a…

2026/11/16 17:14:13 阅读更多 →
Codex持久模式实战:解决AI编码代理上下文丢失问题

Codex持久模式实战:解决AI编码代理上下文丢失问题

从“跑任务跑到一半上下文丢了”这个痛点切入吧。以前在项目里用 Codex 处理跨文件重构时,经常遇到一个尴尬问题:对话稍微长一点,上下文就乱了,关掉终端再重开,之前的思路和决策记录全部归零,Agent 又要重新…

2026/11/7 0:48:07 阅读更多 →

最新新闻

Electron桌面应用开发实战:从环境搭建到打包发布全流程

Electron桌面应用开发实战:从环境搭建到打包发布全流程

做前端这些年,我大部分时间都在跟浏览器标签页打交道,直到第一次把桌面应用跑起来,才发现原来自己一直被限制在地址栏和刷新按钮围起来的框框里。Electron这个词,最开始是在某段时间频繁出现在同事的讨论里,一个用HTML…

2026/11/21 23:27:35 阅读更多 →
滑盖智能锁T109深度解析:结构原理、安装调试与故障排查

滑盖智能锁T109深度解析:结构原理、安装调试与故障排查

简介:亚太天能T109滑盖智能锁产品说明书是一份PDF格式的官方技术文档,主要面向智能锁安装人员、终端用户及售后维护者,帮助快速掌握产品安装、配置与常见故障处理。全包仅1个PDF文件,大小4.37MB,内容结构清晰&#xff…

2026/11/21 23:27:35 阅读更多 →
PMSM弱磁控制原理与Simulink建模:高速AGV驱动系统设计指南

PMSM弱磁控制原理与Simulink建模:高速AGV驱动系统设计指南

上个月我在调试一台高速AGV的驱动系统,整车要求空载跑到8m/s,电机转速已经拉到额定点,驱动器的输出电压也顶到了母线电压极限附近。再往上踩速度指令,转速纹丝不动,三相电流反而开始震荡。那会儿我的第一反应就是&…

2026/11/21 23:27:35 阅读更多 →
C++核心知识点:从内存管理到STL的实战指南

C++核心知识点:从内存管理到STL的实战指南

C 这门语言我前前后后折腾了十几年,用它写过嵌入式驱动、做过游戏服务端,也搭过基础组件库。每次看到新人一头扎进"C 核心知识点"这个搜索词,我其实挺感慨的——这门语言的难点从来不是语法多,而是知识点之间的耦合太深…

2026/11/21 23:27:35 阅读更多 →
T109滑盖智能锁怎么装?安装调试与故障排查全攻略

T109滑盖智能锁怎么装?安装调试与故障排查全攻略

简介:亚太天能T109滑盖智能锁产品说明书以PDF格式发布,适合智能锁用户、安装人员与售后维修人员阅读。内容围绕T109系列指纹密码刷卡锁展开,先介绍前面板、后面板、锁体、机械钥匙、电池盒盖等部件名称与功能,再给出完整安装步骤&…

2026/11/21 23:27:36 阅读更多 →
LLM知识降熵:从信息垄断到理解权下放

LLM知识降熵:从信息垄断到理解权下放

你有没有过这种经历:翻开源码注释、论文摘要或者一份专业报告,每个字都认识,连在一起却像天书。想找人聊聊,身边要么没人懂,要么懂的懒得跟你解释。后来我试着把同一段内容丢给一个大语言模型,几秒钟之后&a…

2026/11/21 23:27:37 阅读更多 →

日新闻

周新闻

月新闻