@mai0313/vct 1.4.0 → 1.5.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (10) hide show
  1. package/README.md +17 -9
  2. package/README.zh-CN.md +17 -9
  3. package/README.zh-TW.md +17 -9
  4. package/binaries/linux-arm64-gnu/vibe_coding_tracker +0 -0
  5. package/binaries/linux-x64-gnu/vibe_coding_tracker +0 -0
  6. package/binaries/macos-arm64/vibe_coding_tracker +0 -0
  7. package/binaries/macos-x64/vibe_coding_tracker +0 -0
  8. package/binaries/windows-arm64/vibe_coding_tracker.exe +0 -0
  9. package/binaries/windows-x64/vibe_coding_tracker.exe +0 -0
  10. package/package.json +1 -1
package/README.md CHANGED
@@ -168,14 +168,15 @@ Time range flags (shared by `usage` and `analysis`, mutually exclusive, default
168
168
 
169
169
  ### Flags
170
170
 
171
- | Flag | Purpose |
172
- | ---------------------------------------------- | ----------------------------------- |
173
- | *(none)* | Interactive TUI dashboard (default) |
174
- | `--table` | Static table, no TUI |
175
- | `--text` | Plain text, script-friendly |
176
- | `--json` | JSON with enriched pricing metadata |
177
- | `--output <FILE>` | Save enriched JSON to a file |
178
- | `--daily` / `--weekly` / `--monthly` / `--all` | Time range filter (see table above) |
171
+ | Flag | Purpose |
172
+ | ---------------------------------------------- | -------------------------------------------------------------------------------- |
173
+ | *(none)* | Interactive TUI dashboard (default) |
174
+ | `--table` | Static table, no TUI |
175
+ | `--text` | Plain text, script-friendly |
176
+ | `--json` | JSON with enriched pricing metadata |
177
+ | `--output <FILE>` | Save enriched JSON to a file |
178
+ | `--merge-providers` | Merge models sharing a base name across provider prefixes (ignored for `--json`) |
179
+ | `--daily` / `--weekly` / `--monthly` / `--all` | Time range filter (see table above) |
179
180
 
180
181
  ### Basic Usage
181
182
 
@@ -199,11 +200,18 @@ vct usage --output report.json
199
200
  vct usage --weekly
200
201
  vct usage --table --monthly
201
202
  vct usage --json --daily
203
+
204
+ # Merge same model reported under different provider prefixes
205
+ # (e.g. openai/gpt-5.5 + azure/gpt-5.5 + gpt-5.5 -> one row)
206
+ vct usage --table --merge-providers
202
207
  ```
203
208
 
204
209
  > [!NOTE]
205
210
  > Model rows are sorted by cost in ascending order, so the highest-spending model is listed last (right above the `TOTAL` row in `--table`). This applies to the interactive dashboard, `--table`, and `--text` output; `--json` preserves the same order. The interactive dashboard also hides models with zero usage in the selected range.
206
211
 
212
+ > [!TIP]
213
+ > The same model can show up as several rows when it is routed under different provider prefixes (`openai/gpt-5.5`, `azure/gpt-5.5`, plain `gpt-5.5`). `--merge-providers` collapses rows that share the base name after the first `/` (versions like `gpt-5.5` vs `gpt-5.4` stay separate) and sums their already-priced cost. In the interactive dashboard, press `m` to toggle it live; `--merge-providers` opens the dashboard already merged. `--json` is left as the raw per-model export.
214
+
207
215
  ### Preview: Interactive Dashboard (`vct usage`)
208
216
 
209
217
  ```
@@ -223,7 +231,7 @@ vct usage --json --daily
223
231
  ┌─────────────────────────────────────────────────────────────────────────────────────────────┐
224
232
  │ Total Cost: $79.33 | Total Tokens: 49.3M | Models: 3 | Memory: 42.8 MB │
225
233
  └─────────────────────────────────────────────────────────────────────────────────────────────┘
226
- ↑/↓ scroll PgUp/PgDn page g/G top/end r refresh q quit | ★ github.com/Mai0313/VibeCodingTracker
234
+ ↑/↓ scroll PgUp/PgDn page g/G top/end m merge r refresh q quit | ★ github.com/Mai0313/VibeCodingTracker
227
235
  ```
228
236
 
229
237
  ### Preview: Table & JSON (`vct usage`)
package/README.zh-CN.md CHANGED
@@ -168,14 +168,15 @@ Commands:
168
168
 
169
169
  ### Flag 一览
170
170
 
171
- | Flag | 用途 |
172
- | ---------------------------------------------- | -------------------------- |
173
- | *(不带参数)* | 互动式 TUI 面板（默认） |
174
- | `--table` | 静态表格，不启动 TUI |
175
- | `--text` | 纯文本，适合脚本处理 |
176
- | `--json` | JSON 输出，附带定价信息 |
177
- | `--output <FILE>` | 将富化 JSON 保存到文件 |
178
- | `--daily` / `--weekly` / `--monthly` / `--all` | 时间范围筛选（见上方表格） |
171
+ | Flag | 用途 |
172
+ | ---------------------------------------------- | ----------------------------------------------------------------------------- |
173
+ | *(不带参数)* | 互动式 TUI 面板（默认） |
174
+ | `--table` | 静态表格，不启动 TUI |
175
+ | `--text` | 纯文本，适合脚本处理 |
176
+ | `--json` | JSON 输出，附带定价信息 |
177
+ | `--output <FILE>` | 将富化 JSON 保存到文件 |
178
+ | `--merge-providers` | 合并共享同一 base 名称、仅 provider 前缀不同的 model（`--json` 会忽略此选项） |
179
+ | `--daily` / `--weekly` / `--monthly` / `--all` | 时间范围筛选（见上方表格） |
179
180
 
180
181
  ### 基本用法
181
182
 
@@ -199,11 +200,18 @@ vct usage --output report.json
199
200
  vct usage --weekly
200
201
  vct usage --table --monthly
201
202
  vct usage --json --daily
203
+
204
+ # 合并同一 model 在不同 provider 前缀下的多行
205
+ # (例如 openai/gpt-5.5 + azure/gpt-5.5 + gpt-5.5 -> 一行)
206
+ vct usage --table --merge-providers
202
207
  ```
203
208
 
204
209
  > [!NOTE]
205
210
  > Model 行会按 cost 升序排序，因此花费最高的 model 会排在最后（在 `--table` 中紧邻 `TOTAL` 行上方）。该排序适用于交互式面板、`--table` 与 `--text` 三种输出；`--json` 也会保持相同顺序。交互式面板还会隐藏在所选范围内用量为 0 的模型。
206
211
 
212
+ > [!TIP]
213
+ > 同一个 model 在不同 provider 前缀下路由时会显示成多行（`openai/gpt-5.5`、`azure/gpt-5.5`、纯 `gpt-5.5`）。`--merge-providers` 会把第一个 `/` 之后 base 名称相同的行合并（`gpt-5.5` 与 `gpt-5.4` 这类版本不同的仍分开），并把它们已定价的 cost 相加。在交互式面板中按 `m` 可实时切换；`--merge-providers` 则让面板一打开就是合并状态。`--json` 保持为逐一 model 的原始导出。
214
+
207
215
  ### 预览：交互式面板（`vct usage`）
208
216
 
209
217
  ```
@@ -223,7 +231,7 @@ vct usage --json --daily
223
231
  ┌─────────────────────────────────────────────────────────────────────────────────────────────┐
224
232
  │ Total Cost: $79.33 | Total Tokens: 49.3M | Models: 3 | Memory: 42.8 MB │
225
233
  └─────────────────────────────────────────────────────────────────────────────────────────────┘
226
- ↑/↓ scroll PgUp/PgDn page g/G top/end r refresh q quit | ★ github.com/Mai0313/VibeCodingTracker
234
+ ↑/↓ scroll PgUp/PgDn page g/G top/end m merge r refresh q quit | ★ github.com/Mai0313/VibeCodingTracker
227
235
  ```
228
236
 
229
237
  ### 预览：表格与 JSON（`vct usage`）
package/README.zh-TW.md CHANGED
@@ -168,14 +168,15 @@ Commands:
168
168
 
169
169
  ### Flag 一覽
170
170
 
171
- | Flag | 用途 |
172
- | ---------------------------------------------- | ---------------------------- |
173
- | *(不帶參數)* | 互動式 TUI 儀表板（預設） |
174
- | `--table` | 靜態表格，不啟動 TUI |
175
- | `--text` | 純文字，適合腳本處理 |
176
- | `--json` | JSON 輸出，附帶 pricing 資訊 |
177
- | `--output <FILE>` | 將富化 JSON 存成檔案 |
178
- | `--daily` / `--weekly` / `--monthly` / `--all` | 時間範圍篩選（見上方表格） |
171
+ | Flag | 用途 |
172
+ | ---------------------------------------------- | ----------------------------------------------------------------------------- |
173
+ | *(不帶參數)* | 互動式 TUI 儀表板（預設） |
174
+ | `--table` | 靜態表格，不啟動 TUI |
175
+ | `--text` | 純文字，適合腳本處理 |
176
+ | `--json` | JSON 輸出，附帶 pricing 資訊 |
177
+ | `--output <FILE>` | 將富化 JSON 存成檔案 |
178
+ | `--merge-providers` | 合併共享同一 base 名稱、僅 provider 前綴不同的 model（`--json` 會忽略此選項） |
179
+ | `--daily` / `--weekly` / `--monthly` / `--all` | 時間範圍篩選（見上方表格） |
179
180
 
180
181
  ### 基本用法
181
182
 
@@ -199,11 +200,18 @@ vct usage --output report.json
199
200
  vct usage --weekly
200
201
  vct usage --table --monthly
201
202
  vct usage --json --daily
203
+
204
+ # 合併同一 model 在不同 provider 前綴下的多列
205
+ # (例如 openai/gpt-5.5 + azure/gpt-5.5 + gpt-5.5 -> 一列)
206
+ vct usage --table --merge-providers
202
207
  ```
203
208
 
204
209
  > [!NOTE]
205
210
  > Model 列會依 cost 由小到大排序，所以花費最高的 model 會排在最後(在 `--table` 中緊鄰 `TOTAL` 列上方)。這個排序會套用到互動式儀表板、`--table` 與 `--text` 三種輸出;`--json` 也會保持相同順序。互動式儀表板也會隱藏在所選範圍內用量為 0 的 model。
206
211
 
212
+ > [!TIP]
213
+ > 同一個 model 在不同 provider 前綴下路由時會顯示成多列（`openai/gpt-5.5`、`azure/gpt-5.5`、純 `gpt-5.5`）。`--merge-providers` 會把第一個 `/` 之後 base 名稱相同的列合併（`gpt-5.5` 與 `gpt-5.4` 這類版本不同的仍分開），並把它們已定價的 cost 相加。在互動式儀表板中按 `m` 可即時切換;`--merge-providers` 則讓儀表板一打開就是合併狀態。`--json` 保持為逐一 model 的原始輸出。
214
+
207
215
  ### 預覽：互動式儀表板（`vct usage`）
208
216
 
209
217
  ```
@@ -223,7 +231,7 @@ vct usage --json --daily
223
231
  ┌─────────────────────────────────────────────────────────────────────────────────────────────┐
224
232
  │ Total Cost: $79.33 | Total Tokens: 49.3M | Models: 3 | Memory: 42.8 MB │
225
233
  └─────────────────────────────────────────────────────────────────────────────────────────────┘
226
- ↑/↓ scroll PgUp/PgDn page g/G top/end r refresh q quit | ★ github.com/Mai0313/VibeCodingTracker
234
+ ↑/↓ scroll PgUp/PgDn page g/G top/end m merge r refresh q quit | ★ github.com/Mai0313/VibeCodingTracker
227
235
  ```
228
236
 
229
237
  ### 預覽：表格與 JSON（`vct usage`）
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@mai0313/vct",
3
- "version": "1.4.0",
3
+ "version": "1.5.1",
4
4
  "description": "Vibe Coding Tracker - AI coding assistant telemetry/usage parser, aggregate JSONL events into CodeAnalysis results",
5
5
  "author": "Wei Lee <mai@mai0313.com>",
6
6
  "license": "MIT",