增强小黑盒(Heybox)的 LSPosed 模块。
Caution
免责声明
- 本应用与清枫(北京)科技有限公司无任何关联,亦未经其授权或认可
- 本项目仅用于学习与研究小黑盒 APP 的部分技术原理,严禁用于任何商业或非法用途
- 请在下载后 24 小时内删除本应用及相关文件
- 禁止在 小黑盒 / HeyBox 平台内发布、讨论或传播本模块的内容,违者后果自负
本应用基于 小黑盒 1.3.393 和小黑盒 1.3.394(1127)完成,低于此版本出现的问题不会进行处理
完整源码、技术栈、工程结构、构建与使用说明见主仓库: Mrmiaomrzh/BetterHeybox
所有功能开关均可在小黑盒「我的 → 设置 → 通用设置」中的 BetterHeybox 设置 入口直接打开模块面板,
| 类型 |
|---|
| 屏蔽开屏广告 |
| 屏蔽信息流广告 |
| 屏蔽气泡广告 |
| 屏蔽角标广告 |
| 屏蔽推广贴 |
- 屏蔽低等级帖:按帖子自带等级数据过滤低等级用户的发帖, 阈值可选关闭 / Lv1-Lv10;无等级数据的账号默认放行, 可通过「屏蔽无等级用户」开关一并屏蔽(含官方号,需先开启等级阈值)
- 关键词屏蔽:命中帖子标题或正文即屏蔽,一行一个;
regex:前缀条目按正则匹配(忽略大小写),如regex:白嫖.{0,4}资格 - AI 标题党识别(默认关闭):调用 AI 逐条判定标题党并屏蔽; 兼容 OpenAI 协议接口,内置 DeepSeek / Kimi / 通义 / 智谱 / OpenAI / OpenRouter / 本地模型(Ollama 等)预设(选中自动填充地址与模型),判定提示词可自定义, 支持一键测试连接;帖子标题会发送到你配置的 AI 服务商,请知悉
- 覆盖首页推荐 / 热点 / 话题详情等信息流列表;改动规则后需刷新信息流或加载新分页生效, 本地缓存已渲染的帖子会在滚动重新绑定时补拦
- 以上配置纳入配置备份(AI Token 除外)
- 底部导航栏优化(需重启小黑盒生效):隐藏底栏tab项
- 液态玻璃底栏(需重启小黑盒生效,Android 13+ 为玻璃效果): 底部导航栏渲染为实时折射/色散的「液态玻璃」效果,带玻璃水滴选中动画、沉浸式小白条, 标签/图标颜色随背景亮度自适应反色;长按首页标题栏右上角图标或 设置页**「通用设置」行**可打开顶部调节面板,实时调节深/浅底色、不透明度、高度、 距底部偏移、宽度自适应(选中项加长)等;与底栏隐藏联动,隐藏 tab 后玻璃条同步收缩; Android 12 及以下自动回退毛玻璃效果
- 液态玻璃实现选择:与独立的「小黑盒液态玻璃」模块共存时,首次打开小黑盒 自动弹出选择,可让玻璃效果由该模块提供——本模块的玻璃底栏与长按入口同步让位, 避免两条玻璃底栏叠加;选择后仍可在设置面板「液态玻璃提供方」行切换
- 屏蔽双列信息流(实验性,仅 1.3.394):将首页推荐 / 话题 / 百科的 双列瀑布流恢复为单列,封面宽高比同步修正回旧单列卡样式
- 解除复制:Hook 小黑盒自定义
TextSelectHandler的长按拦截, 恢复安卓系统标准文本选择 - 拖动跨行选择修复:文本选择激活时放行滚动容器的触摸拦截,选择手柄可跨行拖动
- 图片系统分享:图片查看器中长按图片,在原有分享面板追加「系统分享」动作, 下载当前图片后优先保存到系统相册(可被相册真正查看、可被任意 App 分享), 自动识别 jpg/png/gif/webp/bmp 真实格式并修正 MIME;可通过「系统分享图片」开关关闭
- 净化分享链接:复制链接 / 分享到 QQ、微信等渠道时,自动去掉小黑盒链接上的追踪参数;默认开启,可通过「净化分享链接」开关关闭
- 浏览器重定向(默认关闭):内置网页中的链接按规则改由系统浏览器打开。
默认仅重定向非小黑盒域名的外链,登录 / 授权 / 支付等敏感页与
.apk下载强制留内置 (登录态 Cookie 只在内置 WebView 注入,外链误跳会断登录);开关联动: 「重定向外部链接」与「网页 DevTools」互斥,「包含小黑盒域名」跟随重定向主开关 - 包含小黑盒域名:已知小黑盒域名也重定向,敏感页仍强制内置
- 重定向浏览器:指定打开链接用的浏览器,未设系统默认浏览器时不再弹「打开方式」选择框; 换机 / 卸载自动回退系统解析
- 强制重定向域名 / 强制内置域名:一行一个域名(兼容粘贴完整链接), 分别总是走外部浏览器 / 总是留内置,优先级高于默认规则
- 网页日志(默认关闭):记录内置浏览器打开的页面与标题(最近 80 条), 设置面板可查看、全部复制、清空
- 网页 DevTools:为小黑盒内置 WebView 开启 Chrome 远程调试,电脑
chrome://inspect可调试内置网页 - 打开网页:输入任意 http/https 地址,用小黑盒内置浏览器打开
- 下载入口:视频帖右上角圆形 Monet 渐变悬浮按钮
- 底部下载面板:
- 准备:标题 / 来源 / 预计大小 → 「开始下载」
- 下载中:实时百分比、已下载/总大小、当前速度 → 「暂停下载」「取消下载」
- 暂停:「继续下载」
- 完成:保存路径 → 「播放」「分享」「完成」
- 失败:错误原因 → 「重新下载」
- 后台下载:面板可随时关闭,下载继续进行;悬浮按钮进度环持续反馈
- 全类型视频:正文 / 信息流 / 故事 / 游戏卡片均可;mp4 直链与 HLS(m3u8)分片流均支持
- 断点续传
- 自动转封装 MP4:HLS 合并后自动无损转封装为 MP4
- 智能命名:文件名优先使用帖子标题,HLS 通用名(segs/index)自动回退时间戳;
重名自动加
(n)后缀,绝不覆盖 - 保存位置:默认相册
Movies/BetterHeybox;设置「保存位置」可调起系统文件选择器 选择任意文件夹,完成通知显示实际保存路径 - 通知栏反馈:进度(含暂停/取消)、完成(播放/分享/删除 + 保存路径)、失败(重试/取消)
- 系统分享:完成后一键分享视频文件
- 自动完成每日分享任务:自动完成小黑盒每日任务的 3 种分享任务
- 任务一:分享任意帖子(配置帖子链接)
- 任务二:分享游戏详情(配置游戏详情链接)
- 任务三:分享游戏评价(配置游戏评价链接)
- 3 个独立链接设置:帖子链接 / 游戏详情链接 / 游戏评价链接,各自独立配置; 未配置的任务自动跳过;每日状态按日期记录,跨天重置
- 分享渠道可配置:内嵌面板/独立设置页「分享渠道」可选 QQ / QQ空间、微信 / 朋友圈 或 微博, 自动分享按所选渠道在分享面板点击对应按钮并伪造成功回调(默认 QQ;抖音因无分享成功回调暂不支持)
- 清除今日打卡:打卡失败或想重新执行时,点击「清除今日打卡」清除今日已完成状态并立即重新尝试
| 类型 | 示例 |
|---|---|
| 分享链接(带 link_id) | https://api.xiaoheihe.cn/v3/bbs/app/api/web/share?link_id=123456 |
| 网页链接(xiaoheihe.cn) | https://xiaoheihe.cn/a/123456 |
| 深链协议(heybox://) | heybox://v3/bbs/app/api/web/share?link_id=123456 |
链接经小黑盒 RouterActivity 自动路由到对应帖子/游戏页;未配置的类型自动跳过。
获取方式:在小黑盒 App 打开目标帖子 → 分享 → 复制链接,取分享链接或网页链接均可; 游戏/频道页同理复制分享链接
- 版本前置检测:检测小黑盒版本是否为受支持版本
1.3.393/1.3.394,不匹配时显示提示 - 伪装通知权限:让小黑盒认为通知权限已开启,获得签到加成
- 屏蔽更新:提供可选开关,屏蔽小黑盒更新
- 记录日志:提供「记录日志」开关,开启后自动把模块运行日志写入文件
小黑盒更新常会打乱混淆名,模块通过 DexKit 字节码特征分析 自动重新定位,不必等模块发版适配:
- 原生弹窗自动定位:以 HeyBoxDialog 内的品牌常量字符串为锚点定位对话框类; Builder 的标题/正文、View 槽位、正向/负向按钮等同签名混淆方法,用 alpha=0 的 「隐形探针」按实际渲染位置自动分类; 分享渠道 / 链接编辑 / 导入确认 / 保存位置等弹窗全部走该通道,解析失败自动回退系统弹窗
- 设置页启发式定位:binding 字段按 ViewBinding 接口形态判定
本项目在开发和实现过程中,参考或使用了以下开源项目和库,在此表示衷心感谢:
- 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
- 假装开启小黑盒通知权限 — 提供了功能上的启发
- 小黑盒液态玻璃 — 液态玻璃底栏移植来源
如果涉及任何代码使用不当或版权问题,请随时联系