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

4 Commits

Author SHA1 Message Date
Leo 681f9a10c8 WIP(88): 產生端裸號——agent 被 API 中斷前的進度，總管代存 
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
 2026-08-18 16:14:20 +08:00
Leo 3af210e03a docs: 版本說明頁刪除，改連 GitHub 版本發佈（arcrun-rag#41） 
leo 2026-08-17：「這個頁面刪除。」
（同一件事 08-09 就講過：「不要同步，docs 的版本說明直接連回 github 的版本發佈」，
 那時記在該檔檔頭當待辦，理由是「等 releases 累積出足夠版本歷史」——現有 9 筆，理由失效。）

使用者要看版本紀錄 → github.com/youlinhsieh/arcrun-rag/releases。文件站不再自己維護一份。

── 🔴 動手前發現的事：那一頁不只是一頁 ──────────────────────────────
`docs-site/src/content/docs/help/changelog.md` **同時是兩個東西**——文件站的一頁，
以及**雲端引擎 `1.4.x` 的出貨原稿**（`installer/scripts/daemon-notes.mjs` 的 `CHANGELOG_REL`，
被 `ship.mjs` 的 docs-changelog／release-record 與 `github-release.mjs` 讀）。
直接 `rm` 會讓雲端那條線的 GitHub／Gitea 版本發佈點進去變空白。
⇒ 頁面刪掉，**原稿搬去 repo 根的 `CHANGELOG.md`**（旁邊就是根的 `RELEASE_LINE`），
  形狀與桌面版那條線一致：`collector/CHANGELOG.md` ＋ `collector/DAEMON_LINE`。
  `collector/CHANGELOG.md` 一個字都沒動。

── 投影機制整套拆掉（0fb72ae，D95 第四輪，昨天才併進 main）──────────
它存在的唯一理由是把 daemon 段落渲染回這一頁。頁面沒了，它就是沒人用的機制：
  · `docs-site/remark-daemon-changelog.mjs`（整支）
  · `astro.config.mjs` 的 import 與 `markdown.remarkPlugins`
  · `package.json` build 的 `--force`（那是投影的必要條件，不是通用旗標）
  · `collector/.../daemon-notes.mjs` 的 `releasedSections()`／`releasedSectionsFromFile()`／`RELEASED_HEADING`
  · `collector/.../daemon-notes.test.mjs`（4 支全是投影的演練）
`daemon-notes.mjs` 其餘匯出（notesForVersion／checkNotes…）是出貨線在用的，留著。

── 舊網址留一條轉址，不直接 404 ──────────────────────────────────
那個網址掛在側欄上、也印在 landing「這一版改了什麼」旁邊，已隨 landing 部署到使用者
瀏覽器裡。repo 內的連結本輪都改成直接指 GitHub（landing／docs 首頁／側欄），
所以轉址不服務任何內部連結，只接書籤與舊 HTML。它是 `astro.config.mjs` 的一行宣告
（沒有程式、沒有真相源可以漂），而且被 verify-docs 每次出貨夾住 ⇒ 不是要維護的機制。

── ⚠️ 一次真的降級，標在這裡不藏 ────────────────────────────────
`verify-docs.mjs` 原本斷言「線上那一頁有這兩個版號」——沒有頁面就沒有東西可查。
改成斷言「那條轉址還在」（＝線上這顆確實是這份原始碼建的）。
**舊斷言抓得到「內容停在上一版」，新斷言抓不到。** 差額由 `release-record` 站承接：
每條版本線都要有一筆版本發佈、內文抽不到就中止——那一站有牙齒且更早跑。
`docs` 站的 ① 那道「這一版寫了嗎」照舊每個目標都問（D65：不准跳）。

