glm-quota-line 1.1.1 → 1.3.0

package/CHANGELOG.md

@@ -1,5 +1,39 @@
 # Changelog
 
+## 1.3.0
+
+- Added `commands` subcommand: list every command with a machine-readable schema via `--json` (name / summary / sideEffect / args / examples), for AI agents and scripting
+- Added per-subcommand `--help` (e.g. `model --help`, `config set --help`) — focused help derived from a single command registry
+- **User-customizable model mapping table** — model context window sizes are now managed by the user at runtime. The bundled `data/models.json` is just a frozen base; your local `modelMap` overlays it, so adapting to a new model (e.g. `glm-5.2` with 1M context) needs only `model set <id> <size>` — no package update or upgrade required
+- Added `model` subcommands: `list`, `get`, `set`, `remove` — manage model context window size mappings via CLI
+- Added `modelMap` persistence in tool config — custom model sizes survive across sessions
+- Added `config reset [--models] [--yes]` — restore user config to defaults. `--models` limits the reset to custom model mappings. Preserves install state; prompts unless `--yes` (required in non-interactive sessions)
+- Model ids reported with a bracket suffix (e.g. `glm-5.2[1M]`) are now normalized to the bare id for lookup and display
+- Updated default table: added `glm-5.2` (1M context), removed `glm-5` and `glm-5.1` (no longer in plan)
+- Added `reset-format` config (`time` / `countdown`) — show reset time as countdown duration instead of time point
+- Weekly quota now displays reset time (time point or countdown) alongside the progress bar
+- Context window resolution now relies solely on the local model map: stdin `context_window_size` is ignored, and stdin-provided window percentages are no longer used as a fallback (they are often inaccurate). If the current model id is not in the map, the context segment is simply not shown rather than guessing
+- ctx cache now keyed by session id + model id: token usage can be 0 or missing on individual status-line frames (session start, between requests), which would make the context segment flash. The cache falls back to the last valid value for the same session and model so the display stays stable — a stale value from a different session or model is never shown
+- Refactored command dispatch into `configCommand.js` / `modelCommand.js`, and extracted a shared `bar.js` and a context-scoped `cache.js`. No behavior change
+- Hardcoded `glm-4.7` fallback remains as a defensive guard against `data/models.json` I/O failure
+
+## 1.2.0
+
+- Added interactive TUI configuration: `glm-quota-line configure` — live preview, per-component toggle and style, global options
+- Added component-level control: each display component (plan, 5h, week, reset, context) can be individually toggled and styled
+- Added `minimalist` config to hide all labels, showing only progress bars and values
+- Added `raw-values` config to hide labels and show raw values
+- Added `--json` flag for structured JSON output in terminal mode (useful for scripting and automation)
+- Added `work-days` config (1-7) to customize weekly working days for quota pacing calculation
+- Added one-time query via `npx glm-quota-line` without global install
+- Context window now displays model ID and window size (e.g., `glm-4.7 (200K)`)
+- Context window usage is now calculated from raw tokens when model mapping is available
+- Weekly quota bar now shows theoretical budget with shade segments (▒) when pacing data is available
+- Weekly quota severity now uses pacing-based calculation: good (≤1.1x), warn (1.1-1.3x), danger (>1.3x)
+- Added GLM provider detection to disable quota for non-Zhipu API endpoints
+- Replaced `--ctx on|off` CLI flag and `config set/unset ctx` with TUI component config
+- Consolidated duplicate utility functions into shared `utils.js` module
+
 ## 1.1.1
 
 - Fixed MCP quota not displaying when API returns `TIME_LIMIT` type instead of `MCP_LIMIT`

package/README.en.md

@@ -19,13 +19,25 @@
 
 - **Terminal quick check** — run `glm-quota-line` in any terminal to view your quota (including MCP) without launching Claude Code
 - **Claude Code status line** — auto-embeds in the status bar after install, shows quota balance, reset time, and context window usage in real time
-- **Bar visualization** — default bar style shows remaining quota at a glance
+- **Bar visualization** — default bar style shows remaining quota at a glance; weekly quota shows theoretical budget shadow
+- **Weekly pacing analysis** — calculates usage speed based on work days, auto-highlights when exceeding theoretical budget
+- **JSON output** — `--json` flag outputs structured data for scripting
+- **Interactive configuration** — `glm-quota-line configure` launches a TUI with live preview and per-component controls
+- **Component-level control** — each display component (plan, 5h, week, reset, context) can be individually toggled and styled
 - **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
 
 ## Quick Start
 
