glm-quota-line 0.6.0 → 0.7.0

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## 0.7.0
+
+- Added `--version` and `version` so the installed CLI version is visible directly from the command line
+- Added `check-update` to compare the installed version with npm and print a suggested upgrade command without auto-updating
+- Improved CLI help and README docs with upgrade and version-check examples
+- Corrected published package metadata to include `README.en.md` in the npm file list
+
 ## 0.6.0
 
 - Added official international GLM quota endpoint support for `api.z.ai` while preserving domestic `open.bigmodel.cn` detection

package/README.en.md

@@ -0,0 +1,117 @@
+<h1 align="center">glm-quota-line</h1>
+
+<p align="center">
+  One-command install, zero dependencies. Shows accurate GLM quota balance and reset time in the Claude Code status line — data from the official API, not estimated.
+</p>
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/glm-quota-line"><img alt="npm version" src="https://img.shields.io/npm/v/glm-quota-line?logo=npm&color=cb3837"></a>
+  <a href="https://www.npmjs.com/package/glm-quota-line"><img alt="node version" src="https://img.shields.io/node/v/glm-quota-line?logo=node.js&color=339933"></a>
+  <a href="./LICENSE"><img alt="license" src="https://img.shields.io/npm/l/glm-quota-line"></a>
+  <img alt="dependencies" src="https://img.shields.io/badge/dependencies-0-2ea44f">
+</p>
+
+<p align="center">
+  <a href="./README.md">简体中文</a>
+</p>
+
+`glm-quota-line` reads the GLM 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
+- **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
+
+## Installation
+
+```bash
+npm install -g glm-quota-line
+```
+
+Global install is recommended because `install` writes stable executable paths into `statusLine.command` and `SessionStart` hooks. `npx` works for one-off previews.
+
+Upgrade:
+
+```bash
+npm install -g glm-quota-line
+glm-quota-line check-update
+```
+
+## Quick Start
+
+```bash
+glm-quota-line install
+glm-quota-line config set style bar
+glm-quota-line config set theme ansi
+glm-quota-line config set palette dark
+```
+
+## Output
+
+```text
+GLM Lite | 5h 91% | week 47% | reset 14:47
+
+GLM 5h 91% W 47% | 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.
+
+## Styles & Colors
+
+| 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`                    |
+
+`style` controls layout (`text` / `compact` / `bar`). `theme` enables ANSI color. `palette` only applies when `theme=ansi`.
+
+Set `NO_COLOR=1` to force plain output.
+
+## 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:
+
+```bash
+glm-quota-line config set auth-token <your-real-token>
+glm-quota-line config set base-url https://open.bigmodel.cn/api/anthropic
+# or
+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.
+
+## Commands
+
+```bash
+glm-quota-line [--style text|compact|bar] [--display left|used|both]
+               [--theme plain|ansi] [--palette dark|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 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
+- Missing auth returns `GLM | auth expired`; API failures return `GLM | quota unavailable`
+- `install` does not replace an unmanaged status line unless `--force` is used
+- `install --force` backs up the previous entry; `uninstall` restores it when possible
+
+## License
+
+[MIT](./LICENSE)

package/README.md

@@ -1,7 +1,7 @@
 <h1 align="center">glm-quota-line</h1>
 
 <p align="center">
-  Zero-dependency CLI for showing GLM Coding Plan quota in the Claude Code status line.
+  一行命令安装、零依赖，在 Claude Code 状态栏实时显示 GLM 配额余额与重置时间。数据来自官方接口，精准非估算。
 </p>
 
 <p align="center">
@@ -12,50 +12,35 @@
 </p>
 
 <p align="center">
-  <a href="./README.zh-CN.md">简体中文</a>
+  <a href="./README.en.md">English</a>
 </p>
 
-## Overview
+`glm-quota-line` 读取 GLM 配额接口、缓存结果，并输出一行适合 Claude Code `statusLine.command` 的状态文本。通过 `SessionStart` hook 预刷新缓存，新会话不会显示旧配额。
 
-`glm-quota-line` reads the GLM quota endpoint, caches successful responses, and prints a single short line for `statusLine.command`.
+## 功能
 
-It also installs a Claude Code `SessionStart` hook to pre-refresh the quota cache before a new session renders the status line.
+- **一行命令安装** — `glm-quota-line install` 自动接入 Claude Code 状态栏和 `SessionStart` hook
+- **精准配额显示** — 数据来自官方配额接口，非估算；同时展示 5 小时和周 token 配额
+- **国内 + 国际端点** — 自动识别 `open.bigmodel.cn` 和 `api.z.ai`
+- **零依赖** — 无运行时依赖，单一用途
+- **智能缓存** — 按会话、TTL 和 token 用量刷新；支持代理/网关手动覆盖鉴权
 
-It is intentionally scoped to one host only: Claude Code.
-
-## Why
-
-- Built for a single purpose: show GLM quota clearly in Claude Code
-- Small and predictable: no runtime dependencies, no unnecessary abstraction
-- Practical for real usage: cache-aware, session-aware, and easy to install
-
-## Features
-
-- Built for Claude Code `statusLine.command`
-- No runtime dependencies
-- Optional `text`, `compact`, and `bar` layouts
-- Optional ANSI color themes for dark and light terminals
-- Manual `auth-token` and `base-url` overrides for proxy or gateway setups
-- Automatic install and uninstall for Claude Code status line integration
-- SessionStart pre-refresh so a new Claude session does not briefly show stale quota
-
-## Installation
-
-Recommended:
+## 安装
 
 ```bash
 npm install -g glm-quota-line
 ```
 
-From a local clone:
+推荐全局安装，`install` 会将稳定的可执行路径写入 `statusLine.command` 和 `SessionStart` hooks。`npx` 适合一次性试跑。
+
+升级：
 
 ```bash
-npm install -g .
+npm install -g glm-quota-line
+glm-quota-line check-update
 ```
 
-`npx` is fine for one-off previews, but global install is the better default for Claude Code integration because `install` writes stable executable paths into both `statusLine.command` and the managed `SessionStart` hooks.
-
-## Quick Start
+## 快速开始
 
 ```bash
 glm-quota-line install
@@ -64,75 +49,44 @@ glm-quota-line config set theme ansi
 glm-quota-line config set palette dark
 ```
 
-For a one-off preview:
-
-```bash
-glm-quota-line --style compact
-```
-
-## Output
+## 输出示例
 
 ```text
-GLM Lite | 5h left 91% | week 47% | reset 14:47
+GLM Lite | 5h 91% | week 47% | reset 14:47
 
 GLM 5h 91% W 47% | 14:47
 
 GLM Lite █░░░░░░░░░ 91% | W 47% | 14:47
 ```
 
-## Recommended Setups
-
-| 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`                    |
+同时显示 5 小时配额（主要）和周配额（次要），并自动展示重置时间。
 
-## Color Presets
+## 样式与配色
 
-`style` controls layout. `theme` enables or disables ANSI color. `palette` only applies when `theme=ansi`.
+| 使用场景   | 配置                                          |
+| ---------- | --------------------------------------------- |
+| 深色终端   | `style=bar`, `theme=ansi`, `palette=dark`     |
+| 浅色终端   | `style=compact`, `theme=ansi`, `palette=mono` |
+| 纯文本回退 | 任意 `style`，`theme=plain`                   |
 
-- Dark terminal: `theme=ansi` + `palette=dark`
-- Light terminal: `theme=ansi` + `palette=mono`
-- Maximum compatibility: `theme=plain`
+`style` 控制布局（`text` / `compact` / `bar`），`theme` 控制是否启用 ANSI 颜色，`palette` 仅在 `theme=ansi` 时生效。
 
-Examples:
+设置 `NO_COLOR=1` 可强制关闭颜色。
 
-```bash
-glm-quota-line config set style text
-glm-quota-line config set theme ansi
-glm-quota-line config set palette dark
-
-glm-quota-line config set style compact
-glm-quota-line config set theme ansi
-glm-quota-line config set palette mono
-
-glm-quota-line config set theme plain
-```
+## 自定义鉴权
 
-Set `NO_COLOR=1` to force plain output.
-
-## Manual Credential Overrides
-
-If Claude Code is running behind a gateway or proxy and the injected `ANTHROPIC_AUTH_TOKEN` / `ANTHROPIC_BASE_URL` are not the real values, store explicit overrides:
+如果 Claude Code 运行在代理或网关后面，注入的 `ANTHROPIC_AUTH_TOKEN` / `ANTHROPIC_BASE_URL` 不是实际值：
 
 ```bash
 glm-quota-line config set auth-token <your-real-token>
 glm-quota-line config set base-url https://open.bigmodel.cn/api/anthropic
-# or
+# 或
 glm-quota-line config set base-url https://api.z.ai/api/anthropic
 ```
 
-Clear them later with:
+清除：`glm-quota-line config unset auth-token` / `base-url`。手动保存的值优先于 Claude 注入的环境变量。
 
-```bash
-glm-quota-line config unset auth-token
-glm-quota-line config unset base-url
-```
-
-Stored overrides take precedence over Claude-injected environment variables. `config show` redacts the token, but the local config file still stores the real value in plain text.
-
-## Commands
+## 命令
 
 ```bash
 glm-quota-line [--style text|compact|bar] [--display left|used|both]
@@ -140,28 +94,24 @@ glm-quota-line [--style text|compact|bar] [--display left|used|both]
 
 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 <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 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 set <style|display|theme|palette|auth-token|base-url> <value>
+glm-quota-line config unset <key>
 ```
 
-Run `glm-quota-line --help` for the full command descriptions and examples.
+完整说明运行 `glm-quota-line --help`。
+
+`glm-quota-line --version` 可直接查看当前安装版本；`check-update` 只检查并提示升级命令，不会自动修改环境。
 
-## Notes
+## 说明
 
-- Default output is plain text
-- Missing or expired auth returns `GLM | auth expired`
-- API or parsing failures return `GLM | quota unavailable`
-- Only `TOKENS_LIMIT` quotas are shown; `TIME_LIMIT` / MCP usage is ignored
-- `install` wires both the status line command and managed `SessionStart` hooks
-- `install` does not replace an unmanaged Claude status line unless `--force` is used
-- `install --force` backs up the previous entry and `uninstall` restores it when possible
+- 只展示 `TOKENS_LIMIT` 配额，忽略 `TIME_LIMIT` / MCP 使用量
+- 鉴权缺失返回 `GLM | auth expired`；接口异常返回 `GLM | quota unavailable`
+- `install` 默认不会覆盖非本工具管理的状态栏，除非使用 `--force`
+- `install --force` 会备份旧配置，`uninstall` 会在可能时恢复
 
-## License
+## 许可证
 
 [MIT](./LICENSE)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "glm-quota-line",
-  "version": "0.6.0",
+  "version": "0.7.0",
   "description": "Claude Code status line helper for GLM Coding Plan quota.",
   "type": "module",
   "license": "MIT",
@@ -27,7 +27,7 @@
   "files": [
     "src",
     "README.md",
-    "README.zh-CN.md",
+    "README.en.md",
     "LICENSE",
     "CHANGELOG.md"
   ],

package/src/cli/args.js

@@ -26,6 +26,11 @@ export function parseArgs(argv = process.argv.slice(2)) {
       continue;
     }
 
+    if (arg === "--version" || arg === "-v") {
+      options.version = true;
+      continue;
+    }
+
     if (arg === "--force") {
       options.force = true;
       continue;
@@ -67,4 +72,3 @@ export function parseArgs(argv = process.argv.slice(2)) {
   options.positionals = positionals;
   return options;
 }
-

package/src/cli/commands.js

@@ -13,6 +13,8 @@ import {
 } from "../claude/settings.js";
 import { installClaudeStatusLine, uninstallClaudeStatusLine } from "../claude/install.js";
 import { refreshQuotaOnSessionStart } from "../claude/sessionStart.js";
+import { checkForUpdates } from "./update.js";
+import { getPackageVersion } from "../shared/packageInfo.js";
 
 function isNonEmptyString(value) {
   return typeof value === "string" && value.trim().length > 0;
@@ -66,9 +68,36 @@ const CONFIG_KEYS = {
   }
 };
 
-export async function handleCommand(args, output = process.stdout) {
+export async function handleCommand(args, output = process.stdout, dependencies = {}) {
+  const getVersion = dependencies.getVersion || getPackageVersion;
+  const runUpdateCheck = dependencies.runUpdateCheck || checkForUpdates;
   const [command, subcommand, key, value] = args.positionals;
 
+  if (command === "version") {
+    output.write(`glm-quota-line ${await getVersion()}\n`);
+    return true;
+  }
+
+  if (command === "check-update") {
+    const result = await runUpdateCheck();
+    output.write(`glm-quota-line ${result.currentVersion}\n`);
+
+    if (result.status === "up-to-date") {
+      output.write(`latest: ${result.latestVersion}\nstatus: up to date\n`);
+      return true;
+    }
+
+    if (result.status === "update-available") {
+      output.write(
+        `latest: ${result.latestVersion}\nstatus: update available\nupgrade: ${result.upgradeCommand}\n`
+      );
+      return true;
+    }
+
+    output.write(`status: unable to check updates\nreason: ${result.errorMessage}\n`);
+    return true;
+  }
+
   if (command === "install") {
     const result = await installClaudeStatusLine(undefined, undefined, undefined, {
       force: Boolean(args.force)

package/src/cli/index.js

@@ -7,6 +7,7 @@ import { formatStatus } from "../core/status/format.js";
 import { readStatusLineInput } from "../claude/input.js";
 import { readToolConfig } from "../claude/settings.js";
 import { resolveQuotaStatus } from "../core/quota/service.js";
+import { getPackageVersion } from "../shared/packageInfo.js";
 import {
   isValidDisplayMode,
   isValidPalette,
@@ -20,8 +21,11 @@ function printHelp() {
 Usage:
   glm-quota-line [--style text|compact|bar] [--display left|used|both]
                  [--theme plain|ansi] [--palette dark|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>
@@ -35,6 +39,8 @@ Commands:
   install                 Install glm-quota-line into Claude Code statusLine.command and SessionStart hooks.
   install --force         Replace an existing unmanaged status line and back it up.
   uninstall               Remove the managed status line and SessionStart hooks, and restore a backup if one exists.
+  version                 Print the installed glm-quota-line version.
+  check-update            Check npm for a newer version and print the upgrade command.
   config show             Print the current persisted config. Stored tokens are redacted.
   config set ...          Persist a display option or manual credential override.
   config unset ...        Remove one persisted config key.
@@ -45,11 +51,14 @@ Options:
   --theme                 Color mode: plain or ansi.
   --palette               ANSI palette: dark for dark terminals, mono for light terminals.
   --force                 Allow install to replace an unmanaged Claude status line.
+  -v, --version           Show the installed version.
   -h, --help              Show this help text.
 
 Examples:
   glm-quota-line
+  glm-quota-line --version
   glm-quota-line --style bar --theme ansi --palette 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 auth-token <your-real-token>
@@ -101,6 +110,11 @@ export async function main() {
       return;
     }
 
+    if (args.version) {
+      process.stdout.write(`glm-quota-line ${await getPackageVersion()}\n`);
+      return;
+    }
+
     if (await handleCommand(args)) {
       return;
     }

package/src/cli/update.js

@@ -0,0 +1,120 @@
+import { readPackageInfo } from "../shared/packageInfo.js";
+
+const DEFAULT_TIMEOUT_MS = 5000;
+const DEFAULT_REGISTRY_URL = "https://registry.npmjs.org";
+
+function parseVersion(version) {
+  const match = /^(\d+)\.(\d+)\.(\d+)(?:-([0-9A-Za-z.-]+))?$/.exec(version);
+  if (!match) {
+    return null;
+  }
+
+  return {
+    major: Number.parseInt(match[1], 10),
+    minor: Number.parseInt(match[2], 10),
+    patch: Number.parseInt(match[3], 10),
+    prerelease: match[4] || ""
+  };
+}
+
+export function compareVersions(left, right) {
+  const parsedLeft = parseVersion(left);
+  const parsedRight = parseVersion(right);
+
+  if (!parsedLeft || !parsedRight) {
+    return left === right ? 0 : left.localeCompare(right);
+  }
+
+  for (const key of ["major", "minor", "patch"]) {
+    if (parsedLeft[key] !== parsedRight[key]) {
+      return parsedLeft[key] - parsedRight[key];
+    }
+  }
+
+  if (parsedLeft.prerelease === parsedRight.prerelease) {
+    return 0;
+  }
+
+  if (!parsedLeft.prerelease) {
+    return 1;
+  }
+
+  if (!parsedRight.prerelease) {
+    return -1;
+  }
+
+  return parsedLeft.prerelease.localeCompare(parsedRight.prerelease);
+}
+
+function normalizeRegistryUrl(value) {
+  return value.replace(/\/+$/u, "");
+}
+
+function toErrorMessage(error) {
+  if (error?.name === "AbortError") {
+    return "npm registry request timed out";
+  }
+
+  if (error?.name === "TypeError" && error?.message === "fetch failed") {
+    return "npm registry request failed";
+  }
+
+  if (typeof error?.message === "string" && error.message.trim()) {
+    return error.message.trim();
+  }
+
+  return "npm registry request failed";
+}
+
+export async function checkForUpdates(options = {}) {
+  const fetchImpl = options.fetchImpl || globalThis.fetch;
+  if (typeof fetchImpl !== "function") {
+    throw new Error("fetch is not available in this Node.js runtime");
+  }
+
+  const packageInfo = options.packageInfo || (await readPackageInfo());
+  const packageName = packageInfo.name || "glm-quota-line";
+  const currentVersion = packageInfo.version || "0.0.0";
+  const registryUrl = normalizeRegistryUrl(options.registryUrl || DEFAULT_REGISTRY_URL);
+  const timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+
+  const controller = new AbortController();
+  const timeoutId = setTimeout(() => controller.abort(), timeoutMs);
+
+  try {
+    const response = await fetchImpl(`${registryUrl}/${encodeURIComponent(packageName)}/latest`, {
+      headers: {
+        accept: "application/json"
+      },
+      signal: controller.signal
+    });
+
+    if (!response.ok) {
+      throw new Error(`npm registry returned HTTP ${response.status}`);
+    }
+
+    const payload = await response.json();
+    const latestVersion = typeof payload?.version === "string" ? payload.version.trim() : "";
+    if (!latestVersion) {
+      throw new Error("npm registry response did not include a version");
+    }
+
+    return {
+      packageName,
+      currentVersion,
+      latestVersion,
+      status: compareVersions(currentVersion, latestVersion) < 0 ? "update-available" : "up-to-date",
+      upgradeCommand: `npm install -g ${packageName}`
+    };
+  } catch (error) {
+    return {
+      packageName,
+      currentVersion,
+      latestVersion: null,
+      status: "error",
+      errorMessage: toErrorMessage(error)
+    };
+  } finally {
+    clearTimeout(timeoutId);
+  }
+}

package/src/shared/packageInfo.js

@@ -0,0 +1,29 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+const PACKAGE_JSON_PATH = path.resolve(__dirname, "..", "..", "package.json");
+
+let packageInfoPromise;
+
+async function readPackageJson() {
+  const raw = await fs.readFile(PACKAGE_JSON_PATH, "utf8");
+  const parsed = JSON.parse(raw);
+
+  return {
+    name: typeof parsed.name === "string" ? parsed.name : "glm-quota-line",
+    version: typeof parsed.version === "string" ? parsed.version : "0.0.0"
+  };
+}
+
+export async function readPackageInfo() {
+  packageInfoPromise ||= readPackageJson();
+  return packageInfoPromise;
+}
+
+export async function getPackageVersion() {
+  const packageInfo = await readPackageInfo();
+  return packageInfo.version;
+}

package/README.zh-CN.md

@@ -1,171 +0,0 @@
-<h1 align="center">glm-quota-line</h1>
-
-<p align="center">
-  用于在 Claude Code 状态栏显示 GLM Coding Plan 配额的零依赖 CLI。
-</p>
-
-<p align="center">
-  <a href="https://www.npmjs.com/package/glm-quota-line"><img alt="npm version" src="https://img.shields.io/npm/v/glm-quota-line?logo=npm&color=cb3837"></a>
-  <a href="https://www.npmjs.com/package/glm-quota-line"><img alt="node version" src="https://img.shields.io/node/v/glm-quota-line?logo=node.js&color=339933"></a>
-  <a href="./LICENSE"><img alt="license" src="https://img.shields.io/npm/l/glm-quota-line"></a>
-  <img alt="dependencies" src="https://img.shields.io/badge/dependencies-0-2ea44f">
-</p>
-
-<p align="center">
-  <a href="./README.md">English</a>
-</p>
-
-## 简介
-
-`glm-quota-line` 会读取 GLM 配额接口、缓存成功结果，并输出一行适合 `statusLine.command` 的短文本。
-
-它也会安装 Claude Code 的 `SessionStart` hook，在新会话渲染状态栏之前预刷新 quota 缓存。
-
-项目只面向一个宿主：Claude Code。
-
-## 为什么用它
-
-- 目标单一：只解决 Claude Code 里显示 GLM 配额这件事
-- 足够小：无运行时依赖，没有多余抽象
-- 面向实际使用：带缓存、识别新会话、安装简单
-
-## 功能
-
-- 专为 Claude Code `statusLine.command` 设计
-- 无运行时依赖
-- 支持 `text`、`compact`、`bar` 三种样式
-- 支持适合深色和浅色终端的 ANSI 颜色主题
-- 支持手动设置 `auth-token` 和 `base-url`，覆盖代理或网关环境
-- 支持自动安装和卸载 Claude Code 状态栏配置
-- 通过 SessionStart 预刷新，减少新会话首屏短暂显示旧配额的情况
-
-## 安装
-
-推荐：
-
-```bash
-npm install -g glm-quota-line
-```
-
-本地仓库调试安装：
-
-```bash
-npm install -g .
-```
-
-`npx` 适合一次性试跑，但 Claude Code 的正式集成更适合全局安装，因为 `install` 会把稳定的可执行路径写入 `statusLine.command` 和受工具管理的 `SessionStart` hooks。
-
-## 快速开始
-
-```bash
-glm-quota-line install
-glm-quota-line config set style bar
-glm-quota-line config set theme ansi
-glm-quota-line config set palette dark
-```
-
-临时预览：
-
-```bash
-glm-quota-line --style compact
-```
-
-## 输出示例
-
-```text
-GLM Lite | 5h 91% | week 47% | reset 14:47
-
-GLM 5h 91% W 47% | 14:47
-
-GLM Lite █░░░░░░░░░ 91% | W 47% | 14:47
-```
-
-## 推荐搭配
-
-| 使用场景   | 配置                                          |
-| ---------- | --------------------------------------------- |
-| 深色终端   | `style=bar`, `theme=ansi`, `palette=dark`     |
-| 浅色终端   | `style=compact`, `theme=ansi`, `palette=mono` |
-| 纯文本回退 | 任意 `style`，`theme=plain`                   |
-
-## 颜色搭配
-
-`style` 控制布局，`theme` 控制是否启用 ANSI，`palette` 只在 `theme=ansi` 时生效。
-
-- 深色终端：`theme=ansi` + `palette=dark`
-- 浅色终端：`theme=ansi` + `palette=mono`
-- 最大兼容性：`theme=plain`
-
-示例：
-
-```bash
-glm-quota-line config set style text
-glm-quota-line config set theme ansi
-glm-quota-line config set palette dark
-
-glm-quota-line config set style compact
-glm-quota-line config set theme ansi
-glm-quota-line config set palette mono
-
-glm-quota-line config set theme plain
-```
-
-设置 `NO_COLOR=1` 可强制关闭颜色。
-
-## 手动凭证覆盖
-
-如果 Claude Code 运行在代理或网关后面，注入的 `ANTHROPIC_AUTH_TOKEN` / `ANTHROPIC_BASE_URL` 不是实际值，可以显式保存覆盖值：
-
-```bash
-glm-quota-line config set auth-token <your-real-token>
-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
-```
-
-清除覆盖值：
-
-```bash
-glm-quota-line config unset auth-token
-glm-quota-line config unset base-url
-```
-
-手动保存的覆盖值优先于 Claude 注入的环境变量。`config show` 会脱敏显示 token，但本地配置文件仍会明文保存真实值。
-
-## 命令
-
-```bash
-glm-quota-line [--style text|compact|bar] [--display left|used|both]
-               [--theme plain|ansi] [--palette dark|mono]
-
-glm-quota-line install [--force]
-glm-quota-line uninstall
-glm-quota-line config show
-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 auth-token <token>
-glm-quota-line config set base-url <url>
-glm-quota-line config unset <style|display|theme|palette|auth-token|base-url>
-```
-
-完整说明和示例可运行：
-
-```bash
-glm-quota-line --help
-```
-
-## 说明
-
-- 默认输出为纯文本
-- 鉴权缺失或失效时返回 `GLM | auth expired`
-- 接口异常或解析失败时返回 `GLM | quota unavailable`
-- 只展示 `TOKENS_LIMIT` 配额，忽略 `TIME_LIMIT` / MCP 使用量
-- `install` 会同时接入状态栏命令和受工具管理的 `SessionStart` hooks
-- `install` 默认不会覆盖非本工具管理的 Claude 状态栏，除非显式使用 `--force`
-- `install --force` 会备份旧配置，`uninstall` 会在可能时恢复
-
-## 许可证
-
-[MIT](./LICENSE)