可以。下面这份就是一版 **“类 ACL4SSR 风格 INI/CONF 配置整体说明”**，你可以直接丢给 Codex。
它刻意 **不引入 YAML**，只保留高密度、行导向、声明式的写法。你现在贴的配置本身已经在用 `[custom]`、`ruleset=`、`custom_proxy_group=`、`enable_rule_generator=true`、`overwrite_original_rules=true` 这套思路；subconverter 现有 ACL4SSR 相关配置和外部配置 gist 里也能看到同类结构，甚至有把公共规则和公共分组拆出去再导入的写法。 ([GitHub][1])

---

# sub-provider 类 ACL4SSR 风格 INI 配置说明（草案）

## 1. 目标

将 sub-provider 的配置设计为一种 **ACL4SSR-like 的高密度 INI/CONF DSL**，用于：

* 管理订阅源
* 定义节点选择器
* 定义代理组
* 注册规则模块
* 选择输出 profile
* 生成完整 Clash/Mihomo YAML

这里的重点不是兼容标准 INI 解析器，而是：

> **保留 INI 的可读感 + ACL4SSR 的高密度声明风格 + 方便 Python 自定义解析**

---

## 2. 设计原则

### 2.1 保留 ACL4SSR 的使用习惯

沿用这些核心心智模型：

* `ruleset = 规则模块 -> 目标策略组`
* `group = 策略组定义`
* `selector = 节点筛选器`
* `source = 订阅源`
* `profile = 输出方案`

### 2.2 高密度、行导向

每一条配置尽量一行表达一个对象，方便：

* 快速编辑
* 批量复制
* diff
* 注释开关
* 手工维护

### 2.3 规则正文与配置分离

* `*.list` 文件只保存规则主体
* 目标策略组由配置指定
* 生成器负责最终拼接

### 2.4 不追求严格标准 INI

原因：

* 标准 INI 不擅长重复 key
* 不擅长表达列表对象
* 不擅长表达高密度分组语法

因此这里定义的是：

> **INI-like / CONF-like 自定义配置格式**

---

## 3. 文件组织

推荐结构：

```text
config/
  base.conf
  profiles/
    default.conf
    lite.conf
    media.conf

rules/
  modules/
    Riglen.list
    LocalAreaNetwork.list
    UnBan.list
    BanAD.list
    BanProgramAD.list
    Google.list
    GoogleCN.list
    SteamCN.list
    Bing.list
    OneDrive.list
    Microsoft.list
    Apple.list
    Telegram.list
    AI.list
    OpenAi.list
    YouTube.list
    Netflix.list
    ProxyMedia.list
    ProxyGFWlist.list
    Pt.list
    ChinaDomain.list
    ChinaCompanyIp.list
    Download.list
```

### 说明

* `base.conf`：全局配置、源、选择器、组定义、模块注册、内置规则
* `profiles/*.conf`：不同输出方案
* `rules/modules/*.list`：规则正文

---

## 4. 基础语法

## 4.1 注释

支持两种注释：

```ini
; 这是注释
# 这也是注释
```

## 4.2 空行

空行忽略。

## 4.3 键值形式

基本格式：

```ini
key = value
```

左右空格允许存在，解析时应 trim。

## 4.4 重复 key

允许重复 key。
例如：

```ini
source = ...
source = ...
selector = ...
selector = ...
group = ...
group = ...
module = ...
module = ...
```

解析器应将这类 key 视为“多条记录”，而不是覆盖。

## 4.5 大小写

建议：

* 指令名小写
* 值区分大小写
* 策略组名、规则内容、正则表达式保持原样

---

## 5. 支持的指令

本方案定义以下核心指令：

* `listen`
* `output_dir`
* `cache_dir`
* `mode`
* `allow_lan`
* `log_level`
* `ipv6`
* `append_userinfo_header`
* `userinfo_source_policy`

以及对象型指令：

* `source =`
* `selector =`
* `group =`
* `module =`
* `builtin =`

profile 内支持：

* `name =`
* `enabled =`
* `sources =`
* `include_modules =`
* `exclude_modules =`
* `include_builtins =`
* `override_policy =`
* `prepend_rule =`
* `append_rule =`

---

## 6. base.conf 说明

## 6.1 全局标量配置

### 示例

```ini
listen = 0.0.0.0:3000
output_dir = ./output
cache_dir = ./data/cache
mode = rule
allow_lan = true
log_level = info
ipv6 = false
append_userinfo_header = true
userinfo_source_policy = first_enabled_source
```

### 含义