+**One-time query (no install needed):**
+
+```bash
+npx glm-quota-line
+```
+
+**Status line integration (global install required):**
+
 ```bash
 npm install -g glm-quota-line
 glm-quota-line install
@@ -34,7 +46,7 @@ glm-quota-line install
 Done. Your Claude Code status bar will now show the quota:
 
 ```
-GLM Lite █████████░ 91% | W 47% | 14:47 | ctx ███░░░ 45%
+GLM Lite █████████░ 91% | W ▒▒▒▒░░░░░ 47% | 14:47 | ctx ███░░░ 45% (glm-4.7/200K)
 ```
 
 You can also run `glm-quota-line` directly in the terminal to check your quota without launching Claude Code.
@@ -54,7 +66,7 @@ All options are optional. Persist with `glm-quota-line config set`, or override
 
 | Value | Description | Example |
 |---|---|---|
-| `bar` (default) | Progress bar | `GLM Lite █████████░ 91% \| W 47% \| 14:47 \| ctx ███░░░ 45%` |
+| `bar` (default) | Progress bar | `GLM Lite █████████░ 91% \| W ▒▒▒▒░░░░░ 47% \| 14:47 \| ctx ███░░░ 45%` |
 | `text` | Full text | `GLM Lite \| 5h 91% \| week 47% \| reset 14:47 \| ctx 45%` |
 | `compact` | Compact mode | `GLM 5h 91% W 47% \| 14:47` |
 
@@ -91,24 +103,86 @@ Quota percentage colors change automatically based on remaining amount:
 glm-quota-line config set display used
 ```
 
-### ctx — Context window usage
+### work-days — Work days per week
 
-Show the current Claude Code context window usage percentage in the status line (status line mode only).
+Set the number of work days per week (1–7) for weekly quota theoretical budget and pacing analysis. Default: 5.
 
-| Value | Description |
-|---|---|
-| `on` (default) | Show context window usage |
-| `off` | Hide context window usage |
+```bash
+glm-quota-line config set work-days 6
+```
+
+Pacing analysis calculates theoretical budget based on elapsed work days:
+- Green — usage speed ≤ 1.1x theoretical
+- Yellow — usage speed 1.1x–1.3x theoretical
+- Red — usage speed > 1.3x theoretical
+
+### reset-format — Reset time format
+
+Controls how the reset time is displayed in the status line.
+
+| Value | Description | Example |
+|---|---|---|
+| `time` (default) | Show the reset time point | `reset 14:47` |
+| `countdown` | Show the remaining countdown | `reset 52m` / `reset 2d 5h` |
 
 ```bash
-glm-quota-line config set ctx off
+glm-quota-line config set reset-format countdown
 ```
 
-Context usage colors change automatically based on used percentage:
+The weekly quota also shows the reset info (time point or countdown) alongside its progress bar.
 
-- Green — used < 60%
-- Yellow — used 60%–79%
-- Red — used >= 80%
+### --json — JSON output
+
+Output structured JSON format (terminal mode only, ignored in status line mode):
+
+```bash
+glm-quota-line --json
+```
+
+Example output:
+```json
+{
+  "level": "Lite",
+  "quotas": [
+    {
+      "label": "5h",
+      "leftPercent": 91,
+      "usedPercent": 9,
+      "nextResetTime": 1715257200000
+    },
+    {
+      "label": "week",
+      "leftPercent": 47,
+      "usedPercent": 53,
+      "nextResetTime": 1715744400000
+    }
+  ],
+  "mcp": {
+    "leftPercent": 85,
+    "usedPercent": 15
+  }
+}
+```
+
+### minimalist — Minimal mode
+
+Hide all labels, show only progress bars and values.
+
+```bash
+glm-quota-line config set minimalist true
+```
+
+Effect:
+- Off: `GLM Lite █████████░ 91% | W ▒▒▒▒░░░░░ 47% | 14:47`
+- On: `█████████░ 91% | ▒▒▒▒░░░░░ 47% | 14:47`
+
+### raw-values — Raw values
+
+Hide all labels and show raw values directly.
+
+```bash
+glm-quota-line config set raw-values true
+```
 
 ### auth-token / base-url — Custom auth
 
