```

feat(build): 添加可视化配置工具到构建流程

- 在 build.ps1 中新增步骤10，将配置工具从 resources/config-web/index.html
  复制到 output/config-web.html
- 在 release.yml 中添加兜底机制，确保配置工具正确进入输出目录
- 新增 docs/config-web.md 详细文档，说明配置工具的使用方式、
  配置结构覆盖范围、导入导出行为和实时校验规则
- 配置工具支持完整的配置字段编辑，包括元信息、核心配置和路由规则
```

Author: yuaotian

.github/workflows/release.yml

@@ -89,6 +89,18 @@ jobs:
         $zipName = "antigravity-proxy-${{ steps.prepare_version.outputs.release_tag }}-win-${{ matrix.arch }}.zip"
         $zipPath = Join-Path $env:RUNNER_TEMP $zipName
         if (Test-Path $zipPath) { Remove-Item -Force $zipPath }
+        
+        # 兜底：确保配置工具已进入 output（build.ps1 已复制，这里再校验一次避免遗漏）
+        $configWebSrc = Join-Path $env:GITHUB_WORKSPACE "resources\config-web\index.html"
+        $configWebDst = Join-Path $env:GITHUB_WORKSPACE "output\config-web.html"
+        if (Test-Path $configWebSrc) {
+          Copy-Item $configWebSrc -Destination $configWebDst -Force
+          Write-Host "已复制配置工具到 output: $configWebDst"
+        } else {
+          Write-Error "配置工具源文件不存在: $configWebSrc"
+          exit 1
+        }
+
         Compress-Archive -Path "output/*" -DestinationPath $zipPath -Force
         "zip_path=$zipPath" | Out-File -FilePath $env:GITHUB_OUTPUT -Append -Encoding utf8
 

build.ps1

@@ -499,6 +499,19 @@ $usagePath = Join-Path $OutputDir "使用说明.md"
 $usageDoc | Out-File -FilePath $usagePath -Encoding UTF8
 Write-Success "使用说明已生成: $usagePath"
 
+# ============================================================
+# 步骤 10: 复制配置工具
+# ============================================================
+
+Write-Step "复制配置工具..."
+$configWebSrc = Join-Path $PSScriptRoot "resources\config-web\index.html"
+if (Test-Path $configWebSrc) {
+    Copy-Item $configWebSrc -Destination (Join-Path $OutputDir "config-web.html") -Force
+    Write-Success "配置工具已复制到 output 目录"
+} else {
+    Write-Warning "配置工具源文件不存在: $configWebSrc"
+}
+
 # ============================================================
 # 完成
 # ============================================================

docs/config-web.md

