Home

上帝模式Pro Wiki

Xposed-GodModePro — 一个 LSPosed/Xposed 模块，允许你在任意 Android 应用中屏蔽或修改你不喜欢的 UI 元素，类似于 PC 端的 AdBlock。

文档定位： 本 Wiki 完整反映当前开发主线 v6.11.0（versionBaseline = 6.11.0，PROTOCOL_VERSION = 61000，合同指纹 iruleservice-61000-fd-mutate-v3；合同自 6.10 硬切后未变）。其中规则 JSON、Parcelable、ZIP V1 与 matcher/effect 语义保持 v6.9 兼容，但跨进程合同、写入权威与撤销账本已在 6.10 硬切。历史版本 v6.8.0/v6.9 的冻结细节见主仓库 docs/。

权威边界： 架构决策、兼容性边界与实现状态以主仓库受版本控制的 docs/ 为唯一权威来源，本 Wiki 为面向读者的可读投影。

---

📖 文档索引

入门与使用

页面	说明
入门指南	项目信息、功能特性、快速开始、常见问题
UI与开发指南	UI 界面说明、安全权限、构建开发、日志系统

架构与原理

页面	说明
架构概览	v6.10.x 三模块依赖、进程架构图、组件职责（6.10 新增 RuleServiceClient / OperationLeaseController / UndoJournal；6.11 起 RuleServiceClient 已拆为 ServiceConnection / RuleReader / ObserverCenter / LogBridge 等职责门面真单例）
Hook清单	Xposed 钩子注入点总览、注入流程（含握手失败 guard 与 Recycler 三 Hook 分装）
Xposed注入详解	注入层完整分析：initZygote、handleLoadPackage 分流、六大 Hook、Property 响应式链、ViewController 管线、握手失败不装业务 Hook 的保护
IPC与持久化	6.10 单一合同 IRuleService：descriptor 硬切、SharedMemory 快照、FD mutate、RuleRepository 持久化优先、generation 与备份恢复
撤销与租约	权威撤销账本（AuthoritativeUndoJournal 容量 10、lineage 与图片保活）、操作租约（OperationLeaseController + Coordinator）、EditorHistoryOwnerRegistry 历史作用域
XServiceManager详解	系统服务注入框架：system_server 常驻服务、clipboard 私有事务桥、魔法事务码、BridgeStatus 诊断

引擎与工具

页面	说明
规则引擎	规则模型（MatchSpec / RuleEffect / RuleSlotKey 三分，RuleRecord 扁平兼容）、匹配系统（CompositeMatcher 新 depth 主锚）、执行系统（Remove/ModifyApplier epoch 化）、RuleDiff 与 EventBus
引擎工具类	Logger、TextMatcher、ThreadPools、GmConstants 以及 app 层 FileUtils/ZipUtils 等工具边界
编辑器交互系统	全局编辑许可、FD mutate 单次写入、编辑截图投影、撤销状态机、触摸/按键/工具栏/粒子动画

---

版本与升级提示

• 当前基线： 6.11.0（versionCode 取 git rev-list --count HEAD 单调递增；versionName 在纯净 v6.11.0 tag 上为发行版，其余自动追加 -dev- 时间戳）
• 6.11.0 增量（合同不变）： 结果码语义分类收纳进 RuleServiceContract、6 类中文诊断补全、编辑态单快照、遮罩跟随前端应用、AppRules/ActRules 去 Parcelable、备份解码对齐 IPC 严格标准
• 合同硬切： 客户端与 system_server 均只实现新合同，旧 IGodModeManager/IObserver/AssetWriteSession 已删除；同为 61000 但指纹不匹配的组合在握手阶段进入 REBOOT_REQUIRED，更新 APK 后必须重启系统
• 不迁移规则： RuleRecord JSON、Parcelable 槽位、ZIP V1、图片路径与匹配/执行含义保持不变（由 golden 测试锁定）

---

快速链接

• 项目主页: github.com/firesahc/Xposed-GodMode-Pro
• 权威文档: docs/README.md · 6.10 IPC 合同 · ADR-0002
• 问题反馈: GitHub Issues
• 许可证: 查看 LICENSE

初次使用？请从 入门指南 开始；想理解写入权威与可撤销性？请先读 IPC与持久化 与 撤销与租约。