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

8 Commits

Author SHA1 Message Date
Leo aeb44c712b fix(88): 撤回「產生端吐裸號」的宣稱——那個 v 是版本線判別器，不能單獨拿掉 
總管複驗退回一格（`inkstone/arcrun-rag#88#issuecomment-3082`），退得對。
我照他要的兩條路去查，結論是**選 B，而且原本那個改動本身有 bug**。

## 兩件事要分開講

**① 總管的事實宣稱有一處錯，但他看到的現象是真的**
「這條分支一行都沒動 daemon-version.py」— 不對，上一個 commit 動了 37 行，
含 `version = "v%d.%d.%d"` → `"%d.%d.%d"`。他跑 `daemon-version.py` 得到 `v0.18.29`
也是真的：當時的過渡規則讓「重打已發佈的版本」沿用原本寫法。
⇒ 他跑對了指令、看到真東西，只是把原因歸成「沒改」。

**② 但我的改動確實有 bug，而且比他指出的更嚴重**
`^## v` 這條判斷式有**四份各自為政的拷貝**（daemon-freshness／daemon-in-bundle-gate／
ship.mjs daemon-sync／daemon-version.py），三份只認帶 `v` 的。
產生端一旦戳出 `## 0.18.30（…）`，那三份**不會報錯**，而是往下比對到更舊的
`## v0.18.29（…）` ⇒ **打包出 0.18.30 的執行檔，manifest 卻宣稱是 v0.18.29。**
版本號說謊，靜默，21 站全綠。上一個 commit 就埋著這顆。

## 為什麼不是把三份放寬成 `v?`（我試了，當場被測試擋下）

🔴 **那個 `v` 目前身兼「哪一條版本線」的判別器。**
放寬後 daemon 的閘開始把雲端那條 `## 1.4.47（…）` 當成 daemon 版本撈走
⇒ `daemon-in-bundle-gate.test.mjs` ①⑮⑯ 轉紅，而它們釘的正是 D95 第二輪剛修好的
「出貨線指到錯的 changelog 卻安靜放行」。`daemon-notes.changelogRelFor()` 也用 `/^v/`。

⇒ 「不要 v」要落到產生端，得**先給那些閘一個替代判別器**
  （建議拿 `DAEMON_LINE` 比對，例 `^## v?0\.18\.\d+（`，同時擋「錯的檔」與「錯的線」）。
  那要動 `topReleasedVersion()` 等對外簽章、跨 installer/ 與 collector/，
  **與正在進行的 collector 拆 repo 相衝** ⇒ 不在這條分支做。

## 這個 commit 做了什麼

- 產生端**恢復原行為**（一律吐 `v`）：不留「產生端裸號＋閘只認 v」那顆靜默炸彈
- 四份拷貝**收成一份**（`daemon-notes.DAEMON_RELEASED_RE`，維持嚴格版）
  ⇒ **零行為變更**，但哪天要改格式只需改一個地方，而不是記得改四個
- 把「為什麼還不能改裸號」釘成一支會說話的測試（`daemon-version.test.mjs` ⑤⑥）
  ——不是註解，是紅燈
- 兩處註解寫清楚接手要先做什麼

**上一個 commit 的另外兩格（release 掛成品、內外對應）未受影響，總管已複驗通過。**

測試：installer 252/252、collector 6/6。
 2026-08-18 15:25:22 +08:00
Leo 2e26528bc9 feat(version): 對外號真的不帶 v ＋ release 掛得動成品 ＋ 內外對應由機器產生（arcrun-rag#88） 
leo 2026-08-18 當場抓到「剛剛不是說不要 v？」——實查確認不是措辭問題：
規約寫在 wiki，而**產生號碼的那條路照舊帶 v**。這輪修的是產地與載體。

① 對外號從**產生端**就是裸的
   `daemon-version.py` 是 daemon 那條線唯一的版本產生器，一路長到
   產物檔名（Arcrun-<版本>.dmg）、manifest.daemon.version、/api/latest。
   - 新戳的版本一律裸號；`RELEASED_RE` 加 `v?` 讀得懂歷史
   - 🔴 重打同一版**沿用 changelog 上原本的寫法**：selfupdate.go 的
     newerThanCurrent() 是字串不等於就提示更新 ⇒ 把 v0.18.28 改吐成 0.18.28
     會讓每台已安裝的機器收到一個內容相同卻宣稱是新版的**假更新**。
     規約會自己過期：頂上那段變裸號之後，重打路徑吐的也是裸號。
   - 實測：真實 changelog ＋一段未發佈 → 產生器吐 `0.18.30`（不是 v0.18.30）

