# Arremes Max 规则语法说明 (小白友好版)

> 这份文档只讲两件事:**怎么写规则**、**写了会发生什么**。
> 不需要懂编程,照着例子抄就行。

---

## 一、一分钟上手 (先看这 4 个例子)

| 你想干什么 | 就写这一行 | 效果 |
|---|---|---|
| 拦掉某个域名 | `||example.com^` | example.com 和它的所有子域名都会被拦 |
| 放行某个域名 | `@@||example.com^` | 明确放行 (哪怕别的规则想拦它) |
| 拦掉所有 443 端口 | `||*:443^$network` | 任何 IP 的 443 端口 (HTTPS)都拦 |
| 写一句注释 | `! 这是注释` 或 `# 这是注释` | 不生效,只是给自己看的 |

**三条铁律**:拦截规则是"黑名单",放行规则**必须带 `@@`**,没命中的自动"直通"。

---

## 二、三种结果,一次说清

引擎对每一条数据只会给出三种判定之一:

| 判定 | 什么时候出现 | 结果 |
|---|---|---|
| **拦截** | 命中了拦截规则 (黑名单) | 数据被丢弃,连不上 |
| **放行** | 命中了 `@@` 放行规则 (白名单) | 数据正常通过 |
| **直通** | 谁都没命中 (默认状态) | 数据正常通过 |

> 大白话:门口保安拿两个名单。
> 黑名单上有的 → 拦下；白名单 (`@@`)上有的 → 直接放；
> 两个名单都没有 → 默认通行 (直通)。
>
> **注意**:活动页只会把"命中 `@@` 的"标记成"放行"；其余没命中的都叫"直通"。这是正常的,不是 bug。

---

## 三、定制符号语法 (推荐写法)

| 语法 | 含义 | 示例 |
|---|---|---|
| `||域名^` | 拦截域名及其子域 | `||behaviorlog.qq.com^` |
| `||*关键字*^` | 通配符匹配 | `||*anticheat*^` |
| `||IP^$ip` | 拦截指定 IP | `||180.97.219.4^$ip` |
| `||:端口^$prot` | 拦截端口 | `||:443^$prot` (等价 `*:443`) |
| `||IP:端口^$ip_port` | 拦截 IP:端口 | `||180.97.219.4:49155^$ip_port` |
| `||IP:*^$network` | 拦截该 IP 的全部端口 | `||180.97.219.4:*^$network` |
| `||*:端口^$network` | 拦截任意 IP 的指定端口 | `||*:49155^$network` |
| `@@||域名^` | 放行 (白名单) | `@@||pay.qq.com^` |
| `!` / `#` | 注释行 | `# 这是注释` |

### 修饰符速查

| 修饰符 | 意思 |
|---|---|
| `$ip` | 这条是 IP |
| `$prot` / `$port` | 这条是端口 |
| `$ip_port` | 这条是 IP:端口 |
| `$network` | 这条是"IP:*"或"*:端口" |

---

## 四、传统写法还能用吗?能。

| 传统写法 | 等于 |
|---|---|
| `> 域名` | `||域名^` (拦) |
| `+ 域名` | `@@||域名^` (放) |
| `= 域名` | 精确匹配 |
| `$443` | `*:443` (拦端口) |
| `0.0.0.0 域名` (hosts 格式) | `||域名^` (拦) |
| 中文:`拦 x` / `只拦 x` / `放 x` / `拦端口 x` | 同上,兼容保留 |

> 新旧语法可以混着写,一行一条,别写在同一行里。

---

## 五、常见问题 (最容易踩的坑)

**Q1:为什么我的规则不生效?**
- 检查前缀:拦截要 `||` 开头、放行必须是 `@@||` 开头；
- 检查端口规则:端口写法必须是 `*:443` 这种格式 (或 `||*:443^$network`)；
- 检查是不是被 `@@` 放行规则"盖过了" (放行优先)。

**Q2:为什么开了之后所有网站都打不开?**
- 十有八九写了 `||*:443^$network` (拦所有 443)或 `||*:80^$network` (拦所有 80)。
- 这**不是 bug**,是规则本来的意思:拦"任意 IP 的 443/80 端口"。
- 想只拦特定目标:把 `*` 换成具体 IP,例如 `||180.97.219.4:443^$ip_port`。

**Q3:勾了"拦截应用"后,别的应用会受影响吗?**
- 不会。只有勾选的应用 (被 VPN 接管),其余应用完全不受影响。

**Q4:内置规则现在是什么?**
- 当前内置 2 条端口规则 (下面第六节),旧版 163 万条已备份可回滚。

**Q5:拦了会不会误伤我自己的 App?**
- 本应用自己的流量永远不进拦截引擎 (自动排除自身)。

**Q6 如果都正常还是没办法拦截,感觉自己没搞错。**
- 检查是不是傻到把''也当场规则用了,''只是md文档用来标注高亮,当成规则的我建议去医院看看脑科。

---

## 六、内置规则现状

```text
||*:443^$network
||*:80^$network
```

- 含义:拦截"任意 IP 的 443 端口 / 80 端口"。
- 旧版 163 万条全量表已备份 (work/hosts_backup_1635528.txt)。
- 改表后必须同步更新 `assets/rules/stamp.txt` (格式 `行数|字节数|日期`),以触发端上重建。

---

## 七、加载链 (了解即可)

```text
assets/rules/hosts.txt
   └─ 构建时加密并重命名为随机名
        └─ 运行时解密 → files/net_hosts
             └─ 服务启动后逐行解析 (RuleX 语法归一)
                  └─ 进表:域名表 / IP:端口表
                       └─ 详情页显示"内置规则数 / 成功加载数"
```

---

## 八、活动页分类口径

- 「放行」= 命中 `@@` 放行规则；
- 「拦截」= 命中拦截规则；
- 「直通」= 未命中任何规则 (照常转发)。
