feat: compatible old singbox protocol, optimize the format of source config

Author: messica

README.md

@@ -6,7 +6,7 @@ A modern, extensible proxy configuration conversion tool supporting conversion a
 
 - **Multi-protocol support**: Supports Clash, Sing-box, V2Ray and other proxy configuration formats
 - **Multi-source integration**: Supports integration of multiple input sources with unified interpolation rules ✨
-- **Unified input rules**: Single source and multiple sources use the same `--source` parameter format ✨
+- **URL-style source**: Source uses standard URL form `<path|url>?type=...&name=...&flag=...` for easy extension ✨
 - **Powerful interpolation system**: Advanced template interpolation rules for complex node selection and filtering ✨
 - **Plugin architecture**: Easy to extend new protocol support
 - **Modern CLI**: User-friendly command line interface based on clap 4.x
@@ -37,16 +37,12 @@ cargo install --git https://github.com/your-username/proxy-convert.git
 ### Basic Usage
 
 ```bash
-# Single source
-proxy-convert convert \
-  --source "clash1@clash@./clash.yaml"
+# Recommended: URL-style (path/url + query params)
+proxy-convert convert --source "./clash.yaml?type=clash"
+proxy-convert convert --source "https://example.com/sub?type=clash&name=my&flag=clash" -o config.json
 
-# Multiple sources
-proxy-convert convert \
-  --source "clash1@clash@./clash.yaml" \
-  --source "singbox1@sing-box@./singbox.json" \
-  --template template.json \
-  --output config.json
+# Legacy: name@type@source or type@source
+proxy-convert convert --source "clash1@clash@./clash.yaml" --source "singbox1@sing-box@./singbox.json" -o config.json
 
 # Validate config file
 proxy-convert validate config.json
@@ -66,26 +62,23 @@ proxy-convert version
 
 This ensures consistent user experience regardless of whether you use a single input source or multiple input sources.
 
-### Source Format
+### Source Format (standard URL-style)
 
-```conf
-name@type@source
+```text
+<path|url>?type=clash&name=...&flag=...
 ```
 
-- `name`: Source name, used for template reference
-- `type`: Subscription type (clash/sing-box/v2ray/auto)
-- `source`: File path or URL
+- Path or URL + `?` and query params (standard URL): `type` (required), `name` (optional), `flag` (optional).
+- Examples: `./config.yaml?type=clash`, `https://example.com/sub?type=clash&name=my&flag=clash`
+- Config file `sources` use the same format (list of such strings).
 
 ### Examples
 
 ```bash
-# File sources
---source "clash1@clash@./clash.yaml"
---source "singbox1@sing-box@./singbox.json"
-
-# URL sources
---source "sub1@clash@https://example.com/sub"
---source "v2ray1@v2ray@https://example.com/v2ray.txt"
+--source "./clash.yaml?type=clash"
+--source "https://example.com/sub?type=clash&name=my&flag=clash"
+--source "examples/sources/Eternal Network?type=singbox"
+# With config: --config examples/config.yaml -o config.json
 ```
 
 ## 📋 Interpolation Rules System
@@ -224,10 +217,7 @@ proxy-convert convert [OPTIONS] --source <SOURCE> [--source <SOURCE>...]
 
 **Arguments:**
 
-- `--source <SOURCE>`: Input source in format `name@type@source`
-  - `name`: Source name, used for template reference
-  - `type`: Subscription type (clash/sing-box/v2ray/auto)
-  - `source`: File path or URL
+- `--source <SOURCE>`: Input source: `<path|url>?type=...&name=...&flag=...` (type required in query)
 
 **Options:**
 
@@ -291,6 +281,10 @@ output_format: json
 default_input_format: clash
 default_output_format: singbox
 template_dir: ~/.config/proxy-convert/templates
+# sources: same format as --source, e.g. ["path?type=clash&name=my"]
+# sources:
+#   - "./clash.yaml?type=clash&name=clash1"
+#   - "https://example.com/sub?type=singbox&name=sub1"
 ```
 
 ### Environment Variables
@@ -341,7 +335,7 @@ The project supports multi-source integration with unified interpolation rules:
 
 #### 1. Input Source Management
 
-- **Unified format**: All sources use `name@type@source` format
+- **Source format**: `<path|url>?type=...&name=...&flag=...` (same for CLI and config)
 - **Type detection**: Automatic detection of clash, sing-box, v2ray formats
 - **Source naming**: Each source has a unique name for template reference
 

README.zh-CN.md

@@ -58,28 +58,26 @@ cargo install --git https://github.com/your-username/proxy-convert.git
   ```
 
   **选项：**
-  - `--source <SOURCE>`：输入来源，格式：`name@type@source`
+  - `--source <SOURCE>`：输入来源，见下方「来源格式说明」
   - `-t, --template <TEMPLATE>`：模板文件路径
   - `-o, --output <OUTPUT>`：输出文件路径（默认：config.json）
   - `-f, --format <FORMAT>`：输出格式（json/pretty/yaml，默认：pretty）
   - `-F, --force`：强制覆盖输出文件
   - `-l, --log-level <LOG_LEVEL>`：日志级别（默认：info）
   - `-v, --verbose`：显示详细信息
 
