获取源码
确认源码权限、克隆独立仓库，保存自己的代码并区分应复制的本地文件。
这篇从购买后获得访问权限开始，目标是得到正确的 Flare 工作目录。已经下载源码的话，可以直接阅读快速开始。
开始前准备
- 已安装 Git、Node.js 22.12+ 和仓库锁定的 pnpm 10.26.2。
- 使用购买后获得仓库权限的 GitHub 账号；MuseMVP 与 All in One 包含 Flare，UI 模板方案不包含。
- 已在 Dodo Customer Portal 连接 GitHub，并接受实际收到的仓库邀请。官网文章本身不会授予权限；缺少权限时联系支持核对订单与 GitHub 账号。
1. 克隆独立仓库
git clone https://github.com/musemvp/musemvp-flare.git
cd musemvp-flare
node --version
pnpm --version
pnpm install --frozen-lockfile使用 SSH 时，仓库地址为 [email protected]:musemvp/musemvp-flare.git。命令应在含 pnpm-workspace.yaml 和根 package.json 的目录执行，而不是进入 apps/web 后执行工作区根脚本。
仓库只有一套 TanStack 应用。不要克隆官网 musemvp-com 来启动 SaaS，也不要从原 MuseMVP 拷贝 apps/web-cloudflare。
2. 确认版本和目录
git status --short
git log -1 --oneline
git remote -v应能看到 apps/web、packages、docs、tests 与 .env.example。在自己的开发记录中保存基线提交；源码 docs/PROVENANCE.md 说明来源，AGENTS.md 说明改动边界。
本指南与官网源码浏览器按 Flare b6b68e5 核对。模板以后会更新，采用更新前应查看自己的差异与升级指南。
3. 保存到自己的私有仓库
先在自己的 Git 服务创建空的私有仓库。若希望同时保留模板上游与自己的 origin，可以在确认地址后执行：
git remote rename origin template
git remote add origin https://github.com/YOUR_ACCOUNT/YOUR_PRIVATE_REPO.git
git remote -v先完成本地启动与产品配置，再把当前分支推送到自己的 origin。保持许可证和第三方说明；不要将商业模板源码发布为公共模板仓库。
哪些文件可以跟随代码
| 文件 | 用途 | Git 中如何处理 |
|---|---|---|
pnpm-lock.yaml | 固定依赖 | 提交，使用 frozen install |
packages/config/src/index.ts | 产品和套餐选择 | 提交，不放密钥 |
packages/cli/src/target-resources.ts | 部署资源名字 | 提交，派生产品先换成自己的名字 |
根 .env | CLI 账户/发布配置 | 忽略；新设备发布时安全转移 |
apps/web/.dev.vars | 本地 Worker 密钥 | 忽略；新设备由 init 生成 |
.muse/、.wrangler/ | 部署记录与本地状态 | 忽略，不当作源码分享 |
确认结果与常见问题
- 依赖安装成功，没有临时改动锁文件来绕过错误。
git remote -v指向你期望的源码上游/私有远端。- GitHub 提示 Repository not found：先确认登录账号接受了邀请，再检查 HTTPS token 或 SSH key；不要把 token 发到日志或 issue。
- Frozen install 失败：核对 pnpm 版本与完整锁文件，先处理网络/注册表问题，不要直接删除锁文件。
- 只做本地开发时，不必复制生产
.env；本地与生产数据库也不应共用。
下一步执行本地初始化和首次登录。