② release 掛得動真的成品（本輪的硬前置）
   leo：「assets 都寫 source code，這兩個附檔實際是什麼？是 dmg 還是 go？」
   ——那是 Gitea/GitHub 自動產生的整包 repo 快照。實測既有 release 的
   attachment 數是 **0**，坐實那兩個附檔沒有一個是成品。
   - gitea/github-release.mjs 各補 uploadReleaseAsset／listReleaseAssets
     （兩邊 API 形狀不同是 API 本身的差別，不硬套成同一種）
   - release-lines.mjs 讓**每條版本線各自宣告**自己的成品（assetKeys）；
     daemon 線明列 mac/win/msix，**排除釘在 0.15.7 的兩筆歷史遺留**
     ——照「有 file 欄就掛」會把舊檔掛上新版頁面，正是本輪要治的病
   - ship.mjs 建完 release 後掛檔，並**回頭查證**附件真的在頁面上；
     缺任何一個就擋（不留「點下去沒東西」的版本頁）

③ 內外對應由機器產生，不再是總管手寫
   leo：「對應關係記在該次發佈的 release note，不靠號碼本身編碼」
   - 新增 internal-version.mjs：`RAG-20260818-001-<commit7>`
   - 🔴 `formatInternalVersion` 收到空的 artifacts 直接丟例外
     ⇒ **算不出一個沒有成品的內部號**（leo：「內部每次就要出貨 bundle 的版本」）。
     ops-facts 原本記著「這件事目前靠自律，沒有機械閘」——這就是那道閘
   - 序號從**既有 release 的事實**算，不養會漂的帳；tag 與內文都掃
     （08-17 那兩筆內部號寫在 tag_name 上，只掃內文當天會從 1 重編、無聲撞號）

紅線遵守：既有 tag／檔名一個都沒回頭改；沒寫 GitHub（②③ 實測都在 Gitea）；
沒部署、沒推 main、沒自己併分支。演練建的 release 與 tag 都已刪除複驗。

測試：installer 252 支全綠（原 233 ＋新 19）；collector 產生器新增 6 支全綠。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
 2026-08-18 15:13:00 +08:00
Leo bd25efaae5 refactor(collector): 剪掉臍帶——collector/ 自己就算得出自己的版本號（D95 第一輪②） 
leo 2026-08-17：「身為管理者，你要從頭到尾**不要有很多扭曲**，因為你根本不記得
你做的這些扭曲，**每次都要查**，很直接，源碼、產出物，從 stage 到 prod。」

`collector/` 原本要伸手到 repo 根才算得出自己的版本，共四條：

  ① `daemon-version.py` 讀 `docs-site/src/content/docs/help/changelog.md`
  ② `daemon-version.py` 讀 `ROOT/DAEMON_LINE`
  ③ `daemon-version.py` 的原始碼指紋從 repo 根 `git ls-files collector`
  ④ `changelog-section.sh` 讀 `$REPO_ROOT/docs-site/...` 並 exec
     `$REPO_ROOT/installer/scripts/daemon-notes.mjs`
  ⑤（複驗才發現的第五條）`build-msix.sh` 用 `git rev-parse --show-toplevel`/../../.env
     推 InkStoneCo 頂層拿 MS Store Identity

現在全部落在 `collector/` 內部：

  · `collector/CHANGELOG.md`  ← 新家。**原檔同時裝著兩條版本線**
    （桌面版 `v0.18.x` ＋ 雲端引擎 `1.4.x`），已按版號格式拆開；
    雲端那 17 段原地不動留在 docs-site，桌面版這 30 段搬過來。
  · `collector/DAEMON_LINE`   ← 從 repo 根搬進來
  · 指紋改以 `collector/` 為根算（`cwd=COLLECTOR`、pathspec `.`）
    ⇒ 相對路徑前綴變了、而路徑有進雜湊 ⇒ `FINGERPRINT_ALGO` 3→4，
      照既有設計讓帳本自動整本作廢重記（不要手改 JSON）
  · `daemon-notes.mjs` 實作搬進 `collector/cmd/arcrun-app/`，
    `installer/scripts/daemon-notes.mjs` 變薄殼轉呼叫
    ⇒ **根可以往內伸手，collector 不可以往外伸手**，方向單向
  · `build-msix.sh` 改成往上找「帶著那把鍵的 .env」，
    leo 08-06「腳本自己去讀不要再問人」原樣保留，但不再綁目錄結構