實測
  · 建置產物：`1.4.4x`／`v0.18.2x` 命中 0 個檔；`dist/help/changelog/index.html`
    ＝轉址頁（meta refresh＋canonical＋a href 全指 releases）
  · 兩種網址（astro preview）：`/docs/help/changelog` 與 `…/changelog/` 皆 200，
    內容同一份轉址頁，版本號命中各 0
  · 站內死連結：指向該網址的 href 0 條；pagefind 11 個 fragment 含 changelog 者 0；sitemap 未列
  · 產生鏈完整：`1.4.47`→根 CHANGELOG.md（摘要＋4 行內文）／`v0.18.29`→collector/CHANGELOG.md
    （摘要＋6 行內文）／`1.4.29`→根（6 行）；不存在的版號回 null
  · `node --test installer/scripts/*.test.mjs` 233 支全綠
    （238→233：-4 投影演練、-1 htmlText，兩者的實作都已移除）
  · 建置那句 `/404.htmlEntry docs → 404 was not found.` 是既有行為——
    拿掉 redirects 重建仍出現，與本輪無關

Refs: inkstone/arcrun-rag#41

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
 2026-08-18 14:35:25 +08:00
Leo 00ccec53f2 fix(docs): 桌面版新版本重新長回文件站——投影不複製（D95 第三輪） 
D95 第一輪把 daemon 的 changelog 搬進 collector/ 讓 collector/ 自足，
但文件站的建置沒有任何一步會讀那個新位置 ⇒ 從那一刻起，桌面版的新版本
再也上不了 rag.arcrun.dev/docs/help/changelog/（匿名實測：線上 v0.18.28
有 4 次、v0.18.29 零次；v0.18.29 本來就只到 stage，所以這是未來式的退化，
不是已經在傷害用戶）。

修法：建置時投影，不複製、不改成只給連結。
  collector/CHANGELOG.md
    → collector/cmd/arcrun-app/daemon-notes.mjs 的 releasedSections()（切出已發佈段落）
    → docs-site/remark-daemon-changelog.mjs（remark 階段換掉佔位符）
    → /docs/help/changelog/（網址不變、頁面不變、docs-site 裡零副本）

「哪些段落算已發佈」住在 collector/ 那棵樹——那是 changelog 自己的格式知識，
不是文件站的。方向仍單向：根往內伸手拿，collector 不往外伸手。

順手修掉施工中發現的兩個沉默失敗：
  · Astro 的內容快取只認那一頁自己的檔案有沒有變 ⇒ 只改 collector/CHANGELOG.md
    會建出「成功但內容是舊的」頁面（實測：不加 --force 新段落 0 次命中，加了 4 次）。
    docs-site 的 build 因此帶 --force，理由寫在 package.json 的 //build 與 plugin 檔頭。
  · 佔位符被刪掉時原本會安靜地少掉整條版本歷史 ⇒ 改成當場 throw 並指名修法。

另：第一輪誤把一顆 __pycache__/*.pyc 帶進版控，移出追蹤並補 .gitignore。
（同目錄那些 20MB/11MB 的執行檔與 dmg 是 6b44784／e09f866／c6d7b2c 的舊帳，這輪不動。）

實測
  · 本機建置：v0.18.29 出現 6 次（本輪前為 0）；daemon 30 段＋雲端 17 段，
    與 D95 之前那一頁的 30／17 完全一致
  · 來源證明：docs-site/src 裡 `^## v0.` 零筆；在 collector/CHANGELOG.md 頂端塞
    v9.9.9 重建 → 頁面命中 4 次，移除後回復
  · 網址：dist/help/changelog/index.html → deploy/docs/…（rsync 鏡射）路徑與本輪前相同；
    線上 /docs/help/changelog 307 → /docs/help/changelog/ 200（平台行為，本輪未動路由）
  · 建置輸出會印「[daemon-changelog] 投影 30 段（v0.18.29 … v0.15.4）｜來源 …」
    ——這道閘說得出它實際投影了什麼
  · node --test：installer/scripts/*.test.mjs 與新增的 daemon-notes.test.mjs 共 238 支全綠

Refs: inkstone/InkStoneCo#40

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
 2026-08-18 14:00:32 +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