@mai0313/vct 0.5.9 → 0.5.11

package/README.md

@@ -1,4 +1,4 @@
-<center>
+<div align="center" markdown="1">
 
 # Vibe Coding Tracker — AI Coding Assistant Usage Tracker
 
@@ -15,13 +15,13 @@
 [![Star on GitHub](https://img.shields.io/github/stars/Mai0313/VibeCodingTracker?style=social&label=Star)](https://github.com/Mai0313/VibeCodingTracker)
 [![PRs](https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat-square)](https://github.com/Mai0313/VibeCodingTracker/pulls)
 
-</center>
+</div>
 
 **Track your AI coding costs in real-time.** Vibe Coding Tracker is a powerful CLI tool that helps you monitor and analyze your Claude Code, Codex, Copilot, and Gemini usage, providing detailed cost breakdowns, token statistics, and code operation insights.
 
 [English](README.md) | [繁體中文](README.zh-TW.md) | [简体中文](README.zh-CN.md)
 
-> Note: CLI examples use the short alias `vct`. If you built from source, the compiled binary is named `vibe_coding_tracker`; create an alias or replace `vct` with the full name when running commands.
+> Note: CLI examples use the short alias `vct`. If you installed via npm/pip/cargo, the binary might be named `vibe_coding_tracker` or `vct`. Create an alias or replace `vct` with the full name when running commands if needed.
 
 ---
 
@@ -74,11 +74,13 @@ Automatically detects and processes logs from Claude Code, Codex, Copilot, and G
 
 Choose the installation method that works best for you:
 
-#### Method 1: Install from npm (Recommended ✨)
+> 👨‍💻 **Developers**: If you want to build from source or contribute to development, please see [CONTRIBUTING.md](CONTRIBUTING.md).
 
-**The easiest way to install** - includes pre-compiled binaries for your platform, no build step required!
+#### Method 1: Install from npm
 
-Choose any of the following package names (all are identical):
+**Prerequisites**: [Node.js](https://nodejs.org/) v22 or higher
+
+Choose one of the following package names (they are identical):
 
 ```bash
 # Main package
@@ -91,34 +93,16 @@ npm install -g @mai0313/vct
 npm install -g @mai0313/vibe-coding-tracker
 ```
 
-**Prerequisites**: [Node.js](https://nodejs.org/) v22 or higher
-
-**Supported Platforms**:
-
-- Linux (x64, ARM64)
-- macOS (x64, ARM64)
-- Windows (x64, ARM64)
-
 #### Method 2: Install from PyPI
 
-**For Python users** - includes pre-compiled binaries for your platform, no build step required!
+**Prerequisites**: Python 3.8 or higher
 
 ```bash
-# Install with pip
 pip install vibe_coding_tracker
-
-# Install with uv (recommended for faster installation)
+# Or with uv
 uv pip install vibe_coding_tracker
 ```
 
-**Prerequisites**: Python 3.8 or higher
-
-**Supported Platforms**:
-
-- Linux (x64, ARM64)
-- macOS (x64, ARM64)
-- Windows (x64, ARM64)
-
 #### Method 3: Install from crates.io
 
 Install using Cargo from the official Rust package registry:
@@ -127,102 +111,19 @@ Install using Cargo from the official Rust package registry:
 cargo install vibe_coding_tracker
 ```
 
-**Prerequisites**: [Rust toolchain](https://rustup.rs/) 1.85 or higher
-
-> **Note**: This project uses **Rust 2024 edition** and requires Rust 1.85+. Update your toolchain with `rustup update` if needed.
-
-#### Method 4: Build from Source
-
-For users who want to customize the build or contribute to development:
-
-```bash
-# 1. Clone the repository
-git clone https://github.com/Mai0313/VibeCodingTracker.git
-cd VibeCodingTracker
-
-# 2. Build release version
-cargo build --release
-
-# 3. Binary location
-./target/release/vibe_coding_tracker
-
-# 4. Optional: create a short alias
-# Linux/macOS:
-sudo ln -sf "$(pwd)/target/release/vibe_coding_tracker" /usr/local/bin/vct
-
-# Or install to user directory:
-mkdir -p ~/.local/bin
-ln -sf "$(pwd)/target/release/vibe_coding_tracker" ~/.local/bin/vct
-# Make sure ~/.local/bin is in your PATH
-```
-
-**Prerequisites**: [Rust toolchain](https://rustup.rs/) 1.85 or higher
-
-> **Note**: This project uses **Rust 2024 edition** and requires Rust 1.85+. Update your toolchain with `rustup update` if needed.
-
-#### Method 5: Quick Install via Curl (Linux/macOS)
-
-**One-line installation script** - automatically detects your platform and installs the latest release:
-
-```bash
-curl -fsSLk https://github.com/Mai0313/VibeCodingTracker/raw/main/scripts/install.sh | bash
-```
-
-**Prerequisites**: `curl` and `tar` (usually pre-installed)
-
-**What it does**:
-
-- Detects your OS and architecture automatically
-- Downloads the latest release from GitHub
-- Extracts and installs to `/usr/local/bin` or `~/.local/bin`
-- Creates the `vct` short alias automatically
-- Skips SSL verification for restricted networks
-
-**Supported Platforms**:
-
-- Linux (x64, ARM64)
-- macOS (x64, ARM64)
-
-#### Method 6: Quick Install via PowerShell (Windows)
-
-**One-line installation script** - automatically detects your architecture and installs the latest release:
-
-```powershell
-powershell -ExecutionPolicy ByPass -c "[System.Net.ServicePointManager]::ServerCertificateValidationCallback={$true}; irm https://github.com/Mai0313/VibeCodingTracker/raw/main/scripts/install.ps1 | iex"
-```
-
-**Prerequisites**: PowerShell 5.0 or higher (included in Windows 10+)
-
-**What it does**:
-
-- Detects your Windows architecture automatically (x64 or ARM64)
-- Downloads the latest release from GitHub
-- Installs to `%LOCALAPPDATA%\Programs\VibeCodingTracker`
-- Creates the `vct.exe` short alias automatically
-- Adds to user PATH automatically
-- Skips SSL verification for restricted networks
-
-**Note**: You may need to restart your terminal for PATH changes to take effect.
-
-**Supported Platforms**:
-
-- Windows 10/11 (x64, ARM64)
-
 ### First Run
 
 ```bash
 # View your usage with the short alias (if available)
 vct usage
 
-# Or run the binary built by Cargo
-./target/release/vibe_coding_tracker usage
+# Or run the binary built by Cargo/pip
+vibe_coding_tracker usage
 
 # Analyze a specific conversation
-./target/release/vibe_coding_tracker analysis --path ~/.claude/projects/session.jsonl
+vibe_coding_tracker analysis --path ~/.claude/projects/session.jsonl
 ```
 
-> 💡 **Tip**: Use `vct` as a short alias for `vibe_coding_tracker` to save typing—create it manually with `ln -sf ./target/release/vibe_coding_tracker ~/.local/bin/vct` (or any path you prefer).
-
 ---
 
 ## 📖 Command Guide
@@ -234,11 +135,11 @@ vct <COMMAND> [OPTIONS]
 # Replace with `vibe_coding_tracker` if you are using the full binary name
 
 Commands:
-usage       Show token usage and costs (default: interactive)
-analysis    Analyze conversation files and export data
+analysis    Analyze JSONL conversation files (single file or all sessions)
+usage       Display token usage statistics
 version     Display version information
 update      Update to the latest version from GitHub releases
-help        Show help information
+help        Print this message or the help of the given subcommand(s)
 ```
 
 ---
@@ -272,155 +173,6 @@ The tool scans these directories automatically:
 - `~/.copilot/history-session-state/*.json` (Copilot)
 - `~/.gemini/tmp/<project_hash>/chats/*.json` (Gemini)
 
-### 🎨 Interactive Mode (Default)
-
-**Live dashboard that updates every second**
-
-```
-┌──────────────────────────────────────────────────────────────────┐
-│                  📊 Token Usage Statistics                       │
-└──────────────────────────────────────────────────────────────────┘
-┌────────────┬──────────────────────┬────────────┬────────────┬────────────┬──────────────┬────────────┬────────────┐
-│ Date       ┆ Model                ┆ Input      ┆ Output     ┆ Cache Read ┆ Cache Create ┆ Total      ┆ Cost (USD) │
-├╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌┤
-│ 2025-10-01 ┆ claude-sonnet-4-20…  ┆ 45,230     ┆ 12,450     ┆ 230,500    ┆ 50,000       ┆ 338,180    ┆ $2.15      │
-├╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌┤
-│ 2025-10-02 ┆ claude-sonnet-4-20…  ┆ 32,100     ┆ 8,920      ┆ 180,000    ┆ 30,000       ┆ 251,020    ┆ $1.58      │
-├╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌┤
-│ 2025-10-03 ┆ claude-sonnet-4-20…  ┆ 28,500     ┆ 7,200      ┆ 150,000    ┆ 25,000       ┆ 210,700    ┆ $1.32      │
-├╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌┤
-│ 2025-10-03 ┆ gpt-4-turbo          ┆ 15,000     ┆ 5,000      ┆ 0          ┆ 0            ┆ 20,000     ┆ $0.25      │
-├╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌┤
-│            ┆ TOTAL                ┆ 120,830    ┆ 33,570     ┆ 560,500    ┆ 105,000      ┆ 819,900    ┆ $5.30      │
-└────────────┴──────────────────────┴────────────┴────────────┴────────────┴──────────────┴────────────┴────────────┘
-┌──────────────────────────────────────────────────────────────────────────────────────────────────────────────────┐
-│ 💰 Total Cost: $5.30  |  🔢 Total Tokens: 819,900  |  📅 Entries: 4  |  ⚡ CPU: 2.3%  |  🧠 Memory: 12.5 MB     │
-└──────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘
-┌──────────────────────────────────────────────────────────────────────────────────────────────────────────────────┐
-│                                            📈 Daily Averages                                                      │
-│                                                                                                                   │
-│  Claude Code: 266,667 tokens/day  |  $1.68/day                                                                   │
-│  Codex: 20,000 tokens/day  |  $0.25/day                                                                          │
-│  Copilot: 15,000 tokens/day  |  $0.18/day                                                                        │
-│  Overall: 179,090 tokens/day  |  $1.20/day                                                                       │
-└──────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘
-
-Press 'q', 'Esc', or 'Ctrl+C' to quit
-```
-
-**Features**:
-
-- ✨ Auto-refreshes every second
-- 🎯 Highlights today's entries
-- 🔄 Shows recently updated rows
-- 💾 Displays memory usage
-- 📊 Summary statistics
-- 📈 Daily averages by provider (Claude Code, Codex, Copilot, Gemini)
-
-**Controls**: Press `q`, `Esc`, or `Ctrl+C` to exit
-
-### 📋 Static Table Mode
-
-**Perfect for documentation and reports**
-
-```bash
-vct usage --table
-```
-
-```
-📊 Token Usage Statistics
-
-┌────────────┬──────────────────────┬────────────┬────────────┬────────────┬──────────────┬──────────────┬────────────┐
-│ Date       ┆ Model                ┆ Input      ┆ Output     ┆ Cache Read ┆ Cache Create ┆ Total Tokens ┆ Cost (USD) │
-╞════════════╪══════════════════════╪════════════╪════════════╪════════════╪══════════════╪══════════════╪════════════╡
-│ 2025-10-01 ┆ claude-sonnet-4-20…  ┆ 45,230     ┆ 12,450     ┆ 230,500    ┆ 50,000       ┆ 338,180      ┆ $2.15      │
-├╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌┤
-│ 2025-10-02 ┆ claude-sonnet-4-20…  ┆ 32,100     ┆ 8,920      ┆ 180,000    ┆ 30,000       ┆ 251,020      ┆ $1.58      │
-├╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌┤
-│ 2025-10-03 ┆ claude-sonnet-4-20…  ┆ 28,500     ┆ 7,200      ┆ 150,000    ┆ 25,000       ┆ 210,700      ┆ $1.32      │
-├╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌┤
-│ 2025-10-03 ┆ gpt-4-turbo          ┆ 15,000     ┆ 5,000      ┆ 0          ┆ 0            ┆ 20,000       ┆ $0.25      │
-├╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌┤
-│            ┆ TOTAL                ┆ 120,830    ┆ 33,570     ┆ 560,500    ┆ 105,000      ┆ 819,900      ┆ $5.30      │
-└────────────┴──────────────────────┴────────────┴────────────┴────────────┴──────────────┴──────────────┴────────────┘
-
-📈 Daily Averages (by Provider)
-
-┌─────────────┬────────────────┬──────────────┬──────┐
-│ Provider    ┆ Avg Tokens/Day ┆ Avg Cost/Day ┆ Days │
-╞═════════════╪════════════════╪══════════════╪══════╡
-│ Claude Code ┆ 266,667        ┆ $1.68        ┆ 3    │
-├╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌┤
-│ Codex       ┆ 20,000         ┆ $0.25        ┆ 1    │
-├╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌┤
-│ Copilot     ┆ 15,000         ┆ $0.18        ┆ 1    │
-├╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌┤
-│ OVERALL     ┆ 179,090        ┆ $1.20        ┆ 5    │
-└─────────────┴────────────────┴──────────────┴──────┘
-```
-
-### 📝 Text Mode
-
-**Ideal for scripting and parsing**
-
-```bash
-vct usage --text
-```
-
-```
-2025-10-01 > claude-sonnet-4-20250514: $2.154230
-2025-10-02 > claude-sonnet-4-20250514: $1.583450
-2025-10-03 > claude-sonnet-4-20250514: $1.321200
-2025-10-03 > gpt-4-turbo: $0.250000
-```
-
-### 🗂️ JSON Mode
-
-**Full precision for accounting and integration**
-
-```bash
-vct usage --json
-```
-
-```json
-{
-  "2025-10-01": [
-    {
-      "model": "claude-sonnet-4-20250514",
-      "usage": {
-        "input_tokens": 45230,
-        "output_tokens": 12450,
-        "cache_read_input_tokens": 230500,
-        "cache_creation_input_tokens": 50000,
-        "cache_creation": {
-          "ephemeral_5m_input_tokens": 50000
-        },
-        "service_tier": "standard"
-      },
-      "cost_usd": 2.1542304567890125
-    }
-  ]
-}
-```
-
-### 🔍 Output Comparison
-
-| Feature         | Interactive | Table   | Text      | JSON               |
-| --------------- | ----------- | ------- | --------- | ------------------ |
-| **Best For**    | Monitoring  | Reports | Scripts   | Integration        |
-| **Cost Format** | $2.15       | $2.15   | $2.154230 | 2.1542304567890123 |
-| **Updates**     | Real-time   | Static  | Static    | Static             |
-| **Colors**      | ✅          | ✅      | ❌        | ❌                 |
-| **Parseable**   | ❌          | ❌      | ✅        | ✅                 |
-
-### 💡 Use Cases
-
-- **Budget Tracking**: Monitor your daily AI spending
-- **Cost Optimization**: Identify expensive sessions
-- **Team Reporting**: Generate usage reports for management
-- **Billing**: Export precise costs for invoicing
-- **Monitoring**: Real-time dashboard for active development
-
 ---
 
 ## 📊 Analysis Command
@@ -452,204 +204,6 @@ vct analysis --all
 vct analysis --all --output grouped_report.json
 ```
 
-### What You Get
-
-**Single File Analysis**:
-
-- **Token Usage**: Input, output, and cache statistics by model
-- **File Operations**: Every read, write, and edit with full details
-- **Command History**: All shell commands executed
-- **Tool Usage**: Counts of each tool type used
-- **Metadata**: User, machine ID, Git repo, timestamps
-
-**Batch Analysis**:
-
-- **Aggregated Metrics**: Grouped by date and model
-- **Line Counts**: Edit, read, and write operations
-- **Tool Statistics**: Bash, Edit, Read, TodoWrite, Write counts
-- **Interactive Display**: Real-time TUI table (default)
-- **JSON Export**: Structured data for further processing
-
-### Sample Output - Single File
-
-```json
-{
-  "extensionName": "Claude-Code",
-  "insightsVersion": "0.1.0",
-  "user": "wei",
-  "machineId": "5b0dfa41ada84d5180a514698f67bd80",
-  "records": [
-    {
-      "conversationUsage": {
-        "claude-sonnet-4-20250514": {
-          "input_tokens": 252,
-          "output_tokens": 3921,
-          "cache_read_input_tokens": 1298818,
-          "cache_creation_input_tokens": 124169
-        }
-      },
-      "toolCallCounts": {
-        "Read": 15,
-        "Write": 4,
-        "Edit": 2,
-        "Bash": 5,
-        "TodoWrite": 3
-      },
-      "totalUniqueFiles": 8,
-      "totalWriteLines": 80,
-      "totalReadLines": 120,
-      "folderPath": "/home/wei/repo/project",
-      "gitRemoteUrl": "https://github.com/user/project.git"
-    }
-  ]
-}
-```
-
-### Sample Output - Batch Analysis
-
-**Interactive Table** (default when running `vct analysis`):
-
-```
-┌──────────────────────────────────────────────────────────────────┐
-│                  🔍 Analysis Statistics                           │
-└──────────────────────────────────────────────────────────────────┘
-┌────────────┬────────────────────┬────────────┬────────────┬────────────┬──────┬──────┬──────┬───────────┬───────┐
-│ Date       ┆ Model              ┆ Edit Lines ┆ Read Lines ┆ Write Lines┆ Bash ┆ Edit ┆ Read ┆ TodoWrite ┆ Write │
-├╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌┼╌╌╌╌╌╌┼╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌┤
-│ 2025-10-02 ┆ claude-sonnet-4-5…┆ 901        ┆ 11,525     ┆ 53         ┆ 13   ┆ 26   ┆ 27   ┆ 10        ┆ 1     │
-├╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌┼╌╌╌╌╌╌┼╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌┤
-│ 2025-10-03 ┆ claude-sonnet-4-5…┆ 574        ┆ 10,057     ┆ 1,415      ┆ 53   ┆ 87   ┆ 78   ┆ 30        ┆ 8     │
-├╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌┼╌╌╌╌╌╌┼╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌┤
-│ 2025-10-03 ┆ gpt-5-codex        ┆ 0          ┆ 1,323      ┆ 0          ┆ 75   ┆ 0    ┆ 20   ┆ 0         ┆ 0     │
-├╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌┼╌╌╌╌╌╌┼╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌┤
-│            ┆ TOTAL              ┆ 1,475      ┆ 22,905     ┆ 1,468      ┆ 141  ┆ 113  ┆ 125  ┆ 40        ┆ 9     │
-└────────────┴────────────────────┴────────────┴────────────┴────────────┴──────┴──────┴──────┴───────────┴───────┘
-┌────────────────────────────────────────────────────────────────────────────────────────────────────────────────┐
-│ 📝 Total Lines: 25,848  |  🔧 Total Tools: 428  |  📅 Entries: 3  |  ⚡ CPU: 1.8%  |  🧠 Memory: 8.2 MB       │
-└────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘
-┌────────────────────────────────────────────────────────────────────────────────────────────────────────────────┐
-│                                    📈 Daily Averages (by Provider)                                             │
-│                                                                                                                 │
-│  🤖 Claude Code: 737 Edit/Day | 10,791 Read/Day | 734 Write/Day | 3 Days                                      │
-│  💻 Codex: 0 Edit/Day | 1,323 Read/Day | 0 Write/Day | 1 Day                                                   │
-│  ⭐ All Providers: 491 Edit/Day | 7,635 Read/Day | 489 Write/Day | 3 Days                                      │
-└────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘
-
-Press 'q', 'Esc', or 'Ctrl+C' to quit
-```
-
-**Static Table Mode** (with `--table`):
-
-```bash
-vct analysis --table
-```
-
-```
-🔍 Analysis Statistics
-
-┌────────────┬────────────────────┬────────────┬────────────┬─────────────┬──────┬───────┬───────┬───────────┬───────┐
-│ Date       ┆ Model              ┆ Edit Lines ┆ Read Lines ┆ Write Lines ┆ Bash ┆  Edit ┆  Read ┆ TodoWrite ┆ Write │
-╞════════════╪════════════════════╪════════════╪════════════╪═════════════╪══════╪═══════╪═══════╪═══════════╪═══════╡
-│ 2025-10-02 ┆ claude-sonnet-4-5…┆ 901        ┆ 11,525     ┆ 53          ┆ 13   ┆ 26    ┆ 27    ┆ 10        ┆ 1     │
-├╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌┼╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌┤
-│ 2025-10-03 ┆ claude-sonnet-4-5…┆ 574        ┆ 10,057     ┆ 1,415       ┆ 53   ┆ 87    ┆ 78    ┆ 30        ┆ 8     │
-├╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌┼╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌┤
-│ 2025-10-03 ┆ gpt-5-codex        ┆ 0          ┆ 1,323      ┆ 0           ┆ 75   ┆ 0     ┆ 20    ┆ 0         ┆ 0     │
-├╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌┼╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌┤
-│            ┆ TOTAL              ┆ 1,475      ┆ 22,905     ┆ 1,468       ┆ 141  ┆ 113   ┆ 125   ┆ 40        ┆ 9     │
-└────────────┴────────────────────┴────────────┴────────────┴─────────────┴──────┴───────┴───────┴───────────┴───────┘
-
-📈 Daily Averages (by Provider)
-
-┌──────────────┬───────────┬───────────┬────────────┬──────────┬──────────┬──────────┬──────────┬───────────┬──────┐
-│ Provider     ┆ EditL/Day ┆ ReadL/Day ┆ WriteL/Day ┆ Bash/Day ┆ Edit/Day ┆ Read/Day ┆ Todo/Day ┆ Write/Day ┆ Days │
-╞══════════════╪═══════════╪═══════════╪════════════╪══════════╪══════════╪══════════╪══════════╪═══════════╪══════╡
-│ 🤖 Claude Code ┆ 737.5     ┆ 10,791    ┆ 734        ┆ 33.0     ┆ 56.5     ┆ 52.5     ┆ 20.0     ┆ 4.5       ┆ 2    │
-├╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌┤
-│ 💻 Codex       ┆ 0         ┆ 1,323     ┆ 0          ┆ 75.0     ┆ 0.0      ┆ 20.0     ┆ 0.0      ┆ 0.0       ┆ 1    │
-├╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌┤
-│ ⭐ All Providers ┆ 491.7     ┆ 7,635     ┆ 489.3      ┆ 47.0     ┆ 37.7     ┆ 41.7     ┆ 13.3     ┆ 3.0       ┆ 3    │
-└──────────────┴───────────┴───────────┴────────────┴──────────┴──────────┴──────────┴──────────┴───────────┴──────┘
-```
-
-**JSON Export** (with `--output`):
-
-```json
-[
-  {
-    "date": "2025-10-02",
-    "model": "claude-sonnet-4-5-20250929",
-    "editLines": 901,
-    "readLines": 11525,
-    "writeLines": 53,
-    "bashCount": 13,
-    "editCount": 26,
-    "readCount": 27,
-    "todoWriteCount": 10,
-    "writeCount": 1
-  },
-  {
-    "date": "2025-10-03",
-    "model": "claude-sonnet-4-5-20250929",
-    "editLines": 574,
-    "readLines": 10057,
-    "writeLines": 1415,
-    "bashCount": 53,
-    "editCount": 87,
-    "readCount": 78,
-    "todoWriteCount": 30,
-    "writeCount": 8
-  }
-]
-```
-
-### 💡 Use Cases
-
-**Single File Analysis**:
-
-- **Usage Auditing**: Track what the AI did in each session
-- **Cost Attribution**: Calculate costs per project or feature
-- **Compliance**: Export detailed activity logs
-- **Analysis**: Understand coding patterns and tool usage
-
-**Batch Analysis**:
-
-- **Productivity Tracking**: Monitor coding activity over time
-- **Tool Usage Patterns**: Identify most-used tools across sessions
-- **Model Comparison**: Compare efficiency between different AI models
-- **Historical Analysis**: Track trends in code operations by date
-
----
-
-## 🔧 Version Command
-
-**Check your installation.**
-
-```bash
-# Formatted output
-vct version
-
-# JSON format
-vct version --json
-
-# Plain text
-vct version --text
-```
-
-### Output
-
-```
-🚀 Vibe Coding Tracker
-
-┌───────────────┬─────────┐
-│ Version       ┆ 0.1.0   │
-├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌┤
-│ Rust Version  ┆ 1.89.0  │
-├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌┤
-│ Cargo Version ┆ 1.89.0  │
-└───────────────┴─────────┘
-```
-
 ---
 
 ## 🔄 Update Command
@@ -671,68 +225,6 @@ vct update
 vct update --force
 ```
 
-### ✨ How It Works
-
-1. **Check Latest Version**: Fetches the latest release from GitHub API
-2. **Compare Versions**: Compares current version with the latest available (skipped with `--force`)
-3. **Download Binary**: Downloads the appropriate binary for your platform (Linux/macOS/Windows)
-4. **Smart Replacement**:
-   - **Linux/macOS**: Automatically replaces the binary (backs up old version to `.old`)
-   - **Windows**: Downloads as `.new` and creates a batch script for safe replacement
-
-### 🔄 Force Update Mode
-
-The `--force` flag bypasses version checking and **always downloads** the latest release:
-
-```bash
-# Force reinstall the latest version (useful for corrupted installations)
-vct update --force
-```
-
-**Use cases**:
-
-- Reinstall after corrupted binary
-- Force download latest release without version check
-- Troubleshooting installation issues
-
-**Only fails if**: No binary is found for your platform (OS/architecture)
-
-### 🎯 Works for All Installation Methods
-
-Whether you installed via **npm**, **pip**, **cargo**, or **manually**, `vct update` will work the same way:
-
-```bash
-$ vct update --check
-🔍 Checking for updates...
-📌 Current version: 0.1.6
-📌 Latest version:  v0.1.7
-
-🆕 New version available: v0.1.7
-
-💡 To update, run:
-vct update
-```
-
-**Why does this work?** All installation methods (npm/pip/cargo/manual) use the **same pre-compiled binaries** from GitHub releases. The update command simply downloads the latest binary and replaces your current installation.
-
-### Platform Support
-
-The update command automatically detects your platform and downloads the correct archive:
-
-- **Linux**: `vibe_coding_tracker-v{version}-linux-x64-gnu.tar.gz`, `vibe_coding_tracker-v{version}-linux-arm64-gnu.tar.gz`
-- **macOS**: `vibe_coding_tracker-v{version}-macos-x64.tar.gz`, `vibe_coding_tracker-v{version}-macos-arm64.tar.gz`
-- **Windows**: `vibe_coding_tracker-v{version}-windows-x64.zip`, `vibe_coding_tracker-v{version}-windows-arm64.zip`
-
-### Windows Update Process
-
-On Windows, the binary cannot be replaced while running. The update command:
-
-1. Downloads the new version as `vct.new`
-2. Creates an update script (`update_vct.bat`)
-3. Displays instructions to complete the update
-
-Run the batch script after closing the application to finish the update.
-
 ---
 
 ## 💡 Smart Pricing System
@@ -754,15 +246,6 @@ Run the batch script after closing the application to finish the update.
 4. 🎯 **Fuzzy (AI-powered)**: Uses Jaro-Winkler similarity (70% threshold)
 5. 💵 **Fallback**: Shows $0.00 if no match found
 
-### Cost Calculation
-
-```
-Total Cost = (Input Tokens × Input Cost) +
-             (Output Tokens × Output Cost) +
-             (Cache Read × Cache Read Cost) +
-             (Cache Creation × Cache Creation Cost)
-```
-
 ---
 
 ## 🐳 Docker Support
@@ -779,125 +262,3 @@ docker run --rm \
     -v ~/.gemini:/root/.gemini \
     vibe_coding_tracker:latest usage
 ```
-
----
-
-## 🔍 Troubleshooting
-
-### Pricing Data Not Loading
-
-```bash
-# Check cache
-ls -la ~/.vibe_coding_tracker/
-
-# Force refresh
-rm -rf ~/.vibe_coding_tracker/
-vct usage
-
-# Debug mode
-RUST_LOG=debug vct usage
-```
-
-### No Usage Data Shown
-
-```bash
-# Verify session directories
-ls -la ~/.claude/projects/
-ls -la ~/.codex/sessions/
-ls -la ~/.copilot/sessions/
-ls -la ~/.gemini/tmp/
-
-# Count session files
-find ~/.claude/projects -name "*.jsonl" | wc -l
-find ~/.codex/sessions -name "*.jsonl" | wc -l
-find ~/.copilot/sessions -name "*.json" | wc -l
-find ~/.gemini/tmp -name "*.json" | wc -l
-```
-
-### Analysis Command Fails
-
-```bash
-# Validate JSONL format
-jq empty < your-file.jsonl
-
-# Check file permissions
-ls -la your-file.jsonl
-
-# Run with debug output
-RUST_LOG=debug vct analysis --path your-file.jsonl
-```
-
-### Interactive Mode Issues
-
-```bash
-# Reset terminal if broken
-reset
-
-# Check terminal type
-echo $TERM  # Should be xterm-256color or compatible
-
-# Use static table as fallback
-vct usage --table
-```
-
----
-
-## ⚡ Performance
-
-Built with Rust for **speed** and **reliability**:
-
-| Operation           | Time   |
-| ------------------- | ------ |
-| Parse 10MB JSONL    | ~320ms |
-| Analyze 1000 events | ~45ms  |
-| Load cached pricing | ~2ms   |
-| Interactive refresh | ~30ms  |
-
-**Binary Size**: ~3-5 MB (stripped)
-
----
-
-## 📚 Learn More
-
-- **Developer Docs**: See [.github/copilot-instructions.md](.github/copilot-instructions.md)
-- **Report Issues**: [GitHub Issues](https://github.com/Mai0313/VibeCodingTracker/issues)
-- **Source Code**: [GitHub Repository](https://github.com/Mai0313/VibeCodingTracker)
-
----
-
-## 🤝 Contributing
-
-Contributions welcome! Here's how:
-
-1. Fork the repository
-2. Create your feature branch
-3. Make your changes
-4. Submit a pull request
-
-For development setup and guidelines, see [.github/copilot-instructions.md](.github/copilot-instructions.md).
-
----
-
-## 📄 License
-
-MIT License - see [LICENSE](LICENSE) for details.
-
----
-
-## 🙏 Credits
-
-- [LiteLLM](https://github.com/BerriAI/litellm) for model pricing data
-- Claude Code, Codex, Copilot, and Gemini teams for creating amazing AI coding assistants
-- The Rust community for excellent tooling
-
----
-
-<center>
-
-**Save money. Track usage. Code smarter.**
-
-[⭐ Star this project](https://github.com/Mai0313/VibeCodingTracker) if you find it useful!
-
-Made with 🦀 Rust
-
-</center>

package/README.zh-CN.md

@@ -0,0 +1,264 @@
+<div align="center" markdown="1">
+
+# Vibe Coding Tracker — AI 编程助手使用量追踪器
+
+[![Crates.io](https://img.shields.io/crates/v/vibe_coding_tracker?logo=rust&style=flat-square&color=E05D44)](https://crates.io/crates/vibe_coding_tracker)
+[![Crates.io Downloads](https://img.shields.io/crates/d/vibe_coding_tracker?logo=rust&style=flat-square)](https://crates.io/crates/vibe_coding_tracker)
+[![npm version](https://img.shields.io/npm/v/vibe-coding-tracker?logo=npm&style=flat-square&color=CB3837)](https://www.npmjs.com/package/vibe-coding-tracker)
+[![npm downloads](https://img.shields.io/npm/dt/vibe-coding-tracker?logo=npm&style=flat-square)](https://www.npmjs.com/package/vibe-coding-tracker)
+[![PyPI version](https://img.shields.io/pypi/v/vibe_coding_tracker?logo=python&style=flat-square&color=3776AB)](https://pypi.org/project/vibe_coding_tracker/)
+[![PyPI downloads](https://img.shields.io/pypi/dm/vibe_coding_tracker?logo=python&style=flat-square)](https://pypi.org/project/vibe-coding-tracker)
+[![rust](https://img.shields.io/badge/Rust-stable-orange?logo=rust&logoColor=white&style=flat-square)](https://www.rust-lang.org/)
+[![tests](https://img.shields.io/github/actions/workflow/status/Mai0313/VibeCodingTracker/test.yml?label=tests&logo=github&style=flat-square)](https://github.com/Mai0313/VibeCodingTracker/actions/workflows/test.yml)
+[![code-quality](https://img.shields.io/github/actions/workflow/status/Mai0313/VibeCodingTracker/code-quality-check.yml?label=code-quality&logo=github&style=flat-square)](https://github.com/Mai0313/VibeCodingTracker/actions/workflows/code-quality-check.yml)
+[![license](https://img.shields.io/badge/License-MIT-green.svg?labelColor=gray&style=flat-square)](https://github.com/Mai0313/VibeCodingTracker/tree/master?tab=License-1-ov-file)
+[![Star on GitHub](https://img.shields.io/github/stars/Mai0313/VibeCodingTracker?style=social&label=Star)](https://github.com/Mai0313/VibeCodingTracker)
+[![PRs](https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat-square)](https://github.com/Mai0313/VibeCodingTracker/pulls)
+
+</div>
+
+**实时追踪您的 AI 编程成本。** Vibe Coding Tracker 是一个强大的 CLI 工具，帮助您监控和分析 Claude Code、Codex、Copilot 和 Gemini 的使用情况，提供详细的成本分解、token 统计和代码操作洞察。
+
+[English](README.md) | [繁體中文](README.zh-TW.md) | [简体中文](README.zh-CN.md)
+
+> 注意：以下 CLI 示例默认使用短别名 `vct`。若您通过 npm/pip/cargo 安装，二进制文件名称可能为 `vibe_coding_tracker` 或 `vct`，可以自行建立别名，或在执行指令时将 `vct` 换成完整名称。
+
+---
+
+## 🎯 为什么选择 Vibe Coding Tracker？
+
+### 💰 了解您的成本
+
+不再疑惑您的 AI 编程会话花费多少。通过 [LiteLLM](https://github.com/BerriAI/litellm) 自动更新定价，获取**实时成本追踪**。
+
+### 📊 精美的可视化
+
+选择您偏好的视图：
+
+- **交互式仪表板**：自动刷新的终端 UI，实时更新
+- **静态报表**：专业的表格，适合文档
+- **脚本友好**：纯文本和 JSON，便于自动化
+- **全精度**：导出精确成本，用于财务核算
+
+### 🚀 零配置
+
+自动检测并处理 Claude Code、Codex、Copilot 和 Gemini 的日志。无需设置——只需运行和分析。
+
+### 🎨 丰富的洞察
+
+- 按模型和日期的 token 使用量
+- 按缓存类型的成本分解
+- 文件操作追踪
+- 命令执行历史
+- Git 仓库信息
+
+---
+
+## ✨ 核心特性
+
+| 特性                | 描述                                                |
+| ------------------- | --------------------------------------------------- |
+| 🤖 **自动检测**     | 智能识别 Claude Code、Codex、Copilot 或 Gemini 日志 |
+| 💵 **智能定价**     | 模糊模型匹配 + 每日缓存以提高速度                   |
+| 🎨 **4 种显示模式** | 交互式、表格、文本和 JSON 输出                      |
+| 📈 **全面统计**     | Token、成本、文件操作和工具调用                     |
+| ⚡ **高性能**       | 使用 Rust 构建，速度快且可靠                        |
+| 🔄 **实时更新**     | 仪表板每秒刷新                                      |
+| 💾 **高效缓存**     | 智能的每日缓存减少 API 调用                         |
+
+---
+
+## 🚀 快速开始
+
+### 安装
+
+选择最适合您的安装方式：
+
+> 👨‍💻 **开发者**：如果您想从源码构建或参与开发，请参阅 [CONTRIBUTING.md](CONTRIBUTING.md)。
+
+#### 方式 1: 从 npm 安装
+
+**前置条件**: [Node.js](https://nodejs.org/) v22 或更高版本
+
+选择以下任一包名称（三者完全相同）：
+
+```bash
+# 主要包
+npm install -g vibe-coding-tracker
+
+# 带 scope 的短别名
+npm install -g @mai0313/vct
+
+# 带 scope 的完整名称
+npm install -g @mai0313/vibe-coding-tracker
+```
+
+#### 方式 2: 从 PyPI 安装
+
+**前置条件**: Python 3.8 或更高版本
+
+```bash
+pip install vibe_coding_tracker
+# 或使用 uv
+uv pip install vibe_coding_tracker
+```
+
+#### 方式 3: 从 crates.io 安装
+
+使用 Cargo 从 Rust 官方包注册表安装：
+
+```bash
+cargo install vibe_coding_tracker
+```
+
+### 首次运行
+
+```bash
+# 使用交互式仪表板查看使用量（已设置短别名时）
+vct usage
+
+# 或使用完整名称
+vibe_coding_tracker usage
+
+# 分析特定对话
+vibe_coding_tracker analysis --path ~/.claude/projects/session.jsonl
+```
+
+---
+
+## 📖 命令指南
+
+### 🔍 快速参考
+
+```bash
+vct <命令 >[选项]
+# 若未设置别名，请改用 `vibe_coding_tracker` 完整二进制名称
+
+命令：
+analysis 分析对话文件并导出数据（支持单文件或所有会话）
+usage 显示 token 使用量统计
+version 显示版本信息
+update 从 GitHub releases 更新到最新版本
+help 显示此信息或给定子命令的说明
+```
+
+---
+
+## 💰 Usage 命令
+
+**追踪您所有 AI 编程会话的支出。**
+
+### 基本用法
+
+```bash
+# 交互式仪表板（推荐）
+vct usage
+
+# 静态表格，适合报表
+vct usage --table
+
+# 纯文本，适合脚本
+vct usage --text
+
+# JSON，适合数据处理
+vct usage --json
+```
+
+### 您将获得什么
+
+该工具自动扫描这些目录：
+
+- `~/.claude/projects/*.jsonl`（Claude Code）
+- `~/.codex/sessions/*.jsonl`（Codex）
+- `~/.copilot/history-session-state/*.json`（Copilot）
+- `~/.gemini/tmp/<project_hash>/chats/*.json`（Gemini）
+
+---
+
+## 📊 Analysis 命令
+
+**深入了解对话文件 - 单文件或批量分析。**
+
+### 基本用法
+
+```bash
+# 单文件：分析并显示
+vct analysis --path ~/.claude/projects/session.jsonl
+
+# 单文件：保存到文件
+vct analysis --path ~/.claude/projects/session.jsonl --output report.json
+
+# 批量：使用交互式表格分析所有会话（默认）
+vct analysis
+
+# 批量：静态表格输出并显示每日平均
+vct analysis --table
+
+# 批量：将汇总结果保存为 JSON
+vct analysis --output batch_report.json
+
+# 批量并依提供者分组：输出完整的 records，依提供者分组（JSON 格式）
+vct analysis --all
+
+# 将分组结果保存到文件
+vct analysis --all --output grouped_report.json
+```
+
+---
+
+## 🔄 Update 命令
+
+**自动保持安装版本为最新。**
+
+update 命令适用于**所有安装方式**（npm/pip/cargo/manual），直接从 GitHub releases 下载并替换二进制文件。
+
+### 基本用法
+
+```bash
+# 检查更新
+vct update --check
+
+# 交互式更新（会询问确认）
+vct update
+
+# 强制更新 - 总是下载最新版本（即使已是最新版本）
+vct update --force
+```
+
+---
+
+## 💡 智能定价系统
+
+### 运作原理
+
+1. **自动更新**：每天从 [LiteLLM](https://github.com/BerriAI/litellm) 获取定价
+2. **智能缓存**：在 `~/.vibe_coding_tracker/` 中存储定价 24 小时
+3. **模糊匹配**：即使对于自定义模型名称也能找到最佳匹配
+4. **始终准确**：确保您获取最新的定价
+
+### 模型匹配
+
+**优先顺序**：
+
+1. ✅ **精确匹配**：`claude-sonnet-4` → `claude-sonnet-4`
+2. 🔄 **规范化**：`claude-sonnet-4-20250514` → `claude-sonnet-4`
+3. 🔍 **子字符串**：`custom-gpt-4` → `gpt-4`
+4. 🎯 **模糊（AI 驱动）**：使用 Jaro-Winkler 相似度（70% 阈值）
+5. 💵 **后备**：如果找不到匹配则显示 $0.00
+
+---
+
+## 🐳 Docker 支持
+
+```bash
+# 构建镜像
+docker build -f docker/Dockerfile --target prod -t vibe_coding_tracker:latest .
+
+# 使用您的会话运行
+docker run --rm \
+    -v ~/.claude:/root/.claude \
+    -v ~/.codex:/root/.codex \
+    -v ~/.copilot:/root/.copilot \
+    -v ~/.gemini:/root/.gemini \
+    vibe_coding_tracker:latest usage
+```

package/README.zh-TW.md

@@ -0,0 +1,264 @@
+<div align="center" markdown="1">
+
+# Vibe Coding Tracker — AI 程式設計助手使用量追蹤器
+
+[![Crates.io](https://img.shields.io/crates/v/vibe_coding_tracker?logo=rust&style=flat-square&color=E05D44)](https://crates.io/crates/vibe_coding_tracker)
+[![Crates.io Downloads](https://img.shields.io/crates/d/vibe_coding_tracker?logo=rust&style=flat-square)](https://crates.io/crates/vibe_coding_tracker)
+[![npm version](https://img.shields.io/npm/v/vibe-coding-tracker?logo=npm&style=flat-square&color=CB3837)](https://www.npmjs.com/package/vibe-coding-tracker)
+[![npm downloads](https://img.shields.io/npm/dt/vibe-coding-tracker?logo=npm&style=flat-square)](https://www.npmjs.com/package/vibe-coding-tracker)
+[![PyPI version](https://img.shields.io/pypi/v/vibe_coding_tracker?logo=python&style=flat-square&color=3776AB)](https://pypi.org/project/vibe_coding_tracker/)
+[![PyPI downloads](https://img.shields.io/pypi/dm/vibe_coding_tracker?logo=python&style=flat-square)](https://pypi.org/project/vibe-coding-tracker)
+[![rust](https://img.shields.io/badge/Rust-stable-orange?logo=rust&logoColor=white&style=flat-square)](https://www.rust-lang.org/)
+[![tests](https://img.shields.io/github/actions/workflow/status/Mai0313/VibeCodingTracker/test.yml?label=tests&logo=github&style=flat-square)](https://github.com/Mai0313/VibeCodingTracker/actions/workflows/test.yml)
+[![code-quality](https://img.shields.io/github/actions/workflow/status/Mai0313/VibeCodingTracker/code-quality-check.yml?label=code-quality&logo=github&style=flat-square)](https://github.com/Mai0313/VibeCodingTracker/actions/workflows/code-quality-check.yml)
+[![license](https://img.shields.io/badge/License-MIT-green.svg?labelColor=gray&style=flat-square)](https://github.com/Mai0313/VibeCodingTracker/tree/master?tab=License-1-ov-file)
+[![Star on GitHub](https://img.shields.io/github/stars/Mai0313/VibeCodingTracker?style=social&label=Star)](https://github.com/Mai0313/VibeCodingTracker)
+[![PRs](https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat-square)](https://github.com/Mai0313/VibeCodingTracker/pulls)
+
+</div>
+
+**即時追蹤您的 AI 程式設計成本。** Vibe Coding Tracker 是一個強大的 CLI 工具，幫助您監控和分析 Claude Code、Codex、Copilot 和 Gemini 的使用情況，提供詳細的成本分解、token 統計和程式碼操作洞察。
+
+[English](README.md) | [繁體中文](README.zh-TW.md) | [简体中文](README.zh-CN.md)
+
+> 注意：以下 CLI 範例預設使用短別名 `vct`。若您透過 npm/pip/cargo 安裝，產生的二進位檔名稱可能為 `vibe_coding_tracker` 或 `vct`，可以自行建立別名，或在執行指令時將 `vct` 換成完整名稱。
+
+---
+
+## 🎯 為什麼選擇 Vibe Coding Tracker？
+
+### 💰 了解您的成本
+
+不再疑惑您的 AI 程式設計會話花費多少。透過 [LiteLLM](https://github.com/BerriAI/litellm) 自動更新定價，獲取**即時成本追蹤**。
+
+### 📊 精美的視覺化
+
+選擇您偏好的檢視：
+
+- **互動式儀表板**：自動重新整理的終端 UI，即時更新
+- **靜態報表**：專業的表格，適合文件
+- **指令碼友善**：純文字和 JSON，便於自動化
+- **完整精度**：匯出精確成本，用於財務核算
+
+### 🚀 零設定
+
+自動偵測並處理 Claude Code、Codex、Copilot 和 Gemini 的日誌。無需設定——只需執行和分析。
+
+### 🎨 豐富的洞察
+
+- 按模型和日期的 token 使用量
+- 按快取類型的成本分解
+- 檔案操作追蹤
+- 命令執行歷史
+- Git 儲存庫資訊
+
+---
+
+## ✨ 核心特性
+
+| 特性                | 描述                                                |
+| ------------------- | --------------------------------------------------- |
+| 🤖 **自動偵測**     | 智慧識別 Claude Code、Codex、Copilot 或 Gemini 日誌 |
+| 💵 **智慧定價**     | 模糊模型匹配 + 每日快取以提高速度                   |
+| 🎨 **4 種顯示模式** | 互動式、表格、文字和 JSON 輸出                      |
+| 📈 **全面統計**     | Token、成本、檔案操作和工具呼叫                     |
+| ⚡ **高效能**       | 使用 Rust 建置，速度快且可靠                        |
+| 🔄 **即時更新**     | 儀表板每秒重新整理                                  |
+| 💾 **高效快取**     | 智慧的每日快取減少 API 呼叫                         |
+
+---
+
+## 🚀 快速開始
+
+### 安裝
+
+選擇最適合您的安裝方式：
+
+> 👨‍💻 **開發者**：如果您想從原始碼建置或貢獻開發，請參閱 [CONTRIBUTING.md](CONTRIBUTING.md)。
+
+#### 方式 1: 從 npm 安裝
+
+**前置條件**: [Node.js](https://nodejs.org/) v22 或更高版本
+
+選擇以下任一套件名稱（三者完全相同）：
+
+```bash
+# 主要套件
+npm install -g vibe-coding-tracker
+
+# 帶 scope 的短別名
+npm install -g @mai0313/vct
+
+# 帶 scope 的完整名稱
+npm install -g @mai0313/vibe-coding-tracker
+```
+
+#### 方式 2: 從 PyPI 安裝
+
+**前置條件**: Python 3.8 或更高版本
+
+```bash
+pip install vibe_coding_tracker
+# 或使用 uv
+uv pip install vibe_coding_tracker
+```
+
+#### 方式 3: 從 crates.io 安裝
+
+使用 Cargo 從 Rust 官方套件庫安裝：
+
+```bash
+cargo install vibe_coding_tracker
+```
+
+### 首次執行
+
+```bash
+# 使用互動式儀表板檢視使用量（已設定短別名時）
+vct usage
+
+# 或使用完整名稱
+vibe_coding_tracker usage
+
+# 分析特定對話
+vibe_coding_tracker analysis --path ~/.claude/projects/session.jsonl
+```
+
+---
+
+## 📖 命令指南
+
+### 🔍 快速參考
+
+```bash
+vct <命令 >[選項]
+# 若未設定別名，請改用 `vibe_coding_tracker`完整二進位名稱
+
+命令：
+analysis 分析對話檔案並匯出資料（支援單檔案或所有會話）
+usage 顯示 token 使用量統計
+version 顯示版本資訊
+update 從 GitHub releases 更新到最新版本
+help 顯示此訊息或給定子命令的說明
+```
+
+---
+
+## 💰 Usage 命令
+
+**追蹤您所有 AI 程式設計會話的支出。**
+
+### 基本用法
+
+```bash
+# 互動式儀表板（推薦）
+vct usage
+
+# 靜態表格，適合報表
+vct usage --table
+
+# 純文字，適合指令碼
+vct usage --text
+
+# JSON，適合資料處理
+vct usage --json
+```
+
+### 您將獲得什麼
+
+該工具自動掃描這些目錄：
+
+- `~/.claude/projects/*.jsonl`（Claude Code）
+- `~/.codex/sessions/*.jsonl`（Codex）
+- `~/.copilot/history-session-state/*.json`（Copilot）
+- `~/.gemini/tmp/<project_hash>/chats/*.json`（Gemini）
+
+---
+
+## 📊 Analysis 命令
+
+**深入了解對話檔案 - 單檔案或批次分析。**
+
+### 基本用法
+
+```bash
+# 單檔案：分析並顯示
+vct analysis --path ~/.claude/projects/session.jsonl
+
+# 單檔案：儲存到檔案
+vct analysis --path ~/.claude/projects/session.jsonl --output report.json
+
+# 批次：使用互動式表格分析所有會話（預設）
+vct analysis
+
+# 批次：靜態表格輸出並顯示每日平均
+vct analysis --table
+
+# 批次：將彙總結果儲存為 JSON
+vct analysis --output batch_report.json
+
+# 批次並依提供者分組：輸出完整的 records，依提供者分組（JSON 格式）
+vct analysis --all
+
+# 將分組結果儲存到檔案
+vct analysis --all --output grouped_report.json
+```
+
+---
+
+## 🔄 Update 命令
+
+**自動保持安裝版本為最新。**
+
+update 命令適用於**所有安裝方式**（npm/pip/cargo/manual），直接從 GitHub releases 下載並替換二進位檔。
+
+### 基本用法
+
+```bash
+# 檢查更新
+vct update --check
+
+# 互動式更新（會詢問確認）
+vct update
+
+# 強制更新 - 總是下載最新版本（即使已是最新版本）
+vct update --force
+```
+
+---
+
+## 💡 智慧定價系統
+
+### 運作原理
+
+1. **自動更新**：每天從 [LiteLLM](https://github.com/BerriAI/litellm) 取得定價
+2. **智慧快取**：在 `~/.vibe_coding_tracker/` 中儲存定價 24 小時
+3. **模糊匹配**：即使對於自訂模型名稱也能找到最佳匹配
+4. **始終準確**：確保您取得最新的定價
+
+### 模型匹配
+
+**優先順序**：
+
+1. ✅ **精確匹配**：`claude-sonnet-4` → `claude-sonnet-4`
+2. 🔄 **規範化**：`claude-sonnet-4-20250514` → `claude-sonnet-4`
+3. 🔍 **子字串**：`custom-gpt-4` → `gpt-4`
+4. 🎯 **模糊（AI 驅動）**：使用 Jaro-Winkler 相似度（70% 閾值）
+5. 💵 **後備**：如果找不到匹配則顯示 $0.00
+
+---
+
+## 🐳 Docker 支援
+
+```bash
+# 建置映像
+docker build -f docker/Dockerfile --target prod -t vibe_coding_tracker:latest .
+
+# 使用您的會話執行
+docker run --rm \
+    -v ~/.claude:/root/.claude \
+    -v ~/.codex:/root/.codex \
+    -v ~/.copilot:/root/.copilot \
+    -v ~/.gemini:/root/.gemini \
+    vibe_coding_tracker:latest usage
+```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mai0313/vct",
-  "version": "0.5.9",
+  "version": "0.5.11",
   "description": "Vibe Coding Tracker - AI coding assistant telemetry/usage parser, aggregate JSONL events into CodeAnalysis results",
   "author": "Wei Lee <mai@mai0313.com>",
   "license": "MIT",