先判断订阅链接返回的内容
在 Stash for Android 里添加订阅，最常见的卡点不是网络，而是格式。手里是一串链接，应用却读不出策略组或直接报错，问题往往出在“链接”到“YAML 配置”之间少了一步整理。本文围绕 stash 订阅转换，讲清格式确认、链接整理与导入前检查的完整流程，同时把订阅地址确认、格式判断、导入失败排查以及订阅转换的风险边界一并说明，帮助你在导入之前就把可能出现的问题挡在门外。
先说明前提：Stash for Android 是 Stash 的 Android 抢先体验版本，仍在持续开发中。以下内容是导入前的通用整理思路，不涉及具体版本差异。也正因为处于持续开发阶段，准备阶段多确认一步、多留一份副本，往往比导入后再反复试错更省时间。
为什么链接不能直接导入
Stash 支持策略组和订阅来源，但支持订阅不等于任何链接都能原样读取。机场给出的地址通常指向服务端生成的配置，其中包含节点、策略组、规则集。不同客户端对字段命名和策略组写法要求不同，而 Stash 读取的是 YAML 配置，Android 版可读取与 macOS、iOS 版相同的 YAML 配置。
所以真正进入 Stash 的，应该是一份结构清晰的 YAML。转换的意义不是改节点，而是让配置的组织方式符合 Stash 的读取习惯。这也是“订阅转换stash”成为常见需求的原因。换句话说，转换处理的是结构层面的整理：把代理条目、策略组、规则放在正确的位置，用统一的键名和缩进组织起来，让 Stash 能按自己的读取习惯理解这份配置。节点本身、线路情况并不因为转换而改变，转换也不会替你把不可用的地址变成可用的地址。
理解这一点之后，很多导入失败就有了排查方向：报错未必说明链接彻底无效，也可能是链接返回的内容根本不是配置文本，或者配置文本的结构不符合 Stash 的读取要求。先分清是“地址问题”还是“格式问题”，再去处理，比盲目更换链接更有效。
先确认：stash 订阅格式要看哪几处
动手转换之前，先判断手上是什么，能省掉大量试错。格式判断的核心，是确认你拿到的到底是一份可被读取的配置，还是一段看起来像链接、实际指向别处的内容。
- 确认链接返回的是配置文本，不是网页。用浏览器打开订阅地址，看到完整 YAML 文本（键值对加缩进）说明接近配置；看到登录页、错误页或乱码，说明链接失效或缺少参数。
- 确认代理写法规范。Stash 支持代理协议，条目要按对应协议的字段要求书写，缺字段或拼写不一致都会读取失败。
- 确认策略组被引用。Stash 支持按规则路由、重定向或拦截连接，规则与策略组互相引用；定义了却没被规则使用，界面上就可能看不到效果。
- 确认规则来源可达。规则集若指向外部地址，导入时能否拉取会影响结果。
- 确认没有混入无关片段。多份配置直接拼接容易产生重复键名，这是转换中最隐蔽的错误。
这五处确认可以按顺序进行，也可以先看最可疑的一项。实践中，第 1 条是最先要做的：如果链接打开后根本不是配置文本，后面的字段确认就无从谈起。第 5 条则最容易被忽略，因为拼接后的文件表面上看仍然是一份 YAML，只有在读取到重复键名或结构错位时才会暴露问题。
字段拿不准时，以官方文档为准。文档资料列出入门、规则类型、代理协议和配置文件示例等资料。与其凭印象猜某个字段该怎么写，不如回到文档里对照，尤其是代理协议部分，字段缺漏和拼写不一致都可能导致读取失败。
订阅地址确认：把问题挡在转换之前
在进入转换步骤之前，建议单独花一点时间确认订阅地址本身。很多导入失败并不是格式写错了，而是地址在复制、转发或保存的过程中已经变了样，只是错误要到导入阶段才显现出来。
确认订阅地址时，可以按下面几点逐项确认：
确认地址来源。以机场或服务方给出的原始地址为准，不要使用经过多次转发的版本。转发过程中可能被截断、被附加多余字符，也可能被替换成指向其他位置的地址。
确认地址完整。整段复制，不要手动输入，也不要只复制其中一部分。链接较长时，漏掉结尾的字符往往不会在复制时被发现，却会让请求直接失败。
确认地址类型。区分订阅地址与订阅页面：有些页面是给人看的说明页，真正的配置地址要另行获取。把页面地址当成订阅地址去转换，得到的自然不是配置文本。
确认地址数量与对应关系。一条链接对应一份配置。多条地址拼接成一条不可控，分别转换再合并内容更稳妥。
确认地址仍然有效。服务方可能调整内容或更换地址，本地保存的旧地址不会自动同步。定期回看原始来源，比在导入失败后反复猜测更可靠。
把地址确认放在转换之前，好处是排查时能把变量分开：地址确认无误，问题就集中在格式上；地址本身存疑，就先解决地址，不要急着改配置结构。
订阅链接转换的实操顺序
stash 订阅链接转换建议按下面的顺序推进，每一步都可回退、可确认。
- 保存原始链接。单独记录机场给的地址，不要在原件上反复拼参数，改坏了无法还原。
- 获取配置内容。通过转换工具或自行整理，得到完整 YAML 文本；可只保留代理与策略组，规则按需补充。
- 检查顶层结构。代理列表、策略组、规则三段齐全，键名统一，缩进用空格而非制表符。
- 处理策略组命名。组名要能被规则引用，改名后同步修改规则中的引用，否则会指向不存在的策略组。
- 本地留副本。转换结果存成文件，原始链接与转换结果两份都保留，方便对照排查。
- 导入后观察结果。先看策略组是否完整，再看规则是否按预期分流；某段缺失就回到第 3、4 步。
这个顺序的关键在于“可回退”。第 1 步保留原始链接，第 5 步保留转换结果，两者合起来构成排查时的参照：导入结果不对，可以先拿转换结果与原始链接对照，判断是转换环节丢了内容，还是原始地址返回的内容本身就不完整。第 3、4 步则是结构层面的检查点，顶层结构不齐或策略组命名与引用不一致，都会在导入后表现为策略组缺失或规则不生效。
转换工具只负责结构整理。节点质量与线路情况不在本文讨论范围，也不建议从非官方来源途径获取所谓免费资源，这类来源无法确认，还可能带来安全与合规风险。转换工具的选择同样应遵守这条原则：优先使用来源可确认、说明清楚的处理方式，不要把配置内容交给来路不明的服务。
格式判断：怎样算“接近可导入”
格式判断不必等到导入后才做，在本地看一遍文本就能筛掉大部分问题。判断时可以关注几个直观特征：
看整体形态。完整的 YAML 以键值对加缩进组织，层级靠空格体现；如果打开后是一整段没有换行的字符，或者夹杂大量网页标签，基本可以判断不是配置文本。
看缩进方式。缩进应使用空格，制表符在不同环境下表现不一致，容易造成层级错乱。
看键名是否统一。同一类条目应使用一致的键名写法，拼写不一致会让读取方把它们当成不同的字段。
看段落是否齐全。代理列表、策略组、规则三段是否都在，缺失哪一段，导入后就可能缺哪一部分。
看有无重复与拼接痕迹。多份配置直接拼接容易产生重复键名，这是转换中最隐蔽的错误，需要逐段检查而不是只看开头。
需要强调的是，以上判断只能说明“形态上接近可导入”，并不保证导入一定成功。规则的拉取、策略组引用的完整性等，仍要在导入后观察。格式判断的价值在于把明显不合格的内容提前排除，减少无效的导入尝试。
导入失败排查：按层次定位问题
导入失败时，最忌讳的是同时改动多个地方。建议按“地址—格式—引用—环境”的层次逐项排查，每次只改一处，改完再试。
- 先查地址。回到订阅地址确认环节，确认地址完整、类型正确、仍然有效。如果浏览器打开地址得到的不是配置文本，先解决地址问题，不要动配置结构。
- 再查格式。确认是完整 YAML、缩进用空格、键名统一、三段齐全。若转换结果与原始内容对不上，回到转换步骤重新整理。
- 三查引用。策略组名称与规则中的引用是否一致，规则集指向的外部地址是否可达。改名后没有同步修改引用，是常见且不易察觉的失败原因。
- 四查拼接。是否存在重复键名或无关片段混入，尤其是由多份配置合并而来的内容。
- 最后查环境。确认系统版本、设备类型与获取来源途径符合要求，排除与配置无关的安装层面问题。
按这个顺序排查的好处是，每一步都有明确的判断依据，不需要靠反复重装来碰运气。若某一步确认无误，就把该步排除，继续往下走，避免在同一处反复修改却找不到真正原因。
地址整理：把易错的细节提前处理
导入失败未必是格式问题，很多是地址在复制或转发中被改动。
整段复制，不要截断。链接较长，手动输入极易漏字符。
注意大小写与特殊符号。参数名和值区分大小写，多余的引号或空格都会让请求失败。
区分订阅地址与订阅页面。有些页面是给人看的，真正的配置地址要另行获取。
一条链接对应一份配置。多条地址拼接成一条不可控，分别转换再合并内容更稳妥。
定期回看原始来源。服务方可能调整内容，本地副本不会自动同步。
这些细节单独看都很小，但每一条都足以让导入失败，而且失败时的表现往往相似，难以一眼分辨。把地址整理当成转换流程的固定一环，而不是可选项，能显著减少来回试错。
订阅转换的风险边界
订阅转换本身只是结构整理，但它处在“地址”和“配置内容”之间，因此有几条边界需要提前说清。
第一，转换不改变内容来源。转换工具处理的是你提供的链接或文本，它不会让不可确认的来源变得可确认。来源不明的订阅地址，转换之后依然是来源不明。
第二，不要把敏感内容交给不可信的服务。订阅地址可能带有凭据或参数，把地址提交给来路不明的在线转换服务，等于把这份信息交给第三方。选择处理方式时，应优先考虑来源可确认、处理过程可预期的途径。
第三，转换结果要能追溯。保留原始链接与转换结果两份副本，出现问题时才能判断是原件有误还是整理过程出错。没有副本，排查就只能靠猜。
第四，不要为省事去搜来路不明版本、未经查验版本节点或来路不明的转换服务。来路不明版本本无法确认签名与来源，公开线路往往意味着流量经过不可控的第三方。订阅转换应在可确认来源的工具与文档指导下完成，下载以官方来源途径为准，涉及授权与计费以 Google Play 页面说明为准，版本相关信息以 Release 页为准。
导入前的检查清单
- 系统版本。Stash for Android 支持 Android 7.0 及以上系统，低于该版本无法安装。
- 设备类型。当前版本面向移动设备，不支持 Android TV，电视端不要按手机流程准备。
- 获取来源途径。Android 版本通过 Google Play 分发，官方未提供独立 APK；市面上可能有多个自称官网的页面或同名应用，请确认开发者、包名/签名与官方页面，下载以官方来源途径为准。
- 授权对应平台。macOS 或 iOS 的授权不能直接用于 Android，Android 版通过 Google Play 计费。
- 配置冲突。从其他平台迁移来的 YAML 配置要先按本文顺序确认，不要直接套用。
另外，kexuezj 页面将项目标签标为 Android 与源码未公开，这提醒我们：下载时更要认准官方来源途径，不要被名称相近的页面误导。检查清单的作用是把与配置无关的变量先固定下来，这样导入失败时才能把注意力集中在地址与格式上。
常见疑问与风险提示
策略组是空的怎么办？ 先看策略组有没有被规则引用，再查代理条目字段是否完整；两者都正常，就回看转换工具是否保留了策略组段落。
能直接用别人分享的配置吗？ 可以当结构参考，但其中的地址、凭据、规则来源都要自行确认，直接导入容易引入无法追溯的内容。
找不到视频教程是不是操作错了？ kexuezj 教程页显示当前暂无已发布的视频教程，缺少视频不代表流程有误，按官方文档的入门与配置文件示例逐步确认即可。
导入报错但看不出原因怎么办？ 按“地址—格式—引用—环境”的层次逐项排查，每次只改一处。先确认链接返回的是配置文本，再确认顶层结构与策略组引用，最后排除安装层面的因素。
风险方面，不要为省事去搜来路不明版本、未经查验版本节点或来路不明的转换服务。来路不明版本本无法确认签名与来源，公开线路往往意味着流量经过不可控的第三方。订阅转换应在可确认来源的工具与文档指导下完成，下载以官方来源途径为准，涉及授权与计费以 Google Play 页面说明为准，版本相关信息以 Release 页为准。
把格式看明白，把地址理清楚，Stash 订阅转换本身并不复杂。准备阶段多确认一步，导入阶段就少一次返工。
导入后检查订阅结果
订阅转换服务返回内容后，先用文本编辑器查看首行和文件编码，再把结果保存到本地副本。若响应是网页提示而不是 YAML，应用自然无法识别；若文本能打开但代理组为空，则继续检查转换参数与字段映射。把原始地址、转换结果和报错时间分开记录，可以避免多次重试覆盖证据。
订阅转换完成后，先看配置能否被读取，再看策略组是否出现，最后检查规则是否按预期分流。不要把“链接能打开”直接等同于“Stash 能使用”；地址可能返回了不匹配的格式，也可能只包含部分内容。若导入失败，记录错误提示和使用的来源，重新确认订阅地址、转换格式以及 YAML 层级，再回到官方文档查找对应规则。
订阅来源和转换服务都应当能说明开发者、包名或签名以及官方页面。市面上可能存在多个同名页面，下载以官方来源途径为准，配置也应优先使用可追溯的来源。Stash 支持策略组与机场订阅，但订阅服务本身的条款、授权和隐私说明仍需单独确认。处理完一个变量后再进行下一步，才能知道问题究竟来自地址、格式还是规则。