@@ -0,0 +1,103 @@
+# Antigravity-Proxy 可视化配置工具（Config Web）
+
+## 文件位置与构建产物
+
+- **源码（开发态）**：`resources/config-web/index.html`
+- **构建输出（用户可直接打开）**：`output/config-web.html`
+  - 由 `build.ps1` 在生成 `使用说明.md` 后复制得到（见 `build.ps1` L502-L513）
+- **Release 资产**：Release workflow 打包的是 `output/*`，因此 zip 内会包含 `config-web.html`
+  - `.github/workflows/release.yml` 在 `Compress-Archive` 前做了兜底复制与校验（见 `.github/workflows/release.yml` L84-L105）
+
+## 使用方式（无需服务端）
+
+1. 直接用浏览器打开：
+   - 仓库内：`resources/config-web/index.html`
+   - 或构建后：`output/config-web.html`
+2. **导入**：拖拽或点击「导入」选择 `config.json`
+3. **编辑**：按左侧导航分组修改字段（支持数组增删与拖拽排序）
+4. **导出**：点击「导出」生成新的 `config.json`
+
+> 安全说明：全程仅在浏览器本地处理文件，不进行网络上传。
+
+## 配置结构覆盖范围（与后端解析一致）
+
+本工具覆盖后端实际读取的全部配置字段（见 `src/core/Config.hpp` 中 `Core::Config::Load()`），并额外包含 `build.ps1` 生成的元信息字段 `_comment/_version/_build`。
+
+### 顶层字段
+
+- **元信息（导出时写入）**
+  - `_comment`：说明字符串（`build.ps1` 会写入默认值，见 `build.ps1` L246-L253）
+  - `_version`：版本号（来自 `build.ps1` 的 `$Version`）
+  - `_build`：`{ date, config, arch }`（构建/导出时间与构建参数）
+- **核心配置**
+  - `log_level`：`debug/info/warn/error`
+  - `proxy`：`{ host, port, type }`
+  - `fake_ip`：`{ enabled, cidr }`
+  - `timeout`：`{ connect, send, recv }`（毫秒）
+  - `traffic_logging`：布尔
+  - `child_injection`：布尔
+  - `child_injection_mode`：`filtered/inherit`
+  - `child_injection_exclude`：字符串数组
+  - `target_processes`：字符串数组
+  - `proxy_rules`：
+    - `allowed_ports`：端口白名单数组（空数组=全部端口）
+    - `dns_mode`：`direct/proxy`
+    - `ipv6_mode`：`proxy/direct/block`
+    - `udp_mode`：`block/direct`
+    - `routing`：
+      - `enabled`
+      - `priority_mode`：`order/number`
+      - `default_action`：`proxy/direct`
+      - `use_default_private`
+      - `rules`：RoutingRule 数组
+
+### RoutingRule（`proxy_rules.routing.rules[]`）
+
+- `name`：规则名
+- `enabled`：是否启用
+- `action`：`proxy/direct`
+- `priority`：优先级（仅 `priority_mode=number` 时生效）
+- `ip_cidrs_v4`：IPv4 CIDR 字符串数组
+- `ip_cidrs_v6`：IPv6 CIDR 字符串数组
+- `domains`：域名模式数组（支持通配符、`.example.com` 语义）
+- `ports`：端口/端口范围字符串数组（如 `443` / `10000-20000`）
+- `protocols`：协议数组（当前主要使用 `tcp`）
+
+## 导入/导出行为
+
+- **导入**：读取 JSON → 归一化（枚举小写、缺省字段补齐、数值范围防御性回退）
+  - 对应实现：`resources/config-web/index.html` 中 `normalizeForm()`（见 L1314-L1428）
+- **导出**：以导入的原始 JSON 为底（保留未知字段），再“对象级覆盖”已知字段，最后 `JSON.stringify(..., null, 2)` 导出
+  - 对应实现：`exportObject()`（见 `resources/config-web/index.html` L1445-L1502）
+
+## 实时校验规则（前端）
+
+校验集中在 `validateAll()`（见 `resources/config-web/index.html` L1505-L1677），重点包括：
+
+- **端口**：
+  - `proxy.port`：允许 `0-65535`，其中 `0` 表示禁用代理（后端确有该语义）
+  - `proxy_rules.allowed_ports[]`：必须为 `1-65535` 且不能为 `0`
+  - `RoutingRule.ports[]`：支持 `80` 或 `10000-20000`，且端口必须 `1-65535`
+- **CIDR**：
+  - `fake_ip.cidr`：要求 IPv4 CIDR
+  - `RoutingRule.ip_cidrs_v4/ip_cidrs_v6`：分别校验 v4/v6 CIDR
+- **枚举值**：`log_level`、`proxy.type`、`child_injection_mode`、`dns_mode/ipv6_mode/udp_mode`、`priority_mode/default_action` 等
+
+## 构建/发布集成说明
+
+- `build.ps1`：新增 Step 10 复制配置工具到 `output/config-web.html`（`build.ps1` L502-L513）
+- `release.yml`：在打包前兜底复制并在缺失时失败（`.github/workflows/release.yml` L84-L105）
+
+## 已知限制/注意事项
+
+- **联网依赖**：Tailwind 与 Font Awesome 通过 CDN 加载；离线环境下 UI 可能无样式/无图标。
+- **剪贴板**：`file://` 场景下浏览器可能限制 `navigator.clipboard`，复制按钮失败会提示。
+
+## 维护建议（当 Config.hpp 变更时）
+
+当 `src/core/Config.hpp` 新增/调整字段时，优先同步以下 3 处以避免遗漏：
+
+1. `defaultForm()`：新增字段默认值
+2. `normalizeForm()`：导入归一化策略（小写/回退/类型修正）
+3. `validateAll()`：新增字段校验与错误提示
+