MiToverG422 / ONextBox

# ONextBox
**简体中文 · 繁體中文 · English**
### 🧩 让 ColorOS，多一点可能。
ONextBox 是一款基于 Root 与 Modern Xposed 的 ColorOS 系统优化与扩展工具箱，让系统定制更自由，让日常体验更顺手。
**📥 下载 · 🐛 问题反馈 · 💬 Telegram**
**🚀 正式发布 · 🧪 BetaTesting**
✨ 功能 · 📱 兼容性 · 🔨 构建 · 📚 引用与致谢
---
> [!WARNING]
> 项目仍在持续开发与适配中。系统级修改可能影响稳定性，不同机型、系统版本和区域版本的表现也可能不同。请先备份重要数据，再按需开启功能，不建议一次性打开所有选项。
## 🌿 关于项目
ONextBox 是由 **MiToverG422 主导开发与维护** 的个人项目。项目方向、功能取舍、界面设计、适配与实机验证均由作者主导；ChatGPT / Codex 只是辅助工具，用于部分代码编写、问题分析与迭代，不替代作者的判断与投入。最终的开发决策与项目维护由作者负责。
**如果你不接受 AI 辅助开发的项目，可以选择不使用，彼此尊重即可。** 项目会如实说明工具的使用，不回避，也不把它当作质量保证。
也希望大家更多关注实际体验、代码质量和问题是否得到解决。使用 AI 辅助，不意味着作品天然粗糙，更不意味着作者没有付出；同样，使用 AI 也不代表作品自动可靠。欢迎指出具体问题、提出改进建议，而不是仅凭一个「AI 辅助」标签否定整个项目。
欢迎有复现步骤的反馈，也欢迎代码、翻译与设计贡献。让作品靠体验和改进说话。💜
**官方版本免费提供，不存在付费授权、二次收费或付费激活。** 请认准项目链接，警惕冒充官方的收费版本。
## ✨ 不止一个开关
### 🎨 两种界面，一份工具箱
| 界面风格 | 体验方向 |
| --- | --- |
| **COUI 17.0** | 以 ColorOS 风格为方向，提供圆润卡片、拼接列表、顶栏模糊与细腻的交互动效 |
| **Material 3 Expressive** | 使用 Material 3 Expressive 组件与主题，呈现另一套布局和交互体验 |
> 💡 激活流程使用独立的视觉样式，选择 App 的主题模式不会改变激活页面的颜色。「激活」是首次设置流程，不是收费授权。
## 📱 兼容性与运行要求
| 项目 | 说明 |
| --- | --- |
| 🎯 主要适配目标 | **ColorOS 17** |
| 🌏 主要适配地区 | **CN China 中国大陆版 🇨🇳** |
| 🕰️ 旧版系统 | 部分选项保留 ColorOS 16 等版本的实现，不承诺旧版系统完整兼容 |
| 🌍 机型与地区差异 | 欢迎不同机型与地区版本的用户体验并反馈，具体支持情况以设备系统版本、App 内提示与实际测试为准 |
| 🔑 权限 | 需要可用的 Root 环境；Hook 功能还需要支持 **Modern Xposed API 102** 的框架 |
| 🧱 CPU 架构 | 当前构建面向 **arm64-v8a** |
| 📦 安装下限 | `minSdk 35`（Android 15），仅表示 APK 的安装下限，不等于功能支持范围 |
当前主要实机测试设备为 **OPPO Find X9 Ultra**。单一设备上的测试结果不能作为其他设备或 OTA 版本的兼容保证。
> [!NOTE]
> ONextBox 是第三方独立项目，不是 OPPO、OnePlus、realme 或 Google 的官方产品，也不代表上述品牌为项目背书。
## 🛡️ 使用边界与隐私
ONextBox 会为兼容性检查和功能运行读取必要的设备、系统、Root、框架状态及脱敏诊断信息。配置保存在本地，运行日志存放于应用私有目录，不会自动上传。
- 🌐 检查更新、加载在线 GitHub 头像等操作会访问第三方服务，第三方可能获得 IP 地址等常规网络元数据。
- 🚫 未集成广告或统计 SDK，也没有开发者自建的账号或遥测服务器。
- 🧪 地区、权限、语音助手与 eSIM 相关选项具有较强的环境依赖，不保证能够改变服务端资格、地区政策或运营商限制。
- 🤝 仅管理自己拥有或已获得明确授权的设备、SIM / eSIM 与账户；请勿用于欺诈、身份冒用或其他违法行为。
完整说明可在 App 的「关于 → 协议与引用内容」查看，也可阅读仓库内的 隐私说明 与 协议资源。
## 🐛 反馈与参与
发现问题时，请到 Issues 提供以下信息：
- 📱 设备型号、完整系统版本与区域版本。
- 📦 ONextBox 版本 / 构建号、使用的界面风格，以及框架版本。
- 🧭 复现步骤、开启了哪些选项、预期结果和实际结果。
- 🎬 必要的截图、录屏或经过脱敏的日志。
**提交前请移除手机号、账户、二维码、激活码、EID / ICCID、令牌以及通知正文等敏感信息。**
欢迎提交 Pull Request。系统功能变更请说明适用版本、目标进程与验证方式；UI 修改请尽量兼顾两套界面、浅深色模式和不同语言。🌱
## 🔨 从源码构建
### 🧑‍💻 开发环境
| 环境 | 当前配置 |
| --- | --- |
| JDK | **21** |
| Android SDK | **37**（compileSdk），targetSdk 为 36 |
| Gradle Wrapper | **9.3.1** |
| Android Gradle Plugin | **9.1.0** |
| Kotlin | **2.4.10** |
| 界面 | Jetpack Compose、COUI、Material 3 Expressive |
| 模块 API | libxposed **102.0.0** |
以 版本目录、App 构建配置 和 Gradle Wrapper 为准。
在 Android Studio 中打开项目，安装所需 SDK 并完成 Gradle 同步。首次构建需要联网下载依赖。
**Windows / PowerShell：**
 [code] 
**Linux / macOS：**
 [code] 
| 构建类型 | 用途 | 默认 APK 输出 |
| --- | --- | --- |
| `debug` | 本地调试与排错 | `app/build/outputs/apk/debug/app-debug.apk` |
| `debugSlim` | 启用代码压缩、资源缩减，关闭可调试标记；用于本地实机体验测试 | `app/build/outputs/apk/debugSlim/app-debugSlim.apk` |
| `release` | 优化构建与发布验证 | `app/build/outputs/apk/release/app-release.apk` |
正式构建需要在被 Git 忽略的 `signing.properties` 中配置 `ONEXTBOX_RELEASE_STORE_FILE`、