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

9 Commits

Author SHA1 Message Date
Leo a02eed539a t194 三修：右鍵選單——正解是「**少寫**一段」，不是再補一段 
leo 實測：右鍵仍然沒有 quit 選單。

## 真兇：我把函式庫本來就會做對的事，換成一個更脆弱的版本
讀 systray_darwin.go 的 systray_on_rclick()：

    func systray_on_rclick() {
        if onRClick != nil { onRClick(st) } else { C.show_menu() }
    }

⇒ **沒註冊 SetOnRClick 時，函式庫自己就會把選單叫出來**；
   而且 C 層的 show_menu 內部已經處理好整套：
   create_menu() → [statusItem.button performClick:nil] → set_menu_nil()

我卻註冊了自己的 handler、還加 `if menu != nil` 防呆
⇒ 等於用一個判斷把「本來會動的預設行為」擋掉。

修：**刪掉 SetOnRClick 註冊**。左鍵仍自訂（要開視窗），右鍵交還函式庫。

## 判準（已寫進 mistakes）
用第三方函式庫時，**先讀它的預設行為再決定要不要覆寫**。
「多註冊一個 handler」看起來是加功能，實際上常是**關掉**原本正確的行為。

## 閘也跟著改
check-tray.sh 原本驗「SetOnRClick 有註冊且順序對」——**那是在守一個錯的寫法**。
改成反向：**出現 systray.SetOnRClick 就擋下**，並說明原因。
實跑 7 項全過；App 活著 pid 14081、crash 0。
 2026-08-05 02:27:23 +08:00
Leo c400292c01 新增 check-tray.sh：托盤行為的機械閘（交付警察攔下後補） 
leo 真機測出的四個 bug **編得過也跑得起來**，只有真的去點才會發現；
我改完只驗「build ok」就想交 ⇒ 把「點不下去的部分」用可機械檢查的前置條件守住：

① template icon：22/44 RGBA、**不透明 <50%**（否則會顯示成方塊）、顏色種類
② 呼叫順序：AddMenuItem → SetMenuNil → SetOnClick/SetOnRClick
   （順序錯＝滑鼠事件全失效，正是 leo 撞到的②③）
③ ShowWindow 必須有 Unminimise/Show/SetAlwaysOnTop 三者（缺一就叫不回被蓋住的窗）
④ 結束路徑：有 signal.Notify＋waitCollectorGone（否則只能強制結束、留孤兒）

實跑 7 項全過。這支＋check-cis＋check-render 三支都要過才准交。
 2026-08-05 01:47:58 +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 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