arcrun-collector

inkstone/arcrun-collector

Fork 0

Commit Graph

Author	SHA1	Message	Date
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

Author

SHA1

Message

Date

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

3 Commits