kimi-code-usage 0.1.0__tar.gz → 0.1.2__tar.gz

kimi_code_usage-0.1.2/.claude/settings.local.json

@@ -0,0 +1,23 @@
+{
+  "permissions": {
+    "allow": [
+      "Skill(superpowers:subagent-driven-development)",
+      "Bash(node -e \"JSON.parse\\(require\\('fs'\\).readFileSync\\('package.json'\\)\\); console.log\\('JSON valid'\\)\")",
+      "Bash(rtk grep *)",
+      "Bash(rtk npm *)",
+      "Bash(python3 *)",
+      "Bash(rtk ls *)",
+      "Bash(uv run *)",
+      "Bash(rtk read *)",
+      "WebFetch(domain:github.com)",
+      "WebSearch",
+      "WebFetch(domain:www.sensenova.cn)",
+      "WebFetch(domain:www.opencode.ai)",
+      "WebFetch(domain:platform.sensenova.cn)",
+      "Bash(curl -s -X POST http://127.0.0.1:10086/command -H 'Content-Type: application/json' -d '{\"action\":\"evaluate\",\"args\":{\"code\":\"\\(\\(\\)=>{let p=performance.getEntriesByType\\(\\\\\"resource\\\\\"\\)||[];return JSON.stringify\\(p.slice\\(0,20\\).map\\(e=>e.name.split\\(\\\\\"?\\\\\"\\)[0]\\).filter\\(u=>u.includes\\(\\\\\"sensenova\\\\\"\\)||u.includes\\(\\\\\"api\\\\\"\\)||u.includes\\(\\\\\"cs\\\\\"\\)||u.includes\\(\\\\\"nova\\\\\"\\)\\)\\).slice\\(0,5000\\)}\\)\\(\\)\"},\"session\":\"sensenova2\"}')",
+      "Bash(curl -s -X POST http://127.0.0.1:10086/command -H 'Content-Type: application/json' -d '{\"action\":\"evaluate\",\"args\":{\"code\":\"\\(async\\(\\)=>{let scriptUrls=Array.from\\(document.querySelectorAll\\(\\\\\"script[src]\\\\\"\\),s=>s.src\\).filter\\(s=>s.endsWith\\(\\\\\".js\\\\\"\\)\\);let apiMatches={};for\\(let url of scriptUrls.slice\\(0,30\\)\\){try{let r=await fetch\\(url\\);let t=await r.text\\(\\);let m=t.match\\(/[\\\\\"\\\\\\\\x27]\\(https?:\\\\\\\\/\\\\\\\\/[^\\\\\"\\\\\\\\x27]{10,}\\)[\\\\\"\\\\\\\\x27]/g\\);if\\(m\\){m.forEach\\(x=>{let u=x.replace\\(/[\\\\\"\\\\\\\\x27]/g,\\\\\"\\\\\"\\);if\\(u.includes\\(\\\\\".cn\\\\\"\\)||u.includes\\(\\\\\"api\\\\\"\\)||u.includes\\(\\\\\"nova\\\\\"\\)\\)apiMatches[u]=true}\\)}}catch\\(e\\){}}return JSON.stringify\\(Object.keys\\(apiMatches\\).slice\\(0,30\\)\\)}\\)\\(\\)\"},\"session\":\"sensenova2\"}')",
+      "Bash(curl -s -X POST http://127.0.0.1:10086/command -H 'Content-Type: application/json' -d '{\"action\":\"evaluate\",\"args\":{\"code\":\"\\(async\\(\\)=>{var tries=[\\\\\"5750\\\\\",\\\\\"1408\\\\\",\\\\\"5346\\\\\",\\\\\"4682\\\\\",\\\\\"9493\\\\\",\\\\\"3099\\\\\",\\\\\"4582\\\\\"];var out=[];for\\(let id of tries\\){try{var r=await fetch\\(\\\\\"/_next/static/chunks/\\\\\"+id+\\\\\"-acc76ae5e1746a4d.js\\\\\"\\);var t=await r.text\\(\\);var m=t.match\\(/[\\\\\"\\\\\\\\x27]\\(https?:\\\\\\\\/\\\\\\\\/[^\\\\\\\\\\\\\"\\\\\\\\x27]{10,}\\)[\\\\\"\\\\\\\\x27]/g\\);if\\(m\\){let u=[...new Set\\(m.map\\(x=>x.replace\\(/[\\\\\"\\\\\\\\x27]/g,\\\\\"\\\\\"\\)\\).filter\\(x=>x.includes\\(\\\\\".\\\\\"\\)&&!x.includes\\(\\\\\"_next\\\\\"\\)\\)\\)];if\\(u.length>0\\)out.push\\(id+\\\\\": \\\\\"+JSON.stringify\\(u.slice\\(0,10\\)\\)\\)}}catch\\(e\\){try{r=await fetch\\(\\\\\"/_next/static/chunks/\\\\\"+id+\\\\\"-9bebaa28b82e0188.js\\\\\"\\);t=await r.text\\(\\);m=t.match\\(/[\\\\\"\\\\\\\\x27]\\(https?:\\\\\\\\/\\\\\\\\/[^\\\\\"\\\\\\\\x27]{10,}\\)[\\\\\"\\\\\\\\x27]/g\\);if\\(m\\){let u=[...new Set\\(m.map\\(x=>x.replace\\(/[\\\\\"\\\\\\\\x27]/g,\\\\\"\\\\\"\\)\\).filter\\(x=>x.includes\\(\\\\\".\\\\\"\\)&&!x.includes\\(\\\\\"_next\\\\\"\\)\\)\\)];if\\(u.length>0\\)out.push\\(id+\\\\\": \\\\\"+JSON.stringify\\(u.slice\\(0,10\\)\\)\\)}}catch\\(e2\\){}}}return out.join\\(\\\\\"; \\\\\"\\)||\\\\\"none\\\\\"}\\)\\(\\)\"},\"session\":\"sensenova2\"}')",
+      "Bash(curl -s -X POST http://127.0.0.1:10086/command -H 'Content-Type: application/json' -d '{\"action\":\"evaluate\",\"args\":{\"code\":\"\\(async\\(\\)=>{var tries=[\\\\\"/console?_rsc=z1g34\\\\\",\\\\\"/console?_rsc=1p5nq\\\\\"];var out=[];for\\(let u of tries\\){try{var r=await fetch\\(u\\);var t=await r.text\\(\\);out.push\\(u+\\\\\" -> \\\\\"+r.status+\\\\\" \\\\\"+r.headers.get\\(\\\\\"content-type\\\\\"\\)+\\\\\" \\\\\"+t.slice\\(0,200\\)\\)}catch\\(e\\){out.push\\(u+\\\\\" ERROR\\\\\"\\)}}return out.join\\(\\\\\"|||\\\\\"\\)}\\)\\(\\)\"},\"session\":\"sensenova2\"}')"
+    ]
+  }
+}