@@ -129,6 +203,69 @@ Auth source priority (highest to lowest):
 2. Environment variables `ANTHROPIC_AUTH_TOKEN` / `ANTHROPIC_BASE_URL`
 3. `env` field in `~/.claude/settings.json`
 
+### reset — Restore defaults
+
+One-shot reset of user config. Install state is preserved (status line / hook are not removed).
+
+```bash
+glm-quota-line config reset            # reset all user config (interactive confirm)
+glm-quota-line config reset --models   # reset only custom model mappings (modelMap)
+glm-quota-line config reset --yes      # skip confirmation (scripts / CI)
+```
+
+- Default scope: all global config keys (theme/display/style/work-days/minimalist/raw-values/reset-format/auth-token/base-url), component layout (lines), and custom model mappings (modelMap).
+- `--models` limits the reset to modelMap only; other config is left untouched.
+- In non-interactive sessions (no TTY) `--yes` is required, otherwise it errors out — to avoid accidental deletion.
+- After reset the status line still works — model mappings fall back to the bundled table (`data/models.json`).
+
+### configure — Interactive TUI setup
+
+Launch a terminal UI with live preview to adjust component toggles, styles, and global options.
+
+```bash
+glm-quota-line configure
+```
+
+Key bindings:
+- `↑↓` select component, `Enter` to edit, `Tab` to cycle style, `Space` to toggle
+- `g` to enter global options (theme, display mode, minimalist, raw-values)
+- `s` to save, `q` to quit
+
+Components:
+
+| Component | Description | Styleable | Hideable |
+|---|---|---|---|
+| `level` | Plan level (e.g. GLM Lite) | — | ✓ |
+| `5h` | 5-hour quota | ✓ (bar/text) | — (required) |
+| `week` | Weekly quota | ✓ (bar/text) | ✓ |
+| `reset` | Reset time | — | ✓ |
+| `ctx` | Context window usage | ✓ (bar/text) | ✓ |
+
+### model — Context window management
+
+Manage the context window size mapping per model. The context window usage percentage is computed from this mapping.
+
+```bash
+glm-quota-line model list                    # list all models and their context window size
+glm-quota-line model get <model-id>          # show the size of a given model
+glm-quota-line model set <model-id> <size>   # set a model size (e.g. 300K or 300000)
+glm-quota-line model remove <model-id>       # remove a custom mapping (built-in model reverts to default)
+```
+
+Example `list` output:
+
+```
+glm-4.7        200K
+glm-5.1        200K
+glm-5.2        300K *
+```
+
+The `*` marker indicates a user-configured mapping.
+
+The model mapping is a two-layer system: the bundled `data/models.json` is the default base, and the `modelMap` in `~/.claude/glm-quota-line.json` is the user overlay (merged key-by-key at runtime). **When Zhipu releases a new model, you don't need to wait for an npm package update — just run `model set <new-model> <size>` to write the local overlay and it takes effect immediately.**
+
+To clear all custom model mappings and return to the bundled default table, run `glm-quota-line config reset --models --yes`.
+
 ## Recommended Combinations
 
 | Use case | Config |
@@ -137,29 +274,67 @@ Auth source priority (highest to lowest):
 | Light terminal | `style=bar`, `theme=light` |
 | Minimal setup | `style=compact`, `theme=mono` |
 | Track usage | `style=bar`, `display=used` |
+| Countdown reset | `reset-format=countdown` |
+| Scripting | `--json` |
+| 6-day work week | `work-days=6` |
+| Minimal values | `minimalist=true` |
+| Custom model | `glm-quota-line model set glm-5.2 300K` |
+| Interactive setup | `glm-quota-line configure` |
 
 ## Command Reference
 
 ```bash
-glm-quota-line [--style text|compact|bar] [--display left|used] [--theme dark|light|mono] [--ctx on|off]
+glm-quota-line [--style text|compact|bar] [--display left|used] [--theme dark|light|mono] [--json]
 glm-quota-line install [--force]
 glm-quota-line uninstall
 glm-quota-line version
 glm-quota-line check-update
+glm-quota-line configure
 glm-quota-line config show
-glm-quota-line config set <style|display|theme|ctx|auth-token|base-url> <value>
+glm-quota-line config set <style|display|theme|auth-token|base-url|work-days|minimalist|raw-values|reset-format> <value>
 glm-quota-line config unset <key>
+glm-quota-line config reset [--models] [--yes]
+glm-quota-line model list
+glm-quota-line model get <model-id>
+glm-quota-line model set <model-id> <size>
+glm-quota-line model remove <model-id>
 ```
 
 Run `glm-quota-line --help` for full descriptions.
 