* `listen`：监听地址
* `output_dir`：生成结果输出目录
* `cache_dir`：缓存目录
* `mode`：Clash 模式，通常为 `rule`
* `allow_lan`：是否允许局域网访问
* `log_level`：日志级别
* `ipv6`：是否开启 IPv6
* `append_userinfo_header`：是否透传订阅流量头
* `userinfo_source_policy`：多源时如何选取订阅信息头

---

## 6.2 source 指令

### 目标

定义订阅输入源。

### 格式

```ini
source = key,type,value,enabled=true,cache_ttl=1800
```

### 示例

```ini
source = airport_main,url,https://example.com/sub?token=xxxx,enabled=true,cache_ttl=1800
source = local_links,file,./data/local_links.txt,enabled=false
```

### 字段说明

* 第 1 列：`key`
* 第 2 列：`type`
* 第 3 列：`value`
* 后续：可选命名参数

### 支持类型

* `url`：远程订阅链接
* `file`：本地文件
* `inline`：内联文本
* `base64`：base64 内容

### 建议解析规则

前三列固定，后续按 `k=v` 解析。

---

## 6.3 selector 指令

### 目标

定义节点筛选器，供代理组复用。

### 格式

```ini
selector = key,regex
```

### 示例

```ini
selector = all,.*
selector = hk,(港|HK|hk|Hong Kong|HongKong|hongkong)
selector = jp,(日本|东京|大阪|JP|Japan)
selector = us,(美|洛杉矶|西雅图|US|United States)
selector = netflix,(NF|奈飞|解锁|Netflix|NETFLIX|Media)
```

### 含义

* `key`：选择器名
* `regex`：匹配节点名的正则表达式

### 约定

后续在 `group` 指令中通过 `@selector_key` 引用。

---

## 6.4 group 指令

这是整个 DSL 的核心。
它保留 ACL4SSR 风格的高密度分组写法。你的示例里已经大量使用 `custom_proxy_group=` 这种反引号分隔格式。 现有 subconverter 相关 ACL4SSR 配置里也是同类写法。([GitHub][1])

### 格式

```ini
group = 组名`类型`参数1`参数2`参数3...
```

### 成员约定

* `[]组名`：引用已有组
* `[]DIRECT`：内置 DIRECT
* `[]REJECT`：内置 REJECT
* `@selector_key`：引用 selector 动态筛节点
* `.*`：兼容保留写法，可映射为全部节点

### 示例

```ini
group = 🚀 节点选择`select`[]♻️ 自动选择`[]🇭🇰 香港节点`[]🇯🇵 日本节点`[]🚀 手动切换`[]DIRECT
group = 🚀 手动切换`select`@all
group = ♻️ 自动选择`url-test`@all`http://www.gstatic.com/generate_204`300,,50
group = 🇭🇰 香港节点`url-test`@hk`http://www.gstatic.com/generate_204`300,,50
group = 🇯🇵 日本节点`url-test`@jp`http://www.gstatic.com/generate_204`300,,50
group = 🎥 奈飞节点`select`@netflix
group = 🐟 漏网之鱼`select`[]DIRECT`[]🚀 节点选择`[]♻️ 自动选择
```

### 解析规则建议

#### `select`

```ini
group = 组名`select`成员1`成员2`成员3...
```

#### `url-test`

```ini
group = 组名`url-test`@selector`测试URL`间隔,,容差
```

#### `fallback`

```ini
group = 组名`fallback`@selector`测试URL`间隔,,容差
```

#### `load-balance`

```ini
group = 组名`load-balance`@selector`测试URL`间隔,,容差
```

### 设计建议

不要再继续沿用 `custom_proxy_group=` 这个旧名字。
内部 DSL 里直接统一为：

```ini
group = ...
```

这样更短，也更像你自己的项目语法。

---

## 6.5 module 指令

### 目标

注册规则模块。

### 格式

```ini
module = key,path,policy,order,enabled
```

### 示例

```ini
module = riglen,./rules/modules/Riglen.list,🚀 节点选择,10,true
module = lan,./rules/modules/LocalAreaNetwork.list,🎯 全球直连,20,true
module = banad,./rules/modules/BanAD.list,🛑 广告拦截,40,true
module = apple,./rules/modules/Apple.list,🍎 苹果服务,80,true
module = ai,./rules/modules/AI.list,💬 Ai平台,100,true
module = openai,./rules/modules/OpenAi.list,💬 Ai平台,101,true
```

### 字段说明

* `key`：模块唯一标识
* `path`：规则文件路径
* `policy`：默认策略组
* `order`：排序
* `enabled`：默认是否启用

### 规则文件约定

规则文件只保存规则主体，不含目标策略组。

例如 `OpenAi.list`：

```ini
DOMAIN-SUFFIX,openai.com
DOMAIN-SUFFIX,chatgpt.com
DOMAIN-SUFFIX,oaistatic.com
```

生成时补成：

```ini
DOMAIN-SUFFIX,openai.com,💬 Ai平台
```

---

## 6.6 builtin 指令

### 目标

定义不来自 `.list` 文件的内置规则。

### 格式

```ini
builtin = key,type,value,policy,order,enabled
```

### 示例

```ini
builtin = geoip_cn,GEOIP,CN,🎯 全球直连,9000,true
builtin = final,FINAL,,🐟 漏网之鱼,9999,true
```

### 映射规则

* `GEOIP + CN + 🎯 全球直连`
  -> `GEOIP,CN,🎯 全球直连`
* `FINAL + 🐟 漏网之鱼`
  -> `MATCH,🐟 漏网之鱼`

### 说明

这里保留了 ACL4SSR 配置里 `[]GEOIP,CN`、`[]FINAL` 这种内置规则思想，只是换成更适合你项目的数据化声明。你的现有配置里已经有这两类用法。 ([GitHub][1])

---

## 7. profile 配置说明

每个 profile 一个文件，放在 `config/profiles/` 下。

---

## 7.1 基本字段

### 示例

```ini
name = 默认完整配置
enabled = true

