Coding Plan Usage
一款用于在 VS Code 状态栏实时展示多个 Coding Plan 用量/限额的扩展。
功能特性
- 状态栏实时监控:在 VS Code 状态栏显示多个 Plan 的剩余配额、用量等信息
- 自动定时刷新:支持配置刷新间隔,自动更新状态栏数据
- 自定义查询脚本:每个 Plan 可配置独立的配额查询脚本,灵活适配不同 API 提供商
- 显示模板自定义:支持通过模板语法自定义状态栏展示文案,并支持跨 Plan 引用数据
- 可视化配置:通过 Webview 配置面板,图形化管理 Plan 列表与参数
- 手动触发查询:支持手动执行任意 Plan 的配额查询脚本
安装
本地安装
pnpm install
pnpm run build:vsix
然后在 VS Code 中通过 Extensions → Install from VSIX 选择生成的 .vsix 文件进行安装。
使用说明
打开配置面板
使用命令面板(Cmd/Ctrl + Shift + P)执行:
Coding Plan Usage: Open Config
或通过点击状态栏上的 Plan 信息直接打开配置面板。
配置 Plan
在配置面板中,你可以添加、编辑或删除 Plan。每个 Plan 包含以下字段:
| 字段 |
说明 |
id |
Plan 唯一标识 |
name |
Plan 显示名称 |
baseUrl |
API 基础地址 |
apiKey |
API 密钥 |
quotaQueryScript |
配额查询脚本(支持 JavaScript) |
displayTemplate |
状态栏显示模板(可选) |
enabled |
是否启用 |
显示模板语法
在 displayTemplate 中可以使用以下占位符:
${name} — Plan 名称
${remaining} — 剩余配额
${total} — 总配额
${used} — 已用配额
${unit} — 配额单位
${ref:PlanName} 或 ${ref:planId} — 引用其他 Plan 的数据
示例:
${name}: ${remaining}/${total} ${unit}
可用命令
| 命令 |
说明 |
CodingPlanUsage.helloWorld |
测试命令,弹出欢迎消息 |
CodingPlanUsage.openConfig |
打开配置 Webview |
CodingPlanUsage.refreshStatusBar |
手动刷新状态栏 |
CodingPlanUsage.runQuotaScript |
手动执行选中 Plan 的配额查询脚本 |
设置项
在 VS Code 设置中搜索 codingPlanUsage,可配置以下选项:
codingPlanUsage.enabled — 是否启用扩展(默认:true)
codingPlanUsage.refreshInterval — 状态栏自动刷新间隔,单位秒(默认:60,最小 10)
codingPlanUsage.plans — Plan 列表配置
开发
# 安装依赖
pnpm install
# 开发模式(监听变更)
pnpm run watch
# 编译
pnpm run compile
# 打包生产构建
pnpm run build
# 生成 VSIX 安装包
pnpm run build:vsix
# 运行测试
pnpm run test
技术栈
- TypeScript
- React + Webview(配置面板)
- esbuild(构建)
- VS Code Extension API
License
MIT
| |