inkstone/arcrun-collector
2
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases 14 Wiki Activity
77 Commits 2 Branches 14 Tags
fcdb1df71d9cebfad65bdfa0855d9dd8940a9721
Commit Graph

55 Commits

Author SHA1 Message Date
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 643acc0f74 t194 修：托盤必須在主執行緒建立——交付警察攔下，實跑才發現會 crash 
交付警察問「leo 現在去測會不會發現你沒發現的東西」⇒ 我去真的跑一次，
**發現這版根本起不來**。我原本只驗了「打包產物有沒有那些檔案」，沒驗它會不會活著。

## 兩個 crash，都要真機跑才看得到
① `systray.Run()` 自己開 loop ⇒ 與 Wails 搶 macOS 主 loop
   ⇒ SIGTRAP `signal arrived during cgo execution`
② 改用 RunWithExternalLoop 但在 OnStartup／goroutine 裡呼叫 start
   ⇒ SIGABRT `NSWindow should only be instantiated on the main thread!`
   （NSStatusItem 內部會 new NSWindow，AppKit 規定只能在主執行緒）
   ⚠️ 我一度想「加個 sleep 丟 goroutine」——那只是拖延，goroutine 永遠不是主執行緒。

## 正解
main() 一開始（還在主執行緒）就 RunWithExternalLoop 註冊並 trayStart()，
它**不阻塞**，接著把主執行緒交給 wails.Run()；defer trayEnd() 收尾。

## 實測（跑真的 .app，非只看檔案）
  App 活著 pid 59162 ✅
  它拉起自己的 collector ✅（arcrun-app/.../arcrun-collector，與舊 fyne 版並存不衝突）
  crash 訊號 0 ✅／log 僅 1 行 ✅
兩支機械閘仍全過。

⚠️ 未驗：托盤左右鍵的**點擊行為**要人真的去點（我點不了）。
 2026-08-05 00:46:52 +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
Leo 5a48abb784 t193 四修：裁淨版 lockup＋側邊欄選中態照 portal（leo 兩點） 
## ① logo 比例不對＋深色仍有白底＋旁邊大量空白
三個症狀同一個根：**我用的是未裁淨的原始 PNG**。
portal 的註解早就寫著：原始 1840x560 **只有 32% 高度是實際字形**，上下大留白
⇒ 同 height 字看起來很小；留白處露出 paper-on-ink 自帶的 Ink 底板＝白底。
portal 用的是裁淨版（986x176），但**只內嵌在它的 HTML base64 裡**，我抄不到才用了原始圖。

修：
- 從 portal 的 base64 抽出兩張裁淨版，存成 arcrun-cis/trimmed/ 供全站共用
- 兩張**都是透明底**（實測四邊留白 0）⇒ 深色模式**拿掉 Ink 底板**
- 空白是**版面**造成：側欄 232px 扣 padding 剩 184px，logo 高 24px 只有 134px ⇒ 空 50px
  ⇒ 側欄對齊 portal 的 216px，logo 改 width:100% 填滿可用寬度

實測（渲染後量像素）：
  logo 26px 高 × 151px 寬，右側剩餘空白 1px（原本 50px）
  深色：側欄底(18,18,18) vs logo 上下皆(18,18,18) ⇒ 落差 0，無白底

## ② 側邊欄選中態太粗糙
leo：「參考現在 Portal 的格式⋯⋯這個比現在膠囊反紅精緻，重點是跟 portal 的形象符合」
修：逐字照 portal 的 #sidenav .nav.on ——
    **不是實心膠囊**，而是 amber 字色 ＋ 8% amber 底 ＋ 右側 2px amber 邊。
    側欄右緣也照 portal 用 2px amber 35%。
實測：選中列底(237,228,222)=amber 8%、右緣(176,74,47)=Relation、未選(242,241,237)=Canvas。

## 機械閘加三項守衛
- 不准用未裁淨的原始 lockup（字會太小）
- 選中態必須有 border-right-color: var(--amber)
- 不准再出現 border-radius:999px（膠囊，leo 已否決）
兩支閘全過；style.css 仍 0 個 hex。
 2026-08-05 00:02:46 +08:00
Leo 751ee74f19 t193 三修：每庫一頁＋狀態時間軸＋預設淺色（leo 六點回饋） 
## ① logo 尺寸不對導致白邊
真兇：我寫死 height:22px **沒給 width:auto** ⇒ 容器一壓就變形、露出底板邊緣。
修：照 portal 側欄同一條 clamp(22px,5vw,28px) + width:auto + max-width:100%，
    並依 CIS「clear space = one chevron height」在四邊留白。
實測：logo 底板與品牌區落差 **0**（原本是明顯方塊）。

## ② 深色跟網頁不同／「它有淺色佈景？」
是——**portal 預設淺色**，深色由使用者切換並存 localStorage。
我卻硬跟系統走 ⇒ 兩邊當然不同。
修：改成與 portal 同一套（預設淺色＋切換鈕＋localStorage），
    按鈕規格也逐字對齊 portal 的 .btn/.btn3（padding/font-size/radius/border）。
實測淺色：品牌區(253,252,251)=Paper、側欄(242,241,237)=Canvas，與 CIS 一致。

## ③ 「開啟知識庫網頁」開到錯的庫
真兇：它在首頁、寫死取 accounts[0] ⇒ 有兩個庫必然開錯。
修：移到**各庫頁的上方**，開的就是那個庫。

## ④⑤ 30 個資料夾放不下／「加入資料夾」會加到哪個帳號？
修：**每個知識庫一個獨立分頁**（側邊欄動態列出，附資料夾數）。
    「加入資料夾」在庫頁裡，**作用對象就是那個庫**，不會加錯。

## ⑥ 首頁要顯示 status（看守／發現變化／萃取／上傳）
修：首頁改成**狀態時間軸**四步，進行中那步的圓點會呼吸。
    誠實邊界：collector 目前回報「整輪」而非逐檔階段，
    所以同步中時後三步一起標進行中，**不假裝有更細的進度**。

兩支機械閘全過（check-cis.sh 14 項／check-render.sh 深淺色皆驗）。
style.css 仍是 0 個 hex（顏色全走 var）。
 2026-08-04 23:35:49 +08:00
Leo 3d13e5a54e t193 二修：側邊欄版面＋共用 CSS＋App 內更新＋兩支視覺機械閘 
leo 08-04 看過 v0.17.0 後的四點，逐條回應：

## ① 「不會這裡又寫了一個新的 CSS？」——是，我又寫了一份
真兇：portal 的樣式內嵌在 HTML 裡，沒有獨立檔 ⇒ 四個站各抄一份、本來就在漂移。
解：抽出 InkStoneCo/arcrun-cis/css/arcrun-cis.css 當唯一真相源。
    daemon 的 style.css 現在**一個 hex 都沒有**，顏色全走 var(--...)。

## ② 「完全模仿 gdrive，左方側邊欄，在右方替換頁面」
底部 nav bar 拿掉（leo：「幾乎沒看過這種 nav bar 在下方的」）。
改成左側邊欄四頁：首頁／同步資料夾／AI 設定／版本與更新，右側換頁。
設定不再開 popup；只有「確認移除資料夾」才用覆蓋層。

