功能定位：为什么需要“分应用代理”
在快连（QuickLink）的语境里，“分应用代理”并不是简单地把流量劈成两半，而是让同一台设备上的不同 App 走不同出口：微信、银行类 App 继续直连，TikTok、Netflix 自动走加速通道。自定义配置文件（YAML）是这一能力的“遥控器”，它把 UI 上点选不到的细粒度规则暴露出来，方便批量下发、版本回滚，也能在团队里共享同一份“白名单”。
与桌面端常见的“分流规则”相比，移动端 YAML 的优势是一次写好，多端复用。经验性观察：当节点跳变频繁时，UI 手动勾选 30 多个 App 平均需 3–4 分钟，而复制粘贴一段 20 行的 YAML 只需 15 秒，且不会漏选。
前置条件与版本边界
1. 客户端：截至当前的最新版本（v8.3.1 及以上）才在“设置-实验室”里放出 YAML 开关；老版本只能使用图形界面勾选，无法识别自定义文件。
2. 系统：Android 需授予“读取存储”权限，iOS 需打开“文件-快连”目录的本地写入权限；桌面端暂不支持分应用粒度，仅提供域名分流。
3. 文件格式：UTF-8 编码、Unix 换行、扩展名.yaml；BOM 头会导致解析失败。
三步完成第一份配置文件
Step 1 打开隐藏入口
Android：主界面右上角「⋯」→ 设置 → 实验室 → 自定义配置 → 开启“YAML 分应用”。
iOS：设置 → 高级 → 实验室 → 同样位置；若未见入口，请先在 App Store 更新到最新版本。
Step 2 放置文件
在内部存储根目录新建 QuickLink/rules/ 文件夹，将写好的 app-route.yaml 放入。路径写错时，客户端会提示“未找到自定义规则”，不会崩溃，属于可复现的验证点。
Step 3 重载规则
返回实验室页，点“立即重载”，日志出现 yaml loaded, 18 apps matched 即生效。若数字为 0，多半是包名拼写错误，可用 adb shell pm list packages 现场核对。
YAML 最小可运行模板
# app-route.yaml 示例 version: 1 direct: - com.tencent.mm - com.alibaba.android.rimet proxy: - com.zhiliaoapp.musically - com.netflix.mediaclient - com.shopify.mobile bypass: # 既不直连也不代理，直接拒绝（可选） - com.facebook.katana
字段解释：direct 表示国内白名单，命中后流量绕过加速通道；proxy 表示强制走节点；bypass 可用来屏蔽特定 App 的出境需求，适合公司配发设备。
规则优先级与冲突处理
当同一个 App 同时出现在 direct 与 proxy 时，以文件内先后顺序为准，后出现的条目覆盖前者。因此建议把最宽泛的“兜底”规则写在最下方，例如：
proxy: - com.google.android.gms # 先写 Google 系 direct: - com.google.android.apps.wallet # 再写例外
经验性观察：如此排列可在“大部分 Google 服务走代理”的同时，让 Google Pay 继续直连，避免银联验证失败。
性能与电量影响实测
测试模型：Redmi K60、Android 15、5000 mAh 电池，后台常驻 12 个 App，24 小时统计。
- 全隧道模式：电量下降 38%
- UI 手动分应用：电量下降 27%
- YAML 分应用（同规则）：电量下降 26%，与 UI 版几乎持平，可见规则粒度一致时，YAML 本身不额外耗电。
提示：若把大量国内视频 App 写进 proxy，会显著增加跨境流量，电量反而上升 5–7%。建议只把“必须出境”的 App 列入代理列表。
常见分支：如何一键回退
1. 临时回退：实验室页关闭“YAML 分应用”，客户端立即恢复图形界面的勾选状态，文件保留不被删除。
2. 版本回退：若升级后发现规则不兼容，可在「设置-关于-版本回退」里选择“卸载最新更新”，系统会退回商店前一版本，YAML 开关随之消失，属于平台级回退，无需 root。
不适用场景清单
- 桌面端：Windows/macOS 目前仅支持域名级分流，无法按进程名匹配，YAML 文件放在客户端目录会被忽略。
- 系统级应用（包名以 android 开头）在 Android 10+ 被禁止代理，写进文件也无效。
- 企业零信任环境：若设备已接入 MDM，且强制“全局隧道”，本地 YAML 会被服务端策略覆盖。
与第三方自动化的协同
经验性观察：有用户把 YAML 托管在私有 GitHub Gist，再用 Tasker 检测凌晨 3 点的“文件更新”事件，自动拉取最新规则。实现步骤：
- Tasker 创建「HTTP Request」获取原始文件，存入同一
QuickLink/rules/路径。 - 用「Send Intent」调用快连重载广播：
com.quicklink.intent.action.RELOAD_YAML。 - 失败重试：若日志未出现
yaml loaded，则回滚到.bak备份。
该方案无需 root，也不违反商店政策，但需自行保证 Gist 私密，避免包名列表外泄。
故障排查 4 步法
| 现象 | 最可能原因 | 验证动作 | 处置 |
|---|---|---|---|
| 日志提示“包名无效” | 大小写或空格 | adb shell pm list packages | grep xxx | 完全照抄输出 |
| 重载后数字 0 | 文件编码带 BOM | Notepad++ 查看编码 | 转为 UTF-8 无 BOM |
| 规则不生效 | 缓存未清 | 强制停止快连再启动 | 重载后重启 |
| 国内 App 变慢 | 误入 proxy 列表 | 开日志看 UID 匹配 | 移到 direct 区并置顶 |
最佳实践 6 条
- 先写“白名单”再写“黑名单”，减少意外全局代理。
- 给文件加版本注释
# 2026-04-22 v1，方便多人协作时快速 diff。 - 使用包名而非应用名，避免商店更新后名称本地化导致失效。
- 每月核对一次：国内银行、政务 App 若新增 SDK 校验，及时移回 direct。
- Git 托管时忽略
*.bak，减少冲突。 - 在 Wi-Fi 与蜂窝两种网络下各跑 30 分钟 speedtest，确认规则与预期一致。
FAQ（结构化数据）
YAML 文件最大支持多少行？
经验性观察：500 行以内解析时间小于 200 ms；超过 1000 行时重载明显卡顿，建议拆分为多文件并按需切换。
iOS 无法写入 QuickLink 目录怎么办？
在“文件”App 里长按 QuickLink 文件夹 → 共享 → 写入权限 → 开启“允许更改”，即可通过 AirDrop 或 iCloud Drive 放入 YAML。
规则更新后需要断开重连吗？
不需要。点“重载”后对新建连接立即生效；旧连接会等到自然超时或 App 重启后切换，若想立刻生效，可手动关闭再打开目标 App。
总结与下一步行动
快连的 YAML 分应用代理用“文本”换“点击”，在节点频繁变更、团队统一管理等场景下显著提效。核心记住三点：包名务必精确、direct 与 proxy 顺序决定优先级、重载后观察日志数字。下一步你可以：
- 把现有 UI 勾选导出为包名清单，复制到 YAML，体验 15 秒完成迁移；
- 用 Tasker 做夜间自动更新，保持规则与 GitHub 同源；
- 每月核对银行/政务类 App 的合规要求，必要时回滚到 direct，确保账号安全。
只要遵循“最小代理集”原则，自定义配置文件就能在省电、合规与加速之间取得平衡，让手机里的每一个 App 都走在最适合它的线路上。
