@cxmyu/ccglance 1.2.2 → 1.3.0

package/README.md

@@ -4,18 +4,18 @@
 
 **A fast, zero-dependency, multi-line status line for [Claude Code](https://docs.anthropic.com/en/docs/claude-code)**
 
-model · effort · context · cache · git · session — all at a glance
+model · effort · context · prompt cache · limits · git · session — all at a glance
 
 [![Node.js >= 22](https://img.shields.io/badge/node-%3E%3D22-3c873a)](https://nodejs.org/)
 [![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](./LICENSE)
 
 [English](./README.md) · [简体中文](./README.zh-CN.md) · [GitHub](https://github.com/CxMYu/CcGlanceLine)
 
-**Windows 11 · Segoe UI Emoji**
+**Windows 11 · Segoe UI Emoji · Claude Code 2.1.258 sample**
 
 ![ccglance on Windows 11](./docs/assets/preview-windows.png)
 
-**macOS · Apple Color Emoji**
+**macOS · Apple Color Emoji · Claude Code 2.1.258 sample**
 
 ![ccglance on macOS](./docs/assets/preview-macos.png)
 
@@ -23,6 +23,12 @@ model · effort · context · cache · git · session — all at a glance
 
 > **stdin-first · zero runtime dependencies · fixed emoji style** — renders the JSON Claude Code pipes to its status-line command; only the `status` segment reads a bounded transcript tail. Written in TypeScript, shipped as compiled JavaScript; runs on Node.js ≥ 22 or Bun.
 
+Current Claude Code cache and usage-limit fields are covered, including the
+latest request's prompt-cache hit ratio and token traffic, warm/cold state, and
+the Hour, Week, and account Limit usage windows.
+Older Claude Code versions keep working through optional fields and the legacy
+cache calculation.
+
 **Docs:** [Overview](./docs/overview.md) · [Segments & icons](./docs/segments.md) · [Development](./docs/development.md)
 
 ## Terminal Font

package/README.zh-CN.md

@@ -4,18 +4,18 @@
 
 **面向 [Claude Code](https://docs.anthropic.com/en/docs/claude-code) 的快速、零依赖多行状态栏**
 
-模型 · effort · 上下文 · 缓存 · git · 会话 —— 一眼尽览
+模型 · effort · 上下文 · prompt cache · 限额 · git · 会话 —— 一眼尽览
 
 [![Node.js >= 22](https://img.shields.io/badge/node-%3E%3D22-3c873a)](https://nodejs.org/)
 [![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](./LICENSE)
 
 [English](./README.md) · [简体中文](./README.zh-CN.md) · [GitHub](https://github.com/CxMYu/CcGlanceLine)
 
-**Windows 11 · Segoe UI Emoji**
+**Windows 11 · Segoe UI Emoji · Claude Code 2.1.258 示例**
 
 ![ccglance 在 Windows 11 上的效果](./docs/assets/preview-windows.png)
 
-**macOS · Apple Color Emoji**
+**macOS · Apple Color Emoji · Claude Code 2.1.258 示例**
 
 ![ccglance 在 macOS 上的效果](./docs/assets/preview-macos.png)
 
@@ -23,6 +23,10 @@
 
 > **stdin 优先 · 运行时零依赖 · 固定 emoji 风格** —— 渲染 Claude Code 经 stdin 传入的 JSON;仅 `status` 段读取 transcript 尾部固定字节。TypeScript 编写,以编译后的 JavaScript 发布,可在 Node.js ≥ 22 或 Bun 上运行。
 
+已覆盖新版 Claude Code 的缓存和限额字段，包括最近一次请求的 prompt cache 命中率与
+token 流量、缓存冷热状态，以及 Hour、Week 和账户 Limit 三类用量窗口。旧版 Claude Code 缺少这些可选字段时，
+仍会自动沿用原有缓存计算逻辑。
+
 **文档:** [概览](./docs/overview.zh-CN.md) · [字段与图标](./docs/segments.zh-CN.md) · [开发](./docs/development.zh-CN.md)
 
 ## 终端字体

package/dist/cli.js

@@ -13,16 +13,24 @@ const PREVIEW_SAMPLE = {
         used_percentage: 23.5, remaining_percentage: 76.5,
         current_usage: { output_tokens: 1200, cache_read_input_tokens: 172000, cache_creation_input_tokens: 15000 },
     },
+    prompt_cache: {
+        warm: true, caching_observed: true, ttl: '1h',
+        expires_at: Math.floor(Date.now() / 1000) + 45 * 60,
+        requests: 14, misses: 2, expected_rebuilds: 1, hit_ratio: 0.91,
+        cache_write_tokens: 352000, miss_recache_tokens: 310200,
+        recache_tokens_if_cold: 45000,
+    },
     output_style: { name: 'default' },
     rate_limits: {
         five_hour: { used_percentage: 23.5, resets_at: Math.floor(Date.now() / 1000) + 2 * 3600 },
         seven_day: { used_percentage: 41.2, resets_at: Math.floor(Date.now() / 1000) + 3 * 86400 },
+        spend_limit: { used_percentage: 62.8, resets_at: Math.floor(Date.now() / 1000) + 30 * 86400 },
     },
     workspace: { current_dir: process.cwd() },
     worktree: { name: 'main', branch: 'main' },
     session_name: 'ccglance',
     cost: { total_cost_usd: 0.1234, total_duration_ms: 192000, total_lines_added: 156, total_lines_removed: 23 },
-    version: '2.1.221',
+    version: '2.1.258',
 };
 const argv = process.argv.slice(2);
 // 用法 + 「安装后要做什么」指引。终端直接运行或 --help 时打印；此路径绝不读 stdin。

package/dist/defaults/index.js

@@ -26,11 +26,11 @@ exports.DEFAULT_SPEC = {
         cache: { enabled: true },
         rate_limits: {
             enabled: true,
-            show: 'both',
+            show: 'all',
             warnPct: 70,
             dangerPct: 90,
             showReset: true,
-            labels: { five_hour: 'Hour', seven_day: 'Week' },
+            labels: { five_hour: 'Hour', seven_day: 'Week', spend_limit: 'Limit' },
         },
         style: { enabled: true },
         dir: { enabled: true, fullPath: false },

package/dist/segments/index.js

@@ -31,8 +31,22 @@ function positive(v) {
 function statusIcon(ctx, key, fallback) {
     return opt(ctx, 'status').statusIcons?.[key] || fallback;
 }
-function fmtRatePct(v) {
-    return Math.max(0, Math.min(100, Math.round(v))) + '%';
+function fmtRatePct(v, allowOver100 = false) {
+    const rounded = Math.max(0, Math.round(v));
+    return (allowOver100 ? rounded : Math.min(100, rounded)) + '%';
+}
+// Prompt-cache TTLs are short; minute precision stays compact and avoids a noisy seconds countdown.
+function fmtCacheRemaining(epochSec, nowMs) {
+    const expiry = num(epochSec);
+    if (expiry == null)
+        return null;
+    const ms = expiry * 1000 - nowMs;
+    if (ms <= 0)
+        return null;
+    const minutes = Math.max(1, Math.ceil(ms / 60000));
+    const hours = Math.floor(minutes / 60);
+    const rest = minutes % 60;
+    return hours ? `${hours}h${rest ? `${rest}m` : ''}` : `${minutes}m`;
 }
 // 会话状态：读 transcript 尾部推断；默认仅显示图标，工具态附带工具名。
 const status = (ctx) => {
@@ -93,12 +107,34 @@ const cache = (ctx) => {
     const cw = ctx.data.context_window;
     if (!cw)
         return null;
-    const cu = cw.current_usage || {};
-    const used = nonNegative(cw.total_input_tokens) ?? nonNegative(cu.input_tokens) ?? 0;
-    const read = nonNegative(cu.cache_read_input_tokens) ?? 0;
-    const write = nonNegative(cu.cache_creation_input_tokens) ?? 0;
-    const hitPct = used > 0 && read > 0 ? read / used * 100 : 0;
-    return iconSeg(ctx, 'cache', colors_1.C.cache, 'cache', `${(0, format_1.fmtPct)(hitPct)}${colors_1.DOT}↓${(0, format_1.fmtTokens)(read)}${colors_1.DOT}↑${(0, format_1.fmtTokens)(write)}`);
+    const cu = cw.current_usage;
+    const read = nonNegative(cu?.cache_read_input_tokens) ?? 0;
+    const write = nonNegative(cu?.cache_creation_input_tokens) ?? 0;
+    const fresh = nonNegative(cu?.input_tokens);
+    const latestTotal = fresh != null
+        ? fresh + read + write
+        : nonNegative(cw.total_input_tokens);
+    const latestHitPct = cu && latestTotal != null
+        ? latestTotal > 0 ? Math.max(0, Math.min(100, read / latestTotal * 100)) : 0
+        : null;
+    const pc = ctx.data.prompt_cache;
+    const ratio = pc?.caching_observed === true ? num(pc.hit_ratio) : null;
+    const sessionHitPct = ratio != null ? Math.max(0, Math.min(1, ratio)) * 100 : null;
+    const parts = latestHitPct != null
+        ? [(0, format_1.fmtPct)(latestHitPct), `↓${(0, format_1.fmtTokens)(read)}`, `↑${(0, format_1.fmtTokens)(write)}`]
+        : sessionHitPct != null
+            ? [`Avg ${(0, format_1.fmtPct)(sessionHitPct)}`]
+            : ['0%', '↓0', '↑0'];
+    if (pc?.caching_observed === true && pc.warm === true) {
+        const remaining = fmtCacheRemaining(pc.expires_at, ctx.nowMs);
+        const ttl = typeof pc.ttl === 'string' ? pc.ttl.trim() : '';
+        parts.push(`🔥${remaining || ttl}`);
+    }
+    else if (pc?.caching_observed === true && pc.warm === false) {
+        const recache = positive(pc.recache_tokens_if_cold);
+        parts.push(`🧊${recache != null ? `↻${(0, format_1.fmtTokens)(recache)}` : ''}`);
+    }
+    return iconSeg(ctx, 'cache', colors_1.C.cache, 'cache', parts.join(colors_1.DOT));
 };
 const rateLimits = (ctx) => {
     const rl = ctx.data.rate_limits;
@@ -110,6 +146,7 @@ const rateLimits = (ctx) => {
     const labels = {
         five_hour: o.labels?.five_hour || 'Hour',
         seven_day: o.labels?.seven_day || 'Week',
+        spend_limit: o.labels?.spend_limit || 'Limit',
     };
     const normal = optTextColor(ctx, 'rate_limits', colors_1.C.rate);
     const bold = optBold(ctx, 'rate_limits');
@@ -123,18 +160,18 @@ const rateLimits = (ctx) => {
                     : pct >= 10 ? '🌒' : '🌑';
         return (0, colors_1.paint)(color, glyph, bold);
     };
-    const pushWindow = (label, win) => {
-        if (!win || win.used_percentage == null)
+    const pushWindow = (label, win, allowOver100 = false) => {
+        const pct = nonNegative(win?.used_percentage);
+        if (pct == null)
             return;
-        const pct = win.used_percentage;
         const warn = o.warnPct != null ? o.warnPct : 70;
         const danger = o.dangerPct != null ? o.dangerPct : 90;
         const winColor = pctColor(pct, warn, danger, normal);
-        const reset = showReset ? (0, format_1.fmtResetIn)(win.resets_at, ctx.nowMs) : null;
+        const reset = showReset ? (0, format_1.fmtResetIn)(win?.resets_at, ctx.nowMs) : null;
         const detail = [
             (0, colors_1.paint)(normal, label, bold),
             meter(pct, winColor),
-            (0, colors_1.paint)(winColor, fmtRatePct(pct), bold),
+            (0, colors_1.paint)(winColor, fmtRatePct(pct, allowOver100), bold),
         ];
         if (reset)
             detail.push((0, colors_1.paint)(colors_1.C.rateReset, '⏳', bold), (0, colors_1.paint)(colors_1.C.rateReset, reset, bold));
@@ -147,6 +184,9 @@ const rateLimits = (ctx) => {
     if (wants(['all', 'both', 'seven_day'])) {
         pushWindow(labels.seven_day, rl.seven_day);
     }
+    if (wants(['all', 'spend_limit'])) {
+        pushWindow(labels.spend_limit, rl.spend_limit, true);
+    }
     if (!parts.length)
         return null;
     const col = pctColor(maxUsed, o.warnPct != null ? o.warnPct : 70, o.dangerPct != null ? o.dangerPct : 90, normal);

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@cxmyu/ccglance",
-  "version": "1.2.2",
-  "description": "A fast, zero-dependency, multi-line status line for Claude Code — model, effort, context, cache, git and session, all at a glance.",
+  "version": "1.3.0",
+  "description": "A fast, zero-dependency Claude Code status line for model, effort, context, prompt cache, usage limits, git and session.",
   "bin": {
     "ccglance": "dist/cli.js"
   },