cc-usage-bar 0.4.1 → 0.4.2

package/AGENTS.md

@@ -171,11 +171,11 @@ CC_USAGE_COLORS_BALANCE='0:cyan,60:yellow,90:red'
 # 自定义填充/空槽字符（cells）
 --bar-spec='{"mode":"cells","filled":"▰","empty":"▱","width":12}'
 
-# 单色渐变（tint）—— 完成部分上色，剩余部分变暗
---bar-spec='{"mode":"tint","text":"████████","emptyStyle":"dim"}'
+# 单色渐变（tint）—— 默认 reverse：完成部分反色底块，剩余部分变暗
+--bar-spec='{"mode":"tint","text":"Ciallo~(∠・ω< )⌒★"}'
 
-# 反色填充（reverse）—— 完成部分用反色底块增强对比
---bar-spec='{"mode":"tint","text":"Ciallo~(∠・ω< )⌒★","style":"reverse"}'
+# 想要旧的"只染前景"效果，显式加 style:"fg"
+--bar-spec='{"mode":"tint","text":"████████","style":"fg","emptyStyle":"dim"}'
 
 # 动画帧（frames）—— 按百分比从帧序列里挑一帧
 --bar-spec='{"mode":"frames","frames":["⠋","⠙","⠹","⠸","⠼","⠴","⠦","⠧","⠇","⠏"]}'

package/README.md

@@ -20,6 +20,36 @@ Or, with `--format=bar-time`:
 [█████░░░░░] 47% until 18:00 / [██████░░░░] 59% until 5/9 09:00
 ```
 
+## Quick usage
+
+### Method 1: Command line
+
+```bash
+npm install -g cc-usage-bar@latest
+cc-usage-bar install --format=bar-countdown
+```
+
+If you already have a Claude Code statusline command, the installer keeps it as the prefix and appends the usage bar. Run diagnostics any time with:
+
+```bash
+cc-usage-bar status
+```
+
+### Method 2: Ask an AI assistant
+
+In Claude Code, Cursor, Codex, or another coding assistant, say:
+
+```text
+Install cc-usage-bar for my Claude Code statusline.
+Keep my existing statusline prefix and use the bar-countdown format.
+```
+
+If the assistant needs exact instructions, give it the AI-readable guide:
+
+```bash
+npx cc-usage-bar@latest agents
+```
+
 ## Install
 
 ```bash
@@ -111,16 +141,16 @@ cc-usage-bar install --format=bar-time \
   --bar-spec='{"mode":"tint","text":"Ciallo～(∠・ω< )⌒★"}'
 ```
 
-`tint` keeps the whole text visible and colors the completed prefix while dimming the rest:
+`tint` keeps the whole text visible. By default the completed prefix is rendered as a reversed-color block (high contrast), and the rest is dimmed:
 
 ```json
 {"mode":"tint","text":"Ciallo～(∠・ω< )⌒★"}
 ```
 
-For stronger contrast, add `style:"reverse"` so the completed prefix is rendered as a reversed-color block:
+If you prefer the older "color the foreground only" look, set `style:"fg"`:
 
 ```json
-{"mode":"tint","text":"Ciallo～(∠・ω< )⌒★","style":"reverse"}
+{"mode":"tint","text":"Ciallo～(∠・ω< )⌒★","style":"fg"}
 ```
 
 `cells` replaces the default block characters:

package/README.zh-CN.md

@@ -22,6 +22,36 @@
 [█████░░░░░] 47% until 18:00 / [██████░░░░] 59% until 5/9 09:00
 ```
 
+## 快速使用
+
+### 方法一：正常命令行
+
+```bash
+npm install -g cc-usage-bar@latest
+cc-usage-bar install --format=bar-countdown
+```
+
+如果你已经有自己的 Claude Code statusline 命令，安装器会把它保留为前缀，再追加用量条。需要诊断时运行：
+
+```bash
+cc-usage-bar status
+```
+
+### 方法二：直接和大模型交流
+
+在 Claude Code、Cursor、Codex 或其他编程助手里直接说：
+
+```text
+请安装 cc-usage-bar 并帮我配置 Claude Code statusline。
+保留我原来的 statusline 前缀，使用 bar-countdown 格式。
+```
+
+如果大模型需要更精确的操作说明，把下面命令输出的 AI 可读安装指南发给它：
+
+```bash
+npx cc-usage-bar@latest agents
+```
+
 ## 安装
 
 ```bash
@@ -111,7 +141,7 @@ cc-usage-bar install --format <preset> --bar-width <n>
 
 #### tint：整段文字始终可见
 
-推荐给颜文字、短句、logo 风格文本。已完成部分会染色，未完成部分会变暗，但整段文字一直可见：
+推荐给颜文字、短句、logo 风格文本。整段文字一直可见，**默认**已完成部分会用反色底块（reverse）增强对比，未完成部分变暗：
 
 ```bash
 cc-usage-bar install --format=bar-time \