## ③ 「既然是 Web，你做的時候無法檢視？」——可以，我之前沒做
新增 check-render.sh：headless Chrome 真的渲染一次並**量像素**。
它抓到一個肉眼容易誤判的真 bug：
  arcrun-lockup-h-paper-on-ink.png **自帶不透明 Ink 底板**（實測左上像素 RGBA=23,24,26,255），
  設計前提是貼在純 Ink 表面；我們背景有紙張紋理 ⇒ 出現突兀方塊。
  修：深色模式把品牌區做成純 Ink。實測落差 4（原本會是一個明顯方塊）。
過程中也發現自己對著**舊的 dist**除錯，浪費一輪——這支閘同時防這個。

## ④ 「檢查更新連到 docs，不正確，是直接在這裡進行」
新增「版本與更新」頁：顯示**現在版本 vs 最新版本**，
三段式全在 App 內完成——檢查／下載並安裝／重新啟動套用。
selfupdate 邏輯逐字沿用 arcrun-tray（含 t186 走 raw、t184 蓋正在跑的 .app），不重寫。

## 交貨閘（leo：「你做為檢查有嗎？沒有怎麼交貨？」）
check-cis.sh 擴充：版面檔不准出現任何 hex ＋ 共用底層色票逐項比對。
兩支閘實跑全過。
 2026-08-04 23:09:54 +08:00
Leo bd0cead00e t193：daemon UI 換 Wails——CIS 是硬要求，fyne 做不到 
leo 2026-08-04 看過 v0.16.0 畫面後：
「功能都有了，但美感非常糟糕⋯⋯跟 CIS 完全無關，每個功能都開一個小小的 popup 視窗，
 非常缺乏整體感，這要理解的是原始的技術選擇是否出錯？」
「我的要求是符合 CIS，在風格上跟 portal 一樣」
「CIS 已經提供規範，你做的連 Logo 都沒放上去，這跟美不美有關係嗎？
 要求放進 CIS 是硬要求，你做為檢查有嗎？沒有怎麼交貨？」

## 我的兩個錯
1. **動工前沒提醒做不到**——decisions-summary.md:314 的 D-daemon-UI
   是我 07-27 自己寫的調研（結論：fyne 全自繪、CSS 套不進去），寫完就沒再看。
   今天動工前該查它卻直接開寫，浪費 leo 的時間與 token。
2. **沒做 CIS 檢查就交貨**——連 logo 都沒放。

## 換 Wails（WebView 殼）
前端就是 HTML/CSS ⇒ 可以直接用 portal 那份色票與 lockup。
- style.css 的色票/字體/紙張紋理**逐字取自** portal 的 :root
  （matrix/arcrun:console-ui/public/portal/index.html），不自創任何顏色
- CIS lockup 官方 PNG，淺色 ink 版／深色 paper 版，切換規則同 portal
  （避開 08-01 作廢的自產 SVG——字腔缺失）
- 對話框改**內嵌覆蓋層**，不再每個功能開一個小 popup
- 原生資料夾選擇器（macOS powerbox 會自動授予該資料夾存取權，
  fyne 自繪 picker 拿不到；未來上 Mac App Store 是硬需求）
- 同步中的圓點會呼吸 ⇒ 看得出來在動（issue #17）
- 無帳號時是 onboarding 引導，不是空白面板

## 連線邏輯逐字沿用，不重寫
connect.go 的 normalizePortalURL/fetchConfigByLogin 取自 arcrun-tray/main.go，
含 t86 個資外洩事故的防線（不同實例＝新增帳號，絕不覆蓋舊帳號的資料夾）。
今天已犯過一次「重寫別人修好的東西還修得更差」，不再犯第二次。

## 新增 check-cis.sh（交貨前必跑）
機械檢查六類：官方色票逐個到齊／**不准出現非 CIS 色**／logo 真的放進去／
不可用作廢 SVG／深色模式／字體與紙張紋理同 portal／app icon。
實跑 14 項全過。以後「沒跑過就不准交」。

⚠️ 未驗：實際畫面要 leo 開來看（我開不了視窗）。
 2026-08-04 22:19:41 +08:00
Leo cc6534dd39 t191/t192：daemon 主視窗（Google Drive 風格）＋「同步中…」進行中狀態 
解 issue #18＋#17（leo 指定併做）。

## #17 進行中狀態——真兇是「工作時間對用戶隱形」
leo：「按『立刻同步』後很快就回到『看守中』，看起來好像就做完了，
      這時使用者一看沒做完啊，就覺得是 bug」。
真兇：collector **只在一輪跑完後**才印 JSON ⇒ 托盤無從得知「正在跑」。
修：開工前先印 phase:"start"、跑完印 phase:"done"；
    supervisor 新增 StateSyncing；托盤／主視窗顯示「同步中… 正在讀檔並整理成知識卡」。
形狀相容：兩筆都有 at，舊版托盤只會多算一次 round，不會壞。

實測（真的跑一輪 --once）：
  第1筆 phase='start' at=21:31:26
  第2筆 phase='done'  at=21:31:27

## #18 主視窗（新檔 mainwindow.go）
leo：「daemon 設定項越來越多，不可能統統塞在下拉選單」
     「參考 Google Drive 設定畫面：點擊 daemon 就開一個視窗，佔螢幕約 1/2」
     「資料夾清單要可捲動——我每個 gitea 專案都要同步，那就是幾十個，根本塞不下」
- 920x620 視窗，關窗＝隱藏（daemon 續跑）
- 上：大字狀態＋副標（上次同步／已整理幾份／失敗幾份；有錯誤優先顯示）
- 中：widget.List 虛擬捲動的資料夾清單（帳號標題＋其下資料夾攤平成單層）
- 下：白話動作列（加入資料夾／新增知識庫帳號／AI 設定／檢查更新）
- 每秒自動刷新 ⇒ 同步中看得到在動
- 無帳號時引導去連線（onboarding），不是丟錯誤或空面板
- **所有動作複用既有 handler**，不在視窗那邊重寫一份邏輯

托盤選單第一項加「開啟 Arcrun…」——leo 已點破兩次
「能力做出來了，入口沒出現在用戶會看的地方」（docs 沒連結／MCP 零處提及），
這次做完就讓它看得見。

測試：t192_test.go 八則（狀態文案四態／同步中要說明在做什麼／
副標優先顯示錯誤／副標不可空白／清單攤平且 accIdx 正確／60 個資料夾／無帳號空清單）全過。
collector 與 supervisor 全套綠。

⚠️ 未驗：fyne GUI 的實際外觀需真機開窗（無螢幕環境驗不到），
   CIS 視覺套用待 leo 看過畫面再調。
 2026-08-04 21:32:31 +08:00
Leo 8c7b50d9a9 t190：Gemini 金鑰刪不掉——清空輸入框現在真的會刪除 
leo 08-04 實撞：「我切到 Gemini 把內容刪掉，再切回 Workers AI，儲存，
回去發現 Gemini Key 還在」。要求：「如果他不想留 Key 了，要可以刪除」。

真兇：cfg.GeminiAPIKey = key 寫在 if useGemini 裡 ⇒ 選回雲端 AI 時整段跳過，
舊金鑰原封不動（帳號層同病）⇒ 清空輸入框等於沒作用。

改成無條件以輸入框為準（清空＝刪除），符合使用者心智模型：
我把欄位清空並按儲存，它就該不見。頂層與每個帳號層一併清。

測試：新增 t190_test.go 兩則——清空要真的清掉（頂層＋所有帳號層）、
選 Gemini 填值時每層都要寫進去（不可被本次修改弄壞）。兩則皆過，全套綠。
 2026-08-04 20:47:32 +08:00
