EduOpenAI Core 文档/上游升级流程
上游升级流程
跟随 OpenMAIC 升级的零侵入流程
升级流程
- 拉取上游：git fetch upstream && git checkout -b upgrade/openmaic-vX.Y.Z
- 合并基线：git merge upstream/main（plugins/ 与 lib/plugin/ 无冲突）
- 审查 PATCH：按 patch-registry.md「上游升级审查清单」逐项检查冲突文件
- 回归插件：pnpm test + 手动验证所有插件 API 端点
- 更新 minCoreVersion：所有插件 manifest.json 升至新版本
- 更新登记表：patch-registry.md 标记每个 PATCH 兼容性状态
升级友好检查
每个上游 release 打 tag 后一周内做只读 diff 评估（不实际升级）：git remote add upstream + git fetch upstream --tags，diff 当前基线 → 新 tag，识别与本地 PATCH 重叠的文件，产出冲突清单与迁移评估，由旺财决策。
冲突热点预判
| 文件/区域 | 本地 PATCH | 升级审查要点 |
|---|---|---|
| lib/ai/llm.ts | PATCH-015 | 上游若重构 callLLM 重试逻辑需重新 apply |
| middleware.ts | PATCH-014/020 | 上游若改鉴权逻辑需重新 apply |
| app/admin/page.tsx | PATCH-011/012/013/016 | 上游若引入自身 /admin 需冲突评估 |
| lib/ai/providers.ts | PATCH-009 | 上游已调大默认超时可移除 |
| app/page.tsx | PATCH-002/003/021 | 品牌文案 + 入口链接一并审查 |
提示
原则：不追新、按业务需求升级；基线当前锁定 v0.3.1；升级前先备份 + 建立可回滚点。