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

7 Commits

Author SHA1 Message Date
Leo 80877af60c sync: collector/ 同步自 inkstone/arcrun-rag@740c55c（桌面小幫手 0.18.44） 2026-08-28 03:46:42 +08:00
Leo fcf00bb5df v0.18.11：修好 Windows「裝了完全不會動」的真兇——全新 config 缺 manifest 欄位 
leo 08-06 提供決定性線索：**exit status 2，已自動重試 21 次失敗**。

## 真兇
`app.go` 的 `saveCfg` 只寫四個鍵（accounts／extractor／extractor_explicit／
gemini_api_key），**從來不寫 `manifest`**。
而 `manifest` 是 collector 的必填欄位（`direct.go`：
`if c.Manifest == "" { missing = append(missing, "manifest") }`）
⇒ 讀 config 失敗 → `runDirect` 回 2 → supervisor 無限重拉
⇒ ①「看守中／沒有在跑」一直閃、重開無效（死因沒變）
⇒ ②加資料夾沒反應（collector 從沒跑完一輪）

## 為什麼一路活到封測
**開發機的 config 是舊版留下的、早就有這一欄。**
只有「從零長出 config」的機器才會撞到——也就是**每一台封測者的機器**。
「我這台好好的」正是這個 bug 能活下來的原因。
⇒ 新測試 `TestFreshConfigIsUsableByCollector` **從零建 config**，
   並且不只驗欄位在不在，而是**真的餵給 `collector.LoadDirectConfig`**。
   已反向驗證：把修正拿掉，測試會紅（不是假測試）。

## 順帶修好「為什麼只看得到 exit status 2」
supervisor 在行程結束時用 `cmd.Wait()` 的錯誤當訊息，
**蓋掉**了 stderr 剛寫進 `LastError` 的那句真話
（`collector direct: config 缺必填欄位：manifest`）。
⇒ 改成以 stderr 為主、退出碼放括號補充。
（v0.18.10 已讓死因上畫面＋進 app.log，這版讓那句話是**對的**那一句。）

## 三種 exit 2 的實測輸出（重現測試打出來的，非推測）
- config 不是合法 JSON → `config JSON 解析失敗：invalid character …`
- 缺必填欄位 → `config 缺必填欄位：manifest, accounts（或 cypher_url 連線設定）`
- Windows 反斜線路徑 → 正常解析（**排除「反斜線害的」這個猜測**）

## 驗
collector 全測試過、app 測試過、mac+windows 皆編得過；
產物 `Arcrun-win-v0.18.11.exe`（22M）已放 leo 桌面。
⚠️ **尚未真機驗**——要 leo 在 Windows 全新裝一次才算通。
 2026-08-06 18:41:31 +08:00
Leo 4d3a6a09a6 v0.18.9：collector 併進同一支執行檔——磁碟上不再攤出第二支 exe 
leo 08-06 裁決：「不要兩支，寫成一支檔案」。

## 為什麼
v0.18.7-8 的「單一 exe」其實是**一支包著另一支**：collector.exe 被 go:embed
進 Arcrun.exe，執行時攤到 ~/.arcrun-rag/bin/ 再跑。
那正是防毒軟體眼中的 dropper 特徵 —— 封測者實撞
`Trojan:Win32/Sabsik.FL.A!ml`，檔案當場被隔離、自動刪除。

⚠️ 誠實界定：`!ml` 結尾＝**機器學習判定**，Sabsik 是最常見的通用誤判家族，
   主因是「未簽章＋下載次數少」，**不是**特別指向 dropper 行為。
   所以本次改動**不保證**解除誤判——真正的解是上架 MS Store（微軟簽章）。
   但「執行時把第二支 PE 寫到磁碟再執行」本來就該拿掉，這是對的方向且順手變小。

## 怎麼做
- `collector/` 39 個檔 `package main` → `package collector`，`main()` → 匯出的 `Run(args) int`
- 新增 `collector/cmd/collector/`（薄殼 CLI，讓單獨跑 collector 這條路仍可用）
- App 直接 import 該套件；`main()` 第一件事就判 `--collector`，是的話走 `collector.Run` 不碰 GUI
- `supervisor` 加 `ArgPrefix`，App 把 `BinPath` 指向 `os.Executable()` 自己
- 刪掉 `bundled_collector_{windows,other}.go`（embed + 攤檔那套）
- 三支打包腳本不再編/複製第二支；版本注入同時打到兩個 package
- build-win.sh 的機械閘改成**直接問它**：`--collector --version` 回得出版本才放行
  （舊閘是比大小，只能證明「有 embed」，證明不了「分派是對的」）

## 驗（真機實跑）
· `.app/Contents/MacOS/` 只有 **一個** 執行檔（原本兩個）
· 跑起來兩個行程是**同一個 exe**：
    …/MacOS/arcrun-app
    …/MacOS/arcrun-app --collector direct --config …
· `~/.arcrun-rag/bin` **不存在**（沒有任何東西被攤出來）
· 端到端：丟檔進看守資料夾 → collector.log `"status":"ingested","http_status":200`
· `lsappinfo` 仍是 `type="UIElement"`、`Version="0.18.9"`
· collector 39 檔測試全過；app 測試過；go vet 全綠；mac + windows 交叉編譯皆過
· 單檔 26MB → 22MB（不再夾帶第二份完整程式）
 2026-08-06 16:00:47 +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 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 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
cloud-worker 9e356e3d99 feat(daemon/p04): fyne 托盤殼 + collector 看守器（CP-1 第6關產品化，leo 定 fyne） 
leo 2026-07-21 回「fyne」。交付「可交付的殼」：
- collector/supervisor（純 stdlib，無 fyne）：看守 collector direct 子行程、串 stdout JSON 出
  狀態（看守中/上次同步/出錯自動重試/已暫停）、崩潰重起、Stop 同步等 loop 收掉（修 Stop→Start
  換資料夾時舊 loop 覆寫新狀態的 race）。**sandbox `go test -race ./... 全綠（6 測，含 race）**，
  既有 collector 測試零回歸。
- collector/cmd/arcrun-tray（獨立 module，隔開 fyne CGo 依賴）：選單列/系統匣 icon＋狀態＋
  選資料夾(原生對話框)/暫停·繼續/打開資料夾；關窗縮背景；watch_folder 預設 ~/ArcrunRAG 避開
  ~/Documents 的 TCC 禁區；wires supervisor。

誠實界定（mindset §7）：
- **in-process vs 子行程**：leo 偏好 in-process，但 collector 是 package main，真 in-process 需抽核心成
  library（動已驗引擎有回歸風險）→ 本版走子行程看守（collector 零改、崩潰隔離），行為對用戶相同；
  in-process 抽取列可選後續，待 leo 裁。
- **fyne GUI 沙箱編不了**（CGo+GL）→ build/簽章/TCC 授權＝leo/地端真機做（紅線②③）；
  fyne API 細節以首次真機 build 為準。README 附建置/簽章/TCC 交接。
 2026-07-21 09:27:55 +00:00