Leo 6275daa555 t185/t186：三站 nav bar 補齊＋自更新改走 raw（jsDelivr @main ref 解析卡死） 
## t185：用戶原本根本進不去 docs
leo：「從用戶角度看，**你沒有 nav bar 用戶怎麼進去**？」
——docs 建好了但首頁零連結，只有知道網址的人找得到＝同一個病
（能力做出來了，入口沒出現在用戶會看的地方）。

- rag／install 兩站各加同一條 nav（首頁／安裝／說明文件，當前頁 highlight）
- **下載步驟旁**另加 Mac／Windows 分流連結——入口要放在「用戶正在卡住的地方」，
  不能只靠頁首 nav

實測（線上抓 href，非只看 200）：
  rag.arcrun.dev  → /docs/、/docs/start/install-mac/、/docs/start/install-windows/
  install.arcrun.dev → /docs/

## t186：自更新改打 raw.githubusercontent（推翻 t150 二修的判斷）
真兇不是檔案快取，是 **jsDelivr  的 ref 解析（main→commit）被快取**，
 與 purge 都清不掉。08-04 三條路同時比對坐實：
  @main 1.4.9/v0.15.6（卡住，x-cache MISS,MISS 仍吐舊）／@sha 與 raw 皆 1.4.10/v0.15.7
zip 能靠改帶版本號檔名繞開，**manifest.json 檔名寫死在 code 裡繞不了** ⇒ 只能換來源。

D20 合規：t150 那輪否決 raw 的理由「那是實名讀」是**誤判**——
D20 對實名的定義是「URL 帶 token@／clone private 殼」，
daemon 這個請求不帶任何憑證＝**匿名讀**，D20:22 明列「✅ 放行，不計數」。
副效益：portal 下載按鈕本來就走 raw ⇒ 兩條路同源，不再有「下載頁對、檢查更新錯」。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-08-04 19:29:17 +08:00
Leo 9fcd82b517 v0.15.7：改名 Arcrun.app＋發 DMG（拖進 Applications）＋MSIX 正式身分 
leo 08-04：「如果當初 mac 打包就是 dmg 用拖的，現在 oscar 那裡就解決了，
如果當初 msix 就用了，現在另一個人也是更新就可以」——遠慮該在第一版就有。
原則：**用戶好用、白癡化**。

① 改名 Arcrun RAG.app → Arcrun.app（leo：「不要 rag，要 arcrun.app」）
   五處引用一起改（selfupdate.go／build-mac.sh／build-dmg.sh／t184_test.go／README）

② 新增 build-dmg.sh：DMG 內含 Arcrun.app ＋ Applications 捷徑
   ＝Mac 幾十年的標準做法，開起來就暗示你拖進去 ⇒ **從源頭讓 app 待在對的位置**。
   坑：hdiutil 預設檔案系統會把「Arcrun RAG.app」截成「RAG.app」⇒ 加 -fs HFS+ 解。
   DMG 治源頭、t184 是安全網，兩個都要（已裝在別處的人不會因改發 DMG 就自動變好）。

③ MSIX 用 .env 的正式 Partner Center 身分重打（**不是佔位值**）
   回讀 AppxManifest 逐欄驗證：
     Identity Name        Uncle6.Arcrun
     Publisher            CN=DE038286-31A5-47CF-B83F-FF6B206BF591
     PublisherDisplayName Uncle6
     Version              0.15.7.0
     仍含 PLACEHOLDER      False

實測（t184 端到端，模擬 Oscar 的情境）：
  app 放 /tmp/oscar-test/Downloads/（不在 /Applications）→ 跑更新覆蓋
  → 該處 app 變成 v0.15.7 ✅
  → /Applications 沒有被無中生有一個副本 ✅
  路徑推導三種放置位置皆正確（Downloads／Applications／Desktop）

產物 sha256：
  dmg  0eb3f76b60bf6891   mac zip f264dda7391f3006
  win  32fe44450ca77c62   msix    5bf7c911b8f3a817

⛔ 誠實標記：MSIX 能否實際安裝**這台 Mac 驗不到**（Add-AppxPackage 只有 Windows）。
   已驗的是包結構合法（unpack 過 blockmap 雜湊）＋身分欄位正確。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-08-04 18:12:53 +08:00
Leo 0021c274e8 t184：自更新蓋回「正在跑的那個 .app」——修 Oscar 更新完又跳回舊版 
leo 08-04 實撞（Oscar 截圖）：托盤顯示「🟢 新版 v0.15.6 已就緒」，
點下去重啟後**版本又是 v0.15.4**。同一套機制在 leo 機器正常。

真兇＝`selfupdate.go` 寫死 `/Applications/Arcrun RAG.app`：
  · leo 有把 app 放進 /Applications ⇒ 剛好蓋對他正在跑的那份 ⇒ 一直正常
  · Oscar 從下載資料夾直接跑 ⇒ 蓋到一個他沒在跑的路徑
  · 而且 **ditto 會自動建出該目錄並回傳成功**（實測 exit 0，非報錯）
    ⇒ 畫面說「更新完成」、版本卻永遠是舊的＝**靜默失敗**
  ⇒ 不是新舊 Mac 的差別，是 **app 放置位置**的差別（leo 機器實查證實）。

修法：改用 os.Executable() 往上推 .app（runningAppBundlePath），
更新**當前真的在跑的那份**——放哪都能更新，也不再無中生有 /Applications 副本。
找不到 .app 結構時誠實回錯，不猜路徑亂蓋（蓋錯比不更新更難查）。

⚠️ 「檢查更新」這條路**保留且必須修好**——leo：「這是我解決每次都要撞
沒簽章問題的解法，不能說它無用」。本次是修它，不是繞過它。

測試：新增 t184_test.go（不得回傳寫死 /Applications／.app 推導對三種放置位置
／ditto 靜默建目錄的認知回歸）；順手把 t182 的 TestAccountEngineLabel 改寫成
新判準（explicit 決定，非 config 殘留字串）。兩模組全綠。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-08-04 17:57:46 +08:00
Leo b1898a4530 產物同步 v0.15.6（t182 出貨打包） 
Mac／Windows 兩平台重編為 v0.15.6，含 t182 三顆修復。

實測（用**打包後的執行檔**跑，非源碼、非 mock）：
① 老 config 抹除 — 丟 leo 真 config 複本（頂層＋兩帳號皆 "gemma"、無 explicit）
   → 跑完三層全變 workers-ai、Gemini 金鑰保留、重讀仍是 workers-ai
② 真的走 Workers AI（**把 Gemini 金鑰整個拔掉**才算數）
   → 拔除頂層＋帳號層 gemini_api_key 後丟「火星座標.md」
   → 仍 ingested、卡片四段齊全（一句話定義/要點/關鍵實體/關聯）
   ⇒ Gemini 路無金鑰必失敗，故此卡只可能是 Workers AI 萃的
   ⇒ 同時證明「新用戶不填任何金鑰就能用」＝ leo 要的目的達成
③ 版本號注入：mac／win tray 皆 v0.15.6

體積（jsDelivr 20MB 單檔上限內）：
  mac zip 16M  sha256 c31803a4f56c00bc…
  win zip 17M  sha256 dbb7b0beb5136a70…

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-08-04 16:40:05 +08:00
Leo 133f5add46 t182：老 config 抹除成 Workers AI＋雲端探測——leo 實測「無卡」的真因 
leo 08-04 實測回報（更新 v0.15.5 後仍顯示 Gemini／丟 PDF 無卡），
查出來不是 Workers AI 不通，是**根本沒走到那條路**。三顆真 bug：

