BetterHeybox

BetterHeybox

增强小黑盒(Heybox)的 LSPosed 模块。

Caution

免责声明

  • 本应用与清枫(北京)科技有限公司无任何关联,亦未经其授权或认可
  • 本项目仅用于学习与研究小黑盒 APP 的部分技术原理,严禁用于任何商业或非法用途
  • 请在下载后 24 小时内删除本应用及相关文件
  • 禁止小黑盒 / HeyBox 平台内发布、讨论或传播本模块的内容,违者后果自负

Note

本应用基于 小黑盒 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;抖音因无分享成功回调暂不支持)
  • 清除今日打卡:打卡失败或想重新执行时,点击「清除今日打卡」清除今日已完成状态并立即重新尝试

链接格式(3 个分享链接均支持以下任意一种)

类型 示例
分享链接(带 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 自动分析)

小黑盒更新常会打乱混淆名,模块通过 DexKit 字节码特征分析 自动重新定位,不必等模块发版适配:

  • 原生弹窗自动定位:以 HeyBoxDialog 内的品牌常量字符串为锚点定位对话框类; Builder 的标题/正文、View 槽位、正向/负向按钮等同签名混淆方法,用 alpha=0 的 「隐形探针」按实际渲染位置自动分类; 分享渠道 / 链接编辑 / 导入确认 / 保存位置等弹窗全部走该通道,解析失败自动回退系统弹窗
  • 设置页启发式定位:binding 字段按 ViewBinding 接口形态判定

致谢

本项目在开发和实现过程中,参考或使用了以下开源项目和库,在此表示衷心感谢:

灵感来源

本项目的部分功能设计和实现思路,受到了以下项目的启发,特别感谢:

  1. SoulFrog自动化分享核心实现思路的主要灵感来源,作者 @xmnh
  2. 假装开启小黑盒通知权限 — 提供了功能上的启发
  3. 小黑盒液态玻璃 — 液态玻璃底栏移植来源

如果涉及任何代码使用不当或版权问题,请随时联系

Releases

v0.7.0

Stable

9/5/2026, 3:42:32 AM

Release v0.7.0

Caution

