Releases: wangyunjeff/sub2api-state-kit
Release list
v0.3.4 · 按分组选择账号
v0.3.4 · 按分组选择账号
在「选择需要票据的账号」中先选分组，再选账号并添加，账号名称和 ID 一起显示。支持「全部分组」「未分组」，已添加账号自动排除；插件停止时也能加载目录。分组仅用于筛选，不改变 Sub2API 原有分组、代理或调度。
新增账号默认关闭，保存后再开启。切换选择和刷新不会自动保存、查找票据或发送模型请求，未保存草稿在轮询中保留。
下载与升级
- 安装插件：
sub2api-state-kit_plugin_v0.3.4.s2plugin - 插件完整源码：
sub2api-state-kit_plugin_v0.3.4_source.zip - 包内含 Linux amd64、Linux arm64、macOS arm64；沿用现有发布者公钥，提供 SHA256SUMS。
- 分组下拉需同步更新本版宿主适配并重建宿主前端。 仅上传插件不能增加宿主接口；旧宿主继续支持输入账号 ID。宿主基线仍为官方 Sub2API v0.2.7。
- 安装指南 · 宿主适配说明
如果「测试并应用代理」「查找票据」变灰且显示「插件未运行」，先关闭配置窗口，在插件管理卡片点击「启用」，再打开配置。「使用 STATE」和账号开关不能代替宿主启动插件。
验证
本地通过插件 race / vet、44 项界面测试、5 项宿主目录与页面测试、宿主前端类型检查及构建、官方 v0.2.7 签名安装与真实插件进程集成。真实浏览器验证了分组筛选、未分组、排除重复、新账号默认关闭、草稿保留；原配置和插件启停状态保持不变。
本次新增功能的验证没有发送模型请求；历史模型路由对照仍见 README，不作为此次新的恢复效果测试。公开源码与安装包不包含个人账号、代理认证或票据。
Linux amd64 / arm64 发布验证全部通过：校验同一签名包及 SHA256、重建并比对包内二进制、官方宿主安装与进程运行、宿主适配测试；amd64 另完成宿主前端目录测试、类型检查和构建。
v0.3.3 · 单账号操作、代理测试与模型对照
本版把按账号查找 STATE、代理测试和模型验证放在同一个插件页面。测试结果重点突出 请求模型 与 实际返回模型，便于发现模型被改路由。
新版插件页面成功实测（2026-09-20）
已在 v0.3.3 插件页面重新完成对照，并直接截取测试区域。同一个 Pro 账号、同一个固定业务出口、同一个提示词：无票据时返回 gpt-5.6-luna；本轮第 2 次采集取得有效票据并复验通过后，注入 STATE 完整返回 gpt-6-astra。两次均 HTTP 200。
带票据成功结果：
同账号无票据对照：
最新 README。截图只隐藏账号 / IP，模型字段与回答保持原样。原配置未改动；本轮只验证这次路由对照，没有能力或长期有效性结论。
本次更新
- 单个账号开关点击即保存；单行查找只操作自己，另有全部已开启账号查找按钮。
- 自动续期与补票可开关；进度、出口 IP / 国家、失败原因直接显示。
- 前置代理支持直连、手填或选择 IP 管理；国内部署可让固定业务代理共用前置代理。
- 测试代理成功后自动应用，首次手动查找优先沿用短时保留的会话；单个动态出口失败按配置重试。
- 提供快速检查、鹈鹕动画、糖果推理预设及自定义提示词；可停止测试，HTML 支持预览 / 源码切换。
- 清楚区分代理检测失败、401 授权失败、模型仍被路由及 HTTP 200 数据流中的上游过载。模型名称一致仅为路由指标，不作为能力恢复保证。
安装与升级
本页展示的完整手动功能需要官方 Sub2API 0.2.7 + v0.3.3 宿主适配，并重建宿主前后端。 原版 0.2.7 可使用基础配置、自动采集和传输；仅上传插件无法补齐手动动作接口。已有 v0.3.2 目录适配也需更新。
附件 .s2plugin 内含 Linux amd64、Linux arm64、macOS arm64 运行时；_source.zip 是完整插件源码及宿主适配脚本，不是完整 Sub2API 服务。首次安装需合并发布者公钥。升级保留自己的配置和数据；无票据时默认按业务出口放行，可在高级设置中关闭。
发布包不含作者的账号、代理凭据、API Key、STATE、数据库或签名私钥。README 截图已脱敏。
发布前验证记录（保留当时结果）
41 项界面测试、后端 race / vet 和 macOS arm64 官方宿主集成通过。快速检查与鹈鹕 HTML 预览实测完成，实际返回 Luna，页面如实提示模型不符；糖果测试遇到上游过载，页面明确显示失败原因。本次没有取得新的有效 STATE，不将截图作为恢复模型的成功证明。
Linux 原生验证已通过：amd64 / arm64 均通过 race、41 项 UI 测试、签名 / SHA256、公开源码与包内运行时逐字节比对、官方宿主安装器 / 进程及适配后端测试；amd64 另通过适配宿主前端类型检查与构建。受测源码：fdcdca56b5f6c15e869e48d3c186616de9f7838a。
v0.3.2 · 账号名称与前置代理选择
插件配置页增加账号名称和三种前置代理方式：直连动态代理、手动填写、选择 Sub2API IP 管理中的代理。
- 账号名称显示在添加选项、账号行、状态和页面日志中，保留 ID 便于核对。
- 选择已有代理时只保存代理 ID，每次采集前解析最新配置；删除、禁用、过期或解析失败会明确报错，不会悄悄改成直连。
- v0.3.1 配置自动兼容；业务请求和票据复验仍走账号原有业务代理。
兼容说明： 原版官方 0.2.7 支持插件基础功能、直连和手动前置代理。账号名称与代理下拉需要额外安装本次提供的可选宿主资源目录适配，单独上传插件不会增加宿主接口。适配只基于官方 aea725f（0.2.7），无数据库迁移，与 0.2.6 overlay 无关。
下载 .s2plugin 用于插件管理上传，_source.zip 为插件源码。需要名称与下拉选择的用户请先读 plugin-host-directory.md；源码包含适配补丁和独立宿主准备脚本。安装包不附带作者的账号、代理认证、API Key、数据库或签名私钥。
已通过插件后端 race/vet、19 项前端测试、原版宿主安装与进程集成测试、可选宿主目录测试。本地网页已验证三种设置保存；同一 Pro 账号经所选前置代理采集到 292 STATE，通过原业务代理复验，实际 API 调用 HTTP 200、响应模型 gpt-6-astra。检测到的出口 IP 属于同代理会话的独立查询结果，不保证每次模型连接使用相同出口。
Linux amd64 / arm64 原生验证均通过（含可选宿主适配）：https://github.com/wangyunjeff/sub2api-state-kit/actions/runs/35444355730
v0.3.1 · 前置代理与运行日志插件
STATE Kit 插件 v0.3.1：前置代理、出口 IP 与运行日志。
- 可选填写前置代理：当前机器 → 前置代理 → 动态代理池 → 采集 STATE。支持 HTTP(S) / SOCKS5(H)；原业务出口复验和正常请求仍使用账号原配置。
- 插件配置页可启用出口 IP 检测，查看每次尝试的 IP、响应模型、HTTP 状态、STATE 长度和耗时，每 5 秒刷新。
- 前置代理失败不会回退直连；日志不输出代理密码、账号 Token 或 STATE 原文。
- 保留逐账号开关、Pro 292 / Team 332、票据持久化、续期与异常守护。
官方 0.2.7 插件接口不提供代理管理列表，本版采用手动填写。IP 为同一代理会话的独立查询结果，不保证每条模型连接出口相同。出口检测默认关闭；前置代理默认留空。
下载 .s2plugin 在插件管理中安装；已有 v0.3.0 用户先停用插件再上传新包，配置和发布者公钥沿用。首次安装请看仓库 docs/plugin.md。支持 Linux amd64 / arm64、macOS arm64；空白配置，无作者账号/IP/密钥。
验证完成：本地 35 个后端顶层测试的 race、vet、17 项网页测试及官方宿主集成通过；Linux amd64 / arm64 原生 CI 全部通过：
https://github.com/wangyunjeff/sub2api-state-kit/actions/runs/35441828242
真实 Pro 账号测试：通过两层代理获取 292 票据，并通过原业务出口复验。使用同一个账号、目标模型和业务出口，网页关闭后 API 返回 Luna，开启后返回 gpt-6-astra，再次关/开也得到相同对照结果；插件重启恢复已保存票据且不延长原到期时间。
这是本次受测账号的短时结果，不保证其他账号、真实 Team、模型能力、上游并发或一小时持续有效。详细范围见 docs/plugin-validation.md。
v0.3.0 — 独立 STATE 插件版（Sub2API 0.2.7）
在现有增量版和完整项目版之外，新增独立 STATE Kit 插件版。安装到官方 Sub2API 0.2.7，无需覆盖或编译宿主源码。
下载
sub2api-state-kit_plugin_v0.3.0.s2plugin：签名插件，包含 Linux amd64 / arm64 和 macOS arm64。sub2api-state-kit_plugin_v0.3.0_source.zip：完整插件源码、网页、测试及打包脚本；不是完整宿主源码。trusted-publisher.yaml、publisher-public-key.txt：首次安装的发布者信任配置与公钥。SHA256SUMS：下载完整性校验。
功能
在「插件管理 → STATE Kit · 账号级票据 → 配置」集中操作：全局动态代理池、账号 ID 独立开关、Pro（292）/ Team（332）、模型列表、固定业务代理复验、自动续期、312 / 模型不符守护，以及持久化票据的重启复验。
所有 STATE 开关默认关闭、账号配置为空；不附带作者的真实账号、代理、IP、API Key、票据、数据库或签名私钥。
安装要点
- 将附件公钥配置合并进宿主现有 config.yaml，并重启应用服务一次。
- 在插件管理上传
.s2plugin。同类插件只能启用一个，已启用官方 OpenAI OAuth Transport 时先停用它。 - 启用 STATE Kit，灰度设为 100%；在插件页只为需要的账号打开 STATE。
验证与边界
本地后端 race / vet、15 项网页测试、真实浏览器沙箱操作和官方宿主进程集成通过。Linux amd64 / arm64 均通过对本 Release 同一个签名包的验签、源码重建一致性比对和官方宿主运行集成：CI 结果。
这轮使用可控本地上游测试，未用真实 OAuth 账号或付费代理验证恢复效果。目前支持单个宿主实例；账号设置位于插件页，非账号编辑弹窗。100% 灰度时未开启 STATE 的 OAuth 账号也经过插件转发，宿主将匹配的 WebSocket 切为 HTTP Bridge。缺少有效票据的已启用账号/模型返回暂不可用503。详见安装指南的限制说明。
已有的 完整项目版 v0.2.0 和仓库增量源码继续保留，三个版本按场景选择，勿叠加注入。
感谢 Sub2API、gylive/ccodex-sleep-state 及参与讨论与测试的朋友。本插件按公开协议独立实现，不重新分发私有插件二进制。
v0.2.0 — 完整 Sub2API + STATE 空白部署版
完整 Sub2API + STATE 发布版，基于官方 Sub2API v0.2.6。保留原有后台和网关，并包含账号级 STATE、Pro/Team 选择、全局动态 IP 池、票据保存、续期与异常守护。
这是空白安装包：没有作者的模型账号、代理/IP、API Key、STATE、数据库或部署配置。首次安装由用户自行生成管理员密码与密钥，模型账号、代理和 Key 需要自己配置，STATE 默认关闭。
下载哪个文件
| 文件 | 用途 |
|---|---|
sub2api-state-kit_v0.2.0_linux_amd64.tar.gz |
x86_64 Linux 服务器，内含编译好的程序、网页、Dockerfile 和 Compose |
sub2api-state-kit_v0.2.0_linux_arm64.tar.gz |
ARM64 Linux 服务器，同上 |
sub2api-state-kit_v0.2.0_full-source.zip / .tar.gz |
完整上游源码与扩展、测试和构建说明，无需手动应用增量 |
SHA256SUMS |
所有发布附件校验值 |
GitHub 自动生成的 Source code 附件是增量仓库本身，需要完整项目请选 full-source。增量 overlay/ 与源码生成脚本继续保留。
新安装
解压对应 Linux 部署包，在目录中执行：
sh init.sh
# 编辑 .env，设置自己的管理员邮箱、监听地址和端口
# 管理员密码为此机随机生成，见 .env 的 ADMIN_PASSWORD
docker compose up -d --build需要 Docker Compose v2、openssl 和下载基础镜像的网络。部署包已编译，--build 只组装运行镜像；默认监听 127.0.0.1:8080。需要直接外部访问时调整 BIND_HOST，或使用自己的反向代理。完整源码包也可使用同一 Compose 流程，但会从源码编译。
已有生产用户先备份、隔离测试，只替换应用并保留自己的配置和数据。不要直接覆盖生产 Compose。内置官方更新会替换为原版，后续请使用本项目发布包。
验证与边界
本次 公开构建与验收 全部通过：前端 58 项测试和构建，两个原生 Linux 架构的后端定向回归、二进制编译、Docker Compose 全新安装、管理员登录、网页、STATE 默认关闭、账号/代理/API Key 数量为 0，以及重启后复验。保留首次登录确认流程，不预置确认记录。附件内每个文件和外部压缩包都有 SHA-256 校验值。本版本为非官方实验版，不能保证上游持续接受 STATE、模型能力或生产负载表现。保留上游 LGPL v3 许可证和署名。
感谢 Wei-Shaw/sub2api、gylive/ccodex-sleep-state 和社区的思路与帮助。
v0.1.0 — 账号级 STATE 实验版
首个公开实验版，基于 Sub2API v0.2.6 固定提交。
- 增加账号级 STATE 入口与独立开关，可以逐个账号编辑。
- 增加 Pro（292）/ Team（332）手动选择。
- 增加成功响应模型不符、312 字节 STATE 信号的动态守护。
- 使用同账号动态池采集及固定业务代理复验，保留有效票据续期与重启恢复。
- 仅发布必要功能源码、测试、许可证、说明和完整源码生成脚本；不包含个人账号、真实 STATE、代理凭据、数据库或实验记录。
这是源码扩展包，不是可安装插件或预构建镜像。在下载的仓库目录执行：
python3 scripts/prepare.py ../sub2api-state-source验证范围见 docs/validation.md。长度和路由字段只是实验观察，不保证上游可用性或模型能力。
感谢 Wei-Shaw/sub2api、gylive/ccodex-sleep-state，以及各位群友的帮助。代码免费开源，欢迎 Star 与反馈！