增强小黑盒（Heybox）的 LSPosed 模块。
完整源码、技术栈、工程结构、构建与使用说明见主仓库： Mrmiaomrzh/BetterHeybox
Caution
免责声明
- 本应用与清枫(北京)科技有限公司无任何关联，亦未经其授权或认可，请注意甄别来源
- 本项目仅供学习与研究小黑盒 APP 的部分技术原理，请勿用于任何非法用途
- 本模块会修改宿主应用的运行时行为，可能存在账号封禁、数据异常等风险，请自行评估并承担后果
- 由于项目特殊性，禁止将本模块用于商业用途，也不为其在商业场景下的可用性、合规性提供担保或支持
- 建议删除本应用及相关文件，并禁止在 小黑盒 / HeyBox 平台内发布、讨论或传播本模块
本项目授权条款以主仓库 LICENSE为准
Note
本模块兼容 小黑盒 1.3.393 及以上版本，已适配至 1.3.396 / 1135（APK），其他版本出现的问题不会进行处理
Warning
使用免Root框架「NPatch」时，需要把破解签名校验改成Extreme，不然会有缺少参数闪退的问题
Note
Telegram 发布频道，欢迎加入交流
所有功能开关均可在小黑盒「我的 → 设置 → 通用设置」中的 BetterHeybox 设置 入口直接打开模块面板。
模块设置面板采用分类两级结构：一级页只列「功能分类」入口，点进去才是该类别的全部设置项， 支持搜索，左上角箭头与系统返回键都回到分类页，面板刷新（改一个开关）后仍停留在当前页。
| 分类 | 包含设置 |
|---|---|
| 广告与内容过滤 | 广告过滤、发帖过滤、评论过滤、搜索 / 游戏库 / 帖子详情页面精简、分享净化 |
| 界面与外观 | 液态玻璃底栏、底部导航栏隐藏、消息红点、实验性功能 |
| 浏览与下载 | 解除复制、网页、视频下载、截图 |
| 动态推送 | 关注对象 / 话题 / 关键词、抓取范围、提醒方式、第三方推送、测试与调试 |
| 每日任务 | 自动完成三个分享任务、自动完成「我的任务」限时任务 |
| 通用与备份 | 通知权限、屏蔽更新、日志、配置备份、关于 |
| 类型 |
|---|
| 屏蔽开屏广告 |
| 屏蔽信息流广告 |
| 屏蔽气泡广告 |
| 屏蔽角标广告 |
| 屏蔽推广贴 |
开关在设置页「广告与内容过滤」的「搜索页精简 / 游戏库精简 / 帖子详情精简」里，默认关闭、切换即时生效：
| 开关 | 隐藏内容 |
|---|---|
| 隐藏搜索页横幅 | 搜索栏正下方的横幅推荐 |
| 隐藏「搜索发现」 | 搜索页的搜索发现标题与推荐列表 |
| 隐藏「黑盒热榜」 | 搜索页的热榜标签页榜单与热词 / 热议卡片 |
| 屏蔽帖子下无关内容 | 帖子正文下方的相关搜索、文字配图横幅（来试试黑盒文字配图）、小程序推荐、合集、活动 |
| 话题行防误触 | 只禁用帖子最下方话题行的点击跳转，仍然可见可读 |
| 隐藏话题栏 | 整行隐藏帖子最下方的 #话题 标签 |
| 额外隐藏的视图名 | 用于隐藏静态分析定不到的区块 |
| 诊断：帖子详情精简状态 | 资源解析 / 命中的区块 / 观察到的候选区块 |
| 隐藏游戏库横幅 | 游戏库顶端的三图横幅推荐 |
| 隐藏游戏库小分区 | 黑盒商城、小程序等入口卡片 |
| 隐藏游戏库推荐分区 | 「为你推荐」等分区标题与内容卡 |
| 自定义隐藏类型 | 勾选要隐藏的服务端 type |
| 隐藏指定入口卡片 | 逐个勾选要隐藏的入口卡片，或长按卡片直接隐藏 |
| 隐藏指定推荐分区 | 按分区标题逐个勾选要隐藏的分区 |
| 诊断：游戏库精简状态 | 目标解析 / Hook 安装 / 候选数 / 最近一次长按 |
- 长按游戏库入口卡片会弹小黑盒原生样式的「隐藏「XXX」？」确认框，确认即隐藏
- 搜索 / 游戏库精简只作用于搜索落地页与游戏库，搜索历史 / 搜索结果页 / 其它页面不受影响
- 帖子详情精简只作用于帖子详情页正文下方的区块，不改变正文本身
- 以上配置纳入配置备份
| 过滤项 | 说明 |
|---|---|
| 屏蔽低赞帖子 | 点赞数 < 阈值即屏蔽；阈值关闭 / 1 / 5 / 10 / 20 / 50 / 100 / 200 / 500 / 1000 |
| 屏蔽低评论帖子 | 评论数 < 阈值即屏蔽；候选同上 |
| 屏蔽低收藏帖子 | 收藏数 < 阈值即屏蔽；候选同上。部分列表（旧链社区帖、资讯流）服务端不下发收藏数，这些列表自动放行 |
| 屏蔽低等级帖 | 阈值关闭 / Lv1-Lv10；无等级数据默认放行，可再开「屏蔽无等级用户」 |
| 关键词屏蔽 | 命中标题或正文即屏蔽，一行一个，regex: 前缀为正则 |
| AI 标题党识别 | 默认关闭；OpenAI 协议接口，内置 DeepSeek / Kimi / 通义 / 智谱 / OpenAI / OpenRouter / 本地模型预设，标题会发给你配置的服务商 |
| 屏蔽视频帖 | 默认关闭 |
| 屏蔽插眼评论 | （#36），默认开启 |
| 评论关键词屏蔽 / 无意义评论 | （#36），默认关闭；额外屏蔽宿主判定的无意义灌水评论，regex: 前缀为正则 |
| 屏蔽游戏链接 | （#40），默认关闭；屏蔽评论区只发游戏链接的「游戏名接龙」 |
| 自动清理失效收藏 | 默认关闭；打开收藏列表发现失效内容时自动发起宿主清理 |
覆盖首页推荐流、社区 Tab、话题详情、频道、游戏评测、榜单、搜索结果等列表；收藏夹 / 草稿箱不参与。改动规则后刷新列表或滚动重绑生效；配置纳入配置备份。
| 功能 | 说明 |
|---|---|
| 液态玻璃底栏 | 实时折射 / 色散玻璃底栏，水滴选中动画、沉浸式小白条、颜色随背景自适应；长按首页标题栏右上角图标或设置页「通用设置」行打开调节面板（底色 / 不透明度 / 高度 / 距底偏移 / 宽度 / Tab 宽度 / 形态）；Android 12 及以下回退毛玻璃 |
| 液态玻璃提供方 | 与独立的「小黑盒液态玻璃」模块共存时可选由谁提供，避免两条玻璃叠加 |
| 底部导航栏隐藏 | 隐藏底栏 tab 项（需重启小黑盒）；剩余 tab 自动等分，选中项被隐藏时自动切换 |
| 屏蔽双列信息流 | 实验性，仅 1.3.396（1134）及以上显示；首页推荐 / 话题 / 百科恢复单列 |
开关在「界面与外观」的「消息红点」里，默认关闭、切换即时生效：
| 开关 | 说明 |
|---|---|
| 隐藏消息未读红点 | 打开后首页 / 社区 / 热点 / 我的 / 话题 / 频道都不再显示；底栏「消息」小红点随之消失，底栏数字角标不受影响 |
| 精简消息入口 | 消息列表里按勾选处理入口行：只藏红数字，或整行移除 |
| 隐藏红数字的入口 | 勾选只隐藏右侧红色数字的入口，默认「活动消息」「官方消息」；候选来自匹配的入口行 |
| 完整隐藏的入口 | 勾选整行从消息列表移除的入口，默认不隐藏任何入口 |
| 诊断：消息红点状态 | 开关 / 挂点 / 两个勾选集 / 已观察到的入口标题 |
| 功能 | 说明 |
|---|---|
| 解除复制 | 恢复安卓系统标准文本选择，选择手柄可跨行拖动 |
| 评论区自由复制 | （#32），默认开启；长按评论的菜单不变，点「复制」后多出 复制全部内容 / 自由复制 / 复制 @昵称 |
| 快速截图 | （#44），默认开启；右下角「截图」悬浮入口进入多选模式，单选 / 多选信息流帖子与详情页评论，合成一张长图后保存到相册或分享 |
| 图片系统分享 | 图片长按追加「系统分享」，优先存系统相册并修正真实格式 / MIME |
| 净化分享链接 | 复制 / 分享时去掉 h_camp、h_session_id 等追踪参数，保留 link_id 等功能参数 |
截图可在设置面板「浏览与下载 → 截图功能」里进一步调整：截图时隐藏用户标签（默认开）、
时间戳（默认关）、操作按钮（默认开）、关闭图标（默认开）、关注按钮（默认开）、
点赞数（默认开）、图片数量角标（默认开）、无关内容（默认开），
并支持「自定义隐藏内容」（资源名或 text:关键词）与「添加水印」（默认关）。
| 功能 | 说明 |
|---|---|
| 浏览器重定向 | 默认关闭；内置网页外链改走系统浏览器，登录 / 授权 / 支付 / .apk 强制留内置 |
| 包含小黑盒域名 | 默认关闭；官方 H5 与小程序页面始终留内置（登录态靠内置 WebView 注入） |
| 重定向浏览器 | 指定用哪个浏览器打开，未设系统默认时不再弹「打开方式」 |
| 强制重定向 / 强制内置域名 | 一行一个（兼容完整链接），优先级高于默认规则 |
| 网页日志 | 默认关闭；记录内置浏览器打开的页面与标题（最近 80 条） |
| 网页 DevTools | 为内置 WebView 开启 Chrome 远程调试 |
| 打开网页 | 输入任意 http/https 地址用内置浏览器打开 |
| 功能 | 说明 |
|---|---|
| 下载入口 | 视频帖右上角圆形悬浮按钮，正文 / 信息流 / 故事 / 游戏卡片均可 |
| 下载面板 | 准备 / 下载中 / 暂停 / 完成 / 失败五态；面板可关闭，后台继续下载 |
| 格式与续传 | mp4 直链与 HLS 分片；断点续传，HLS 合并后自动转封装 MP4 |
| 保存位置 | 默认相册 Movies/BetterHeybox，可改任意文件夹；文件名优先帖子标题，重名加序号不覆盖 |
| 通知与分享 | 通知栏显示进度 / 完成 / 失败，完成后可播放 / 分享 / 删除 |
| 功能 | 说明 |
|---|---|
| 自动完成三种分享任务 | 分享任意帖子 / 游戏详情 / 游戏评价，各配一个链接；未配置的自动跳过，状态按日期跨天重置 |
| 分享渠道 | QQ / QQ空间、微信 / 朋友圈、微博；在分享面板点对应按钮并伪造成功回调，不会真的发出内容 |
| 完成后返回首页 | 默认开启，顺带清理途中打开的帖子页 |
| 清除今日打卡 | 清除今日已完成状态并立即重试 |
链接格式（3 个链接均支持）：
| 类型 | 示例 |
|---|---|
| 分享链接（带 link_id） | https://api.xiaoheihe.cn/v3/bbs/app/api/web/share?link_id=123456 |
| 网页链接 | https://xiaoheihe.cn/a/123456 |
| 深链协议 | heybox://v3/bbs/app/api/web/share?link_id=123456 |
| 游戏详情 | https://api.xiaoheihe.cn/game/share_game_detail?appid=123456&game_type=pc |
获取方式：小黑盒内打开帖子 / 游戏页 → 分享 → 复制链接。game_statistic 这类中转 / 统计链接（会 302 到应用宝下载页，模块会拦下并跳过该步）。
| 功能 | 说明 |
|---|---|
| 自动完成我的任务 | 读取「我的任务」列表，命中关键词的未完成任务自动填好正文 |
| 半自动 / 全自动 | 默认半自动（模块填正文、你按「发布」）；打开「全自动发帖」后由模块直接提交 |
| 只做限时任务 | 只处理带倒计时的任务，默认开启 |
| 完成后删帖 | 任务进度确认推进后删掉刚发的帖子，默认开启 |
| 自动领奖 | 任务变成可领取时自动打开领奖入口，默认开启 |
| 发帖内容 / 匹配关键词 | 正文默认「扣1」；标题 / 描述命中任一关键词即视为目标任务 |
| 每天最多 | 默认 1 条 |
| 立即执行 | 不等自动时机，立刻检查一次 |
| 诊断 | 「刷新任务状态 / 查看任务状态 / 清除今日记录」 |
默认关闭；开启后每天最多自动处理 1 条命中的限时任务，（#42）。
动态推送（（#26））
| 功能 | 说明 |
|---|---|
| 关注动态提醒 | 关注作者（userid 或主页链接）有新动态时提醒 |
| 关键词监控 | 一行一个，regex: 为正则；可只匹配标题 |
| 关注话题 | 一行一个；可「导入关注话题」或「搜索话题」加入 |
| 关键词 / 话题拉流 | 按关键词搜索、按话题取最新帖；首次只登记基线，每轮最多 5 个关键词 |
| 推荐关键词 | 取小黑盒热搜词 / 联想词，点一下加入监控 |
| 时间窗 / 检查间隔 | 30 分钟 ~ 30 天 / 5 分钟 ~ 12 小时 |
| 提醒方式 | 应用内横幅、系统通知（点击盒内打开）、第三方推送（钉钉 / WxPusher / AstrBot / 自定义 webhook） |
| 检查时机 | 打开小黑盒、宿主收到推送时搭便车、信息流命中；默认最小间隔 10 分钟 |
默认关闭，未配置监控目标时不发起任何请求；取数复用宿主 OkHttp，签名由宿主拦截器补齐。
| 功能 | 说明 |
|---|---|
| 版本前置检测 | 仅支持 1.3.393 / 1.3.394 / 1.3.395 / 1.3.396，不匹配时提示 |
| 首启免责声明 | 首次打开小黑盒需「同意并继续」 |
| 关于 | 查看模块版本号、打开 GitHub 仓库 |
| 伪装通知权限 | 让小黑盒认为通知权限已开启，获得签到加成 |
| 伪装使用情况权限 | （#43），默认关闭；让小黑盒认为「使用情况访问」已授权，绑定手机设备时不再弹「游戏时长统计」权限框，也不读取真实使用情况数据 |
| 返回空使用情况数据 | 连带让游戏时长等使用情况统计返回空，并阻止后台上传 |
| 诊断：使用情况权限伪装 | 开关状态 / 命中次数 / DexKit 解析来源 |
| 屏蔽更新 | 屏蔽小黑盒更新入口 |
| 记录日志 | 把模块运行日志写入文件；「导出日志」附带模块统计，崩溃时自动记录堆栈 |
本项目在开发和实现过程中，参考或使用了以下开源项目和库，在此表示衷心感谢：
- LSPosed — Xposed 框架基础
- Libxposed api — Apache-2.0，现代 Xposed 模块 API
- Dexkit — Apache-2.0，字节码特征分析
- HeyBox-LiquidGlass — 液态玻璃底栏移植来源
- QEA0-Liquid-Glass-Android — MIT，液态玻璃渲染器
- AndroidLiquidGlassView — MIT，QmDeve，AGSL shader 与 GPU 渲染路径
本项目的部分功能设计和实现思路，受到了以下项目的启发，特别感谢：
- SoulFrog — 自动化分享核心实现思路的主要灵感来源，作者 @xmnh
- 假装开启小黑盒通知权限 — 提供了功能上的启发
如果涉及任何代码使用不当或版权问题，请随时联系