Hotakus/opencode-visual-cache

解决的问题

OpenCode Visual Cache 是 OpenCode 的 TUI（终端用户界面）插件，提供 LLM 令牌缓存的实时可视化。它帮助用户监控缓存命中率、令牌使用详情，以及由提示缓存产生的相关成本和节省，这些信息在标准终端界面中通常对用户不可见。

工作原理

该插件与 OpenCode SDK 集成，从 AI 提供商获取实时令牌数据和定价信息。它使用行业标准公式计算缓存命中率，并在可折叠的侧边栏面板和可选的底部状态栏中显示这些数据。它还基于字符数估算不同角色（系统、用户、子代理、工具）之间的令牌分布，以提供令牌消耗情况的分解。

适用人群

希望追踪 API 成本、优化提示缓存效率，并实时监控其会话和子代理的令牌足迹的 OpenCode 开发者和高级用户。

主要亮点

• 实时缓存监控：使用颜色编码的进度条显示缓存命中率（绿色 ≥85%，橙色 ≥70%，红色 <70%）。
• 成本追踪：计算会话累计成本及缓存带来的节省金额，支持多种货币和自定义汇率。
• 详细的令牌分解：追踪缓存读取、写入、未命中和输出令牌，并提供按角色的估算分布。
• uma Balance 集成：从多个 AI 提供商（如 DeepSeek、SiliconFlow、OpenRouter、Moonshot）查询账户余额，并支持自动切换提供方。
• 子代理支持：允许用户切换视图，监控会话中特定子代理的缓存统计信息。
• 可自定义 UI：支持可折叠面板、多语言支持（中文、英文、日文、韩文），以及可配置的底部状态栏。