第三节 账号、用量与计费
[!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 兑换码与代金券
设置 → 账户 新增「兑换码」区块:
- 输入兑换码 → 点「兑换」。
- 结果就地反馈(成功 / 失效 / 已用过等 12 种情况都有明确的本地化提示)。
- 下方可查看「我的用量点券」列表:面额、有效期、永久券(明确标注「永久」)。
3.5 退出登录
设置 → 账号 → 登出。退出后本机会清除登录凭证与共享额度的访问能力,但本地工作区、会话、技能、设置全部保留,下次登录后无缝继续。
