Skip to content

Releases

hcai(fix): 同步了上游v0.2.21;解决了多节点部署下系统设置缓存不一致的问题,同时解决了一些已知问题。

Choose a tag to compare

@github-actions github-actions released this 14 Nov 08:43
2db175f

hcai(fix): 同步了上游v0.2.21;解决了多节点部署下系统设置缓存不一致的问题,同时解决了一些已知问题。

版本:v0.2.21-hcai(fix1)。沿用已完整合入的上游 v0.2.21(10ba8f9b4dc2e6023d4a9879ab77b21841babd10),保留 HCAI 自定义及原管理员返利记录查询修复。

  • 系统设置成功落库后,本机立即失效 HTML 缓存并刷新 iframe 来源,通过既有 Redis 通知其他节点;消息只有元数据,发布失败告警且不影响保存成功。
  • 修复客户端 IP 信任、WebSearch Manager、错误透传规则和 TLS 指纹模板的跨节点旧快照;增加重连校准、30秒数据库补偿和订阅关闭清理,避免接收通知后再次发布。
  • 阻止失效前的旧 HTML 渲染重新污染缓存,保持响应 ETag 与内容一致。
  • 按指定括号版本发布并补充插件兼容,不降低协议检查;更新检测仍只比较数字基础版本,同基线 fix1 需人工核查 Release。

验证:Go 1.27.3 完整 unit/普通测试及 CGO=0 构建,前端 Node 22.23.4 / pnpm 11.10.0 的 lint/typecheck/3176测试/build,embed race及版本输出,以及双节点、断线恢复、失败路径、幂等、无Redis和关闭清理回归均通过。业务修复 CI、归档修正 CI、main 最终 CI和正式构建均成功。

数据库:相对 0.2.21-hcai 无新增迁移。从更早版本升级仍正常自动应用尚未执行的既有迁移。无需新增配置或第二套 Redis 客户端,无公开清缓存接口;Redis ACL需允许新 channel sub2api:settings:updated:v1 及既有两个规则/模板 channel。

失败策略:数据库读取失败时,IP转发头信任关闭、WebSearch Manager暂时禁用;错误透传规则/TLS模板保留旧快照并告警重试,不宣称故障期间配置已同步。

一致性边界:Pub/Sub 没有持久化重放,30秒是补偿周期而非网络/数据库故障时 SLA;旧节点、已打开浏览器页面及在途请求不会被强制更新。应在后续获授权部署时更新目标节点并逐节点核查菜单及 CSP,不靠重启所有节点替代失效机制。

产物:Linux amd64 的 sub2api_0.2.21-hcai-fix1_linux_amd64.tar.gz、独立二进制 gz、checksums.txt、BUILD_INFO.txt;归档名作安全字符规范化,VERSION及标签保留括号;原 v0.2.21-hcai 标签和产物保留。包内安装脚本可能仍指向上游,使用本仓库经校验二进制。回退需结合实际数据库与配置评估。

文档位于 docs/hcai-dev/:系统设置多节点缓存失效修复、四类运行时缓存多节点一致性修复、同类问题审查、自定义清单、差异附录、版本规范及本修订发布记录。此前部署前审查属于旧发行基线,不代替本修订验证。

本次仅完成仓库版本发布,未连接生产、部署或重启服务;真实生产多节点业务验收未执行。

正式发行提交:2db175f8d4b79115e1010b1610391da025a9fdaa。下载后SHA256核验通过,两个归档二进制一致;Go1.27.3、linux/amd64、CGO=0、embed、vcs.modified=false,完整源码revision与标签一致。

产物 SHA-256
sub2api_0.2.21-hcai-fix1_linux_amd64.tar.gz 8a6a1ce33d3dc75177d27d1dfe495aa11d33fda6cd30aee01d2fe4e4ab93c99f
sub2api-linux-amd64.gz 7feb90a176fc380e62870bd6de80b4a08576464faa7f044442ad79ce2cbe0090
解压后二进制 f3251ae4f357a744ee208eba6eb0e28e50dbb1a7582353a48496e0114f5db4e2

v0.2.21-hcai

Choose a tag to compare

@github-actions github-actions released this 11 Nov 15:12
3820212

HCAI 0.2.21

