火山方舟助手
在 VSCode 状态栏实时查看你的 火山方舟(Volcano Ark) Coding Plan / Agent Plan 用量 —— 会话、周、月额度一目了然,告别超额焦虑。
火山引擎|Volcengine|Volcano Ark|方舟 Coding Plan|Agent Plan|用量查询|额度监控|配额管理|AI 编程助手|GLM|DeepSeek|Doubao|MiniMax|大模型 API 用量|LLM 用量|Token 额度|VSCode 插件|状态栏用量|订阅管理|arkcli


✨ 功能
- 状态栏实时展示:形如
🟢32.3% 🟢6.0% 🟢3.0%,一眼掌握会话 / 周 / 月三个周期用量,还可显示当前使用的模型名称。
- 悬停提示:鼠标悬停状态栏即可查看各周期重置时间与倒计时(如「6 天后重置」)。
- 详情面板:点击状态栏打开侧边栏,通过进度条、百分比和实时倒计时直观呈现用量全貌。
- 一键切换模型:在 Coding Plan 支持的模型之间快速切换,无需跳转控制台。
- 自动刷新:默认每 5 分钟后台更新一次,间隔可自定义;倒计时本地实时更新,不产生额外请求。
- 智能颜色预警:
- 统一标准:按阈值变色(默认 < 70% 绿色、70–90% 橙色、≥ 90% 红色),阈值可调。
- 智能计算:结合每日额度综合判断,超日标准优先警示。
- 文案格式自由定制:提供「默认」「极简」「自定义」三种模式,自定义支持
{s_color}、{s_pct}、{w_color}、{w_pct}、{m_color}、{m_pct} 等变量,按需组合状态栏展示内容。
- 多套餐支持:同时兼容 Coding Plan 与 Agent Plan。
🚀 快速开始
- 在 VSCode 扩展市场搜索「火山方舟助手」并安装。
- 按下方说明配置火山引擎 AK/SK。
- 安装完成后,状态栏将自动出现用量指示器,即刻生效。
🔑 配置 AK/SK
插件通过火山引擎官方接口查询您的套餐用量,需要提供火山引擎账号的 AK/SK 进行身份验证。支持两种配置方式:
- VSCode 设置(推荐):打开设置(
Ctrl+, / Cmd+,),搜索 火山方舟助手 或 arkPlanUsage,填入 arkAccessKey 和 arkSecretKey。
- 环境变量:设置
VOLC_ACCESS_KEY 与 VOLC_SECRET_KEY。
💡 AK/SK 获取方式:登录 火山引擎控制台 → 右上角头像 → 「访问控制」→「用户」→ 创建或选择 IAM 子用户 →「密钥管理」→ 创建 / 查看 AK/SK。
🔒 隐私说明:您的 AK/SK 仅保存在本地 VSCode 配置中,所有用量请求直接发送至火山引擎官方接口,不会经过或上传至任何第三方服务器。
⚙️ 扩展设置
| 设置项 |
默认值 |
说明 |
arkPlanUsage.arkAccessKey |
"" |
火山引擎 Access Key(AK),也可通过 VOLC_ACCESS_KEY 环境变量设置 |
arkPlanUsage.arkSecretKey |
"" |
火山引擎 Secret Key(SK),也可通过 VOLC_SECRET_KEY 环境变量设置 |
arkPlanUsage.product |
coding-plan |
套餐类型:coding-plan(Coding Plan)或 agent-plan(Agent Plan) |
arkPlanUsage.refreshInterval |
5 |
自动刷新间隔(分钟),设为 0 可禁用自动刷新 |
arkPlanUsage.showModel |
true |
是否在状态栏显示当前使用的模型名称 |
arkPlanUsage.showSession |
true |
是否显示会话(Session)用量 |
arkPlanUsage.showWeekly |
true |
是否显示周(Weekly)用量 |
arkPlanUsage.showMonthly |
true |
是否显示月(Monthly)用量 |
arkPlanUsage.statusBarColorMode |
统一标准 |
颜色计算标准:统一标准(按阈值判断)或 智能计算(基于每日额度判断) |
arkPlanUsage.colorWarnThreshold |
70 |
用量超过此百分比显示橙色(仅「统一标准」模式生效) |
arkPlanUsage.colorDangerThreshold |
90 |
用量超过此百分比显示红色(仅「统一标准」模式生效) |
arkPlanUsage.statusBarFormat |
默认 |
状态栏文案格式:默认 / 极简 / 自定义 |
arkPlanUsage.statusBarFormatCustom |
{s_color}{s_pct}% {w_color}{w_pct}% {m_color}{m_pct}% |
自定义文案模板(格式选择「自定义」时生效),支持 {s_color} {s_pct} {w_color} {w_pct} {m_color} {m_pct} 变量 |
🎯 命令
在命令面板(Ctrl+Shift+P / Cmd+Shift+P)中搜索以下命令:
- 火山方舟助手: 立即刷新用量 —— 立即拉取最新用量数据。
- 火山方舟助手: 查看用量详情 —— 打开用量详情侧边面板。
- 火山方舟助手: 切换模型 —— 快速切换当前使用的模型。
💰 还没订阅方舟 Coding Plan?
方舟 Coding Plan 最新支持 GLM-5.3、DeepSeek-V4-flash 正式版、Doubao-Seed-2.1-turbo、MiniMax-M3 等模型,工具不限,现在订阅叠加 9.5 折,低至 9.4 元,订阅越多越划算!
👉 立即订阅:https://volcengine.com/L/Usj0_gtAseM/
🎁 邀请码:2UHR42UX
❓常见问题
问:状态栏没有显示用量?
请检查 AK/SK 是否正确配置,并确认您的火山引擎账号已开通 Coding Plan 或 Agent Plan。可通过「火山方舟助手: 立即刷新用量」命令手动触发一次刷新。
问:支持哪些套餐?
目前支持 Coding Plan 与 Agent Plan,可在设置 arkPlanUsage.product 中切换。
问:AK/SK 会被上传吗?
不会。所有凭证仅存储在您本地的 VSCode 配置中,请求直接发送至火山引擎官方接口。