-  - 来源格式说明
+  - **来源格式说明**（标准 URL 规范，命令行与配置文件一致）
 
-    ```bash
-    name@type@source
+    ```text
+    <path|url>?type=clash&name=...&flag=...
     ```
 
-    - `name`：来源名称，用于模板引用（可选，见下方说明）
-    - `type`：订阅类型（clash/sing-box/v2ray/auto）
-    - `source`：文件路径或URL
-
-    **重要说明：**
-    - 如果只有一个来源，可以省略 `name`，直接使用 `type@source` 格式
-    - 当省略 `name` 时，生成的节点标签不会添加来源前缀
-    - 多个来源时必须指定 `name` 以区分不同来源
+    - path 或 url 后加 `?` 与查询参数（与标准 URL 一致）：
+      - `type`：**必填**，订阅类型（clash / sing-box / v2ray）
+      - `name`：可选，来源名称，用于模板引用
+      - `flag`：可选，请求 URL 时的 flag 参数（空表示 `&flag=`）
+    - 示例：`./config.yaml?type=clash`、`https://example.com/sub?type=clash&name=my&flag=clash`、`examples/sources/Eternal Network?type=singbox`
+    - 配置文件 `sources` 也使用相同格式的字符串列表（见下方配置示例）。
 
 - **验证配置文件**：验证配置文件的格式和内容正确性
 
@@ -102,25 +100,22 @@ cargo install --git https://github.com/your-username/proxy-convert.git
 #### 使用示例
 
 ```bash
-# 单个来源（省略 name）
-proxy-convert convert \
-  --source "clash@./clash.yaml"
+# 单源
+proxy-convert convert --source "./clash.yaml?type=clash"
 
-# 单个来源（指定 name）
+# 多源（可带 name、flag）
 proxy-convert convert \
-  --source "clash1@clash@./clash.yaml"
+  --source "https://example.com/sub?type=clash&name=my&flag=clash" \
+  --source "examples/sources/Eternal Network?type=singbox" \
+  -o config.json
 
-# 多个来源（必须指定 name）
-proxy-convert convert \
-  --source "clash1@clash@./clash.yaml" \
-  --source "singbox1@sing-box@./singbox.json" \
-  --template template.json \
-  --output config.json
+# 使用配置文件（sources 格式与 --source 一致）
+proxy-convert convert --config examples/config.yaml -o config.json
 
 # 其他命令
-proxy-convert validate config.json          # 验证配置文件
-proxy-convert template singbox --output template.json  # 生成模板
-proxy-convert version                      # 显示版本信息
+proxy-convert validate config.json
+proxy-convert template singbox --output template.json
+proxy-convert version
 ```
 
 ## 📋 插值规则系统 ✨
@@ -242,7 +237,7 @@ proxy-convert version                      # 显示版本信息
 **单个来源的情况：**
 
 - 如果只有一个来源且没有指定 `name`，节点标签保持原样
-- 例如：`--source "clash@./clash.yaml"` 时，节点标签不会添加前缀
+- 例如：单源且未指定 `name`（如 `--source "./clash.yaml?type=clash"`）时，节点标签不会添加前缀
 
 **标签前缀的作用：**
 
@@ -322,14 +317,10 @@ output: config.json
 # 模板目录
 template_dir: ~/.config/proxy-convert/templates
 
-# 来源配置（可选，也可以通过命令行参数指定）
-source:
-  - name: clash1
-    type: clash
-    path_or_url: ./clash.yaml
-  - name: singbox1
-    type: sing-box
-    path_or_url: ./singbox.json
+# 来源配置（可选，与 --source 格式一致：<path|url>?type=...&name=...&flag=...）
+sources:
+  - "./clash.yaml?type=clash&name=clash1"
+  - "./singbox.json?type=singbox&name=singbox1"
 ```
 
 **配置项说明：**
@@ -344,7 +335,7 @@ source:
 - `output_format`：输出格式（json/pretty/yaml）
 - `output`：默认输出文件路径
 - `template_dir`：模板文件目录
-- `source`：预定义的来源列表
+- `sources`：预定义的来源列表（每项为 URL 格式字符串，与命令行 `--source` 一致）
 
 ### 环境变量
 
@@ -423,7 +414,7 @@ src/
 
 #### 1. 输入源管理
 
-- **统一格式**：所有来源使用 `name@type@source` 格式
+- **来源格式**：统一使用 URL 形式 `<path|url>?type=...&name=...&flag=...`（命令行与配置文件一致）
 - **类型检测**：自动检测 clash、sing-box、v2ray 格式
 - **来源命名**：每个来源都有唯一名称用于模板引用
 

src/commands/cli.rs

@@ -24,9 +24,7 @@ pub struct Cli {
 pub enum Commands {
     /// Convert subscription configuration
     Convert {
-        /// Input sources in format: source-name@source-type@<path|url>
-        /// Single source: --source "clash1@clash@./clash.yaml"
-        /// Multiple sources: --source "clash1@clash@./clash.yaml" --source "sub1@sing-box@https://example.com/sub"
+        /// Input sources: <path|url>?type=clash&name=...&flag=... (type required in query)
         #[arg(long = "source", value_name = "SOURCE")]
         sources: Vec<String>,