diff --git a/README.md b/README.md
index 98f12f3..9945a9f 100644
--- a/README.md
+++ b/README.md
@@ -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`/