sync: collector/ 同步自 inkstone/arcrun-rag@d129f8b（桌面小幫手 0.18.48）

cmd/arcrun-app/folder_badge.go

@@ -0,0 +1,82 @@
+// folder_badge.go — 資料夾那一列的**同步狀態圖示**（`inkstone/arcrun-rag#159`）。
+//
+// leo 2026-08-28 原話：
+//
+//	「補送中是什麼意思？**不要發明奇怪狀態**⋯⋯他要知道的是『**我的資料夾是否同步了**』，
+//	 **有同步打勾就好**」
+//	「產生 GUI 就是要讓人減少讀字降低負擔，你在 GUI 寫這麼多字剛好違背它的原理」
+//
+// ── 這支檔存在的理由 ─────────────────────────────────────────────────────
+// 在這之前，那一列的標籤是這樣算的（frontend/src/main.js:545）：
+//
+//	<span class="tag">${f.resyncNote ? '補送中' : '自動同步中'}</span>
+//
+// 也就是說它量的**不是同步狀態**，是「#140 那句補送說明是不是空字串」。
+// 於是 2026-08-28 leo 的畫面上七列有六列寫「補送中」——連 `youlinhsieh-test1`
+// （實測 `pending=0`、`repaired=2`，補送早就做完了）也照樣標補送中。
+// ⇒ **標籤跟事實脫鉤**，而不是措辭不好聽。
+//
+// 現在改成從 `collector.SyncProgress` 算——那是 `(*Manifest).Progress()` 的原件，
+// 與首頁大數字、診斷檔用的是同一個函式。**畫面上打的勾，跟首頁的數字同源。**
+//
+// ── 三種狀態，沒有第四種 ─────────────────────────────────────────────────
+//
+//	✅ ok       Done == Total     每一份我認得的檔都送進知識庫了，而且送上去之後沒再改過
+//	🔄 working  還沒送完，但沒有出錯的跡象
+//	⚠️ trouble  已經放棄自動重試（Stuck），或**一份都還沒成功而且每一份都失敗過**
+//
+// 🔴 第三種的第二個條件是 leo 那句「Geek6688 很久沒碰了也顯示補送中？」逼出來的。
+// 實查他機器上的 manifest（2026-08-28）：`geek6688-test1` 的 14 份**每一份的
+// fail_count 都大於 0**（7 與 3），錯誤是雲端回 `HTTP 500 Node post_block failed:
+// Too many subrequests`，`done=0`。
+// ⇒ 這不是「排隊中」，是「一直在撞牆」。標成同步中＝叫他等一件正在壞掉的事。
+// ⇒ 但**單看「有檔案在重試」不夠**：`pms` 有 110 份待處理、其中只有 4 份在重試、
+// 已經送成功 23 份——那是健康的積壓，標警告就變成新的噪音（實測 9 個資料夾裡
+// 會有 7 個亮警告，等於回到 leo 抱怨的「滿畫面都是狀態」）。
+// **所以第二個條件要求 `Done == 0`：一份都沒成功、而且全都在失敗，才叫撞牆。**
+//
+// 🔴 剛加進來、還沒開始送的資料夾（Failing == 0）落在 working，不會誤報警告。
+package main
+
+import (
+	"fmt"
+
+	collector "arcrun-rag/collector"
+)
+
+// 資料夾狀態的機器代碼。前端只認這三個字串，圖示與顏色由 CSS 決定
+// ——狀態名不進畫面，畫面上只有一個圖示（GUI 的目的是讓人少讀字）。
+const (
+	folderSyncOK      = "ok"
+	folderSyncWorking = "working"
+	folderSyncTrouble = "trouble"
+	// folderSyncUnknown＝collector 還沒回報過這個資料夾（剛加進來、第一輪還沒跑完）。
+	// **不能落到 ok**——那會是「還沒查就打勾」，正是這張票的紅線。
+	folderSyncUnknown = "unknown"
+)
+
+// folderBadge 把一個資料夾的同步現況翻成「一個狀態代碼＋一句短提示」。
+//
+// known＝status.json 裡有沒有這個資料夾的紀錄。沒有就是 unknown，不猜。
+//
+// 提示句刻意短：它住在 tooltip 裡，而 leo 的紅線是「**不要把長句子搬進 tooltip
+// 裡繼續長**」。要看細節的人有診斷檔（疑難排解那張卡），不是靠這一行。
+func folderBadge(p collector.SyncProgress, known bool) (state, tip string) {
+	if !known {
+		return folderSyncUnknown, "還在確認這個資料夾"
+	}
+	switch {
+	case p.Total == 0:
+		// 資料夾是空的、或裡面沒有我讀得了的檔。**不是「同步好了」**，
+		// 所以不打勾——打勾要對應「東西真的在知識庫裡」。
+		return folderSyncUnknown, "還沒有可整理的檔案"
+	case p.Done == p.Total:
+		return folderSyncOK, fmt.Sprintf("已同步 · %d 份", p.Done)
+	case p.Stuck > 0:
+		return folderSyncTrouble, fmt.Sprintf("%d 份一直送不上去", p.Stuck)
+	case p.Done == 0 && p.Failing > 0:
+		return folderSyncTrouble, fmt.Sprintf("%d 份都還沒送成功", p.Failing)
+	default:
+		return folderSyncWorking, fmt.Sprintf("同步中 · 還有 %d 份", p.Total-p.Done)
+	}
+}