+## For Agents / Automation
+
+If you are an AI agent (Claude Code / Cursor / Codex) or a script author, the following surface is guaranteed stable:
+
+```bash
+# Get the full machine-readable schema of every command in one call
+# (name / summary / sideEffect / args / examples)
+glm-quota-line commands --json
+
+# Focused help for a single command or command group
+glm-quota-line model --help
+glm-quota-line config set --help
+```
+
+Conventions:
+- **Exit codes**: `0` on success, `1` on error.
+- **Side-effect tagging**: every command is tagged `read` (safe for automation), `write` (persists config / model map), `mutating` (modifies Claude Code integration), or `interactive` (requires a TTY).
+- **Non-blocking**: no command blocks waiting for input (`config reset` needs `--yes` in non-interactive sessions; `configure` prints a hint instead of launching the TUI when there is no TTY).
+- **Read query**: `glm-quota-line --json` emits structured quota data (5h / week / MCP + reset times).
+
+Typical agent workflow: run `commands --json` to discover capabilities → invoke the command you need → parse stdout.
+
 ## Notes
 
 - Shows `TOKENS_LIMIT` and `MCP_LIMIT` / `TIME_LIMIT` quotas
-- Context window usage is shown by default; disable with `--ctx off` or `config set ctx off`
+- Weekly quota progress bar shadow (▒) is a daily pacing baseline: the theoretical budget based on elapsed work days — the more the filled bar (█) extends past the shadow, the faster you're consuming
+- Context window usage is shown by default; toggle via `glm-quota-line configure`
+- Context window usage is computed from raw tokens using the local model map; if the current model id is not in the map, the context segment is not shown (no guessing)
+- Each component can be individually toggled and styled via `glm-quota-line configure`
 - 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
+- Set `GLM_QUOTA_DEBUG=1` to output context window debug info to stderr
 
 ## License
 

package/README.md

@@ -19,13 +19,25 @@
 
 - **终端快速查询** — 直接运行 `glm-quota-line` 即可在终端查看配额（含 MCP），无需启动 Claude Code
 - **Claude Code 状态栏** — 安装后自动嵌入状态栏，实时显示配额余额、重置时间和上下文窗口用量
-- **进度条可视化** — 默认 bar 风格，一眼看清剩余比例
+- **进度条可视化** — 默认 bar 风格，一眼看清剩余比例；周配额显示理论预算阴影
+- **智能配速分析** — 根据工作日和已过时间计算配额使用速度，超速时自动变色警示
+- **JSON 输出** — 支持 `--json` 参数输出结构化数据，便于脚本调用
+- **交互式配置** — `glm-quota-line configure` 启动 TUI 界面，实时预览、逐项调整组件开关与样式
+- **组件级控制** — 每个显示组件（套餐、5h、周、重置、上下文）可单独开关和设置样式
 - **智能缓存** — 按会话、TTL 和 token 用量分级刷新；`SessionStart` hook 预刷新，新会话不显示旧数据
 - **国内 + 国际端点** — 自动识别 `open.bigmodel.cn` 和 `api.z.ai`
 - **零依赖** — 无运行时依赖，单一用途
 
 ## 快速开始
 
+**一次性查询（无需安装）：**
+
+```bash
+npx glm-quota-line
+```
+
+**状态栏集成（需要全局安装）：**
+
 ```bash
 npm install -g glm-quota-line
 glm-quota-line install
@@ -34,7 +46,7 @@ glm-quota-line install
 安装完成。Claude Code 底部状态栏会自动显示配额：
 
 ```
