inkstone/arcrun-collector
2
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases 15 Wiki Activity
88 Commits 2 Branches 15 Tags
f32e82bab55e1c1850899faaf303cccbb4cc23da
Commit Graph

4 Commits

Author SHA1 Message Date
Leo 6bf0daa786 修首頁狀態說謊＋DMG 補上拖曳版面（leo 08-05 封測回報 ①②） 
## ② 首頁狀態是壞的
leo：「拖新的檔案進資料夾，完成本地萃取、上傳，但自始至終 daemon 的首頁都顯示
『有變動就自動開始』『等待中』，都顯示綠燈沒動，實際上已經做完了。」

兩個獨立的真兇：

**A. 「同步中」判斷用錯依據（回歸）**
t191 早就做好機制：collector 開工印 phase:"start"、跑完印 "done"，
supervisor 據此維護 StateSyncing。**換 Wails 時 App 沒接這條線**，改看 sync-now 訊號檔：
  ① 訊號檔只有手動按「立刻同步」才產生 ⇒ 拖檔進資料夾（自動觸發）整輪不亮燈
  ② 就算手動按，collector 是**先刪檔再跑**（consumeSyncNowSignal）⇒ 真正在跑時檔早沒了
⇒ 改讀 sup.Status().State == StateSyncing。**接回既有機制，不發明第三種判斷法。**

**B. 做完的證據被下一輪抹掉**
ExtractedOK/ExtractFailed 是**本輪**計數、每輪覆寫整份 status.json
⇒ 有產出那輪寫下 N，十幾秒後空轉的一輪把它蓋成 0
⇒ 「上一輪 N 份」永遠空白、四步時間軸的綠燈只靠「跑過任何一輪」判斷＝與實際進度脫鉤。
⇒ 新增 last_activity_{at,ok,failed}：有產出記本輪、空轉沿用上一輪（CarryForwardActivity）。
   首頁改顯示「幾點整理了幾份」，綠燈只在真的整理過東西時才亮。

## ① Mac DMG 少了「看得出要拖」的版面
leo：「要跳出虛擬隨身碟，打開一個 finder 的視窗，**顯示 Arcrun 和 Application 的捷徑**，
用戶把 App 拖進 Application」。
原本 DMG 內容是對的（Arcrun.app＋Applications 捷徑），但**沒設版面**
⇒ 預設清單視圖、位置隨機，看不出「要往右拖」。
⇒ build-dmg.sh 改走 UDRW → Finder AppleScript 設大圖示/視窗大小/左右並排 → 轉 UDZO。
   best-effort：無桌面工作階段時只警告不中止（版面是加分，不該讓打包掛掉）。

⚠️ 真正讓 leo 拿到 zip 的原因不在這裡——是**線上 portal 還沒出貨**（見下）。

## 驗（實測輸出）
· collector 全測綠；新增 TestCarryForwardActivity 四子測（含「空轉不該抹掉上次成果」）
· 掛載 dist/Arcrun-v0.18.5.dmg 實查：
    內容剛好兩項（Arcrun.app + Applications→/Applications 捷徑）
    .DS_Store 6148 bytes（版面已存進去）
    Contents/MacOS/ 有 arcrun-app **和 arcrun-collector**
    CFBundleShortVersionString = 0.18.5（不是 1.0.0）／LSUIElement = true／codesign -v 通過
· 三支機械閘 check-cis／check-render／check-tray 全 PASS

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
 2026-08-05 18:01:17 +08:00
Leo d787bfc47d t195：燈號不再說謊＋加診斷 log（leo：「燈號是真的還是假的？」→ 是假的） 
## 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 未修）。
 2026-08-05 11:45:07 +08:00
Leo fcdb1df71d t194 二修：托盤 icon／右鍵選單／重複點擊／正常結束（leo 實測四點） 
leo 真機測出四個問題，每個都查到真兇後才動手：

