docs: 补充 V2/V3 修复同步规范

AGENTS.md

@@ -8,7 +8,7 @@
 - 主仓库：`https://github.com/dataease/dataease`，是开源项目；遵循根目录 `LICENSE`，不要将其简化描述为没有附加条件的 GPLv3。
 - 子模块：`https://github.com/dataease/de-xpack`，**不是开源项目**。本地可见、存在 GitHub 地址或可作为插件加载，均不表示可以将其实现公开。
 - 不把 XPack 实现源码、专有资源或内部差异复制到开源主仓库、公开 PR/Issue 或公开文档；跨仓库协作通过必要的公共契约和兼容性说明完成，不能为解决构建缺失直接搬运专有实现。
-- 两个仓库的开发目标分支均为 `dev-v3`。主仓库通过 PR 合入，XPack 按维护者指定流程直接推送；具体步骤见第 8 节。旧文档中的 `dev-v2` 目标不适用于本工作区。
+- 两个仓库的开发目标分支均为 `dev-v3`。主仓库通过 PR 合入，XPack 按维护者指定流程直接推送；具体步骤见第 9 节。旧文档中的 `dev-v2` 目标不适用于本工作区。
 
 ## 1. 工作原则
 
@@ -158,7 +158,17 @@
 
 只声明实际验证过的环境和行为；未覆盖的数据库、入口或 Profile 明确列为限制。
 
-## 8. Git、提交与交付
+## 8. V2/V3 修复同步
+
+- V2 与 V3 持续独立迭代，可能位于不同目录，也可能是同一仓库的不同分支。另一版本的提交、PR 或修复说明是调查线索，不是可直接合并的补丁；不得在有未提交改动的工作区为查看来源版本擅自切换分支。
+- 用户明确要求跨版本同步，或提供另一版本的修复并要求在当前版本处理时，先依据用户提供的来源提交/PR、可访问的代码或复现信息，提取问题触发条件、预期行为、边界情况与回归场景。普通单版本任务不自动修改另一版本，也不因功能相似就自行扩大任务范围。
+- 来源代码不在当前可访问范围时，先使用可用的提交/PR 和问题描述；不足以确认行为时，请用户提供差异或访问方式。读取来源版本不要求获得其长期写权限；跨版本修改分别在各自目标版本的工作区完成。
+- 沿当前版本的实际入口和调用链确认问题是否存在，检查已有修复及版本特有行为。若已解决或功能不适用，给出代码或验证依据，不为保持两边代码形式一致而制造改动。
+- 从 V2 同步到 V3 时，按 V3 的 JPA/QueryDSL、数据库方言、迁移机制及重构后的权限契约重新实现；不得直接移植 MyBatis Mapper、仅适用于 MySQL 的 SQL、旧权限判断或 Flyway 脚本。前端、API 和 XPack 也应分别核对当前契约与实现边界。
+- 验证目标版本的回归场景和受影响入口；涉及持久化、查询或权限时，按第 7 节覆盖相关数据库、身份和拒绝路径。完成说明记录来源版本及提交/PR（如有）、目标版本对应改动、行为差异、已执行验证和未覆盖项。
+- 两个版本各自遵守本仓库的分支、提交和发布流程。跨版本同步不授权自动提交、推送或创建 PR；只有任务包含相应交付要求时才按第 9 节执行。
+
+## 9. Git、提交与交付
 
 ### DataEase 主仓库：PR 合入 dev-v3