同步上游 v0.2.21,固定基线 10ba8f9b4dc2e6023d4a9879ab77b21841babd10。

HCAI 修复与保留

  • 修复管理员返利记录查询退化:无搜索计数不再解析所有来源,兑换码 ID 与历史 code 分别走索引,ID优先防止碰撞重复,保护非法和溢出引用并稳定分页。不修改返利计算、余额或账本写入,无额外迁移。
  • 保留 HCAI 品牌首页/loading、插件后缀兼容与设置、模型广场人民币实付/美元官方价及渠道展示优先、CC Switch、支付宝沙箱、MinIO/异步图片、企业微信、多节点锁/租约和认证失效广播。
  • 合入12h缓存价格与视频独立倍率非负保护,保持实际扣费与展示优先级边界。

上游内容

新增 Claude Fable/Mythos 5.2,OpenAI 30m/12h缓存写入统计与价格、内存预算自适应,修复流式/WebSocket failover、工具上下文、刷新令牌和原生生图错误状态码等问题。缓存计费、请求体预算与部分基础价格存在行为变化,升级前核对渠道价卡及显式配置。

迁移及部署注意

  • 正常服务启动自动执行 249_add_usage_logs_api_key_cost_index_notx.sql 和 250_openai_cache_write_ttl.sql;完整文件名区分同编号迁移,不删除旧迁移。usage_logs并发索引可能延长首次启动,请给予合理启动时间。
  • 请求体预算配置键 gateway.request_body_memory_budget_bytes,未显式配置时自动取内存上限的1/4、最低1GiB。
  • 本次发布不代表已部署或完成生产恢复/真实模型/支付验收。GIF上游拒绝未宣称解决。
  • 返利性能为隔离数据库结果,不保证生产响应时间。回退前评估新字段/索引及配置兼容,保留旧程序与数据库备份,不随意撤销数据库迁移。

验证与文档

Go1.27.3、Node22.23.4、pnpm11.10.0;前端393文件3176测试、lint/typecheck/构建、后端unit/普通完整测试、普通/embed构建和模块校验通过。unit首轮有全进程内存阈值用例失败,独立3次及全套重跑通过,未放宽断言。PostgreSQL17全量迁移与全部AffiliateRepository集成测试通过。

产物

Linux amd64 内嵌前端二进制,提供tar.gz、gz、checksums.txt与BUILD_INFO.txt。生产采用核验后的二进制/systemd方式,包内安装脚本可能仍指向上游,不将上游Docker镜像视为HCAI产物。不覆盖旧Release和标签。

发布审批与 CI

本版本已获用户 CODEOWNER 例外授权,仅在 dev/main 两个 PR 的最终 Backend/Frontend CI 均成功后合并发布。

main 发布提交:3820212cac2b5bd94002cb0be64a37c71a055a5d。

v0.2.20-hcai

Choose a tag to compare

@github-actions github-actions released this 07 Nov 08:16
be8ece4

版本与来源

HCAI 0.2.20-hcai;上游 v0.2.20,实际提交 dab829a4e9b7d1cc307189aea8b0319eb29e29d0(附注标签对象另为 ec41309811cd)。基于已发布 0.2.19-hcai.1,包含此前 Token 请求统计数据库缓存及其他 HCAI 修复。

本次更新

  • 合入管理 MCP/OAuth(默认关闭,需显式设置 MCP_PUBLIC_URL)、管理密钥权限与显式全权兼容模式、注册邮箱黑名单、图片尺寸档位路由。
  • 合入请求体/响应内存治理、读写超时、GPT Image 2.6、流式与非流式响应、Antigravity 用量等上游修复。
  • 保留 HCAI 首页/loading、插件设置与版本兼容、模型广场渠道展示优先与独立官方价、中英文、汇率、CC Switch、返利/沙箱、MinIO、企业微信、多节点锁与认证广播、日志重试及 Token 统计缓存。
  • Go 1.27.3、Node.js 22.23.4、pnpm 11.10.0 安全构建基线保持。

迁移与兼容

正常启动自动执行新增 249_mcp_oauth.sql。既有 249_ops_token_stats_cache.sql 按完整文件名独立保留,不改写历史迁移。已在隔离 PostgreSQL 17 验证旧基线升级、两个迁移并存、数据保留和重启幂等。

