Sub2API STATE Kit 插件

本仓库维护 Sub2API v0.2.7 的独立 .s2plugin 插件，不覆盖宿主源码。4.2.1 简化了配置页，并缩短票据续期链路。

先选择“运行方式”，页面只要求填写当前方式需要的链路字段：

第一层“IP 管理代理”两种方式共用，始终显示。它用于访问代理生成器 API；Cookie 分流的业务固定代理留空时，也作为业务出口。

1. 运行方式选择“稳定同出口”。
2. 第一层选择可访问生成器的代理。
3. 填写代理生成器 API。
4. 账号出口方式选择“代理生成器”。
5. 建议开启“优先使用上一轮出票 IP”和“提前准备备用票”。
6. 保存后等待状态变为“可用”，再用实际模型请求验收。

推荐参数：

1. 运行方式选择“Cookie 分流”。
2. 第一层保持和稳定模式相同的选择。
3. 打票方式选择“代理生成器 API”或“S5/HTTP 固定采集代理”。
4. 选择代理生成器时，Cookie 采集代理留空。
5. 业务固定代理留空则使用第一层，也可以填写独立出口。
6. 保存后先用实际模型请求确认跨出口仍返回目标模型。

推荐参数：

插件不会把刚返回的 STATE 直接投入业务。一次成功获取必须依次完成：

1. 获取或复用生成出口，并检查出口地区。
2. 发起打票请求，确认 STATE 长度和实际模型。
3. 在业务出口上携带该 STATE 再复验一次。
4. 复验通过并保存成功后，才替换当前可用票据。

因此多出的是“同出口复验”，不是无效查票。续期或备用票获取期间，当前仍可用的旧票继续服务。

• 将出口 IP 与地区检查合并为一次请求。
• 同一出口的复验只复核 IP 是否变化，不再重复查询地区。
• 地区被拦截、312、STATE 长度不符或复验失败时缩短重试等待。
• 旧模式也可提前准备备用票，优先复用当前正在工作的生成出口，失败后自动换新出口。
• 诊断耗时现在覆盖代理生成、出口检查和探测，便于继续调整提前量。

这些优化不降低复验标准，也不承诺固定获得 292。上游生命周期、出口质量和账号状态仍会决定最终成功率。

注册入口：B2Proxy

生成器地址保留：

proto=http&stype=txt&sessType=sticky&sessTime=180&sessAuto=0

不要使用 sessAuto=1。它可能在会话中途更换出口。

下载对应架构的包：

sub2api-state-kit_plugin_v4.2.1_linux-amd64.s2plugin

首次安装先把 Release 中的 trusted-publisher.yaml 合并到宿主现有 config.yaml，重启一次 Sub2API，再上传同架构 .s2plugin。已安装旧版时可以直接升级，配置会保留。

完整说明见 插件安装与使用指南，探测和验证边界见 插件验证记录。