Files

问题：Token balance exhausted 被作为原始助手气泡展示，且额度确认可能跨会话复用。

修复：区分绝对余额与滚动额度，绑定当前会话失败 key，并补充真实消息结构与双会话回归测试。

2026-08-08 19:34:31 +08:00

Task: 诊断 Token balance exhausted 的错误呈现与请求行为

Identity

证实远端网关在 introspect 后以 balance=0 拒绝 authorize；本仓库不包含该 Python 网关或账本计算，客户端无法恢复真实额度。
证实本机 OpenCode 数据库中的三条失败均为无 parts 的 structured assistant error，原始文本此前被当作普通气泡渲染。
新增绝对 token-balance 判定，并仅对该类结构化错误显示中文友好文案。
当前会话的实时绝对余额错误直接打开升级提示，不再用滚动额度百分比错误地反证，也少发一次 token usage 请求。
历史错误仅做中文化，不会在充值后重进旧会话时再次弹窗；后台会话错误也不会绑定到当前会话。
额度确认和弹窗状态绑定具体 failure key，避免切换会话时沿用旧确认状态。
重复 token usage 请求的剩余来源是 Sidebar 的 stale 后立即刷新及 1.5 秒一致性复查；本次未扩大为全局请求去重重构。
README 无需更新：产品边界和架构未变化，本次为既有错误呈现修正。

RED：pnpm exec vitest run tests/unit/opencode-chat-panel.test.tsx -t "shows a subscription upgrade dialog instead of the raw quota error"，修复前 DOM 可见原始英文错误。
GREEN：7 个相关单测文件共 259 项通过，覆盖 ChatPanel、错误分类、消息归一化、store、token usage、AI proxy 与 Sidebar。
pnpm run typecheck 通过。
聚焦 ESLint 通过：4 个变更源码/测试文件无报错。
pnpm run build:vite 通过；仅保留既有 chunk 大小提示。
pnpm test 未全绿：与本次变更无文件交集的环境/基线失败可独立复现，包括系统缺少 zip、.opencode/agent 生成目录不存在，以及 project-progress-sync 的 3 个既有 watcher/调用次数断言失败。
未新增 Electron E2E：现有共享 fixture 无远端额度错误注入点；单测使用了本机 SQLite 中核对过的真实 structured message 形状。