① 抹除只做一半（leo：「就要抹除改成用 Workers AI，如果保持 Gemini
   它不會改掉，那就是失敗的」）
   t181 只在 RunDirectOnce 改頂層記憶體值，但
   - makeAccountSubConfig 會把**帳號層**舊值蓋回來（t126「帳號層優先」）
   - 完全**沒寫回檔案** ⇒ 托盤是另一個行程，讀檔還是念 Gemini
   leo 的 config 正是頂層＋兩個帳號各留 "gemma"、無 explicit
   ⇒ 畫面顯示 Gemini、萃取也真的跑 Gemini。
   修：遷移移到 LoadDirectConfig（每次啟動必經），逐層抹除 + 寫回檔案。
   金鑰保留（Gemini 是選配不是廢除）。

② 驗證器擋掉自己的新預設
   `extractor 只能是 claude / gemma` ⇒ config 一旦寫成 workers-ai，
   daemon 直接載入失敗起不來。v0.15.5 已帶著這顆出貨。

③ 托盤標籤照 config 舊字串念（t178 的通則版）
   t178 只把 claude 這**一個**殘留值導向 Gemini，殘留 gemma 一樣脫鉤。
   改成與 direct.go 同一條判準：沒 explicit 就一律念「雲端 AI」。

＋ t182 雲端探測（leo 指定設計：「會去掃一次看雲端是否裝好，沒裝好就顯示
  workers AI 還沒通，一旦通了就顯示可用」）：ProbeWorkersAI 逐帳號探
  /portal/daemon/extract（送空 text，不燒 LLM 額度），結果寫進 status.json
  由托盤「狀態：」講白話。**不做靜默退回 Gemini**——那會讓用戶永遠
  不知道自己雲端沒更新。

實測證據（非 mock，打真實例）：
- youlin 實例萃真卡：3.67s，產出完整知識卡（一句話定義/要點/關鍵實體/關聯）
- 連測三次：3.51s / 3.34s / 3.59s（Gemini 實測 16.87s ⇒ 快約 5 倍）
- 兩個實例都已有 /portal/daemon/extract（皆回 400＝route 存在）
- 拿 leo 真 config 複本跑遷移：三層全抹成 workers-ai、金鑰留著、重讀仍是 workers-ai

測試：新增 direct_t182_test.go（抹除全層/寫回磁碟/主動選過不動/合法值/冪等）；
既有三則因預設變更而失效的斷言已更新（t108 二進位不出機的契約未放寬，仍綠）。
全套綠。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-08-04 16:29:56 +08:00
Leo cea6108924 產物同步 v0.15.5（隨 t181 出貨重建） 
.app／mac zip／collector 執行檔重建為 v0.15.5，與已出貨的 bundles
（1fc8029、release 1.4.7、mac sha a38c64bc…）一致。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-08-04 16:02:17 +08:00
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
Leo 1a3e974941 t178：托盤標籤與錯誤訊息對齊實際行為（leo 封測者實撞） 
【leo 08-04】封測者是台大資工碩士，仍搞不清楚 ⇒「一般人就完蛋了」。
他的托盤顯示「oscar · Claude」但他根本沒有 Claude，
同時錯誤說「Gemini 金鑰是空的」——**兩個訊息互相矛盾**。

① 標籤與行為脫鉤（accountEngineLabel）
   direct.go 早就把 claude 正規化成 gemma（t176：地端先只支援 Gemini），
   但標籤照 config 舊字串念 ⇒ 顯示 Claude、實際走 gemma。
   舊值來源＝雲端舊版下發後留在 config.json 的殘留（t176 擋了新寫入、沒洗舊值）。
   修：claude 也顯示「· Gemini」，與萃取實際走的路一致。

② 錯誤訊息沒說設定在哪
   舊：「請在設定裡輸入 Gemini API Key」——用戶找不到入口。
   新：「點托盤選單的『AI 設定…』貼上金鑰（免費申請：aistudio.google.com/apikey）」
   ——錯誤訊息本身就要能當 onboarding。

測試：TestAccountEngineLabel 兩則斷言翻轉成新規格（claude→仍顯示 Gemini），
並註明「若變回 · Claude 代表標籤又和萃取實際走的路脫鉤」；兩模組全綠。

⚠️ 未送達：daemon 執行檔要打包 v0.15.5 出貨才會到用戶手上。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-08-04 11:33:13 +08:00
Leo ae0a94b172 產物同步 v0.15.4（隨 t177 出貨重建） 
.app／mac zip／collector 執行檔重建為 v0.15.4，與已出貨的 bundles
（24d4418、daemon v0.15.4、mac sha 776ace79…）一致。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-08-04 10:20:09 +08:00
Leo 1e139a2e7e t177 更正：取回 08-02 的原版修法，撤掉我重寫的次級版本 
【leo 08-04 質問】「這不是先前改過為什麼又出現？你去查看 wiki，是不是你沒看 wiki 就改？」
——**是。查證屬實，而且比沒查更糟。**

【事實】08-02 commit `dde7a5b` 已完整修過這個 bug（t170 daemon 側），
但它**只在 `fix/cis-round3-landing-favicon` 分支**，`feat/daemon` 不含它。
我在 feat/daemon 上看到沒修過的舊 code，就當新 bug 從頭修了一遍。

【而且我修得比原版差】
  08-02 原版：isSemverLike 辨格式 → compareSemver **逐段整數比較**
              （能擋 "1.10.0" < "1.9.0" 這個經典坑）＋ minCloudRelease 最低版本常數
  我今天版：  只判「是不是 semver」，是就放行 ⇒ 無法表達「semver 世代的最低相容版本」
⇒ 本 commit **取回 08-02 原版**（git checkout dde7a5b -- ...），
   刪掉我另建的重複測試檔 cloudversion_test.go，改用原版在 main_test.go 的 8 則。

【測試】兩模組全綠；8 則逐項通過，含「semver 1.10.0 比 1.9.0 新（防字串比較）」
——那則正是我的版本表達不出來的。

【病根】hook 給的是 wiki grep 命中行，而那幾行**不含「已修過」的線索**
（關鍵字 compareSemver/isSemverLike 不在搜尋詞裡）。我把「hook 沒提」當成「沒人修過」，
且跳過了 `git log --all -S` 這個五秒就能做的機械檢查。
⇒ 已在頂層 InkStoneCo 補 hook：改檔時一併列出**該檔在所有分支的近期 commit**。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-08-04 09:51:48 +08:00
Leo e516e0dbce t177 修「知識庫需要更新」永遠消不掉：semver 打爆字串比較（兩份都修） 
【leo 08-04 實撞】「刷新完兩個雲端，為什麼還要我去更新？」
實測坐實**更新其實成功了**：youlin 實例 /health = 1.4.6、daemon 已 v0.15.3，
但托盤兩個帳號都掛「⚠ 知識庫需要更新（點我）」。

【真兇】版本號 08-02 由 `2026-07-31+8e83589` 改成 semver（`1.4.6`）後，
判斷式仍是 `date < "2026-07-28"` ——**字串比較**：
    "1.4.6"      < "2026-07-28" → true   ⚠️ 最新版被判過舊
    "2026-07-31" < "2026-07-28" → false  舊格式才會對
