@amadeus19/cc-statusline 3.2.3 → 3.2.4

package/README.md

@@ -1,9 +1,9 @@
 # Claude Code Statusline Pro
 
-[![npm version](https://badge.fury.io/js/@amadeus19/cc-statusline.svg)](https://badge.fury.io/js/@amadeus19/cc-statusline)
+[![npm version](https://badge.fury.io/js/ccsp.svg)](https://badge.fury.io/js/ccsp)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 [![Node.js](https://img.shields.io/badge/Node.js-18+-green.svg)](https://nodejs.org/)
-[![Platform](https://img.shields.io/badge/Platform-Windows%20%7C%20macOS%20%7C%20Linux-blue.svg)](https://github.com/amadeus19/cc-statusline)
+[![Platform](https://img.shields.io/badge/Platform-Windows%20%7C%20macOS%20%7C%20Linux-blue.svg)](https://github.com/wangnov/ccsp)
 
 [中文](#使用指南) | [English](#user-guide)
 
@@ -26,6 +26,8 @@
 - 🌐 **双语支持**: 中英双语配置界面和错误提示
 - 🦀 **Rust 引擎**: 提供原生 Rust 内核，更快更稳
 
+> ⚠️ **Rate Limit 组件目前仅支持 GLM Coding Plan**（智谱清言 Coding Plan），用于查询 5 小时 / 7 天 Token 配额使用情况及重置倒计时。其他平台暂不支持。
+
 ### 🦀 Rust 重写优化亮点
 
 - 原生 `git2` 仓库分析：直接获取分支、状态、stash 等信息，避免频繁 Shell 调用，在大型仓库中依然流畅
@@ -74,8 +76,6 @@ npm --version
 }
 ```
 
-> 💡 **兼容说明**：旧命令 `npx @amadeus19/cc-statusline@latest` 仍会继续工作并自动调用新包，但将显示迁移提示。建议尽快将现有配置更新为 `npx @amadeus19/cc-statusline@latest` 以保持一致。
-
 保存文件后，重新打开Claude Code即可看到专业版状态栏！
 
 #### 验证安装
@@ -83,7 +83,10 @@ npm --version
 打开Claude Code，你应该看到类似这样的状态栏：
 
 ```text
-📁 my-project | 🤖 S4 | 🌿 main | 📊 [████████████░░░] 80.1%(160k/200k) | $21.07 | ✅ Ready
+📁 cc-statusline | 🤖 glm-5.1 | 🌿 main⚡ | 📊 [███░░░░░░░░░] 26.9% (53.8k/200k) | ✅ Ready | 💰 $1.29
+🪙 5h: 1% [░░░░░░░░░░░░] ⏰ 4h12m │ 🌐 MCP: 2/1000 (30d)
+
+注：最后一行的 🪙 5h 用量和 ⏰ 倒计时即为 Rate Limit 组件（需 GLM Coding Plan）
 ```
 
 ### 🎯 快速配置指南
@@ -92,12 +95,13 @@ npm --version
 
 通过简单的字母组合快速定制状态栏显示内容：
 
-- **P** = Project (项目名称)  
+- **P** = Project (项目名称)
 - **M** = Model (模型信息)
 - **B** = Branch (Git分支)
 - **T** = Tokens (Token使用情况)
 - **U** = Usage (使用量统计)
 - **S** = Status (状态信息)
+- **R** = Rate Limit (GLM 配额用量)
 
 #### 快速配置命令
 
@@ -105,7 +109,7 @@ npm --version
 
 ```bash
 # 显示所有组件（推荐）
-npx @amadeus19/cc-statusline@latest --preset PMBTUS --theme powerline
+npx @amadeus19/cc-statusline@latest --preset PMBTUSR --theme powerline
 
 # 只显示模型、Token和使用量
 npx @amadeus19/cc-statusline@latest --preset MTU --theme classic
@@ -145,7 +149,7 @@ Classic主题支持三种图标模式，默认会根据终端能力自动选择
 
 ![Classic Nerd Font](./assets/classic_nf.png)
 
-**需要安装Nerd Font字体，并在对应的终端中选择使用字体**，推荐使用 [Hack Nerd Font](https://github.com/ryanoasis/nerd-fonts/releases/download/v3.2.3/Hack.zip)
+**需要安装Nerd Font字体，并在对应的终端中选择使用字体**，推荐使用 [Hack Nerd Font](https://github.com/ryanoasis/nerd-fonts/releases/download/v3.4.0/Hack.zip)
 
 ##### 😊 Emoji 模式
 
@@ -211,6 +215,42 @@ contextUsedTokens = usage.input_tokens +
 
 这确保了状态栏显示的token使用量与Claude官方统计完全一致。
 
+### 🪙 Rate Limit 配额用量（仅 GLM Coding Plan）
+
+Rate Limit 组件可实时查询 GLM Coding Plan 的 Token 配额使用情况和重置倒计时，帮助你掌控 API 调用节奏。
+
+> ⚠️ **目前仅支持 GLM Coding Plan**（智谱清言 Coding Plan），需要配置 `ANTHROPIC_API_KEY` 或 `ZHIPU_API_KEY` 环境变量。其他平台暂不支持。
+
+#### 显示内容
+
+- **5 小时用量**：当前 5 小时窗口的 Token 消耗百分比及进度条
+- **7 天用量**：当前 7 天窗口的 Token 消耗百分比及进度条
+- **重置倒计时**：距配额窗口重置的剩余时间
+- **MCP 统计**：MCP 调用次数及配额
+
+#### 配置示例
+
+```toml
+[components.rate_limit]
+enabled = true
+
+[components.rate_limit.glm_usage]
+enabled = true
+cache_ttl = 300        # 缓存有效期（秒）
+timeout_ms = 5000      # 请求超时（毫秒）
+retry_attempts = 2     # 重试次数
+
+[components.rate_limit.glm_usage.thresholds]
+warning = 80           # 80% 显示黄色警告
+danger = 95            # 95% 显示红色危险
+
+[components.rate_limit.display]
+show_5h_progress_bar = true
+show_7d_progress_bar = true
+show_countdown = true
+progress_width = 8
+```
+
 ### 💰 Cost计算说明
 
 #### 智能成本追踪系统
@@ -336,6 +376,39 @@ critical = 95   # 95%显示🔥临界
 force_nerd_font = false     # 强制启用Nerd Font
 force_emoji = false         # 强制启用Emoji  
 force_text = false          # 强制文本模式
+
+# Rate Limit 配额用量（仅 GLM Coding Plan）
+[components.rate_limit]
+enabled = true
+
+[components.rate_limit.glm_usage]
+enabled = true
+cache_ttl = 300                # 缓存有效期（秒）
+timeout_ms = 5000              # 请求超时（毫秒）
+retry_attempts = 2             # 重试次数
+
+[components.rate_limit.glm_usage.thresholds]
+warning = 80                   # 80% 显示黄色警告
+danger = 95                    # 95% 显示红色危险
+
+[components.rate_limit.display]
+# 进度条
+show_5h_progress_bar = true   # 5h 进度条
+show_7d_progress_bar = true   # 7d 进度条
+progress_width = 8            # 进度条宽度
+
+# 倒计时
+show_countdown = true         # 倒计时开关
+
+# 速率图标（5h / 7d 前缀）
+emoji_icon = "🪙"
+nerd_icon = "\uF51E"          # 󰔞
+text_icon = "[R]"
+
+# 倒计时图标
+timer_emoji_icon = "⏰"
+timer_nerd_icon = "\uF017"    #
+timer_text_icon = "⏳"
 ```
 
 ### 🖥️ 终端兼容性
@@ -455,6 +528,8 @@ echo '{"model":{"id":"claude-sonnet-4"}}' | npx @amadeus19/cc-statusline@latest
 - 🌐 **Bilingual Support**: Chinese and English configuration interface with error messages
 - 🦀 **Rust Engine**: Native Rust core for faster, more stable statusline updates
 
+> ⚠️ **The Rate Limit component currently only supports GLM Coding Plan** (Zhipu AI Coding Plan) for querying 5h/7d Token quota usage and reset countdown. Other platforms are not supported yet.
+
 ### 🦀 Rust Rewrite Highlights
 
 - Native `git2` repository analysis: reads branch status, stash counts, and operations without spawning shells, keeping large repos responsive
@@ -521,12 +596,13 @@ Open Claude Code and you should see a status bar like this:
 
 Quickly customize status bar content through simple letter combinations:
 
-- **P** = Project (project name)  
+- **P** = Project (project name)
 - **M** = Model (model information)
 - **B** = Branch (Git branch)
 - **T** = Tokens (token usage)
 - **U** = Usage (usage statistics)
 - **S** = Status (status information)
+- **R** = Rate Limit (GLM quota usage)
 
 #### Quick Configuration Commands
 
@@ -534,7 +610,7 @@ Note: These commands are all written in settings.json, not executed directly in
 
 ```bash
 # Show all components (recommended)
-npx @amadeus19/cc-statusline@latest --preset PMBTUS --theme powerline
+npx @amadeus19/cc-statusline@latest --preset PMBTUSR --theme powerline
 
 # Show only model, tokens, and usage
 npx @amadeus19/cc-statusline@latest --preset MTU --theme classic
@@ -574,7 +650,7 @@ Classic theme supports three icon modes, automatically selected based on termina
 
 ![Classic Nerd Font](./assets/classic_nf.png)
 
-**Requires Nerd Font installation and selecting the font in the corresponding terminal**, recommend [Hack Nerd Font](https://github.com/ryanoasis/nerd-fonts/releases/download/v3.2.3/Hack.zip)
+**Requires Nerd Font installation and selecting the font in the corresponding terminal**, recommend [Hack Nerd Font](https://github.com/ryanoasis/nerd-fonts/releases/download/v3.4.0/Hack.zip)
 
 ##### 😊 Emoji Mode
 
@@ -640,6 +716,42 @@ contextUsedTokens = usage.input_tokens +
 
 This ensures that the token usage displayed in the status bar is completely consistent with Claude's official statistics.
 
+### 🪙 Rate Limit Quota Usage (GLM Coding Plan Only)
+
+The Rate Limit component queries your GLM Coding Plan Token quota usage and reset countdown in real time, helping you manage your API call pace.
+
+> ⚠️ **Currently only supports GLM Coding Plan** (Zhipu AI Coding Plan). Requires `ANTHROPIC_API_KEY` or `ZHIPU_API_KEY` environment variable. Other platforms are not supported yet.
+
+#### Display Contents
+
+- **5-hour usage**: Token consumption percentage and progress bar for the current 5-hour window
+- **7-day usage**: Token consumption percentage and progress bar for the current 7-day window
+- **Reset countdown**: Time remaining until the quota window resets
+- **MCP stats**: MCP call count and quota
+
+#### Configuration Example
+
+```toml
+[components.rate_limit]
+enabled = true
+
+[components.rate_limit.glm_usage]
+enabled = true
+cache_ttl = 300        # Cache TTL in seconds
+timeout_ms = 5000      # Request timeout in milliseconds
+retry_attempts = 2     # Retry attempts
+
+[components.rate_limit.glm_usage.thresholds]
+warning = 80           # 80% shows yellow warning
+danger = 95            # 95% shows red danger
+
+[components.rate_limit.display]
+show_5h_progress_bar = true
+show_7d_progress_bar = true
+show_countdown = true
+progress_width = 8
+```
+
 ### 💰 Cost Calculation Explanation
 
 #### Intelligent Cost Tracking System
@@ -765,6 +877,26 @@ critical = 95   # 95% shows 🔥 critical
 force_nerd_font = false     # Force enable Nerd Font
 force_emoji = false         # Force enable Emoji
 force_text = false          # Force text mode
+
+# Rate Limit quota usage (GLM Coding Plan only)
+[components.rate_limit]
+enabled = true
+
+[components.rate_limit.glm_usage]
+enabled = true
+cache_ttl = 300
+timeout_ms = 5000
+retry_attempts = 2
+
+[components.rate_limit.glm_usage.thresholds]
+warning = 80
+danger = 95
+
+[components.rate_limit.display]
+show_5h_progress_bar = true
+show_7d_progress_bar = true
+show_countdown = true
+progress_width = 8
 ```
 
 ### 🖥️ Terminal Compatibility

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@amadeus19/cc-statusline",
-  "version": "3.2.3",
+  "version": "3.2.4",
   "description": "Claude Code Statusline Pro - Rust-powered statusline",
   "license": "MIT",
   "bin": {