glm-quota-line 0.8.0 → 1.0.0

package/CHANGELOG.md

@@ -1,5 +1,26 @@
 # Changelog
 
+## 1.0.0
+
+- Replaced `theme`/`palette` two-config system with unified `theme` presets: `dark`, `light`, `mono`
+- Removed `palette` config and CLI flag entirely
+- Removed `display=both` option; display now supports only `left` (default) and `used`
+- Removed `bar-width` config option; bar width is fixed at 10
+- Changed default style from `text` to `bar`
+- Bar fill now represents remaining quota by default (was used); `display=used` fills by usage
+- Added `light` theme with blue accents for light terminals
+- `loadConfig` now reads `~/.claude/settings.json` env as a fallback auth source
+- `loadConfig` changed from sync to async; all callers updated
+- Updated README with complete config reference, display docs, and terminal quick-check usage
+
+## 0.9.0
+
+- Replaced progressive tier-based backoff with diamond-shaped refresh strategy: high quota (80–100%) refreshes every 2 min, medium (30–79%) every 5 min, low (0–29%) every 2 min — frequent updates when usage is active or quota is near exhaustion, relaxed in between
+- Added failure-type-aware retry TTLs: rate-limited (429) retries after 3 min, unavailable retries after 2 min, instead of reusing the quota-based TTL
+- Removed `refreshCount`/`tierIndex` cache fields and `advanceTier()` — cache format is now simpler, and TTL is derived purely from quota percentage
+- Aligned severity threshold (danger/warn boundary) from hardcoded 25% to `LOW_QUOTA_THRESHOLD` (30%), consistent with the refresh band boundary
+- Unknown CLI commands and invalid config subcommands now print an error and exit with code 1 instead of silently showing quota status
+
 ## 0.8.0
 
 - Added progressive refresh backoff: new sessions start at 3-minute intervals, advance to 5 minutes after 5 refreshes, and cap at 10 minutes after 5 more — giving new users fast feedback while reducing API pressure in long sessions

package/README.en.md

@@ -1,7 +1,7 @@
 <h1 align="center">glm-quota-line</h1>
 
 <p align="center">
-  One-command install, zero dependencies. Shows accurate Zhipu GLM Coding Plan quota balance and reset time in the Claude Code status line — data from the official API, not estimated.
+  A Zhipu GLM Coding Plan quota monitor built for Claude Code. Accurate, real-time data from the official site — no window switching, just glance and go.
 </p>
 
 <p align="center">
@@ -15,15 +15,14 @@
   <a href="./README.md">简体中文</a>
 </p>
 
-`glm-quota-line` reads the Zhipu GLM Coding Plan quota API, caches results, and prints a short status line for Claude Code's `statusLine.command`. A `SessionStart` hook pre-refreshes the cache so new sessions never show stale data.
-
 ## Features
 
-- **One-command install** — `glm-quota-line install` wires status line and `SessionStart` hooks into Claude Code automatically
-- **Accurate quota display** — reads directly from the official GLM quota API, not estimated; shows both 5-hour and weekly token quotas
+- **Terminal quick check** — run `glm-quota-line` in any terminal to view your quota without launching Claude Code
+- **Claude Code status line** — auto-embeds in the status bar after install, shows quota balance and reset time in real time
+- **Bar visualization** — default bar style shows remaining quota at a glance
+- **Smart caching** — tiered refresh by session, TTL, and token usage; `SessionStart` hook pre-refreshes so new sessions never show stale data
 - **Domestic + international endpoints** — auto-detects `open.bigmodel.cn` and `api.z.ai`
 - **Zero dependencies** — no runtime deps, single-purpose CLI
-- **Smart caching** — refreshes by session, TTL, and token usage; supports manual auth overrides for proxy/gateway setups
 
 ## Quick Start
 
@@ -32,13 +31,13 @@ npm install -g glm-quota-line
 glm-quota-line install
 ```
 
-That's it — works out of the box. Default output (`style=text`, `theme=ansi`, `palette=dark`):
+Done. Your Claude Code status bar will now show the quota:
 
-```text
-GLM Lite | 5h 91% | week 47% | reset 14:47
+```
+GLM Lite █████████░ 91% | W 47% | 14:47
 ```
 
-Both the 5-hour quota (primary) and weekly quota (secondary) are shown with automatic reset time.
+You can also run `glm-quota-line` directly in the terminal to check your quota without launching Claude Code.
 
 Upgrade:
 
@@ -47,38 +46,52 @@ npm install -g glm-quota-line
 glm-quota-line check-update
 ```
 
-## Custom Styles
+## Configuration
+
+All options are optional. Persist with `glm-quota-line config set`, or override per-invocation with CLI flags.
 
-All style options are optional — adjust only if needed:
+### style — Output layout
+
+| Value | Description | Example |
+|---|---|---|
+| `bar` (default) | Progress bar | `GLM Lite █████████░ 91% \| W 47% \| 14:47` |
+| `text` | Full text | `GLM Lite \| 5h 91% \| week 47% \| reset 14:47` |
+| `compact` | Compact mode | `GLM 5h 91% W 47% \| 14:47` |
 
 ```bash
-glm-quota-line config set style bar       # layout: text / compact / bar
-glm-quota-line config set theme ansi      # color: plain / ansi
-glm-quota-line config set palette dark    # palette: dark / mono (only when theme=ansi)
+glm-quota-line config set style compact
 ```
 
-Different `style` outputs:
-
-```text
-# style=text (default)
-GLM Lite | 5h 91% | week 47% | reset 14:47
+### theme — Color theme
 
