Cherry Studio 在 Windows 上如何先启用符号链接再克隆仓库？

Cherry Studio 在 Windows 上如何先启用符号链接再克隆仓库【免费下载链接】cherry-studio Cherry Studio 是一款支持多个 LLM 提供商的桌面客户端项目地址: https://gitcode.com/CherryHQ/cherry-studio如果你在 Windows 上准备从源码运行 Cherry Studiocherry-studio 仓库在克隆之前还有一步不能跳过先启用操作系统的符号链接支持再配置 Git然后才克隆仓库。项目的开发环境文档明确要求 Windows 开发者完成这一步否则需要在启用支持之后重新克隆。本文按 docs/contrib/development.md 中“Windows: Enable Symlinks”和“Project Setup”两节的原文给出完整的操作顺序。为什么克隆前必须先启用符号链接文档说明这个项目使用符号链接symlinks来同步AGENTS.md和 skills 等文件。因为 Windows 默认不允许普通账户创建符号链接所以文档要求Windows developers must enable symlink support before cloning。也就是说符号链接支持是克隆这个仓库的前置条件而不是可选优化。第一步启用 Windows 的符号链接支持文档给出两条二选一的路径启用开发者模式Developer Mode在系统设置中进入 Settings → Update Security → For developers打开 Developer Mode。授予创建符号链接的权限通过secpol.msc本地安全策略授予SeCreateSymbolicLinkPrivilege权限。两者任选其一即可文档用“or”并列给出。完成任一条路径后当前用户就具备了创建符号链接的条件。第二步配置 Git 并克隆仓库启用符号链接支持之后先配置 Gitgit config --global core.symlinks true这条命令写入的是 Git 全局配置--global作用范围是当前用户的所有仓库不只是 cherry-studio。然后克隆仓库git clone https://gitcode.com/CherryHQ/cherry-studio之前已经克隆过仓库怎么办文档给出的处理方式是在启用符号链接支持之后重新克隆re-clone仓库。如果你的仓库是在未启用符号链接支持时克隆的启用支持之后按上面的命令重新克隆一次即可而不是在原目录上修补链接。克隆后按同一文档继续搭建开发环境克隆完成后docs/contrib/development.md 的“Project Setup”一节给出了连续的后续命令nvm install corepack enable pnpm install cp .env.example .env pnpm dev各条命令在文档中的适用条件Node.js 版本由仓库根目录的 .node-version 定义当前仓库中该文件为24.11.1package.json 的engines字段进一步要求node 24.11.1 24.16.0。文档建议使用 nvm 或 fnm 这类版本管理器nvm install会按该文件安装对应版本。pnpm 版本锁定在 package.json 的packageManager字段执行corepack enable后会自动使用正确版本无需手动指定。环境变量cp .env.example .env复制出本地.env。启动pnpm dev是文档给出的开发启动命令。文档同时说明开发运行默认会在 Electron 默认userData目录后附加Dev后缀把本地开发数据与打包后的应用数据分开如果要同时运行多个开发实例可给每个实例设置唯一后缀例如在.env中写CS_DEV_USER_DATA_SUFFIXDevQuito或内联传入CS_DEV_USER_DATA_SUFFIXDevQuito pnpm dev文档对该后缀的限制是必须是单个路径组件不能包含路径分隔符、盘符冒号、* ? |、控制字符或结尾的点空值会回退为Dev违反规则的其他取值会直接停止开发运行以避免两个实例共用同一目录。这一环节完成后的判断依据需要说明的是文档没有给出单独验证“符号链接是否已生效”的检查命令。文档本身给出的判断与补救方式是符号链接负责同步AGENTS.md和 skills 等文件如果仓库是在未启用符号链接支持时克隆的在启用支持后重新克隆即可。对已按正确顺序先启用、再克隆操作的读者文档的直接下一步就是上面的 Project Setup 流程安装依赖并通过pnpm dev启动开发构建。完整的 Windows 符号链接启用步骤、IDE 配置与项目搭建命令均以 docs/contrib/development.md 为准。【免费下载链接】cherry-studio Cherry Studio 是一款支持多个 LLM 提供商的桌面客户端项目地址: https://gitcode.com/CherryHQ/cherry-studio创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考