Skip to content

Commit a18f6d9

Browse files
1812z1812z
committed
README.md
1 parent 742539a commit a18f6d9

File tree

2 files changed

+200
-21
lines changed

2 files changed

+200
-21
lines changed

‎README.md‎

Lines changed: 86 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -1,50 +1,115 @@
1+
<div align="center">
2+
3+
<img src="https://github.com/user-attachments/assets/dc034ec0-90cf-4371-9ab0-132ca2527b32" width="120" height="120" style="border-radius: 24px;" alt="HyperIsland Icon"/>
4+
15
# HyperIsland
26

3-
基于 LSPosed 的 Xposed 模块，为澎湃 OS 注入超级岛样式的进度通知。支持下载管理器通知（显示文件名、进度、暂停/取消按钮）以及任意标准安卓通知（通用适配）。
7+
**为澎湃 OS3 打造的超级岛进度通知增强模块**
8+
9+
[![GitHub Release](https://img.shields.io/github/v/release/1812z/HyperIsland?style=flat-square&logo=github&color=black)](https://github.com/1812z/HyperIsland/releases)
10+
[![License](https://img.shields.io/github/license/1812z/HyperIsland?style=flat-square&color=orange)](LICENSE)
11+
[![Platform](https://img.shields.io/badge/Platform-Android-green?style=flat-square&logo=android)](https://android.com)
12+
[![LSPosed](https://img.shields.io/badge/Framework-LSPosed-blueviolet?style=flat-square)](https://github.com/LSPosed/LSPosed)
13+
[![HyperOS](https://img.shields.io/badge/ROM-澎湃OS3-orange?style=flat-square)](https://hyperos.mi.com)
14+
[![Build](https://img.shields.io/badge/Build-Flutter-02569B?style=flat-square&logo=flutter)](https://flutter.dev)
15+
16+
17+
**[English](README_EN.md)** | 简体中文
18+
19+
</div>
420

521
---
622

7-
## 功能
23+
## ✨ 功能介绍
24+
25+
<table>
26+
<tr>
27+
<td width="50%">
28+
29+
### 📥 下载管理器拓展
30+
拦截 HyperOS 下载管理器的通知，以超级岛样式展示文件名与下载进度，支持**暂停、继续、取消**操作。
31+
32+
</td>
33+
<td width="50%">
34+
35+
### 🏝️ 超级岛 + 焦点通知适配
36+
拦截任意 App 发出的标准安卓通知，处理后以超级岛 + 焦点通知样式展示，按钮来自原通知。
37+
38+
</td>
39+
</tr>
40+
<tr>
41+
<td width="50%">
42+
43+
### 🚫 通知黑名单
44+
黑名单应用不会弹出通知，仅显示超级岛（全屏状态下随状态栏自动隐藏）。
45+
46+
</td>
47+
<td width="50%">
848

9-
- **下载通知适配**：拦截 HyperOS 下载管理器的通知，以超级岛样式展示文件名与下载进度，支持暂停、继续、取消操作。
10-
- **通用通知适配**：拦截任意 App 发出的标准安卓通知（如文件下载等），自动提取标题与进度并以超级岛样式展示，按钮来自原通知。
49+
### 🔥 热加载支持
50+
修改配置后**无需重启**即可生效，安装或更新软件后重启作用域即可。
51+
52+
</td>
53+
</tr>
54+
</table>
1155

1256
---
1357

14-
## 使用说明
58+
## 📋 使用说明
59+
60+
### 第一步：在 LSPosed 中激活模块
1561

16-
### 1. 在 LSPosed 中激活模块
62+
> ⚠️ 本模块依赖 **LSPosed** 框架，需要设备已获取 Root 权限并安装 LSPosed。
1763
1864
1. 打开 **LSPosed** 管理器，进入「模块」列表。
1965
2. 找到 **HyperIsland** 并启用开关。
2066
3. 在模块的作用域中，勾选推荐的应用：
21-
- **下载通知**：勾选「下载管理器」。
22-
- **通用适配**：勾选「系统界面」。
23-
4. 确认保存后，**软件右上角重启按钮，重启对应作用域内的应用**（或直接重启手机）使 Hook 生效。
24-
25-
> 注意：每次在 LSPosed 中修改作用域，都需要重启被修改的作用域应用才能生效。
67+
- **下载通知**：勾选「下载管理器」
68+
- **通用适配**：勾选「系统界面」
69+
4. 确认保存后，点击**软件右上角重启按钮**，重启对应作用域内的应用（或直接重启手机）使 Hook 生效。
2670

2771
---
2872

29-
### 2. 在 HyperCeiler 中开启焦点通知白名单
73+
### 第二步：在 HyperCeiler 中开启焦点通知白名单
3074

31-
超级岛样式的通知需要经过 HyperCeiler 的「焦点通知」权限才能正常显示。
75+
> 💡 超级岛样式的通知需要经过 HyperCeiler 的「焦点通知」权限才能正常显示。
76+
> 如果你的 HyperCeiler 版本过旧可能找不到相应入口，请自行更新版本。
3277
3378
1. 打开 **HyperCeiler**，进入「系统界面」或「小米服务框架」相关设置。
3479
2. 找到「**移除焦点通知白名单**」。
3580
3. 打开开关并重启作用域。
3681

3782
---
3883

39-
## 注意事项
84+
## ⚠️ 注意事项
4085

41-
- 本模块依赖 **LSPosed** 框架，需要设备已获取 Root 权限并安装 LSPosed。
42-
- 本模块依赖 **HyperCeiler** 提供的焦点通知（`FocusNotification`）白名单支持，请确保 HyperCeiler 版本支持该功能。
43-
- 安装或更新软件后，需要重启作用域程序，修改配置若无特殊说明不需要重启，支持热加载。
44-
- 通用适配仅处理**安卓标准**通知，自定义通知样式不受支持。
45-
- 本模块在澎湃 OS3 环境下测试，其他 ROM 可能存在兼容性问题。
86+
| 事项 | 说明 |
87+
|------|------|
88+
| 框架依赖 | 本模块依赖 **LSPosed** 框架，需设备已 Root |
89+
| 重启时机 | 安装或更新软件后需重启作用域；修改配置一般支持热加载 |
90+
| 通知兼容性 | 通用适配仅处理**标准安卓通知**，自定义通知样式不受支持 |
91+
| ROM 兼容性 | 本模块在**澎湃 OS3** 环境下测试，其他 ROM 可能存在兼容性问题 |
4692

4793
---
4894

49-
## 开源协议
50-
MIT，详见 [LICENSE](https://github.com/1812z/HyperIsland/blob/main/LICENSE)
95+
## 🔨 构建
96+
97+
确保已安装 Flutter 开发环境，然后运行：
98+
99+
```bash
100+
flutter build apk --target-platform=android-arm64
101+
```
102+
103+
---
104+
105+
## 📄 许可证
106+
107+
本项目基于 [LICENSE](LICENSE) 开源，欢迎 Issue 与 PR。
108+
109+
<div align="center">
110+
111+
Made with ❤️ for HyperOS users
112+
113+
[![Star History](https://img.shields.io/github/stars/1812z/HyperIsland?style=social)](https://github.com/1812z/HyperIsland)
114+
115+
</div>

‎README_EN.md‎

Lines changed: 114 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,114 @@
1+
<div align="center">
2+
3+
<img src="https://github.com/user-attachments/assets/dc034ec0-90cf-4371-9ab0-132ca2527b32" width="120" height="120" style="border-radius: 24px;" alt="HyperIsland Icon"/>
4+
5+
# HyperIsland
6+
7+
**Dynamic Island–style progress notifications for HyperOS 3, powered by LSPosed**
8+
9+
[![GitHub Release](https://img.shields.io/github/v/release/1812z/HyperIsland?style=flat-square&logo=github&color=black)](https://github.com/1812z/HyperIsland/releases)
10+
[![License](https://img.shields.io/github/license/1812z/HyperIsland?style=flat-square&color=orange)](LICENSE)
11+
[![Platform](https://img.shields.io/badge/Platform-Android-green?style=flat-square&logo=android)](https://android.com)
12+
[![LSPosed](https://img.shields.io/badge/Framework-LSPosed-blueviolet?style=flat-square)](https://github.com/LSPosed/LSPosed)
13+
[![HyperOS](https://img.shields.io/badge/ROM-HyperOS3-orange?style=flat-square)](https://hyperos.mi.com)
14+
[![Build](https://img.shields.io/badge/Build-Flutter-02569B?style=flat-square&logo=flutter)](https://flutter.dev)
15+
16+
**English** | **[简体中文](README.md)**
17+
18+
</div>
19+
20+
---
21+
22+
## ✨ Features
23+
24+
<table>
25+
<tr>
26+
<td width="50%">
27+
28+
### 📥 Download Manager Extension
29+
Intercepts HyperOS Download Manager notifications and displays them in Dynamic Island style, showing file name and progress with **pause, resume, and cancel** controls.
30+
31+
</td>
32+
<td width="50%">
33+
34+
### 🏝️ Dynamic Island + Focus Notification
35+
Intercepts standard Android notifications from any app and renders them in Dynamic Island + Focus Notification style, preserving the original action buttons.
36+
37+
</td>
38+
</tr>
39+
<tr>
40+
<td width="50%">
41+
42+
### 🚫 Notification Blacklist
43+
Apps on the blacklist will not trigger pop-up notifications — only the Dynamic Island indicator is shown (auto-hidden with the status bar in fullscreen).
44+
45+
</td>
46+
<td width="50%">
47+
48+
### 🔥 Hot Reload Support
49+
Configuration changes take effect **without restarting**. Only scope restarts are required after installing or updating apps.
50+
51+
</td>
52+
</tr>
53+
</table>
54+
55+
---
56+
57+
## 📋 Setup Guide
58+
59+
### Step 1 — Activate the Module in LSPosed
60+
61+
> ⚠️ This module requires the **LSPosed** framework. Your device must be rooted and LSPosed must be installed.
62+
63+
1. Open **LSPosed Manager** and navigate to the **Modules** tab.
64+
2. Find **HyperIsland** and enable the toggle.
65+
3. In the module scope, check the recommended apps:
66+
- **Download notifications**: check **Download Manager**
67+
- **Universal adapter**: check **System UI**
68+
4. Save and tap the **restart button** in the top-right corner to restart the affected scope (or reboot your device) to activate the hook.
69+
70+
---
71+
72+
### Step 2 — Enable Focus Notification Whitelist in HyperCeiler
73+
74+
> 💡 Dynamic Island–style notifications require the "Focus Notification" permission granted through HyperCeiler.
75+
> If you can't find the relevant option, please update HyperCeiler to the latest version.
76+
77+
1. Open **HyperCeiler** and navigate to **System UI** or **Xiaomi Service Framework** settings.
78+
2. Find **"Remove Focus Notification Whitelist"**.
79+
3. Enable the toggle and restart the scope.
80+
81+
---
82+
83+
## ⚠️ Important Notes
84+
85+
| Item | Details |
86+
|------|---------|
87+
| Framework | Requires **LSPosed** and a **rooted** device |
88+
| Restart Timing | Restart scope after installing/updating apps; config changes generally support hot reload |
89+
| Notification Compatibility | Universal adapter only handles **standard Android notifications**; custom notification styles are not supported |
90+
| ROM Compatibility | Tested on **HyperOS 3**; other ROMs may have compatibility issues |
91+
92+
---
93+
94+
## 🔨 Build
95+
96+
Make sure Flutter is installed, then run:
97+
98+
```bash
99+
flutter build apk --target-platform=android-arm64
100+
```
101+
102+
---
103+
104+
## 📄 License
105+
106+
This project is open source under the [LICENSE](LICENSE). Issues and PRs are welcome.
107+
108+
<div align="center">
109+
110+
Made with ❤️ for HyperOS users
111+
112+
[![Star History](https://img.shields.io/github/stars/1812z/HyperIsland?style=social)](https://github.com/1812z/HyperIsland)
113+
114+
</div>

0 commit comments

Comments
 (0)