-# style=compact
-GLM 5h 91% W 47% | 14:47
+| Value | Description |
+|---|---|
+| `dark` (default) | Dark terminal, strongest color contrast |
+| `light` | White/light terminal, blue-tinted accents |
+| `mono` | Grayscale, minimal distraction |
 
-# style=bar
-GLM Lite █░░░░░░░░░ 91% | W 47% | 14:47
+```bash
+glm-quota-line config set theme light
 ```
 
-Recommended combinations:
+Quota percentage colors change automatically based on remaining amount:
+
+- Green — remaining >= 60%
+- Yellow — remaining 30%–60%
+- Red — remaining < 30%
 
-| Use case       | Config                                        |
-| -------------- | --------------------------------------------- |
-| Dark terminal  | `style=bar`, `theme=ansi`, `palette=dark`     |
-| Light terminal | `style=compact`, `theme=ansi`, `palette=mono` |
-| Plain fallback | any `style`, `theme=plain`                    |
+### display — Quota metric
 
-## Custom Auth
+| Value | Description |
+|---|---|
+| `left` (default) | Show remaining quota (bar fills with remaining) |
+| `used` | Show used quota (bar fills with used) |
+
+```bash
+glm-quota-line config set display used
+```
+
+### auth-token / base-url — Custom auth
 
 If Claude Code runs behind a gateway or proxy and the injected `ANTHROPIC_AUTH_TOKEN` / `ANTHROPIC_BASE_URL` are not the real values:
 
@@ -89,27 +102,38 @@ glm-quota-line config set base-url https://open.bigmodel.cn/api/anthropic
 glm-quota-line config set base-url https://api.z.ai/api/anthropic
 ```
 
-Clear with `glm-quota-line config unset auth-token` / `base-url`. Stored overrides take precedence over Claude-injected environment variables.
+Clear with `glm-quota-line config unset auth-token` / `base-url`.
 
-## Commands
+Auth source priority (highest to lowest):
 
-```bash
-glm-quota-line [--style text|compact|bar] [--display left|used|both]
-               [--theme plain|ansi] [--palette dark|mono]
+1. Values persisted via `config set`
+2. Environment variables `ANTHROPIC_AUTH_TOKEN` / `ANTHROPIC_BASE_URL`
+3. `env` field in `~/.claude/settings.json`
+
+## Recommended Combinations
 
+| Use case | Config |
+|---|---|
+| Dark terminal (default) | `style=bar`, `theme=dark` |
+| Light terminal | `style=bar`, `theme=light` |
+| Minimal setup | `style=compact`, `theme=mono` |
+| Track usage | `style=bar`, `display=used` |
+
+## Command Reference
+
+```bash
+glm-quota-line [--style text|compact|bar] [--display left|used] [--theme dark|light|mono]
 glm-quota-line install [--force]
 glm-quota-line uninstall
 glm-quota-line version
 glm-quota-line check-update
 glm-quota-line config show
-glm-quota-line config set <style|display|theme|palette|auth-token|base-url> <value>
+glm-quota-line config set <style|display|theme|auth-token|base-url> <value>
 glm-quota-line config unset <key>
 ```
 
 Run `glm-quota-line --help` for full descriptions.
 
-Use `glm-quota-line --version` to print the installed version. `check-update` only checks and prints the suggested upgrade command; it does not modify your environment.
-
 ## Notes
 
 - Only `TOKENS_LIMIT` quotas are shown; `TIME_LIMIT` / MCP usage is ignored

package/README.md

@@ -1,7 +1,7 @@
 <h1 align="center">glm-quota-line</h1>
 
 <p align="center">
-  一行命令安装、零依赖，在 Claude Code 状态栏实时显示智谱（Zhipu）GLM Coding Plan 配额余额与重置时间。数据来自官方接口，精准非估算。
+  为 Claude Code 打造的智谱 GLM Coding Plan 配额监控工具。数据精准同步官网，无需切换窗口，随时掌握用量。
 </p>
 
 <p align="center">
@@ -15,15 +15,14 @@
   <a href="./README.en.md">English</a>
 </p>
 
-`glm-quota-line` 读取智谱（Zhipu）GLM Coding Plan 配额接口、缓存结果，并输出一行适合 Claude Code `statusLine.command` 的状态文本。通过 `SessionStart` hook 预刷新缓存，新会话不会显示旧配额。
-
 ## 功能
 
-- **一行命令安装** — `glm-quota-line install` 自动接入 Claude Code 状态栏和 `SessionStart` hook
-- **精准配额显示** — 数据来自官方配额接口，非估算；同时展示 5 小时和周 token 配额
+- **终端快速查询** — 直接运行 `glm-quota-line` 即可在终端查看配额，无需启动 Claude Code
+- **Claude Code 状态栏** — 安装后自动嵌入状态栏，实时显示配额余额和重置时间
+- **进度条可视化** — 默认 bar 风格，一眼看清剩余比例
+- **智能缓存** — 按会话、TTL 和 token 用量分级刷新；`SessionStart` hook 预刷新，新会话不显示旧数据
 - **国内 + 国际端点** — 自动识别 `open.bigmodel.cn` 和 `api.z.ai`
 - **零依赖** — 无运行时依赖，单一用途
-- **智能缓存** — 按会话、TTL 和 token 用量刷新；支持代理/网关手动覆盖鉴权
 
 ## 快速开始
 
@@ -32,13 +31,13 @@ npm install -g glm-quota-line
 glm-quota-line install
 ```
 
-两步完成，开箱即用。默认输出（`style=text`，`theme=ansi`，`palette=dark`）：
+安装完成。Claude Code 底部状态栏会自动显示配额：
 
-```text
-GLM Lite | 5h 91% | week 47% | reset 14:47
+```
+GLM Lite █████████░ 91% | W 47% | 14:47
 ```
 
