@tsa-group/claude-usage 0.4.2 → 0.4.4

package/dist/doctor.js

@@ -186,6 +186,20 @@ export async function doctor() {
             : ok(`採集狀態正常（上次成功 ${h.last_ok_at ?? "-"}）`));
         if (h.last_error)
             out.push(`         上次錯誤: ${h.last_error}`);
+        if (warn) {
+            // ★ 這行以前漏了：畫面印 [BAD] 但結論說「沒有發現問題」。
+            // 一個會自相矛盾的診斷工具，比沒有診斷工具更糟 —— 使用者會學會忽略它。
+            if (credOk) {
+                // 憑證「現在」讀得到，health 卻說壞掉 —— 那是**背景任務**的環境或版本
+                // 與這裡不同，不是憑證問題。這個分辨很重要：兩者的處置完全不同。
+                problems.push(`憑證現在讀得到，但背景任務回報失敗（${warn}）。代表背景任務跑的環境或版本` +
+                    `與你現在這個不同 —— 重跑 claude-usage install 讓它指到目前的版本；` +
+                    `Windows 可用 schtasks /Query /TN ClaudeUsage /V /FO LIST 看它實際執行什麼`);
+            }
+            else {
+                problems.push(`採集失敗：${warn}`);
+            }
+        }
     }
     else {
         out.push(info("尚無 health 紀錄（背景任務還沒跑過）"));

package/dist/health.js

@@ -22,6 +22,8 @@ export const STATUS_BY_CODE = {
 /** 連續失敗幾次 / 幾小時沒成功，就算不健康 */
 export const WARN_FAILURES = 3;
 export const WARN_STALE_HOURS = 6;
+/** 最近這麼多分鐘內成功過，就視為「現在是好的」，蓋過失敗計數器（見 healthWarning） */
+export const RECENT_OK_MIN = 45;
 /** usage_snapshots.jsonl 的最後一行（本機最新一筆快照） */
 export function lastSnapshot() {
     const p = snapPath();
@@ -77,11 +79,17 @@ export function saveHealth(h) {
  * 不會再推一次。
  */
 export function healthWarning(h) {
+    const ok = parseIso(h.last_ok_at);
+    const okMinAgo = ok ? (Date.now() - ok.getTime()) / 60_000 : Infinity;
     const cf = h.consecutive_failures ?? 0;
-    if (cf >= WARN_FAILURES) {
+    // ★ 近期成功過就不看失敗計數器。「現在有沒有在運作」最可靠的答案是「最近有沒有
+    // 成功過」，而不是一個可能卡住的計數器 —— 實測（Molly, 0.4.3）出現過快照確實
+    // 每 15 分鐘進來、consecutive_failures 卻停在 152 的矛盾狀態：多個 tick 行程
+    // 同時 read-modify-write health.json 就會互相蓋掉，計數器因此永遠歸不了零。
+    // 那種情況下報「連續 152 次失敗」是錯的，而且會讓人去修一個沒有壞的東西。
+    if (cf >= WARN_FAILURES && okMinAgo > RECENT_OK_MIN) {
         return `連續 ${cf} 次採樣失敗 (${h.last_sample_status}) 自 ${h.first_failure_at}`;
     }
-    const ok = parseIso(h.last_ok_at);
     if (ok) {
         const hrs = (Date.now() - ok.getTime()) / 3_600_000;
         if (hrs >= WARN_STALE_HOURS) {

package/dist/install.js

@@ -119,7 +119,9 @@ function winInstall() {
         console.error(`  手動執行這行可看到正確訊息: schtasks ${args.map((a) => (a.includes(" ") ? `"${a}"` : a)).join(" ")}`);
     }
     console.log(`uninstall: schtasks /Delete /TN ${WIN_TASK} /F`);
-    console.log("! Windows 路徑尚未在真機完整驗證 —— 裝完請跑 claude-usage status 確認有心跳");
+    console.log("! 憑證與採樣已於 2026-08-28 在 Windows 實機驗證通過（含桌面版加密憑證庫）。\n" +
+        "  尚未完整驗證的是背景任務本身（schtasks + VBS 隱藏視窗）——\n" +
+        "  裝完請跑 claude-usage status 確認有心跳。");
     return r.status ?? 1;
 }
 function winUninstall() {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tsa-group/claude-usage",
-  "version": "0.4.2",
+  "version": "0.4.4",
   "description": "Per-user Claude usage collector — measures Claude Code token detail and account-level rate-limit utilization locally, reports to your own ingest server.",
   "type": "module",
   "bin": {