-GLM Lite █████████░ 91% | W 47% | 14:47 | ctx ███░░░ 45%
+GLM Lite █████████░ 91% | W ▒▒▒▒░░░░░ 47% 11:10 | 14:47 | ctx ███░░░ 45% (glm-4.7/200K)
 ```
 
 也可以直接在终端运行 `glm-quota-line` 快速查看用量，无需启动 Claude Code。
@@ -54,9 +66,9 @@ glm-quota-line check-update
 
 | 值 | 说明 | 示例 |
 |---|---|---|
-| `bar`（默认） | 进度条可视化 | `GLM Lite █████████░ 91% \| W 47% \| 14:47 \| ctx ███░░░ 45%` |
-| `text` | 完整文本 | `GLM Lite \| 5h 91% \| week 47% \| reset 14:47 \| ctx 45%` |
-| `compact` | 紧凑模式 | `GLM 5h 91% W 47% \| 14:47` |
+| `bar`（默认） | 进度条可视化 | `GLM Lite █████████░ 91% \| W ▒▒▒▒░░░░░ 47% 11:10 \| 14:47 \| ctx ███░░░ 45%` |
+| `text` | 完整文本 | `GLM Lite \| 5h 91% \| week 47% 11:10 \| reset 14:47 \| ctx 45%` |
+| `compact` | 紧凑模式 | `GLM 5h 91% W 47% 11:10 \| 14:47` |
 
 ```bash
 glm-quota-line config set style compact
@@ -91,24 +103,101 @@ glm-quota-line config set theme light
 glm-quota-line config set display used
 ```
 
-### ctx — 上下文窗口用量
+### work-days — 每周工作日
 
-在状态栏显示当前 Claude Code 上下文窗口的使用百分比（仅状态栏模式）。
+设置每周工作日数量（1-7），用于计算周配额的理论预算和配速分析。默认 5 天。
 
-| 值 | 说明 |
-|---|---|
-| `on`（默认） | 显示上下文窗口用量 |
-| `off` | 隐藏上下文窗口用量 |
+```bash
+glm-quota-line config set work-days 6
+```
+
+配速分析会根据已过工作日计算理论预算，并判断使用速度：
+- 绿色 — 使用速度 ≤ 1.1x 理论值
+- 黄色 — 使用速度 1.1x–1.3x 理论值
+- 红色 — 使用速度 > 1.3x 理论值
+
+### minimalist — 极简模式
+
+隐藏所有标签文字，只保留进度条和数值。
 
 ```bash