⇒ **任何 semver 都恆判過舊，更新幾次都消不掉。** 這是 wiki 事故 D，08-02 立案未修。

【修法】照事故 D 定案③「兩種格式都要認」：
semver（X.Y.Z 純數字三段）⇒ 視為新契約、不判過舊；
舊日期格式 ⇒ 維持日期比較，讓尚未更新的老實例仍被正確提示（不為修 A 而漏報 B）。

⚠️ **這 bug 有兩份**（tasks.md:2592 早就寫明），兩份都修：
  collector/cloud_version.go  的 cloudVersionStale
  cmd/arcrun-tray/main.go     的 trayCloudVersionStale

【為什麼會出貨】collector 那份**一直有測試**、tray 那份**完全沒有**
⇒ 沒有任何閘擋得住。本 commit 補上 cmd/arcrun-tray/cloudversion_test.go。

【測試證明有效，非裝飾】暫時把 semver 分支拿掉重跑 → 三個 case 立刻紅
（含「leo 08-04 實撞的那一版」）；裝回去即綠。
兩模組全測試綠（collector／supervisor／tray）。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-08-04 09:38:19 +08:00
Leo 9a7aaf3fce 產物同步 v0.15.3（隨 t176 出貨重建） 
collector/cmd/arcrun-tray 的 .app／mac zip／collector 執行檔重建為 v0.15.3，
與已出貨的 bundles（release 1.4.5、daemon v0.15.3、sha a1c890f2…）一致。

註：這批二進位早已在版控裡（前人決定），本次只更新內容不改版控策略。
⚠️ build-mac.sh 只產 .app 不產 zip——zip 要自己 ditto 打，
否則沿用舊 zip 會出貨到「改之前」的執行檔（t174 同款病，本次實際撞到）。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-08-03 23:06:18 +08:00
Leo f903a3f53f t176 daemon：LLM 設定移回地端＋托盤單一實例（leo 08-03 架構翻案） 
leo 回報 Windows daemon 三症狀，查完 ①③ 同根，根在「雲端控制地端」這個設計。

【①③ 真兇】雲端 extractor_config 是**全租戶共用一把 KV**
（arcrun:portal.ts:43 portalTenant = worker 層級變數，不分用戶），
任一處設了 claude → 所有人的 daemon 都收到 claude。沒裝 Claude Code 的機器
FindClaudeBin 失敗 → 每檔萃取 failed、一張卡都沒建；想去 portal 改回 gemini，
checkbox 卻恆 disabled（claude_available 恆 false，因 daemon 從未實作
report-capabilities 回報 → daemon_caps KV 永遠空）⇒ 用戶自己解不開。
awindhon 實證：雲端同步成功、Gemini key 有效、零張卡，config.json extractor="claude"。

【leo 裁示】「地端要用什麼模型就在 daemon 上輸入 API Key 設置，而不是雲端設置後
控制地端」「地端先限制 Gemini API Key 配合客戶要求」「雲端就是 Workers AI」。

本次（daemon 端）：
- addOrUpdateAccount 不再接受雲端下發的 extractor/gemini_api_key/llm_model，
  只收連線欄位。t126「每帳號一份萃取設定」照舊保留——t126 修的是「存在哪一層」，
  本次改的是「值從哪來」，兩者正交。
- 托盤新增「AI 設定…」：使用者自己填 Gemini API Key，寫本地 config 後立即生效。
- 萃取一律走 gemini：殘留的 extractor:"claude" 正規化為 gemma；claude 路退役。
  ⚠️ 這不是「自動偵測有無 claude」（leo 07-27 已否決的 B 案），是整條路先不支援。
- 清掉隨之死亡的 claude_bin 回寫（死代碼＝錯誤的環境信號）。
- 托盤單一實例（症狀②）：pidfile + 跨平台 processAlive。
  mac 之前不多開是借 macOS Launch Services 的巧合，Windows 沒有該層 ⇒ 每點一次多一個 icon。
  Unix 用 signal 0（EPERM 也算活著，測試抓到的實際 bug）／Windows 用 OpenProcess+ExitCode。

測試：collector 全綠、tray 全綠。5 個原本用 claude stub 的測試改走**真實 gemma 路**
（httptest 替身注入 gemmaBaseURL），不是改斷言充綠；t126②③ 兩案翻轉成
「雲端下發一律被忽略」的回歸守衛；新增 4 案 single-instance。

未送達：本 commit 只到 code，尚未打包出貨；雲端側（刪 portal AI 設定區塊、
extractor 下發、admin/extractor）未動，待部署授權。CP rag-beta 步驟仍為 ◐。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-08-03 17:48:10 +08:00
Leo 7ecd740f82 品牌 icon 落地：托盤／app／msix／landing favicon 用 leo 的 CIS 
用戶從 rag.arcrun.dev → install.arcrun.dev → 自己的 portal → 托盤，
四個地方應該看到同一個 icon。此前最不一致的就是托盤（Fyne 內建的通用
「儲存」圖示，main.go:1016 留著 TODO）。

素材真身＝InkStoneCo/arcrun-cis/（leo 用 Claude Design 做的 CIS）。

托盤（trayicon.go，新檔）
- macOS：template 單色（純黑＋alpha），系統依選單列深淺自動反色。
  ⚠️ fyne v2.5.3 只有 *theme.ThemedResource 才會走 systray.SetTemplateIcon
  （driver_desktop.go:169）；傳一般 StaticResource 會走 SetIcon＝不反色。
- Windows：完整墨底 icon（template 是 mac 專有）。
- 兩份都用 go:embed 內嵌，不讀外部路徑——打包後工作目錄不是原始碼目錄。
- 選單列用雙 chevron 而非完整方形字符：CIS 規定 26px 以下降級成 chevron，
  方塊裡的字符只佔高度 ~28%，22pt 下只剩 ~4px 會糊掉。

app 圖示
- icon.png 換成 CIS 1024 原生；icns 重產含 16→1024 全套 Retina 階梯。

msix（Store）
- 圖示改成預先產好、隨 repo 版控的 assets/store/（含 gen-store-assets.py 可重跑）。
- 修掉一個實際的變形 bug：舊版 `sips -z 150 310 icon.png` 會把方形 icon
  **橫向拉扁**成寬磚（實測產出的字符明顯變形），違反 CIS「never skew or stretch」。
  寬磚改用橫式 lockup 等比置中於墨底。
- 補 71x71／310x310／targetsize-16/24/32/48/256，manifest 一併宣告；
  BackgroundColor 從 transparent 改成品牌 Ink #17181A。

landing favicon（rag.arcrun.dev）
- LOGO_SVG 從琥珀金圓圈暫代圖換成 CIS 正式 mark（單色，CIS：彩色 chevron
  在產品裡代表「這條關係是活的」，用在 logo 會是謊話）。
- 修掉名實不符：`/favicon.ico` 過去回的是 SVG 位元組卻標 image/svg+xml
  （線上實測 200 但 type=image/svg+xml），老瀏覽器與抓圖服務畫不出來。
  現在 .ico 回真 ICO（16/32/48 三尺寸）、apple-touch-icon.png 回真 PNG（180）。
- 三個頁面（首頁/privacy/support）補上 icon link 宣告（此前完全沒有）。

⚠️ installer 這次沒動：`install.arcrun.dev` 的真身是
`installer/oauth-prototype/worker.js`（不在本分支，見 wiki decisions-summary
「installer 有兩個 worker，改錯＝白做」），另立一筆處理。

