usage-cli 0.32.1__tar.gz → 0.32.3__tar.gz

{usage_cli-0.32.1 → usage_cli-0.32.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: usage-cli
-Version: 0.32.1
+Version: 0.32.3
 Summary: usage — 在 macOS menu bar 與 Windows 系統匣顯示 Claude Code、Codex、Antigravity 用量的小工具（也提供終端機 TUI）
 License-Expression: AGPL-3.0-only
 Requires-Python: >=3.13

{usage_cli-0.32.1 → usage_cli-0.32.3}/i18n.json

@@ -56,6 +56,7 @@
     "data_stale_hint": "資料來自備援來源，建議檢查設定",
     "status_loading": "載入中",
     "status_synced": "✓ 已同步",
+    "status_refreshing": "↻ 更新中…",
     "status_no_data": "無資料",
     "awaiting_rate_limits": "請對 Claude Code 發送一句訊息以同步配額",
     "hook_broken_not_installed": "⚠ 狀態列沒在更新，請按「設定狀態列」重新安裝",
@@ -75,6 +76,7 @@
     "percent_used": "{value}% 已用",
     "reset_in": "重置 {time}",
     "reset_imminent": "即將重置",
+    "reset_done": "已重置",
     "burn_warning": "⚠ 照目前速度 {empty}後用完 · 重置 {reset}",
     "burn_warning_compact": "⚠ {empty}後用完",
     "reset_placeholder": "重置 --",
@@ -431,8 +433,19 @@
     "claude_pane_week": "週",
     "claude_pane_period": "期間",
     "claude_pane_sessions": "Claude 對話",
+    "claude_pane_session_done": "完成：{title}",
+    "claude_pane_session_waiting": "在等你：{title}",
     "claude_pane_busy": "忙",
     "claude_pane_waiting": "等你",
+    "claude_pane_unavailable_not_signed_in": "未登入 · 在它的 CLI 登入一次",
+    "claude_pane_unavailable_no_data": "還沒有資料 · 用過一次就會出現",
+    "claude_pane_unavailable_error": "讀不到 · 會自動重試",
+    "claude_pane_waiting_input": "要你回答",
+    "claude_pane_waiting_dialog": "對話框開著",
+    "claude_pane_waiting_sandbox": "要允許沙盒",
+    "claude_pane_waiting_worker": "子代理請求",
+    "claude_pane_waiting_goal": "確認目標",
+    "claude_pane_waiting_for": "等你：{reason}",
     "claude_pane_agent_running": "執行中",
     "claude_pane_agent_idle": "閒置",
     "claude_pane_agent_pending": "待執行",
@@ -479,6 +492,7 @@
     "claude_pane_invalid_sidecar": "usage-pane.json 格式錯誤",
     "claude_pane_elapsed": "{minutes}分{seconds}秒",
     "claude_pane_remaining": "剩",
+    "claude_pane_reset_done": "已重置",
     "claude_pane_hours_ago": "{count}時前"
   },
   "en": {
@@ -538,6 +552,7 @@
     "data_stale_hint": "Data is from a fallback source. Check settings.",
     "status_loading": "Loading",
     "status_synced": "✓ Synced",
+    "status_refreshing": "↻ Refreshing…",
     "status_no_data": "No data",
     "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.",
@@ -557,6 +572,7 @@
     "percent_used": "{value}% used",
     "reset_in": "Resets in {time}",
     "reset_imminent": "Reset imminent",
+    "reset_done": "Reset",
     "burn_warning": "⚠ At this pace, empty in {empty} · resets in {reset}",
     "burn_warning_compact": "⚠ Empty in {empty}",
     "reset_placeholder": "Resets in --",
@@ -913,8 +929,19 @@
     "claude_pane_week": "Week",
     "claude_pane_period": "Period",
     "claude_pane_sessions": "Claude sessions",
+    "claude_pane_session_done": "Done: {title}",
+    "claude_pane_session_waiting": "Waiting for you: {title}",
     "claude_pane_busy": "Busy",
     "claude_pane_waiting": "waiting for you",
+    "claude_pane_unavailable_not_signed_in": "Not signed in · sign in once in its CLI",
+    "claude_pane_unavailable_no_data": "No data yet · shows up after first use",
+    "claude_pane_unavailable_error": "Couldn't read · retrying automatically",
+    "claude_pane_waiting_input": "needs your answer",
+    "claude_pane_waiting_dialog": "dialog open",
+    "claude_pane_waiting_sandbox": "sandbox permission",
+    "claude_pane_waiting_worker": "subagent request",
+    "claude_pane_waiting_goal": "confirm the goal",
+    "claude_pane_waiting_for": "waiting: {reason}",
     "claude_pane_agent_running": "running",
     "claude_pane_agent_idle": "idle",
     "claude_pane_agent_pending": "pending",
@@ -961,6 +988,7 @@
     "claude_pane_invalid_sidecar": "Invalid usage-pane.json",
     "claude_pane_elapsed": "{minutes}m{seconds}s",
     "claude_pane_remaining": "left",
+    "claude_pane_reset_done": "Reset",
     "claude_pane_hours_ago": "{count}h ago"
   },
   "zh-CN": {
@@ -1020,6 +1048,7 @@
     "data_stale_hint": "数据来自备用来源，建议检查设置",
     "status_loading": "加载中",
     "status_synced": "✓ 已同步",
+    "status_refreshing": "↻ 更新中…",
     "status_no_data": "无数据",
     "awaiting_rate_limits": "请对 Claude Code 发送一句消息以同步配额",
     "hook_broken_not_installed": "⚠ 状态栏没有更新，请点「设置状态栏」重新安装",
@@ -1039,6 +1068,7 @@
     "percent_used": "{value}% 已用",
     "reset_in": "重置 {time}",
     "reset_imminent": "即将重置",
+    "reset_done": "已重置",
     "burn_warning": "⚠ 按当前速度 {empty}后用完 · 重置 {reset}",
     "burn_warning_compact": "⚠ {empty}后用完",
     "reset_placeholder": "重置 --",
@@ -1395,8 +1425,19 @@
     "claude_pane_week": "周",
     "claude_pane_period": "期间",
     "claude_pane_sessions": "Claude 对话",
+    "claude_pane_session_done": "完成：{title}",
+    "claude_pane_session_waiting": "在等你：{title}",
     "claude_pane_busy": "忙",
     "claude_pane_waiting": "等你",
+    "claude_pane_unavailable_not_signed_in": "未登录 · 在它的 CLI 登录一次",
+    "claude_pane_unavailable_no_data": "还没有数据 · 用过一次就会出现",
+    "claude_pane_unavailable_error": "读不到 · 会自动重试",
+    "claude_pane_waiting_input": "要你回答",
+    "claude_pane_waiting_dialog": "对话框开着",
+    "claude_pane_waiting_sandbox": "要允许沙盒",
+    "claude_pane_waiting_worker": "子代理请求",
+    "claude_pane_waiting_goal": "确认目标",
+    "claude_pane_waiting_for": "等你：{reason}",
     "claude_pane_agent_running": "运行中",
     "claude_pane_agent_idle": "空闲",
     "claude_pane_agent_pending": "待运行",
@@ -1443,6 +1484,7 @@
     "claude_pane_invalid_sidecar": "usage-pane.json 格式错误",
     "claude_pane_elapsed": "{minutes}分{seconds}秒",
     "claude_pane_remaining": "剩",
+    "claude_pane_reset_done": "已重置",
     "claude_pane_hours_ago": "{count}时前"
   },
   "ja": {
@@ -1502,6 +1544,7 @@
     "data_stale_hint": "データはフォールバック元から取得しています。設定を確認してください。",
     "status_loading": "読み込み中",
     "status_synced": "✓ 同期済み",
+    "status_refreshing": "↻ 更新中…",
     "status_no_data": "データなし",
     "awaiting_rate_limits": "Claude Code にメッセージを送信してクォータを同期してください",
     "hook_broken_not_installed": "⚠ ステータスラインが更新されていません。「ステータスラインを設定」を押して再インストールしてください。",
@@ -1521,6 +1564,7 @@
     "percent_used": "{value}% 使用済み",
     "reset_in": "{time}後にリセット",
     "reset_imminent": "まもなくリセット",
+    "reset_done": "リセット済み",
     "burn_warning": "⚠ このペースで{empty}で使い切り·リセット{reset}",
     "burn_warning_compact": "⚠ {empty}で使い切り",
     "reset_placeholder": "リセット --",
@@ -1877,8 +1921,19 @@
     "claude_pane_week": "週",
     "claude_pane_period": "期間",
     "claude_pane_sessions": "Claude セッション",
+    "claude_pane_session_done": "完了：{title}",
+    "claude_pane_session_waiting": "入力待ち：{title}",
     "claude_pane_busy": "実行中",
     "claude_pane_waiting": "入力待ち",
+    "claude_pane_unavailable_not_signed_in": "未ログイン · CLI で一度ログイン",
+    "claude_pane_unavailable_no_data": "まだデータなし · 一度使うと表示",
+    "claude_pane_unavailable_error": "読み取れません · 自動で再試行",
+    "claude_pane_waiting_input": "回答待ち",
+    "claude_pane_waiting_dialog": "ダイアログ表示中",
+    "claude_pane_waiting_sandbox": "サンドボックス許可",
+    "claude_pane_waiting_worker": "サブエージェント要求",
+    "claude_pane_waiting_goal": "目標の確認",
+    "claude_pane_waiting_for": "入力待ち：{reason}",
     "claude_pane_agent_running": "実行中",
     "claude_pane_agent_idle": "待機中",
     "claude_pane_agent_pending": "実行待ち",
@@ -1925,6 +1980,7 @@
     "claude_pane_invalid_sidecar": "usage-pane.json の形式が不正です",
     "claude_pane_elapsed": "{minutes}分{seconds}秒",
     "claude_pane_remaining": "残り",
+    "claude_pane_reset_done": "リセット済み",
     "claude_pane_hours_ago": "{count}時間前"
   },
   "ko": {
@@ -1984,6 +2040,7 @@
     "data_stale_hint": "데이터가 대체 소스에서 왔습니다. 설정을 확인하세요.",
     "status_loading": "불러오는 중",
     "status_synced": "✓ 동기화됨",
+    "status_refreshing": "↻ 새로 고치는 중…",
     "status_no_data": "데이터 없음",
     "awaiting_rate_limits": "Claude Code에 메시지를 보내 할당량을 동기화하세요",
     "hook_broken_not_installed": "⚠ 상태 표시줄이 업데이트되지 않습니다. \"상태 표시줄 설정\"을 눌러 다시 설치하세요.",
@@ -2003,6 +2060,7 @@
     "percent_used": "{value}% 사용됨",
     "reset_in": "{time} 후 초기화",
     "reset_imminent": "곧 초기화",
+    "reset_done": "리셋됨",
     "burn_warning": "⚠ 현재 속도면 {empty} 후 소진 · 초기화까지 {reset}",
     "burn_warning_compact": "⚠ {empty} 후 소진",
     "reset_placeholder": "초기화까지 --",
@@ -2359,8 +2417,19 @@
     "claude_pane_week": "주간",
     "claude_pane_period": "기간",
     "claude_pane_sessions": "Claude 대화",
+    "claude_pane_session_done": "완료: {title}",
+    "claude_pane_session_waiting": "입력 대기: {title}",
     "claude_pane_busy": "작업 중",
     "claude_pane_waiting": "입력 대기",
+    "claude_pane_unavailable_not_signed_in": "로그인 안 됨 · CLI에서 한 번 로그인",
+    "claude_pane_unavailable_no_data": "아직 데이터 없음 · 한 번 사용하면 표시",
+    "claude_pane_unavailable_error": "읽을 수 없음 · 자동으로 재시도",
+    "claude_pane_waiting_input": "답변 필요",
+    "claude_pane_waiting_dialog": "대화 상자 열림",
+    "claude_pane_waiting_sandbox": "샌드박스 권한",
+    "claude_pane_waiting_worker": "하위 에이전트 요청",
+    "claude_pane_waiting_goal": "목표 확인",
+    "claude_pane_waiting_for": "입력 대기: {reason}",
     "claude_pane_agent_running": "실행 중",
     "claude_pane_agent_idle": "유휴",
     "claude_pane_agent_pending": "실행 대기",
@@ -2407,6 +2476,7 @@
     "claude_pane_invalid_sidecar": "usage-pane.json 형식이 잘못되었습니다",
     "claude_pane_elapsed": "{minutes}분{seconds}초",
     "claude_pane_remaining": "남음",
+    "claude_pane_reset_done": "리셋됨",
     "claude_pane_hours_ago": "{count}시간 전"
   }
 }

