OpenCode Quota 标志

在 OpenCode 和终端中查看配额、用量和 token。

npm npm downloads CI License: MIT

English | 简体中文 | 繁體中文 | Français | Deutsch | 日本語 | Español

OpenCode 中的 OpenCode Quota：侧边栏、配额窗口的 Usage 和 Limits 标签页，以及它的设置

--- ## 安装 ```bash opencode plugin add @slkiser/opencode-quota ``` 重启 OpenCode，然后输入 `/quota`。会打开一个显示你各项限额的窗口。点击标签页 Usage（用量）、Limits（限额）、Plugin（插件）或某个 Settings（设置）标签页，或按 `tab` 在它们之间切换；点击或按 `esc` 关闭窗口。 > [!IMPORTANT] > 需要 OpenCode `2.0.26+`；终端命令还需要 Node.js `22.13+` 或 `23.4+`。还在用 OpenCode 1？请改为运行 `npx @slkiser/opencode-quota@4 init`。
自己编辑 opencode.json 把插件添加到 `opencode.jsonc` 或 `opencode.json`，并保留你的其他插件。写在 `~/.config/opencode` 中对所有项目生效；写在某个项目的文件夹中则只对该项目生效。这一项同时加载服务端和 TUI： ```jsonc { "$schema": "https://opencode.ai/config.json", "plugin": ["@slkiser/opencode-quota"], } ```
## 功能 - **为 OpenCode 2 打造：** 设置实时生效，作用于每个打开的 OpenCode。 - **终端：** 即使 OpenCode 已关闭，`npx @slkiser/opencode-quota@latest show` 也能使用。 - **Web 和 Desktop：** `/quota`、`/quota_usage` 和 `/quota_status` 会把报告作为你的消息发到聊天中。AI 从不回复它，插件也会把它从每次 AI 请求中过滤掉。卸载插件后，过去聊天中的旧报告将不再被过滤。Web 的字体可能无法让各列对齐。 - **脚本和状态栏：** JSON、导出文件和指标。参见[外部集成](../external-integration.md)。 ## 命令 | 命令 | 显示内容 | | --- | --- | | `/quota` | 限额。Web 和 Desktop：限额与最近 7 天的用量并排显示 | | `/quota_usage [range]` | token 和 API 费用：`today`（默认）、`24h`、`7d`、`30d`、`90d`、`all`、`session`（含其子代理）、`between` 两个日期之间 | | `/quota_status` | 配置检查：登录、提供商、价格和提示 | | `/quota_settings` | 设置标签页（仅 TUI） | 例如 `/quota_usage 30d` 或 `/quota_usage between 2026-09-01 2026-09-25`。在终端中，无论 OpenCode 是否打开，`npx @slkiser/opencode-quota@latest show` 都会显示你的配额，`npx @slkiser/opencode-quota@latest status` 会检查你的配置（[两者的区别](../troubleshooting.md#terminal-commands)）。加上 `--help` 可查看所有选项。 ## 设置 在 `/quota_settings` 中修改侧边栏、状态行、toast 提示、颜色、措辞和提供商。**Save**（保存）只会把你改动的内容写入 OpenCode 配置文件夹中的 `opencode-quota/settings.jsonc`，并保留你的注释。编辑该文件后，几秒内就会生效到每个打开的 TUI。自定义提供商、Claude CLI 路径和导出路径只能在文件中设置。[设置和默认值](../configuration.md)。 ## 提供商 用 `/connect` 登录后，提供商就会出现。在 `/quota_settings` → **Providers** 中开启或关闭各个提供商。
| 美国 | 套餐 | | --- | --- | | [Anthropic (Claude)](../providers.md#anthropic-claude)\* | 个人 · 企业 | | [Cursor](../providers.md#cursor)\* | 个人 · 企业 | | [Gemini CLI](../providers.md#gemini-cli)\* | 企业 | | GitHub Copilot | 个人 · [企业](../providers.md#github-copilot)\* | | [Google AGY](../providers.md#google-agy-quick-setup)\* | 个人 · 企业 | | Ollama Cloud | 个人 | | OpenAI | 个人 · 企业 | | OpenCode Go | 个人 | | OpenCode Zen | 个人 · 企业 | | OpenRouter | 个人 · 企业 | | xAI | 个人 · 企业 | | 中国 | 套餐 | | --- | --- | | [Alibaba Coding Plan](../providers.md#alibaba-coding-plan)\* | 个人 | | [Alibaba Token Plan](../providers.md#alibaba-token-plan)\* | 个人 · 企业 | | DeepSeek | 个人 | | Kimi Code | 个人 · 企业 | | Kimi Code (CN) | 个人 · 企业 | | MiniMax Token Plan | 个人 · 企业 | | MiniMax Token Plan (CN) | 个人 · 企业 | | [Xiaomi MiMo](../providers.md#xiaomi-mimo)\* | 个人 | | Z.ai Coding Plan | 个人 | | Zhipu Coding Plan | 个人 · 企业 |
\* 带链接的名称还需要多做一步；其余的登录后即可使用。[每个提供商报告哪些内容](../providers.md#pre-configured-providers)。 OpenAI ChatGPT 配额需要 Codex 登录（[方法](../providers.md#openai-and-xai)）。Gemini CLI 仅适用于 Gemini Code Assist Standard 或 Enterprise（组织）账号。个人 Google 用户请使用 Google AGY。中国提供商的企业套餐只显示你自己的成员 API 密钥的用量，但 Alibaba Token Plan 会为每个团队席位显示一行 Credits。API 密钥来自 OpenCode 或[环境变量](../providers.md#api-keys)。 ### 自定义提供商 跟踪任何其他提供商，数据来自它的配额 API 或本地估算。让你的代理添加一个自定义提供商：它保存时处于关闭状态，你在 `/quota_settings` → **Providers** 中把它打开。[可复制粘贴的提示词](../providers.md#custom-providers)。 ## 更新 ```bash opencode plugin update ``` 重启 OpenCode。从 4.x 或 5.x 升级？你的设置会在首次启动时转换，旧的 `/tokens_*` 命令也仍然可用。参见[更新](../updating.md)。 ## 故障排查 1. 在 OpenCode 会话中运行 `/quota_status`，或在终端中运行 `npx @slkiser/opencode-quota@latest status`。 2. 缺少某个提供商？在 OpenCode 2 中重新登录它。 3. 在用配套插件（Cursor、Google）？在 `opencode.json` 中把它列在 `@slkiser/opencode-quota` **之前**。 4. 找不到 `claude` 或 `bl`？参见[服务环境](../troubleshooting.md#service-environment)。 5. `/quota_usage` 为空？先启动一次 OpenCode，然后使用一个模型。 更多解决方法：[故障排查](../troubleshooting.md)。 ## 参考 指南：[配置](../configuration.md) · [提供商](../providers.md) · [故障排查](../troubleshooting.md) · [外部集成](../external-integration.md) · [更新](../updating.md) 外部链接：[OpenCode 文档](https://opencode.ai/docs/) · [OpenCode 配置](https://opencode.ai/docs/config/) · [OpenCode 插件](https://opencode.ai/docs/plugins/) · [OpenCode TUI](https://opencode.ai/docs/tui/) · [models.dev 价格数据](https://models.dev/) · [Node.js 下载](https://nodejs.org/en/download) ## 贡献者 感谢每一位为 OpenCode Quota 做出贡献的人。 ## 许可证 MIT。OpenCode Quota 并非由 OpenCode 团队开发，与 OpenCode 或上面列出的任何提供商均无关联。