實測證據
- mac .app 執行檔內 grep 到 tray-template.png 位元組（sha f6af940d，位移 14001472）；
  Windows exe 內 grep 到 tray-windows.png（sha 59f4f1ac）；各自平台只嵌自己那份
  （另一份被 linker 消掉＝runtime.GOOS 編譯期常數，正確）。
- msix 重打包過 makemsix unpack 回讀驗證，包內 11 張圖示齊全。
- 已部署 arcrun-landing（版本 b79d19df）。繞快取實測 rag.arcrun.dev：
  favicon.ico→image/x-icon 1573B（3 icons，sha 151e645b＝與本機產出同一顆）、
  apple-touch-icon.png→image/png 180x180、首頁 head 三個 link 宣告都在。
  ⚠️ 舊版 max-age=86400 的邊緣快取未 purge（無 zone token），24h 內自然過期。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-07-31 20:43:55 +08:00
Leo 0c93475ab9 t150 二修：繞開 jsDelivr @main 的 7 天快取（否則更新機制形同虛設） 
實測（07-29）：jsDelivr 對 @main 回 cache-control max-age=604800＝**7 天**
⇒ 用戶小幫手連續七天看不到新版；下載 zip 同理會抓到舊檔 ⇒ sha256 不符 ⇒ 更新永遠失敗。
修：manifest 與 zip 下載都帶 ?t=<unix> 繞快取（實測即取得最新）。
不用 raw.githubusercontent——那是實名讀 GitHub，受 D20 頻率閘管制。
另修副作用：檔名要用去掉查詢字串的網址算，否則存成 ...zip?t=1785... 怪檔名。
 2026-07-29 22:47:46 +08:00
Leo 8dd15fbe43 t150: 小幫手自我更新（背景備妥＋重啟完成）＋版本一致性 
leo 07-29 三句話定調：
「小白不會動不動就刪除再裝新的」
「如果它都掛着，那準備好就告訴他重啓更新」
「**我要他下載多幾次他就放棄了，所以抓到一個客戶後不能讓他有機會離開**」

① 版本一致性（leo：「我的和下載下來的會是同一個嗎？」）
   真因：build-mac.sh L22／build-windows.sh L46 **只有 tray 注入版本，collector 沒有**
   ⇒ 托盤顯示 tray 的版本，實際幹活的 collector 無版本可查、可能不同版。
   修：collector 加 version/buildTime 變數與 --version 旗標；兩個 build 腳本都改為
   兩支注入同一個 LDFLAGS_VER（各 2 處）。
   驗：collector --version → v0.15.0 (build 20260729-2238)；tray 內含同一組值。

② 自我更新（leo 選 1+3：完全自動，但要有提醒與手動檢查）
   - 背景每日檢查 manifest 的 daemon 版本（單一 CDN 靜態檔，非 GitHub API，不違反不輪詢紅線）
   - 有新版**默默下載並驗 sha256**，備妥後選單變「🟢 新版已就緒 — 點此重新啟動完成更新」
   - daemon 常駐不重啟 ⇒ 不偷換正在跑的自己；使用者按一下才 ditto 覆蓋並重啟
   - 另有「檢查更新…」讓人隨時手動按（不必等每日排程）
   - 驗章不符或解壓失敗＝保留舊版不動（壞掉的 .app 比舊版更糟）
   ⇒ **封測者完全不必再下載任何東西**

驗：go build／go vet 過；三個版本比較測試通過（dev 不提示／同版不提示／新版要提示）；
未剝離符號版確認 5 個更新函式在 build 範圍內
（註：打包版被 -s -w 剝符號，用 grep/strings 驗會誤判為「功能沒進去」）。
 2026-07-29 22:40:58 +08:00
Leo 71e91aefbd chore(landing): SITE_BUNDLE_VERSION → 2026-07-29+bc507f7 2026-07-29 15:51:50 +08:00
Leo be5d6e3237 fix(t126): 萃取引擎/金鑰改每帳號一份——多帳號不再互相覆蓋 
leo：「2 個 CF 帳號一個填 gemma4 一個填 Mistral，daemon 會用誰的？別人也加就會有一樣的疑問」
實證：金鑰只有機器層一份 ⇒ 後連的覆蓋前一個。
修：AccountConfig 加 Extractor/GeminiAPIKey/LLMModel；帳號層優先、空值繼承機器層；
既有 config 遷移（頂層金鑰複製到各帳號，冪等）；連線只寫該帳號不覆蓋機器層；
托盤帳號標題顯示「· Gemini」/「· Claude」（一眼看出誰用誰）。
三模組 go test 全綠（總管親跑）。（實作＝子 CC；驗證+commit＝總管）
 2026-07-29 14:36:44 +08:00
Leo 4b60190bad fix(t113): 拿掉「暫停看守」——leo：想不出什麼場景要暫停 
同 t101 語意收斂：列入=同步、不要=刪除，沒有暫停態。tray go test 綠。
（實作＝子 CC；驗證+commit＝總管）
 2026-07-28 21:17:39 +08:00
Leo 668eb5f0b8 fix(t110 二修): 結束項加回——「fyne 自動附 Quit」是錯誤前提（leo 真機：兩個都沒了） 
教訓：runtime 生成的 UI 元素驗收只能看真選單，grep binary 驗不到；
子 CC 的框架行為研究要求實證不採信註解。tray go test 綠。
 2026-07-28 21:00:10 +08:00
Leo 921628098e fix(t110): 移除自訂「結束 Arcrun RAG」——fyne systray 自動附 Quit 造成重複 
leo 實測：選單同時有兩個結束項。fyne v2.5.3 內建 Quit 無公開 API 可改文案/抑制，
選移除自訂項（sup.Stop() 經 SetOnStopped 保障不變，Windows 同理）。tray go test 綠。
（實作＝子 CC；驗證+commit＝總管）
 2026-07-28 18:43:37 +08:00
Leo 1738acaca7 fix(t108 🔴🔴): 逐帳號同步遺失萃取設定→原文直送——三層修＋契約保險絲 
事故（leo 機 07-28 17:3x 總管現場抓到）：t104 config 重寫吃掉機器層 extractor/key、
per-account DirectConfig 不繼承 ⇒ extractor 空 ⇒ 6 筆走 rag_ingest_direct 原文出機。
修：①config 讀改寫全程保留既有欄位（帶測試）②帳號層無值垂直繼承機器層
extractor/claude_bin/gemini_api_key/llm_model/CardIngestWF/RemovedWF（帶 fake server 測試：
必須收到 rag_ingest_card 非 direct）③契約保險絲：extractor 空時非 .md/.txt 禁直送、
標 failed「萃取器未設定，已跳過（不直送原文）」——同類 bug 永不再成外洩。
三模組 go test 全綠（總管親跑）。（實作＝子 CC；驗證+commit＝總管）
 2026-07-28 17:59:42 +08:00
Leo bf1f0d9991 feat(t104): 多帳號同時看守——切換概念消滅 
leo 架構依據：「它只是一個門，幾個帳號通過它同步並沒有影響」＋
「我不是 Google Drive……不提供暫存空間，daemon 工作輕巧，多帳號只是頁簽問題」
（D-daemon-not-Drive）。
Accounts[] 每帳號獨立連線+資料夾；舊 config 冪等遷移 accounts[0]；
逐帳號同步一敗不擋全；status.json 分帳；托盤每帳號一分組；
「連上知識庫」→「＋新增帳號…」（append 非替換）；t86 切換清空退役；
t101 刪除作用於正確帳號。+873/-149、collector 5+tray 5 新測試，
兩模組 go test 全綠（總管親跑）。
（實作＝子 CC；驗證+commit＝總管）
 2026-07-28 16:45:14 +08:00