实际新增配置位于 gateway,不是上游 Release 文案中的 security:

  • gateway.request_body_memory_budget_bytes:默认 1 GiB,超额 503 + Retry-After。
  • gateway.request_body_read_timeout_seconds / gateway.downstream_write_timeout_seconds:默认 120 秒,限制单次停滞读写,0 可禁用。

客户端断开后的有界 drain 影响截断请求计量;Terra 订阅长上下文豁免/API Key 倍率、minimal effort 校验和 Codex 默认模型/认证模板随上游变化,不是仅展示改动。CC Switch 保留 HCAI 既有 /v1 规范化及中文脚本保护,真实客户端尚未验收。

二进制回退不撤销新表;混合版本不要启用 MCP 或依赖新权限。部署前保留旧程序/配置并评估数据库恢复条件。本次仅合并发布,未部署,未执行生产恢复、真实付费模型或支付/MinIO 验收。

验证与记录

本地前端冻结安装、lint、typecheck、393 文件/3148 tests、生产构建;后端 unit/full、普通/CGO0/Linux amd64 embed 构建、模块校验、HCAI 定向回归及隔离迁移通过。远程两轮 PR CI 结果见下方最终证据。

冲突及合并记录;净差异清单。19 个冲突逐项记录,历史快照保留。

提供 Linux amd64 内嵌前端程序、tar.gz/gz、checksums.txt 与 BUILD_INFO.txt。归档安装脚本可能仍指向上游;HCAI 非 Docker 节点使用核验后的二进制,不直接运行上游安装脚本。

最终合并证据

附件下载校验通过,tar.gz/gz 解压二进制完全相同;Go 1.27.3、linux/amd64、embed、CGO=0、vcs.modified=false,构建提交与发布标签均为上述 main SHA。

二进制 SHA-256:d74933867a3567d1687f2cebd2253cd0bdd233eb87a28036e4a6162b1b21d2ca。

v0.2.19-hcai.1

Choose a tag to compare

@github-actions github-actions released this 04 Nov 10:31
68846f7

Token 请求统计优化,版本 0.2.19-hcai.1。

  • 一次聚合返回统计列表和模型总数,减少重复读取。
  • PostgreSQL 共享缓存和全局事务互斥,多个应用无须共享 Redis。
  • 默认自动刷新60秒,增加请求防重、筛选取消、隐藏页面暂停;已有持久化30秒设置不会被覆盖。
  • 原统计范围和逐请求 TPS 平均值保持不变。

升级说明:迁移249新增 ops_token_stats_cache 表及到期索引,不重建 usage_logs。全部共享数据库的应用升级后互斥才完整生效。缓存TTL120秒,统计窗口按分钟对齐,截至时间见页面;不同筛选的冷计算会串行等待,可能超时。缓存不可用时返回错误,不绕过保护直查。

已完成前后端检查、隔离PostgreSQL并发与统计一致性测试、Linux amd64 embed构建;具体CI与验证见版本发布记录。未进行生产执行计划/IO验证,未部署或重启生产。

回滚:可回退上一版程序并保留新增缓存表;旧版不使用该表,回退后跨实例保护失效。不要自动删除缓存表。

附件仅支持Linux amd64,SHA256见checksums.txt;准确提交与工具链见BUILD_INFO.txt。包内上游安装脚本不作为HCAI生产部署入口,不包含arm64或HCAI Docker镜像。

v0.2.19-hcai

Choose a tag to compare

@github-actions github-actions released this 01 Nov 04:35
11b95f8

0.2.19-hcai

同步上游 v0.2.19(dece26153621959ccd7635814f4b2d08304e681a),保留 HCAI 首页/loading、插件管理、模型广场渠道展示优先/双语/汇率、CC Switch、支付返利、身份探测、MinIO、企业微信及多区域协调。

发布提交:11b95f862f680763471af79e56a321efd25d6088。用户于 2026-11-01 授权本版本例外合并与发布;dev/main 两个 PR 最终前后端 CI 均通过。

更新与兼容

  • 引入受限管理员 API Key、GPT-6.1 Terra、Grok 模型目录诊断、Gemini 重试配置及 DeepSeek 等兼容/计费修复。
  • 新增 OpenAI/Composite 图片按实际张数计费开关,默认关闭,仅图片端点适用。
  • 兼容 7 个显式冲突;修复自动合并中模型广场提前返回绕过渠道 token 展示优先的问题,实际扣费优先级不变。
  • 保留 Go 1.27.3、Node.js 22.23.4、pnpm 11.10.0 安全构建基线。

数据库与回退

正常启动自动执行迁移 247(受限管理密钥表)、248(groups.image_count_billing,默认 false)。已在隔离 PostgreSQL 验证旧基线升级及重复执行幂等,未进行生产恢复演练。

混合版本期间不要开启新的图片计费开关或依赖受限管理密钥;旧版本不识别这些能力。回退程序不撤销新增表/列。本次包含真实计费及目录变化,不只是展示更新。

验证与记录

前端冻结安装、lint、typecheck、3067 tests、build;后端 unit/full/build、Linux amd64 embed、go mod verify;隔离迁移均通过。两处既有测试时序竞态已修复,重复验证及定向 race 检查通过。

产物与部署边界

附件仅提供 Linux amd64 内嵌前端程序,包含 tar.gz、单二进制 gz、checksums.txt、BUILD_INFO.txt。包内 deploy/install.sh 等仍可能指向上游,不能直接当作 HCAI 生产安装入口。

本次只发布,不部署生产。后续如部署,既有范围为 jp-01 → jp-02 → tw → us,逐台二进制替换/systemd 重启;不包含 jp-03,不使用 Docker。部署授权、备份及生产验收另行确认。

v0.2.18-hcai

Choose a tag to compare

@github-actions github-actions released this 24 Oct 08:39
4bd14c5

v0.2.18-hcai

基于上游 v0.2.18(ac1b8f1271be0d674fa6f074403c1410f30a3a81),发布提交 4bd14c5。

  • 保留 HCAI 首页/loading、插件开关、模型广场渠道价格优先及独立官方参考价、双语、支付返利、MinIO 与多区域定制。
  • 合入 Vertex 账号配额、Gemini/Antigravity 生图门控、流式请求断开后的计费收尾、调度缓存及图片下载安全修复。
  • Go 1.27.3、Node.js 22.23.4、pnpm 11.10.0 安全构建基线保持不变。

升级注意

迁移 246 会开启已有 Gemini/Antigravity 分组的生图权限,混合分组不自动开启;升级前核对权限并保留数据库备份。回退二进制不会撤销迁移,需要按分组设置恢复权限。Grok 4.7 Fast 包含真实标准费率变化,不只是官方展示价变化。

生产备份恢复和多区域发布未执行,本次 Release 不代表已经部署。包内安装脚本可能指向上游,不应直接用于 HCAI 生产升级;现有环境采用二进制替换与 systemd 发布。

验证与产物

dev CI、main CI、发布构建 均成功。两个压缩包校验通过,解压后二进制完全一致,linux/amd64、Go 1.27.3、vcs.modified=false。

二进制 SHA-256:21a4d278aa744ce18e8637a74992f28c795d7452ec6764eb4b354a0a53adcce1。

9 个冲突及逐项方案;381 个非文档净差异路径。

v0.2.17-hcai-security.20261022

Choose a tag to compare

@github-actions github-actions released this 24 Oct 07:29
f8e21b2

What's Changed

  • hcai(security): 更新 Go 和 Node.js 安全构建环境 by @HeLongaa in #31
  • hcai(release): 发布 0.2.17-hcai-security.20261022 by @HeLongaa in #32

Full Changelog: v0.2.17-hcai...v0.2.17-hcai-security.20261022

v0.2.17-hcai

Choose a tag to compare

@github-actions github-actions released this 19 Oct 17:47
f62c11e

0.2.17-hcai

发行核验已于 2026-10-20(北京时间)完成:自动发布成功,正式 Release 非预发布且为 latest。标签、main、BUILD_INFO 及二进制 VCS 信息均指向下面的发布提交;内嵌前端、linux/amd64、CGO_ENABLED=0、vcs.modified=false 已确认。

下载后两项压缩附件均通过 checksums.txt 校验,tar.gz 与 gz 解压后的程序逐字节一致。

文件 SHA-256
sub2api_0.2.17-hcai_linux_amd64.tar.gz 12924104432c2bac2e5d5d61fe4f3ab88024f0cca5786a450098e90f8777b8ed
sub2api-linux-amd64.gz 9e7fbb0ff4258167fe9cfb96a6d543c1693c065fde87994a135cc80fea80b7b6
解压后 sub2api 3392c63f640b8a9f1501b975e9f48f452adc844e1256cfabf3261fa4e627262b

发布提交:f62c11e87e43951c3fb6c1a395e8bbcf6ab15018。dev 合并提交:45969bde4457ca425b5545f1e33a55055e444bfc。

main 发布 PR #30 的 最终 CI 前后端全部通过。自动发行工作流。本次 CODEOWNER 例外由用户明确授权,未绕过 CI。

同步上游 v0.2.17(060d0160417782cd962a0c7f460f6cd4565d4916),保留 HCAI 首页/loading、插件开关和版本兼容、模型广场渠道展示优先及独立官方参考价、CC Switch、返利、沙箱支付、MinIO/异步图片、多区域后台作业及认证缓存失效等定制。

上游更新与升级注意事项

  • Gemini 4 Argon、思考档位与流式摘要、模型能力目录及 OpenAI API Key Web Search 模拟等能力。
  • GPT-5.5 系列不再作为 ChatGPT OAuth/SetupToken 上游目标调度或展示;API Key 账号不受此退役规则影响。部署前核对别名及模型映射。
  • 退款 pending 期间保留扣减,确认成功不重复扣减,确认失败事务归还;支付宝记录可查询请求号。旧退款缺少请求号时需要人工对账。
  • gateway.min_output_tokens 默认 128、最小 16,低于下限的配置不能启动。
  • 本次无新增 SQL 迁移或依赖锁变化;无 SQL 不代表可以无条件混跑或回退,尤其须核对待处理退款及 Gemini 缓存费用状态。

HCAI 合并与验证

四处显式冲突逐项处理,未用上游 README 覆盖 HCAI 文档。详细记录:

本地前端 2924 项测试、lint、typecheck、build,Go unit/full、普通及 embed 构建、模块校验和定向 PostgreSQL/Redis 集成验证通过。未进行生产恢复演练或真实模型/支付验收。

部署与回退

发行物为 Linux amd64 内嵌前端程序,提供 tar.gz、gz、checksums.txt、BUILD_INFO.txt。无本次 arm64 或 HCAI Docker 镜像发行物。包内安装脚本可能仍引用上游,不直接用于 HCAI 部署。

本次仅发布,未部署任何生产节点。正式部署须核实节点、备份、回退程序和观测门槛,逐台验证后再推进下一节点。既有 usage-log 超时及美国调度快照问题未在此确认修复;不因发布完成而宣称线上全功能验收通过。

v0.2.16-hcai

Choose a tag to compare

@github-actions github-actions released this 13 Oct 16:05
f84107f

0.2.16-hcai

基于上游 v0.2.16,固定源码 01842576b3d5c1e2545b5a99ad555d36e28ed306,累计引入 v0.2.15 之后 79 个提交。HCAI 通过两阶段 PR 合入,保留上游合并历史。

main 发布提交:f84107fd4d67a367a360df34952d0a52915f13f4。北京时间 2026-10-14 完成合并。

更新与定制

  • Gemini 显式上下文缓存:创建、续期、删除、存储计费和数据库修改租约恢复。
  • Haiku 5.5、Gemini Vertex API Key/模型同步、AQ. Key、分组多语言、模型级临时冷却。
  • GPT-6.1 Sol OAuth 订阅长上下文豁免、Gemini 价格与协议转换、风控分组、倒计时、IME 输入及运维显示修复。
  • 保留 HCAI 首页与加载态、插件设置和版本兼容、渠道展示价优先与双币种、官方参考价独立来源、完整双语键、CC Switch、菜单安全、返利与沙箱支付、WeCom、多节点协调、异步图片和 MinIO。

3 个冲突为 VERSION、Wire 生成代码、endpoint 常量;分别采用 HCAI 版本号、从合并后源定义重新生成、同时保留异步图片和 Gemini 缓存路径。详见 合并记录。

迁移与回退

新增 242_group_i18n.sql、243_gemini_cached_contents.sql、244_gemini_cached_contents_channel_usage.sql、245_gemini_cached_contents_mutation_lease.sql。旧 SQL 不改写,同编号不同文件名均保留。

新增 gateway.gemini_cached_content_max_ttl_seconds,默认 86400。第三方缓存上游必须支持绑定账号;Vertex API Key 不支持显式缓存或批量生图。缓存恢复通过数据库资源租约互斥,各节点须能访问对应上游。

本版包含真实计费变化,不能仅当作价格展示更新。回退旧程序前需处理未完成缓存修改、上游存储费用及新数据,不自动删表/列。正式上线仍需生产备份和迁移验收。

验证与范围

本地前端冻结安装、lint、typecheck、381 文件/2925 测试及构建通过;Go unit/full、普通/内嵌构建、模块校验通过。隔离 PostgreSQL/Redis 验证迁移、分组、路由、缓存修改租约和认证失效;未调用真实模型或支付。

用户已授权本次 CODEOWNER 审批例外,前提为两个 PR 最终 Backend/Frontend checks 均通过。生产副本迁移、恢复演练和多区域业务验收未执行;本 Release 不表示生产已部署。历史 usage-log 同步回退超时问题未宣称修复。

  • PR #27 → dev:最终 HEAD 3d591bddbf54e08f57112df6fc1099ddb0a85b69 的 CI 全通过;dev 合并 SHA ff95b8ced213eb092264f3c3d83d7b412fe99a4c。
  • PR #28 → main:最终 HEAD 为上述 dev SHA,CI 全通过。
  • 自动发行工作流 对应上述 main 发布提交。

产物

仅提供 Linux amd64:sub2api_0.2.16-hcai_linux_amd64.tar.gz、sub2api-linux-amd64.gz、checksums.txt、BUILD_INFO.txt。包内部分安装脚本默认地址仍指向上游,不用于自动覆盖 HCAI 生产。

发行及下载校验已完成:两份包均通过 checksums.txt 校验,解压后二进制经 cmp 确认完全一致,为 Linux x86-64 静态 ELF / Go 1.27.2。BUILD_INFO 的 version/tag/commit/target 与发布提交一致,构建时间为 2026-10-13T16:04:20Z。旧 v0.2.15-hcai 标签未移动。

  • tar.gz SHA-256:e19200b3ed6b52a58e364bb8ab501ce22604e16c48c92b3459e0702d356b7ec9
  • gzip SHA-256:0865ea08e7f177e19a1a36763fd3c30bc77c17c8987701dbb7df211c50b99fb5
  • 二进制 SHA-256:2b8fc65f369acdc6f097b9b6e214e7d3421bdcd2c7146a83a5853bcf867014a4

v0.2.15-hcai

Choose a tag to compare

@github-actions github-actions released this 13 Oct 04:02
e2118bc

同步上游 v0.2.15,保留 HCAI 全部已确认定制。版本:0.2.15-hcai;main 与标签提交:e2118bc2629754f796496d98ebcf86d5b3bf1332;上游:f2669c8cf62555cd92389b3f55920e9e6e7c6ff2。

新增上游 Cline、Command Code、动态平台目录与单请求输出 TPS;合入 WS 计费、模型发现/映射、协议转换和前端竞态修复。HCAI 首页/loading、插件管理与版本兼容、渠道展示价优先/双语、CC Switch、返利、企业微信、MinIO、多区域锁与租约及专用发行流程均保留。上游新增运维加载测试补齐 HCAI 企业微信读取/保存 mock,生产加载保护未放宽。

新增迁移 242_drop_platform_check_constraints.sql:移除两处数据库平台 CHECK,改由应用平台清单校验;历史迁移不改写。Go 1.27.2、Vue 3.5.43,并合入 source-map-js 安全约束。

生产恢复副本迁移、备份恢复、真实模型/支付验收未执行;既有用量日志同步超时未诊断或关闭。旧程序不理解新增平台数据,回退前必须评估数据兼容。Release 成功不等于部署放行;本次未部署生产节点。

产物仅 Linux amd64:tar.gz、单独 gzip 二进制、checksums.txt、BUILD_INFO.txt。上线前核对架构、SHA-256 和构建提交。包内 install.sh 与部分 compose 默认入口仍指向上游,不要直接用于覆盖 HCAI。历史标签与附件不覆盖。