驗收閘：`collector/check-standalone.sh`——不是 grep，是**行為證明**：
把 collector/ 的檔案單獨複製到 repo 之外的臨時目錄、在那裡 git init，
再跑版本計算與打包前置閘。跑得起來＝真的自足。

自己發現並修掉的三件：
  · `arcrun-tray/assets/store/` 與 `--setup` 其實還活著（見上一顆 commit）
  · 兩支同名的 `daemon-notes.mjs` CLI 守衛比的是**檔名尾綴**
    ⇒ 兩支一起開火，問雲端版號時 collector 那支先 exit(1)，
      薄殼根本沒機會查 docs-site。改成比絕對路徑。
  · `collector/CHANGELOG.md` 的「怎麼出新版」說明若照抄那行標題，
    會被 `daemon-version.py` 的純字串比對當成「有待發佈內容」而誤升版
    ⇒ 說明裡刻意不寫成真的標題，並把這個邊角寫在檔案裡

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
 2026-08-18 13:05:33 +08:00
Leo 5c0bddacc4 v0.18.20：失敗清單改摺疊式＋修指紋閘的自我參照 
## UI（leo 實測版面被壓扁）
失敗清單改用原生 `<details>`：只列檔名、旁邊三角形、**預設收合**，
點開才看原因。先前把原因攤在檔名旁邊，中文檔名被擠成一行一個字。

## 🔴 指紋閘三修：帳本自己不能算進指紋（經典自我參照）
`.version-source.json` 就住在 `collector/` 底下 ⇒ 戳版號寫入它、指紋跟著變
⇒ **同一輪連續打 win/mac/msix，第二支就被自己的閘擋下**（實撞）。
查證過才修（沒有亂放寬）：
  · `gen-icons.py` 產的 .ico **位元一致**，不是它
  · `dist/` 早就 gitignore，不在名單裡
  · 真兇只有帳本
⇒ **只排除帳本一個檔**。一度想順手排掉整個 `build/`，那會讓「換 app icon」
  不算原始碼變更＝在閘上挖洞，已收回。
驗：連跑兩次版本號相同（冪等）。

## 三種產物都備齊（在共用資料夾）
`Arcrun-win-v0.18.20.exe`／`送審用/Arcrun-v0.18.20.dmg`／`送審用/Arcrun-v0.18.20.msix`
⚠️ MSIX 的 **Identity 三值仍是佔位**（`PLACEHOLDER.ArcrunRAG`）⇒ **不能送 Store**，
需 leo 從 Partner Center 提供 `IDENTITY_NAME`／`PUBLISHER`／`PUBLISHER_DISPLAY` 再重打。

## 未送達
線上仍 v0.18.8。推遠端需 leo 開 D20 閘。
 2026-08-06 22:39:42 +08:00
Leo 6e0b65a2bb mistakes：Workers AI 額度用完／掃描版 PDF——兩個「不是 bug 但要說清楚」的已知現象 2026-08-06 20:48:01 +08:00
Leo 6698f9fbda v0.18.10：讓「同步引擎沒在跑」說出死因（leo Windows 實測①②的診斷前置） 
leo 08-06 Windows 回報：「一直在『看守中』和『沒有在跑』中間閃，要我重啟但重啟無效，
我覺得它在跑個迴圈不停重複」＋「加一個資料夾明顯沒產生看守資料夾」。
朋友的一般 PC（非 ARM）也一樣，停在等待中 ⇒ **不是 ARM 模擬的問題，是 Windows 通用**。

## 已定位的機制（不是根因，是「為什麼查不出根因」）
閃爍＝子行程一啟動就死 → supervisor 退避重拉 → 狀態在 Starting（alive=true）與
Error（false）之間彈跳 ⇒ 畫面跟著閃。而**死因一直被記在 Status().LastError 裡，
從來沒有上過畫面、也沒寫進 app.log** ⇒ 使用者只看到閃爍與「請重新開啟」，
重開當然無效（死因沒變）。這是「安靜地略過」的同一種病換地方發作。