Leo f8450815d3 feat(t103): daemon 偵測雲端過舊＋托盤更新入口——連動閉環 
每輪 GET /health 取 bundle_version（5s timeout 失敗靜默）；空或日期<minCloudBuilt
→ 托盤「⚠ 知識庫需要更新（點我）」開 install.arcrun.dev；結果進 status.json。
兩模組 go test 全綠（總管親跑）。leo：「daemon 和雲端是連動的」——自此用戶只看托盤。
（實作＝子 CC；驗證+commit＝總管）
 2026-07-28 16:15:12 +08:00
Leo ef74c69023 feat(t101): 托盤刪除語意取代看守語意——leo 實測裁定 
「沒有看守這件事，只要列入就是看守，不想同步就刪掉」：
子選單「停止看守這個資料夾」→「刪除這個知識庫」（按下從列表剔除、冪等）；
「＋ 建立新資料夾並看守…」整項刪除。tray go test 綠（總管親跑）。
（實作＝子 CC；驗證+commit＝總管。此案原被誤擱置害 v0.13 漏裝＝mistakes c947e5a）
 2026-07-28 16:06:08 +08:00
Leo 77aa4c5195 feat(t98): 托盤「立刻同步」——訊號檔法零 IPC，跨平台 
leo：「無法知道到底同步了沒，可以在 daemon 上加一個立刻同步？」
tray 點擊寫 ~/.arcrun-rag/sync-now＋短暫顯示「同步中…」；collector 主迴圈 1 秒輪詢
訊號檔、有就立刻跑一輪刪檔，無則照 PollSec 排程；完成後 status.json 更新自然刷新托盤。
測試：collector＋supervisor＋tray 三模組全綠（總管親跑）。
（實作＝子 CC；驗證+commit＝總管）
 2026-07-28 15:06:08 +08:00
Leo 02833588e5 build: v0.12.0 Mac zip 重包（含 t89/t86/t77lite/t91/92）＋mistakes：zip 假綠一課 2026-07-28 12:43:01 +08:00
Leo 6c9d74d588 fix(t91+t92): 萃取狀態可見＋Finder 啟動 PATH 修正——背景執行不可見的兩題同根一起解 
leo 07-28 實測根因：Finder 起的 GUI app 只有最小 PATH（無 /opt/homebrew/bin）
→ claude 靜默找不到→整輪萃取失敗，托盤卻顯示「看守中」。leo：「我怎麼知道它有萃？」
- FindClaudeBin：LookPath 失敗後掃 4 個常見絕對路徑，找到回寫 config claude_bin
- CheckExtractor 預檢＋每輪寫 ~/.arcrun-rag/status.json（ok/fail 計數＋失敗清單）
- 托盤：引擎未就緒→「⚠ 萃取引擎未就緒：<白話原因>」；失敗>0→可點開明細；正常→「已萃 N 檔」
測試：collector＋supervisor＋tray 三模組 go test 全綠（總管親跑）。
（實作＝子 CC；驗證+commit＝總管）
 2026-07-28 12:41:41 +08:00
Leo 5e122b47ec feat(t77-lite): Windows 合併成單一 exe——go:embed 把 collector 吃進 tray 
leo 07-28：「Windows 解開有 2 個 exe，被瀏覽器擋住，如果只有 1 個，
我還可以把 exe 改成 e_e 讓朋友改回來，但現在這樣完全不行」。
做法：build-windows.sh 先編 collector.exe 到 tray 目錄供 //go:embed，
tray 啟動時 ensureEmbeddedCollector() sha256 比對後解壓到 ~/.arcrun-rag/bin/，
失敗 fallback 同層（舊版相容）；Mac 走 build-tag no-op 完全不動。
驗收（總管親跑）：PE32+ GUI exe／zip 僅 1 檔 16.9MB<20MB jsDelivr 上限／
collector 特徵字串在 exe 肚裡（grep=1）／Mac go build+test 全綠／tray 測試綠。
（實作＝子 CC；build+驗收+commit＝總管）
 2026-07-28 12:15:13 +08:00
Leo 0deef3dbd9 fix(t86 🔴): 換知識庫實例時清空看守資料夾——堵個資外洩 
leo 07-28 實測坐實：youlin 時代的資料夾被原封同步進 geek6688 新實例
（「假如我把個人的同步到官方去就很危險，個資外泄」）。
修：instanceChanged(old,new) 比 host；連線精靈成功後若換了實例→清空
WatchFolders/WatchFolder，成功對話框改為說明「因為換了知識庫，為避免把舊資料夾
誤傳到新知識庫，請重新用『＋新增知識資料夾…』選擇」；同實例改密碼行為照舊。
測試（main_test.go）：host 異同判定含大小寫/尾斜線/scheme 差異。tray go test 綠。
（實作＝子 CC；審查+commit＝總管。⚠️ manifest 沿用＝t86b 另案未含）
 2026-07-28 12:03:20 +08:00
Leo 59cf9825d1 fix(t75 ④⑤): 連線精靈不再清空輸入＋Windows 不再每幾秒閃 console 視窗 
leo 同事真機實測撞到的兩個最嚴重問題。

④ 連線失敗會清空使用者輸入（leo：「很糟糕」）
   真兇：失敗後呼叫 showConnectWizard()，註解寫著「不要把他丟回空白畫面」
   **但行為與註解相反**——它重建整個對話框，urlEntry 是全新的，
   而 cfg.CypherURL 因連線失敗根本沒寫入 ⇒ 欄位就是空的 ⇒ 使用者整段重打。
   修：改 showConnectWizardWith(prevURL, prevEmail) 帶回上次輸入，
   讓他只改錯的那個字。密碼不帶回（打錯時重打較安全，也少留記憶體）。

⑤ daemon 開著時每幾秒閃一個方框（約半螢幕）
   真兇：arcrun-collector.exe 是 console 型執行檔，supervisor 每輪 exec 起它，
   **Windows 預設會為 console 程式配可見視窗** ⇒ 每輪閃一次。
   Mac/Linux 無此概念故開發期完全沒想到。
   修：新增 hidewindow_windows.go（HideWindow + CREATE_NO_WINDOW）
   ＋hidewindow_other.go（no-op），編譯期分平台不寫 runtime.GOOS 判斷。
   註：-H windowsgui 是連結期選項(管自己有沒有視窗)，與此(管起別人時給不給視窗)
   是兩件事，兩者都要做才乾淨。

驗證：Mac 與 Windows 交叉編譯皆 exit=0 且產物生成；collector 全測試綠。
⚠️ 未真機驗——⑤ 的效果必須在真 Windows 上確認方框消失。
 2026-07-28 00:42:12 +08:00
Leo 1b58cd1a35 fix(t72): build-windows.sh 補版本注入（Mac 有、Windows 漏了）＋tray go.mod tidy 
實測抓到：Windows 版編出來 v0.10.0 命中 0——版本注入只加在 build-mac.sh，
Windows 那支漏了（我今天改的那份在 detached worktree，沒進分支）。

