Repository navigation
Releases: do-whilefor/zcode2api
Release list
zcode2api v1.3.7
- 自动领卡遇到安全验证要求时，获取新票据并在原出口最多重试一次；验证失败、依赖缺失或需要人工操作时保留领取记录。
- 网页领取逐张验证，关闭弹窗、按 Esc 或点击遮罩后立即取消，忽略晚到的验证回调。
- 验证组件初始化后等待 2.1 秒再启动，保证设备信息采集时间。
- 校验一次性票据与地域，防止跨请求或账号复用；默认额度与领卡 API 版本更新为
3.17.2。 - 合并重复的验证配置解析，清理重复去重逻辑、注释及界面和文档文案。
- 补充自动验证、重试上限、原出口保持和弹窗取消的回归测试，前端测试共 65 项。
后台验证需要 Node.js 18+ 和 jsdom；上游要求人工操作时仍需在领卡页面或官方客户端完成。
提供 Windows、Linux、macOS 的 amd64/arm64 发行包及 SHA256SUMS 校验文件。Docker 镜像：ghcr.io/do-whilefor/zcode2api:1.3.7。
zcode2api v1.3.5
账号调度与故障处理
- 明确的账号并发满使用共享暂忙状态和统一队列，优先切换其他可用账号；冷却遵守
Retry-After，缺失时默认 1 秒，持续等待至恢复或取消。 - 冷却结束后每账号先放行一个恢复探测，开始有效输出后恢复正常名额；队列最多保留 1024 个等待请求，不同账号池之间不会因队首暂忙互相阻塞。
- 普通限流与服务过载保留独立的 10 秒重试窗口，网络及普通服务端故障继续使用有限重试预算。
- 收窄代理节点故障判定，区分 SDK 资源连接失败、验证票据失效、人工验证要求和运行环境错误，避免误删健康节点。
auto模式收到明确验证要求后，在同一出口刷新场景并重新取票一次；代理切换后重新执行验证流程。- 统一日志和网关的简短错误提示，区分账号、本地排队、SDK、代理及不同阶段超时；保留错误码和追踪标识，未知错误压成单行并限制为 80 个字符。
日志管理与控制台
- 调用记录、调度时间线和审计支持服务端筛选全部已保存记录，修复失败状态匹配错误及旧日志超出加载上限后无法筛选的问题。
- 每页固定 20 条，提供首页、上一页、页码、下一页、末页及指定页跳转；浏览期间新增记录不会打乱当前分页，刷新可查看最新记录。
- 三个分区分别保留筛选条件和页码，支持关键词、时间范围和自定义日期，以及各分区的错误码、模型、账号、策略、动作等筛选。
- 压缩常用筛选区域，优化“更多筛选”按钮的展开状态和已选数量；加宽报错列并直接展示正文，改善日志行间留白与手机显示。
- 请求详情和调度候选使用紧凑浮层，不撑高日志行；候选信息以账号、选中状态和中文跳过原因展示，支持点击外部或按 Escape 关闭。
- 调用、调度和审计日志不按时间或条数自动清理，保留数据目录即可在重启后继续查询。
清理与验证
- 清理未使用常量、重复 SDK 封装、旧界面样式和冗余注释，将仅供测试的辅助方法移出生产代码。
- 增加共享冷却、排队取消、SDK 与代理分流、历史日志筛选、稳定分页和详情浮层的回归测试；前端测试增至 59 项。
zcode2api v1.3.0
代理与错误处理
- 全局代理持续使用当前节点，仅在风控拦截或连接故障后切换；失败节点从本次运行的可用池中剔除，重启或修改代理配置后重新载入。
- 支持在设置页指定优先使用的代理节点，订阅刷新及本地监听端口变化时保留节点身份；指定节点同样参与故障切换。
- 代理池耗尽时返回
proxy_pool_exhausted，不回退直连或循环使用失败节点；已开始输出的流式请求不重放，账号独立代理保持独立处理。 - 精简上游风控与网络错误提示，保留错误码和追踪标识；未知错误合并多余空白并限制长度，历史用量日志也使用简短提示。
控制台与运行环境
- 额度轮询、上游安全验证、出站代理、网关与模型改为默认收起的独立面板，内层配置保持平铺；代理检测结果单独折叠，显示数量汇总并限制展开高度。
- 精简代理设置说明，移除节点名称正则筛选及订阅地址显示切换，默认显示订阅地址；缩小 Mihomo 安装按钮并修正路径与刷新间隔输入框的对齐。
- 自动检测 Mihomo，支持 PATH、托管安装目录及项目根目录，并显示实际可执行文件路径；已检测到时禁用安装按钮。
- 增加 Node.js 与 jsdom 检测，验证 Node.js 18+ 及 jsdom 能否实际加载；打开面板或修改路径后自动更新检测状态。
- 补充代理故障切换、错误摘要、运行环境检测和设置页交互的回归测试。
完整变更：v1.2.1...v1.3.0
zcode2api v1.2.1
更新内容
- 恢复设置页的全局默认思考强度选择，支持
low/high/max，保存后持久化；客户端显式设置优先，其次是密钥默认值，均未指定时使用全局默认值。 - 说明低强度仍开启思考；客户端显式关闭思考时保留客户端设置，始终思考的模型仍可能返回
1210。 - 修正设置页高级参数入口的对齐，折叠和展开时均与上方控件保持一致。
- 精简 README，将配置与网络说明拆分到
docs/，补齐历史版本更新记录。 - 发行包附带 CHANGELOG 和独立说明文档，并校验对应的包内容清单。
完整变更：v1.2.0...v1.2.1
zcode2api v1.2.0
- 新增全局出站代理设置，支持手填 HTTP/HTTPS 代理、按请求或按时间轮换、失败出口冷却，以及账号独立代理优先。
- 新增 HTTPS 节点订阅，支持 VLESS TCP/WS（含 Reality）、Hysteria2 和 HTTP/HTTPS 节点，可按名称正则筛选；通过 Mihomo 为每个节点建立固定入口，刷新时保留正在进行的请求。
- 控制台支持检测代理草稿配置、安装固定版本并校验 SHA-256 的 Mihomo；代理启用、轮询和订阅设置保存后对后续请求生效。
- 新增可选的阿里云官方 SDK 安全验证，使用 Node.js 18+ 与 jsdom，提供 off / auto / always 模式、超时及 Canvas/WebGL 模拟设置；一次性票据按请求生成，明确过期后最多重新验证一次。
- 验证码配置获取、SDK 验证与携带票据的推理共用同一代理入口；完善 WAF 拦截诊断和错误处理，3012、WAF 与 SDK 风险拒绝会结束当前请求。
- Docker 支持按需加入 Node/jsdom 和 Mihomo 运行环境；发行包包含锁定的可选依赖清单，提供 Windows、Linux、macOS 的 amd64/arm64 六个平台压缩包及 SHA256SUMS。
- 扩展离线回归、竞态检测、模糊测试、多版本 Node 和四种 Docker 运行环境检查；发布前统一验证六个平台压缩包及校验和，后端语句覆盖率要求至少 75%。
启用 SDK 安全验证前，请在程序根目录执行 npm --prefix captcha_node ci --omit=dev --ignore-scripts。Docker 可通过 CAPTCHA_RUNTIME=1 和 PROXY_RUNTIME=1 构建参数按需加入依赖。代理与安全验证默认关闭；SDK 模拟环境不保证通过上游风险判定，代理连通性检测也不代表真实推理一定可用。
完整更新对比： v1.1.1...v1.2.0
zcode2api v1.1.1
- 单账号推理并发上限调整为 3，所有模型共享名额；满额后换号或排队，每次请求结束只释放自身占用的名额。
- 领卡中心的「客户端奖励任务」默认折叠，点击后查看任务进度。
- 清理未使用的 SSE 字段、前端参数和旧样式，合并流式与非流式响应的结束原因处理，简化协程管理和映射复制。
- 增加并发名额释放、排队唤醒及会话亲和的回归测试。
完整更新对比： v1.1.0...v1.1.1
zcode2api v1.1.0
更新内容
- 修复周末等活动卡不显示、自动领卡遗漏：接入活动投放接口，与旧版可领清单合并并去重。
- 区分“暂无可领”“部分同步”和“查询失败”，单个来源异常不再隐藏已发现的卡片。
- 可领卡使用紧凑横条布局，客户端奖励任务和进度条铺满容器，并保留手机适配。
- Windows 压缩包补齐启停脚本，完整解压后无需安装 Go 即可启动；修复相对数据目录解析不一致的问题。
- 新增
--version，预编译程序与 Docker 镜像包含发布版本。 - 补充领卡回归测试和 Windows 源码、免 Go 发行包、重复启停、自定义数据目录验证。
下载与使用
提供 Windows、Linux、macOS 的 amd64 / arm64 压缩包，以及 SHA256SUMS 校验文件。
Windows 解压后运行 ./scripts/start.ps1，停止时运行 ./scripts/stop.ps1；无需 Go。首次管理密码位于 data/admin-password.txt。Linux / macOS 运行 ./zcode2api --root .。
更新时先停止旧程序，保留原有 data 和自定义 config.json，替换发行文件后重新启动。程序发布版本与设置中的上游 app_version 独立。
Docker 镜像：ghcr.io/do-whilefor/zcode2api:1.1.0。
完整变更：v1.0.0 → v1.1.0
zcode2api v1.0.0
zcode2api v1.0.0
ZCode 多账号额度管理与 HTTP 推理网关的首个正式版本。
主要功能
- 支持 OpenAI Chat Completions、OpenAI Responses 与 Anthropic Messages 协议。
- 支持 BigModel 与 Z.ai 多账号管理、OAuth 授权、分组调度与网关密钥。
- 上游繁忙时自动换号并受控重试；已开始输出的请求不会整轮重放。
- 支持额度卡自动领取、手动领取、领取记录及待生效额度查询。
- 提供 Web 控制台，管理账号、密钥、用量与运行设置。
下载与运行
根据系统和处理器选择安装包：Windows 使用 .zip，Linux 与 macOS 使用 .tar.gz；提供 amd64 与 arm64 两种架构。macOS 的 darwin_arm64 适用于 Apple Silicon，darwin_amd64 适用于 Intel Mac。
解压并进入目录后运行：
# Linux / macOS
./zcode2api --root .# Windows PowerShell
.\zcode2api.exe --root .- Web 控制台：http://127.0.0.1:6789
- OpenAI 兼容 Base URL：
http://127.0.0.1:6780/v1 - 首次管理密码：
data/admin-password.txt - 安装包包含配置示例、README、许可证与安全说明；
SHA256SUMS提供各安装包的 SHA-256 校验值。