## 這版做的
- 死因上畫面：重試 >= 3 次改顯示「同步引擎一直啟動失敗，已自動重試 N 次｜原因：…」，
  且**黏住不閃**（不受重起過程中的 Starting 影響）
- 每次異常結束寫進 app.log（同錯誤 10 次內只記一次，避免洗爆）

## 排除掉的嫌疑（查過，不是）
- PDF 引擎（pdfium/wasm）：**延遲初始化**，第一次讀 PDF 才啟動 ⇒ 不會在啟動時炸
- ARM 模擬：leo 朋友的一般 x64 PC 同樣症狀
- 待查嫌疑：Wails 的 Windows 版是 `-H windowsgui`（GUI subsystem，無主控台），
  而 v0.18.8 的 collector.exe 是 `go build` 的 console subsystem——
  v0.18.9 合併成單一 binary 後，子行程換成 GUI subsystem 的自己。**尚未證實。**

## 順帶修好自己的閘（它擋對了我）
指紋閘擋下「v0.18.10 已對應另一份原始碼」——因為第一次打包失敗、版號卻已被戳。
⇒ 加判準：**磁碟上沒有該版號產物＝從未出貨，允許重戳**（不用去手改 JSON，
那種爛示範遲早被改成「都放行」）。

## 安裝程式（leo ③）尚未兌現，誠實記錄
`wails build -nsis` 需要 makensis；Homebrew 的 3.12 在這台 macOS **連兩行的最小腳本
都在寫檔階段丟 std::bad_alloc**，zlib/bzip2/lzma 三壓縮器全崩，brew extract 舊版
被 homebrew/core 擋。且帶 -nsis 會讓 wails 整個中止、連 exe 都不產
⇒ build-win.sh 改成**先煙霧測試 makensis**，壞的就只出裸 exe 並大聲警告。
 2026-08-06 18:27:08 +08:00
Leo 0b8bc83bd1 版本指紋閘（同一版號只准一份原始碼，實測有效）＋落帳封測兩病與 md 真相 2026-08-06 16:17:40 +08:00
Leo b783b870e6 版本號改由 changelog 決定：從頭到尾沒有人打過數字，且與更新內容天生綁定 
## 為什麼推翻自己幾小時前的做法
上一版用「動過 collector/ 的 commit 數」當 patch。確實不用手打，但
**每個 commit 都變成一版**（一天 5 個 commit 就跳 5 版），
每跳一版還要補一段 changelog ⇒ 把機械化變成新的手工活。leo 要的不是這個。

## 現在的機制（daemon-version.py）
單一真相源＝docs-site/.../help/changelog.md：
  · 要出新版 ⇒ 最上面加一段 `## 下一版（未發佈）`，底下寫白話更新內容
  · 打包時腳本把它**戳成正式版號**（上一版 patch+1）並補今天日期
  · 沒有「未發佈」段 ⇒ 版本＝最上面那一版（重打同一版，冪等不虛增）
⇒ 版本號沒有人打過；且不可能「升了版卻沒人知道改什麼」，
  也不可能「寫了內容卻忘了升版」——兩者出自同一段文字。
換線（0.18→0.19）只改 DAEMON_LINE，下一版自動從 0.19.0 起。
刪掉 daemon-version.sh 與 DAEMON_PATCH_BASE（一版的殘留）。

## 驗（實測輸出）
· `## 下一版（未發佈）` --stamp→ `## v0.18.7（2026-08-06）`（腳本自己改的）
· 沒有未發佈段時重跑 → 仍回 v0.18.7（冪等，不虛增）
· ./build-win.sh 全程通 → dist/Arcrun-win-v0.18.7.exe（27,445,248 bytes）
    strings 抽內嵌版本 = v0.18.7
· ./build-dmg.sh 全程通 → dist/Arcrun-v0.18.7.dmg（10M）
    掛載後 strings 抽 App 內嵌版本 = v0.18.7
    Info.plist CFBundleShortVersionString = 0.18.7（以前永遠是 1.0.0）
⇒ **兩條打包線第一次在同一個版本號上對齊**——這正是 08-06 那個病
  （只重打 Mac DMG、Windows 沒動、manifest 卻宣告新版）的根治。
· 未驗：Windows／Mac 真機行為；未出貨 ⇒ ◐
 2026-08-06 13:16:14 +08:00