zcode2api v1.6.3

1. 修复缓存回归：将 OpenAI 协议转换中的随机指令标记改为稳定标记，避免相同请求的缓存前缀无故变化，改善重复请求和长会话的缓存命中表现。
2. 新增缓存详情：调用日志直接显示缓存命中率，支持查看普通输入、缓存读取、缓存写入及输出用量，并提供请求 ID、追踪 ID 等排查信息。
3. 感谢 @ybtou 在 Issue #5 中反馈缓存命中率下降问题。

zcode2api v1.6.2

• 修复系统提示词重复问题，保留 ZCode 必需的三段模板结构，避免直接移除模板引起的请求异常。
• 优化代理故障与 WAF 拦截处理：启用代理池后，遇到 upstream_waf_blocked 时对受限出口进行冷却，并在有可用备用节点时自动切换。
• 完善订阅错误分类与提示，便于排查认证失败、令牌失效等问题。
• 清理冗余代码和过时文件，合并重复逻辑。

zcode2api v1.6.1

• 回退了ZCode 必需的三段 system 模板。
• 将客户端自定义指令合并到第三段、保持固定三段结构的逻辑。

感谢 @ybtou 在 Issue #3 中反馈此问题。

zcode2api v1.6.0

协议兼容

• 对齐 ZCode 3.17.2 的请求版本、请求 ID、UUIDv7 查询标识及 metadata.user_id，并保留按运行平台生成的标识。感谢 @Heking114514 在 PR #1 中提供请求指纹的排查与修复方案，本版本已按网关架构适配。
• 支持 Chat Completions 的 function / custom 工具，以及 Responses 的 function / custom / namespace 工具，补齐工具声明、调用历史、工具选择与流式响应转换。感谢 @amzqing 在 Issue #2 中反馈 namespace 工具兼容问题。
• 使用 LLGuidance 校验 custom 工具的 Lark 与 Rust regex grammar；生成结果不符合语法时返回明确错误，不将无效输入作为可执行工具调用返回。此功能是生成后的校验，不是上游逐 token 约束生成。
• 移除网关注入的固定 ZCode 系统模板，按已知段落指纹清理客户端默认模板，保留未知或自定义内容与代码示例。
• 增加 instruction_mode：默认通过带作用域的顶层 system 近似转换 developer 和中途 system 指令，并返回兼容性响应头；严格模式拒绝无法等价保留的指令语义。

版本与控制台

• 新增 ZCode 官方稳定版自动跟随，统一同步推理、额度和领卡 API 的版本标识；默认每 5 天检查，支持按分钟、小时或天设置间隔，以及手动同步。
• 检查进度与版本配置持久化；重启后沿用检查计划，同步失败或官方清单版本低于当前配置时保留已有版本。
• 默认账号余额轮询间隔调整为 5 秒、抖动为 0；控制台概览、账号和日志每秒刷新。
• 更新检查、发行包下载和镜像入口迁移至 7sen1ot/zcode2api，自动忽略旧仓库的版本缓存。
• 修复设置卡片悬停背景的圆角，折叠时与卡片边缘一致，展开时保留顶部圆角。
• 同步中、英、日 README 的仓库地址与截图预览，统一为四行两列，并在发行包中附带截图。

Grammar 校验需要 Python 3.10+ 与 grammar_python/requirements.txt 中的 llguidance；普通 function 和无 grammar 的 custom 工具不需要该依赖。Docker 可使用 GRAMMAR_RUNTIME=1 构建参数安装。六个平台发行包均附带依赖清单与协议兼容说明；一键更新只替换程序，可选运行时依赖仍需单独安装。

zcode2api v1.5.0

• 新增「设置 → 版本更新」，检查 GitHub 最新正式 Release，展示当前版本、最新版本与发布说明；同一发行版本不会覆盖本地热修复。
• 为 root 运行的 Linux/systemd 服务提供一键更新：校验发行包 SHA256，备份程序、数据库及配置，重启并检查健康状态，启动失败时恢复旧程序。Docker 与其他部署方式提供手动更新入口。
• 修复周末免费卡识别，同时支持 ZCODE GLOBAL BUILD 和 ZCODE WEEKEND BUILD，使用上游返回的可领取计划 ID，移除前端重复的名称过滤。
• 修复 HTTP 400 携带 3007 时未触发验证的问题，接通服务器 SDK 与浏览器官方验证组件；代理故障、账号风控和 429 限流继续独立处理。
• 服务器验证未通过时，浏览器初始化后等待 2.1 秒，自动尝试一次官方无痕验证，成功后继续领取；失败、15 秒无结果或要求人工交互时保留手动入口，不循环重试。
• 验证对话框在组件加载前显示，支持加载失败后重新加载、手动重试和取消；忽略取消或重新初始化后的迟到回调，避免重复提交。
• 总使用额度、输入与输出改为完整数字显示，移除「万」「亿」和 Token 单位，并适配较长数字。
• 领取审计补充上游 HTTP 状态、SDK 是否执行、是否携带票据和是否需要浏览器验证，不记录票据正文。

浏览器自动验证需要页面保持打开并登录；交互题目与验证结果由上游决定。Node.js、jsdom、Mihomo 等可选依赖不会随一键更新自动升级。

完整变更：v1.3.9...v1.5.0

zcode2api v1.3.9

• 强化阿里云无痕验证 SDK 的票据管理：按账号凭据、用途、场景与代理出口隔离一次性票据，按近期验证需求预取并补充过期票据。
• 推理、管理接口与 SDK 共用冷却状态，遵守 Retry-After；区分账号风控、验证拒绝与代理连接故障，避免错误归因和无效重试。
• 代理连接故障与 WAF 拦截采用短时隔离，到期后允许后续请求重新尝试；验证与携票业务请求保持同一服务端出口。
• 完善手动及批量领卡的 SDK 自动验证、一次性验证会话与官方交互验证兜底；新增每日自动领卡时间设置，默认北京时间 19:02。
• 更新控制台用量与缓存趋势图、账号身份展示和日志刷新，精简表单说明与弹窗。
• 增加英语、日语 README，补齐源码、发行包、Windows 脚本与 Docker Compose 部署说明，并随发行包提供。
• 移除旧测试套件与覆盖率门槛，CI 精简为静态检查、语法检查与服务冒烟测试；CD 复用检查并验证发行包内的 Linux 程序，通过后发布六个平台发行包与 Docker 镜像。

自动验证需要 Node.js 18+ 与 jsdom；验证结果由上游决定，需要人工交互时使用官方验证组件。

完整变更：v1.3.7...v1.3.9

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