Skip to content

About

面向小红书的 LSPosed 模块:去广告、收敛弹窗、收紧隐私(个人学习项目,MIT)

Resources

Contributing

Stars

0 stars

Watchers

0 watching

Forks

 
 

Repository files navigation

静盒 (QuietBox)

一个面向小红书的 LSPosed 模块:去掉广告、收敛弹窗、收紧隐私,让 App 安静下来。

基于 libxposed Modern API 102,纯 Java Hook 实现。

当前版本:0.9.9(versionCode 23)。适配小红书 9.53.0(9530807),0.9.8 发布时静态体检清单 64/64;主分支新增 EN-04 旧门与 PV-02 协调器锚点后为 67/67。0.9.8 按 9.53.0 重定位 21 个挂载点(7 SIG / 14 GONE),APK 静态体检 64/64(0.9.8);0.9.7 按 9.52.1 重定位 31 个挂载点(11 SIG / 20 GONE);0.9.6 新增配置逐键容错、config_version 与设置页「恢复默认」;0.9.5 完成失败可见化:全关时仍有诊断/崩溃捕获、安装重试清理失败标记、写回滚保留确认值、字段锚点失败可见、skip 原因列表。0.9.4 新增 EN-04 强制允许保存(默认关,真机验证通过);0.9.3 加入崩溃捕获与导出诊断包;0.9.1 新增 EN-03 实况图去水印(默认关,真机开/关对比验证通过)。0.9.8 已完成 9.53.0 真机冒烟(15 注册 / 3 hit / 0 err),未逐项核对 hook 命中与开关效果。AD-04/AD-05 与 EX-01 离线分支仍未真机验证。只支持 9.53.0,不再支持 9.52.1 及更早版本。

⚠️ 本项目与小红书官方无任何关联,仅供学习、研究和个人设备使用。 使用前请阅读文末的免责声明。

仓库:https://github.com/yigenhuobah/quietbox | 下载:Releases | 反馈:Issues

更新日志见 CHANGELOG.md。


功能

26 项功能,23 项提供开关(3 项 blocked 不渲染;EX-01 为实验性,未在真实场景实测),每项独立开关。默认值遵循“净化开、敏感关”:广告净化与界面精简默认开启,隐私保护、功能增强、实验功能默认关闭。改动需重启小红书生效(实验页的单项实验约 3 秒生效)。

广告净化(AD)

编号 功能 说明 默认
AD-01 开屏广告跳过 覆盖内嵌 Fragment、独立全屏 Activity、冷启动占位三条路径 开
AD-02 信息流广告过滤 开屏关联广告与服务端下发的普通广告都过滤 开
AD-03 评论广告过滤 隐藏评论区广告组件 开
AD-04 广告外跳拦截 广告落地页不拉起淘宝、京东等外部 App 开
AD-05 搜索广告过滤 搜索结果里不显示广告 开
AD-06 详情页广告条屏蔽 隐藏笔记详情页底部的二跳广告条 开
AD-07 评论带货插入屏蔽 评论区顶部不再插入商品卡 开
AD-08 直播卡过滤 首页信息流按 modelType 过滤直播卡;仅覆盖已验证的首页列表链路,详情连播不覆盖 开
AD-09 带货卡过滤 首页信息流按 modelType 过滤带货卡;仅覆盖已验证的首页列表链路,详情连播不覆盖 开
AD-10 投票卡过滤 首页信息流按 modelType 过滤投票卡;仅覆盖已验证的首页列表链路,详情连播不覆盖 开
AD-11 摇一摇跳转禁用 本版本不可用:广告摇一摇检测在原生引擎侧,Java 层无精确挂载点 关

