Skip to content

v2.1.8 · 密钥累计用量与有效期

Choose a tag to compare

View all tags
@github-actions github-actions released this 20 Sep 04:21
· 11 commits to master since this release
v2.1.8
224e521

新增：密钥列表显示累计用量，密钥可设有效期

密钥列表此前看不到任何消耗，管理员没法判断哪把密钥在实际使用；而且每把密钥都是永久有效，
发出去的短期试用密钥也只能靠手动删除来收回。

密钥页新增两列：

  • 总用量：显示该密钥累计的 token 数（输入 + 输出），数据来自用量账本。账本是独立
    文件，面板在返回密钥列表时一并合并，浏览器不需要再多拉一次接口；账本不可用时该列显示
    0，密钥列表照常加载。
  • 有效期：显示「无限制」/「N 天后到期」/「已过期」。创建或编辑密钥时可以选择
    7 / 30 / 90 天、1 年或自定义时间，留空表示无限制。

既有密钥和新建密钥的默认都是无限制，这次升级不会给任何密钥加上到期时间，也不需要
迁移：密钥文件里没有 expires_at 字段就等于永久有效。到期后该密钥立即失效，网关返回
api_key_expired 而不是笼统的 invalid_api_key，调用方能区分「密钥过期」和「密钥不对」；
在管理台重新设置有效期即可继续使用。

有效期只影响鉴权，不改变密钥的启停、模型白名单或用量记录。修改时会拒绝过去的时间、
超过十年的时间和格式错误的值；只改名称时不会顺手清掉已设的有效期。

部署

本次同时更新网关与管理台，两者的镜像标签都是 v2.1.8。

cd /opt/workbuddy2api
sudo docker compose pull
sudo docker compose up -d

已知边界

  • 「总用量」是账本累计值，与用量统计页口径一致；它不按密钥的有效期或日期过滤。
  • 有效期按网关时间判定，没有提前提醒；到期后需要管理员手动续期。
  • 删除密钥不会删除账本里该密钥的历史用量记录。
Assets 5
Loading