Files
arcrun-collector/cmd/arcrun-tray
Leo 1a8906c0b7 t181 daemon 端:萃取預設走 Workers AI(免金鑰)+托盤可切換 AI 來源
【leo 08-04 列為最優先】「daemon 的 AI 改用 workers AI」
——「這是我的用戶**最大障礙**,造成首輪測試用戶的**好評或惡評**」。

【新增】collector/extract_workersai.go:打自己雲端實例的 /portal/daemon/extract,
那端用 env.AI binding ⇒ **完全不需要任何金鑰**。與 gemma 路架構完全對稱
(leo 的判斷:「不論用 Claude/Gemini/Workers AI…應該是同一件事」——是,
只有「送到哪」不同,讀檔/轉檔/淨化/落卡全共用)。
舊實例回 404 時講人話:「你的知識庫還是舊版 ⇒ 請到 portal 按『立即更新』」。

【預設改為一律 Workers AI】leo 特別交代:
  「default 用 Workers AI,你要用 Gemini 要**特別去選取**,**不管你現在是否有填金鑰**」
  「只要更新版本,就已經 default workers AI 了,除非去一個地方切換」
  「不然我會有很多質疑,**花在解釋為什麼 Gemini 不管用上**」
⇒ 判準是新欄位 ExtractorExplicit(使用者主動選過),**不是「有沒有金鑰」**。
  舊 config 沒這欄=false ⇒ 更新版本後自動走 Workers AI;金鑰留著不動,改選 Gemini 立刻可用。

【托盤=唯一切換處】「AI 設定…」改成引擎選擇:雲端 AI(預設)/Gemini(選配)。
選 Gemini 才顯示金鑰欄,並附「Billing Tier: Unavailable ⇒ 換 Google 帳號」的排難提示
(今天 oscar 撞的那題)。Gemini 不推廣(leo:「特定人告訴他怎麼做就好」),文案只說明不慫恿。

【標籤】leo:「用 workers AI 就**不顯示**,用 Gemini 會顯示 Gemini」
⇒ 預設路徑不佔版面;只有主動選了別的才標出來(延續 t178「標籤必須與實際行為一致」)。

【測試】新增 TestT181DefaultsToWorkersAI 六則,含最關鍵的
**「有金鑰但沒主動選 ⇒ 仍走 workers-ai」**;既有測試補 ExtractorExplicit 以隔離變因
(它們測的是萃取管線,不是預設邏輯)。兩模組全綠。

⚠️ 未送達:要打包 v0.15.5 並部署雲端端點才會到用戶手上。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-08-04 15:00:48 +08:00
..

Arcrun RAG 托盤殼(arcrun-tray)— 建置/簽章/TCC 交接

CP-1 第 6 關 daemon 產品化。leo 2026-07-21 定框架=fyne(窮舉七案後推薦,見頂層 journeys/daemon-tray-shell-options.md)。建置/簽章/公證/TCC 授權=leo/地端在真機做(紅線②③)。

這顆殼做什麼

一個選單列(Mac/系統匣(Windowsicon,讓不開 terminal 的人也能用:

  • 狀態一眼看(看守中 · 上次同步 HH:MM/啟動中/出錯自動重試/已暫停)
  • 選單:選擇知識資料夾(系統原生對話框)/打開資料夾/暫停·繼續看守
  • 關掉視窗=縮回背景續看守(不是結束)

看守 arcrun-collector direct(同綑執行檔),把它當背景常駐;崩了自動重起。

哪些已驗、哪些待真機驗(誠實界定,mindset §7)

部分 狀態 驗法
看守核心 collector/supervisor(子行程管理/狀態解析/崩潰重起/停止) sandbox go test 驗過(純 stdlib,5 測全綠,含重起/停止/狀態解析) cd collector && go test ./supervisor/
collector 引擎(未動) 既有測試無回歸 cd collector && go test ./...
fyne GUI 本體(本 main.gotray icon/選單/原生選資料夾) 待真機 build——fyne 需 CGoGL/webview,無螢幕 sandbox 編不了 真機 go mod tidy && fyne package
macOS TCC 同意流 待真 Mac 驗(沙箱測不到真 TCC 語意=假綠,故不盲寫) 見下「TCC」

⚠️ fyne API 細節(fyne.DoSetSystemTrayMenu 刷新/Lifecycle)以首次真機 build 為準—— 本檔按 fyne v2.5 API 寫,但未經編譯器。第一次 go mod tidy && go build 若有 API 出入,就地修。

建置(leo/地端,真機)

cd collector/cmd/arcrun-tray
go mod tidy                       # 拉 fyne 依賴(首次需網路)
# 把 collector 執行檔一起放進 bundle(托盤靠同層 arcrun-collector
cd ../.. && GOOS=darwin GOARCH=arm64 go build -o cmd/arcrun-tray/arcrun-collector .
# 打包 .appMac)/.exeWin
go run fyne.io/fyne/v2/cmd/fyne@latest package -os darwin -icon icon.png -name "Arcrun RAG"
# Windows-os windows

icon.png 待放(leo logo 進行中);Mac 選單列建議 template 單色 icon(自動深淺色)。

簽章/公證(Macleo/地端)

未簽章的 .app 會被 Gatekeeper 擋(右鍵開可繞,但非產品體驗)。正式版:

codesign --deep --force --options runtime --sign "Developer ID Application: <你>" "Arcrun RAG.app"
xcrun notarytool submit "Arcrun RAG.zip" --apple-id … --team-id … --wait
xcrun stapler staple "Arcrun RAG.app"

TCCmacOS,只有真 Mac 驗得到)

預設 watch_folder ~/ArcrunRAG(本殼已這樣設)——刻意避開 ~/Documentslaunchd/背景程序碰 ~/Documents 會被 TCC 擋(2026-07-19 實撞)。預設在非 TCC 禁區=零授權即可用

用戶若堅持把資料夾設在 ~/Documents/~/Desktop/~/Downloads

  1. 首次讀取被拒 → 本殼應偵測並引導:系統設定 → 隱私權與安全性 → 檔案與資料夾(或完整磁碟取用權)勾選 Arcrun RAG。
  2. 這一步必須在真 Mac 上驗(跳不跳授權框、launchd 背景 vs GUI 前景差異)。sandbox 只能測到 os.Open 成不成,測不到真 TCC=假綠,故本輪不寫死。

安裝(用戶視角,最終形態)

下載 → 拖進「應用程式」→ 開啟 → 選一個資料夾 → 完成。cypher_url/namespace/api_key 由安裝器寫進 ~/.arcrun-rag/config.json(用戶不碰)。現行 docs/manual/product-install-guide.md 是廢棄的 Docker 六步,產品化時要重寫成這段。