v0.10.0 兩平台實測：
  Mac  zip 15.92MB｜托盤 21.15MB(strip)｜collector 14.46MB(含 PDFium)
  Win  zip 16.86MB｜tray 22.40MB｜collector 15.15MB
  兩者皆 < jsDelivr 20MB
  指紋全中：v0.10.0／版本列／結束 Arcrun RAG／PDF 打不開(轉檔層)

順帶修：tray go.mod 需 tidy 才編得過（合併後又被覆蓋，撞了兩次）。
 2026-07-27 21:17:50 +08:00
Leo a0a7215d24 Merge branch 'fix/mac-build-strip-t72' into feat/daemon 2026-07-27 21:12:55 +08:00
Leo 90b6de66bc feat(t72): daemon 加版本編號（leo 07-27：沒版本號＝只能靠 shasum 對帳） 
病根：在此之前無法從畫面看出裝的是哪一版。07-27 花大半天對帳
「leo 手上／鏡像上／剛編的」是否同一顆，只能 shasum 比對 binary；
使用者更做不到這件事，回報問題時我們也不知道他跑的是哪版（t63 三層落差）。

做法：
- main.go 加 version/buildTime 變數，build 時 -ldflags -X 注入，未注入顯示 dev
- 托盤選單「結束」正上方加停用態版本列（回報問題時眼睛已在那一區）
- build-mac.sh / build-windows.sh 同一套：VERSION 環境變數 > git describe > dev

實測（兩平台各實跑一次 VERSION=v0.9.0）：
  Mac  托盤 21.1MB／zip 12.43MB／v0.9.0 命中 3／版本列 1／結束 1／連上知識庫 1
  Win  zip 13.27MB／PE32+ GUI／v0.9.0 命中 3／版本列 1／結束 1／連上知識庫 1
  兩包皆 < jsDelivr 20MB 上限

未驗：選單版本列的實際顯示（Mac 需 leo 點選單、Windows 需真機）。
 2026-07-27 19:46:19 +08:00
Leo 1c48d58789 fix(t72/t63): build-mac.sh 加 -s -w——Mac 版掉進 jsDelivr 20MB 內，免拆檔 
真兇：fyne package 內部自己 go build，吃不到 -ldflags，產出含符號表+DWARF 的胖執行檔。
解：②b 用 -s -w 重編托盤覆蓋回 bundle；collector 也一併 strip。

實測（從乾淨狀態重跑 build-mac.sh）：
  托盤   28.6MB → 21.1MB
  整包zip 21.1MB → 12.43MB  ← 遠低於 jsDelivr 20MB 上限
  功能指紋 結束 Arcrun RAG=1 / 連上知識庫=1（未掉功能）
  codesign -v 通過

影響：此前 Mac 版超 20MB，jsDelivr 直接回 File size exceeded，只能走 raw；
現在可走 CDN，且**免除原本要拆檔（tray/collector 分開）的工程**。
Windows 版 13MB 本來就在限內，不受影響。

未驗：真機執行行為（托盤 icon/選資料夾）——strip 不影響邏輯但仍需真機確認。
 2026-07-27 19:31:30 +08:00
Leo 26dd6960c2 feat(t72): Windows 交叉編譯腳本——Mac 上就編得出 Windows 托盤（推翻「要真機」假設） 
任務板一直寫「fyne GUI 沙箱編不了 CGo+GL → 歸屬真機」，本機實測推翻一半：
裝 mingw-w64 後 Mac 直接交叉編譯成功，不需 Windows 機器/Docker/fyne-cross。

  CGO_ENABLED=1 GOOS=windows CC=x86_64-w64-mingw32-gcc \
    go build -ldflags "-H windowsgui -s -w"
  → PE32+ executable (GUI) x86-64, for MS Windows

正確說法是「編得出來、但驗不了」——編譯是 Mac 的事，跑起來對不對才是真機的事。

另兩條路實測皆失敗（訊息留在文件）：
- CGO_ENABLED=0 → go-gl/gl 無 non-cgo 實作
- CGO_ENABLED=1 無交叉編譯器 → 退回 host clang 報 -mthreads 不支援

體積（解掉 t72 的 zip 疑慮）：tray 加 -s -w 40.8MB→23.5MB、collector 6.5MB，
zip 合計 13.9MB＝在 jsDelivr 20MB 上限內，Windows 版不會踩到 Mac 版那個坑。

腳本已實跑通過。⛔ 未驗＝托盤 icon/選資料夾對話框/SmartScreen 實際行為（要真 Windows）。
詳 system-dev/docs/3-specs/rag-wave1/windows-build-and-os-split.md

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
 2026-07-27 18:34:59 +08:00
Leo fedb765742 feat(t52): per-folder 庫章——DirectConfig.libraries 對映＋libraryFor()（資料夾名 slug／中文退後備／明列優先，go test 綠）；兩支 ingest workflow 的 post_block metadata 補 library（真兇：blocks 沒蓋章＝兩資料夾全歸 general）；托盤連線時回報庫自動登記 2026-07-26 01:53:44 +08:00
Leo 3675f38e59 fix(daemon/t55): 托盤補「結束 Arcrun RAG」——leo 07-26 實撞沒有出口（關窗只隱藏、LSUIElement 無 Dock 右鍵、只剩強制結束）；結束前先 sup.Stop() 不留孤兒 collector 2026-07-26 01:12:57 +08:00
Leo 3174340c4c feat(daemon/t54): 連線精靈——首次啟動輸入知識庫網址＋帳密，自動換取設定並開始看守（不再需要下載 config.json 丟隱藏資料夾）；portal→cypher 子域自動換算、三種輸入格式實測可用；選單加「連上知識庫…」供換帳號 2026-07-26 00:16:58 +08:00
Leo 125377b899 feat(daemon-beta t26): 托盤選單顯連線身分（暱稱>email>未設定），CF 全程隱形 
- directConfig/DirectConfig 加 Email、InstanceName（選配）欄，兩結構同形
- rebuildTray 選單頂加 disabled「連線中：<暱稱||email||未設定>」列；
  有 cypher_url 再加一行縮短 host（fyne MenuItem 無 tooltip，取捨見註解）
- connectionStatusLabel/shortCypherHost 抽純函式，3+3 案 table test
- go vet + go test 全綠（collector 43 通、tray 10 通）；tray go build 過
 2026-07-24 17:59:01 +08:00
Leo b9d880413d feat(daemon-beta t14/t15/t17): supervisor log 檔＋removed 清本地卡＋托盤建新資料夾 
- t14 supervisor：子行程 stdout（tee）/stderr 全落 ~/.arcrun-rag/collector.log，
  >5MB 改名 .old 重開（兩代輪替）；落 log 失敗一律吞掉不擋看守。新增 2 測試
  （輸出進檔＋輪替觸發）。
- t15 direct removed（extractor 模式）：雲端 takedown 2xx 後同步刪本地
  system-dev/wiki/cards/<頁名>.md（存在才刪；刪失敗只記 warning 不擋）。
  新增 2 測試（刪原檔→本地卡被清／卡已不在照常下架）。
- t17 arcrun-tray：tray 選單＋設定視窗加「建立新資料夾並看守…」——
  widget.Entry 輸入名稱→ ~/ 底下 mkdir（已存在沿用；擋路徑分隔與 ..）→
  addWatchFolder＋saveConfig＋重啟看守＋rebuildTray。

collector: go vet ✓、go test -count=1 ./... 43/43 綠；arcrun-tray: go build ✓（產物已刪）

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-07-24 15:06:21 +08:00