sources = airport_main
include_modules = riglen,lan,unban,banad,apple,telegram,ai,openai
exclude_modules =
include_builtins = geoip_cn,final
```

### 含义

* `name`：profile 名称
* `enabled`：是否启用
* `sources`：本 profile 使用哪些订阅源
* `include_modules`：启用哪些模块
* `exclude_modules`：从启用列表中排除哪些模块
* `include_builtins`：启用哪些内置规则

---

## 7.2 override_policy 指令

### 目标

覆盖模块默认策略组。

### 格式

```ini
override_policy = module_key,new_policy
```

### 示例

```ini
override_policy = apple,🚀 节点选择
override_policy = ai,💬 Ai平台
```

### 含义

例如某模块默认是 `🍎 苹果服务`，某 profile 想改成 `🚀 节点选择`，就在 profile 里覆盖。

---

## 7.3 prepend_rule / append_rule 指令

### 目标

给特定 profile 注入自定义规则。

### 示例

```ini
prepend_rule = DOMAIN-SUFFIX,internal.example.com,DIRECT
append_rule = DOMAIN-SUFFIX,test.example.com,🚀 节点选择
```

### 含义

* `prepend_rule`：插在 rules 最前
* `append_rule`：插在 builtin 之前或之后，由实现约定

### 建议

`MATCH` / `FINAL` 仍应最后输出。

---

## 8. 解析器行为规范

## 8.1 base.conf

解析器应支持：

* 普通标量键值
* 多条 `source`
* 多条 `selector`
* 多条 `group`
* 多条 `module`
* 多条 `builtin`

## 8.2 profile.conf

解析器应支持：

* 普通标量键值
* 多条 `override_policy`
* 多条 `prepend_rule`
* 多条 `append_rule`

## 8.3 字段 trim

建议默认：

* 去掉左右空白
* 不改动组名内部空格
* 不改动正则原文

## 8.4 布尔值

支持：

* `true/false`
* `yes/no`
* `1/0`

内部统一成布尔值。

## 8.5 列表字段

例如：

```ini
sources = airport_main,local_links
include_modules = apple,ai,openai
```

按逗号切分，trim 后转数组。

## 8.6 module/source 的 CSV 解析

建议用 Python `csv` 模块解析逗号分隔，而不是简单 `split(",")`，避免后续扩展时出问题。

## 8.7 group 的反引号解析

建议：

1. 去掉前缀 `group =`
2. 按反引号 `` ` `` 分段
3. 第一段为组名
4. 第二段为类型
5. 后续段按组类型解释

---

## 9. 生成流程规范

生成器处理顺序建议如下：

### 第 1 步：加载 base.conf

构建：

* 源表
* selector 表
* group 定义表
* module 注册表
* builtin 注册表

### 第 2 步：加载指定 profile.conf

得到：

* 使用哪些源
* 启用哪些模块
* 启用哪些 builtin
* policy override
* prepend/append 规则

### 第 3 步：拉取并解析节点

* 拉 URL 订阅
* 读本地文件
* 统一解析为节点对象
* 去重 / 重命名 / 过滤

### 第 4 步：按 selector 构建节点集合

例如：

* `hk` -> 匹配香港节点
* `us` -> 匹配美国节点
* `all` -> 全部节点

### 第 5 步：构建 proxy-groups

解析 `group = ...` 指令，生成最终组定义。

### 第 6 步：构建 rules

1. 按模块顺序加载 `.list`
2. 对每行规则补上目标 policy
3. 应用 `override_policy`
4. 加入 `prepend_rule`
5. 加入 builtin
6. 加入 `append_rule`
7. 确保 `FINAL/MATCH` 最后

