额度监控与通知
订阅制的 AI 编程工具都有窗口限额：Claude 和 Codex 按 5 小时窗口和 7 天窗口算，Grok 按周或按月算。用完了会话会直接卡住，一眼就看得见；但"还剩多少""几点能再用"，以前只能靠自己隔一阵切过去试。
智码 AICoder 把额度搬进了软件：状态栏常驻显示当前账号的用量，后台盯着你所有账号的额度，到了该找你的时候主动找你 —— 额度恢复了、快用完了、登录凭据快过期了、AI 答完了，都会通知到你。
状态栏的额度胶囊
当前会话用的是订阅账号时，底部状态栏右侧会常驻几枚额度胶囊，形如 5h 29% 3h29m：窗口名 + 已用百分比 + 淡色的重置倒计时。倒计时每分钟自动走一格。
| 工具 | 显示 | 说明 |
|---|---|---|
| Claude Code | 5h + 7d 两枚 | 第二枚取 7 天窗口一族里最吃紧的那一维：7 天总额度、Opus 专属、Sonnet 专属哪个用得最多就显示哪个（显示为 7d / Opus / Sonnet） |
| Codex | 5h + 7d 两枚 | 5 小时窗口与每周窗口 |
| Grok | 一枚 | 订阅制显示周额度百分比（7d 42%），按量付费显示本月已用金额（月 $12.30） |
胶囊颜色随用量变化：
| 已用比例 | 颜色 |
|---|---|
| 低于 60% | 绿色，充足 |
| 60% – 85% | 黄色，留意 |
| 85% 以上 | 红色，吃紧 |
| 100% | 实心红底，这个窗口已经用完 |
取不到额度时，胶囊会换成一句状态提示，告诉你该不该动手：
| 胶囊显示 | 含义 | 怎么办 |
|---|---|---|
| 需重新登录 | 这个账号的登录凭据已失效 | 重新登录该账号 |
| 额度受限 | 当前网络出口被 Anthropic 拒绝，与账号本身无关 | 在「设置 → 网络」为 Claude Code 打开代理 |
| 额度 -- | 暂时没取到数据（网络抖动、查询太频繁被暂时拒绝、访问令牌待续期、新账号还没有用量），悬停可看具体原因 | 不用管，会自动重试或在下次启动会话时恢复；也可以在详情里点「刷新」 |
悬停看额度详情
鼠标停在胶囊上，弹出这个账号的完整额度：
- 账号与套餐 —— 顶部写明邮箱和套餐，切号之后能确认这组数字属于谁
- 已用完提示 —— 某个窗口用满时，最上方直接说结论，比如「5 小时窗口额度已用完 · 15:30 恢复 · 还有 2h 13m」；几个窗口同时用满会各列一行（它们的恢复时间可能差好几天），上游没给恢复时间时也会写明
- 各窗口进度条 —— 已用百分比 + 多久后重置；Claude 部分套餐（多为 Max）还会多出 Opus、Sonnet 专属窗口
- 其他账号（Claude）—— 开了后台额度监控后，下方列出你其他 Claude 账号各用了多少，不用切过去就知道哪个号还有余量；点「全部」可重新查询一遍
- 底部按钮 —— 「刷新」立即重新查询；另一个按钮直接跳到额度相关设置
Codex 的详情里还会标出数据是实时的还是历史快照（快照可能不准），并显示积分余额。账号有额度重置券时会列出每张券的到期时间，点「使用」可以立即重置当前限额窗口 —— 会先弹确认，券用掉不可撤销，当前没有需要重置的窗口时不会扣券。
概览页的用量限额卡片
打开生产力仪表盘的「概览」页，会看到「用量限额 · Claude」「用量限额 · Codex」两张卡片，内容与状态栏详情一致。卡片跟着页面顶部的 Claude / Codex / 全部切换走：选 Claude 只看 Claude，选「全部」两张都显示。纯 API Key 档案或未登录时没有订阅额度，对应卡片不显示。
配置档案上的额度标签
开了后台额度监控后，各工具设置页的配置档案列表里，每个被监控的账号档案行右侧会挂上额度标签（如 5h 12% 7d 64%），状态栏的档案切换浮层里也有一份迷你版。切号之前就能看出哪个号还剩多少，不必切过去才发现也满了。
| 标签 | 含义 |
|---|---|
| 百分比标签 | 各窗口已用比例，配色同状态栏；悬停看重置时间与数据是多久前更新的 |
| 需重新登录（红底） | 登录凭据已失效，要重新登录 |
| 待刷新（黄框） | 访问令牌过期了，但启动会话时 CLI 会自动续期，这个号通常照样能用 |
Claude Code 终端底部的额度显示
除了智码自己的状态栏，Claude Code 终端底部也能显示额度：在「设置 → Claude Code → CLI 工具」把「额度状态栏」切到「智码内置」，重启 Claude Code 后终端底部会显示当前目录、模型、5 小时 / 7 天额度和上下文占用。它按你用的厂商自动适配（Anthropic 订阅、智谱、Kimi Code、DeepSeek 等），按终端宽度自动收缩、不会换行；显示哪几段可以在「状态栏显示」里勾选。
如果你已经在用自己配置的状态栏，智码不会去改动它。
后台额度监控
状态栏只显示当前会话那一个账号，而且只在你开着会话时才更新。后台额度监控会在应用运行期间持续盯着你所有账号的额度，是「额度恢复了」这类通知的来源。
开关在「设置 → 通知」页的「额度监控与通知」卡片里。各工具的设置页里也有「额度监控与提醒」一行，点「去设置」直接跳过来。
| 设置项 | 说明 | 默认 |
|---|---|---|
| 开启后台监控 | 总开关 | 关 |
| 监控哪些工具 | 每家一个开关，按需打开 | — |
| 用量预警阈值（%） | 已用比例越过它就发「额度即将用完」，可设 50–99 | 85 |
| 通知哪些事件 | 额度恢复 / 额度预警 / 凭据将过期，各自可关 | 全开 |
支持的额度来源
| 额度来源 | 能监控哪些账号 |
|---|---|
| Claude Code | 当前登录账号 + 所有 Claude 账号档案，包括远程工作区里用的账号 |
| Kimi Code | 当前登录账号 + 所有 Kimi Code 档案 |
| MiniMax | 每个接入 MiniMax 的档案 |
| Codex | 仅当前登录账号 |
| Grok | 仅当前登录账号 |
| Antigravity | 仅当前登录账号 |
| OpenCode Go | 仅当前账号 |
后四家的额度数据跟着各自 CLI 的当前登录态走，只能看当前那一个，设置里会标「仅当前账号」。即便如此它依然有用：Codex 额度用完、你切去用 Claude 时，Codex 恢复了照样会有人告诉你。
账号列表怎么看
卡片下方的表格一行一个账号：
| 列 | 内容 |
|---|---|
| 监控 | 勾选决定要不要查这个账号。当前登录、但还没存成档案的账号始终纳入，不可取消 |
| 账号 | 工具标签 + 邮箱，当前登录的标「当前」，后面跟套餐名 |
| 额度 | 每项指标一枚胶囊。除百分比外还可能是「无限」「套餐未含」、余额或积分数；数字被划掉表示那是旧数据（凭据已失效，或窗口已经重置过、还没查到新一轮） |
| 状态 | 正常时显示「多久后再查」；异常时显示需重新登录、待刷新、出口 IP 受限、限流中、重试中等，悬停看原因和"现在显示的是多久之前的数据" |
右上角的刷新按钮可以立即把所有账号查一遍。
几个使用建议
- 只勾真正在用的号：所有账号共用同一份查询配额，已停用、留档的旧号取消勾选，正在用的那个才查得更勤。
- 让监控常驻：监控随应用运行。如果「关闭窗口时」设成了直接退出，关掉窗口监控也就停了；想让它一直盯着，把关闭行为设为最小化到系统托盘。
- 不必担心查得太频繁：查询节奏是自适应的 —— 窗口的重置时刻是已知的，监控会在那个时间点附近查一次，而不是固定间隔反复轮询。
- 同一账号只算一行：同一个账号在本机和远程工作区各有一个档案时合并成一行，因为额度属于账号、不属于机器。
撞到限额之后
| 场景 | 智码会做什么 |
|---|---|
| 会话撞了限额 | 会话停下后在侧边栏标成红色（悬停显示「撞了额度 / 限流」）；Claude / Codex / Grok 的状态栏额度详情顶部写明「已用完 · 几点恢复」 |
| 撞了限额但没开额度监控 | 右上角提示「开启额度监控，恢复时通知你」，可以一键「去开启」，也可以「不再提示」 |
| 开着额度监控与通知 | 这个账号会被记为"用满了"，窗口一重置就发「额度已恢复」通知 |
Claude 撞了 5 小时会话限额，且 Claude Code 提供 /limit-reset | 先问你要不要当场重置接着用 —— 代价是消耗每周额度、每周只能用一次；选「不重置」就按额度轮换的设置处理 |
| 准备了多个档案 | 可以开启额度用尽自动轮换，撞限额时自动换到下一个可用档案接着跑 |
额度守卫（Claude）
撞了限额再处理，往往已经晚了：新会话一开始要读入整个项目的上下文，额度快用完时开新会话，很容易做到一半被限额打断。额度守卫是在快撞限额之前替你把一道关：Claude 订阅账号的额度到了守卫线，新建会话、继续提问之前先问你一声。
开关在 设置 → Claude Code → 额度守卫（紧挨着「额度用尽自动轮换」上方）。卡片上会标出当前账号的套餐和已用比例。
守卫线
每种套餐有自己的线，5 小时窗口和 7 天窗口分开算，哪个窗口已用比例先到线就按哪个：
| 套餐 | 5 小时窗口 | 7 天窗口 |
|---|---|---|
| Pro | 85% | 85% |
| Max 5x | 90% | 90% |
| Max 20x | 95% | 95% |
| 未识别套餐 | 95% | 95% |
线可以逐档修改（50% – 99%），「恢复默认」一键还原。7 天窗口里 Opus / Sonnet 单独计量的部分也按 7 天这条线算，只在新会话用的正是那个模型时才算。
到线时会发生什么
| 场景 | 守卫做什么 |
|---|---|
| 新建会话 | 开了自动轮换：先换到一个没到线的订阅账号再建，已经在跑的会话不受影响。换不了才弹确认框：「暂不新建」（默认）、「仍要新建」（2 分钟内同一账号不再问）、在框里手动切换账号后重新判断，还可以勾「本次重置前不再提醒」 |
| 聊天模式里发消息 | 发送前先确认「仍要发送」；取消时输入框里的草稿原样保留。会话的第一句不问（新建时已经问过） |
| 终端模式里继续提问 | 这句话会被拦下，同时弹出「仍要继续」「先不发」「切换账号」。选「仍要继续」后，在终端里按 ↑ 调回这句、再回车即可发出，这个会话到窗口重置前不再拦 |
| 会话正在回答时到线 | 弹出汇总框，对每个正在回答的会话选「跑完这一轮」（默认）或「立即暂停」。暂停的会话对话都还在，重置后发「继续」就能接着做。开了自动轮换则先换号 |
| 排队中的消息 | 到线时排队的消息先扣住，会话上出现「继续发送」；额度恢复、换号后会重新判断，也可以随时手动放行 |
「本次重置前不再提醒」只对当前这个窗口管用：5 小时窗口点了不再提醒，之后 7 天窗口到线时还是会问。
AI 和手机端新建会话
- AI / 编排新建会话：AI 通过 MCP 新建 Claude 会话时，到线会被拦下，并提示 AI 先告诉你、别连续重试；桌面同时弹框，开了自动轮换会先换号，换不了就问你「允许」还是「先不要」。点「允许」后，到这个窗口重置前 AI 新建都不再被拦。不想拦 AI 的话，在卡片里关掉「拦截 AI 新建会话」
- 手机端：手机端 v0.9.2 起，新建会话和会话里继续发消息前同样先确认；需要桌面端 v6.2.1 及以上，旧版本不受影响，照常发送
- 主窗口不在前台时，到线和「AI 想新建被拦」各发一条系统通知（受桌面通知开关管）
和「额度用尽自动轮换」的分工
两者并存、各管一段：
| 额度守卫 | 轮换里的「预防式提前切换」 | |
|---|---|---|
| 在哪些账号之间换 | 只在订阅账号之间 | 所有参与轮换的档案，含 API Key 档案 |
| 会话会不会被重启 | 不会 | 换完会重启会话 |
| 定位 | 日常第一道关 | 订阅账号都到线之后的兜底 |
订阅账号都到线时，可以靠预防式提前切换切到 API Key 档案接着用。详见配置档案管理。
主动通知
两类通知，开关在两个地方
| 类别 | 包含的事件 | 本机桌面通知由谁控制 |
|---|---|---|
| 会话通知 | 回答完成、错误退出、等待输入 | 「设置 → 通用 → 通知」，默认开启 |
| 额度通知 | 额度已恢复、额度即将用完、凭据即将过期 | 「设置 → 通知」页顶部的「通知总开关」与「桌面弹窗」，两个都开着才弹 |
邮件和 Webhook 渠道统一受「通知总开关」控制（默认关闭）：打开总开关、添加渠道、在渠道里勾选要推送的事件，三步缺一不可。总开关关着时，渠道页底部会提示你"配了也不会真的发送"。
额度通知
| 事件 | 什么时候发 | 什么时候不发 |
|---|---|---|
| 额度已恢复 | 某个窗口重置、腾出了空间，而它之前用得很高（越过预警阈值，或你在会话里撞过限额） | 同一账号还有别的窗口卡在高位时先不报 —— 比如 5 小时窗口重置了，但 7 天窗口还剩 2%，这个号照样用不了；等它整体能用了再报 |
| 额度即将用完 | 已用比例第一次越过预警阈值，同一个窗口周期只提醒一次 | 刚撞过限额的账号不再补报"快满了"，你已经知道了 |
| 凭据即将过期 | 账号的登录凭据 3 天内就要到期 | 同一份凭据只提醒一次 |
额度类邮件和 Webhook 消息里，会把同一账号的每个窗口各列一行（用了多少、几时重置）。所以 5 小时窗口提醒"快满了"或"恢复了"时，你能顺带知道 7 天窗口还剩多少、什么时候重置。
凭据快过期怎么办
长期不用的账号没有机会自动续期，到期后只能重新登录。收到提醒后，用这个账号跑一次会话即可自动续上。
回答完成通知
AI 答完一轮，会弹出一条带正文的桌面通知：
- 标题：「回答完成 · 工具名」
- 正文：会话名、用时，以及这一轮回答的正文摘要 —— 不用切回来就知道它答了什么
- 报错的一轮：改发「错误退出」，正文是报错内容
- 没有回答的一轮不发：切模型（
/model）、执行斜杠命令、会话刚启动、MCP 重连这类没有 AI 回答的轮次，不会冒出一条空通知
终端模式与聊天模式都支持。每一轮只弹一次。
想要声音提醒，打开「设置 → 通用 → 完成提示音」：有叮咚、钟声、成功音、闹铃、气泡、水晶、梦幻、水滴 8 种音色，可调音量、可试听。提示音与系统通知共用「通知」这个主开关。
手机端（mobile-v0.8.0 及以上）的回复完成提醒用的是同一套判定，详见移动端使用教程。
什么时候不弹右下角通知
桌面通知是给"你不在软件前"的时候用的，下面这些情况不会弹：
| 情况 | 说明 |
|---|---|
| 你正在用智码 | 窗口在前台且没有最小化 —— 不管你看的是不是那个会话，标签上的状态已经看得见。切到别的应用、最小化或藏到托盘后才弹 |
| 这一轮太短 | 回答用时没超过「设置 → 通用 → 通知阈值」（默认 2 秒，可调 0.5 – 10 秒） |
| 开着桌宠 | 后台会话答完由桌宠提醒，系统通知让位，免得同一件事提醒两遍 |
| 同一会话刚弹过 | 同一个会话 30 秒内只弹一次 |
| 刚打开或切到这个会话 | 15 秒内不弹，那段输出多半是恢复会话时的回放 |
| 额度通知已经发了邮件 | 邮件成功送达就不再重复弹桌面通知；邮件没发出去时照弹，不会漏 |
以上规则只管本机桌面通知。邮件和 Webhook 渠道按各自订阅的事件推送，不受"你在不在软件前"影响。
等待输入
Codex 聊天模式里 AI 请求你审批、而那个标签又不在前台时，会推送一条「等待输入」。终端模式暂不发这条。
通知渠道
在「设置 → 通知」页，从上到下依次是：通知总开关、桌面弹窗、额度监控与通知、通知渠道。点「添加渠道」新建：
| 渠道 | 需要填写 | 新建时默认订阅的事件 |
|---|---|---|
| 桌面通知 | 不用配置：额度类看本页「桌面弹窗」开关，会话类看「设置 → 通用 → 通知」 | — |
| 邮件 | 发件邮箱 + 授权码；收件人留空就发给自己 | 额度已恢复、额度即将用完 |
| 钉钉群机器人 | Webhook 地址；启用了"加签"时填加签密钥 | 回答完成、错误退出 |
| 企业微信群机器人 | Webhook 地址 | 回答完成、错误退出 |
| 飞书群机器人 | Webhook 地址；启用了"签名校验"时填签名密钥 | 回答完成、错误退出 |
| Slack Incoming Webhook | Webhook 地址 | 回答完成、错误退出 |
| 通用 Webhook | 你自己的接收地址；可选签名密钥 | 回答完成、错误退出 |
邮件默认只订阅额度类事件，是因为它的场景是"人不在电脑前也要知道" —— 每答完一轮就发一封邮件属于骚扰。订阅哪些事件可以随时在渠道里改。
每个渠道是一张卡片，带启用开关和「测试」「编辑」「删除」按钮；编辑弹窗里的「发送测试消息」用表单里还没保存的内容直接试发，确认能收到再保存。
配置邮件通知
- 「添加渠道」，平台类型选「邮件（SMTP）」
- 填发件邮箱 —— 服务器会按邮箱域名自动识别，不用自己查地址
- 填授权码 —— 多数邮箱要先在邮箱设置里开启发信服务、生成专用授权码，它不是登录密码。识别出邮箱服务商后，表单下方会给出分步指引和「打开 xx 设置页」的链接
- 收件人留空就发给发件邮箱自己
- 点「发送测试消息」，收到测试邮件即配置成功
已收录的邮箱服务商包括 QQ 邮箱、163 邮箱、126 邮箱、Gmail、iCloud、Yahoo、新浪邮箱、搜狐邮箱、阿里邮箱、139 邮箱、yeah.net、天翼邮箱、Yandex、Mail.ru、Zoho、AOL、Fastmail、Naver 等。授权码在本地加密保存；编辑已有渠道时授权码一栏留空即保持不变。
注意
- Outlook 用不了：Outlook 已停用密码方式发信，授权码怎么填都连不上，表单会提前提示，建议换用其他邮箱。
- Gmail 的应用专用密码带空格显示，直接粘贴即可，空格会自动去掉。
- 未收录的邮箱会按常见规则猜测服务器地址；连不上的话，展开表单里的「服务器设置」改成你的邮箱服务商提供的真实地址。
会话停下来后按「怎么停的」上色
会话在后台停下、你还没切过去看时，侧边栏的会话标题、时间和小圆点会变色，标签栏的会话列表和「已完成会话」浮层里的圆点也同步着色。颜色区分的不是"停了没停"，而是怎么停的：
| 颜色 | 含义 | 包括哪些情况 |
|---|---|---|
| 黄色 | 正常答完，可以去看回复了 | 已回答完毕；答完了但还挂着后台命令没收 |
| 红色 | 出事了，需要你处理 | 这一轮失败没有产出、CLI 已退出只剩一个 shell、登录过期、撞了额度或被限流 |
| 蓝色 | 停在那儿等你给一下 | 停在确认菜单上等你按键、上下文吃紧在等一句「继续」 |
| 灰色 | 停了，但读不出是怎么停的 | 其余情况。宁可说"有变化"，也不谎报"已完成" |
鼠标悬停在标题或圆点上，会显示一句状态说明，比如「登录过期，需要重新登录」「停在确认菜单上，等你按键」。亮色主题下用的是同色系里深一档的颜色。
切过去看过之后标记自动消失。没看的标记跨重启保留（最多 7 天），应用意外崩溃重开后也不会丢 —— "哪个会话出事了"这条信息不会在重启时被抹平。
在此之前，登录过期、撞额度、报错、CLI 崩掉统统会被染成同一种"已完成"的黄色，切过去才发现根本没产出；现在一眼就能分出哪个是真答完了。