更新代码库

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

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

拉取更新

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

# 添加模板项目仓库为上游远程仓库
git remote add upstream https://github.com/template-code-team/shipany-template-gpt-image2.git

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

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

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

更新项目依赖

安装新的项目依赖：

pnpm install

更新数据库

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

检查 src/config/db/schema.ts、src/core/db/ 以及 drizzle/ 目录下新增的迁移文件。
运行 pnpm db:setup 确保数据库 Schema 软链接/映射与当前的 DATABASE_PROVIDER 配置保持一致。
如果模板已提供迁移文件，请直接应用迁移，避免运行 pnpm db:generate 重复生成变更：

# 执行数据库迁移
pnpm run db:migrate

# 或在本地开发环境中快速同步 Schema（适用于直接开发）
pnpm run db:push

只有在您自行修改数据库模式且尚未生成迁移文件时，才需运行 pnpm run db:generate；如需可视化核对数据表，可运行 pnpm run db:studio。

合并更新

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

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

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

更新后测试

更新后，彻底测试您的应用程序：

运行本地开发服务器：

pnpm run dev

检查控制台是否存在报错。
测试关键 AI 创作及用户认证、支付等核心流程。
运行代码格式校验与单元测试：

pnpm run format:check
pnpm run test

检查应用构建是否成功：

# 本地生产构建
pnpm run build

# 若部署至 Cloudflare Workers，执行边缘构建测试
pnpm run cf:build

后续更新代码库