1. 获取项目源码(Fork)
Vercel 部署使用你自己的 Fork。Vercel 从这个仓库构建,后续更新也通过 Fork 同步作者仓库。
本地/内网部署不需要 Fork,直接在服务器上 git clone 即可,见本地部署总览。
Fork 前确认
请先登录 GitHub,并打开作者仓库:PikaNova/Novora。Fork 后的仓库归你的 GitHub 账号或学校组织所有;Vercel 以后只连接这个仓库的 main 分支。
为什么必须 Fork
Fork 会保留与 PikaNova/Novora 的上游关系。作者发布新版后,你可以在 GitHub 使用 Sync fork 把更新合并到自己的 main,Vercel 才能构建新代码。Deploy Hook 只能重新部署已有代码,不能代替同步上游。
创建 Fork
- 在 PikaNova/Novora 页面右上角点击 Fork。
Owner选择自己的 GitHub 账号,或学校的 GitHub Organization。- 仓库名称建议保留为
Novora;如需区分学校实例,可改为school-novora。 - 保持默认分支
main被包含,不需要勾选额外模板选项。 - 点击 Create fork,等待 GitHub 跳转到新仓库。
- 确认仓库页显示
forked from PikaNova/Novora,并且当前分支为main。
Fork 后地址类似:
text
https://github.com/你的用户名/Novora检查仓库根目录
Fork 首页应直接看到以下文件或目录:
text
api/
public/
src/
index.html
package.json
vercel.json
vite.config.tspackage.json 必须位于将要交给 Vercel 的仓库根目录。官方 Fork 的根目录已经正确;不要再套一层 Novora 文件夹,也不要上传 node_modules、.env 或数据库连接串。
自定义代码的处理方式
需要修改校名、功能或样式时,先在自己的 Fork 创建分支完成修改和测试,再合入 main。不要直接改作者仓库,也不要为了更新使用会覆盖自定义提交的强制命令。
后续更新时,先同步作者上游,再处理与学校自定义代码的冲突。完整步骤见Vercel 日常维护。
完成标志
确认浏览器地址是自己的 Fork,仓库页显示来源 PikaNova/Novora,且能看到 package.json、api、src 与 vercel.json。下一步将为它创建 Neon 数据库。