-同时显示 5 小时配额（主要）和周配额（次要），并自动展示重置时间。
+也可以直接在终端运行 `glm-quota-line` 快速查看用量，无需启动 Claude Code。
 
 升级版本：
 
@@ -47,40 +46,54 @@ npm install -g glm-quota-line
 glm-quota-line check-update
 ```
 
-## 自定义样式
+## 配置项
+
+所有配置均为可选，按需调整。通过 `glm-quota-line config set` 持久化，或用 CLI 参数临时覆盖。
 
-所有样式配置均为可选，按需调整：
+### style — 输出布局
+
+| 值 | 说明 | 示例 |
+|---|---|---|
+| `bar`（默认） | 进度条可视化 | `GLM Lite █████████░ 91% \| W 47% \| 14:47` |
+| `text` | 完整文本 | `GLM Lite \| 5h 91% \| week 47% \| reset 14:47` |
+| `compact` | 紧凑模式 | `GLM 5h 91% W 47% \| 14:47` |
 
 ```bash
-glm-quota-line config set style bar       # 布局: text / compact / bar
-glm-quota-line config set theme ansi      # 配色: plain / ansi
-glm-quota-line config set palette dark    # 色板: dark / mono（仅 theme=ansi 时生效）
+glm-quota-line config set style compact
 ```
 
-不同 style 效果：
-
-```text
-# style=text（默认）
-GLM Lite | 5h 91% | week 47% | reset 14:47
+### theme — 主题配色
 
-# style=compact
-GLM 5h 91% W 47% | 14:47
+| 值 | 说明 |
+|---|---|
+| `dark`（默认） | 深色终端，彩色对比最强 |
+| `light` | 浅色/白色终端，蓝调配色 |
+| `mono` | 灰阶，极简低干扰 |
 
-# style=bar
-GLM Lite █░░░░░░░░░ 91% | W 47% | 14:47
+```bash
+glm-quota-line config set theme light
 ```
 
-推荐搭配：
+配额百分比会根据剩余量自动变色：
 
-| 使用场景   | 配置                                          |
-| ---------- | --------------------------------------------- |
-| 深色终端   | `style=bar`, `theme=ansi`, `palette=dark`     |
-| 浅色终端   | `style=compact`, `theme=ansi`, `palette=mono` |
-| 纯文本回退 | 任意 `style`，`theme=plain`                   |
+- 绿色 — 剩余 >= 60%
+- 黄色 — 剩余 30%–60%
+- 红色 — 剩余 < 30%
 
-## 自定义鉴权
+### display — 显示指标
 
-如果 Claude Code 运行在代理或网关后面，注入的 `ANTHROPIC_AUTH_TOKEN` / `ANTHROPIC_BASE_URL` 不是实际值：
+| 值 | 说明 |
+|---|---|
+| `left`（默认） | 显示剩余量（进度条填充 = 剩余比例） |
+| `used` | 显示已用量（进度条填充 = 已用比例） |
+
+```bash
+glm-quota-line config set display used
+```
+
+### auth-token / base-url — 自定义鉴权
+
+当 Claude Code 运行在代理或网关后面时，注入的 `ANTHROPIC_AUTH_TOKEN` / `ANTHROPIC_BASE_URL` 可能不是实际值，可手动覆盖：
 
 ```bash
 glm-quota-line config set auth-token <your-real-token>
@@ -89,26 +102,37 @@ glm-quota-line config set base-url https://open.bigmodel.cn/api/anthropic
 glm-quota-line config set base-url https://api.z.ai/api/anthropic
 ```
 
-清除：`glm-quota-line config unset auth-token` / `base-url`。手动保存的值优先于 Claude 注入的环境变量。
+清除：`glm-quota-line config unset auth-token` / `base-url`。
 
-## 命令
+鉴权来源优先级（从高到低）：
 
-```bash
-glm-quota-line [--style text|compact|bar] [--display left|used|both]
-               [--theme plain|ansi] [--palette dark|mono]
+1. `config set` 持久化的值
+2. 环境变量 `ANTHROPIC_AUTH_TOKEN` / `ANTHROPIC_BASE_URL`
+3. `~/.claude/settings.json` 中的 `env` 字段
+
+## 推荐搭配
 
+| 使用场景 | 配置 |
+|---|---|
+| 深色终端（默认） | `style=bar`, `theme=dark` |
+| 浅色终端 | `style=bar`, `theme=light` |
+| 极简工作流 | `style=compact`, `theme=mono` |
+| 关注已用量 | `style=bar`, `display=used` |
+
+## 命令参考
+
+```bash
+glm-quota-line [--style text|compact|bar] [--display left|used] [--theme dark|light|mono]
 glm-quota-line install [--force]
 glm-quota-line uninstall
 glm-quota-line version
 glm-quota-line check-update
 glm-quota-line config show
