Skip to content

feat(admin): 账号用量窗口 5h/7d 增加说明 tooltip#2895

Open
wucm667 wants to merge 1 commit into
Wei-Shaw:mainfrom
wucm667:feat/usage-window-tooltip
Open

feat(admin): 账号用量窗口 5h/7d 增加说明 tooltip#2895
wucm667 wants to merge 1 commit into
Wei-Shaw:mainfrom
wucm667:feat/usage-window-tooltip

Conversation

@wucm667
Copy link
Copy Markdown
Contributor

@wucm667 wucm667 commented May 29, 2026

背景

账号管理列表的"用量窗口"列会展示 5h / 7d(OAuth 账号还有 7d S)进度条。不少用户看到后不理解它的含义,反复来问:这是什么限制、在哪里配置、能不能解除(见 #2887)。评论区其他用户已经给出过解答——这是上游账号(如 OpenAI ChatGPT)自身的官方滚动用量窗口限制,由上游对账号设定,不是 sub2api 配的,也跟映射的模型无关,无法在 sub2api 端解除。本 PR 把这条解释直接做成 UI 提示,避免重复答疑。

改动

  • AccountsView.vue 的"用量窗口"列表头新增一个说明性 HelpTooltip(ⓘ 图标,hover 展开):
    • 复用项目已有的 @/components/common/HelpTooltip.vue未引入任何新依赖;该组件 teleport 到 body,可避免表格容器 overflow 裁剪。
    • 图标只在列表头放一个,不在每行重复,避免列表拥挤。
  • 新增 i18n key admin.accounts.usageWindowsHintzh.ts / en.ts 同步),文案说明:
    • 5h / 7d 是上游账号(如 OpenAI ChatGPT、Claude)官方的滚动用量窗口限制,由上游对账号设定,并非 sub2api 配置,也与映射的模型无关;
    • 窗口滚动到期后用量自动重置,无法在 sub2api 端解除该限制。
  • 纯展示说明:不改动 5h/7d 用量计算与任何后端逻辑,未触碰 Antigravity 专用的 usageWindow.* i18n 块。

测试

均在 frontend/ 下执行:

  • pnpm typecheck ✅ 通过
  • pnpm lint:check ✅ 通过
  • pnpm build ✅ 通过
  • pnpm test:run:新增 AccountsView.usageWindowsHint.spec.ts ✅ 通过(断言列表头同时渲染列名与 usageWindowsHint 提示文案)。
    • 说明:AccountUsageCell.spec.ts 中有 6 条用例失败,但这是 upstream/main 上既有的失败getUsage 调用参数匹配相关),已通过 git stash 在干净的 upstream/main 上复现确认,与本次改动无关,本 PR 未触碰该组件。

pnpm-lock.yaml 无变动。纯前端改动,无需跑后端测试。

Fixes #2887

在账号管理列表"用量窗口"列表头增加一个说明性 HelpTooltip,
解释 5h / 7d 是上游账号(如 OpenAI ChatGPT、Claude)官方的滚动
用量窗口限制,由上游设定、非 sub2api 配置、与映射模型无关,且
窗口滚动到期后自动重置、无法在 sub2api 端解除。

复用现有 HelpTooltip 组件(teleport 到 body,避免表格裁剪),
单个 ⓘ 图标置于列表头,避免每行重复。新增 i18n key
admin.accounts.usageWindowsHint(zh/en 同步)。纯展示说明,
不改用量计算与后端逻辑。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

用量窗口 5h 7d 是什么意思啊

1 participant