尧图网络 高端网站定制 · 原创设计
免费咨询热线
400-888-6620
免费获取方案
Cherry Studio 开发环境怎么配置?Node、pnpm 与 Windows 符号链接准备
Cherry Studio 开发环境怎么配置Node、pnpm 与 Windows 符号链接准备【免费下载链接】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要在本地把 Cherry Studio 跑起来做开发需要完成三件准备工作装对 Node 版本、启用正确版本的 pnpm以及在 Windows 上提前开启符号链接支持——文档明确要求 Windows 开发者必须在 clone 仓库之前就启用符号链接。完成后的目标是执行pnpm dev启动开发实例并让本地开发数据与打包后的应用数据隔离。本文的命令与限制均来自 docs/contrib/development.md 和仓库根目录的配置文件。先确认版本要求配置前先看仓库里写死的三个版本约束Node.js.node-version与.nvmrc均为24.11.1package.json的engines字段要求node 24.11.1 24.16.0且.npmrc设置了engine-stricttrueNode 版本不在此范围内时依赖安装会被拒绝。pnpm版本锁定在package.json的packageManager字段中当前值为pnpm11.8.0带 hash 的完整 pin。Windows 上先开启符号链接项目在仓库内使用符号链接同步AGENTS.md、skills 等文件例如根目录下AGENTS.md - CLAUDE.md。Windows 上不开启符号链接权限clone 出来的仓库链接会缺失因此这两步要在 clone或重新 clone之前完成开启开发者模式Settings → Update Security → For developers或者通过secpol.msc授予SeCreateSymbolicLinkPrivilege权限。二选一即可。配置 Git注意这是修改全局 Git 配置的命令git config --global core.symlinks true在开启符号链接支持之后再 clone 仓库如果此前已经 clone 过需要重新 clone。macOS 和 Linux 不需要这一步直接从下一节的 Node 安装开始。安装 Node.js文档推荐用版本管理器如 nvm 或 fnm按.node-version自动安装nvm install这条命令会读取仓库中的版本文件装入24.11.1恰好满足engines的范围24.11.1 24.16.0。启用 pnpmpnpm 版本由packageManager字段锁定启用 corepack 后会自动使用该版本无需手动指定corepack enable安装依赖并准备环境变量pnpm install然后复制环境变量模板cp .env.example .env.env.example 中包含NODE_OPTIONS内存上限、API_KEY、BASE_URL、MODEL、CSLOGGER_MAIN_LEVEL/CSLOGGER_RENDERER_LEVEL日志级别等项其中多开实例用的CS_DEV_USER_DATA_SUFFIX默认是注释状态需要时再打开。启动开发实例pnpm dev按 package.json 中dev脚本的定义这条命令会依次执行重建better-sqlite3的 Electron 原生模块rebuild:electron、下载二进制资源download:binaries需要联网、构建 utility-process 产物最后启动electron-vite dev。默认情况下开发实例会在 Electron 默认userData目录后追加Dev后缀把本地开发数据与打包应用的数据分开可以用这个目录是否独立生成来判断开发数据确实隔离了。同时跑多个开发实例如果要在同一台机器上并行多个开发实例给每个实例一个唯一后缀。可以写在.env里CS_DEV_USER_DATA_SUFFIXDevQuito也可以在启动时内联传入CS_DEV_USER_DATA_SUFFIXDevQuito pnpm dev CS_DEV_USER_DATA_SUFFIXDevParis pnpm dev后缀有明确规则必须是单个路径组件不能含路径分隔符、盘符冒号、* ? |、控制字符或结尾的点。空白值会回退到Dev违反规则的取值不会静默回退而是直接停止开发运行——这是文档给出的失败判定方式如果启动时报错退出先检查后缀写法。IDE 配置可选按编辑器选择其一即可不影响pnpm dev本身能否运行VS Code 系编辑器Cursor 等推荐扩展列在 .vscode/extensions.json 中包括 ESLint、EditorConfig、i18n Ally、Tailwind CSS、Vitest Explorer、oxc 扩展。Zed先安装 Oxc extension用于 Oxfmt 和 Oxlint再把示例配置复制到本地配置该文件被 git 忽略可自由修改cp .zed/settings.json.example .zed/settings.json验证、调试与后续操作需要调试开发实例时执行pnpm debug然后在浏览器输入chrome://inspect查看。本地跑测试pnpm test。环境配好后如需产出安装包文档给出的命令按平台分别为pnpm build:win、pnpm build:mac、pnpm build:linux其中架构相关命令和better-sqlite3prebuild 的工作流在 docs/contrib/linux-packaging.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),仅供参考
RELATED