-glm-quota-line config set ctx off
+glm-quota-line config set minimalist true
+```
+
+效果对比：
+- 关闭：`GLM Lite █████████░ 91% | W ▒▒▒▒░░░░░ 47% 11:10 | 14:47`
+- 开启：`█████████░ 91% | ▒▒▒▒░░░░░ 47% 11:10 | 14:47`
+
+### raw-values — 原始数值
+
+隐藏所有标签文字，直接显示原始数值。
+
+```bash
+glm-quota-line config set raw-values true
+```
+
+### reset-format — 重置时间格式
+
+控制状态栏中重置时间的显示格式。
+
+| 值 | 说明 | 示例 |
+|---|---|---|
+| `time`（默认） | 显示重置时间点 | `reset 14:47` |
+| `countdown` | 显示剩余倒计时 | `reset 52m` / `reset 2d 5h` |
+
+```bash
+glm-quota-line config set reset-format countdown
+```
+
+周配额也会同步显示重置信息（时间点或倒计时）。
+
+### --json — JSON 输出
+
+输出结构化 JSON 格式（仅终端模式，状态栏模式忽略）：
+
+```bash
+glm-quota-line --json
+```
+
+输出示例：
+```json
+{
+  "level": "Lite",
+  "quotas": [
+    {
+      "label": "5h",
+      "leftPercent": 91,
+      "usedPercent": 9,
+      "nextResetTime": 1715257200000
+    },
+    {
+      "label": "week",
+      "leftPercent": 47,
+      "usedPercent": 53,
+      "nextResetTime": 1715744400000
+    }
+  ],
+  "mcp": {
+    "leftPercent": 85,
+    "usedPercent": 15
+  }
+}
 ```
 
-上下文用量会根据已用比例自动变色：
+### reset — 恢复出厂配置
+
+一键重置用户配置,保留安装状态(不卸载状态栏/hook)。
+
+```bash
+glm-quota-line config reset            # 交互确认后重置全部用户配置
+glm-quota-line config reset --models   # 只清空自定义模型映射(modelMap)
+glm-quota-line config reset --yes      # 跳过确认(脚本/CI 用)
+```
 
-- 绿色 — 已用 < 60%
-- 黄色 — 已用 60%–79%
-- 红色 — 已用 >= 80%
+- 默认重置范围:所有全局配置项(theme/display/style/work-days/minimalist/raw-values/reset-format/auth-token/base-url)、组件布局(lines)、自定义模型映射(modelMap)。
+- `--models` 限定只清 modelMap,其它配置不动。
+- 非交互环境(无 TTY)必须加 `--yes`,否则报错退出,避免误删。
+- 重置后状态栏仍正常工作——模型映射会回退到包内默认表(`data/models.json`)。
 
 ### auth-token / base-url — 自定义鉴权
 
@@ -129,6 +218,54 @@ glm-quota-line config set base-url https://api.z.ai/api/anthropic
 2. 环境变量 `ANTHROPIC_AUTH_TOKEN` / `ANTHROPIC_BASE_URL`
 3. `~/.claude/settings.json` 中的 `env` 字段
 
+### configure — 交互式 TUI 配置
+
+启动终端交互界面，实时预览状态栏效果，逐项调整组件开关、样式和全局选项。
+
+```bash
+glm-quota-line configure
+```
+
+操作方式：
+- `↑↓` 选择组件，`Enter` 进入编辑，`Tab` 切换样式，`Space` 开关显示
+- `g` 进入全局选项（主题、显示模式、极简模式、原始数值、重置时间格式）
+- `s` 保存，`q` 退出
+
+组件列表：
+
+| 组件 | 说明 | 可设置样式 | 可隐藏 |
+|---|---|---|---|
+| `level` | 套餐级别（如 GLM Lite） | — | ✓ |
+| `5h` | 5 小时配额 | ✓ (bar/text) | —（必需） |
+| `week` | 周配额 | ✓ (bar/text) | ✓ |
+| `reset` | 重置时间 | — | ✓ |
+| `ctx` | 上下文窗口用量 | ✓ (bar/text) | ✓ |
+
+### model — 模型上下文窗口管理
+
+管理模型的上下文窗口大小映射。上下文窗口用量百分比基于此映射计算。
+
+```bash
+glm-quota-line model list                    # 查看所有模型及其上下文窗口大小
+glm-quota-line model get <model-id>          # 查看指定模型的大小
+glm-quota-line model set <model-id> <size>   # 设置模型大小（如 300K 或 300000）
+glm-quota-line model remove <model-id>       # 移除自定义映射（内置模型恢复默认值）
+```
+
+`list` 输出示例：
+
+```
+glm-4.7        200K
+glm-5.1        200K
+glm-5.2        300K *
+```
+
+`*` 标记表示用户自定义的映射。
+
+模型映射采用双层结构:包内 `data/models.json` 作为默认底层,`~/.claude/glm-quota-line.json` 里的 `modelMap` 作为用户覆盖层(运行时逐键覆盖)。**智谱发布新模型时,无需等待 npm 包更新——直接 `model set <新模型> <大小>` 写入本地覆盖层即可立刻生效。**
+
+想清空所有自定义模型映射、回到包内默认表:执行 `glm-quota-line config reset --models --yes`。
+
 ## 推荐搭配
 
 | 使用场景 | 配置 |
@@ -137,29 +274,68 @@ glm-quota-line config set base-url https://api.z.ai/api/anthropic
 | 浅色终端 | `style=bar`, `theme=light` |
 | 极简工作流 | `style=compact`, `theme=mono` |
 | 关注已用量 | `style=bar`, `display=used` |
+| 倒计时重置 | `reset-format=countdown` |
+| 脚本调用 | `--json` |
+| 6 天工作制 | `work-days=6` |
+| 极简数值 | `minimalist=true` |
+| 自定义模型 | `glm-quota-line model set glm-5.2 300K` |
+| 交互式配置 | `glm-quota-line configure` |
 
 ## 命令参考
 
 ```bash
-glm-quota-line [--style text|compact|bar] [--display left|used] [--theme dark|light|mono] [--ctx on|off]
+glm-quota-line [--style text|compact|bar] [--display left|used] [--theme dark|light|mono] [--json]
 glm-quota-line install [--force]
 glm-quota-line uninstall
 glm-quota-line version
 glm-quota-line check-update
+glm-quota-line configure
 glm-quota-line config show
-glm-quota-line config set <style|display|theme|ctx|auth-token|base-url> <value>
+glm-quota-line config set <style|display|theme|auth-token|base-url|work-days|minimalist|raw-values|reset-format> <value>
 glm-quota-line config unset <key>