### 第 7 步：渲染完整 YAML

这里是生成器内部输出，不需要在配置层暴露 YAML 结构给用户。

---

## 10. 错误处理建议

以下情况应报错并指出行号：

* 未知指令
* `group` 语法不合法
* `module` 路径不存在
* profile 引用了不存在的 `source`
* profile 引用了不存在的 `module`
* `override_policy` 指向未知模块
* `@selector_key` 未定义
* builtin 类型不支持

以下情况可仅 warning：

* selector 匹配不到节点
* group 最终成员为空
* 模块文件为空
* 规则重复

---

## 11. 兼容性策略建议

## 11.1 兼容旧 ACL4SSR 心智模型

虽然这是你自己的 DSL，但建议：

* 注释继续支持 `;`
* 保留 `ruleset -> policy` 的思想
* 保留高密度 `group` 行语法
* 保留 `GEOIP` / `FINAL` 的 builtin 概念

## 11.2 不必兼容旧关键字原样

内部不建议继续沿用：

* `ruleset=`
* `custom_proxy_group=`

建议统一改成更短的：

* `module =`
* `group =`

这样语义更清晰：

* `module` 是规则模块注册
* `group` 是代理组定义

---

## 12. 最小示例

## 12.1 base.conf

```ini
listen = 0.0.0.0:3000
mode = rule
allow_lan = true
log_level = info

source = airport_main,url,https://example.com/sub?token=xxxx,enabled=true,cache_ttl=1800

selector = all,.*
selector = hk,(港|HK|hk|Hong Kong|HongKong|hongkong)
selector = us,(美|US|United States)

group = 🚀 节点选择`select`[]♻️ 自动选择`[]🇭🇰 香港节点`[]🇺🇲 美国节点`[]DIRECT
group = ♻️ 自动选择`url-test`@all`http://www.gstatic.com/generate_204`300,,50
group = 🇭🇰 香港节点`url-test`@hk`http://www.gstatic.com/generate_204`300,,50
group = 🇺🇲 美国节点`url-test`@us`http://www.gstatic.com/generate_204`300,,150
group = 🐟 漏网之鱼`select`[]DIRECT`[]🚀 节点选择

module = apple,./rules/modules/Apple.list,🍎 苹果服务,80,true
module = openai,./rules/modules/OpenAi.list,💬 Ai平台,100,true

builtin = geoip_cn,GEOIP,CN,🎯 全球直连,9000,true
builtin = final,FINAL,,🐟 漏网之鱼,9999,true
```

## 12.2 profiles/default.conf

```ini
name = 默认完整配置
enabled = true

sources = airport_main
include_modules = apple,openai
exclude_modules =
include_builtins = geoip_cn,final

override_policy = apple,🚀 节点选择
prepend_rule = DOMAIN-SUFFIX,internal.example.com,DIRECT
```

---

## 13. 给 Codex 的实现要求

你可以直接把下面这段交给 Codex：

```md
请为 sub-provider 设计并实现一套类 ACL4SSR 风格的 INI/CONF 配置系统，不要引入 YAML 配置层。

目标：
- 使用高密度、行导向、声明式配置
- 保留 ACL4SSR 的使用习惯，但不要求 100% 兼容其原始关键字
- 规则正文继续使用 rules/modules/*.list
- 配置文件负责声明：
  - source
  - selector
  - group
  - module
  - builtin
  - profile

要求：
1. base.conf 负责全局配置、source、selector、group、module、builtin。
2. profiles/*.conf 负责具体输出 profile。
3. group 使用反引号分隔的 ACL4SSR-like 语法。
4. module 指向规则文件路径和默认策略组。
5. builtin 用于表达 GEOIP、FINAL 这类内置规则。
6. 生成器读取这些 conf 文件后，生成完整 Clash/Mihomo YAML。
7. 不要接数据库，不要做面板。
8. 解析器要能给出清晰的行号错误提示。
9. profile 支持 override_policy、prepend_rule、append_rule。
10. 先实现最小可用版本，再逐步扩展。
```

---

## 14. 最终结论

你现在最适合的路线，就是：

> **规则正文继续放 `.list`**
> **配置层改成类 ACL4SSR 风格的 `.conf`**
> **Python 写一个轻量 parser + generator**
> **最终输出完整 YAML**

这条路最顺，也最符合你现在的使用习惯。

[1]: https://github.com/tindy2013/subconverter/blob/master/base/config/ACL4SSR_NoMicrosoft.ini "subconverter/base/config/ACL4SSR_NoMicrosoft.ini at master · tindy2013/subconverter · GitHub"