火山方舟AFP用量（VS Code 插件）

在 VS Code 状态栏查看火山方舟 Agent Plan 套餐的 AFP（Agent Frame Point）额度使用率，支持个人版和企业版席位查询。

⚠️ 非官方社区项目：本扩展并非火山引擎/字节跳动官方出品，也未与其存在任何隶属、背书或担保关系。“火山引擎”“火山方舟”“Volcengine”等名称及商标归其各自权利人所有，本插件仅用于调用官方公开 OpenAPI 查询本人账号的套餐用量。

该插件按照最新管控面 API 实现：

• 个人版：POST https://ark.cn-beijing.volcengineapi.com/?Action=GetAFPUsage&Version=2024-01-01
• 企业版：POST https://ark.cn-beijing.volcengineapi.com/?Action=GetSeatAFPUsage&Version=2024-01-01
• Service：ark
• Region：cn-beijing
• 鉴权：火山引擎 V4 HMAC-SHA256 Access Key 签名

功能

• 状态栏显示近 5 小时、近 1 周、近 1 月使用率
• 鼠标悬停查看已用 / 总额度、重置时间与倒计时
• 点击状态栏打开用量详情
• 支持个人版 Agent Plan
• 支持企业版一个或多个席位 ID 查询（单次最多 1000 个）
• 自定义刷新间隔、显示窗口、警告/危险阈值
• 支持长期 AK/SK 和临时 Session Token

效果展示

状态栏：在底部状态栏实时显示各时间窗口的 AFP 使用率，超额风险自动变色。

鼠标悬停：以表格展示套餐、模型档位、各窗口已用 / 总额度、使用率与重置倒计时。

用量详情：点击状态栏打开仪表盘，查看额度卡片、进度条、重置时间与倒计时。

配置

打开 VS Code 设置，搜索 火山方舟AFP用量：

也可以使用环境变量：

VOLC_ACCESSKEY=你的 AK
VOLC_SECRETKEY=你的 SK
# 可选
VOLC_SESSION_TOKEN=临时 Token

兼容的环境变量名还包括 VOLC_ACCESS_KEY_ID、VOLC_ACCESS_KEY、VOLC_SECRET_ACCESS_KEY、VOLC_SECRET_KEY。

settings.json 示例

{
  "volcArkAfp.accessKeyId": "AKLT...",
  "volcArkAfp.secretAccessKey": "********",
  "volcArkAfp.accountType": "personal",
  "volcArkAfp.refreshIntervalMinutes": 5
}

企业版示例：

{
  "volcArkAfp.accessKeyId": "AKLT...",
  "volcArkAfp.secretAccessKey": "********",
  "volcArkAfp.accountType": "enterprise",
  "volcArkAfp.seatIds": ["seat-001", "seat-002"]
}

命令

在命令面板（Cmd/Ctrl + Shift + P）搜索：

• 火山方舟 AFP: 刷新用量
• 火山方舟 AFP: 查看用量详情
• 火山方舟 AFP: 打开插件设置

隐私与数据安全

• 插件仅读取你在设置或环境变量中配置的访问凭证（AK/SK/可选 Session Token）。
• 所有网络请求仅发往火山方舟 OpenAPI：https://ark.cn-beijing.volcengineapi.com，用于查询套餐用量。
• 不收集任何分析数据、使用遥测或错误上报，不向任何第三方服务器发送数据。
• 凭证保存在你本机的 VS Code 设置或环境变量中，不会随插件分发；请确认不要把含密钥的 settings.json 提交到代码仓库。
• 建议使用仅授予方舟管控面只读权限的 IAM 子用户密钥，而非主账号密钥。

权限与安全建议

建议不要使用主账号 AK/SK，而是在 IAM 中创建仅具备方舟管控面只读权限的子用户。设置中的密钥是明文存储；如果使用团队共享设备，优先从环境变量注入。

文档依据

• 获取套餐 AFP 额度（GetAFPUsage）
• 获取单个/多个席位的 AFP 额度（GetSeatAFPUsage）
• 火山方舟 Base URL 及鉴权