-glm-quota-line config set <style|display|theme|palette|auth-token|base-url> <value>
+glm-quota-line config set <style|display|theme|auth-token|base-url> <value>
 glm-quota-line config unset <key>
 ```
 
-完整说明运行 `glm-quota-line --help`。
-
-`glm-quota-line --version` 可直接查看当前安装版本；`check-update` 只检查并提示升级命令，不会自动修改环境。
+运行 `glm-quota-line --help` 查看完整说明。
 
 ## 说明
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "glm-quota-line",
-  "version": "0.8.0",
+  "version": "1.0.0",
   "description": "Zhipu GLM Coding Plan quota monitor for Claude Code status line.",
   "type": "module",
   "license": "MIT",

package/src/claude/sessionStart.js

@@ -11,7 +11,7 @@ export async function refreshQuotaOnSessionStart(options = {}) {
   const loadConfigFn = options.loadConfigFn ?? loadConfig;
   const resolveQuotaStatusFn = options.resolveQuotaStatusFn ?? resolveQuotaStatus;
   const config = {
-    ...loadConfigFn(options.env ?? process.env, userConfig),
+    ...(await loadConfigFn(options.env ?? process.env, userConfig)),
     sessionId: hookInput?.session_id || ""
   };
 

package/src/claude/settings.js

@@ -5,7 +5,6 @@ import {
   TOOL_CONFIG_MANAGED_BY,
   TOOL_CONFIG_SCHEMA_VERSION,
   isValidDisplayMode,
-  isValidPalette,
   isValidStatusStyle,
   isValidTheme
 } from "../shared/constants.js";
@@ -56,10 +55,6 @@ function normalizeToolConfig(config) {
     normalized.theme = base.theme;
   }
 
-  if (isValidPalette(base.palette)) {
-    normalized.palette = base.palette;
-  }
-
   const authToken = normalizeOptionalString(base.authToken);
   if (authToken) {
     normalized.authToken = authToken;

package/src/cli/args.js

@@ -59,14 +59,6 @@ export function parseArgs(argv = process.argv.slice(2)) {
       }
       continue;
     }
-
-    if (arg === "--palette" || arg.startsWith("--palette=")) {
-      options.palette = takeValue(argv, index);
-      if (!arg.includes("=")) {
-        index += 1;
-      }
-      continue;
-    }
   }
 
   options.positionals = positionals;

package/src/cli/commands.js

@@ -1,6 +1,5 @@
 import {
   isValidDisplayMode,
-  isValidPalette,
   isValidStatusStyle,
   isValidTheme
 } from "../shared/constants.js";
@@ -42,17 +41,12 @@ const CONFIG_KEYS = {
   display: {
     property: "displayMode",
     validate: isValidDisplayMode,
-    invalidMessage: "Invalid display. Use: left, used, or both."
+    invalidMessage: "Invalid display. Use: left or used."
   },
   theme: {
     property: "theme",
     validate: isValidTheme,
-    invalidMessage: "Invalid theme. Use: plain or ansi."
-  },
-  palette: {
-    property: "palette",
-    validate: isValidPalette,
-    invalidMessage: "Invalid palette. Use: dark or mono."
+    invalidMessage: "Invalid theme. Use: dark, light, or mono."
   },
   "auth-token": {
     property: "authToken",
@@ -149,11 +143,13 @@ export async function handleCommand(args, output = process.stdout, dependencies
   if (command === "config" && subcommand === "set") {
     const configKey = CONFIG_KEYS[key];
     if (!configKey) {
-      output.write("Supported config keys: style, display, theme, palette, auth-token, base-url\n");
+      process.exitCode = 1;
+      output.write("Supported config keys: style, display, theme, auth-token, base-url\n");
       return true;
     }
 
     if (!configKey.validate(value)) {
+      process.exitCode = 1;
       output.write(`${configKey.invalidMessage}\n`);
       return true;
     }
@@ -168,7 +164,8 @@ export async function handleCommand(args, output = process.stdout, dependencies
   if (command === "config" && subcommand === "unset") {
     const configKey = CONFIG_KEYS[key];
     if (!configKey) {
-      output.write("Supported config keys: style, display, theme, palette, auth-token, base-url\n");
+      process.exitCode = 1;
+      output.write("Supported config keys: style, display, theme, auth-token, base-url\n");
       return true;
     }
 
@@ -177,5 +174,17 @@ export async function handleCommand(args, output = process.stdout, dependencies
     return true;
   }
 
+  if (command === "config") {
+    process.exitCode = 1;
+    output.write("Supported config subcommands: show, set, unset\n");
+    return true;
+  }
+
+  if (command) {
+    process.exitCode = 1;
+    output.write(`Unknown command: ${command}\nRun 'glm-quota-line -h' for usage.\n`);
+    return true;
+  }
+
   return false;
 }

package/src/cli/index.js

@@ -10,7 +10,6 @@ import { resolveQuotaStatus } from "../core/quota/service.js";
 import { getPackageVersion } from "../shared/packageInfo.js";
 import {
   isValidDisplayMode,
-  isValidPalette,
   isValidStatusStyle,
   isValidTheme
 } from "../shared/constants.js";
@@ -19,20 +18,19 @@ function printHelp() {
   process.stdout.write(`glm-quota-line
 
 Usage:
-  glm-quota-line [--style text|compact|bar] [--display left|used|both]
-                 [--theme plain|ansi] [--palette dark|mono]
+  glm-quota-line [--style text|compact|bar] [--display left|used]
+                 [--theme dark|light|mono]
   glm-quota-line --version
   glm-quota-line install [--force]
   glm-quota-line uninstall
   glm-quota-line version
   glm-quota-line check-update
   glm-quota-line config set style <text|compact|bar>
-  glm-quota-line config set display <left|used|both>
-  glm-quota-line config set theme <plain|ansi>
-  glm-quota-line config set palette <dark|mono>
+  glm-quota-line config set display <left|used>
+  glm-quota-line config set theme <dark|light|mono>
   glm-quota-line config set auth-token <token>
   glm-quota-line config set base-url <url>
-  glm-quota-line config unset <style|display|theme|palette|auth-token|base-url>
+  glm-quota-line config unset <style|display|theme|auth-token|base-url>
   glm-quota-line config show
 
 Commands:
@@ -47,9 +45,8 @@ Commands:
 
 Options:
   --style                 Output layout: text, compact, or bar.