相关推荐

AI研究偏好建模:面向科研对齐的可解释偏好学习方法

AI研究偏好建模:面向科研对齐的可解释偏好学习方法

1. 项目概述:这不是调参,是给AI装上“价值罗盘” “AI 研究偏好模型”——这六个字最近在学术圈和工程团队的茶水间高频出现,但很多人听到的第一反应是:“又一个新名词?是不是就是RLHF(基于人类反馈的强化学…

📅 2026/9/13 9:14:37
Unreal Engine 5.7 网络与多人游戏实战指南:属性复制、RPC 与服务器权威架构全解析

Unreal Engine 5.7 网络与多人游戏实战指南:属性复制、RPC 与服务器权威架构全解析

Unreal Engine 5.7 网络与多人游戏实战指南:属性复制、RPC 与服务器权威架构全解析 【免费下载链接】Claude-Code-Game-Studios Turn Claude Code into a full game dev studio — 49 AI agents, 72 workflow skills, and a complete coordination system mirroring…

📅 2026/9/13 9:14:37
AI技术落地挑战与解决方案:从实验室到产业应用

AI技术落地挑战与解决方案:从实验室到产业应用

1. AI投资热潮与企业落地现状的矛盾最近两年AI领域的投资热度持续攀升,各大科技巨头和风投机构都在疯狂加码。但一个耐人寻味的现象是:根据最新行业调研,只有1%的企业声称自己部署了"成熟"的AI解决方案。这个数字与动辄数十亿的投资…

📅 2026/9/13 9:14:37
MORE NEWS

更多资讯

📰

OmniRoute 发布检查清单:从版本号、OpenAPI 契约到 CI 同步守卫的完整发布流程

OmniRoute 发布检查清单:从版本号、OpenAPI 契约到 CI 同步守卫的完整发布流程 【免费下载链接】OmniRoute Never stop coding. Free MIT AI gateway: one endpoint, 352 providers (150 free), 1200 models Kimi, Claude, GPT, Gemini, GLM, DeepSeek, MiniMax. Wo…

📰

形参对实参的影响:值传递与引用传递的工程实践指南

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

📰

marimo 云服务示例实战:用 uv 沙箱运行 GCP 数据应用,用 Modal 部署 GPU 笔记本与应用

marimo 云服务示例实战:用 uv 沙箱运行 GCP 数据应用,用 Modal 部署 GPU 笔记本与应用 【免费下载链接】marimo A reactive notebook for Python — run reproducible experiments, query with SQL, execute as a script, deploy as an app, and version…

📰

AI Agent多意图路由与查询分发技术解析

1. AI Agent架构中的核心挑战与解决方案在构建现代AI智能体系统时,我们常常面临一个根本性矛盾:用户习惯用自然语言表达需求,而系统底层需要结构化指令才能精准执行。这种语义鸿沟直接影响了AI Agent的实用性和用户体验。以一个典型IT支持场景…

📰

超帧(HyperFrame)设计指南:解决多传感器数据同步与封装的工程方法论

干了这么多年数据采集和实时系统,我慢慢发现一个规律:凡是涉及多路数据同步的场景,不管前端怎么折腾,最后几乎都会收敛到同一个思路上——把多个杂乱无章的帧,打包成一个更大的结构来统一处理。这个结构就是 hyperfram…

📰

CogVideoX LoRA 微调手把手:单卡完成定制视频生成的完整路径

CogVideoX LoRA 微调手把手:单卡完成定制视频生成的完整路径 【免费下载链接】CogVideo text and image to video generation: CogVideoX (2024) and CogVideo (ICLR 2023) 项目地址: https://gitcode.com/GitHub_Trending/co/CogVideo CogVideoX 是清华大学…

TODAY

今日更新

THIS WEEK

本周精选

THIS MONTH

本月热门

读完文章,想聊聊您的网站?

告诉我们您的行业与需求,资深顾问一对一梳理方案与报价,全程免费。

📞 💬