FirstCommit

2025-07-23 19:31:36 +08:00
commit 9838382619
16 changed files with 6836 additions and 0 deletions
--- a/README.md
+++ b/README.md
@@ -0,0 +1,189 @@
+# Clash Subscription Merger
+
+一个智能的 Clash 节点订阅合并工具，能够将多个 VPN 订阅链接合并为统一的配置文件，支持自动节点分类、流量信息提取和智能排序。
+
+## 功能特性
+
+- **多订阅源合并**: 支持合并多个 Base64 编码的 Clash 订阅链接
+- **智能节点过滤**: 自动过滤掉包含流量信息和到期时间的无效节点
+- **地区自动分类**: 根据节点名称自动归类到香港、新加坡、美国等地区
+- **流量信息提取**: 智能提取订阅中的流量信息并添加到组名中
+- **名称冲突处理**: 自动处理重复节点名称，使用 `_Num` 后缀
+- **智能排序**: 按平均每日剩余流量对订阅组进行排序
+- **文件自动替换**: 支持自动替换指定目标文件
+
+## 项目结构
+
+```
+clash-Subscribe/
+├── merger.py              # 主脚本，包含 ClashSubscriptionMerger 类
+├── demo.py               # 演示脚本，创建测试数据
+├── subscribe.json        # 订阅配置文件
+├── temp.yaml            # Clash 配置模板文件
+├── merge.yaml           # 最终输出的合并配置文件
+├── Replacement.txt      # 目标文件路径配置（可选）
+├── temp/                # 临时文件目录
+├── pyproject.toml       # Python 项目配置
+└── README.md           # 项目说明文档
+```
+
+## 安装与使用
+
+### 环境要求
+
+- Python 3.8+
+- uv 包管理器（推荐）
+
+### 安装依赖
+
+```bash
+# 使用 uv（推荐）
+uv sync
+
+# 或使用 pip
+pip install requests pyyaml
+```
+
+### 配置订阅
+
+编辑 `subscribe.json` 文件，添加你的订阅信息：
+
+```json
+[
+    {
+        "group_name": "订阅组名称",
+        "url": "https://your-subscription-url"
+    },
+    {
+        "group_name": "另一个订阅",
+        "url": "https://another-subscription-url"
+    }
+]
+```
+
+### 运行程序
+
+```bash
+python merger.py
+
+## 或者
+
+uv run merger.py
+
+```
+
+### 生成演示数据
+
+```bash
+python demo.py
+```
+
+## 配置说明
+
+### 地区分类规则
+
+程序会根据以下关键词自动分类节点：
+
+- **香港**: HKG, 🇭🇰, HongKong, Hong Kong, HK
+- **新加坡**: Singapore, 🇸🇬, SGP, SG  
+- **美国**: USA, 🇺🇸, United States, US, America
+
+### 节点过滤规则
+
+#### Proxy 节点过滤
+自动过滤包含以下关键词的节点：
+- `剩余流量`
+- `套餐到期`
+- `未到期`
+
+注意：保留包含 `距离下次重置剩余` 的节点。
+
+#### Proxy Groups 节点过滤
+过滤以下前缀开头的节点：
+- `Auto`
+- `剩余流量`
+- `套餐到期`
+- `未到期`
+
+### 流量信息提取
+
+程序支持提取以下格式的流量信息：
+- `剩余流量: XX.XX GB`
+- `流量: XX.XX GB`
+- `总流量: XX.XX GB`
+
+提取的流量信息会自动添加到订阅组名中，如：`TrustedAccessPath(183.54 GB)`
+
+### 智能排序
+
+新添加的订阅组会按照平均每日剩余流量（GB/天）进行降序排序，流量更多的组排在前面。
+
+## 高级功能
+
+### 自动文件替换
+
+创建 `Replacement.txt` 文件，输入目标文件的完整路径：
+
+```
+/path/to/your/clash/config.yaml
+```
+
+程序完成合并后会自动将 `merge.yaml` 的内容替换到指定文件中。
+
+### 模板文件自定义
+
+`temp.yaml` 文件包含基础的 Clash 配置：
+- 网络设置（端口 7890，DNS 配置）
+- 地区代理组（Auto-香港，Auto-新加坡，Auto-USA）
+- 路由规则（中国域名、国际域名）
+- 广告屏蔽规则
+
+## 工作流程
+
+1. **加载配置**: 从 `subscribe.json` 读取订阅信息
+2. **获取订阅**: 下载并解码 Base64 订阅内容
+3. **保存临时文件**: 将订阅内容保存到 `temp/` 目录
+4. **处理节点**: 提取代理节点并应用过滤规则
+5. **提取流量信息**: 使用正则表达式提取流量和天数信息
+6. **地区分类**: 根据节点名称自动分类到对应地区
+7. **名称去重**: 处理重复节点名称冲突
+8. **智能排序**: 按平均每日流量对订阅组排序
+9. **生成配置**: 使用模板合并所有数据生成 `merge.yaml`
+10. **文件替换**: 可选地替换指定的目标文件
+
+## 输出示例
+
+```
+开始处理Clash订阅合并...
+正在处理订阅: TrustedAccessPath
+已保存临时文件: temp/TrustedAccessPath.yaml
+处理文件: temp/TrustedAccessPath.yaml
+提取到流量信息: TrustedAccessPath -> 183.54 GB
+提取到剩余天数: TrustedAccessPath -> 25天
+平均每天剩余流量: TrustedAccessPath -> 7.34GB/天
+更新组名: TrustedAccessPath -> TrustedAccessPath(183.54 GB)
+
+合并完成!
+总共合并了 156 个节点
+香港节点: 45 个
+新加坡节点: 38 个
+美国节点: 42 个
+其他节点组: 3 个
+```
+
+## 注意事项
+
+- 程序会自动创建 `temp/` 目录存储临时文件
+- 如果临时文件已存在，程序会跳过重新下载
+- 建议定期清理 `temp/` 目录中的过期文件
+- 请确保订阅 URL 的有效性和访问权限
+- 生成的 `merge.yaml` 文件可直接用于 Clash 客户端
+
+## 依赖项
+
+- `requests>=2.31.0` - HTTP 请求库
+- `pyyaml>=6.0.1` - YAML 文件处理库
+
+## 许可证
+
+本项目采用开源许可证，具体详情请查看项目仓库。