feat: update embedded settings and theme handling

Author: Mrmiaomrzh

.gitignore

@@ -18,6 +18,7 @@ captures/
 
 # Temp
 analysis/
+.tools/
 docs/
 
 # Keystore

CHANGELOG.md

@@ -2,9 +2,21 @@
 
 本项目版本号采用 `v主版本.次版本.修订版本` 格式。推送代码时，CI 会构建带日期和当日序号的版本并将 APK 保存在 Action 成品中；Release 工作流手动输入版本号后创建正式 Release，并在说明中列出 commit 更新内容。
 
-## [Unreleased]
+## 0.2.1
 
-## [0.2.0] - 未发布
+### 内嵌设置与主题
+- 小黑盒设置页入口改为直接渲染 BetterHeybox 面板，不再跳转独立设置 Activity
+- 修复内嵌面板因跨应用 Theme 资源混用导致的 `Resources$NotFoundException`
+- 支持小黑盒深色模式「打开 / 关闭 / 跟随系统」三态读取
+- 深色模式使用黑底白字，浅色模式使用白底黑字；切换后自动刷新入口和面板颜色
+- 入口注入前读取当前主题状态，避免设置页重载时出现颜色闪烁
+- 开关与退出按钮改用 Android 系统 Monet 色板取色
+
+### 通用
+- 增加小黑盒目标版本 `1.3.393` 检测提示
+- 增加可选的「屏蔽更新」开关
+
+## [0.2.0]
 
 首个可分发版本。
 
@@ -24,5 +36,4 @@
 - 修复拖动选择只能拉一行（选择时放行滚动容器触摸拦截）
 
 ### 通用
-- 不显示桌面图标（组件级禁用，可从小黑盒设置页入口进入）
 - 设置页「立即重启」：杀小黑盒后台进程 + LSPosed 热重载（无 root）

README.md

@@ -1,13 +1,13 @@
 # BetterHeybox
 
-小黑盒（Heybox）增强的 LSPosed 模块（libxposed Modern API 102）。
+增强小黑盒（Heybox）的 LSPosed 模块。
 
 ## Note
-本应用基于小黑盒1.3.393上完成，低于此版本出现的问题不会进行处理
+本应用基于 [小黑盒 1.3.393](./HeyboxDownload/1.3.393.apk) 完成，低于此版本出现的问题不会进行处理
 
 ## 功能
 
-所有功能开关均可在模块自带设置界面（`SettingsActivity`）独立控制；
+所有功能开关均可在小黑盒「我的 → 设置 → 通用设置」中的`BetterHeybox 设置`入口直接在当前页面内打开模块面板。
 开关经 LSPosed **RemotePreferences** 跨进程同步，**广告过滤类开关即时生效**。
 
 ### 广告过滤
@@ -18,25 +18,28 @@
 | 信息流广告|
 | 气泡广告 |
 | 角标广告 | 
-| 推广贴 |
+| 部分推广贴 |
 
 ### 界面增强
 
 - **底部导航栏优化**（需重启小黑盒生效）：隐藏「首页 / 热点 / 游戏库 / 加号」；
   隐藏加号时联动隐藏「推荐」占位，剩余 tab 完全等分、无空白
 - **设置页入口注入**：小黑盒「我的 → 设置」页顶部自动插入 "BetterHeybox 设置" 入口，
-  优先复用小黑盒 `SettingItemView` 样式（失败回退纯代码构建，深浅色均清晰）
+  点击后直接在当前页面渲染模块设置面板，不启动独立设置页
+- **主题同步**：识别小黑盒深色模式的「打开 / 关闭 / 跟随系统」三种状态；
+  深色为黑底白字，浅色为白底黑字，切换后自动刷新入口和面板
+- **系统 Monet 取色**：开关和退出按钮使用 Android 系统 Monet 色板
 
 ### 帖子增强
 
-- **解除复制**：Hook 掉小黑盒自定义 `TextSelectHandler` 的长按拦截，
+- **解除复制**：Hook 小黑盒自定义 `TextSelectHandler` 的长按拦截，
   恢复安卓系统标准文本选择（长按正文弹「复制/全选」菜单，采用系统复制）
 - **拖动跨行选择修复**：文本选择激活时放行滚动容器的触摸拦截，选择手柄可跨行拖动
 
 ### 通用
 
-- **不显示桌面图标**：组件级禁用 `LaunchActivity`（立即生效），
-  隐藏后仍可从小黑盒设置页注入的入口进入模块设置
+- **版本前置检测**：检测小黑盒是否为目标版本 `1.3.393`，不匹配时显示提示
+- **屏蔽更新**：提供可选开关，屏蔽小黑盒更新入口
 
 ## 技术栈
 
@@ -59,13 +62,10 @@ app/src/main/
 │   ├── MainModule.java          # 模块入口
 │   ├── App.java                 # Application：连接框架服务、RemotePreferences 存取
 │   ├── SettingsActivity.java    # 模块设置界面
