跳过主要内容
文档目录

更新代码库

如何保持您的 MinuteShip 项目与最新仓库代码同步

MinuteShip 会保持定期更新、错误修复和安全补丁，本文档介绍如何将您的项目更新到最新版本。

您可以将您的代码库更新到最新版本。需要注意，您对应用程序进行的自定义越多，更新过程就越复杂。更新涉及使用 Git 将最新的 MinuteShip 模板代码与您的更改合并，因此可能需要仔细解决合并冲突以保留您的自定义代码。

拉取更新

如果您使用 Git 仓库开始项目，您可以直接拉取更新。

# 添加模板项目仓库为上游远程仓库
git remote add upstream https://github.com/your-org/minuteship.git

# 获取模板最新更改
git fetch upstream

# 为更新创建新分支
git checkout -b update-template

# 合并更改（如有必要解决冲突）
git merge upstream/main

更新项目依赖

安装新的项目依赖：

pnpm install

更新数据库

当更新包含数据库模式更改时：

  1. 检查 src/db/app.schema.ts、src/db/auth.schema.ts，以及 src/db/migrations/ 下新增的迁移文件。
  2. 如果模板已经提供迁移文件，请保留并直接应用该迁移。不要运行 db:generate 重复生成相同变更。
  3. 先在本地应用并验证迁移，再应用到远程数据库：
# 应用到本地 D1 数据库
pnpm run db:migrate:local

# 应用到远程 D1 数据库
pnpm run db:migrate:remote

只有在您自行修改数据库模式、且尚无对应迁移文件时，才运行 pnpm run db:generate。

合并更新

如果您在快速开始中已经将项目关联到自己的 GitHub 仓库，合并完成后可以将更新推送到您的远程仓库：

# 推送更新分支到您的远程仓库
git push origin update-template

# 合并到主分支后推送
git checkout main
git merge update-template
git push origin main

更新后测试

更新后，先检查关键用户流程与控制台错误，再运行：

pnpm check  # lint → test → build → typecheck → e2e
pnpm check:production  # 本地生产构建 Worker 冒烟测试

接收更新通知

要接收 MinuteShip 的更新通知：

  1. 关注 GitHub 仓库
  2. 加入 Discord 社区
  3. 关注 X 账号 @your-handle

下一步

现在您了解了如何保持您的 MinuteShip 项目最新，探索这些相关主题：