+glm-quota-line config reset [--models] [--yes]
+glm-quota-line model list
+glm-quota-line model get <model-id>
+glm-quota-line model set <model-id> <size>
+glm-quota-line model remove <model-id>
 ```
 
 运行 `glm-quota-line --help` 查看完整说明。
 
+## 给 Agent / 自动化
+
+如果你是 AI agent(Claude Code / Cursor / Codex)或脚本作者,以下接口保证稳定:
+
+```bash
+# 一次调用拿到所有命令的 machine-readable schema(name / summary / sideEffect / args / examples)
+glm-quota-line commands --json
+
+# 查看单个命令或命令组的聚焦帮助
+glm-quota-line model --help
+glm-quota-line config set --help
+```
+
+约定:
+- **退出码**:成功 `0`,失败 `1`。
+- **副作用标注**:每个命令标为 `read`(只读,自动化安全)、`write`(改配置/模型映射)、`mutating`(改 Claude Code 集成)、`interactive`(需 TTY)。
+- **非阻塞**:所有命令都不会卡住等待输入(仅 `config reset` 在非交互环境需 `--yes`,`configure` 在非 TTY 时打印提示而非启动 TUI)。
+- **只读查询**:`glm-quota-line --json` 输出结构化配额数据(5h/week/MCP + 重置时间)。
+
+典型 agent 工作流:先 `commands --json` 了解能力 → 调用需要的命令 → 读取 stdout 解析结果。
+
 ## 说明
 
 - 展示 `TOKENS_LIMIT` 配额和 `MCP_LIMIT` / `TIME_LIMIT` 配额
-- 状态栏默认显示上下文窗口用量，可通过 `--ctx off` 或 `config set ctx off` 关闭
+- 周配额进度条中的阴影（▒）是每日应耗基准线：根据已过工作日计算的理论预算，已用部分（█）超过阴影越多，说明消耗越快
+- 状态栏默认显示上下文窗口用量和模型信息，可通过 `glm-quota-line configure` 交互式关闭
+- 每个组件可单独控制开关和样式，通过 `glm-quota-line configure` 交互式调整
+- 上下文窗口使用率优先从原始 token 数计算，当模型映射不可用时回退到 API 提供的百分比
+- 模型上下文窗口大小可通过 `glm-quota-line model` 命令自定义，支持查看、设置、移除和批量导入
 - 鉴权缺失返回 `GLM | auth expired`；接口异常返回 `GLM | quota unavailable`
+- 非 GLM 提供商（非智谱 AI 端点）会自动禁用配额查询
 - `install` 默认不会覆盖非本工具管理的状态栏，除非使用 `--force`
 - `install --force` 会备份旧配置，`uninstall` 会在可能时恢复
+- 设置 `GLM_QUOTA_DEBUG=1` 可输出上下文窗口调试信息到 stderr
 
 ## 许可证
 

package/data/models.json

@@ -0,0 +1,10 @@
+{
+  "schemaVersion": 1,
+  "source": "https://open.bigmodel.cn/dev/api#glm",
+  "models": {
+    "glm-4.5-air": 128000,
+    "glm-4.7": 200000,
+    "glm-5-turbo": 200000,
+    "glm-5.2": 1000000
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "glm-quota-line",
-  "version": "1.1.1",
+  "version": "1.3.0",
   "description": "Zhipu GLM Coding Plan quota monitor for Claude Code status line.",
   "type": "module",
   "license": "MIT",
@@ -13,7 +13,8 @@
     "z.ai",
     "coding-plan",
     "quota",
-    "statusline"
+    "statusline",
+    "tui"
   ],
   "repository": {
     "type": "git",
@@ -28,6 +29,7 @@
   },
   "files": [
     "src",
+    "data",
     "README.md",
     "README.en.md",
     "LICENSE",

package/src/claude/sessionStart.js

@@ -3,7 +3,7 @@ import { resolveQuotaStatus } from "../core/quota/service.js";
 import { readStatusLineInput } from "./input.js";
 import { readToolConfig } from "./settings.js";
 
-export const SESSION_START_MATCHERS = ["startup", "resume", "clear"];
+export const SESSION_START_MATCHERS = ["startup", "resume", "clear", "compact"];
 
 export async function refreshQuotaOnSessionStart(options = {}) {
   const hookInput = await readStatusLineInput(options.stdin ?? process.stdin);