AD-08/09/10 只挂首页信息流的列表追加、刷新与分页路径(9.53.0 为 hgd.m0#S / hgd.m0#C0 / bgd/s#Sd;9.52.1 为 nfd.m0#S / nfd.m0#C0 / ifd/s#Pd;9.52.0 为 ExploreView#S / ExploreView#C0 / vha/s#Pd),不处理详情页连播;9.51.0 真机曾观察到 modelType=note 与 live_v2 并保留正常笔记,9.53.0 沿用同一链路、尚未真机验证,其他类型原样放行。

界面精简(UI)

编号 功能 说明 默认
UI-01 评分引导弹窗屏蔽 不弹「满意吗 / 去评分」和系统评分 开
UI-02 通知引导弹窗屏蔽 不弹「开启通知」引导;手动开通知不受影响 开
UI-03 满意度调研条屏蔽 详情页不再弹出「对内容满意吗」 开
UI-04 更新弹窗屏蔽 不再弹出版本更新提示 开
UI-05 自动播放 关闭详情页/视频 tab 的自动播放(画质偏好本版本不提供) 开

隐私保护(PV)

编号 功能 说明 默认
PV-01 截图检测关闭 不注册截图监听;手动分享不受影响 关
PV-02 通讯录同步关闭 不上传通讯录,不再有通讯录推荐好友 关
PV-03 复制链接净化 去掉链接里的追踪参数(xsec_token 默认保留,可单独勾选删除) 关
PV-04 埋点抑制 本版本不可用:没有安全的挂载点,强行拦截会影响应用生命周期 关

功能增强(EN)

编号 功能 说明 默认
EN-01 水印策略 保存图片时不带水印 关
EN-02 默认静音 本版本不可用:需求取消,小红书自带自动静音 关
EN-03 实况图去水印 保存实况图(Live Photo)不带水印:静态帧跳过水印绘制,视频走与笔记详情预览同源的本地下载链路(不再请求服务端渲染);会切换实况保存链路,默认关闭 关
EN-04 强制允许保存 对作者关闭保存的笔记强制允许保存;默认关,开启前请自行判断合规风险 关

实验功能(EX)

编号 功能 说明 默认
EX-01 已删除笔记查看 实验性:服务端返回「内容无法展示」错误页时,若同进程里还留有同一 noteId 的上一份详情数据,则继续展示;否则走离线/错误分支,页面可能为空。不伪造内容,未在真实被删笔记场景实测 关
EX-02 AB 测试面板 强开小红书灰度实验。实验页内置 21 个高价值、纯客户端的实验开关(详情页渲染、播放体验、评论键盘等),并展示模块探测到的其他实验 key;未收录项只读,不建议修改。支持把全量 key + 当前探测值导出为 CSV 关

强开的是灰度实验组,不是隐藏福利。部分实验依赖服务端配套数据,可能出现页面空白或崩溃。 请一次只开一项、逐项验证;广告、埋点、直播、服务端调参类实验不提供开关。

PV-03 另有一个子选项「同时删除 xsec_token」,不单独编号,依赖 PV-03 开启。


界面

  • 底栏 4 Tab:设置 / 测试 / 诊断 / 关于,底部导航切换、状态各自保留。
  • 设置 Tab:状态卡 → 异常横幅 → AD/UI/PV/EN/EX 分组 → 恢复默认 → 页脚。
  • 状态卡:只有正在连接框架… / 未激活 / 框架已连接 / 已激活四种状态,副标题显示框架 API、目标版本与 remote prefs 可用性。
  • 异常横幅:仅在目标应用版本未适配,或已启用且 ≥2 个功能明确失效时出现;不新增第五种状态。
  • 测试 Tab:AB 测试面板(EX-02)与全量实验导出。
  • 诊断 Tab:逐功能显示 编号 标题 · registered · hit N · skip 原因,无数据用 —;页首显示刷新时间,页尾提供刷新与复制。
  • 关于 Tab:模块版本、目标应用、源码、四模块互链、免责声明与 MIT 许可证。

设置页不展示逐功能诊断信息,排障细节统一放在诊断 Tab。


环境要求

  • Android 10 及以上
  • 已安装 LSPosed(Zygisk 版,配合 Magisk / KernelSU)
  • 小红书 9.53.0(versionCode 9530807)

其他版本可能只有部分功能生效,甚至完全不生效——模块的 Hook 点依赖具体版本。

安装

  1. 从 Releases 下载 quietbox-x.y.z.apk 并安装。
  2. 打开 LSPosed 管理器,在模块列表里启用「静盒」。
  3. 进入模块的作用域设置,勾选 小红书(com.xingin.xhs)。
  4. 打开「静盒」,确认顶部显示 已激活,且副标题包含 已注入小红书。
  5. 按需调整开关。

常见问题

开关是灰色的? 模块 App 还没绑定到 LSPosed 服务。等一两秒会自动刷新;一直灰着就检查 LSPosed 里模块是否启用、作用域是否勾选。

某项功能没效果? 先看诊断页的逐功能状态,再看 logcat(tag QuietBox):

  • 注册成功会打印 AD-05 registered jl0.f0#o
  • 命中会打印 AD-05 hit search ads removed=3

诊断页显示 skip 或没有注册日志,说明这个版本的挂载点没找到,大概率是小红书升级后内部结构变了。请看「兼容性」。

升级小红书后失效了? 正常现象。模块依赖具体版本的内部结构,升级后需要重新适配。顶部出现「目标应用版本未适配」或「N 项功能未生效」的红色提示时,打开诊断页查看 skip 原因。当前唯一适配版本是 9.53.0,升级小红书后请等待新版本模块,或回退到 9.53.0。

会不会导致封号? 模块不修改账号数据、不拦截网络请求、不上传任何信息。但它确实会 Hook 目标应用进程,理论上存在被检测的可能。是否使用、是否用于主账号,请自行评估并承担风险。

和同类模块冲突吗? 同时使用多个 Hook 同一应用的模块可能互相覆盖。建议只保留一个。

需要给静盒加自启动白名单吗? 不需要。功能开关通过 LSPosed 的 remote preferences 传递。诊断与 AB 探测数据由小红书进程单向写入模块 App 的本地 ContentProvider,只在本机展示,不联网、不上传。


隐私

  • 不申请网络权限,App 本身无法联网。
  • 无统计、无遥测、无崩溃上报、无后台服务。
  • 不读取、不上传任何用户数据。
  • 所有逻辑都在本机目标进程内完成。
  • 诊断数据只写入模块 App 的本地存储(status_report),AB 探测结果只写入 ab_report,均仅用于界面展示。
  • 模块只在 LSPosed 中勾选的应用里生效。

兼容性

项目 状态
小红书 9.53.0(9530807) 已适配:21 个挂载点重定位(7 SIG / 14 GONE),0.9.8 静态体检清单 64/64;主分支新增 EN-04 旧门与 PV-02 协调器锚点后 67/67。已完成真机冒烟(15 注册 / 3 hit / 0 err),尚未真机逐项确认,请按诊断页核对 registered/hit
小红书 9.52.1(9521801)及更早 不再支持:不阻断运行(fail-open),横幅提示「未适配」,大部分功能可能失效
Android 10 及以上(minSdk 29) 支持;运行记录覆盖 Android 15(模拟器)与 Android 17(0.8.0 核心回归、0.8.1 诊断修复复验),其余版本未逐一验证
LSPosed(API 102) 支持

已知限制

  • AD-05 只过滤搜索结果中 alioth.entities.i 广告实体,品牌广告卡不在覆盖范围。
  • EN-03 开启后实况保存走预览同源视频:宿主后续若改保存链路(如下线 livePhotoVideoPath)可能失效,因此默认关闭。
  • EX-01(已删除笔记查看)与 AD-04(广告外跳拦截)未真机验证,不据此宣称通过。
  • 小红书 9.52.1 不再支持,请升级到 9.53.0(9530807)。

0.8.1 已修复 0.8.0 的「N 项功能未生效」误报;0.9.0 进一步区分 critical skip 并加入会话标识、TTL 与心跳,只有类级主锚点缺失才会触发失败横幅。

相关模块

四个模块使用统一的设计与工程规范,可分别独立安装:

从源码构建

# 依赖缓存放 D 盘(按需修改)
set GRADLE_USER_HOME=D:\gradle-home

gradlew assembleDebug      # 调试包
gradlew assembleRelease    # 正式包,产物名 quietbox-<版本>.apk

release 读取仓库根目录的 keystore.properties 签名(该文件不入库)。缺失或 storeFile 未配置时,release 任务在执行前直接失败,不会回退 debug 签名,也不会产出未签名包。

工具链:Gradle 8.13(wrapper) · AGP 8.13.2 · compileSdk 37 · minSdk 29 · JDK 21(构建);字节码 source/target 仍为 17。 当前单测 256 项,./gradlew :app:testDebugUnitTest 可复跑;lint 0 errors / 23 warnings。 首次构建需要自己提供 local.properties(sdk.dir=<SDK 路径>)。

许可证

MIT License

免责声明

  • 本项目仅供学习、研究和个人设备使用,不得用于商业用途、二次售卖或批量分发。
  • 本项目与小红书及其运营方无任何隶属、授权或合作关系,也未获得其认可。
  • 本项目不包含目标应用的任何代码、资源或商标素材;不修改目标应用安装包;不拦截网络请求;不提供代理、后台服务或常驻进程。
  • 使用本模块可能违反目标应用的用户服务协议。请自行确认使用场景在当地法律和协议下是否合规。
  • Hook 系统或应用行为可能导致应用异常、崩溃、数据丢失或设备不稳定。所有风险由使用者自行承担,作者不对任何直接或间接损失负责。
  • 请从本仓库的 Releases 下载,不要使用来路不明的改包或二次分发包。
  • 本项目不保证任何功能效果,也不承诺持续更新。
  • 如权利人认为本项目侵犯其权益,请通过 Issue 联系,作者会立即停止分发并删除相关内容。
  • 下载后请于 24 小时内删除。如不同意以上任何一条,请不要下载或使用。

About

面向小红书的 LSPosed 模块:去广告、收敛弹窗、收紧隐私(个人学习项目,MIT)

Resources

Contributing

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages