v0.7.11 · Sub2API 扩展系统

[0.7.11] - 2026-09-16

修复

• OAuth 合并计费只需组内一个账号明确设置采购成本；未设置的成员继承该组成本，全组未设置时才使用全局默认值。多个明确成本不一致时仍拒绝保存，明确填写的零金额也参与校验。
• 消费核算从完整组配置读取采购成本，即使设置成本的成员在查询区间没有调用，也不会错误使用其他成员的默认值；同组采购成本仍只计一次。
• 单账号保存与合并计费失败使用与成功反馈相同的右上角通知组件，以 error 类型显示中文成本冲突提示，保留编辑内容以便重试。

兼容性与升级

• 本次为问题修复，无独立新增功能、破坏性接口变化、数据库结构或环境变量变化，无需迁移。
• 更新至 v0.7.11 后检查 /health，刷新成本配置与消费核算页面，确认只设置一个 OAuth 成本时可以合并，成本冲突时显示右上角错误通知。
• 配置仍保留各账号的原始成本和空值，不批量回填。可回退至 v0.7.10，但会恢复按有效成本比较的限制，只有部分成员填写成本的组可能重新报错或按默认值核算。

已知限制

• 同组多个账号明确设置成本时仍须保持金额一致，修改共享采购价时需同步调整这些明确值，或清空其他成员的成本以继承组内唯一金额。

镜像与更新

• 应用镜像：ghcr.io/fluxcode666/sub2api-extension:v0.7.11
• 二进制更新包：linux/amd64、linux/arm64，附带 checksums.txt。
• 本次发布不连接服务器、不自动部署；管理员可点击控制台左上角版本号更新。
• 更新由应用进程下载并原子替换，完成后按部署方式重启服务。
• 首次安装或更新，请查看 更新指南。
• 更新前备份数据库和上传资源；二进制回退不会撤销数据库迁移。

v0.7.10 · Sub2API 扩展系统

[0.7.10] - 2026-09-15

修复

• 成本配置的合并计费账号下拉改为每页加载 10 个匹配账号，滚动到底部自动追加下一页；搜索仍覆盖全部账号并保留跨搜索多选，避免大量账号同时挂载造成卡顿。
• 修复合并计费可选账号误显示禁止选择光标的问题，禁用样式只匹配真正禁用的选项。
• 修复合并账号下拉的滚轮被外层弹窗拦截的问题，使用 Radix 模态 Popover 保留列表滚动和关闭后的焦点恢复。
• OAuth 回本分析在未填写账号过期时间时，自动读取 Sub2API 已保存的订阅到期时间；影子账号可使用母账号订阅日期，仍优先采用管理员手填期限。
• 未获取到有效期限时显示“未获取到”，不再将未知状态标为“永不过期”。只提取订阅日期，不读取完整凭据或使用 token 的过期时间；非法日期不阻断账号同步。

兼容性与升级

• 账号下拉修复仅涉及前端，更新后刷新成本配置页即可；回退旧版本会恢复全量渲染和光标误判，已保存的合并计费配置不受影响。
• 无数据库结构、接口字段或环境变量变化，无需额外迁移；兼容缺少相关字段的旧版 Sub2API。
• 升级后等待启动/定时同步（默认 5 分钟），或在成本配置页点击“立即同步倍率”，再刷新消费核算。回退后重新同步将恢复仅使用手填期限的行为，已有成本与合并计费配置保持兼容。

已知限制

• 成本配置接口仍返回完整账号列表；下拉按 10 条分页加载，匹配账号较多时需要继续滚动或搜索缩小范围。
• 自动日期依赖 Sub2API 已成功获取并保存订阅信息；附属系统不会自行向账号供应商发起查询，消费核算使用最近成功同步的快照。

镜像与更新

• 应用镜像：ghcr.io/fluxcode666/sub2api-extension:v0.7.10
• 二进制更新包：linux/amd64、linux/arm64，附带 checksums.txt。
• 本次发布不连接服务器、不自动部署；管理员可点击控制台左上角版本号更新。
• 更新由应用进程下载并原子替换，完成后按部署方式重启服务。
• 首次安装或更新，请查看 更新指南。
• 更新前备份数据库和上传资源；二进制回退不会撤销数据库迁移。

v0.7.9 · Sub2API 扩展系统

[0.7.9] - 2026-09-14

修复

• 修复 v0.7.8 打开或刷新成本配置页时因全量逐账号同步、等待同步锁而触发 15 秒超时的问题。页面现在只读获取 Sub2API 账号列表并合并已有成本，新建且无使用记录的账号仍会立即展示。
• 保存独立成本或合并计费组时仅同步所选账号，处理与后台同步同时首次建档的冲突；保留原有 OAuth 采购价、API 手工倍率及计费组，保存后未建档账号仍保持可见。
• 请求超时显示“请求超时，请稍后重试”，保留调用方主动取消行为；首次加载失败提供重新加载入口，不再把默认费用与零账号展示为实际数据。

兼容性与升级

• 无新增功能、破坏性接口变化、数据库结构或环境变量变化，无需额外迁移；API 响应字段保持兼容。
• 更新至 v0.7.9 后检查 /health，刷新成本配置页，验证未使用账号的成本保存及合并计费。已保存数据可供旧版本读取；回退 v0.7.8 会恢复本次修复的加载超时风险。

已知限制

• 页面仍读取完整账号列表并在前端分页，需要可用的 Sub2API 数据库连接。手工和后台全量同步仍逐账号持久化，大量账号或数据库缓慢时手工同步仍可能超时，但不再阻塞页面加载。
• 已在隔离 PostgreSQL、真实 HTTP 与浏览器中使用 1,500 个账号和每次数据库操作 6 毫秒延迟复现并验证；未在生产数据库执行压测。

镜像与更新

• 应用镜像：ghcr.io/fluxcode666/sub2api-extension:v0.7.9
• 二进制更新包：linux/amd64、linux/arm64，附带 checksums.txt。
• 本次发布不连接服务器、不自动部署；管理员可点击控制台左上角版本号更新。
• 更新由应用进程下载并原子替换，完成后按部署方式重启服务。
• 首次安装或更新，请查看 更新指南。
• 更新前备份数据库和上传资源；二进制回退不会撤销数据库迁移。

v0.7.8 · Sub2API 扩展系统

[0.7.8] - 2026-09-14

修复

• 「账号独立成本与合并计费」在打开或刷新页面时自动读取 Sub2API accounts 列表，无使用记录的新账号也能立即配置独立成本和合并计费，无需等待定时同步或手工同步。
• 刷新账号时保留已保存的 OAuth 采购价、API 手工倍率与计费组；页面读取、手工同步和定时同步在同一服务实例内串行执行，避免新账号重复建档冲突。

兼容性与升级

• 无数据库结构、响应字段或环境变量变化，无需额外迁移；更新后刷新成本配置页即可。未配置 Sub2API 数据库时仍可读取已有本地配置；配置了账号来源后，读取失败会显示错误，不能视作空账号列表。
• 更新后检查 /health，并在成本配置页确认新建且无使用记录的账号可以展示和保存配置；回退至 v0.7.7 可继续使用已保存的账号成本配置，账号列表恢复为手工或定时同步后更新。

已知限制

• 自动获取账号需要可用的 Sub2API 数据库连接；同步串行化仅覆盖同一服务实例，多实例部署仍需关注同步重叠。

镜像与更新

• 应用镜像：ghcr.io/fluxcode666/sub2api-extension:v0.7.8
• 二进制更新包：linux/amd64、linux/arm64，附带 checksums.txt。
• 本次发布不连接服务器、不自动部署；管理员可点击控制台左上角版本号更新。
• 更新由应用进程下载并原子替换，完成后按部署方式重启服务。
• 首次安装或更新，请查看 更新指南。
• 更新前备份数据库和上传资源；二进制回退不会撤销数据库迁移。

v0.7.7 · Sub2API 扩展系统

[0.7.7] - 2026-09-14

新增

• 「OAuth 回本分析」和「账号成本明细」默认按账号创建时间倒序排列，支持点击账号创建时间、收入、利润或请求数表头切换正序与倒序；每个表格独立维护单列排序，切换排序后回到第一页。
• 「OAuth 回本分析」增加请求数和利润列；OAuth 利润按 OAuth 收入减采购成本、再减该收入对应税额计算，不混入合并计费组中的 API 收入与成本。

兼容性与升级

• 排序与 OAuth 利润展示均在前端基于现有响应字段完成，无数据库结构、API 或配置变化；升级后刷新消费核算页即可使用，回退至 v0.7.6 不影响历史数据。

镜像与更新

• 应用镜像：ghcr.io/fluxcode666/sub2api-extension:v0.7.7
• 二进制更新包：linux/amd64、linux/arm64，附带 checksums.txt。
• 本次发布不连接服务器、不自动部署；管理员可点击控制台左上角版本号更新。
• 更新由应用进程下载并原子替换，完成后按部署方式重启服务。
• 首次安装或更新，请查看 更新指南。
• 更新前备份数据库和上传资源；二进制回退不会撤销数据库迁移。

v0.7.6 · Sub2API 扩展系统

[0.7.6] - 2026-09-13

改进

• 优化成本配置页筛选布局、表格密度、列宽与移动端适配，提升账号成本配置操作的可读性。

修复

• OAuth 单号成本未配置时，输入框显示“未配置”提示。
• 成本配置页所有数字输入框移除上下增减控件，保留数字输入和校验能力。

兼容性

• 无数据库结构、API 或配置变化。

镜像与更新

• 应用镜像：ghcr.io/fluxcode666/sub2api-extension:v0.7.6
• 二进制更新包：linux/amd64、linux/arm64，附带 checksums.txt。
• 本次发布不连接服务器、不自动部署；管理员可点击控制台左上角版本号更新。
• 更新由应用进程下载并原子替换，完成后按部署方式重启服务。
• 首次安装或更新，请查看 更新指南。
• 更新前备份数据库和上传资源；二进制回退不会撤销数据库迁移。

v0.7.4 · Sub2API 扩展系统

[0.7.4] - 2026-09-13

变更

• 将 OAuth 回本分析中的“用户计费”统一改为“收入”，并同步调整汇总文案。

镜像与更新

• 应用镜像：ghcr.io/fluxcode666/sub2api-extension:v0.7.4
• 二进制更新包：linux/amd64、linux/arm64，附带 checksums.txt。
• 本次发布不连接服务器、不自动部署；管理员可点击控制台左上角版本号更新。
• 更新由应用进程下载并原子替换，完成后按部署方式重启服务。
• 首次安装或更新，请查看 更新指南。
• 更新前备份数据库和上传资源；二进制回退不会撤销数据库迁移。

v0.7.3 · Sub2API 扩展系统

[0.7.3] - 2026-09-13

修复

• 修复消费核算收入取数字段：识别 Sub2API usage_logs.actual_cost 作为用户实际扣费，恢复 API 收入、毛利、税额、税后利润及 OAuth 回本数据；账号成本仍使用 total_cost / account_stats_cost 与账号倍率计算。
• 修复上海日期选择器在 UTC 容器中发生日期偏移的问题；无时区日期按 Asia/Shanghai 解析，与每日分组口径一致。
• 修复混合计费组的 OAuth 回本统计误把 API 收入计入回本进度，增加 API/OAuth 分项收入字段。
• 移除账号成本明细中的倍率/核算口径列，避免展示已取消的统计口径。

兼容性

• 账号明细响应新增 api_revenue 与 oauth_revenue 字段，旧客户端可忽略；无需数据库迁移。

镜像与更新

• 应用镜像：ghcr.io/fluxcode666/sub2api-extension:v0.7.3
• 二进制更新包：linux/amd64、linux/arm64，附带 checksums.txt。
• 本次发布不连接服务器、不自动部署；管理员可点击控制台左上角版本号更新。
• 更新由应用进程下载并原子替换，完成后按部署方式重启服务。
• 首次安装或更新，请查看 更新指南。
• 更新前备份数据库和上传资源；二进制回退不会撤销数据库迁移。

v0.7.2 · Sub2API 扩展系统

[0.7.2] - 2026-09-13

修复

• 优化消费核算：当 Sub2API usage_logs 没有明确收费字段时，不再把实际成本冒充收入，也不再展示虚假的毛利、税额和利润率。
• 无收入字段时页面切换为 API 用量与成本监控，账号明细聚焦请求数、Token、API 成本、OAuth 一次性采购成本及账号倍率；每日明细仍保留 API 利润列，但以不可用占位显示。
• 每日明细增加 API / OAuth 账号类型切换，按日期汇总展示；OAuth Tab 仅展示当天利润（用户计费），另增 OAuth 回本分析板块展示账号级回本数据，不在每日明细中展示无法可靠核算的成本和回本进度列；API Tab 固定展示 API 收入，移除倍率/口径列，收入可用时展示毛利、税额、税后利润和利润率，并为四个利润指标增加公式提示。
• 账号成本明细新增账号类型和平台筛选，保留账号名/计费组搜索与创建时间范围筛选；表格明确展示收入、毛利、税额和利润列，无明确收费字段时以不可用占位显示。
• 日期筛选改为单入口范围日历，支持桌面双月、移动端单月和清除范围。
• OAuth 回本分析增加账号创建时间和过期时间；过期时间同时显示剩余天数，永不过期账号显示“永不过期”。
• 消费核算页移除 API 账号成本走势图和核算口径区域，保留消费概览、每日明细、OAuth 回本分析和账号成本明细；账号名称与账号 ID 分行展示并增加间距。

兼容性与升级

• 新增响应字段 revenue_available、revenue_source、api_account_count 和 daily_accounts，旧客户端可忽略。
• 附属库 account_cost_configs 新增可空列 account_expires_at，由同步读取 Sub2API accounts.expires_at 写入；设置 AUTO_MIGRATE=false 的部署需先执行 make migrate，旧客户端可忽略新增响应字段 account_expires_at。

镜像与更新

• 应用镜像：ghcr.io/fluxcode666/sub2api-extension:v0.7.2
• 二进制更新包：linux/amd64、linux/arm64，附带 checksums.txt。
• 本次发布不连接服务器、不自动部署；管理员可点击控制台左上角版本号更新。
• 更新由应用进程下载并原子替换，完成后按部署方式重启服务。
• 首次安装或更新，请查看 更新指南。
• 更新前备份数据库和上传资源；二进制回退不会撤销数据库迁移。

v0.7.1 · Sub2API 扩展系统

[v0.7.1] - 2026-09-12

修复

• 修复 Sub2API 菜单被手动删除或重复创建后，扩展系统入口无法可靠恢复的问题；统一重建管理员菜单项并补齐 iframe 所需的空 page_slug。
• 将管理员菜单名称固定为“扩展系统↗”，避免与可配置的站点名称混淆。

兼容性与升级

• 无数据库结构变化；升级后重新保存系统配置中的“上架到 Sub2API”开关即可重建菜单。

镜像与更新

• 应用镜像：ghcr.io/fluxcode666/sub2api-extension:v0.7.1
• 二进制更新包：linux/amd64、linux/arm64，附带 checksums.txt。
• 本次发布不连接服务器、不自动部署；管理员可点击控制台左上角版本号更新。
• 更新由应用进程下载并原子替换，完成后按部署方式重启服务。
• 首次安装或更新，请查看 更新指南。
• 更新前备份数据库和上传资源；二进制回退不会撤销数据库迁移。