{usage_cli-0.32.1 → usage_cli-0.32.3}/menubar/agy.py

@@ -213,20 +213,20 @@ def _remaining_percent(window: AgyQuotaWindow) -> float:
     return max(0.0, min(100.0, float(window.remaining_percent)))
 
 
-def _cache_age_minutes(fetched_at: str, now: float) -> int:
-    """Whole minutes since the cached snapshot was taken (never negative)."""
+def _cache_age_minutes(fetched_at: str, now: float) -> float:
+    """Minutes since the cached snapshot was taken (never negative)."""
     try:
         age_seconds = now - parse_iso8601_utc_or_raise(fetched_at).timestamp()
     except (TypeError, ValueError):
         return 0
-    return max(0, int(age_seconds // 60))
+    return max(0.0, age_seconds / 60)
 
 
 def _window_row(
     title: str,
     window: AgyQuotaWindow,
     language: str,
-    age_minutes: int = 0,
+    age_minutes: float = 0,
     forecast_seconds: float | None = None,
     warning_max_seconds: float | None = None,
     *,
@@ -236,12 +236,20 @@ def _window_row(
     used = 100.0 - remaining
     warning = False
     warning_seconds: float | None = None
-    if remaining == 100.0:
+    reset_done = window.resets_in_minutes is not None and window.resets_in_minutes <= max(
+        0, age_minutes
+    )
+    if reset_done:
+        used = 0.0
+        reset_text = _t(language, "reset_done")
+    elif remaining == 100.0:
         reset_text = _t(language, "agy_quota_full")
     elif window.resets_in_minutes is None:
         reset_text = _t(language, "reset_placeholder")
+    elif window.resets_in_minutes - max(0, age_minutes) < 1:
+        reset_text = _t(language, "reset_imminent")
     else:
-        minutes_left = max(1, window.resets_in_minutes - max(0, age_minutes))
+        minutes_left = window.resets_in_minutes - int(max(0, age_minutes))
         time_to_reset = minutes_left * 60
         if window_seconds is None:
             if (
@@ -275,12 +283,13 @@ def _window_row(
             )
     return QuotaRowState(
         title=title,
-        percent=used,
+        percent=100.0 - remaining,
         percent_text=_t(language, "percent_used", value=_format_percent(used)),
         reset_text=reset_text,
         color=_bar_color(used, AGY_COLOR),
         warning=warning,
         available=True,
+        reset_done=reset_done,
     )
 
 

{usage_cli-0.32.1 → usage_cli-0.32.3}/menubar/app.py

@@ -70,6 +70,7 @@ from loaders.history_loader import (
     flush_caches_on_terminate as flush_history_cache,
 )
 from menubar import actions as menubar_actions
+from menubar import manual_refresh
 from menubar import menu as menubar_menu
 from menubar import notify as menubar_notify
 from menubar import refresh as menubar_refresh
@@ -419,7 +420,7 @@ class AppDelegate(NSObject):
             self._panel_window_did_hide()
 
     def refreshNow_(self, sender: Any) -> None:
-        self._refresh(queue_if_busy=True)
+        manual_refresh.start_mac(self)
 
     def installHook_(self, sender: Any) -> None:
         thread = threading.Thread(target=self._install_hook_in_background, daemon=True)
@@ -822,7 +823,7 @@ class AppDelegate(NSObject):
             codex_model = result.get("codex_model", "unknown")
             self.codex_5h_pct = codex_5h_pct
             self.codex_model = codex_model
-            self.latest_state = state
+            self.latest_state = manual_refresh.finish_mac(self, state)
             self._process_quota_notifications(state)
             if self._panel_window_is_visible():
                 self.popover_controller.setState_(self.latest_state)
@@ -831,8 +832,7 @@ class AppDelegate(NSObject):
             menubar_title._set_button_title(self, state)
         finally:
             should_refresh_again = bool(self._refresh_queued)
-            self._refresh_queued = False
-            self._refresh_in_flight = False
+            self._refresh_queued = self._refresh_in_flight = False
         if should_refresh_again:
             self._refresh()
         if started_at:
@@ -842,7 +842,7 @@ class AppDelegate(NSObject):
             )
 
     def _clearRefreshInFlight_(self, _sender: Any) -> None:
-        self._refresh_in_flight = False
+        manual_refresh.fail_mac(self)
 
     def _load_codex_refresh_result(self) -> dict[str, Any]:
         history_scan = None if self.mock else self._history_source_scan()

{usage_cli-0.32.1 → usage_cli-0.32.3}/menubar/grok.py

@@ -18,9 +18,7 @@ from menubar.state import (
     GROK_COLOR,
     GrokStaleState,
     QuotaRowState,
-    _bar_color,
-    _format_percent,
-    format_human_time,
+    _quota_row,
 )
 from usage_common.time_utils import parse_iso8601_utc_or_raise
 
@@ -56,22 +54,15 @@ def project_quota(
         period_end = parse_iso8601_utc_or_raise(quota.period_end).timestamp()
     except (TypeError, ValueError):
         return None
-    if period_end < current_time:
-        return None
     stale = _stale_state(quota.fetched_at, current_time, language)
-    used = max(0.0, min(100.0, quota.used_percent))
     return GrokQuotaProjection(
-        weekly=QuotaRowState(
-            title=_t(language, "weekly_label"),
-            percent=used,
-            percent_text=_t(language, "percent_used", value=_format_percent(used)),
-            reset_text=_t(
-                language,
-                "reset_in",
-                time=format_human_time(max(0.0, period_end - current_time), language),
-            ),
-            color=_bar_color(used, GROK_COLOR),
-            available=True,
+        weekly=_quota_row(
+            _t(language, "weekly_label"),
+            quota.used_percent,
+            period_end,
+            current_time,
+            GROK_COLOR,
+            language,
         ),
         stale=stale,
     )

usage_cli-0.32.3/menubar/manual_refresh.py

@@ -0,0 +1,51 @@
+"""Status-chip feedback for user-requested refreshes."""
+
+from __future__ import annotations
+
+from typing import Any
+
+from i18n import _t
+from menubar.state import PopoverState
+
+
+def begin(state: PopoverState, *, queued: bool = False) -> None:
+    if state.refresh_status is None:
+        state.refresh_status = (state.status_text, state.status_long)
+    state.refresh_queued = state.refresh_queued or queued
+    state.status_text = _t(
+        state.language, "status_text", value=_t(state.language, "status_refreshing")
+    )
+    state.status_long = False
+
+
+def finish(
+    previous: PopoverState | None, state: PopoverState, *, queued: bool = False
+) -> PopoverState:
+    if previous is not None and previous.refresh_status is not None:
+        keep = previous.refresh_queued and queued
+        previous.status_text, previous.status_long = previous.refresh_status
+        previous.refresh_status = None
+        previous.refresh_queued = False
+        if keep:
+            begin(state)
+    return state
+
+
+def finish_mac(app: Any, state: PopoverState) -> PopoverState:
+    return finish(app.latest_state, state, queued=bool(app._refresh_queued))
+
+
+def start_mac(app: Any) -> None:
+    begin(app.latest_state, queued=bool(app._refresh_in_flight))
+    app._refresh(queue_if_busy=True)
+    if app._panel_window_is_visible():
+        app.popover_controller.setState_(app.latest_state)
+
+
+def fail_mac(app: Any) -> None:
+    state = getattr(app, "latest_state", None)
+    if state is not None:
+        finish(state, state)
+    app._refresh_in_flight = False
+    if state is not None and app._panel_window_is_visible():
+        app.popover_controller.setState_(state)

{usage_cli-0.32.1 → usage_cli-0.32.3}/menubar/state.py

@@ -99,6 +99,13 @@ class QuotaRowState:
     warning: bool = False
     available: bool = True
     reset_text_compact: str = ""
+    reset_done: bool = False
+
+    # Keep percent unchanged for quota notifications; renderers use display_percent.
+
+    @property
+    def display_percent(self) -> float | None:
+        return 0.0 if self.reset_done else self.percent
 
 
 class CodexStaleState(TypedDict):
@@ -156,6 +163,8 @@ class PopoverState:
     grok_stale: GrokStaleState | None = None
     card_order: tuple[str, ...] = ("claude", "codex", "agy", "grok")
     history_error: HistoryLoadErrorState | None = None
+    refresh_status: tuple[str, bool] | None = None
+    refresh_queued: bool = False
 
 
 @dataclass(frozen=True, slots=True)
@@ -970,7 +979,10 @@ def _quota_row(
     pct = max(0.0, min(100.0, float(pct)))
     time_to_reset = resets_at - now
     warning_seconds: float | None = None
-    if time_to_reset < 60:
+    if time_to_reset <= 0:
+        reset_text = _t(language, "reset_done")
+        warning = False
+    elif time_to_reset < 60:
         reset_text = _t(language, "reset_imminent")
         warning = False
     else:
@@ -1007,11 +1019,14 @@ def _quota_row(
     row = QuotaRowState(
         title=title,
         percent=pct,
-        percent_text=_t(language, "percent_used", value=_format_percent(pct)),
+        percent_text=_t(
+            language, "percent_used", value=_format_percent(0.0 if time_to_reset <= 0 else pct)
+        ),
         reset_text=reset_text,
-        color=_bar_color(pct, color),
+        color=_bar_color(0.0 if time_to_reset <= 0 else pct, color),
         warning=warning,
         available=True,
+        reset_done=time_to_reset <= 0,
     )
     if warning_seconds is not None:
         row.reset_text_compact = _t(

{usage_cli-0.32.1 → usage_cli-0.32.3}/menubar/title.py

@@ -66,20 +66,22 @@ def _menubar_attributed_title(app: _TitleApp, state: PopoverState) -> Any:
     if not state.hide_claude:
         claude_percent = (
             "--"
-            if state.claude_session.percent is None
-            else f"{_format_percent(state.claude_session.percent)}%"
+            if state.claude_session.display_percent is None
+            else f"{_format_percent(state.claude_session.display_percent)}%"
         )
         title.appendAttributedString_(_menubar_icon_attachment_string(_claude_menubar_icon()))
         title.appendAttributedString_(_menubar_text_string(app, f" {claude_percent}"))
     if not state.hide_codex and (app.codex_5h_pct is not None or state.hide_claude):
-        codex_percent = (
-            "--" if app.codex_5h_pct is None else f"{_format_percent(float(app.codex_5h_pct))}%"
+        codex_row = (
+            state.codex_session if state.codex_session.percent is not None else state.codex_weekly
         )
+        codex_used = 0.0 if codex_row.reset_done else app.codex_5h_pct
+        codex_percent = "--" if codex_used is None else f"{_format_percent(float(codex_used))}%"
         if not state.hide_claude:
             title.appendAttributedString_(_menubar_text_string(app, "  "))
         title.appendAttributedString_(_menubar_icon_attachment_string(_codex_menubar_icon()))
         title.appendAttributedString_(_menubar_text_string(app, f" {codex_percent}"))
-    agy_session_percent = state.agy_session.percent
+    agy_session_percent = state.agy_session.display_percent
     agy_visible = not state.hide_agy and agy_session_percent is not None
     if agy_visible:
         assert agy_session_percent is not None
@@ -88,7 +90,7 @@ def _menubar_attributed_title(app: _TitleApp, state: PopoverState) -> Any:
             title.appendAttributedString_(_menubar_text_string(app, "  "))
         title.appendAttributedString_(_menubar_icon_attachment_string(_agy_menubar_icon()))
         title.appendAttributedString_(_menubar_text_string(app, f" {agy_percent}"))
-    grok_weekly_percent = state.grok_weekly.percent
+    grok_weekly_percent = state.grok_weekly.display_percent
     grok_visible = not state.hide_grok and grok_weekly_percent is not None
     if grok_visible:
         assert grok_weekly_percent is not None
@@ -123,18 +125,22 @@ def _compose_title(app: _TitleApp, state: PopoverState) -> str:
     if not state.hide_claude:
         claude = (
             "--"
-            if state.claude_session.percent is None
-            else f"{_format_percent(state.claude_session.percent)}%"
+            if state.claude_session.display_percent is None
+            else f"{_format_percent(state.claude_session.display_percent)}%"
         )
         parts.append(claude)
     if not state.hide_codex and (app.codex_5h_pct is not None or state.hide_claude):
-        codex = "--" if app.codex_5h_pct is None else f"{_format_percent(float(app.codex_5h_pct))}%"
+        codex_row = (
+            state.codex_session if state.codex_session.percent is not None else state.codex_weekly
+        )
+        codex_used = 0.0 if codex_row.reset_done else app.codex_5h_pct
+        codex = "--" if codex_used is None else f"{_format_percent(float(codex_used))}%"
         parts.append(codex)
-    if not state.hide_agy and state.agy_session.percent is not None:
-        agy = f"{_format_percent(state.agy_session.percent)}%"
+    if not state.hide_agy and state.agy_session.display_percent is not None:
+        agy = f"{_format_percent(state.agy_session.display_percent)}%"
         parts.append(agy)
-    if not state.hide_grok and state.grok_weekly.percent is not None:
-        grok = f"{_format_percent(state.grok_weekly.percent)}%"
+    if not state.hide_grok and state.grok_weekly.display_percent is not None:
+        grok = f"{_format_percent(state.grok_weekly.display_percent)}%"
         parts.append(grok)
     # Both providers hidden: keep a recognizable, clickable status item.
     return " · ".join(parts) if parts else "usage"

{usage_cli-0.32.1 → usage_cli-0.32.3}/panels/payload.py

@@ -91,7 +91,7 @@ def _data_uri(asset_name: str) -> str:
 
 def _row_payload(row: QuotaRowState) -> dict[str, object]:
     return {
-        "percent": row.percent,
+        "percent": row.display_percent,
         "percentText": row.percent_text,
         "resetText": row.reset_text,
         "resetTextCompact": row.reset_text_compact or row.reset_text,

{usage_cli-0.32.1 → usage_cli-0.32.3}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "usage-cli"
-version = "0.32.1"
+version = "0.32.3"
 description = "usage — 在 macOS menu bar 與 Windows 系統匣顯示 Claude Code、Codex、Antigravity 用量的小工具（也提供終端機 TUI）"
 readme = "README.md"
 requires-python = ">=3.13"

usage_cli-0.32.3/tests/test_manual_refresh.py

@@ -0,0 +1,62 @@
+from types import SimpleNamespace
+
+import pytest
+
+from i18n import _t
+from menubar import manual_refresh
+from menubar.state import _empty_state
+
+
+@pytest.mark.parametrize("normal", ["status_synced", "data_stale_hint", "status_no_data"])
+def test_manual_refresh_restores_new_status(normal: str) -> None:
+    previous = _empty_state()
+    manual_refresh.begin(previous)
+    assert previous.status_text == "Status: ↻ Refreshing…"
+    assert previous.status_long is False
+    state = _empty_state()
+    state.status_text = _t("en", "status_text", value=_t("en", normal))
+    state.status_long = True
+    assert manual_refresh.finish(previous, state) is state
+    assert state.status_text == _t("en", "status_text", value=_t("en", normal))
+    assert state.status_long is True
+    assert state.refresh_status is None
+
+
+def test_auto_refresh_never_changes_status() -> None:
+    previous, state = _empty_state(), _empty_state()
+    expected = state.status_text
+    manual_refresh.finish(previous, state, queued=True)
+    assert state.status_text == expected
+    assert state.refresh_status is None
+
+
+def test_manual_refresh_queued_behind_auto_waits_for_its_result() -> None:
+    previous = _empty_state()
+    manual_refresh.begin(previous, queued=True)
+    state = manual_refresh.finish(previous, _empty_state(), queued=True)
+    assert state.status_text == "Status: ↻ Refreshing…"
+    result = manual_refresh.finish(state, _empty_state())
+    assert result.status_text == _empty_state().status_text
+    assert result.refresh_status is None
+
+
+def test_mac_manual_refresh_pushes_status_and_failure_restores_it() -> None:
+    state = _empty_state()
+    expected = state.status_text
+    pushed: list[str] = []
+    calls: list[bool] = []
+    app = SimpleNamespace(
+        latest_state=state,
+        _refresh_in_flight=False,
+        _refresh=lambda *, queue_if_busy: calls.append(queue_if_busy),
+        _panel_window_is_visible=lambda: True,
+        popover_controller=SimpleNamespace(
+            setState_=lambda state: pushed.append(state.status_text)
+        ),
+    )
+    manual_refresh.start_mac(app)
+    assert calls == [True]
+    assert pushed == ["Status: ↻ Refreshing…"]
+    manual_refresh.fail_mac(app)
+    assert pushed == ["Status: ↻ Refreshing…", expected]
+    assert app._refresh_in_flight is False