Kiro Credit Tracker
实时追踪和可视化 Kiro Credits 消耗数据的 VS Code / Kiro IDE 扩展。
提供状态栏实时显示、侧边栏仪表盘、自动日志监听、CSV 账本管理等功能，实现纯 TypeScript 的零依赖体验。
功能特性
- ⚡ 状态栏实时显示 — 在状态栏左侧显示当前 Credits 余量（
⚡ remaining/limit cr），使用率超过 80% 黄色警告，超过 95% 红色告警
- 📊 侧边栏仪表盘 — 暗色主题 Webview 面板，内置 Chart.js 图表，支持日/周/月/计费周期视图切换和日期范围筛选
- 📁 自动日志监听 — 通过 FileSystemWatcher 实时监听 Kiro 日志文件变化，秒级数据更新
- 📒 CSV 账本管理 — 自动维护
~/.kiro/credit-ledger.csv，与现有 Python 脚本格式完全兼容
- 🔄 历史数据重建 — 从所有历史日志文件全量提取 Credits 数据，重建完整消耗记录
- 💾 CSV 导出 — 一键导出账本到指定路径
- 🖥️ 跨平台支持 — 支持 macOS 和 Windows
截图
安装
从 VSIX 文件安装
- 下载最新的
.vsix 文件
- 打开 VS Code / Kiro IDE
- 按
Ctrl+Shift+P（macOS: Cmd+Shift+P）打开命令面板
- 输入
Extensions: Install from VSIX...
- 选择下载的
.vsix 文件
或者使用命令行：
code --install-extension kiro-credit-tracker-0.1.0.vsix
从源码构建
git clone <repository-url>
cd kiro-credit-tracker-extension
npm install
npm run compile
npm run package
命令
| 命令 |
说明 |
Kiro Credits: 查看仪表盘 |
打开侧边栏仪表盘面板 |
Kiro Credits: 重建历史数据 |
从所有历史日志全量提取并重建 CSV 账本 |
Kiro Credits: 导出 CSV |
将当前账本复制到指定路径 |
Kiro Credits: 刷新数据 |
立即扫描最新日志并更新数据 |
配置
扩展激活后自动运行，无需额外配置。
数据文件路径
- 日志文件
- macOS:
~/Library/Application Support/Kiro/logs/*/window*/exthost/kiro.kiroAgent/q-client*.log
- Windows:
%APPDATA%/Kiro/logs/*/window*/exthost/kiro.kiroAgent/q-client*.log
- CSV 账本:
~/.kiro/credit-ledger.csv
状态栏颜色
| 使用率 |
颜色 |
| ≤ 80% |
绿色（正常） |
| 80% - 95% |
黄色（警告） |
| > 95% |
红色（告警） |
技术栈
- TypeScript + VS Code Extension API
- Chart.js（内联到 Webview）
- Mocha + fast-check（测试）
许可证
MIT
| |