@@ -122,10 +152,10 @@ cc-usage-bar install --format=bar-time \
 {"mode":"tint","text":"Ciallo～(∠・ω< )⌒★"}
 ```
 
-如果想让完成部分更像“填充底块”，可以加 `style:"reverse"`，完成部分会用反色块增强对比：
+如果更喜欢"只给完成部分上前景色、不反色"的旧风格，显式加 `style:"fg"`：
 
 ```json
-{"mode":"tint","text":"Ciallo～(∠・ω< )⌒★","style":"reverse"}
+{"mode":"tint","text":"Ciallo～(∠・ω< )⌒★","style":"fg"}
 ```
 
 #### cells：替换默认块字符

package/dist/src/format.js

@@ -147,8 +147,7 @@ function parseBarSpec(raw) {
         const out = { mode: 'tint', text: obj.text };
         if (obj.emptyStyle === 'plain' || obj.emptyStyle === 'dim')
             out.emptyStyle = obj.emptyStyle;
-        if (obj.style === 'fg' || obj.style === 'reverse')
-            out.style = obj.style;
+        out.style = obj.style === 'fg' ? 'fg' : 'reverse';
         return out;
     }
     if (obj.mode === 'frames') {

package/dist/src/providers/minimax.js

@@ -3,13 +3,8 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.minimaxAdapter = void 0;
 exports.parseMinimax = parseMinimax;
 const http_1 = require("./http");
-function tier(total, used, endMs) {
-    if (typeof total !== 'number' || typeof used !== 'number' || total <= 0)
-        return undefined;
-    return {
-        utilization: ((total - (total - used)) / total) * 100,
-        resets_at: typeof endMs === 'number' ? new Date(endMs).toISOString() : undefined,
-    };
+function isoFromMs(ms) {
+    return typeof ms === 'number' ? new Date(ms).toISOString() : undefined;
 }
 function parseMinimax(body) {
     if (!body || typeof body !== 'object')
@@ -19,16 +14,22 @@ function parseMinimax(body) {
     if (typeof code === 'number' && code !== 0) {
         return { error: r.base_resp?.status_msg ?? `MiniMax error ${code}` };
     }
-    const remains = r.model_remains?.[0];
-    if (!remains)
+    if (!Array.isArray(r.model_remains))
+        return null;
+    const item = r.model_remains.find((m) => m && m.model_name === 'general');
+    if (!item)
         return null;
     const out = { kind: 'subscription', planName: 'MiniMax' };
-    const fh = tier(remains.current_interval_total_count, remains.current_interval_usage_count, remains.end_time);
-    if (fh)
-        out.five_hour = fh;
-    const wk = tier(remains.current_weekly_total_count, remains.current_weekly_usage_count, remains.weekly_end_time);
-    if (wk)
-        out.seven_day = wk;
+    const fhRemain = item.current_interval_remaining_percent;
+    if (typeof fhRemain === 'number') {
+        out.five_hour = { utilization: 100 - fhRemain, resets_at: isoFromMs(item.end_time) };
+    }
+    if (item.current_weekly_status === 1) {
+        const wkRemain = item.current_weekly_remaining_percent;
+        if (typeof wkRemain === 'number') {
+            out.seven_day = { utilization: 100 - wkRemain, resets_at: isoFromMs(item.weekly_end_time) };
+        }
+    }
     if (!out.five_hour && !out.seven_day)
         return null;
     return out;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cc-usage-bar",
-  "version": "0.4.1",
+  "version": "0.4.2",
   "description": "Show your Claude Code subscription usage (5h / 7d, or balance) in the statusline. Supports Anthropic, Kimi, GLM, MiniMax, DeepSeek, StepFun, SiliconFlow, OpenRouter, Novita.",
   "keywords": [
     "claude",