🐮 GrandpaNiu

---

⚠️ 使用限制与风险声明

本仓库内容仅供 个人学习、研究和实验使用。

禁止将本仓库内容用于以下行为：

• 商业服务
• 收费转售
• 改名搬运
• 镜像分发
• 代运营
• 引流项目
• 其他变相商业用途

规则净化存在误杀风险。使用本仓库模块后，可能出现：

• App 打不开
• 视频无法播放
• 图片加载异常
• 登录异常
• 页面空白
• 某些按钮失效
• 某些广告未完全去除

遇到问题时，请先关闭模块，或者关闭对应 App 的增强规则进行排查。使用者需要自行承担导入、运行、修改和依赖本仓库内容所产生的风险。

---

📌 这是什么？

GrandpaNiu 是一个用于 Shadowrocket、Surge 和 Android 规则客户端 的广告净化与规则构建仓库。

简单理解：

这是一个把常见 App 广告规则、脚本规则、重写规则和 Android 规则整理到一起的自动化融合模块仓库。

主要用于处理：

• 开屏广告
• 弹窗广告
• 横幅广告
• 活动卡片
• 信息流推荐
• 追踪请求
• 部分 App 冗余接口请求

---

🧭 当前策略：只维护一个融合模块

GrandpaNiu 的公开入口只保留一个主模块：

Ronghemokuai.sgmodule

Release 目录里的 Release/Module.sgmodule 是兼容别名，由构建器从 Release/Ronghemokuai.sgmodule 复制生成；新用户仍然只导入根目录 Ronghemokuai.sgmodule。

设计原则是：

多来源规则与脚本 → 候选池 → 审查与去重 → 保护规则优先 → 单一融合模块

也就是说，本仓库不是 Stable / Lite / Full / Aggressive 多版本路线。Release/Modules/ 下的 App 独立模块只是诊断和便利用途，不作为新的公开版本体系。

融合策略详见：docs/FUSION_POLICY.md。

---

✅ 小白怎么用？

普通用户只需要用下面这个主模块入口。

🍎 iPhone / Shadowrocket / Surge

推荐使用主融合模块：

https://grandpaniuu.github.io/GrandpaNiu/Ronghemokuai.sgmodule

使用步骤：

1. 点击上面的“安装模块”按钮，或复制模块链接。
2. 打开 Shadowrocket 或 Surge。
3. 找到“模块”或“Module”。
4. 选择“从 URL 导入”。
5. 粘贴链接。
6. 启用模块。
7. 更新模块、脚本和资源。
8. 重启需要净化的 App。

🤖 Android

Android 用户可以查看 Android 规则入口：

Android 规则主要适合：

• Mihomo
• Clash Meta
• FlClash
• sing-box
• AdGuard DNS
• AdGuard Home
• v2rayNG / V2Ray / Xray 分流片段

注意：Android 规则不能完全等同于 iOS 模块，因为 Android 通常不支持 Shadowrocket / Surge 那种 Script、MITM、Rewrite 能力。

🪟 Windows / v2rayN

v2rayN 使用专用的自定义路由 JSON 数组格式：

https://grandpaniuu.github.io/GrandpaNiu/Windows/v2rayN/GrandpaNiu-v2rayN-custom-routing.json

导入方法：

快捷路径：路由设置 → 自定义规则 → 从 URL 或剪贴板导入

1. 打开 v2rayN。
2. 进入「路由设置」。
3. 打开「自定义规则」。
4. 选择「从 URL 导入」，粘贴上面的链接。
5. 如果当前版本没有 URL 导入，就先打开链接复制 JSON 内容，再选择「从剪贴板导入」。
6. 保存路由设置，并让当前配置重新应用。

规则顺序是：GrandpaNiu 广告拦截 → 国内/私有地址直连 → 其他全部代理。

---

🚀 核心功能

🍎 iOS 模块

• Shadowrocket / Surge 融合模块
• 常见广告域名拦截
• App 开屏广告净化
• 弹窗、横幅、活动卡片清理
• 部分 App 脚本增强
• YouTube、Spotify、知乎、Bilibili、微博、淘宝、京东、拼多多等常见规则维护
• 单一公开入口，避免用户选择多个版本

🤖 Android 规则

• 域名规则
• 关键词规则
• IP 规则
• DNS 拦截规则
• sing-box / Mihomo / Clash Meta / AdGuard 等格式输出

⚙️ 自动化构建

仓库已配置 GitHub Actions，用于：

• 每日自动更新
• 每日自动重建融合模块
• 自动同步 Release 产物
• 自动生成健康检查报告
• 源文件变化后自动构建最终模块

---

🧩 当前版本策略

本仓库当前采用 Fusion 单一融合版。

不再主要维护多个旧版本入口，例如：

• Stable
• Stable Plus
• Lite
• Full

维护方向不是增加公开版本数量，而是提高唯一融合模块的稳定性：

• 候选规则先进入 Rewrite/Sources/Candidates/
• 不适合的规则归档到 Rewrite/Sources/Rejected/
• 登录、支付、视频播放、CDN 等稳定性保护规则优先加载
• 最终公开输出仍然是 Ronghemokuai.sgmodule
• Release/Module.sgmodule 仅作为 Release 目录兼容别名，不是新的公开版本线

Android iOS 兼容增强层

Android 构建现在会从 iOS/Fusion 源文件中提取可安全迁移的 [Rule] REJECT 域名、关键词和 IP 规则，自动合并到 Android 主规则集，并生成 iOS-App-Compatible-Reject 兼容输出。

同时新增两层更稳的 Android 去广告增强：

• iOS-Rewrite-Compatible-Reject：只从 iOS [URL Rewrite] 的 reject 行里提取“域名本身就是广告/统计/弹窗/营销”的 host，不迁移路径级核心 API。
• Android-Ad-SDK-Compatible-Reject：从 Rules/aggressive-ads.list 中抽取明确广告 SDK / 广告网络域名，跳过宽泛关键词、URL 正则、登录、支付、银行、视频播放和 CDN 保护链路。

脚本、MITM、Body Rewrite、Header Rewrite、Map Local、登录、支付、银行、验证码、视频播放、图片/CDN 保护链路不会直接迁移到 Android 拦截规则中。