AI 生成草稿，待人工审核。 本页不是权威事实源；引用前必须回到原始 Commit 核对。
生成工作流：ai-knowledge-sync.yml；来源 OrekiDawson/AD-Oreki-Edition-Android@59f1fc50046d 文件 AGENTS.md。
| 主题 | 陈述 | 状态 | 证据等级 | 原文摘录 |
|---|---|---|---|---|
| 仓库性质与当前轮次 | 本仓库是 Android MOD 源码与构建仓库，项目状态为 R101 轮内恢复，不启动 R102。 | 进行中 | 读码 | 本仓库是 Android MOD 源码与构建仓库。项目状态：R101 轮内恢复（用户明确授权 P0 修复与真实验收；不启动 R102）。 |
| 上游基线冻结 | Android 固定官方 3.21.0 为唯一基线，自 2026-11-13 起正式冻结。 | 已验证 | 读码 | 上游基线：官方 Android 3.21.0（2026-11-13 起正式冻结；允许只读监测上游安全/重大缺陷，禁止未经授权自动升级、合并、修改冻结基线或发布 |
| 基线冻结标识 | 冻结基线标识为 base APK SHA-256 4e9970a808d10b6cc1a1068b078ec3c7d922051086a576c66d071c1216f527ac、XAPK SHA-256 ad1b367ecf872bd71c12b714622424511599177f3a4b9c1a6bb4493bee0dc68a、versionCode 30210000、minSdk 32 / targetSdk 37。 | 已验证 | 读码 | 冻结标识：base APK SHA-256 4e9970a808d10b6cc1a1068b078ec3c7d922051086a576c66d071c1216f527ac、XAPK SHA-256 ad1b367ecf872bd71c12b714622424511599177f3a4b9c1a6bb4493bee0dc68a、versionCode 30210000、minSdk 32 / targetSdk 37 |
| 业务逻辑语言约束 | 新增或修改的 Android 业务逻辑使用 Kotlin，禁止新增 Java/Smali 游戏业务实现。 | 已验证 | 读码 | 新增或修改的 Android 业务逻辑使用 Kotlin；原版混淆 DEX/Smali 只作为已核实的 ABI、反射和兼容入口，不新增 Smali/Java 业务实现。 |
| 验证与结果标注规则 | 涉及存档、阶段、挑战、自动购买器或 GUI 的修改需执行真实运行验证；未运行写 NOT RUN，失败写 FAIL，不伪造 PASS。 | 已验证 | 读码 | 涉及存档、阶段、挑战、自动购买器或 GUI 的修改，执行对应的真实运行验证（AVD 或真机、截图、控件树、日志）。……未运行写 NOT RUN，失败写 FAIL，不伪造 PASS。 |
| build_mod.py 退役目标 | scripts/build_mod.py 的彻底退役是用户明确指定的强制长期目标；退役完成前允许对其做必要的故障修复和隔离对照。 | 进行中 | 读码 | 例外：scripts/build_mod.py 的彻底退役为用户明确指定的强制长期目标（见第 14 节）。……在退役完成前允许对 build_mod.py 做必要的故障修复和隔离对照 |
| MOD 独立版本命名规则 | MOD 产品版本名称为 Oreki Edition，版本号从 1.0.0 起；1.0.1 为 patch，1.1.0 为向后兼容增强，2.0.0 为重大/不兼容变更。 | 已验证 | 读码 | 产品版本名 Oreki Edition，从 1.0.0 起；1.0.1 patch、1.1.0 向后兼容增强、2.0.0 重大/不兼容变更。 |
| versionCode 必须严格递增 | Android 每次新的正式发布，versionCode 必须严格大于历史已发布最大值；当前最大值为 30210000，来自 R103 android-update-3.21.0-3d924271。 | 已验证 | 读码 | Android 每次新的正式发布 versionCode 必须严格大于历史已发布最大值（当前最大值 30210000，来自 R103 android-update-3.21.0-3d924271） |
| 包名与签名证书固定 | 不得改变包名 com.oreki.antimatterdimensions 与签名证书 95960bce…3197，不得破坏存档兼容与覆盖升级安装。 | 已验证 | 读码 | 不得改变包名 com.oreki.antimatterdimensions、签名证书 95960bce…3197，不得破坏存档兼容与覆盖升级安装。 |
| 反混淆基线固定为 3.21.0 | 反混淆/Kotlin 目标固定为 3.21.0 基线，复用现有 JADX 导出、docs/deobfuscation/data/first-party-3.21-index.csv、语义映射与 Kotlin 重建成果，不因上游发版重置。 | 已验证 | 读码 | 固定为 3.21.0 基线；复用现有 JADX 导出、docs/deobfuscation/data/first-party-3.21-index.csv、语义映射与 Kotlin 重建成果，不因上游发版重置。 |
| 完整基线替换需用户授权 | 完整基线替换必须在用户明确批准的新轮次进行；技术条件满足不能代替用户授权。 | 已验证 | 读码 | 完整基线替换必须在用户明确批准的新轮次进行；技术条件满足不能代替用户授权。 |
| 正式发布门禁六项条件 | 完整升级发布前必须全部满足六项门禁：合格稳定版可回退、AGP 正式构建链可产出完整游戏 APK 并通过真实运行验收、无未解决 P0、存档/签名兼容与覆盖升级验证通过、Android/Web 行为等价验收通过、收益/成本评估支持升级。 | 已验证 | 读码 | ① 已有通过门禁的合格稳定版可回退；② AGP 正式构建链可产出完整游戏 APK 并通过真实运行验收；③ 无未解决 P0；④ 存档/签名兼容与覆盖升级验证通过；⑤ Android/Web 行为等价验收通过；⑥ 收益/成本评估支持升级。 |
| 删除 build_mod.py 为永久目标 | 项目最终将删除 scripts/build_mod.py，正式 Android 构建、Candidate/Verify/Release 及相关生成/校验流程不得再依赖该文件、Python 包装调用器或同功能换名脚本。 | 进行中 | 读码 | 最终删除 scripts/build_mod.py，正式 Android 构建、Candidate/Verify/Release 和相关生成/校验流程均不得再依赖该文件、Python 包装调用器或同功能换名脚本。 |
| 目标构建技术栈 | 正式游戏代码、资源、Manifest、DEX、APK 的构建以 AGP 9.5.1 + Gradle Kotlin DSL + Kotlin 业务源码为核心，并消除生产构建期 Python 依赖。 | 进行中 | 读码 | 正式游戏代码、资源、Manifest、DEX、APK 的构建以固定 AGP 9.5.1 + Gradle Kotlin DSL + Kotlin 业务源码为核心 |
| 迁移方式为分批而非立即硬删 | 迁移计划先对 build_mod.py 实际执行函数建立迁移清单，按资源/Manifest、混淆绑定、教程、业务补丁、构建期守卫及 CI 调用逐批迁移。 | 进行中 | 读码 | 先对 build_mod.py 实际执行函数建迁移清单，区分需要保留的行为、已由 Kotlin 接管的功能与无效历史代码 |
| 删除前需完整验收 | 删除 build_mod.py 前需具备无脚本 AGP 完整构建、真实 APK 安装/冷启、Tick 运行、存档保存/恢复、关键阶段/挑战/自动购买器/GUI、签名/包名/版本升级兼容及独立 CI/CD 门禁的可追溯证据，失败保持 BLOCKED。 | 待确认 | 读码 | 需要干净工作区的无脚本 AGP 完整构建，以及真实 APK 安装/冷启、Tick 持续运行、存档保存/恢复、关键阶段/挑战/自动购买器/GUI、原版签名/包名/版本升级兼容和独立 CI/CD 门禁的可追溯证据；失败保持 BLOCKED。 |
| 当前工程目录并存现状 | 目前根级 Groovy build.gradle/settings.gradle 与 agp/app Kotlin DSL 并存，AGP 从 scripts/payload/kotlin 和生成绑定读取业务代码。 | 已验证 | 读码 | 目前根级 Groovy build.gradle/settings.gradle 与 agp/app Kotlin DSL 并存；AGP 从 scripts/payload/kotlin 和生成绑定读取业务代码。 |
| Issue #61 与 #52 并列最高优先级 | 自 R113-01 起，Issue 61（目录标准化）与 Issue 52（退役 build_mod.py）并列最高优先级的长期架构主线，不再归入普通 P2。 | 进行中 | 读码 | 自 R113-01 起，Issue #61 与 Issue 52（彻底退役 build_mod.py）并列最高优先级的长期架构主线，不再归入普通 P2。 |
证据
状态：待确认（AI 提取，人工审核后改为已验证）
证据等级：读码（来源文本）
适用版本：Android 3.21.0 / Web 冻结上游（以来源为准）
来源仓库：OrekiDawson/AD-Oreki-Edition-Android
来源 Commit：59f1fc50046d91d0e9ede49fe2a538b1c90134c1
来源文件：AGENTS.md