RuleForge 收集多个公开项目的代理分流规则，经过统一解析、规范化、去重和冲突裁决后，生成 Quantumult X 与 Mihomo 可以使用的分类规则。
项目只处理公开规则及其生成过程，不提供节点订阅，也不保存账号、Cookie、Token、证书或私钥。
- 已裁决分类规则用于远程分流。每条规则都带有策略列。
- 候选分类规则保留去重后的候选项，其中包括发生过冲突、最终可能被排除的规则。
- 远程过滤器片段按业务优先级引用各分类文件。
- 完整配置模板沿用既有 Quantumult X 模板，已移除节点订阅和私有证书内容，可直接导入后补入自己的节点。
- 构建摘要记录来源哈希、规则数量和裁决统计。
- 冲突报告记录冲突内容、处理结果和裁决原因。
- Curation 报告记录共享基础设施排除项和业务分类纠正。
- 审计报告记录共享基础设施根域的 risk 项。
- 跨分类优先规则承载分类文件顺序无法表达的具体规则优先级。
- 优先规则预览用实际 first-match 样例列出审计判断与当前路由不一致的规则；当前模板不会引用这些候选规则。
- AI Curation 清单记录可审计的排除项。
- 已裁决 Classical 规则不包含策略列，具体策略由配置中的
RULE-SET指定。 - 候选分类规则用于审阅合并和裁决前的候选项。
- Rule Provider 片段包含 26 个远程规则提供者。
- 路由规则片段按业务优先级引用 26 个 Rule Provider。
- 通用配置示例提供双订阅、地区测速组和业务策略组。
- 构建摘要与冲突报告记录 Mihomo 来源的构建结果。
- Curation 报告记录共享基础设施排除项和业务分类纠正。
- 审计报告记录共享基础设施根域的 risk 项。
- 优先规则预览用 Mihomo 当前 Rule Provider 顺序模拟实际命中；当前模板不会引用这些候选规则。
- AI Curation 清单记录可审计的排除项。
下载 完整 Quantumult X 配置模板 后，在 [server_remote] 或客户端的节点管理中加入自己的订阅。模板的策略组、DNS、远程重写、本地规则、定时任务和 MITM 分区沿用既有实际模板；公共文件不包含节点订阅、账号信息或本地证书材料。
模板内的 [filter_remote] 已接入仓库当前的分类片段，规则内容会由远程分类文件独立更新，每日刷新一次。已有配置只想更新规则时，继续使用 远程过滤器片段 即可。模板同时显式设置 fallback_udp_policy = reject，未匹配的 UDP 默认拒绝；需要 QUIC/UDP 时请确认所选节点确实支持。
下载 profiles/mihomo/config.example.yaml 后，替换下面两个订阅地址占位符。
REPLACE_WITH_SUBSCRIPTION_1
REPLACE_WITH_SUBSCRIPTION_2模板默认只监听本机，secret 为空，TUN 与 IPv6 关闭，DNS 使用 Fake-IP。模板同时启用 GeoSite 中国域名数据库，避免 Fake-IP 流量只能依赖 GEOIP,CN。Proxy Provider 节点 UDP 默认显式关闭，确认服务端支持后再按 provider 开启。业务策略组排在地区测速组之前，保留订阅原始节点名称，图标来自 Orz-3 mini/Color。完整使用说明见 Mihomo 模板说明。
26 个 Mihomo Rule Provider 指向本仓库 main 分支，每 86400 秒刷新一次；GeoSite 数据也按 24 小时自动更新。Quantumult X 完整模板中的远程规则和重写资源同样统一为每日刷新。
| 分类 | 默认策略 | 用途 |
|---|---|---|
reject、privacy |
reject |
广告、跟踪和隐私规则 |
alipay、wechat |
direct |
支付宝与微信直连 |
china-services |
direct |
国内电商、地图、出行和常用服务 |
china-streaming |
direct |
哔哩哔哩、优酷、爱奇艺和 AcFun |
china-direct、direct-exception |
direct |
国内直连与明确的直连例外 |
ai |
AI |
OpenAI、Claude、Gemini、Copilot 等 AI 服务 |
apple |
苹果服务 |
Apple 相关服务 |
google-voice |
美国节点 |
Google Voice |
google |
谷歌服务 |
Google 相关服务 |
microsoft、cloud |
全球加速 |
Microsoft、OneDrive、Dropbox、MEGA 等服务 |
social |
全球加速 |
Twitter、Facebook、Instagram、Discord 等社交服务 |
developer |
全球加速 |
GitLab、Docker、Figma、Notion、npm 等开发者服务 |
github |
GitHub |
GitHub 相关服务 |
spotify |
Spotify |
Spotify |
telegram |
电报代理 |
Telegram |
tiktok |
海外抖音 |
TikTok |
youtube |
YouTube |
YouTube |
netflix |
Netflix |
Netflix |
china-media |
港台番剧 |
国内及港台媒体补充规则 |
global-media |
国际媒体 |
国际流媒体 |
proxy-exception、proxy |
全球加速 |
明确的代理例外与全球代理兜底 |
Mihomo 模板在 AI 规则后使用 GEOSITE,openai,AI 覆盖官方 OpenAI 域名，再处理其他业务和代理规则；最后使用 GEOSITE,cn,DIRECT 作为中国域名兜底，再使用 GEOIP,CN,DIRECT 处理已经拿到真实目标 IP 的连接。
规则按业务用途分类，同一个分类可以同时包含域名、IP 段等不同规则类型。目标渲染器负责把统一规则模型转换为客户端语法，不改变分类和策略。
每次构建依次执行以下步骤。
- 拉取来源并更新缓存。
- 按来源格式解析为统一规则模型。
- 合并同一业务分类中的多个来源。
- 应用可审计的 Curation 规则，排除共享云厂商 ASN 和通用 SaaS 根域。
- 规范化规则并删除完全重复的内容。
- 检查语义重叠和策略冲突。
- 按安全策略、显式业务 override、规则具体程度、业务分类语义、同分类来源优先级和稳定 fallback（仅用于 semantic overlap 排序）进行裁决，并以最终目标客户端会实际匹配的语义为准。
- 对仍然存活的跨分类重叠构造域名或 IP 样例，并按最终分类顺序模拟实际 first-match。
- 生成客户端规则、构建摘要、冲突报告、Curation 报告和不生效的优先规则预览。
冲突裁决会处理域名关键词、通配符和 CIDR 重叠。裁决顺序为 security > explicit override > specificity > category semantics > same-category source preference > fallback。完全相同的 selector 只有在存在安全、显式业务或 category preference 时才选择一个结果，否则保持 unresolved；fallback 只用于 semantic overlap 的 first-match 排序。普通 direct 不覆盖 reject，只有明确的 direct-exception 才允许这样做。共享云厂商和 SaaS 根域会进入审计风险清单，专用业务分类通常为 high、宽泛策略分类为 medium；更具体的业务 hostname 不因位于同一根域而被一并标记。
categories/candidates/ 用于检查候选规则，categories/safe/ 才是提供给客户端的已裁决版本。
priority-preview.json 和 priority-preview.md 只用于观察潜在路由变化。预览会过滤已经被其他冲突淘汰的规则；精确域名、更窄后缀或 CIDR 等可以构造可靠样例的差异会列为候选，关键词及受到第三条规则干扰的关系继续标记为待审阅。Apple 自有域名及官方 Apple Intelligence/iCloud 端点统一以“苹果服务”为预期策略，避免 QX 与 Mihomo 分别落入 AI、国际媒体或通用代理；明确的 reject 和 direct-exception 仍然优先。预览文件不会被完整模板或远程片段引用。
当前主要来源为 Blackmatrix7/ios_rule_script，并使用 ConnersHua/RuleGo 与 ACL4SSR/ACL4SSR 补充和交叉检查。
Quantumult X 与 Mihomo 使用两份独立清单。两份清单保持相同的业务分类和策略边界，各自采用适合目标客户端的上游格式，生成结果不会互相作为输入。QX 没有 Mihomo 的 GEOSITE,openai 兜底，因此额外登记了 oaistatsig.com 的 QX 补充规则。
需要 Python 3.11 或更高版本。生成器只使用 Python 标准库，不需要安装第三方 Python 包。
python tools/ruleforge.py lint --manifest sources/quantumultx.yaml
python tools/ruleforge.py lint --manifest sources/mihomo.yaml
python -m unittest discover -s tests -v
python tools/ruleforge.py build --manifest sources/quantumultx.yaml --refresh --fail-on-conflict
python tools/ruleforge.py build --manifest sources/mihomo.yaml --refresh --fail-on-conflict带有 --refresh 的构建会访问上游来源。任一来源抓取失败、没有解析出规则、出现解析异常、不受支持的规则类型或仍有未决冲突时，命令会失败。生成过程先写入同盘暂存目录，全部检查和渲染成功后才替换正式输出；失败构建不会覆盖上一次可用结果。
Update proxy rules 每天在 UTC 2 时 17 分运行，对应中国时间 10 时 17 分。也可以从 GitHub Actions 页面手动触发。
工作流先运行回归测试，再依次构建 Quantumult X 与 Mihomo。两个目标全部通过后才会提交生成结果。单纯的生成时间和缓存状态变化不会产生提交。
CI 使用固定版本的 Mihomo v1.19.30，并校验下载文件的 SHA256。内核检查通过后，工作流会按刚发布的提交 SHA 下载 26 个 Mihomo、26 个 Quantumult X 规则文件、QX 远程过滤器片段和两套优先规则预览，与本地构建结果逐字节比对；同时确认 main 分支公开地址仍可读取。
- 上游规则可能出现误判、遗漏、更新延迟或地址失效。使用者需要结合自己的网络环境测试。
- 静态测试和 Mihomo 内核配置检查只能证明文件格式与引用关系成立，不能代替真实客户端、节点、DNS 和业务页面验收。
- Quantumult X 与 Mihomo 使用独立上游清单，同名分类的覆盖数量和客户端行为可能不同；切换客户端后应分别验收常用域名。
- 规则内容的许可、署名和转载要求以上游项目说明为准。本项目不主张拥有上游规则的原创权。
- 请遵守所在地法律、组织网络规定和目标服务条款，不要将本项目用于违法或未经授权的用途。
- 正式使用前应保留原配置，以便出现问题时回退。
感谢以下公开规则项目及其维护者。