docs: 說清楚這個 repo 是什麼、成品在哪、跟 arcrun-rag 什麼關係(D95)
leo D95 的要求是「不要有很多扭曲,因為你根本不記得你做的這些扭曲,每次都要查」 ⇒ 打開這個 repo 第一眼就要答得出三題:這是什麼產品/去哪拿/跟隔壁那個什麼關係。 過渡狀態(collector/ 還留在 arcrun-rag)也寫在裡面—— 不寫的話,下一個人查到兩份源碼會以為自己找錯地方。 票:inkstone/InkStoneCo#40
This commit is contained in:
@@ -1,4 +1,30 @@
|
||||
# collector
|
||||
# arcrun-collector — 桌面小幫手(Arcrun RAG Desktop)
|
||||
|
||||
> **這個 repo 是「桌面小幫手」的家:原始碼、版本說明、每一版的成品,全部在這裡。**
|
||||
>
|
||||
> - **要下載桌面小幫手** → 右邊的「版本發布 / Releases」,最新一版就是最上面那筆。
|
||||
> 每一筆都掛著當版的三個成品:macOS 的 `.dmg`、Windows 的 `.exe` 與 `.msix`。
|
||||
> - **這一版改了什麼** → 同一筆 release 的內文,原稿是 [`CHANGELOG.md`](CHANGELOG.md)。
|
||||
> - **版本號長什麼樣** → `0.18.x`([`DAEMON_LINE`](DAEMON_LINE) 宣告的那條線)。
|
||||
> 雲端引擎是 `1.4.x`,**是另一個產品、另一個 repo**(見下)。
|
||||
>
|
||||
> ## 跟 arcrun-rag 的關係
|
||||
>
|
||||
> [`inkstone/arcrun-rag`](https://git.uncle6.me/inkstone/arcrun-rag) 是**雲端引擎**(`1.4.x`)——
|
||||
> 跑在使用者自己 Cloudflare 帳號上的那些 worker。桌面小幫手會連上它,但兩者是兩個產品、
|
||||
> 兩條版本線、兩份版本說明。
|
||||
>
|
||||
> 🔴 **為什麼分開**(D95,leo 2026-08-18):在此之前兩個產品的版本發布疊在 arcrun-rag
|
||||
> 同一條歷史上(`0.18.33`、`0.18.30` 跟 `1.4.49`、`1.4.48` 並排),而且出貨線每跑一次就多疊一筆。
|
||||
> leo 原話:「**我強調了不要扭曲,這就是扭曲,把一個差很多的東西塞進去別人的歷史裡。**」
|
||||
> 兩個產品共用一條版本歷史,「最新版是哪一個」就沒有答案。
|
||||
>
|
||||
> 📌 過渡狀態(誠實記著):原始碼目前仍同時存在於 `arcrun-rag` 的 `collector/`,
|
||||
> 由出貨線每次出貨同步過來。**把 `collector/` 從 arcrun-rag 拆掉**要動 20 幾支讀那個路徑的
|
||||
> 腳本,另立一輪處理(票:`inkstone/InkStoneCo#40`)。
|
||||
> 在那之前,**發佈的落點以本 repo 為準**。
|
||||
|
||||
---
|
||||
|
||||
> ✂️ **legacy Node 版(Gitea push 鏈)已於 2026-07-19 刪除**(SDD `ingest-hash-trigger` task 4:
|
||||
> 「Gitea webhook 接收端程式碼與路由已刪除(git 記錄可查)」)。`index.js`/`transform.js`/
|
||||
|
||||
Reference in New Issue
Block a user