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），仅供参考