第三节 账号、用量与计费
[!ref] 新手教程：首次登录的分步引导见快速上手指南「安装与登录」节；本节详解各登录方式、额度与用量计费机制。
AVL Code 推荐通过统一管理后台完成登录，登录这一步会自动为本机分配一份套餐额度，无需手动配置 API Key。
3.1 登录方式
账户页未登录区分两段切换：手机登录（默认）| 密码登录。
| 方式 | 流程 |
|---|---|
| 手机号验证码（默认，最快） | 输入手机号 → 收短信验证码 → 输入验证码登录。没有账号会自动注册，无需单独走注册流程。验证码 60 秒重发倒计时；触发风控时自动切出图形验证码（点图可刷新） |
| 用户名 + 密码 | 设置 → 账号 → 密码登录 tab → 输入账号密码 → 提交 |
| SSO 单点登录 | 设置 → 账号 → SSO 登录，自动打开浏览器完成认证，回跳后桌面端自动接收凭证 |
三种方式得到的额度完全等价（取 key、状态同步一致），体验差异只在登录环节本身。
3.2 套餐额度与个人额度
登录成功后，账号即带有一份套餐额度。套餐额度按周期计量（5 小时与 7 天两级窗口），周期内用尽会提示「套餐额度已用尽」，等周期恢复后即可继续；购买用量点券不受套餐限额。当前套餐与可用点数显示在 设置 → 账号 面板上。
如果你希望使用自有的模型 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 种情况都有明确的本地化提示）。
- 下方可查看「我的用量点券」列表：面额、有效期、永久券（明确标注「永久」）。
[!note] 账号面板上的「可用点数」直接取服务端的展示口径，与网页端账户页显示的数字一致；客户端不再自行把券列表相加，因此不会出现「面板数字和网页对不上」的情况。
3.4.2 用量不足时一键去买
点数不足 / 套餐周期额度用尽时，不必自己去翻网页找入口 —— 界面会就地给出去处：
| 位置 | 你会看到 |
|---|---|
| 对话里的报错块 | 当这一轮失败的原因是「余额不足」或「周期额度已用尽」时，错误块下方直接出现「购买点券」「升级 · 订阅套餐」两个按钮（限流、鉴权、上游故障等其它错误不会挂这两个按钮 —— 花钱也修不好） |
| 消息流里的低余额预警 | 使用内置 AVL-Zero 时，可用点数低于 50 会在本会话最新一条回复下方给出一行预警「AVL Zero 可用点数仅剩 §xx.xx，即将用尽」，附「购买点券」「升级 · 订阅套餐」两个按钮；已显示用量不足报错的那条、正在输出时、余额未知时都不重复提示 |
| 设置 → 账号 · 账号卡 | 余额旁常驻「购买点券」入口，看到余额的那一刻就能补充；账号卡的余额行固定单行显示，余额未知时也不会折成两行 |
| 设置 → 账号 · 用量区 | 「购买点券」「升级 · 订阅套餐」两个按钮 |
| 版本过期锁屏 | 同样给出这两个入口 |
点击后先在应用内弹出选档框（「选一档，在浏览器里确认并付款」），选好档位后在系统默认浏览器里直接打开该档的「确认购买」页完成支付，少一步中转；需要联系销售的套餐会转到订阅套餐页，框底的「去服务页面」则打开完整的购券 / 订阅页。之所以不在应用内嵌二维码，是因为支付链接本身过长、生成的二维码密度太高，真机扫码识别率差；交给浏览器反而最稳。
落点跟随你配置的账号服务地址，自建部署同样正确。
3.5 退出登录
设置 → 账号 → 登出。退出后本机会清除登录凭证与套餐额度的访问能力，但本地工作区、会话、技能、设置全部保留，下次登录后无缝继续。