kimi_code_usage-0.1.2/.gitignore

@@ -0,0 +1,46 @@
+# Environment / Secrets
+.env
+*.env
+
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.egg-info/
+dist/
+build/
+
+# Node.js
+node_modules/
+package-lock.json
+
+# VSCode Extension artifacts
+*.vsix
+vscode-extension/out/
+vscode-extension/archive/
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+
+# OS
+.DS_Store
+Thumbs.db
+# Skill-generated analysis artifacts
+.understand-anything/
+.codegraph/
+
+# Python test artifacts
+.pytest_cache/
+.coverage
+.coverage.*
+
+# Node / Vitest coverage
+vscode-extension/coverage/
+
+# VS Code extension test runner
+.vscode-test/
+**/*.js.map
+tokscale-export-*.json

kimi_code_usage-0.1.2/PKG-INFO

@@ -0,0 +1,190 @@
+Metadata-Version: 2.4
+Name: kimi-code-usage
+Version: 0.1.2
+Summary: A curated Kimi Coding Plan usage monitor with aesthetic CLI and MCP server.
+Project-URL: Homepage, https://github.com/Golden0Voyager/kimi-code-usage
+Project-URL: Repository, https://github.com/Golden0Voyager/kimi-code-usage
+Project-URL: Issues, https://github.com/Golden0Voyager/kimi-code-usage/issues
+Author-email: Haining Yu <hainingyu@gmail.com>
+License: MIT
+Keywords: curated,kimi,mcp,monitor,moonshot,usage
+Requires-Python: >=3.10
+Requires-Dist: aiohttp>=3.8.0
+Requires-Dist: fastmcp>=0.1.0
+Requires-Dist: httpx[socks]>=0.20.0
+Requires-Dist: python-dotenv>=1.0.0
+Requires-Dist: rich>=12.0.0
+Description-Content-Type: text/markdown
+
+<pre align="center">
+ ██╗  ██╗ ██╗ ███╗   ███╗ ██╗     ██████╗  ██████╗  ██████╗  ███████╗
+ ██║ ██╔╝ ██║ ████╗ ████║ ██║    ██╔════╝ ██╔═══██╗ ██╔══██╗ ██╔════╝
+ █████╔╝  ██║ ██╔████╔██║ ██║    ██║      ██║   ██║ ██║  ██║ █████╗
+ ██╔═██╗  ██║ ██║╚██╔╝██║ ██║    ██║      ██║   ██║ ██║  ██║ ██╔══╝
+ ██║  ██╗ ██║ ██║ ╚═╝ ██║ ██║    ╚██████╗ ╚██████╔╝ ██████╔╝ ███████╗
+ ╚═╝  ╚═╝ ╚═╝ ╚═╝     ╚═╝ ╚═╝     ╚═════╝  ╚═════╝  ╚═════╝  ╚══════╝
+</pre>
+
+> **English** · [中文](README.zh.md)
+
+# Kimi Code Usage: The Curated Toolchain
+
+**Manifesting your AI quota with aesthetic precision across CLI, MCP, and VS Code.**
+
+![CLI & MCP (Python) Coverage](https://img.shields.io/badge/CLI%20%26%20MCP%20(Python)-100%25%20coverage-brightgreen)
+![VS Code Extension Coverage](https://img.shields.io/badge/VS%20Code%20Extension-100%25%20coverage-brightgreen)
+
+---
+
+### 🌟 Project Vision
+
+In the era of "Vibecoding," transparency of resources is a prerequisite for flow. **Kimi Code Usage** is a meticulously crafted toolchain — three components, one soul.
+
+**Prerequisite:** A [Kimi Coding Plan](https://api.kimi.com/coding/v1) API Key, set as `KIMI_API_KEY` in your environment or `.env` file.
+
+---
+
+### ⚡ CLI Reporter
+
+> A Rich-rendered panel in your terminal. Zero noise, pure signal.
+
+**Install & Run:**
+```bash
+pip install kimi-code-usage
+kimi-usage              # Aesthetic Rich panel
+kimi-usage --json       # Machine-readable JSON
+kimi-usage --plain      # Plain text output
+```
+
+Or run instantly without installing:
+```bash
+uvx kimi-code-usage
+```
+
+---
+
+### 🔍 MCP Server
+
+> Exposes `get_kimi_usage` to any MCP-compatible AI Agent.
+
+Compatible with **Claude Code, Cursor, Windsurf, Hermes**, and any MCP-enabled agent.
+
+**Add to your MCP config** (e.g., `~/.claude/settings.json`):
+```json
+{
+  "mcpServers": {
+    "kimi-code-usage": {
+      "command": "uvx",
+      "args": ["--from", "kimi-code-usage", "kimi-mcp"],
+      "env": {
+        "KIMI_API_KEY": "YOUR_KEY"
+      }
+    }
+  }
+}
+```
+
+> **Note:** The MCP server still needs `--from` because `kimi-mcp` is a separate command from the default `kimi-code-usage` entry point.
+
+Then simply ask your AI: *"Check my Kimi quota."*
+
+---
+
+### 💎 VS Code Extension
+
+> A sleek status bar indicator with sensory color alerting.
+
+**Install:** Search `Kimi Code Usage` in the VS Code Marketplace, or:
+```bash
+code --install-extension HainingYu.kimi-code-usage
+```
+
+**Configure** (`Settings > Kimi Code Usage`):
+
+| Setting | Description | Default |
+| :--- | :--- | :--- |
+| `kimiCodeUsage.apiKey` | API key (or reads `KIMI_CODING_API_KEY`/`KIMI_API_KEY` env) | `""` |
+| `kimiCodeUsage.baseUrl` | API Base URL | `"https://api.kimi.com/coding/v1"` |
+| `kimiCodeUsage.refreshIntervalMinutes` | Auto-refresh interval in minutes | `5` |
+| `kimiCodeUsage.weeklyLowThresholdPercent` | Weekly low quota warning threshold (%) | `30` |
+| `kimiCodeUsage.fiveHourLowThresholdPercent` | 5-hour low quota warning threshold (%) | `15` |
+| `kimiCodeUsage.showPaceIndicator` | Show pace indicator (Fast/Normal/Slow) | `true` |
+| `kimiCodeUsage.showPaceBar` | Show pace bar in status bar | `true` |
+
+**Usage:** Status bar shows `🌕  [===]  Wee:96% 5Ho:99%`. Hover for details. `Cmd+Shift+P → Kimi: Refresh`.
+
+---
+
+## 📊 Real-World Analysis
+
+> *How much does a ¥199/mo Coding Plan actually cover? Real data from 5 months of heavy vibe coding, with a cost comparison against standard API pricing.*
+
+**Full data → [`docs/kimi-code-usage.md`](docs/kimi-code-usage.md)**
+
+### 1. Profile
+
+| Item | Detail |
+|:---|:---|
+| Plan | Tier 3 Allegretto ($31/mo) → **¥199/mo** |
+| Workflow | Claude Code + kimi-for-coding, heavy vibe coding |
+| Data Period | 2026-01 ~ 2026-05 full records (~3,152M tokens) |
+
+### 2. Token Composition
+
+| Component | 5-Month Total | Share |
+|:---|:---|---:|
+| Input (Cache Miss) | ~154M | 4.9% |
+| Cache Created | ~89M | 2.8% |
+| Output | ~12M | 0.4% |
+| **Cache Read (Cache Hit)** | **~2,896M** | **91.9%** |
+| **Total** | **~3,152M** | **100%** |
+
+A **91.9% cache hit rate** is the signature of vibe coding — long sessions where each turn carries full conversation history, and only the latest exchange is fresh.
+
+### 3. Actual Monthly Burn
+
+Based on continuous weekly sampling (3 days = 30% of weekly quota):
+
+| Metric | Value |
+|:---|:---:|
+| Weekly Burn | ~320M tokens |
+| **Monthly Burn** | **≈ 1.37 ~ 1.5 billion tokens** |
+| Plan Cost | ¥199/mo |
+| **Effective Rate** | **≈ ¥0.14 / million tokens** |
+
+### 4. Cost Comparison
+
+Priced against **Kimi K2.6 standard API rates** (input ¥6.50 / cache ¥1.10 / output ¥27.00 per million tokens):
+
+| Scenario | Cost/Month | Multiple |
+|:---|:---:|:---:|
+| **Kimi Coding Plan (¥199)** | **¥199** | **1×** |
+| Pay-as-you-go (K2.6 standard) | **≈ ¥2,420** | **12.2×** |
+
+| Pay-as-you-go Breakdown | Volume/Month | Rate | Cost |
+|:---|---:|:---:|---:|
+| Input (Cache Miss) | 73.5M | ¥6.50/MTok | ¥478 |
+| Cache Read (Hit) | 1,378.5M | ¥1.10/MTok | ¥1,516 |
+| Output | 5.55M | ¥27.00/MTok | ¥150 |
+| Cache Created | 42.5M | ¥6.50/MTok | ¥276 |
+| **Total** | **1.5B** | | **¥2,420** |
+
+### 5. Bottom Line
+
+> **The Coding Plan saves heavy users ≈ ¥2,221/month (~92%).** Cache reads account for 92% of total tokens; the plan bundles both cache and input into the subscription fee. Under pay-as-you-go, cache alone makes up 63% of the bill.
+
+### ⚠️ Disclaimer
+
+> This analysis reflects one user's actual usage from 2026-01 to 2026-05 via `ccusage`. Token ratios and cost estimates are for **reference only** — actual results vary by session pattern, model choice, caching behavior, and API pricing. Rates sourced from [platform.kimi.com](https://platform.kimi.com) as of 2026-05-24.
+
+---
+
+### 🎨 About the Curator
+
+Crafted with ❤️ by **Haining Yu**, an Art Curator and Vibecoder. This toolchain is part of a curated collection designed to bridge the gap between aesthetic curation and intuitive, AI-powered coding.
+
+---
+
+<p align="center">
+  <strong>Enjoy the flow. Stay in the vibe.</strong>
+</p>

kimi_code_usage-0.1.2/README.md

@@ -0,0 +1,172 @@
+<pre align="center">
+ ██╗  ██╗ ██╗ ███╗   ███╗ ██╗     ██████╗  ██████╗  ██████╗  ███████╗
+ ██║ ██╔╝ ██║ ████╗ ████║ ██║    ██╔════╝ ██╔═══██╗ ██╔══██╗ ██╔════╝
+ █████╔╝  ██║ ██╔████╔██║ ██║    ██║      ██║   ██║ ██║  ██║ █████╗
+ ██╔═██╗  ██║ ██║╚██╔╝██║ ██║    ██║      ██║   ██║ ██║  ██║ ██╔══╝
+ ██║  ██╗ ██║ ██║ ╚═╝ ██║ ██║    ╚██████╗ ╚██████╔╝ ██████╔╝ ███████╗
+ ╚═╝  ╚═╝ ╚═╝ ╚═╝     ╚═╝ ╚═╝     ╚═════╝  ╚═════╝  ╚═════╝  ╚══════╝
+</pre>
+
+> **English** · [中文](README.zh.md)
+
+# Kimi Code Usage: The Curated Toolchain
+
+**Manifesting your AI quota with aesthetic precision across CLI, MCP, and VS Code.**
+
+![CLI & MCP (Python) Coverage](https://img.shields.io/badge/CLI%20%26%20MCP%20(Python)-100%25%20coverage-brightgreen)
+![VS Code Extension Coverage](https://img.shields.io/badge/VS%20Code%20Extension-100%25%20coverage-brightgreen)
+
+---
+
+### 🌟 Project Vision
+
+In the era of "Vibecoding," transparency of resources is a prerequisite for flow. **Kimi Code Usage** is a meticulously crafted toolchain — three components, one soul.
+
+**Prerequisite:** A [Kimi Coding Plan](https://api.kimi.com/coding/v1) API Key, set as `KIMI_API_KEY` in your environment or `.env` file.
+
+---
+
+### ⚡ CLI Reporter
+
+> A Rich-rendered panel in your terminal. Zero noise, pure signal.
+
+**Install & Run:**
+```bash
+pip install kimi-code-usage
+kimi-usage              # Aesthetic Rich panel
+kimi-usage --json       # Machine-readable JSON
+kimi-usage --plain      # Plain text output
+```
+
+Or run instantly without installing:
+```bash
+uvx kimi-code-usage
+```
+
+---
+
+### 🔍 MCP Server
+
+> Exposes `get_kimi_usage` to any MCP-compatible AI Agent.
+
+Compatible with **Claude Code, Cursor, Windsurf, Hermes**, and any MCP-enabled agent.
+
+**Add to your MCP config** (e.g., `~/.claude/settings.json`):
+```json
+{
+  "mcpServers": {
+    "kimi-code-usage": {
+      "command": "uvx",
+      "args": ["--from", "kimi-code-usage", "kimi-mcp"],
+      "env": {
+        "KIMI_API_KEY": "YOUR_KEY"
+      }
+    }
+  }
+}
+```
+
+> **Note:** The MCP server still needs `--from` because `kimi-mcp` is a separate command from the default `kimi-code-usage` entry point.
+
+Then simply ask your AI: *"Check my Kimi quota."*
+
+---
+
+### 💎 VS Code Extension
+
+> A sleek status bar indicator with sensory color alerting.
+
+**Install:** Search `Kimi Code Usage` in the VS Code Marketplace, or:
+```bash
+code --install-extension HainingYu.kimi-code-usage
+```
+
+**Configure** (`Settings > Kimi Code Usage`):
+
+| Setting | Description | Default |
+| :--- | :--- | :--- |
+| `kimiCodeUsage.apiKey` | API key (or reads `KIMI_CODING_API_KEY`/`KIMI_API_KEY` env) | `""` |
+| `kimiCodeUsage.baseUrl` | API Base URL | `"https://api.kimi.com/coding/v1"` |
+| `kimiCodeUsage.refreshIntervalMinutes` | Auto-refresh interval in minutes | `5` |
+| `kimiCodeUsage.weeklyLowThresholdPercent` | Weekly low quota warning threshold (%) | `30` |
+| `kimiCodeUsage.fiveHourLowThresholdPercent` | 5-hour low quota warning threshold (%) | `15` |
+| `kimiCodeUsage.showPaceIndicator` | Show pace indicator (Fast/Normal/Slow) | `true` |
+| `kimiCodeUsage.showPaceBar` | Show pace bar in status bar | `true` |
+
+**Usage:** Status bar shows `🌕  [===]  Wee:96% 5Ho:99%`. Hover for details. `Cmd+Shift+P → Kimi: Refresh`.
+
+---
+
+## 📊 Real-World Analysis
+
+> *How much does a ¥199/mo Coding Plan actually cover? Real data from 5 months of heavy vibe coding, with a cost comparison against standard API pricing.*
+
+**Full data → [`docs/kimi-code-usage.md`](docs/kimi-code-usage.md)**
+
+### 1. Profile
+
+| Item | Detail |
+|:---|:---|
+| Plan | Tier 3 Allegretto ($31/mo) → **¥199/mo** |
+| Workflow | Claude Code + kimi-for-coding, heavy vibe coding |
+| Data Period | 2026-01 ~ 2026-05 full records (~3,152M tokens) |
+
+### 2. Token Composition
+
+| Component | 5-Month Total | Share |
+|:---|:---|---:|
+| Input (Cache Miss) | ~154M | 4.9% |
+| Cache Created | ~89M | 2.8% |
+| Output | ~12M | 0.4% |
+| **Cache Read (Cache Hit)** | **~2,896M** | **91.9%** |
+| **Total** | **~3,152M** | **100%** |
+
+A **91.9% cache hit rate** is the signature of vibe coding — long sessions where each turn carries full conversation history, and only the latest exchange is fresh.
+
+### 3. Actual Monthly Burn
+
+Based on continuous weekly sampling (3 days = 30% of weekly quota):
+
+| Metric | Value |
+|:---|:---:|
+| Weekly Burn | ~320M tokens |
+| **Monthly Burn** | **≈ 1.37 ~ 1.5 billion tokens** |
+| Plan Cost | ¥199/mo |
+| **Effective Rate** | **≈ ¥0.14 / million tokens** |
+
+### 4. Cost Comparison
+
+Priced against **Kimi K2.6 standard API rates** (input ¥6.50 / cache ¥1.10 / output ¥27.00 per million tokens):
+
+| Scenario | Cost/Month | Multiple |
+|:---|:---:|:---:|
+| **Kimi Coding Plan (¥199)** | **¥199** | **1×** |
+| Pay-as-you-go (K2.6 standard) | **≈ ¥2,420** | **12.2×** |
+
+| Pay-as-you-go Breakdown | Volume/Month | Rate | Cost |
+|:---|---:|:---:|---:|
+| Input (Cache Miss) | 73.5M | ¥6.50/MTok | ¥478 |
+| Cache Read (Hit) | 1,378.5M | ¥1.10/MTok | ¥1,516 |
+| Output | 5.55M | ¥27.00/MTok | ¥150 |
+| Cache Created | 42.5M | ¥6.50/MTok | ¥276 |
+| **Total** | **1.5B** | | **¥2,420** |
+
+### 5. Bottom Line
+
+> **The Coding Plan saves heavy users ≈ ¥2,221/month (~92%).** Cache reads account for 92% of total tokens; the plan bundles both cache and input into the subscription fee. Under pay-as-you-go, cache alone makes up 63% of the bill.
+
+### ⚠️ Disclaimer
+
+> This analysis reflects one user's actual usage from 2026-01 to 2026-05 via `ccusage`. Token ratios and cost estimates are for **reference only** — actual results vary by session pattern, model choice, caching behavior, and API pricing. Rates sourced from [platform.kimi.com](https://platform.kimi.com) as of 2026-05-24.
+
+---
+
+### 🎨 About the Curator
+
+Crafted with ❤️ by **Haining Yu**, an Art Curator and Vibecoder. This toolchain is part of a curated collection designed to bridge the gap between aesthetic curation and intuitive, AI-powered coding.
+
+---
+
+<p align="center">
+  <strong>Enjoy the flow. Stay in the vibe.</strong>
+</p>

kimi_code_usage-0.1.2/README.zh.md

@@ -0,0 +1,172 @@
+<pre align="center">
+ ██╗  ██╗ ██╗ ███╗   ███╗ ██╗     ██████╗  ██████╗  ██████╗  ███████╗
+ ██║ ██╔╝ ██║ ████╗ ████║ ██║    ██╔════╝ ██╔═══██╗ ██╔══██╗ ██╔════╝
+ █████╔╝  ██║ ██╔████╔██║ ██║    ██║      ██║   ██║ ██║  ██║ █████╗
+ ██╔═██╗  ██║ ██║╚██╔╝██║ ██║    ██║      ██║   ██║ ██║  ██║ ██╔══╝
+ ██║  ██╗ ██║ ██║ ╚═╝ ██║ ██║    ╚██████╗ ╚██████╔╝ ██████╔╝ ███████╗
+ ╚═╝  ╚═╝ ╚═╝ ╚═╝     ╚═╝ ╚═╝     ╚═════╝  ╚═════╝  ╚═════╝  ╚══════╝
+</pre>
+
+> [English](README.md) · **中文**
+
+# Kimi Code Usage：三端工具链
+
+**以优雅的姿态，在终端、AI 助手与编辑器中感知你的 AI 额度。**
+
+![CLI & MCP (Python) 测试覆盖率](https://img.shields.io/badge/CLI%20%26%20MCP%20%28Python%29%20%E6%B5%8B%E8%AF%95%E8%A6%86%E7%9B%96%E7%8E%86-100%25-brightgreen)
+![VS Code 插件 测试覆盖率](https://img.shields.io/badge/VS%20Code%20%E6%8F%92%E4%BB%B6%20%E6%B5%8B%E8%AF%95%E8%A6%86%E7%9B%96%E7%8E%86-100%25-brightgreen)
+
+---
+
+### 🌟 项目愿景
+
+在"直觉编程"时代，资源的透明度是进入心流状态的前提。**Kimi Code Usage** 是一套精心打磨的工具链 — 三种形态，一个灵魂。
+
+**统一前提：** 在环境变量或 `.env` 文件中设置 `KIMI_API_KEY`（[Kimi Coding Plan](https://api.kimi.com/coding/v1) API Key）。
+
+---
+
+### ⚡ CLI 终端报告器
+
+> 在你的终端中渲染出带有工业美感的配额面板。
+
+**安装与运行：**
+```bash
+pip install kimi-code-usage
+kimi-usage              # 美观的 Rich 面板
+kimi-usage --json       # 机器可读的 JSON
+kimi-usage --plain      # 纯文本输出
+```
+
+或免安装直接运行：
+```bash
+uvx kimi-code-usage
+```
+
+---
+
+### 🔍 MCP 智能体接口
+
+> 让你的 AI 助手能够主动感知你的额度状态。
+
+兼容 **Claude Code、Cursor、Windsurf、Hermes** 及所有支持 MCP 的 AI 工具。
+
+**添加到 MCP 配置**（如 `~/.claude/settings.json`）：
+```json
+{
+  "mcpServers": {
+    "kimi-code-usage": {
+      "command": "uvx",
+      "args": ["--from", "kimi-code-usage", "kimi-mcp"],
+      "env": {
+        "KIMI_API_KEY": "YOUR_KEY"
+      }
+    }
+  }
+}
+```
+
+> **注意：** MCP 服务器需要 `--from` 参数，因为 `kimi-mcp` 是独立于默认入口点的子命令。
+
+配置后直接对 AI 说：*"帮我查一下 Kimi 用量。"*
+
+---
+
+### 💎 VS Code 编辑器插件
+
+> 状态栏实时显示剩余百分比，颜色随额度变化而呼吸。
+
+**安装：** 在 VS Code 插件市场搜索 `Kimi Code Usage`，或运行：
+```bash
+code --install-extension HainingYu.kimi-code-usage
+```
+
+**配置**（`设置 > Kimi Code Usage`）：
+
+| 设置项 | 说明 | 默认值 |
+| :--- | :--- | :--- |
+| `kimiCodeUsage.apiKey` | API 密钥（或读取 `KIMI_CODING_API_KEY`/`KIMI_API_KEY` 环境变量） | `""` |
+| `kimiCodeUsage.baseUrl` | API 基础地址 | `"https://api.kimi.com/coding/v1"` |
+| `kimiCodeUsage.refreshIntervalMinutes` | 自动刷新间隔（分钟） | `5` |
+| `kimiCodeUsage.weeklyLowThresholdPercent` | 每周低余量告警阈值 (%) | `30` |
+| `kimiCodeUsage.fiveHourLowThresholdPercent` | 5小时低余量告警阈值 (%) | `15` |
+| `kimiCodeUsage.showPaceIndicator` | 显示速度指针（快/正常/慢） | `true` |
+| `kimiCodeUsage.showPaceBar` | 在状态栏显示速度进度条 | `true` |
+
+**使用：** 状态栏显示 `🌕  [===]  Wee:96% 5Ho:99%`。悬停查看详情。`Cmd+Shift+P → Kimi: Refresh`。
+
+---
+
+## 📊 真实用量参考
+
+> *¥199/月 Coding Plan 的实际用量是多少？对比按量付费能省多少？来自 5 个月的真实数据。*
+
+**详细数据 → [`docs/kimi-code-usage.md`](docs/kimi-code-usage.md)**
+
+### 1. 用户画像
+
+| 项目 | 详情 |
+|:---|:---|
+| 方案 | 第三档 Allegretto（$31/月）→ **¥199/月** |
+| 工作流 | Claude Code + kimi-for-coding，重度 vibe coding |
+| 数据周期 | 2026-01 ~ 2026-05 全量记录（约 31.5 亿 tokens） |
+
+### 2. 消耗结构
+
+| 项目 | 5 个月累计 | 占比 |
+|:---|:---|---:|
+| 输入（Cache Miss） | ~1.54 亿 | 4.9% |
+| 缓存创建 | ~0.89 亿 | 2.8% |
+| 输出 | ~0.12 亿 | 0.4% |
+| **缓存读取（Cache Hit）** | **~28.96 亿** | **91.9%** |
+| **总计** | **~31.52 亿** | **100%** |
+
+缓存命中率 **91.9%** 是 vibe coding 的典型特征——长会话中每轮携带完整历史，仅最新一轮为 cache miss。
+
+### 3. 实际月消耗
+
+基于近一周连续采样（3 天占周额度 30%）推得：
+
+| 指标 | 数值 |
+|:---|:---:|
+| 周消耗 | ~3.2 亿 tokens |
+| **月消耗** | **≈ 13.7 ~ 15 亿 tokens** |
+| 方案费用 | ¥199/月 |
+| **折算有效费率** | **≈ ¥0.14 / 百万 tokens** |
+
+### 4. 费用对比
+
+按 **Kimi K2.6 标准 API 定价**（输入 ¥6.50 / 缓存 ¥1.10 / 输出 ¥27.00 每百万 tokens）计算等量消耗的费用：
+
+| 场景 | 月费用 | 倍数 |
+|:---|:---:|:---:|
+| **Kimi Coding Plan（¥199）** | **¥199** | **1×** |
+| 按量付费（K2.6 标准价） | **≈ ¥2,420** | **12.2×** |
+
+| 按量付费明细 | 月用量 | 单价 | 费用 |
+|:---|---:|:---:|---:|
+| 输入（Cache Miss） | 7,350 万 | ¥6.50/百万 | ¥478 |
+| 缓存读取（Cache Hit） | 13.79 亿 | ¥1.10/百万 | ¥1,516 |
+| 输出 | 555 万 | ¥27.00/百万 | ¥150 |
+| 缓存创建 | 4,250 万 | ¥6.50/百万 | ¥276 |
+| **合计** | **15 亿** | | **¥2,420** |
+
+### 5. 结论
+
+> **Coding Plan 每月为重度用户节省约 ¥2,221（约 92%）。** 核心原因：缓存读取占总 tokens 92%，而 Plan 将其和输入都包在订阅费内；按量付费下这部分占账单 63%。
+
+### ⚠️ 免责声明
+
+> 本分析基于单用户 2026-01~05 期间的实际用量数据（`ccusage` 采集），各项比例和费用估算**仅供参考**。实际结果因会话模式、模型选择、缓存策略和 API 定价变化而异。定价截至 2026-05-24，引用自 [platform.kimi.com](https://platform.kimi.com)。
+
+---
+
+### 🎨 关于策展人
+
+由 **Haining Yu** 精心打磨。作为一名艺术策展人与 Vibecoder，我将代码视作展览，力求在审美策展与直觉化 AI 编程之间寻找完美的平衡。
+
+---
+
+<p align="center">
+  <strong>Enjoy the flow. Stay in the vibe.</strong>
+</p>

kimi_code_usage-0.1.2/docs/kimi-code-usage.md

@@ -0,0 +1,54 @@
+# Kimi Code 用量分析
+
+分析日期：2026-05-24
+数据来源：`bunx ccusage`（全量记录 2026-01 ~ 2026-05）
+
+---
+
+## Token 比例（全量累积）
+
+| 项目 | 全量累积 | 占比 |
+|------|---------|:---:|
+| 输入（Cache Miss） | ~154M | 4.9% |
+| 缓存创建 | ~89M | 2.8% |
+| 输出 | ~12M | 0.4% |
+| 缓存读取（Cache Hit） | ~2,896M | 91.9% |
+| **总计** | **~3,152M** | **100%** |
+
+## 背后原因
+
+缓存 91.9% 是 **vibe coding 长 session** 的典型特征：
+
+- Claude Code + kimi-for-coding 模式下，每轮对话都携带完整历史
+- 只有最后一次提问和回复是 cache miss，前面 N-1 轮全部命中缓存
+- 单 session 50-100 轮对话下，缓存占比自然逼近 92-98%
+
+## 月度费用估算（按 1.5B tokens/月）
+
+### Kimi K2.6 标准 API 定价（无 Coding Plan）
+
+| 项目 | 单价 | 月用量 | 月费用 |
+|------|:---:|:------:|:-----:|
+| 输入（Cache Miss） | ¥6.50/MTok | 73.5M | ¥478 |
+| 缓存读取（Cache Hit） | ¥1.10/MTok | 1,378.5M | ¥1,516 |
+| 输出 | ¥27.00/MTok | 5.55M | ¥150 |
+| 缓存创建（按输入计） | ¥6.50/MTok | 42.5M | ¥276 |
+| **合计** | | **1.5B** | **≈ ¥2,420/月** |
+
+费用占比：缓存读取 63% > 输入 31% > 输出 6%
+
+### 与 Coding Plan 对比
+
+| 方案 | 月费用 |
+|-----|:-----:|
+| **Kimi K2.6 按量付费** | **≈ ¥2,420** |
+| Coding Plan（会员） | ¥39~¥199 |
+| **差价** | **12~60 倍** |
+
+Coding Plan 的核心价值：把缓存读取和大量输入都包进订阅费。
+
+## 优化建议
+
+- 善用 `/clear` 或 `/compress` 指令切断历史
+- 新话题主动开新 session
+- 可从缓存占比 92% 降至 70-80%，费用减半以上