usage-cli 0.32.6__tar.gz → 0.33.1__tar.gz

{usage_cli-0.32.6 → usage_cli-0.33.1}/PKG-INFO

@@ -1,12 +1,13 @@
 Metadata-Version: 2.4
 Name: usage-cli
-Version: 0.32.6
+Version: 0.33.1
 Summary: usage — 在 macOS menu bar 與 Windows 系統匣顯示 Claude Code、Codex、Antigravity 用量的小工具（也提供終端機 TUI）
 License-Expression: AGPL-3.0-only
 Requires-Python: >=3.13
 Description-Content-Type: text/markdown
 License-File: LICENSE
 License-File: THIRD_PARTY_NOTICES.md
+Requires-Dist: zstandard<1.0.0,>=0.25.0
 Requires-Dist: pyobjc-framework-Cocoa>=11.0; sys_platform == "darwin"
 Requires-Dist: pyobjc-framework-Quartz>=11.0; sys_platform == "darwin"
 Requires-Dist: pyobjc-framework-UserNotifications>=11.0; sys_platform == "darwin"
@@ -78,6 +79,8 @@ It lands in your Applications folder automatically. Open it once; if macOS 15 or
 - **Progress Concierge:** Open a new Claude Code session and `usage` hands your last progress straight to the AI, including your last request, uncommitted changes, and unfinished todos. No `/resume`, no recap. When you do `/resume` a conversation that sat long enough for its cache to expire, it warns you how many tokens the next message will re-send and suggests `/compact` first. Off by default.
 - **Token Saver:** A menu-bar toggle asks Claude Code and Codex to answer more tersely and in plainer language, saving output tokens while keeping code and error messages byte-exact. A light reminder keeps long conversations from drifting back to verbose — in an A/B test on real sessions, late replies stayed ~40% shorter instead of drifting 84% longer.
 - **Claude Code side pane (macOS and Windows):** Quotas, conversations, and background jobs inside Claude Code. [See the side pane](#claude-code-side-pane).
+- **Beginner Mode (macOS):** Off by default. After Claude Code answers, up to three technical terms from that answer appear above the prompt, each with a one-line plain explanation in your UI language. Press 9 to mark them understood; terms you skip come back after 1, 3, then 7 days. Understood terms return as a one-question multiple-choice quiz 7, 21, then 60 days later, at most one a day; a wrong answer puts the term back in the hints. `/terms` opens your term history. Picking terms asks Claude Haiku through your Claude Code, so it uses a little Claude quota, and it pauses while your 5-hour quota is at 90% or more.
+- **Quota-Aware Mode (macOS):** Off by default. When a 5-hour quota passes 80%, 90%, or 95%, or a weekly quota passes 95%, Claude Code gets one line with what is left and when it resets. Before a big task, Claude then tells you and lets you pick a smaller part or wait for the reset. It covers Claude Code, Codex, and Antigravity quota, says each level once per conversation, and makes no extra model calls.
 - **Auto-start 5-hour Session:** Off by default. Turn it on and, right after a 5-hour quota resets, `usage` sends one tiny message to each tool (Claude with Haiku, Antigravity with Gemini 3.5 Flash Low, Codex with its cheapest model) so the next 5-hour window starts counting right away. Those messages do use a little quota, but the amount is negligible. Checking your quota never sends a message; only this switch does.
 - **Terminal Integration:** `usage status --json` hands your Claude Code, Codex, Antigravity, and Grok quota to any tool that can run a command — Starship, tmux, or your own scripts. Reads the same local files as the menu bar. [Ready-made snippets](docs/DEVELOPMENT.md#quota-status-for-other-tools-usage-status).
 - **Token-waste Health Check:** A daily background diagnosis scans your logs for waste, including repeated file reads, polluter directories, and noisy Bash output. If it finds issues, a one-line heads-up appears; say "show me" and the AI walks you through fixes.
@@ -99,14 +102,17 @@ It lands in your Applications folder automatically. Open it once; if macOS 15 or
 
 ## Privacy & Data Sources
 
+Claude Desktop chat quota is also supported without installing the standalone Claude Code CLI or configuring a status line. Keep Claude Desktop open: when Claude Code quota files are unavailable, usage reads its local `plan-usage-history.json` (including Microsoft Store installations on Windows). When a recent response in its local Chromium block-file HTTP cache matches the organization, usage also reads the exact session and weekly reset times. Newer cached observations take precedence over throttled history samples; older cache must match the percentages. Missing, unsupported, expired, or inconsistent cache data leaves the countdown unknown; times are never estimated. Desktop samples normally update every 5–15 minutes. The panel shows the observation age, marks it stale after 30 minutes, and stops displaying it after two hours. The most recent organization sample is used; custom desktop profiles are not discovered. No cookies, login tokens, or API calls are needed. These quota caches contain no per-project token counts. Desktop sessions that also write compatible Claude Code logs under `~/.claude/projects/` are counted by the existing project/token reports.
+
 - Claude Code and Codex numbers are read from local log files on your machine.
 - Antigravity quota requires network access, and only if you use it: quota is fetched from Google's official quota endpoint using the OAuth credential the Antigravity CLI already stored after sign-in — read from macOS Keychain, Windows Credential Manager, or a local token file depending on CLI version. `usage` reads that credential without writing it back and keeps any refreshed access token in memory only; the call itself reads quota metadata.
 - Background network activity: the Antigravity quota/token endpoints above, public Claude and Codex status pages to flag outages, a public model-pricing table to estimate cost (falls back to built-in prices offline), and occasionally checking GitHub for a new version. Claude Code and Codex log contents are never uploaded.
+- Beginner Mode, only if you turn it on, sends Claude Code's latest answer to Claude Haiku through your own Claude Code sign-in to pick terms. Your term list stays in `~/.usage/glossary.json`.
 
 ## Requirements
 
 - macOS 12 (Monterey) or newer, or Windows 10/11
-- Claude Code, Codex, Antigravity, or Grok CLI has been used at least once (so local usage data exists).
+- Local usage data from Claude Code, Codex, Antigravity, or Grok CLI, or a running Claude Desktop app with plan-usage history.
 - (Source runs only) Python 3.13.
 
 ## Install
@@ -162,7 +168,7 @@ See your quota, other conversations, and background jobs without leaving Claude
 
 **How to enable**
 
-1. In the usage menu bar menu (macOS) or the system-tray panel menu (Windows), check **Claude Code side pane**.
+1. In the usage menu bar menu (macOS) or the system-tray panel menu (Windows), check **Claude Code side pane**. On macOS it sits under the **Claude Code** submenu as **Side pane**.
 2. Open a new conversation or run `/reload-plugins`.
 3. At terminal widths ≥144 columns, the pane opens on the right automatically. In narrower terminals, enter `/usage-dash`.
 
@@ -251,6 +257,7 @@ If the menu bar shows `--`, it's usually not broken — there's just no local da
 | AI Update Daily | ✅ | — | — |
 | Progress Concierge & Token Saver | ✅ | — | — |
 | Token-waste Health Check | ✅ | — | — |
+| Claude Code Beginner Mode & Quota-Aware Mode | ✅ | — | — |
 | Open-source license | AGPL-3.0 | MIT | — |
 
 ## When usage Isn't the Right Fit

{usage_cli-0.32.6 → usage_cli-0.33.1}/README.md

@@ -57,6 +57,8 @@ It lands in your Applications folder automatically. Open it once; if macOS 15 or
 - **Progress Concierge:** Open a new Claude Code session and `usage` hands your last progress straight to the AI, including your last request, uncommitted changes, and unfinished todos. No `/resume`, no recap. When you do `/resume` a conversation that sat long enough for its cache to expire, it warns you how many tokens the next message will re-send and suggests `/compact` first. Off by default.
 - **Token Saver:** A menu-bar toggle asks Claude Code and Codex to answer more tersely and in plainer language, saving output tokens while keeping code and error messages byte-exact. A light reminder keeps long conversations from drifting back to verbose — in an A/B test on real sessions, late replies stayed ~40% shorter instead of drifting 84% longer.
 - **Claude Code side pane (macOS and Windows):** Quotas, conversations, and background jobs inside Claude Code. [See the side pane](#claude-code-side-pane).
+- **Beginner Mode (macOS):** Off by default. After Claude Code answers, up to three technical terms from that answer appear above the prompt, each with a one-line plain explanation in your UI language. Press 9 to mark them understood; terms you skip come back after 1, 3, then 7 days. Understood terms return as a one-question multiple-choice quiz 7, 21, then 60 days later, at most one a day; a wrong answer puts the term back in the hints. `/terms` opens your term history. Picking terms asks Claude Haiku through your Claude Code, so it uses a little Claude quota, and it pauses while your 5-hour quota is at 90% or more.
+- **Quota-Aware Mode (macOS):** Off by default. When a 5-hour quota passes 80%, 90%, or 95%, or a weekly quota passes 95%, Claude Code gets one line with what is left and when it resets. Before a big task, Claude then tells you and lets you pick a smaller part or wait for the reset. It covers Claude Code, Codex, and Antigravity quota, says each level once per conversation, and makes no extra model calls.
 - **Auto-start 5-hour Session:** Off by default. Turn it on and, right after a 5-hour quota resets, `usage` sends one tiny message to each tool (Claude with Haiku, Antigravity with Gemini 3.5 Flash Low, Codex with its cheapest model) so the next 5-hour window starts counting right away. Those messages do use a little quota, but the amount is negligible. Checking your quota never sends a message; only this switch does.
 - **Terminal Integration:** `usage status --json` hands your Claude Code, Codex, Antigravity, and Grok quota to any tool that can run a command — Starship, tmux, or your own scripts. Reads the same local files as the menu bar. [Ready-made snippets](docs/DEVELOPMENT.md#quota-status-for-other-tools-usage-status).
 - **Token-waste Health Check:** A daily background diagnosis scans your logs for waste, including repeated file reads, polluter directories, and noisy Bash output. If it finds issues, a one-line heads-up appears; say "show me" and the AI walks you through fixes.
@@ -78,14 +80,17 @@ It lands in your Applications folder automatically. Open it once; if macOS 15 or
 
 ## Privacy & Data Sources
 
+Claude Desktop chat quota is also supported without installing the standalone Claude Code CLI or configuring a status line. Keep Claude Desktop open: when Claude Code quota files are unavailable, usage reads its local `plan-usage-history.json` (including Microsoft Store installations on Windows). When a recent response in its local Chromium block-file HTTP cache matches the organization, usage also reads the exact session and weekly reset times. Newer cached observations take precedence over throttled history samples; older cache must match the percentages. Missing, unsupported, expired, or inconsistent cache data leaves the countdown unknown; times are never estimated. Desktop samples normally update every 5–15 minutes. The panel shows the observation age, marks it stale after 30 minutes, and stops displaying it after two hours. The most recent organization sample is used; custom desktop profiles are not discovered. No cookies, login tokens, or API calls are needed. These quota caches contain no per-project token counts. Desktop sessions that also write compatible Claude Code logs under `~/.claude/projects/` are counted by the existing project/token reports.
+
 - Claude Code and Codex numbers are read from local log files on your machine.
 - Antigravity quota requires network access, and only if you use it: quota is fetched from Google's official quota endpoint using the OAuth credential the Antigravity CLI already stored after sign-in — read from macOS Keychain, Windows Credential Manager, or a local token file depending on CLI version. `usage` reads that credential without writing it back and keeps any refreshed access token in memory only; the call itself reads quota metadata.
 - Background network activity: the Antigravity quota/token endpoints above, public Claude and Codex status pages to flag outages, a public model-pricing table to estimate cost (falls back to built-in prices offline), and occasionally checking GitHub for a new version. Claude Code and Codex log contents are never uploaded.
+- Beginner Mode, only if you turn it on, sends Claude Code's latest answer to Claude Haiku through your own Claude Code sign-in to pick terms. Your term list stays in `~/.usage/glossary.json`.
 
 ## Requirements
 
 - macOS 12 (Monterey) or newer, or Windows 10/11
-- Claude Code, Codex, Antigravity, or Grok CLI has been used at least once (so local usage data exists).
+- Local usage data from Claude Code, Codex, Antigravity, or Grok CLI, or a running Claude Desktop app with plan-usage history.
 - (Source runs only) Python 3.13.
 
 ## Install
@@ -141,7 +146,7 @@ See your quota, other conversations, and background jobs without leaving Claude
 
 **How to enable**
 
-1. In the usage menu bar menu (macOS) or the system-tray panel menu (Windows), check **Claude Code side pane**.
+1. In the usage menu bar menu (macOS) or the system-tray panel menu (Windows), check **Claude Code side pane**. On macOS it sits under the **Claude Code** submenu as **Side pane**.
 2. Open a new conversation or run `/reload-plugins`.
 3. At terminal widths ≥144 columns, the pane opens on the right automatically. In narrower terminals, enter `/usage-dash`.
 
@@ -230,6 +235,7 @@ If the menu bar shows `--`, it's usually not broken — there's just no local da
 | AI Update Daily | ✅ | — | — |
 | Progress Concierge & Token Saver | ✅ | — | — |
 | Token-waste Health Check | ✅ | — | — |
+| Claude Code Beginner Mode & Quota-Aware Mode | ✅ | — | — |
 | Open-source license | AGPL-3.0 | MIT | — |
 
 ## When usage Isn't the Right Fit

usage_cli-0.33.1/THIRD_PARTY_NOTICES.md

@@ -0,0 +1,96 @@
+# Third-party notices
+
+The Windows taskbar label anchoring in `wintray/taskbar_overlay.py` is adapted
+from [Codex Usage Widget](https://github.com/ognjeeen/codex-usage-widget),
+commit `940d722d4044242bbe73f8056014449c2ef827a7`, particularly
+`Infrastructure/Windows/TaskbarWindowInterop.cs`.
+
+MIT License
+
+Copyright (c) 2026 Ognjen Marinković
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+
+## Python Zstandard
+
+The local Claude HTTP cache reader uses python-zstandard, including its bundled
+Zstandard library, under their BSD licenses.
+
+Copyright (c) 2016, Gregory Szorc
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without modification,
+are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this
+list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice,
+this list of conditions and the following disclaimer in the documentation
+and/or other materials provided with the distribution.
+
+3. Neither the name of the copyright holder nor the names of its contributors
+may be used to endorse or promote products derived from this software without
+specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
+ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR
+ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
+(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
+ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+
+## Zstandard
+
+BSD License
+
+For Zstandard software
+
+Copyright (c) Meta Platforms, Inc. and affiliates. All rights reserved.
+
+Redistribution and use in source and binary forms, with or without modification,
+are permitted provided that the following conditions are met:
+
+ * Redistributions of source code must retain the above copyright notice, this
+   list of conditions and the following disclaimer.
+
+ * Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the documentation
+   and/or other materials provided with the distribution.
+
+ * Neither the name Facebook, nor Meta, nor the names of its contributors may
+   be used to endorse or promote products derived from this software without
+   specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
+ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR
+ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
+(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
+ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

{usage_cli-0.32.6 → usage_cli-0.33.1}/adapters/rate_limits.py

@@ -10,6 +10,8 @@ import os
 from datetime import datetime, timezone
 from typing import Any
 
+import usage_client
+
 from .types import RateLimits
 
 STATUS_FILE = os.path.expanduser("~/.claude/usage-status.json")
@@ -42,8 +44,12 @@ def _read_status() -> dict[str, Any] | None:
 
 def load_rate_limits() -> RateLimits | None:
     data = _read_status()
-    if data is None:
-        return None
+    if data is None or not usage_client._has_complete_rate_limits(data):
+        snapshot = usage_client.read_quota_fallback()
+        if snapshot is not None:
+            return _snapshot_rate_limits(snapshot)
+        if data is None:
+            return None
 
     rl = data.get("rate_limits") or {}
     five = rl.get("five_hour") or {}
@@ -74,3 +80,18 @@ def load_rate_limits() -> RateLimits | None:
         model=model_name,
         updated_at=data.get("_received_at", ""),
     )
+
+
+def _snapshot_rate_limits(quota: usage_client.UsageSnapshot) -> RateLimits:
+    return RateLimits(
+        five_hour_pct=quota.current_percent,
+        seven_day_pct=quota.weekly_percent,
+        five_hour_resets_at=int(quota.current_reset_at)
+        if quota.current_reset_at is not None
+        else None,
+        seven_day_resets_at=int(quota.weekly_reset_at)
+        if quota.weekly_reset_at is not None
+        else None,
+        model="",
+        updated_at=datetime.fromtimestamp(quota.polled_at, timezone.utc).isoformat(),
+    )

{usage_cli-0.32.6 → usage_cli-0.33.1}/i18n.json

@@ -69,7 +69,7 @@
     "awaiting_rate_limits": "請對 Claude Code 發送一句訊息以同步配額",
     "hook_broken_not_installed": "⚠ 狀態列沒在更新，請按「設定狀態列」重新安裝",
     "hook_broken_restart": "⚠ 狀態列沒在運作，請重開一次 Claude Code",
-    "usage_status_missing": "⚠ 找不到狀態檔，請按「設定狀態列」，再打開一次 Claude Code",
+    "usage_status_missing": "尚無額度資料。請保持 Claude 桌面版開啟，或設定狀態列後啟動終端機的 Claude Code。",
     "usage_status_missing_active": "⚠ 配額資料只能靠終端機的狀態列同步，桌面版／背景工作階段不會觸發，請開一次終端機的 Claude Code 來同步",
     "usage_status_no_quota": "⚠ 狀態檔尚無配額資料，等 Claude Code 再刷新一次 statusLine",
     "status_error": "錯誤 ({message})",
@@ -490,6 +490,8 @@
     "claude_pane_sidecar_error": "面板設定讀取失敗：{error}",
     "menu_badge_new": "新",
     "claude_pane_menu": "Claude Code 側邊面板",
+    "claude_code_section": "Claude Code",
+    "claude_pane_section_menu": "側邊面板",
     "claude_pane_tooltip": "在 Claude Code 顯示額度、對話與背景工作",
     "claude_pane_enabled_msg": "已開啟側邊面板。開新的 Claude Code 對話（或在對話裡打 /reload-plugins）後生效；終端機寬度不夠時打 /usage-dash 叫出面板。",
     "claude_pane_fullscreen_enabled_note": "已一併開啟 Claude Code 的全螢幕介面，讓面板顯示在右側。取消勾選側邊面板時會改回。",
@@ -515,7 +517,34 @@
     "keeper_failed_line": "上次失敗 {time}：{tool}（{reason}）",
     "terse_codex_hook_untrusted": "Codex 還沒批准 usage 的精簡模式 hook，Codex 那邊不會生效。在 Codex 裡打 /hooks 批准它。",
     "terse_codex_hook_disabled": "你在 Codex 停用了 usage 的精簡模式 hook。在 Codex 裡打 /hooks 重新啟用。",
-    "claude_pane_stopped": "已停止"
+    "claude_pane_stopped": "已停止",
+    "claude_beginner_menu": "新手模式",
+    "claude_beginner_tooltip": "幫你看懂 Claude 的回答：回答完，在輸入框上方用白話提示最多 3 個專有名詞。按 9 標成「懂了」就不再提示，之後開新對話時會出選擇題小考。會用到少量 Claude 額度。",
+    "claude_beginner_title": "名詞提示",
+    "claude_beginner_history_title": "名詞提示紀錄",
+    "claude_beginner_description": "開啟名詞提示紀錄",
+    "claude_beginner_all_known": "都懂了",
+    "claude_beginner_dismiss": "收起",
+    "claude_beginner_known": "懂了",
+    "claude_beginner_unknown": "還不懂",
+    "claude_beginner_empty": "還沒有名詞紀錄。",
+    "claude_beginner_opened": "已開啟名詞提示紀錄。",
+    "claude_beginner_quiz_title": "小考",
+    "claude_beginner_quiz_question": "{term} 是什麼意思？",
+    "claude_beginner_quiz_right": "答對了！{days} 天後再考一次。",
+    "claude_beginner_quiz_done": "答對了！這個詞你已經學會了。",
+    "claude_beginner_quiz_wrong": "答錯了。正確答案：{answer}。這個詞之後會再出現在名詞提示裡。",
+    "claude_beginner_enabled_msg": "已開啟新手模式。重開 Claude Code 後生效。",
+    "claude_beginner_disabled_msg": "已關閉新手模式。重開 Claude Code 後生效。",
+    "claude_beginner_action_failed": "無法切換新手模式",
+    "quota_aware_menu": "額度感知模式",
+    "quota_aware_tooltip": "額度快用完時，Claude 開大任務前會先告訴你剩多少、幾點重置，讓你選先做小的還是等重置。",
+    "quota_aware_enabled_msg": "已開啟額度感知模式。請重啟 Claude Code 套用。",
+    "quota_aware_disabled_msg": "已關閉額度感知模式。請重啟 Claude Code 套用。",
+    "quota_aware_action_failed": "無法切換額度感知模式。",
+    "claude_beginner_error": "新手模式：{error}",
+    "claude_desktop_updated": "Claude 桌面版 · {minutes} 分鐘前更新",
+    "claude_desktop_stale": "Claude 桌面版 · 資料過期 · {minutes} 分鐘前更新"
   },
   "en": {
     "panel_default_name": "Default",
@@ -587,7 +616,7 @@
     "awaiting_rate_limits": "Send a message in Claude Code to sync your quota",
     "hook_broken_not_installed": "⚠ Status line is not updating. Click \"Set Up Status Line\" to reinstall it.",
     "hook_broken_restart": "⚠ Status line hook is not running. Restart Claude Code once.",
-    "usage_status_missing": "⚠ Status file not found. Click \"Set Up Status Line\", then open Claude Code once.",
+    "usage_status_missing": "No quota data yet. Keep Claude Desktop open, or set up the status line and start Claude Code in a terminal.",
     "usage_status_missing_active": "⚠ Quota data only syncs via the terminal status line — the desktop app and headless sessions don't trigger it. Open Claude Code in a terminal once to sync.",
     "usage_status_no_quota": "⚠ Status file has no quota data yet. Wait for Claude Code to refresh statusLine once.",
     "status_error": "Error ({message})",
@@ -1008,6 +1037,8 @@
     "claude_pane_sidecar_error": "Cannot read pane settings: {error}",
     "menu_badge_new": "New",
     "claude_pane_menu": "Claude Code side pane",
+    "claude_code_section": "Claude Code",
+    "claude_pane_section_menu": "Side pane",
     "claude_pane_tooltip": "Show quotas, Claude sessions and background jobs in Claude Code",
     "claude_pane_enabled_msg": "Pane enabled. Open a new Claude Code conversation (or run /reload-plugins in a conversation). If the terminal is too narrow, run /usage-dash to open the pane.",
     "claude_pane_fullscreen_enabled_note": "Claude Code's fullscreen layout is now on so the pane can sit on the right. Turning the side pane off switches it back.",
@@ -1033,7 +1064,34 @@
     "keeper_failed_line": "Last failure {time}: {tool} ({reason})",
     "terse_codex_hook_untrusted": "Codex has not approved usage’s terse mode hook, so terse mode will not work in Codex. Run /hooks in Codex to approve it.",
     "terse_codex_hook_disabled": "You disabled usage’s terse mode hook in Codex. Run /hooks in Codex to enable it again.",
-    "claude_pane_stopped": "stopped"
+    "claude_pane_stopped": "stopped",
+    "claude_beginner_menu": "Beginner Mode",
+    "claude_beginner_tooltip": "Understand Claude’s answers: after each answer, see up to 3 technical terms explained above the prompt. Press 9 to mark them as understood so they stop appearing; a new conversation will later quiz you on them with a multiple-choice question. Uses a small amount of Claude quota.",
+    "claude_beginner_title": "Terms",
+    "claude_beginner_history_title": "Term history",
+    "claude_beginner_description": "Open your term history",
+    "claude_beginner_all_known": "All understood",
+    "claude_beginner_dismiss": "Dismiss",
+    "claude_beginner_known": "Understood",
+    "claude_beginner_unknown": "Not yet understood",
+    "claude_beginner_empty": "No terms yet.",
+    "claude_beginner_opened": "Term history opened.",
+    "claude_beginner_quiz_title": "Quick quiz",
+    "claude_beginner_quiz_question": "What does {term} mean?",
+    "claude_beginner_quiz_right": "Correct! Next quiz in {days} days.",
+    "claude_beginner_quiz_done": "Correct! You have learned this term.",
+    "claude_beginner_quiz_wrong": "Not quite. The answer is: {answer}. This term will show up in the hints again.",
+    "claude_beginner_enabled_msg": "Beginner Mode enabled. Restart Claude Code to apply.",
+    "claude_beginner_disabled_msg": "Beginner Mode disabled. Restart Claude Code to apply.",
+    "claude_beginner_action_failed": "Could not change Beginner Mode",
+    "quota_aware_menu": "Quota-Aware Mode",
+    "quota_aware_tooltip": "When quota is running low, Claude tells you how much remains and when it resets before starting a large task, so you can choose a smaller part now or wait for the reset.",
+    "quota_aware_enabled_msg": "Quota-Aware Mode enabled. Restart Claude Code to apply.",
+    "quota_aware_disabled_msg": "Quota-Aware Mode disabled. Restart Claude Code to apply.",
+    "quota_aware_action_failed": "Could not change Quota-Aware Mode.",
+    "claude_beginner_error": "Beginner Mode: {error}",
+    "claude_desktop_updated": "Claude Desktop · updated {minutes}m ago",
+    "claude_desktop_stale": "Claude Desktop · stale · updated {minutes}m ago"
   },
   "zh-CN": {
     "panel_default_name": "默认",
@@ -1105,7 +1163,7 @@
     "awaiting_rate_limits": "请对 Claude Code 发送一句消息以同步配额",
     "hook_broken_not_installed": "⚠ 状态栏没有更新，请点「设置状态栏」重新安装",
     "hook_broken_restart": "⚠ 状态栏没有运行，请重开一次 Claude Code",
-    "usage_status_missing": "⚠ 找不到状态文件，请点「设置状态栏」，再打开一次 Claude Code",
+    "usage_status_missing": "尚无额度数据。请保持 Claude 桌面版打开，或设置状态栏后启动终端中的 Claude Code。",
     "usage_status_missing_active": "⚠ 配额数据只能靠终端的状态栏同步，桌面版／后台会话不会触发，请打开一次终端的 Claude Code 来同步",
     "usage_status_no_quota": "⚠ 状态文件还没有配额数据，等 Claude Code 再刷新一次 statusLine",
     "status_error": "错误 ({message})",
@@ -1526,6 +1584,8 @@
     "claude_pane_sidecar_error": "面板设置读取失败：{error}",
     "menu_badge_new": "新",
     "claude_pane_menu": "Claude Code 侧边面板",
+    "claude_code_section": "Claude Code",
+    "claude_pane_section_menu": "侧边面板",
     "claude_pane_tooltip": "在 Claude Code 显示额度、对话与后台任务",
     "claude_pane_enabled_msg": "已开启侧边面板。打开新的 Claude Code 对话（或在对话里输入 /reload-plugins）后生效；终端宽度不够时输入 /usage-dash 打开面板。",
     "claude_pane_fullscreen_enabled_note": "已一并开启 Claude Code 的全屏界面，让面板显示在右侧。取消勾选侧边面板时会改回。",
@@ -1551,7 +1611,34 @@
     "keeper_failed_line": "上次失败 {time}：{tool}（{reason}）",
     "terse_codex_hook_untrusted": "Codex 还没批准 usage 的精简模式 hook，Codex 那边不会生效。在 Codex 里输入 /hooks 批准它。",
     "terse_codex_hook_disabled": "你在 Codex 停用了 usage 的精简模式 hook。在 Codex 里输入 /hooks 重新启用。",
-    "claude_pane_stopped": "已停止"
+    "claude_pane_stopped": "已停止",
+    "claude_beginner_menu": "新手模式",
+    "claude_beginner_tooltip": "帮你看懂 Claude 的回答：回答完，在输入框上方用白话提示最多 3 个专业术语。按 9 标成“懂了”就不再提示，之后开新对话时会出选择题小测验。会用到少量 Claude 额度。",
+    "claude_beginner_title": "术语提示",
+    "claude_beginner_history_title": "术语提示记录",
+    "claude_beginner_description": "打开术语提示记录",
+    "claude_beginner_all_known": "都懂了",
+    "claude_beginner_dismiss": "收起",
+    "claude_beginner_known": "懂了",
+    "claude_beginner_unknown": "还不懂",
+    "claude_beginner_empty": "还没有术语记录。",
+    "claude_beginner_opened": "已打开术语提示记录。",
+    "claude_beginner_quiz_title": "小测验",
+    "claude_beginner_quiz_question": "{term} 是什么意思？",
+    "claude_beginner_quiz_right": "答对了！{days} 天后再考一次。",
+    "claude_beginner_quiz_done": "答对了！这个词你已经学会了。",
+    "claude_beginner_quiz_wrong": "答错了。正确答案：{answer}。这个词之后会再出现在术语提示里。",
+    "claude_beginner_enabled_msg": "已开启新手模式。重启 Claude Code 后生效。",
+    "claude_beginner_disabled_msg": "已关闭新手模式。重启 Claude Code 后生效。",
+    "claude_beginner_action_failed": "无法切换新手模式",
+    "quota_aware_menu": "额度感知模式",
+    "quota_aware_tooltip": "额度快用完时，Claude 开大任务前会先告诉你还剩多少、几点重置，让你选先做小的还是等重置。",
+    "quota_aware_enabled_msg": "已开启额度感知模式。请重启 Claude Code 应用。",
+    "quota_aware_disabled_msg": "已关闭额度感知模式。请重启 Claude Code 应用。",
+    "quota_aware_action_failed": "无法切换额度感知模式。",
+    "claude_beginner_error": "新手模式：{error}",
+    "claude_desktop_updated": "Claude 桌面版 · {minutes} 分钟前更新",
+    "claude_desktop_stale": "Claude 桌面版 · 数据过期 · {minutes} 分钟前更新"
   },
   "ja": {
     "panel_default_name": "デフォルト",
@@ -1623,7 +1710,7 @@
     "awaiting_rate_limits": "Claude Code にメッセージを送信してクォータを同期してください",
     "hook_broken_not_installed": "⚠ ステータスラインが更新されていません。「ステータスラインを設定」を押して再インストールしてください。",
     "hook_broken_restart": "⚠ ステータスライン hook が動作していません。Claude Code を一度再起動してください。",
-    "usage_status_missing": "⚠ ステータスファイルが見つかりません。「ステータスラインを設定」を押してから、Claude Code を一度起動してください。",
+    "usage_status_missing": "利用枠データがありません。Claude デスクトップを開いたままにするか、ステータスラインを設定してターミナルの Claude Code を起動してください。",
     "usage_status_missing_active": "⚠ クォータ情報はターミナルのステータスラインでのみ同期されます。デスクトップアプリやヘッドレスセッションでは同期されません。ターミナルで Claude Code を一度開いてください。",
     "usage_status_no_quota": "⚠ ステータスファイルにクォータデータがまだありません。Claude Code が statusLine をもう一度更新するまでお待ちください。",
     "status_error": "エラー ({message})",
@@ -2044,6 +2131,8 @@
     "claude_pane_sidecar_error": "パネル設定を読み込めません: {error}",
     "menu_badge_new": "新規",
     "claude_pane_menu": "Claude Code サイドパネル",
+    "claude_code_section": "Claude Code",
+    "claude_pane_section_menu": "サイドペイン",
     "claude_pane_tooltip": "Claude Code に使用量、セッション、バックグラウンド作業を表示",
     "claude_pane_enabled_msg": "サイドパネルを有効にしました。新しい Claude Code セッションを開くか、会話で /reload-plugins を実行してください。ターミナルの幅が足りない場合は /usage-dash で開けます。",
     "claude_pane_fullscreen_enabled_note": "Claude Code のフルスクリーンレイアウトを有効にし、パネルを右側に表示できるようにしました。サイドパネルをオフにすると元に戻ります。",
@@ -2069,7 +2158,34 @@
     "keeper_failed_line": "前回の失敗 {time}：{tool}（{reason}）",
     "terse_codex_hook_untrusted": "Codex が usage の簡潔モード hook をまだ承認していないため、Codex では機能しません。Codex で /hooks を入力して承認してください。",
     "terse_codex_hook_disabled": "Codex で usage の簡潔モード hook が無効になっています。Codex で /hooks を入力して再び有効にしてください。",
-    "claude_pane_stopped": "停止済み"
+    "claude_pane_stopped": "停止済み",
+    "claude_beginner_menu": "初心者モード",
+    "claude_beginner_tooltip": "Claude の回答をわかりやすく：回答後、入力欄の上に最大3つの専門用語をやさしく説明します。9を押すと「理解した」と記録して表示しなくなり、後日、新しい会話で選択式のミニテストが出ます。Claude の使用枠を少量使います。",
+    "claude_beginner_title": "用語のヒント",
+    "claude_beginner_history_title": "用語の履歴",
+    "claude_beginner_description": "用語の履歴を開く",
+    "claude_beginner_all_known": "すべて理解した",
+    "claude_beginner_dismiss": "閉じる",
+    "claude_beginner_known": "理解した",
+    "claude_beginner_unknown": "まだわからない",
+    "claude_beginner_empty": "用語の記録はまだありません。",
+    "claude_beginner_opened": "用語の履歴を開きました。",
+    "claude_beginner_quiz_title": "ミニテスト",
+    "claude_beginner_quiz_question": "{term} の意味は？",
+    "claude_beginner_quiz_right": "正解！{days} 日後にもう一度出題します。",
+    "claude_beginner_quiz_done": "正解！この用語は覚えました。",
+    "claude_beginner_quiz_wrong": "不正解。正解は「{answer}」です。この用語はまた用語ヒントに表示されます。",
+    "claude_beginner_enabled_msg": "初心者モードを有効にしました。Claude Code を再起動してください。",
+    "claude_beginner_disabled_msg": "初心者モードを無効にしました。Claude Code を再起動してください。",
+    "claude_beginner_action_failed": "初心者モードを切り替えられません",
+    "quota_aware_menu": "クォータ認識モード",
+    "quota_aware_tooltip": "クォータが少なくなると、大きなタスクを始める前に Claude が残量とリセット時刻を伝えます。小さな部分を先に進めるか、リセットを待つか選べます。",
+    "quota_aware_enabled_msg": "クォータ認識モードを有効にしました。Claude Code を再起動してください。",
+    "quota_aware_disabled_msg": "クォータ認識モードを無効にしました。Claude Code を再起動してください。",
+    "quota_aware_action_failed": "クォータ認識モードを切り替えられませんでした。",
+    "claude_beginner_error": "初心者モード：{error}",
+    "claude_desktop_updated": "Claude デスクトップ · {minutes}分前に更新",
+    "claude_desktop_stale": "Claude デスクトップ · 古いデータ · {minutes}分前に更新"
   },
   "ko": {
     "panel_default_name": "기본",
@@ -2141,7 +2257,7 @@
     "awaiting_rate_limits": "Claude Code에 메시지를 보내 할당량을 동기화하세요",
     "hook_broken_not_installed": "⚠ 상태 표시줄이 업데이트되지 않습니다. \"상태 표시줄 설정\"을 눌러 다시 설치하세요.",
     "hook_broken_restart": "⚠ 상태 표시줄 hook이 작동하지 않습니다. Claude Code를 한 번 다시 시작하세요.",
-    "usage_status_missing": "⚠ 상태 파일을 찾을 수 없습니다. \"상태 표시줄 설정\"을 누른 뒤 Claude Code를 한 번 여세요.",
+    "usage_status_missing": "사용 한도 데이터가 없습니다. Claude 데스크톱을 열어 두거나 상태 표시줄을 설정한 뒤 터미널에서 Claude Code를 실행하세요.",
     "usage_status_missing_active": "⚠ 할당량 데이터는 터미널 상태 표시줄로만 동기화됩니다. 데스크톱 앱이나 헤드리스 세션에서는 동기화되지 않습니다. 터미널에서 Claude Code를 한 번 열어주세요.",
     "usage_status_no_quota": "⚠ 상태 파일에 아직 할당량 데이터가 없습니다. Claude Code가 statusLine을 한 번 더 새로 고칠 때까지 기다리세요.",
     "status_error": "오류 ({message})",
@@ -2562,6 +2678,8 @@
     "claude_pane_sidecar_error": "패널 설정을 읽을 수 없습니다: {error}",
     "menu_badge_new": "신규",
     "claude_pane_menu": "Claude Code 사이드 패널",
+    "claude_code_section": "Claude Code",
+    "claude_pane_section_menu": "사이드 패널",
     "claude_pane_tooltip": "Claude Code에 사용량, 대화 및 백그라운드 작업 표시",
     "claude_pane_enabled_msg": "사이드 패널을 켰습니다. 새 Claude Code 대화를 열거나 대화에서 /reload-plugins를 실행하세요. 터미널이 좁으면 /usage-dash로 패널을 여세요.",
     "claude_pane_fullscreen_enabled_note": "Claude Code의 전체 화면 레이아웃도 켜서 패널이 오른쪽에 표시됩니다. 사이드 패널을 끄면 원래대로 돌아갑니다.",
@@ -2587,6 +2705,33 @@
     "keeper_failed_line": "마지막 실패 {time}: {tool} ({reason})",
     "terse_codex_hook_untrusted": "Codex가 usage의 간결 모드 hook을 아직 승인하지 않아 Codex에서 작동하지 않습니다. Codex에서 /hooks를 입력해 승인하세요.",
     "terse_codex_hook_disabled": "Codex에서 usage의 간결 모드 hook을 비활성화했습니다. Codex에서 /hooks를 입력해 다시 활성화하세요.",
-    "claude_pane_stopped": "중지됨"
+    "claude_pane_stopped": "중지됨",
+    "claude_beginner_menu": "초보자 모드",
+    "claude_beginner_tooltip": "Claude의 답변을 쉽게 이해하세요. 답변 후 입력창 위에 전문 용어를 최대 3개까지 쉽게 설명합니다. 9를 누르면 이해한 것으로 기록하여 더 이상 표시하지 않고, 나중에 새 대화에서 객관식 퀴즈를 냅니다. Claude 사용량을 조금 씁니다.",
+    "claude_beginner_title": "용어 안내",
+    "claude_beginner_history_title": "용어 안내 기록",
+    "claude_beginner_description": "용어 안내 기록 열기",
+    "claude_beginner_all_known": "모두 이해했어요",
+    "claude_beginner_dismiss": "닫기",
+    "claude_beginner_known": "이해했어요",
+    "claude_beginner_unknown": "아직 모르겠어요",
+    "claude_beginner_empty": "아직 용어 기록이 없습니다.",
+    "claude_beginner_opened": "용어 안내 기록을 열었습니다.",
+    "claude_beginner_quiz_title": "퀴즈",
+    "claude_beginner_quiz_question": "{term}의 뜻은?",
+    "claude_beginner_quiz_right": "정답! {days}일 후에 다시 출제합니다.",
+    "claude_beginner_quiz_done": "정답! 이 용어를 익혔어요.",
+    "claude_beginner_quiz_wrong": "오답이에요. 정답: {answer}. 이 용어는 용어 힌트에 다시 나타납니다.",
+    "claude_beginner_enabled_msg": "초보자 모드를 켰습니다. Claude Code를 다시 시작하세요.",
+    "claude_beginner_disabled_msg": "초보자 모드를 껐습니다. Claude Code를 다시 시작하세요.",
+    "claude_beginner_action_failed": "초보자 모드를 전환할 수 없습니다",
+    "quota_aware_menu": "할당량 인식 모드",
+    "quota_aware_tooltip": "할당량이 부족해지면 Claude가 큰 작업을 시작하기 전에 남은 양과 초기화 시간을 알려 줍니다. 작은 부분을 먼저 진행하거나 초기화를 기다릴 수 있습니다.",
+    "quota_aware_enabled_msg": "할당량 인식 모드를 켰습니다. Claude Code를 다시 시작해 주세요.",
+    "quota_aware_disabled_msg": "할당량 인식 모드를 껐습니다. Claude Code를 다시 시작해 주세요.",
+    "quota_aware_action_failed": "할당량 인식 모드를 변경할 수 없습니다.",
+    "claude_beginner_error": "초보자 모드: {error}",
+    "claude_desktop_updated": "Claude 데스크톱 · {minutes}분 전 업데이트",
+    "claude_desktop_stale": "Claude 데스크톱 · 오래된 데이터 · {minutes}분 전 업데이트"
   }
 }