# 解决 Pegasus 冲突 ## 说明此技能可帮助用户在升级 SaaS Pegasus 代码库时解决合并冲突。大多数用户在将主分支合并到 Pegasus 升级分支后出现合并冲突时会调用此技能，但您也可以帮助他们运行合并过程。 ### 调用时首先，通过检查用户当前的状态来确定用户需要哪些帮助： 1. **检查 git status** ：运行 `git status` 以查看是否有正在进行的活动合并 2. **询问用户**：如果不清楚，询问他们是否： * 已经运行 `git merge` 并需要帮助解决冲突（最常见） * 希望您为他们运行合并过程 * 需要帮助了解哪些冲突需要优先考虑 ### 如果存在有冲突的活动合并用户已经运行了“git merge <主分支>”并且有冲突需要解决。使用以下策略帮助他们解决冲突： #### 数据库迁移 * **策略** : 放弃 Pegasus 迁移更改，保留用户的更改 * **原因** ：迁移文件应该重新生成，而不是合并 * **操作** ：对于有冲突的迁移文件，接受他们的（来自 main 的用户版本），然后在解决所有冲突后运行 `./manage.py makemigrations` * **Git 命令** ：对于每个冲突的迁移，`git checkout --theirs ` * **djstripe 迁移引用** ：如果 djstripe 已升级，请检查应用程序迁移是否引用不再存在的旧 djstripe 迁移（请参阅下面的“djstripe 2.10 升级”部分）。 #### 依赖锁文件（uv.lock、requirements.txt、package-lock.json） * **策略** : 接受 Pegasus 更改以锁定文件，手动合并源文件 * **源文件** : `pyproject.toml`, `requirements.in`, `package.json` * **锁定文件** : `uv.lock`, `requirements.txt`, `package-lock.json` * **行动**： 1. 对于源文件：仔细合并，保留自定义 2. 对于锁定文件：使用 `git checkout --ours ` 和 `git add ` 接受我们的（Pegasus 版本） 3. **立即重新生成** ：解析后立即运行 `uvsync` （对于 uv.lock）或 `npm install` （对于 package-lock.json）以确保依赖项正确同步 * **重要**：不要等到合并后步骤 - 解决它们后立即重新生成锁定文件 #### 静态资源（static/ 中的 JavaScript/CSS 包） * **策略** : 删除并重新生成 * **操作** ：接受任一版本（无关紧要），将被重建 * **重新生成** : 合并后运行 `npm run build` 或 `npm run dev` #### 配置文件（.env.example、设置文件） * **策略**：仔细合并，保留定制 * **行动**：回顾双方并明智地结合起来 #### 其他文件 * **策略**：具体情况评估 * **行动** ：阅读两个版本，了解更改，智能合并 ### 如果运行完整的合并过程如果用户希望您运行合并： 1. **获取最新更改** ：运行 `git fetch` 从远程下载最新分支和提交（这确保您可以看到最新的 Pegasus 升级分支） 2. **查找最新的升级分支** : 运行 `gitbranch -a` 列出所有分支并查找最新的 Pegasus 升级分支（通常带有 `pegasus-YYYY.MM` 前缀，例如 `pegasus-2025.01`） 3. **检查当前分支** : 运行`git status`来查看它们是否已经在升级分支上 4. **签出升级分支**：如果尚未使用，请运行 `git checkout ` 5. **拉取最新更改**：运行`git pull`以确保升级分支与远程保持最新 6. **识别主分支** ：确定主开发分支（通常是 `main` 或 `master`） 7. **运行merge** ：执行`git merge `将主开发分支合并到Pegasus升级分支 8. **处理冲突**：遵循上述冲突解决策略 9. **依赖关系同步**：冲突解决后，您应该重新同步依赖关系。 * Python：`uv同步` * JavaScript：`npm install` ### 合并后步骤解决所有冲突并完成合并后，**询问用户是否要继续执行合并后步骤**或者是否更愿意稍后手动执行这些步骤。如果用户想要继续，请运行以下步骤： 1. **构建资产**：`npm run build`（或用于开发的`npm run dev`） 2. **可选 - 数据库迁移**：如果需要，运行`./manage.py makemigrations`来创建新的迁移 3. **可选 - 运行迁移**：`./manage.py migrate` 以应用数据库更改 4. **可选 - 运行测试**：`./manage.py test` 运行 Python 测试套件 5. **可选 - Docker 用户**：他们可以运行 `make update` 而不是上面的手动步骤 6. **推送到 GitHub** ：运行 `git push` 将合并的更改推送到 GitHub。推送后，升级分支应该准备好通过拉取请求合并到主分支中如果用户喜欢手动执行这些操作，请告知他们准备好后应采取哪些步骤。 ### 重要提醒 * **启用 rerere** ：建议运行 `git config rerere.enabled true` 来记住冲突解决方案以供将来升级 * **切勿挤压** ：在 GitHub 中合并 Pegasus PR 时，始终使用“创建合并提交”（而不是挤压或变基） * **查看更改** ：在提交之前始终查看升级中的更改内容 * **始终比较干净版本** ：解决重要冲突时，使用 `git show HEAD:` 和 `git show main:` 查看每个分支的干净版本，而不是尝试就地解析冲突标记 ### 示例 #### 示例 1：用户存在冲突（最常见）用户：“升级 Pegasus 后出现合并冲突” 你：[检查 git 状态，查看迁移和 uv.lock 中的冲突] 您：“我可以看到您在迁移和 uv.lock 方面存在冲突。让我帮助解决这些问题： - 对于迁移：我将保留您的版本，我们将重新生成它们 - 对于 uv.lock：我将接受 Pegasus 版本并重新生成它 [继续解决冲突]” #### 示例 2：用户需要合并方面的帮助用户：“你能帮我将更改合并到 Pegasus 升级分支吗？” 你：“我可以帮忙。让我： 1.找到最新的Pegasus升级分支 2. 查看该分支（或确认您已经在该分支上） 3. 将你的主开发分支合并进去 4. 帮助解决出现的任何冲突 [继续查找分支并运行 git merge main]” ### 边缘情况 * **没有 Pegasus 升级分支** ：如果用户没有 `pegasus-YYYY.MM` 分支，请引导他们查看 Pegasus 升级文档 * **太多冲突** ：如果多个文件之间存在数十个冲突，建议按优先顺序检查它们（首先迁移，然后锁定文件，然后配置） * **自定义修改**：对用户自定义保持保守 - 如有疑问，请保留其更改并注意 Pegasus 中的不同之处 * **不熟悉的文件类型**：如果您遇到文件冲突，您不确定如何处理，请解释冲突双方并询问用户哪种方法有意义 ### djstripe 2.10 升级（Pegasus 2026.2.2+） Pegasus 2026.2.2 将 djstripe 从 2.9 升级到 2.10。这是一个重大升级，需要超出正常冲突解决的额外步骤。 #### 迁移壁球 djstripe 2.10 将所有以前的迁移压缩为“0001_initial”和“0002_2_10”。解决迁移冲突后，检查是否有任何应用程序迁移引用了不再存在的旧 djstripe 迁移（例如 `('djstripe', '0012_2_8')`）。如果是这样，请将这些依赖项更新为 `('djstripe', '0001_initial')`。不要删除迁移 - 而是更新其依赖项引用。 #### 字段移至 stripe_data 许多模型字段作为数据库列被删除，现在通过“@property”访问器从“stripe_data”JSONField 读取。 “Product”的主要变化：“default_price”、“type”现在是属性。这意味着： * `select_lated("default_price")` 会失败——删除它，直接使用 `.get()` * 删除字段上的 `filter()`、`order_by()`、`values()` 将失败 — 使用 `stripe_data__` 代替 * 像“product.default_price.id”这样的属性访问仍然有效（它从“stripe_data”进行数据库查找） #### 迁移后重新同步条带数据运行“./manage.py migrate”后，运行“./manage.py djstripe_sync_models Product Price”以重新填充现有记录的“stripe_data”。如果没有这个，像“product.default_price”这样的属性将返回“None”，因为旧的 FK 数据还不在“stripe_data”中。 #### 过时的解决方法不再需要更改“djstripe_ paymentintent.capture_method”列长度的“RunSQL”迁移（[dj-stripe#2038]()的解决方法）。清除其“操作”列表（将迁移文件保留为依赖链的无操作）。

解决 Pegasus 冲突

包含技能