From d787bfc47d93a02c853a0d16d1294d3f944ea662 Mon Sep 17 00:00:00 2001 From: richblack Date: Wed, 5 Aug 2026 11:45:07 +0800 Subject: [PATCH] =?UTF-8?q?t195=EF=BC=9A=E7=87=88=E8=99=9F=E4=B8=8D?= =?UTF-8?q?=E5=86=8D=E8=AA=AA=E8=AC=8A=EF=BC=8B=E5=8A=A0=E8=A8=BA=E6=96=B7?= =?UTF-8?q?=20log=EF=BC=88leo=EF=BC=9A=E3=80=8C=E7=87=88=E8=99=9F=E6=98=AF?= =?UTF-8?q?=E7=9C=9F=E7=9A=84=E9=82=84=E6=98=AF=E5=81=87=E7=9A=84=EF=BC=9F?= =?UTF-8?q?=E3=80=8D=E2=86=92=20=E6=98=AF=E5=81=87=E7=9A=84=EF=BC=89?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit ## leo 實撞 丟 PDF 進 youlinhsieh-test1 沒反應；按「立刻同步」後畫面顯示 「正在整理知識卡」，但**卡從來沒產出**。 ## 燈號為什麼是假的 舊版 describeStatus 只看「sync-now 訊號檔存不存在」就顯示「同步中…」。 那只代表**排隊了**，不代表有人處理：leo 的 collector 在 11:25 跑完最後一輪， 他 11:38 按同步 ⇒ 訊號檔沒人消化 ⇒ 畫面一直說在整理，實際 13 分鐘沒跑過。 **這比沒有燈號更糟——它在說謊。** 修：燈號要有憑有據—— · collector 沒在跑 → 明說「同步引擎沒有在跑」並告訴他怎麼辦 · 有排隊 **且** 引擎活著 → 才是「同步中」 · 其餘 → 看守中 ## 順手補上診斷 log（~/.arcrun-rag/app.log） startSupervisor 以前只 Stat(config) 就靜默 return，出問題完全查不到 （我這次也是繞了很久才確定它有啟動）。現在每個 return 點都留痕。 ## 🔴 但真正擋住產卡的是另一個 401（未修，需 leo 裁） 實測鏈路：掃到 PDF ✅ → /portal/daemon/extract ✅ 200 → 寫 kbdb ❌ 401 curl -X POST https://arcrun-kbdb.youlin-hsieh-dev.workers.dev/entries（無 token）→ 401 真兇：workflows/rag-ingest-card.local.yaml 打 __KBDB_BASE__/entries **完全沒帶 Authorization**，但 kbdb 要 Bearer KBDB_INTERNAL_TOKEN。 ⚠️ 與今天修的 t189 不同：那是 extract 端點入口（現已 200），這是 workflow 內部寫 kbdb。 修法命中 D36 金鑰鐵律（「只能拿 key，送出時自動拉 value」） ⇒ 應寫 {{credential.kbdb_internal_token}} 由 resolve_credentials 回填， 而非讓安裝器 sed 把 token 值塞進定義。**已停下等 leo 裁**。 ## CP 對帳 「丟檔→產卡」＝ ❌ 斷（卡產不出來）。本次只修好「燈號誠實」與「可診斷」， **未送達用戶**（daemon 新版尚未出貨、401 未修）。 --- cmd/arcrun-app/app.go | 21 ++++++++++++++++--- cmd/arcrun-app/build-dmg.sh | 33 +++++++++++++++++++++++++++++ cmd/arcrun-app/supervise.go | 41 ++++++++++++++++++++++++++++++++++--- 3 files changed, 89 insertions(+), 6 deletions(-) create mode 100755 cmd/arcrun-app/build-dmg.sh diff --git a/cmd/arcrun-app/app.go b/cmd/arcrun-app/app.go index abdc49a..656121d 100644 --- a/cmd/arcrun-app/app.go +++ b/cmd/arcrun-app/app.go @@ -221,10 +221,25 @@ func loadSyncStatus() syncStatus { } // describeStatus 產生狀態文案。 -// 🔴 issue #17：正在跑就要**看得出來在跑**——按「立刻同步」會寫 sync-now 訊號檔， -// collector 開工時才把它吃掉；訊號檔還在＝已排隊未完成 ⇒ 顯示「同步中…」。 +// 🔴 t195（leo 08-05 實撞：「燈號是真的還是假的？」——**是假的**）： +// +// 舊版只看「sync-now 訊號檔存不存在」就顯示「同步中…」。 +// 但那只代表**排隊了**，不代表有人在處理：leo 的 collector 在 11:25 死掉， +// 他 11:38 按同步 ⇒ 訊號檔沒人消化 ⇒ 畫面一直說「正在整理知識卡」， +// 實際上 13 分鐘沒跑過任何一輪、也不會產卡。**這比沒有燈號更糟——它在說謊。** +// +// ⇒ 燈號改成有憑有據： +// · collector 沒在跑 → 明說「同步引擎沒有在跑」，不要假裝在整理 +// · 有訊號檔且引擎活著 → 才是真的「同步中」 +// · 其餘 → 看守中 func describeStatus(s syncStatus) (syncing bool, big, sub string) { - if _, err := os.Stat(syncNowSignal()); err == nil { + alive := collectorAlive() + _, queued := os.Stat(syncNowSignal()) + + if !alive { + return false, "同步引擎沒有在跑", "資料夾不會被自動整理 ⇒ 請結束 Arcrun 再重新開啟" + } + if queued == nil { return true, "同步中… 正在讀檔並整理成知識卡", "請稍候，完成後會顯示整理了幾份" } if s.ExtractorError != "" && !s.ExtractorOK { diff --git a/cmd/arcrun-app/build-dmg.sh b/cmd/arcrun-app/build-dmg.sh new file mode 100755 index 0000000..4162883 --- /dev/null +++ b/cmd/arcrun-app/build-dmg.sh @@ -0,0 +1,33 @@ +#!/usr/bin/env bash +# build-dmg.sh — 打包成 Mac 標準安裝檔（t194，leo：「你應該包成 Mac 安裝檔，我完整做一次」） +# +# DMG 裡放 Arcrun.app ＋ Applications 捷徑 ⇒ 開啟就是「把 App 拖進去」的標準畫面。 +# 為什麼一定要：使用者若直接在下載資料夾裡跑，自更新會蓋錯位置（t184 Oscar 的病）； +# 而且 macOS 對「不在 /Applications 的常駐程式」權限行為也不一致。 +set -euo pipefail +cd "$(dirname "$0")" +VERSION="${VERSION:-$(git describe --tags --always --dirty 2>/dev/null || echo dev)}" + +echo "① 先確保 .app 是最新的" +VERSION="$VERSION" bash build-mac.sh >/dev/null + +APP="build/bin/Arcrun.app" +[ -d "$APP" ] || { echo "❌ 找不到 $APP" >&2; exit 1; } + +OUT="dist"; DMG="$OUT/Arcrun-${VERSION}.dmg" +STAGE="$(mktemp -d)/Arcrun" +mkdir -p "$OUT" "$STAGE" + +echo "② 放 app ＋ Applications 捷徑" +ditto "$APP" "$STAGE/Arcrun.app" +ln -s /Applications "$STAGE/Applications" + +echo "③ 產 DMG（-fs HFS+：否則含空格/中文的名稱會被截斷）" +rm -f "$DMG" +hdiutil create -volname "Arcrun" -srcfolder "$STAGE" -fs HFS+ -ov -format UDZO "$DMG" >/dev/null +rm -rf "$(dirname "$STAGE")" + +SIZE=$(ls -lh "$DMG" | awk '{print $5}') +echo "✅ 完成：${DMG}（${SIZE}）" +echo +echo "🔬 使用者流程：開 DMG → 把 Arcrun 拖到 Applications → 從啟動台開啟" diff --git a/cmd/arcrun-app/supervise.go b/cmd/arcrun-app/supervise.go index b0619ca..ae3d977 100644 --- a/cmd/arcrun-app/supervise.go +++ b/cmd/arcrun-app/supervise.go @@ -9,6 +9,7 @@ package main // 邊界：**複用既有的 supervisor 套件**（重起退避、狀態機、round 解析都在裡面， // 含 t191 的 phase:start/done ⇒ 「同步中…」）。這裡只做「找到執行檔、拉起來」。 import ( + "fmt" "os" "os/exec" "os/signal" @@ -43,10 +44,34 @@ func collectorBinPath() string { // startSupervisor 在 App 啟動時拉起 collector；沒有 config 就先不啟動 // （使用者還沒連知識庫，啟動只會一直失敗刷 log）。 func startSupervisor() { - sup = supervisor.New(collectorBinPath(), configPath()) - if _, err := os.Stat(configPath()); err == nil { - sup.Start() + bin := collectorBinPath() + cfg := configPath() + // 🔴 t195：這裡以前只 Stat(config) 就靜默 return，出問題完全查不到。 + // leo 實撞：App 活著、collector 從沒啟動、畫面卻顯示「正在整理知識卡」。 + // ⇒ 每個 return 點都要留下痕跡（寫進 collector.log 旁邊的 app.log）。 + if _, err := os.Stat(bin); err != nil { + appLog("啟動同步引擎失敗：找不到 %s（%v）", bin, err) + return } + if _, err := os.Stat(cfg); err != nil { + appLog("尚未連上知識庫（沒有 %s），同步引擎先不啟動", cfg) + return + } + sup = supervisor.New(bin, cfg) + sup.Start() + appLog("同步引擎已啟動：%s", bin) +} + +// appLog 把 App 層的關鍵事件寫進 ~/.arcrun-rag/app.log。 +// 沒有這個，「為什麼沒同步」就只能用猜的（leo 這次就卡在這）。 +func appLog(format string, args ...any) { + f, err := os.OpenFile(filepath.Join(appDir(), "app.log"), + os.O_APPEND|os.O_CREATE|os.O_WRONLY, 0o644) + if err != nil { + return + } + defer f.Close() + fmt.Fprintf(f, "%s %s\n", time.Now().Format(time.RFC3339), fmt.Sprintf(format, args...)) } // restartWatch 在設定變更後重起看守，讓新設定立刻生效。 @@ -109,3 +134,13 @@ func processRunning(bin string) bool { out, _ := exec.Command("pgrep", "-f", bin).Output() return len(strings.TrimSpace(string(out))) > 0 } + +// collectorAlive 回報「同步引擎是不是真的在跑」。 +// 🔴 t195：燈號不可以只憑「訊號檔存在」就說在同步——leo 實撞過 +// collector 已死、畫面卻一直顯示「正在整理知識卡」13 分鐘。 +func collectorAlive() bool { + if sup == nil { + return false + } + return processRunning(collectorBinPath()) +}