第三节 账号、用量与计费

[!ref] 新手教程:首次登录的分步引导见快速上手指南「安装与登录」节;本节详解各登录方式、额度与用量计费机制。

AVL Code 推荐通过统一管理后台完成登录,登录这一步会自动为本机分配一份共享额度,无需手动配置 API Key

3.1 登录方式

账户页未登录区分两段切换:手机登录(默认)| 密码登录

方式 流程
手机号验证码(默认,最快) 输入手机号 → 收短信验证码 → 输入验证码登录。没有账号会自动注册,无需单独走注册流程。验证码 60 秒重发倒计时;触发风控时自动切出图形验证码(点图可刷新)
用户名 + 密码 设置 → 账号 → 密码登录 tab → 输入账号密码 → 提交
SSO 单点登录 设置 → 账号 → SSO 登录,自动打开浏览器完成认证,回跳后桌面端自动接收凭证

三种方式得到的额度完全等价(取 key、状态同步一致),体验差异只在登录环节本身。

3.2 共享额度与个人额度

登录成功后,系统会自动为你分配一份共享额度。共享额度由组织统一管理、统一计费,个人无需关心余额;如果组织设有个人配额,会显示在 设置 → 账号 的点数余额面板上。

如果你希望使用自有的模型 API Key(例如个人订阅的 OpenAI / Anthropic / 阿里云模型服务),可以在 设置 → 模型 里添加,AVL Code 会优先使用你自己配置的 Key,自动回退到共享额度作为兜底。

3.3 用量监控

设置 → 账号 面板自动展示三档用量统计:

  • 24 小时
  • 7 天
  • 30 天

每分钟刷新一次;如果你触发了某些异常,例如短时间内大量调用,点数余额面板上会以提示色高亮,方便定位异常。

3.3.1 配额提示按用量 / 重置时间分层

配额耗尽前的提示不再只有一档,而是按「当前用量百分比 + 距离重置时间」分层显示:

  • 轻量提示:用量未紧、距重置还远 → 仅状态点变色,不打扰。
  • 中度提示:用量近上限或重置时间即将到来 → 输入框上方信息条提示,可直接看到「剩余 N 点 · 还有 M 分钟重置」。
  • 强提示:用量已近耗尽且重置仍远 → 横幅 / 卡片提示,附建议(切换备用 Provider / 续兑换码)。

提示文案会把重置时间用本地时区直观展示(如「今天 18:00 重置」),不再只说「即将耗尽」。

3.4 凭证过期

登录凭证有效期约 24 小时。

  • 离过期不到 1 小时时,左侧栏状态点变为琥珀色。
  • 过期后下一次操作会弹出"登录已过期"提示并自动跳到登录页。
  • 重新登录不会丢失会话或配置。

3.4.1 兑换码与代金券

设置 → 账户 新增「兑换码」区块:

  1. 输入兑换码 → 点「兑换」。
  2. 结果就地反馈(成功 / 失效 / 已用过等 12 种情况都有明确的本地化提示)。
  3. 下方可查看「我的用量点券」列表:面额、有效期、永久券(明确标注「永久」)。

3.5 退出登录

设置 → 账号 → 登出。退出后本机会清除登录凭证与共享额度的访问能力,但本地工作区、会话、技能、设置全部保留,下次登录后无缝继续。