免责声明
本应用与清枫(北京)科技有限公司无任何关联,亦未经其授权或认可,仅用于学习与研究小黑盒 APP 的部分技术原理,严禁用于任何商业或非法用途 ,请在下载后 24 小时内删除本应用及相关文件
禁止小黑盒 / HeyBox 平台内发布、讨论或传播本模块的内容,违者后果自负

  • 发帖过滤(#15):

    • 屏蔽低等级发帖:按帖子自带等级数据过滤低等级用户,阈值关闭 / Lv1-Lv10 可选,可选屏蔽无等级徽章账号(含官方号,默认放行)
    • 关键词屏蔽:命中标题或正文即屏蔽,一行一个,regex: 前缀支持正则
    • AI 标题党识别(默认关闭):OpenAI 兼容接口逐条判定标题党并屏蔽,内置 DeepSeek / Kimi / 通义 / 智谱 / OpenAI / OpenRouter / 本地模型预设(选中自动填充地址与模型),判定提示词可自定义、支持一键测试连接;帖子标题会发送到所配置的 AI 服务商,请知悉
    • 覆盖首页推荐 / 热点 / 话题详情等信息流列表,本地缓存内容在重新绑定时补拦;新增配置纳入配置备份(AI Token 除外)
  • 浏览器重定向(#18,默认关闭):内置网页中的链接按规则改由系统浏览器打开,启动 / 页面加载 / 页内跳转 / 容器兜底四层拦截,基本消除跳转白屏与闪页;默认仅重定向非小黑盒域名的外链,登录 / 授权 / 支付等敏感页与 .apk 下载强制留内置;「包含小黑盒域名」开启后已知域名也重定向(敏感页仍强制内置);支持「强制重定向域名」「强制内置域名」名单(一行一个,优先级最高,兼容粘贴完整链接)与「重定向浏览器」指定包名(未设系统默认浏览器时不再弹选择框);相关配置纳入配置备份

  • 网页日志(默认关闭):记录内置浏览器打开的页面与标题(最近 80 条),设置面板可查看、全部复制、清空

  • 每日任务完成后返回首页(#13):自动化分享全部完成后自动退回小黑盒首页,清理途中打开的帖子页;设置面板「每日任务」新增开关(默认开启),并纳入配置备份

  • 液态玻璃同步上游 v1.5.0(#14, #16):

    • 玻璃条宽度三模式(自适应/占满/自定义百分比),默认自适应——按标签数量取合适宽度并居中,宽屏上玻璃条不再横贯全屏
    • 底栏形态系统(经典居中/右侧圆钮/自动),右侧圆钮形态用圆形玻璃按钮承载加号
    • Tab 宽度调节(50-150%)与宽度变化过渡动画:隐藏/显示标签、调节宽度时标签与水滴同拍滑动,加号随中缝平滑跟随
    • 加号点击弹跳:点击加号获得与选中 tab 图标同款的弹跳反馈
    • 底部提示条抬升避让:底部 Toast、应用内通知(更新/推荐横幅)自动抬到玻璃条上方 12dp,不再被玻璃条遮挡
    • 重复点击当前 tab 刷新:不再限定标题白名单,任何 tab 的重复点击都按宿主语义刷新

变更

  • 设置面板分组调整:网页相关设置(重定向 / 网页 DevTools / 打开网页 / 网页日志)归入「网页」分组;新增开关联动——「重定向外部链接」与「网页 DevTools」互斥(开一个自动关另一个),「包含小黑盒域名」跟随重定向主开关,联动原地刷新不跳回顶部
  • 「玻璃宽度自适应」更名为「加长选中 Tab」,生效条件与上游对齐(有标签被隐藏时选中项加长)
  • 玻璃条宽度模式 / 自定义宽度 / Tab 宽度 / 底栏形态纳入配置备份

修复

  • 原生弹窗(分享渠道 / 链接编辑 / 导入确认 / 保存位置)误回退系统样式:隐形探针分类时未排除自身注入的替换视图,导致 Builder 方法分类失败;现剔除替换视图并自动重跑探针(最多三轮)(#17)

更新内容

  • c173c11 feat: browser redirect with custom rules, web log and settings group (#18)
  • 439b394 feat: post filter by level, keywords and AI clickbait (#15)
  • 76810d1 feat: sync liquid glass with upstream v1.5.0 (#14, #16)
  • 405bb21 fix: restore probe replacer exclusion, native dialogs fell back to system style (#17)
  • 3278b52 feat: auto return to home after daily share tasks (#13)
  • 5020279 chore: issue triage label priority and max-2 labels per issue
  • 2b5dc03 chore: rework issue triage workflow, remove unused labeler config

碎碎念

关于该模块更多信息,请前往主仓库查看
有问题或者功能建议,请提交 issues 反馈
可以的话请来个 Star QwQ!

Assets

1

v0.6.5

Stable

9/3/2026, 10:18:34 AM

Release v0.6.5

Caution

免责声明
本应用与清枫(北京)科技有限公司无任何关联,亦未经其授权或认可,仅用于学习与研究小黑盒 APP 的部分技术原理,严禁用于任何商业或非法用途 ,请在下载后 24 小时内删除本应用及相关文件
禁止小黑盒 / HeyBox 平台内发布、讨论或传播本模块的内容,违者后果自负

  • 液态玻璃底栏:底部导航栏渲染为实时折射/色散的「液态玻璃」效果,带玻璃水滴选中动画;Android 13+ 启用 GPU 渲染,低版本自动回退毛玻璃。长按首页标题栏图标或设置页「通用设置」行打开调节面板,可调深/浅底色、不透明度、高度、偏移、沉浸式小白条、自适应反色、宽度自适应(感谢 @sjtt2小黑盒液态玻璃)
  • 液态玻璃实现选择:与独立的「小黑盒液态玻璃」模块共存时,首次打开小黑盒自动弹出选择,可让玻璃效果由该模块提供;提供方选择纳入配置备份
  • 屏蔽双列信息流(实验性):将首页推荐 / 话题 / 百科的双列瀑布流恢复为单列,封面比例同步修正(仅 1.3.394 生效,其他版本不显示开关)
  • 网页 DevTools:为小黑盒内置 WebView 开启 Chrome 远程调试
  • 打开网页:设置页输入网址后用小黑盒内置浏览器打开

变更

  • 底部导航栏隐藏优化:剩余 tab 自动等分、选中项被隐藏时自动切换,与液态玻璃联动热生效
  • 视频下载悬浮按钮与液态玻璃调节面板互不遮挡;液态玻璃设置纳入配置备份
  • 设置面板分组调整:「底部导航栏隐藏」移至面板顶部

修复

  • 屏蔽社区推广贴失效:社区/搜索/新闻/频道列表实际渲染未被拦截,现已同时拦截;顺带修复被隐藏的卡片复用给正常帖子时连带消失的问题(#12)
  • 修复关闭「自适应反色」时浅色模式被误判为深色
  • 修复视频下载悬浮按钮监听器泄漏:反复进出视频页会在进程内累积持有已销毁页面的视图树(#11)
  • 修复配置备份遗漏「液态玻璃提供方」选择的问题
  • 图片系统分享功能调用失败(#10)

更新内容

  • 18180c1 feat: glass provider arbitration, single-column feed, cleanup pass
  • 5a3ab49 chore: Update gitignore and issues workflow
  • f52c5a3 fix: Failed to fix image sharing function(#10)
  • 8f12b59 fix: Fixed the issue where the video download button remained visible even when obscured by a subsequent drawing layer.
  • cdb2336 fix: Repairing layout errors when introducing liquid glass
  • fdbfeae fix: The download button should only appear on the video playback page.

碎碎念

关于该模块更多信息,请前往主仓库查看
有问题或者功能建议,请提交 issues 反馈
可以的话请来个 Star QwQ!

Assets

1

v0.5.0

Stable

8/29/2026, 10:15:16 AM

BetterHeybox v0.5.0

新功能

设置页自动分析

  • 小黑盒更新打乱混淆名后,设置相关目标自动重新定位,无需等模块发版适配
  • 原生弹窗(分享渠道 / 链接编辑 / 导入确认 / 保存位置)按字节码特征自动查找,
    混淆方法用「隐形探针」按实际渲染位置分类,结果按宿主版本缓存——同版本二次启动弹窗即开
  • 设置页入口 / binding / 列表 getter 改为反射启发式定位,入口混淆名失效自动回退生命周期 Hook
  • 任一层失败自动回退系统弹窗,核心开关不受影响

视频下载(0.4.5)

  • 视频帖右上角圆形悬浮入口下载

净化分享链接(0.4.5)

  • 复制链接 / 分享到 QQ、微信、微博时,自动去掉小黑盒链接上的追踪参数

诊断与日志(0.4.1)

  • Debug 版运行检查点:设置页可查看「运行状态」
  • 「导出日志」:便于离线排查

优化

  • 正式版日志只保留 error 级,Debug 版全量输出

修复

  • 单参数 Hook 重载因参数越界导致 URL 捕获全部丢失
  • 通知缺少 smallIcon 被系统拒收、下载静默失败
  • 部分系统上解除复制的长按菜单不显示
  • 自动每日任务分享后误跳消息页;分享任务执行失败

关于该模块更多信息,请前往主仓库查看
有问题或者功能建议,请提交 issues 反馈
可以的话请来个 Star QwQ!

Assets

1

v0.4.0

Stable

8/27/2026, 3:07:47 PM

Release 0.4.0

更新内容

  • 兼容小黑盒 1.3.394 版本
  • 模块设置页新增「配置备份」分组(导出配置 / 导入配置)
  • 新增「自动完成每日分享任务」
  • 新增「伪装通知权限」
  • 修复长文正文进入时文字短暂消失
  • 修复图片系统分享功能

关于该模块更多信息,请前往主仓库查看
有问题或者功能建议,请提交 issues 反馈
可以的话请来个 Star QwQ!

Assets

1

0.3.0

Stable

8/25/2026, 9:55:09 AM

release: v0.3.0

  • 调用小黑盒设置UI (感谢 @258a)
  • 新增“系统分享图片”开关
  • 重构内联

关于该模块更多信息,可以前往主仓库查看
有问题请提交 issues 反馈
可以的话请来个 Star !

Assets

1

0.2.5

Stable

8/18/2026, 8:59:51 AM

release: v0.2.5

  • 小黑盒设置页内直接渲染 BetterHeybox 设置面板
  • 支持深色模式打开、关闭、跟随系统三态同步
  • 修复深浅色切换闪烁及 Theme 资源异常
  • 开关与按钮改用系统 Monet 取色
  • 增加 Heybox 1.3.393 版本检测与更新屏蔽
  • 移除无效的桌面图标隐藏功能及独立桌面入口

关于该模块更多信息,可以前往主仓库查看

Assets

1