-  --display               Quota metric: left, used, or both.
-  --theme                 Color mode: plain or ansi.
-  --palette               ANSI palette: dark for dark terminals, mono for light terminals.
+  --display               Quota metric: left or used.
+  --theme                 Theme preset: dark, light, or mono.
   --force                 Allow install to replace an unmanaged Claude status line.
   -v, --version           Show the installed version.
   -h, --help              Show this help text.
@@ -57,10 +54,10 @@ Options:
 Examples:
   glm-quota-line
   glm-quota-line --version
-  glm-quota-line --style bar --theme ansi --palette dark
+  glm-quota-line --style bar --theme dark
   glm-quota-line check-update
   glm-quota-line config set style compact
-  glm-quota-line config set theme ansi
+  glm-quota-line config set theme light
   glm-quota-line config set auth-token <your-real-token>
   glm-quota-line install
 
@@ -74,8 +71,7 @@ function getStoredDisplayOverrides(userConfig) {
   return {
     ...(isValidStatusStyle(userConfig.style) ? { style: userConfig.style } : {}),
     ...(isValidDisplayMode(userConfig.displayMode) ? { displayMode: userConfig.displayMode } : {}),
-    ...(isValidTheme(userConfig.theme) ? { theme: userConfig.theme } : {}),
-    ...(isValidPalette(userConfig.palette) ? { palette: userConfig.palette } : {})
+    ...(isValidTheme(userConfig.theme) ? { theme: userConfig.theme } : {})
   };
 }
 