## ① 托盤 icon 變方塊
真兇：我塞 1024x1024 的**彩色 app icon** 當 template icon。
macOS 選單列規格是 **16-22pt、純黑＋alpha**（由系統依深淺色自動上色）
⇒ 彩色大圖被縮成一坨方塊是必然。
修：用 CIS 的 chevron-double.svg 渲成 44x44 純黑 template icon。

## ②③ 右鍵沒選單／第一次能開之後就不再跳
真兇（energye/systray 原始碼註解白紙黑字寫著）：
「該方法主動調用後 如果托盤菜單已創建則添加進去, **之後鼠標事件失效**」
⇒ 只要用 AddMenuItem 建了選單，SetOnClick／SetOnRClick **全部失效**。
修：SetMenuNil() 移除選單讓滑鼠事件生效，右鍵時自己 ShowMenu()。
另外 ShowWindow 只呼叫 WindowShow 對「已開但被蓋住」無效
⇒ 補 Unminimise ＋ AlwaysOnTop 閃一下搶焦點。

## ④ 只能用強制結束
真兇：Wails 的 loop 不理 SIGTERM，且 collector 是我們自己 Start 的子行程
⇒ 主程式被殺後**子行程變孤兒繼續跑**。
實測（機械驗證，非目視）：
  修前 kill -TERM → App 沒退、collector 孤兒還在
  修後 kill -TERM → App 正常退出 ✅、collector 一起收掉 ✅、殘留 0
修：installSignalHandler 收 TERM/INT → stopSupervisor() →
    waitCollectorGone(3s) 確認子行程真的不見（逾時補一刀）→ 才 os.Exit。
    「關了卻還在同步」比沒關更糟。

實跑驗證：App 活著 pid 88466、自己拉起 collector、crash 0、兩支機械閘全過。
 2026-08-05 01:41:31 +08:00
Leo 549834f343 t194：托盤收成 Google Drive 式（點 icon 開視窗／右鍵只有結束）＋同綑 collector 
leo 2026-08-05：「依照 google drive，托盤裡只剩下按右鍵會結束，
其他設定都在這個頁面，點擊托盤的 icon 就立刻展開界面」

## 托盤
Wails v2 沒有內建托盤 ⇒ 用 energye/systray（Wails 相容分支，支援左鍵事件）。
- 左鍵：直接展開主視窗，**不彈選單**
- 右鍵：只有一項「結束 Arcrun」
- 設定全部留在視窗裡，托盤不再是第二套 UI
  （fyne 版把設定塞下拉選單，leo 早說過「不可能統統塞在下拉選單」）
- 關窗＝隱藏不結束（daemon 常駐；按 × 就停止同步不符預期）
- Dock 不出現 icon：Wails v2.13 的 mac.ActivationPolicy 還沒開放（原始碼是註解掉的）
  ⇒ 改走 Info.plist 的 LSUIElement，與 fyne 版同一個做法

## 🔴 順手抓到自己的大漏：這個 App 根本沒有啟動 collector
daemon 的**本體**是 `collector direct`（監看/萃卡/上傳），Wails 版我一路沒接
⇒ 照這樣出貨會是「裝了也不會同步」的空殼。
修：新增 supervise.go，**複用既有 supervisor 套件**（重起退避／狀態機／
    t191 的 phase:start/done ⇒「同步中…」），不複製一份（複製＝會漂移）。
    go.mod 用 replace 指回 collector 主模組。
    加/刪資料夾、改 AI 設定後都會 restartWatch()，設定立刻生效。

## 打包
新增 build-mac.sh：編 collector → wails build → **同綑進 .app** → ad-hoc 重簽。
沒同綑就等於沒有 daemon。

實測（v0.18.0）：collector 同綑 15M ✅／LSUIElement=true ✅／版本注入 ✅／已簽 ✅
兩支機械閘全過。
⚠️ 未驗：托盤左右鍵的實際行為要真機點（我開不了視窗）。
 2026-08-05 00:31:52 +08:00