-│   └── LaunchActivity.java      # 桌面图标入口
 ├── res/                         # 设置页布局 / 字符串 / drawable
 └── resources/META-INF/xposed/   # 模块声明
 ```
 
-另有 `docs/`（开发前置准备文档）与 `analysis/`（逆向分析工作区，不入库）。
-
 ## 模块声明
 
 不再使用 Manifest meta-data 与 `assets/xposed_init`，全部声明在 `META-INF/xposed/`：
@@ -96,4 +96,4 @@ app/src/main/resources/META-INF/xposed/
 4. **看日志**：`adb logcat -s BetterHeybox`（每个 Hook 安装成功/失败均有 ✔/✘ 日志）
 
 # 免责声明
-本应用与清枫（北京）科技有限公司无关，仅学习研究小黑盒APP原理，请在下载后24h内删除
+本应用与清枫（北京）科技有限公司无关，仅学习研究小黑盒APP原理，请在下载后24h内删除

app/src/main/AndroidManifest.xml

@@ -20,27 +20,20 @@
         tools:ignore="MissingApplicationIcon">
 
         <!--
-          桌面图标入口（可被「不显示桌面图标」开关禁用）。
-          隐藏后仍可通过 小黑盒设置 → BetterHeybox 设置 进入模块设置。
-        -->
-        <activity
-            android:name=".LaunchActivity"
-            android:exported="true"
-            android:theme="@android:style/Theme.DeviceDefault.DayNight">
-            <intent-filter>
-                <action android:name="android.intent.action.MAIN" />
-                <category android:name="android.intent.category.LAUNCHER" />
-            </intent-filter>
-        </activity>
-
-        <!--
-          模块设置界面。exported=true：允许小黑盒进程（Hook 注入的入口）启动它。
-          不设 LAUNCHER：由 LaunchActivity 作为桌面入口（可被开关禁用）。
+          模块设置界面。由小黑盒内嵌入口使用；不提供独立桌面启动入口。
         -->
         <activity
             android:name=".SettingsActivity"
             android:exported="true"
             android:theme="@android:style/Theme.DeviceDefault.DayNight" />
+
+        <receiver
+            android:name=".PreferenceReceiver"
+            android:exported="true">
+            <intent-filter>
+                <action android:name="com.better.heybox.SET_BOOLEAN" />
+            </intent-filter>
+        </receiver>
     </application>
 
 </manifest>

app/src/main/java/com/better/heybox/App.java

@@ -1,9 +1,7 @@
 package com.better.heybox;
 
 import android.app.Application;
-import android.content.ComponentName;
 import android.content.SharedPreferences;
-import android.content.pm.PackageManager;
 
 import io.github.libxposed.service.XposedService;
 import io.github.libxposed.service.XposedServiceHelper;
@@ -18,9 +16,6 @@ public class App extends Application implements XposedServiceHelper.OnServiceLis
     /** RemotePreferences 分组名（Hook 侧用同名读取） */
     public static final String PREFS_GROUP = "betterheybox";
 
-    /** 本地 UI 状态存储（用于桌面图标组件校正，不依赖 RemotePreferences 连接） */
-    public static final String LOCAL_PREFS = "betterheybox_ui";
-
     /** 功能开关 key */
     public static final String KEY_OPEN_SCREEN = "open_screen";
     public static final String KEY_FEED_AD = "feed_ad";
@@ -32,7 +27,7 @@ public class App extends Application implements XposedServiceHelper.OnServiceLis
     public static final String KEY_HIDE_TAB_GAME = "hide_tab_game";
     public static final String KEY_HIDE_ADD = "hide_add";
     public static final String KEY_COPY_POST = "copy_post";
-    public static final String KEY_HIDE_ICON = "hide_icon";
+    public static final String KEY_BLOCK_UPDATE = "block_update";
 
     // 框架服务实例（volatile 保证跨线程可见）
     private static volatile XposedService sService;
@@ -41,31 +36,13 @@ public class App extends Application implements XposedServiceHelper.OnServiceLis
     public void onCreate() {
         super.onCreate();
         XposedServiceHelper.registerListener(this);
-        syncDesktopIconState();
-    }
-
-    /**
-     * 校正桌面图标组件状态：与本地记录保持一致。
-     * 防止「恢复图标」时残留 DISABLED（即使桌面未即时刷新，下次进程启动也会校正回 DEFAULT）。
-     */
-    private void syncDesktopIconState() {
-        try {
-            boolean hide = getSharedPreferences(LOCAL_PREFS, MODE_PRIVATE)
-                    .getBoolean(KEY_HIDE_ICON, false);
-            ComponentName cn = new ComponentName(this, "com.better.heybox.LaunchActivity");
-            getPackageManager().setComponentEnabledSetting(cn,
-                    hide
-                            ? PackageManager.COMPONENT_ENABLED_STATE_DISABLED
-                            : PackageManager.COMPONENT_ENABLED_STATE_DEFAULT,
-                    PackageManager.DONT_KILL_APP);
-        } catch (Throwable t) {
-            // 校正失败不影响主流程
-        }
     }
 
     @Override
     public void onServiceBind(XposedService service) {
         sService = service;
+        PreferenceReceiver.tryFlush(this,
+                getSharedPreferences("betterheybox_pending", MODE_PRIVATE));
     }
 
     @Override