@@ -101,7 +97,7 @@ export async function main() {
     const config = {
       // Stored auth/base-url must override Claude's injected env so users can
       // bypass gateway/proxy credentials when necessary.
-      ...loadConfig(process.env, userConfig),
+      ...(await loadConfig(process.env, userConfig)),
       // Display config precedence is env defaults -> persisted config -> CLI flags.
       ...getStoredDisplayOverrides(userConfig),
       ...args,
@@ -113,9 +109,7 @@ export async function main() {
       `${formatStatus(quotaStatus, {
         displayMode: config.displayMode,
         style: config.style,
-        theme: config.theme,
-        palette: config.palette,
-        barWidth: config.barWidth
+        theme: config.theme
       })}\n`
     );
   } catch {

package/src/core/quota/cache.js

@@ -80,6 +80,10 @@ function normalizeCache(parsed) {
   const savedAt = asFiniteNumber(parsed.savedAt);
   const lastAttemptAt = asFiniteNumber(parsed.lastAttemptAt) ?? savedAt;
   const sessionId = typeof parsed.sessionId === "string" ? parsed.sessionId : "";
+  const lastFailureKind =
+    parsed.lastFailureKind === "rate_limited" || parsed.lastFailureKind === "unavailable"
+      ? parsed.lastFailureKind
+      : null;
 
   if (result && savedAt === null) {
     return null;
@@ -89,21 +93,11 @@ function normalizeCache(parsed) {
     return null;
   }
 
-  const refreshCount =
-    typeof parsed.refreshCount === "number" && Number.isFinite(parsed.refreshCount)
-      ? Math.max(0, Math.floor(parsed.refreshCount))
-      : 0;
-  const tierIndex =
-    typeof parsed.tierIndex === "number" && Number.isFinite(parsed.tierIndex)
-      ? Math.max(0, Math.floor(parsed.tierIndex))
-      : 0;
-
   return {
     savedAt,
     lastAttemptAt,
     sessionId,
-    refreshCount,
-    tierIndex,
+    lastFailureKind,
     result
   };
 }
@@ -114,8 +108,7 @@ async function writeCache(cacheFilePath, cache) {
       ...(Number.isFinite(cache.savedAt) ? { savedAt: cache.savedAt } : {}),
       ...(Number.isFinite(cache.lastAttemptAt) ? { lastAttemptAt: cache.lastAttemptAt } : {}),
       ...(cache.sessionId ? { sessionId: cache.sessionId } : {}),
-      refreshCount: cache.refreshCount ?? 0,
-      tierIndex: cache.tierIndex ?? 0,
+      ...(cache.lastFailureKind ? { lastFailureKind: cache.lastFailureKind } : {}),
       ...(cache.result ? { result: cache.result } : {})
     },
     null,
@@ -142,21 +135,19 @@ export async function writeSuccessCache(cacheFilePath, result, options = {}) {
     savedAt: now,
     lastAttemptAt: now,
     sessionId: options.sessionId || "",
-    refreshCount: options.refreshCount ?? 0,
-    tierIndex: options.tierIndex ?? 0,
+    lastFailureKind: null,
     result
   });
 }
 
-export async function writeRateLimitedCache(cacheFilePath, cached, options = {}) {
+export async function writeFailureCache(cacheFilePath, cached, options = {}) {
   const now = options.now ?? Date.now();
 
   await writeCache(cacheFilePath, {
     savedAt: cached?.savedAt ?? null,
     lastAttemptAt: now,
     sessionId: options.sessionId || cached?.sessionId || "",
-    refreshCount: cached?.refreshCount ?? 0,
-    tierIndex: cached?.tierIndex ?? 0,
+    lastFailureKind: options.failureKind || "unavailable",
     result: cached?.result ?? null
   });
 }

package/src/core/quota/service.js

@@ -1,37 +1,39 @@
 import {
   readCache,
-  writeRateLimitedCache,
+  writeFailureCache,
   writeSuccessCache
 } from "./cache.js";
 import { fetchQuota } from "./fetch.js";
 import { parseQuotaResponse } from "./parse.js";
 import {
-  LOW_QUOTA_THRESHOLD,
-  REFRESH_TIERS
+  RATE_LIMIT_RETRY_TTL_MS,
+  REFRESH_BANDS,
+  UNAVAILABLE_RETRY_TTL_MS
 } from "../../shared/constants.js";
 
 function getCachedStatus(cached) {
   return cached?.result ?? { kind: "unavailable" };
 }
 
-function getEffectiveTtlMs(tierIndex, leftPercent) {
-  if (Number.isFinite(leftPercent) && leftPercent < LOW_QUOTA_THRESHOLD) {
-    return REFRESH_TIERS[0].ttlMs;
+function getRefreshTtlMs(leftPercent) {
+  if (!Number.isFinite(leftPercent)) {
+    return REFRESH_BANDS[1].ttlMs;
   }
 
-  const tier = REFRESH_TIERS[tierIndex];
-  return tier ? tier.ttlMs : REFRESH_TIERS[REFRESH_TIERS.length - 1].ttlMs;
+  const matchedBand = REFRESH_BANDS.find((band) => leftPercent >= band.minLeftPercent);
+  return matchedBand ? matchedBand.ttlMs : REFRESH_BANDS[REFRESH_BANDS.length - 1].ttlMs;
 }
 
-function advanceTier(refreshCount, tierIndex) {
-  const nextCount = refreshCount + 1;
-  const tier = REFRESH_TIERS[tierIndex] ?? REFRESH_TIERS[REFRESH_TIERS.length - 1];
+function getEffectiveTtlMs(cached) {
+  if (cached?.lastFailureKind === "rate_limited") {
+    return RATE_LIMIT_RETRY_TTL_MS;
+  }
 
-  if (nextCount >= tier.maxRefreshes && tierIndex < REFRESH_TIERS.length - 1) {
-    return { refreshCount: 1, tierIndex: tierIndex + 1 };
+  if (cached?.lastFailureKind === "unavailable") {
+    return UNAVAILABLE_RETRY_TTL_MS;
   }
 
-  return { refreshCount: nextCount, tierIndex };
+  return getRefreshTtlMs(cached?.result?.leftPercent);
 }
 
 function shouldRefreshQuota(cached, cacheTtlMs, now, sessionId) {
@@ -60,9 +62,7 @@ export async function resolveQuotaStatus(config, options = {}) {
   }
 
   const cached = await readCache(config.cacheFilePath);
-  const tierIndex = cached?.tierIndex ?? 0;
-  const leftPercent = cached?.result?.leftPercent;
-  const effectiveTtlMs = getEffectiveTtlMs(tierIndex, leftPercent);
+  const effectiveTtlMs = getEffectiveTtlMs(cached);
 
   const shouldRefresh = options.forceRefresh
     ? true
@@ -76,23 +76,9 @@ export async function resolveQuotaStatus(config, options = {}) {
   const parsed = parseQuotaResponse(response);
 
   if (parsed.kind === "success") {
-    const isNewSession = Boolean(sessionId) && cached?.sessionId !== sessionId;
-    const isLowQuota = Number.isFinite(parsed.leftPercent) && parsed.leftPercent < LOW_QUOTA_THRESHOLD;
-
-    let nextTier;
-    if (isNewSession) {
-      nextTier = { refreshCount: 1, tierIndex: 0 };
-    } else if (isLowQuota) {
-      nextTier = { refreshCount: cached?.refreshCount ?? 0, tierIndex };
-    } else {
-      nextTier = advanceTier(cached?.refreshCount ?? 0, tierIndex);
-    }
-
     await writeSuccessCache(config.cacheFilePath, parsed, {
       now,
-      sessionId,
-      refreshCount: nextTier.refreshCount,
-      tierIndex: nextTier.tierIndex
+      sessionId
     });
     return parsed;
   }
@@ -102,16 +88,27 @@ export async function resolveQuotaStatus(config, options = {}) {
   }
 
   if (parsed.kind === "rate_limited") {
-    await writeRateLimitedCache(config.cacheFilePath, cached, {
+    await writeFailureCache(config.cacheFilePath, cached, {
       now,
-      sessionId
+      sessionId,
+      failureKind: "rate_limited"
     });
     return getCachedStatus(cached);
   }
 
   if (cached?.result) {
+    await writeFailureCache(config.cacheFilePath, cached, {
+      now,
+      sessionId,
+      failureKind: "unavailable"
+    });
     return cached.result;
   }
 
+  await writeFailureCache(config.cacheFilePath, cached, {
+    now,
+    sessionId,
+    failureKind: "unavailable"
+  });
   return parsed;
 }

package/src/core/status/bar.js

@@ -1,16 +1,8 @@
-import { DEFAULT_BAR_WIDTH, STATUS_BAR_CHARACTERS } from "../../shared/constants.js";
+import { STATUS_BAR_CHARACTERS } from "../../shared/constants.js";
 
-function normalizeBarWidth(barWidth) {
-  if (!Number.isFinite(barWidth)) {
-    return DEFAULT_BAR_WIDTH;
-  }
-
-  return Math.min(20, Math.max(5, Math.round(barWidth)));
-}
-
-export function buildBar(usedPercent, barWidth, characters = STATUS_BAR_CHARACTERS) {
-  const safePercent = Math.min(100, Math.max(0, usedPercent));
-  const width = normalizeBarWidth(barWidth);
+export function buildBar(percent, characters = STATUS_BAR_CHARACTERS) {
+  const safePercent = Math.min(100, Math.max(0, percent));
+  const width = 10;
   let filledUnits;
 
   if (safePercent <= 0) {
@@ -29,4 +21,3 @@ export function buildBar(usedPercent, barWidth, characters = STATUS_BAR_CHARACTE
     emptyText: characters.empty.repeat(width - filledUnits)
   };
 }
-

package/src/core/status/format.js

@@ -1,6 +1,5 @@
 import {
   normalizeDisplayMode,
-  normalizePalette,
   normalizeStatusStyle,
   normalizeTheme
 } from "../../shared/constants.js";
@@ -30,15 +29,6 @@ function createQuotaTextSegments(quota, displayMode, tone) {
     ];
   }
 
-  if (mode === "both") {
-    return [
-      { text: `${quota.label} left `, tone: "muted" },
-      { text: quota.leftText, tone },
-      { text: " used ", tone: "muted" },
-      { text: quota.usedText, tone }
-    ];
-  }
-
   return [
     { text: `${quota.label} `, tone: "muted" },
     { text: quota.leftText, tone }
@@ -113,7 +103,21 @@ function createCompactSegments(model) {
   return segments;
 }
 
-function createBarSegments(model, barWidth) {
+function createBarMetric(quota, displayMode) {
+  if (normalizeDisplayMode(displayMode) === "used") {
+    return {
+      percent: quota.usedPercent,
+      text: quota.usedText
+    };
+  }
+
+  return {
+    percent: quota.leftPercent,
+    text: quota.leftText
+  };
+}
+
+function createBarSegments(model, displayMode) {
   if (
     !Number.isFinite(model.primaryQuota?.leftPercent) ||
     !Number.isFinite(model.primaryQuota?.usedPercent)
@@ -121,7 +125,8 @@ function createBarSegments(model, barWidth) {
     return createErrorSegments({ kind: "unavailable" });
   }
 
-  const bar = buildBar(model.primaryQuota.usedPercent, barWidth);
+  const metric = createBarMetric(model.primaryQuota, displayMode);
+  const bar = buildBar(metric.percent);
   const severityTone = model.severity;
   const segments = [
     { text: model.levelLabel, tone: "label" },
@@ -129,7 +134,7 @@ function createBarSegments(model, barWidth) {
     { text: bar.filledText, tone: severityTone },
     { text: bar.emptyText, tone: "barEmpty" },
     { text: " ", tone: "plain" },
-    { text: model.primaryQuota.leftText, tone: severityTone }
+    { text: metric.text, tone: severityTone }
   ];
 
   if (model.secondaryQuota) {
@@ -152,8 +157,7 @@ export function formatStatus(result, options = {}) {
 
   if (model.kind !== "success") {
     return applyTheme(createErrorSegments(model), {
-      theme: normalizeTheme(options.theme),
-      palette: normalizePalette(options.palette)
+      theme: normalizeTheme(options.theme)
     });
   }
 
@@ -163,13 +167,12 @@ export function formatStatus(result, options = {}) {
   if (style === "compact") {
     segments = createCompactSegments(model);
   } else if (style === "bar") {
-    segments = createBarSegments(model, options.barWidth);
+    segments = createBarSegments(model, options.displayMode);
   } else {
     segments = createTextSegments(model, options.displayMode);
   }
 
   return applyTheme(segments, {
-    theme: normalizeTheme(options.theme),
-    palette: normalizePalette(options.palette)
+    theme: normalizeTheme(options.theme)
   });
 }

package/src/core/status/theme.js

@@ -1,7 +1,5 @@
 import {
-  DEFAULT_PALETTE,
   DEFAULT_THEME,
-  normalizePalette,
   normalizeTheme
 } from "../../shared/constants.js";
 
@@ -9,8 +7,11 @@ const ANSI = {
   reset: "\u001b[0m",
   bold: "\u001b[1m",
   dim: "\u001b[2m",
+  underline: "\u001b[4m",
+  black: "\u001b[30m",
   gray: "\u001b[90m",
   white: "\u001b[37m",
+  blue: "\u001b[34m",
   cyan: "\u001b[36m",
   green: "\u001b[32m",
   yellow: "\u001b[33m",
@@ -50,9 +51,11 @@ function getDarkCodes(tone) {
 function getMonoCodes(tone) {
   switch (tone) {
     case "muted":
+      return [ANSI.gray];
     case "barEmpty":
-      return [ANSI.dim];
+      return [ANSI.dim, ANSI.gray];
     case "reset":
+      return [ANSI.underline];
     case "label":
     case "good":
     case "warn":
@@ -64,17 +67,39 @@ function getMonoCodes(tone) {
   }
 }
 
+function getLightCodes(tone) {
+  switch (tone) {
+    case "label":
+    case "reset":
+      return [ANSI.blue];
+    case "muted":
+      return [ANSI.gray];
+    case "barEmpty":
+      return [ANSI.dim, ANSI.gray];
+    case "good":
+      return [ANSI.green];
+    case "warn":
+      return [ANSI.yellow];
+    case "danger":
+      return [ANSI.red];
+    case "neutral":
+      return [ANSI.black];
+    default:
+      return [];
+  }
+}
+
 export function applyTheme(segments, options = {}) {
   const theme = normalizeTheme(options.theme || DEFAULT_THEME);
-  const palette = normalizePalette(options.palette || DEFAULT_PALETTE);
-
-  if (theme !== "ansi") {
-    return segments.map((segment) => segment.text).join("");
-  }
 
   return segments
     .map((segment) => {
-      const codes = palette === "mono" ? getMonoCodes(segment.tone) : getDarkCodes(segment.tone);
+      const codes =
+        theme === "mono"
+          ? getMonoCodes(segment.tone)
+          : theme === "light"
+            ? getLightCodes(segment.tone)
+            : getDarkCodes(segment.tone);
       return applyCodes(segment.text, codes);
     })
     .join("");

package/src/core/status/viewModel.js

@@ -1,3 +1,5 @@
+import { LOW_QUOTA_THRESHOLD } from "../../shared/constants.js";
+
 function padTwoDigits(value) {
   return String(value).padStart(2, "0");
 }
@@ -37,7 +39,7 @@ function getSeverity(leftPercent) {
     return "good";
   }
 
-  if (leftPercent >= 25) {
+  if (leftPercent >= LOW_QUOTA_THRESHOLD) {
     return "warn";
   }
 

package/src/shared/config.js

@@ -1,20 +1,34 @@
 import crypto from "node:crypto";
+import fs from "node:fs/promises";
 import os from "node:os";
 import path from "node:path";
 
 import {
-  DEFAULT_BAR_WIDTH,
   DEFAULT_CACHE_TTL_MS,
   DEFAULT_CN_BASE_URL,
   DEFAULT_INTL_BASE_URL,
   DEFAULT_DISPLAY_MODE,
-  DEFAULT_PALETTE,
   DEFAULT_QUOTA_URL,
   DEFAULT_STYLE,
   DEFAULT_THEME,
   DEFAULT_TIMEOUT_MS
 } from "./constants.js";
 
+function getClaudeSettingsPath() {
+  return path.join(os.homedir(), ".claude", "settings.json");
+}
+
+async function readClaudeEnv(claudeSettingsPath) {
+  try {
+    const filePath = claudeSettingsPath || getClaudeSettingsPath();
+    const raw = await fs.readFile(filePath, "utf8");
+    const settings = JSON.parse(raw);
+    return settings?.env && typeof settings.env === "object" ? settings.env : null;
+  } catch {
+    return null;
+  }
+}
+
 function getCacheRoot() {
   if (process.platform === "darwin") {
     return path.join(os.homedir(), "Library", "Caches");
@@ -63,13 +77,17 @@ export function normalizeOptionalString(value) {
   return value.trim();
 }
 
-export function loadConfig(env = process.env, overrides = {}) {
+export async function loadConfig(env = process.env, overrides = {}, options = {}) {
+  const claudeEnv = await readClaudeEnv(options.claudeSettingsPath);
   const anthropicBaseUrl =
-    normalizeOptionalString(overrides.baseUrl) || normalizeOptionalString(env.ANTHROPIC_BASE_URL);
+    normalizeOptionalString(overrides.baseUrl) ||
+    normalizeOptionalString(env.ANTHROPIC_BASE_URL) ||
+    normalizeOptionalString(claudeEnv?.ANTHROPIC_BASE_URL);
   const derivedQuotaUrl = deriveQuotaUrl(anthropicBaseUrl);
   const authorization =
     normalizeOptionalString(overrides.authToken) ||
-    normalizeOptionalString(env.ANTHROPIC_AUTH_TOKEN);
+    normalizeOptionalString(env.ANTHROPIC_AUTH_TOKEN) ||
+    normalizeOptionalString(claudeEnv?.ANTHROPIC_AUTH_TOKEN);
   const tokenHash = authorization
     ? crypto.createHash("sha256").update(authorization).digest("hex").slice(0, 12)
     : "anonymous";
@@ -84,8 +102,6 @@ export function loadConfig(env = process.env, overrides = {}) {
     displayMode: DEFAULT_DISPLAY_MODE,
     style: DEFAULT_STYLE,
     theme: DEFAULT_THEME,
-    palette: DEFAULT_PALETTE,
-    barWidth: DEFAULT_BAR_WIDTH,
     cacheFilePath: path.join(getCacheRoot(), "glm-quota-line", cacheFileName)
   };
 }

package/src/shared/constants.js

@@ -4,18 +4,18 @@ export const DEFAULT_INTL_BASE_URL = "https://api.z.ai";
 export const DEFAULT_TIMEOUT_MS = 5000;
 export const DEFAULT_CACHE_TTL_MS = 600_000;
 
-export const REFRESH_TIERS = [
-  { ttlMs: 180_000, maxRefreshes: 5 },   // 3 min × 5
-  { ttlMs: 300_000, maxRefreshes: 5 },   // 5 min × 5
-  { ttlMs: 600_000, maxRefreshes: Infinity } // 10 min (cap)
+export const REFRESH_BANDS = [
+  { minLeftPercent: 80, ttlMs: 120_000 }, // 2 min
+  { minLeftPercent: 30, ttlMs: 300_000 }, // 5 min
+  { minLeftPercent: 0, ttlMs: 120_000 } // 2 min
 ];
 
 export const LOW_QUOTA_THRESHOLD = 30;
+export const RATE_LIMIT_RETRY_TTL_MS = 180_000;
+export const UNAVAILABLE_RETRY_TTL_MS = 120_000;
 export const DEFAULT_DISPLAY_MODE = "left";
-export const DEFAULT_STYLE = "text";
-export const DEFAULT_BAR_WIDTH = 10;
-export const DEFAULT_THEME = "ansi";
-export const DEFAULT_PALETTE = "dark";
+export const DEFAULT_STYLE = "bar";
+export const DEFAULT_THEME = "dark";
 
 export const STATUS_BAR_CHARACTERS = {
   filled: "█",
@@ -30,15 +30,11 @@ export function isValidStatusStyle(value) {
 }
 
 export function isValidDisplayMode(value) {
-  return value === "left" || value === "used" || value === "both";
+  return value === "left" || value === "used";
 }
 
 export function isValidTheme(value) {
-  return value === "plain" || value === "ansi";
-}
-
-export function isValidPalette(value) {
-  return value === "dark" || value === "mono";
+  return value === "dark" || value === "light" || value === "mono";
 }
 
 export function normalizeStatusStyle(value) {
@@ -52,7 +48,3 @@ export function normalizeDisplayMode(value) {
 export function normalizeTheme(value) {
   return isValidTheme(value) ? value : DEFAULT_THEME;
 }
-
-export function normalizePalette(value) {
-  return isValidPalette(value) ? value : DEFAULT_PALETTE;
-}