@tsa-group/claude-usage 0.4.3 → 0.4.5

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() {
@@ -128,19 +130,43 @@ function winUninstall() {
         rmSync(VBS_PATH());
     return 0;
 }
+/** schtasks 的 LastTaskResult。0 以外的值多半代表背景任務其實沒跑成功。 */
+const TASK_RESULT = {
+    0: "上次執行成功",
+    267011: "尚未執行過",
+    267009: "正在執行中",
+    267014: "上次被中止",
+};
 function winStatus() {
-    // 同 winInstall：不設 encoding。Windows 主控台是本地碼頁（繁中 CP950），用 utf8
-    // 解碼會把整段表格變成亂碼，而使用者要看的只是「這個工作在不在、下次何時跑」。
-    const r = spawnSync("schtasks", ["/Query", "/TN", WIN_TASK]);
-    if (r.status !== 0) {
-        console.log("bg-task:   NOT installed (schtasks)");
-        return r.status ?? 1;
+    // ★ 不要印 schtasks 的原始輸出：它走**主控台代碼頁**（繁中是 CP950），而 Node 只會
+    // 用 utf8/latin1 解，中文必定變亂碼（實測「下午 03:45 就緒」印成 `¤U¤È 03:45 ´N°ü`）。
+    // 先前的版本用正則挑日期迴避，但仍會連帶吃到後面的本地化文字。
+    // 改走 PowerShell 的 ScheduledTasks cmdlet，**自己指定 ASCII 安全的輸出格式** ——
+    // 順便拿到 LastTaskResult，那正是「背景任務上次到底有沒有跑成功」的直接答案，
+    // 而那是 schtasks 表格裡最該看、卻最容易被亂碼蓋掉的一欄。
+    const cmd = `$ErrorActionPreference='SilentlyContinue';` +
+        `$t=Get-ScheduledTask -TaskName '${WIN_TASK}';` +
+        `if(-not $t){'MISSING'}else{` +
+        `$i=Get-ScheduledTaskInfo -TaskName '${WIN_TASK}';` +
+        `$last=if($i.LastRunTime){$i.LastRunTime.ToString('yyyy-MM-dd HH:mm')}else{'-'};` +
+        `$next=if($i.NextRunTime){$i.NextRunTime.ToString('yyyy-MM-dd HH:mm')}else{'-'};` +
+        `"$($t.State)|$($i.LastTaskResult)|$last|$next"}`;
+    const r = spawnSync("powershell.exe", ["-NoProfile", "-NonInteractive", "-ExecutionPolicy", "Bypass", "-Command", cmd], { encoding: "utf8", timeout: 15_000, windowsHide: true });
+    const line = (r.stdout ?? "").trim();
+    if (r.status !== 0 || !line || line === "MISSING") {
+        console.log(`bg-task:   NOT installed —— 跑 claude-usage install 重新註冊`);
+        return 1;
+    }
+    const [state, resultRaw, last, next] = line.split("|");
+    const result = Number(resultRaw);
+    const meaning = TASK_RESULT[result] ?? `結束碼 ${resultRaw}`;
+    console.log(`bg-task:   已註冊 "${WIN_TASK}"  狀態=${state}  上次=${last}  下次=${next}`);
+    console.log(`           ${meaning}`);
+    // 只有「成功」與「還沒跑過」算正常；其餘代表背景任務其實沒在做事。
+    if (result !== 0 && result !== 267011 && result !== 267009) {
+        console.log(`           ! 背景任務上次沒有正常結束 —— 細節: schtasks /Query /TN ${WIN_TASK} /V /FO LIST`);
+        return 1;
     }
-    // 只挑出下次執行時間那一段數字/日期，避開會亂碼的本地化欄位標題
-    const raw = (r.stdout ?? Buffer.alloc(0)).toString("latin1");
-    const when = raw.match(/\d{4}[/-]\d{1,2}[/-]\d{1,2}[^\r\n]*/)?.[0]?.trim();
-    console.log(`bg-task:   已註冊 "${WIN_TASK}"${when ? `，下次執行 ${when}` : ""}`);
-    console.log(`           完整資訊: schtasks /Query /TN ${WIN_TASK} /V /FO LIST`);
     return 0;
 }
 const sessionStartGroups = (s) => s.hooks?.SessionStart ?? [];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tsa-group/claude-usage",
-  "version": "0.4.3",
+  "version": "0.4.5",
   "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": {