+
+
${esc(f.path)}
- ${f.resyncNote ? '補送中' : '自動同步中'}
-
-
+ ${SYNC_ICON[f.sync] || SYNC_ICON.unknown}
+
-
- ${f.resyncNote ? `
${esc(f.resyncNote)}
` : ''}`).join('')
+
`).join('')
|| `
這個知識庫還沒有資料夾
按右上的「加入資料夾」，選一個要自動整理的資料夾。
`}`;
}
diff --git a/cmd/arcrun-app/frontend/src/style.css b/cmd/arcrun-app/frontend/src/style.css
index 4825047..e77086c 100644
--- a/cmd/arcrun-app/frontend/src/style.css
+++ b/cmd/arcrun-app/frontend/src/style.css
@@ -144,6 +144,41 @@ button.ghost:hover { color: var(--err); background: transparent; }
.folder .tag.retiring { color: rgba(var(--ink-rgb), .5); }
.folder-note { margin: -3px 0 9px; padding: 0 15px; font-size: 12.5px; }
+/* ══ arcrun-rag#159：那一列只剩「三角形 ＋ 路徑 ＋ 兩個圖示」══════════════
+ leo 2026-08-28：「補送中、資料夾結構、移除，**變成 3 個 emoticon 就好，
+ 畫面上都是字壓力很大**」「**展開三角形按鈕放資料夾上**」
+ ⇒ 三角形移到列首（跟樹裡面的展開鈕同一個造型，使用者只要學一次）。 */
+.folder > .tw {
+ flex: none; width: 22px; height: 22px; padding: 0; border: none; background: none;
+ display: inline-flex; align-items: center; justify-content: center;
+}
+.folder > .tw:hover { background: none; }
+/* 三角形用 CSS 畫，不用 ▸▾ 字元——理由同樹裡那顆（見 .ftrow .tw i）：
+ 那兩個字在 Windows 的中文字型裡是全形，大小與位置每台機器都不一樣。 */
+.folder > .tw i {
+ display: block; width: 0; height: 0;
+ border-left: 6px solid rgba(var(--ink-rgb), .5);
+ border-top: 5px solid transparent; border-bottom: 5px solid transparent;
+ transition: transform .12s;
+}
+.folder.open > .tw i { transform: rotate(90deg); }
+.folder > .tw:hover i { border-left-color: var(--amber); }
+/* 狀態圖示。**一個字都沒有**——說明住在 title/aria-label 裡，滑過去才出現。 */
+.folder .fstat { flex: none; font-size: 14px; line-height: 1; cursor: default; }
+/* 🔴 視覺層級要對得上意思：**只有需要你出手的那一格才准大聲**。
+ 「同步中」是常態、不需要任何人做什麼 ⇒ 壓到跟灰階一樣安靜；
+ ⚠️ 維持原色，因為它是唯一一個「你可能要看一下」的狀態。
+ （不壓的話 🔄 的藍色會比 ⚠️ 還跳，畫面就在對使用者喊錯的東西。） */
+.folder .fstat.working { filter: grayscale(.85); opacity: .5; }
+/* 還沒回報過的那一格刻意做得很淡：它不是「沒問題」，是「還不知道」。 */
+.folder .fstat.unknown { color: rgba(var(--ink-rgb), .3); font-size: 12px; }
+/* 圖示按鈕（移除）：跟三角形同一個量級，hover 才變紅——不預設嚷嚷。 */
+.folder .ico {
+ flex: none; padding: 4px 6px; border: none; background: none;
+ font-size: 14px; line-height: 1; filter: grayscale(1); opacity: .7;
+}
+.folder .ico:hover { background: none; filter: none; opacity: 1; }
+
.big-num { font-size: 26px; font-weight: 600; letter-spacing: .01em; }
.kv { display: flex; gap: 26px; margin-top: 4px; }
.kv .k { font-size: 12.5px; color: rgba(var(--ink-rgb), .45); }
@@ -299,6 +334,14 @@ input[type=text], input[type=password] {
.kbrow .nm { font-size: 14px; font-weight: 600; flex: none; }
.kbrow .right { display: flex; align-items: center; gap: 10px; font-size: 13px; }
.kbver { margin-bottom: 14px; font-size: 13.5px; display: flex; align-items: center; gap: 10px; }
+/* arcrun-rag#159：版本那一格只有**數字與圖示**，說明收進 title。
+ 等寬字讓 `1.4.46 → 1.4.58` 這種對照掃視時對得齊。 */
+.kbv { font-family: ui-monospace, Menlo, monospace; font-size: 12.5px; color: rgba(var(--ink-rgb), .7); }
+/* 這一輪連不上 ⇒ 版本號調淡表示「這是上次查到的」。**不是把它抹掉**——
+ 版本查到過就是事實，抽風的是網路（見 collector/direct.go #159 那段）。 */
+.kbv.dim { opacity: .45; }
+/* 從來沒查到過：一個很淡的圈，跟資料夾那一列的 unknown 同一個語彙。 */
+.kbv.unknown { font-family: inherit; color: rgba(var(--ink-rgb), .3); }
.warn { color: var(--err); font-size: 13px; }
#side .nav .dot.warn {
width: 7px; height: 7px; border-radius: 50%; flex: none;
@@ -432,12 +475,10 @@ input[type=text], input[type=password] {
margin: -3px 0 9px; padding: 8px 10px 6px;
background: var(--well); border-radius: 10px;
}
-.fthead {
- display: flex; align-items: center; gap: 8px; flex-wrap: wrap;
- padding-bottom: 7px; margin-bottom: 5px;
- border-bottom: 1px solid rgba(var(--ink-rgb), .08);
-}
-.fthead button { padding: 4px 9px; font-size: 12px; }
+/* 🔴 arcrun-rag#159：`.fthead`（全部展開／全部收合＋收檔策略那句話）**整條移除**。
+ leo 2026-08-28 在截圖上圈掉它：「上下廢話刪除，只留乾淨 Tree」
+ 「產生 GUI 就是要讓人減少讀字降低負擔，你在 GUI 寫這麼多字剛好違背它的原理」。
+ 收檔策略那句話沒有被刪掉——它改掛在根那一列的數字上，點一下就看得到。 */
/* 樹本體：檔案總管那種「緊湊但點得到」的密度。
overflow-x 讓很深的樹自己捲，不去撐破右側版面。 */
.ftbody { overflow-x: auto; padding: 1px 0; }
@@ -474,6 +515,19 @@ input[type=text], input[type=password] {
}
/* 全部同步完＝這一格沒有待辦，用完整墨色讓它從灰階裡浮出來（不另發明「成功色」）。 */
.ftrow .num.full { color: var(--ink); }
+/* #159：這一列有「為什麼」可以看時，數字自己就是那顆按鈕（畫面上不多一個字、
+ 也不多一顆按鈕）。虛線底線是唯一的提示——**它不是裝飾，是可點的告示**。 */
+.ftrow .num.hasWhy {
+ cursor: pointer;
+ border-bottom: 1px dotted rgba(var(--ink-rgb), .35);
+}
+.ftrow .num.hasWhy:hover { color: var(--ink); border-bottom-color: var(--amber); }
+.ftrow .num.hasWhy:focus-visible { outline: 2px solid var(--amber); outline-offset: 1px; }
+/* 點開之後那一行理由。預設不存在——這就是「收起來不等於刪掉」的落點。 */
+.ftwhy {
+ font-size: 12px; line-height: 1.6; padding: 1px 4px 4px;
+ color: rgba(var(--ink-rgb), .55); white-space: normal; max-width: 46em;
+}
/* 🔴 選擇器**不要**綁在 .ftrow 底下：頁首那句「為什麼只收這些」也用同一個 class，
綁死就只有樹裡面吃得到樣式、頁首那句會掉回 16px 的內文級——實撞過一次，
畫面上那句話比整棵樹都大聲，喧賓奪主。 */
@@ -484,12 +538,6 @@ input[type=text], input[type=password] {
font-size: 12px; color: rgba(var(--ink-rgb), .45);
flex: 0 1 auto; min-width: 0; overflow: hidden; text-overflow: ellipsis;
}
-.fthead .why { flex: 1; min-width: 0; line-height: 1.6; }
-/* 整棵沒走進去：語氣是告知不是錯誤，所以不用 --err。 */
-.ftrow .skip {
- font-size: 11.5px; color: rgba(var(--ink-rgb), .5);
- border: 1px solid rgba(var(--ink-rgb), .18); border-radius: 5px; padding: 0 5px;
-}
.ftmsg {
padding: 6px 2px 2px; font-size: 12px; line-height: 1.65;
color: rgba(var(--ink-rgb), .45);
diff --git a/direct.go b/direct.go
index 5ca23c1..ed3b240 100644
--- a/direct.go
+++ b/direct.go
@@ -742,6 +742,10 @@ func RunDirectOnce(cfg *DirectConfig, dryRun bool) ([]DirectResult, int, *Trigge
folderTrees := map[string]FolderTree{}
var knownRoots []string
+ // `inkstone/arcrun-rag#159`：每個看守資料夾這一輪的同步現況（key＝資料夾路徑）。
+ // 值是 (*Manifest).Progress() 的原件——與 totalProgress 同一個來源，只是沒有累加。
+ folderProgress := map[string]SyncProgress{}
+
// t210：跨帳號、跨資料夾累加的總量進度（見 rootProgress 註解）。
var totalProgress SyncProgress
var stuckReasons []string
@@ -768,8 +772,28 @@ func RunDirectOnce(cfg *DirectConfig, dryRun bool) ([]DirectResult, int, *Trigge
// t103：per-account 雲端版本偵測
cloudVer, cloudOK := fetchCloudVersion(accCfg.CypherURL)
+ // 🔴 `inkstone/arcrun-rag#159`：**一次探測失敗 ≠ 這台知識庫連不上。**
+ //
+ // leo 2026-08-28 的畫面上，`youlin.hsieh.dev` 那行紅字寫「目前連不上這個
+ // 知識庫，查不到版本」——而同一台機器上 curl 打同一支 /health 是 HTTP 200
+ // 亞秒回應。實查當下 status.json：**三個帳號全部** `cloud_check_ok=false`、
+ // 錯誤都是 `dial tcp: ... no such host`，而剛開的 Go 行程（cgo 與純 Go
+ // 兩種 resolver 都試過）解得出來、GET 也 200。
+ // ⇒ 那是這台機器當下的 DNS 抽風，不是知識庫掛了。
+ //
+ // 舊寫法把「這一輪沒查到」直接呈現成「查不到版本」，於是**一次抽風就抹掉
+ // 我們早就知道的事實**。改成：查不到就沿用上一輪查到的版本
+ //（同 CarryForwardActivity 的理由），只有**從來沒查到過**才是真的不知道。
+ // CloudCheckOK 仍照實記這一輪的可達性——那是另一件事，不混在一起。
+ if strings.TrimSpace(cloudVer) == "" {
+ if prevAcc, ok := prevStatus.AccountDetails[accHost]; ok {
+ cloudVer = prevAcc.CloudVersion
+ }
+ }
// t215：這個帳號要不要更新——與 portal 版本卡同一套判準（見檔頭）。
- cloudUpd := EvalCloudUpdate(cloudVer, cloudOK, latestRelease, latestOK)
+ // 第二個參數傳「我們知不知道它的版本」而不是「這一輪連不連得上」：
+ // 版本是**事實**，可達性是**當下狀態**，兩者不是同一個問題。
+ cloudUpd := EvalCloudUpdate(cloudVer, strings.TrimSpace(cloudVer) != "", latestRelease, latestOK)
accSt := AccountSyncStatus{
LastSync: time.Now().Format(time.RFC3339),
CloudVersion: cloudVer,
@@ -861,6 +885,10 @@ func RunDirectOnce(cfg *DirectConfig, dryRun bool) ([]DirectResult, int, *Trigge
skippedOtherNames = append(skippedOtherNames, p.SkippedOtherNames...)
// #104：這一根用了什麼策略、少收了什麼 —— 以前到這裡就被丟掉了
// （只有 CLI 的 stderr 講得出來，App 走的這條路一個字都不說）。
+ // #159：這一根的同步現況。與 folderPlans 同一個「掃成了才記」的閘——
+ // 掃壞的那輪 rootProgress 是零值，記下去畫面會把它讀成「0 份、已同步」
+ // ＝拿我們自己編的答案打勾。沒記的根由下面的沿用機制補上一輪的。
+ folderProgress[root] = rp.Progress
folderPlans[root] = FolderPlanStatus{
Mode: string(p.Plan.Mode),
Reason: p.Plan.Reason,
@@ -952,6 +980,21 @@ func RunDirectOnce(cfg *DirectConfig, dryRun bool) ([]DirectResult, int, *Trigge
if len(folderPlans) > 0 {
st.FolderPlans = folderPlans
}
+ // #159：逐資料夾的同步現況。這一輪沒掃成的根**沿用上一輪**
+ // （同 MergeFolderTreeStore ② 的理由：畫面不該因為一輪掃壞就說「沒有狀態」）；
+ // 已經不在看守清單上的根自然消失——folderProgress 的 key 只可能來自本輪的
+ // knownRoots，移除掉的資料夾不會被沿用回來。
+ for _, root := range knownRoots {
+ if _, ok := folderProgress[root]; ok {
+ continue
+ }
+ if prev, ok := prevStatus.FolderProgress[root]; ok {
+ folderProgress[root] = prev
+ }
+ }
+ if len(folderProgress) > 0 {
+ st.FolderProgress = folderProgress
+ }
st.SkippedDocCount = len(skippedSeen)
for _, sf := range skippedSeen {
st.SkippedDocs = append(st.SkippedDocs, sf)
diff --git a/folder_progress_wiring_test.go b/folder_progress_wiring_test.go
new file mode 100644
index 0000000..6f114fd
--- /dev/null
+++ b/folder_progress_wiring_test.go
@@ -0,0 +1,138 @@
+package collector
+
+import (
+ "net/http"
+ "net/http/httptest"
+ "os"
+ "path/filepath"
+ "testing"
+ "time"
+)
+
+// TestFolderProgressLandsInStatus 守住 `inkstone/arcrun-rag#159` 的接線：
+// **逐資料夾的同步現況真的會寫進 status.json**，而且是每個根各一份。
+//
+// 為什麼要有這一條：小幫手畫面上那個打勾完全靠這個欄位。它沒寫出來的話，
+// 前端拿不到資料 ⇒ 每一列都會落到 unknown ⇒ 使用者又回到「看不出同步了沒」。
+func TestFolderProgressLandsInStatus(t *testing.T) {
+ srv := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
+ w.WriteHeader(http.StatusOK)
+ _, _ = w.Write([]byte(`{"ok":true}`))
+ }))
+ defer srv.Close()
+
+ base := t.TempDir()
+ rootA := filepath.Join(base, "A")
+ rootB := filepath.Join(base, "B")
+ for _, d := range []string{rootA, rootB} {
+ if err := os.MkdirAll(d, 0o755); err != nil {
+ t.Fatal(err)
+ }
+ }
+ _ = os.WriteFile(filepath.Join(rootA, "a1.md"), []byte("# A1"), 0o644)
+ _ = os.WriteFile(filepath.Join(rootA, "a2.md"), []byte("# A2"), 0o644)
+ _ = os.WriteFile(filepath.Join(rootB, "b1.md"), []byte("# B1"), 0o644)
+
+ cfg := &DirectConfig{
+ Manifest: filepath.Join(base, "manifest.json"),
+ Accounts: []AccountConfig{{CypherURL: srv.URL, Namespace: "ns", WatchFolders: []string{rootA, rootB}}},
+ MaxRemoved: DefaultMaxRemovedRatio,
+ }
+ RunDirectOnce(cfg, false)
+
+ st, err := LoadSyncStatus(StatusFilePath(cfg.Manifest))
+ if err != nil {
+ t.Fatalf("讀不到 status.json：%v", err)
+ }
+ if len(st.FolderProgress) != 2 {
+ t.Fatalf("folder_progress 應該每個看守資料夾各一份（2），got %d：%+v",
+ len(st.FolderProgress), st.FolderProgress)
+ }
+ if got := st.FolderProgress[rootA].Total; got != 2 {
+ t.Errorf("A 的分母應為 2，got %d", got)
+ }
+ if got := st.FolderProgress[rootB].Total; got != 1 {
+ t.Errorf("B 的分母應為 1，got %d", got)
+ }
+ // 🔴 逐資料夾加起來要等於首頁那行總量——它們本來就是同一組數字被切開，
+ // 對不起來就代表有人另算了一套（那正是這張票要拔掉的病）。
+ var sum SyncProgress
+ for _, p := range st.FolderProgress {
+ sum = sum.Add(p)
+ }
+ if sum.Total != st.Progress.Total-st.Progress.Unreadable {
+ t.Errorf("逐資料夾合計 %d ≠ 首頁總量 %d（扣掉沒進 manifest 的 %d）",
+ sum.Total, st.Progress.Total, st.Progress.Unreadable)
+ }
+}
+
+// TestCloudVersionSurvivesOneFailedProbe 守住票的追加條件 6：
+// **「連不上」的判準不能是「這一輪解析失敗」。**
+//
+// leo 2026-08-28 畫面上寫「目前連不上這個知識庫，查不到版本」，
+// 而同一台機器 curl 打同一支 /health 是 HTTP 200——那是機器當下 DNS 抽風。
+// 一次探測失敗不准抹掉我們已經知道的版本。
+func TestCloudVersionSurvivesOneFailedProbe(t *testing.T) {
+ srv := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
+ w.WriteHeader(http.StatusOK)
+ _, _ = w.Write([]byte(`{"ok":true}`))
+ }))
+ defer srv.Close()
+
+ base := t.TempDir()
+ root := filepath.Join(base, "R")
+ if err := os.MkdirAll(root, 0o755); err != nil {
+ t.Fatal(err)
+ }
+ _ = os.WriteFile(filepath.Join(root, "r.md"), []byte("# R"), 0o644)
+
+ cfg := &DirectConfig{
+ Manifest: filepath.Join(base, "manifest.json"),
+ Accounts: []AccountConfig{{CypherURL: srv.URL, Namespace: "ns", WatchFolders: []string{root}}},
+ MaxRemoved: DefaultMaxRemovedRatio,
+ }
+
+ orig := fetchCloudVersion
+ defer func() { fetchCloudVersion = orig }()
+ // 「最新版是多少」也要釘住，否則這條測試會依賴 install.arcrun.dev 通不通
+ // ——那樣測的就不是我們要測的東西了（而且 CI 離線就紅）。
+ origLatest := fetchLatestCloudReleaseRaw
+ fetchLatestCloudReleaseRaw = func() (string, bool) { return "1.4.58", true }
+ latestMu.Lock()
+ latestFetched = time.Time{} // 清掉節流快取，讓 stub 這一輪真的生效
+ latestMu.Unlock()
+ defer func() {
+ fetchLatestCloudReleaseRaw = origLatest
+ latestMu.Lock()
+ latestFetched = time.Time{}
+ latestMu.Unlock()
+ }()
+
+ // 第一輪：查得到版本。
+ fetchCloudVersion = func(string) (string, bool) { return "1.4.60", true }
+ RunDirectOnce(cfg, false)
+
+ // 第二輪：探測失敗（模擬 DNS 抽風）。
+ fetchCloudVersion = func(string) (string, bool) { return "", false }
+ RunDirectOnce(cfg, false)
+
+ st, err := LoadSyncStatus(StatusFilePath(cfg.Manifest))
+ if err != nil {
+ t.Fatal(err)
+ }
+ if len(st.AccountDetails) != 1 {
+ t.Fatalf("應該只有一個帳號，got %d", len(st.AccountDetails))
+ }
+ for host, acc := range st.AccountDetails {
+ if acc.CloudVersion != "1.4.60" {
+ t.Errorf("%s：一次探測失敗就把版本抹掉了（got %q，應沿用 1.4.60）", host, acc.CloudVersion)
+ }
+ if !acc.CloudUpdateKnown {
+ t.Errorf("%s：版本明明還知道，卻標成「查不到」", host)
+ }
+ // 可達性是另一件事，要照實記——不准為了讓畫面好看就說連得上。
+ if acc.CloudCheckOK {
+ t.Errorf("%s：這一輪明明沒連上，cloud_check_ok 卻是 true", host)
+ }
+ }
+}
diff --git a/progress.go b/progress.go
index 361b4b4..b2a1032 100644
--- a/progress.go
+++ b/progress.go
@@ -37,6 +37,16 @@ type SyncProgress struct {
Pending int `json:"pending"` // 還沒送，會自動接著做（含退避等待中的）
Stuck int `json:"stuck"` // 連續失敗達上限、已暫停自動重試——**不會自己好**
Unreadable int `json:"unreadable"` // 格式讀不了，根本沒進 manifest（由呼叫端補進來）
+ // Failing＝Pending 裡「最近一次已經送失敗過、正在退避等重試」的份數
+ // （`inkstone/arcrun-rag#159`）。**它是 Pending 的子集合，不進不變式**——
+ // 加總永遠只算 Total == Done+Pending+Stuck+Unreadable。
+ //
+ // 🔴 為什麼要分出來：Pending 同時裝著兩種完全不同的處境——「還沒輪到」與
+ // 「一直送不上去」。混在一起時畫面只能講「同步中」，而 2026-08-28 leo 桌面上
+ // geek6688-test1 的 14 份**每一份都在失敗重試**（雲端回 HTTP 500 Too many
+ // subrequests，fail_count 是 7 與 3），講「同步中」等於叫他等一件正在壞掉的事。
+ // 分出來，畫面才判斷得出該不該示警（見 arcrun-app/folder_badge.go）。
+ Failing int `json:"failing"`
}
// Add 把另一個資料夾／帳號的進度累加進來——首頁與診斷檔講的都是總量。
@@ -47,6 +57,7 @@ func (p SyncProgress) Add(o SyncProgress) SyncProgress {
Pending: p.Pending + o.Pending,
Stuck: p.Stuck + o.Stuck,
Unreadable: p.Unreadable + o.Unreadable,
+ Failing: p.Failing + o.Failing,
}
}
@@ -69,6 +80,11 @@ func (m *Manifest) Progress() SyncProgress {
p.Stuck++
default:
p.Pending++
+ if e.FailCount > 0 {
+ // #159：還在排隊，但**已經失敗過**——退避等下一次重試。
+ // 與 Pending 並存（子集合），不影響上面的不變式。
+ p.Failing++
+ }
}
}
return p
diff --git a/sync_status.go b/sync_status.go
index a66a4a8..9762a92 100644
--- a/sync_status.go
+++ b/sync_status.go
@@ -105,6 +105,23 @@ type SyncStatus struct {
// 與 Retiring 同族的現況快照，見 ResyncStatus 註解。
Resync map[string]ResyncStatus `json:"resync,omitempty"`
+ // FolderProgress＝**逐個看守資料夾**的同步現況（key＝資料夾路徑，`inkstone/arcrun-rag#159`）。
+ //
+ // 🔴 為什麼要有：小幫手畫面上每個資料夾都要能一眼看出「同步了沒」，而在這之前
+ // 那一格唯一的資料來源是 #140 的補送說明——**它只在有補送的時候才有值**，
+ // 於是畫面只好拿「有沒有那句話」當狀態。2026-08-28 leo 看到七列有六列寫「補送中」，
+ // 連 pending 已經是 0 的也照樣寫（實測 youlinhsieh-test1：pending=0／repaired=2，
+ // 畫面仍標補送中）——那個標籤量的根本不是同步狀態。
+ //
+ // 🔴 **不另算一套**：值就是 (*Manifest).Progress() 的原件，與首頁那行大數字、
+ // 診斷檔用同一個函式。逐資料夾加起來會等於首頁總量，因為它們本來就是同一組
+ // 數字被切開，不是兩份實作。
+ //
+ // 與 FolderPlans 同族的現況快照；某一輪那個根沒掃成（payload 為 nil）時**沿用
+ // 上一輪**，不要讓使用者看到昨天還好好的資料夾突然沒有狀態
+ // （同 MergeFolderTreeStore ② 的理由）。
+ FolderProgress map[string]SyncProgress `json:"folder_progress,omitempty"`
+
// 🔴 G-6.2「不准安靜地略過」（2026-08-06）：副檔名不在 allowedExt 的檔案，
// 以前在 scan.go 的白名單閘就 `return nil` 蒸發了——沒事件、沒紀錄、沒畫面。
// 使用者丟一份 .doc 進資料夾，得到的回應是**完全的沉默**。