# Arcrun 桌面版（daemon）版本說明

> 🔴 **這份就是版本號的單一真相源。**（2026-08-18 從 `docs-site/src/content/docs/help/changelog.md` 搬來，D95 第一輪）
>
> 為什麼搬：`daemon-version.py` 從這份檔案算出版本號，
> 而它原本住在 repo 根的 `docs-site/` 底下——`collector/` 得往上伸手才拿得到自己的版本。
> 那條臍帶讓 `collector/` **沒有資格被搬成獨立 repo**，也讓「源碼→產出物」多了一道要記得的扭曲。
> 現在它與 `DAEMON_LINE`、`daemon-version.py` 住在同一棵樹底下，`collector/` 自己就算得出自己的版本。
>
> 🔴 **雲端（Arcrun 引擎 1.4.x）的版本說明不在這裡**，它住在 repo 根的 `CHANGELOG.md`
> （2026-08-17 從 docs-site 搬去，同一天 leo 說「這個頁面刪除」）——
> 兩條版本線本來就是兩個產品，混在一個檔裡是 D95 要拆掉的那種扭曲。
>
> 📌 **兩份都不是網頁，是出貨原稿。** 使用者讀的是版本發佈頁，由出貨線的 `release-record` 站拿這兩份檔的段落產生。
>
> 🔴 **兩條線發到兩個 repo**（D95，2026-08-18，`inkstone/InkStoneCo#40`）——
> 這份（桌面版 `0.18.x`）發到 **`arcrun-collector`**，
> 雲端引擎 `1.4.x` 那份發到 `arcrun-rag`：
>
> | | 內部（Gitea，stage） | 對外（GitHub，prod） |
> |---|---|---|
> | 桌面版 `0.18.x` | [`inkstone/arcrun-collector`](https://git.uncle6.me/inkstone/arcrun-collector/releases) | `youlinhsieh/arcrun-collector` ⚠️ **repo 還沒建**，建它是 D20 人閘 |
> | 雲端 `1.4.x` | `inkstone/arcrun-rag` | [`youlinhsieh/arcrun-rag`](https://github.com/youlinhsieh/arcrun-rag/releases) |
>
> 落點宣告在 `installer/ship.targets.json` 的 `releaseRecord.lineRepos`，
> 缺一條就在登錄簿驗證階段 exit 2——**沒有「退回去發到 arcrun-rag」這條路**。

## 怎麼出新版（不要手打版本號）

在**本檔最上面**（第一個 `v0.18.x` 段落之上）加一個二級標題，標題文字就是
`下一版（未發佈）`，底下條列白話更新內容：

    <二級標題> 下一版（未發佈）

    - 🔴 **（用戶看得懂的白話標題）**：（以前會怎樣、現在會怎樣）

> ⚠️ 上面刻意**不寫成真的標題**（用 `<二級標題>` 代替兩個井字號）。
> `daemon-version.py` 判斷「有沒有待發佈內容」用的是**純字串比對**，
> 本檔任何位置只要出現那一行的字面值，它就會以為要升版——
> 連寫在說明或程式碼區塊裡都算。這是機制的已知邊角，別把它變成陷阱。

打包時 `daemon-version.py --stamp` 會把它戳成正式版號＋今天日期。
**版本號從頭到尾沒有人打過**，而且「更新內容」與「版本」天生綁在一起。
沒有這一段 ⇒ `changelog-section.sh --check` 擋下打包。

⚠️ 寫給用戶看，不是寫給工程師看：說「以前會怎樣、現在會怎樣」，不要寫函式名或 commit 編號。

---

## 0.18.44（2026-08-28）

- 一個帳號沒有回應，不會再讓整台機器的同步停下來。以前只要有一發請求卡住，後面所有知識庫帳號、所有資料夾就一起停在那裡，畫面上什麼都不動也沒有錯誤訊息（實測卡了 39 分鐘）。現在等不到回覆的那個帳號這一輪先跳過，其他資料夾照常跑完。
- 等待不再是靜默的。哪個知識庫、正在做哪件事、已經等了多久，會寫在畫面與紀錄裡。
- 資料夾結構每一輪都會重新整理。以前雲端一沒回應，你看到的資料夾樹就永遠停在上一次。
- 被跳過的檔案不算失敗。雲端沒有回應是知識庫那邊的狀況，不會被記成這個檔的失敗次數，也不會因此被停掉自動重試。

## 0.18.43（2026-08-28）

- 🔴 **小幫手不再把自己整理出來的筆記當成新資料再整理一次**：以前它整理完一份文件、把筆記寫進資料夾之後，下一輪掃描又會把那些筆記當成「新來的檔案」再整理一遍，整理出來的東西又變成下一輪的材料——一輪接一輪停不下來。你會看到資料夾裡冒出越來越多名字奇怪的檔（像是同一個詞被括號包起來重複一次），每一輪都白白用掉一次當天的整理額度，知識庫裡也被塞進一堆「筆記的筆記」。現在它認得出哪些檔是自己寫的，一律跳過。
- **已經被繁殖出來的那些檔要自己刪**：這次的修正只保證不再繼續長，**不會回頭清掉先前多出來的檔**——那些檔跟你自己的東西混在同一個資料夾裡，我們寧可不替你決定刪哪一個。名字裡有重複括號的（例如「換柱（換柱）」）就是這次多出來的，可以直接刪掉。
- 🔴 **裝過開發範本的資料夾，現在分得出「空白樣板」與「你真的寫過的東西」**：以前只要路徑在 `system-dev/` 底下就整批不收，於是同一個資料夾裡**你自己的筆記與現成的知識卡也一起被丟掉**（實測：一個桌面資料夾底下有 9 張整理好的卡，一張都沒上去）。現在改成逐個檔比對——**內容和安裝時鋪下去的原版一模一樣**（你還沒動過）才不收；你寫過一個字、或那個檔根本不是範本鋪的，就是你的知識，照收。
- **這個分辨不看資料夾叫什麼名字**：換個名字裝、裝在別的位置，答案都一樣；反過來，一個剛好也叫 `system-dev` 但裡面是你自己東西的資料夾，不會再被誤殺。
- 🔴 **資料夾樹現在真的是「所有的資料夾」**：以前有幾種資料夾我們決定不收，而「不收」的做法是**連走都不走進去**——結果是那個資料夾底下有哪幾層、哪些子資料夾，你在小幫手與知識庫網頁上**一個都看不到**，樹到那一節就斷了。（實測：桌面上一個資料夾實際有 12 層資料夾，畫面上只有 3 個。）現在每一層都會列出來，跟你在檔案總管裡看到的一樣。
- **不收的那一層，照樣告訴你「底下有幾個檔、我收了幾個、為什麼沒收」**：以前這種資料夾要嘛不存在，要嘛顯示一個我們自己編的 `0 / 0`。現在數字是真的（例如「0 / 9」），旁邊寫著原因（例如「這是開發範本鋪下來的檔，不是你寫的東西」）——你先看得到那裡有東西，才輪得到決定要不要收它。
- **收檔範圍一個字都沒有放寬**：這一版只改「看得到什麼」，沒有改「收什麼」。原本不收的檔案現在仍然不收。
- 🔴 **把整理好的卡片放在資料夾裡，不會再被小幫手自己攪亂**：如果你把整理過的知識卡放在 `system-dev/wiki/cards/` 這種位置，小幫手替它們整理出來的新卡片會**被舊版的「卡片歸位」動作硬拖出來、改成別的檔名**——接著它連自己一秒前寫的卡都找不到，那批文件於是一份都上不去；被拖出來的卡又被當成你的新文件再整理一次，檔案愈長愈多（`某某（某某）`、`某某（某某）（某某）`…）。（實測：一個資料夾裡因此多出 70 個沒人要的檔案，9 份現成的卡一份也沒進到雲端。）現在那批卡片放在哪裡就留在哪裡。

## 0.18.42（2026-08-27）

- 🔴 **問 AI「這份資料的原文在哪」，現在答得出你走得到的位置**：以前它會回一個像 `../某某檔.pdf` 的東西——那是程式自己擺放檔案的相對位置，你拿著它打不開任何檔案；原稿如果放在子資料夾裡，連是哪一層都看不出來。現在每張卡的「出處」寫的是**哪一台電腦 › 哪一個知識庫 › 庫內哪一個路徑**（例如 `youlinhsieh@Leo-MBA › youlinhsieh-test1 › 會議紀錄/2026/某某.md`），照著三格走就找得到那個檔。
- **以前已經整理過的筆記也會一起換掉，不用重新整理一次**：小幫手會把本機既有的卡片改成新寫法並重新送上去一次，**不會再花一次 AI 額度、內容其餘一個字都不動**；每個資料夾只做一次，做完就不再重複。
- **刻意不寫完整的電腦路徑**：卡片會被別台電腦上的 AI 讀到，而完整路徑只在原本那台成立——寫了反而給你一個看起來精確、實際上打不開的答案。

## 0.18.41（2026-08-27）

- 🔴 **不叫「docs」的文件夾，現在也認得出來**：以前只有名字剛好叫 `docs`／`doc`／`documentation` 的資料夾會被讀，一個放滿 PDF、Word、筆記的資料夾只要名字不一樣（例如一個舊專案的存檔夾），就整個被當成程式碼跳過，畫面上也不會說為什麼。現在只要一個資料夾裡完全沒有程式碼、有看得懂的文件，不管叫什麼名字都會被收進來——你不用先學會「哪個按鈕可以救回一個資料夾」，大部分情況它一開始就是對的。

## 0.18.40（2026-08-27）

- 🔴 **卡住的檔案不再擋住後面所有人**：以前只要有幾個檔一直收不上去（格式讀不了、雲端當天額度滿了…），它們就會**每一輪都繼續佔著最前面的位子**，即使那一輪根本沒去試它們。結果是排在後面、本來好好的檔案永遠輪不到——你等再久、跑再多輪都一樣，數字只會往上長不會往下掉。現在退避中的檔案會讓開，後面的檔案遞補得上來，佇列真的會往前走。

## 0.18.39（2026-08-27）

- 🔴 **「已送上去」從今以後是真的送上去了**：以前只要雲端把請求收下來，小幫手就算它成功——就算雲端其實根本沒把它寫進你的知識庫。畫面上是綠的、數字也在跑，而 AI 一句都查不到，而且那些檔案因為被蓋了「已送」的章，**永遠不會再試一次**。現在它會看雲端真正的回覆：沒寫進去就誠實標成失敗、不蓋章、下一輪重新送。（實測：一個開發資料夾 26 份標「已送達」，雲端實際只有 4 份。）
- **太大的檔案現在會好好跟你說**：以前十幾萬字的大檔會一直送、一直失敗，而你看到的是一串沒人讀得懂的錯誤訊息，還會把每天的免費額度燒掉。現在它會先量一下，太大就不送，並且告訴你「這份檔約幾萬字、拆小一點就會自動收進來」。

## 0.18.38（2026-08-26）

- 🔴 **每一層子資料夾都看得到，不是只有第一層**：以前你只看得到自己選的那個資料夾本身，裡面到底有哪些子資料夾、哪幾層、哪些東西真的上去了，完全看不到。現在**桌面小幫手與知識庫網頁兩邊都攤得開**：小幫手裡點進那個知識庫，資料夾右邊多一顆「資料夾結構」，按下去就是一棵像檔案總管那樣、一列一列往下縮排的樹，點資料夾展開、再點收合，也可以一鍵全部展開／全部收合。
- **小幫手看得到，不必等雲端、也不必連線**：這棵樹是你這台電腦自己算出來的。就算網路斷了、或今天的 AI 額度用完了，它照樣打得開——那正是你最想知道「到底同步到哪了」的時候。
- **每一層都告訴你「幾份、上去了幾份」**：每個資料夾旁邊會標「已同步 / 總共」。兩個數字不一樣也會告訴你差在哪裡——還讀不了的格式、不在收檔範圍的檔案，還是還在處理中。
- **整個沒走進去的資料夾，不會假裝成 0 / 0**：被跳過的資料夾會直接寫「整個資料夾未收」加上原因，而不是給你一個我們自己編的數字。

## 0.18.37（2026-08-26）

- 🔴 **雲端被清空過的檔案，小幫手現在會自己發現並補送**：以前小幫手送成功一次就會在本機蓋一個「已送」的章，而那個章**永遠不會過期**。萬一雲端被重裝或清空，那批檔案就**再也不會被送上去**，而且沒有任何地方會跟你說——你只會發現「檔案明明在資料夾裡，AI 卻查不到」，而且查不出為什麼。現在它會跟雲端對一次帳，發現那邊沒有就重新送。
- **重跑第二次不會又全部送一遍**：對完帳之後它分得出「雲端真的沒有」與「我上次送過了」，不會把你的 AI 額度燒掉。
- **補送的時候看得到**：不會靜悄悄跑完。

## 0.18.36（2026-08-24）

- 🔴 **移除資料夾時，可以順便把我們放進去的隱藏檔案一起清掉**：小幫手整理你的資料夾時，會在**每一層**放一個隱藏的整理稿目錄（`.wiki`／`.arcrun-rag`）。以前你把資料夾從清單移除之後，這些東西**全部留在原地**——隱藏的、散在幾十層裡，你自己幾乎刪不乾淨。現在移除的對話框多了一個勾選框「順便把 Arcrun RAG 放在這個資料夾裡的檔案清掉」，勾起來會**先把確切要刪哪些列給你看**，你看過再按確定。
- **只刪我們自己建的，你的檔案一個都不會碰**：每一筆都要有我們自己寫下的依據（我們放的說明檔、我們的整理帳本、我們的檔名前綴）才會刪；只要有一個東西認不出來，那整個目錄就原封不動留著，並且在清單上告訴你留了什麼、為什麼留。
- **這幾種情況我們刻意不刪**：你那個資料夾裡如果還有別的資料夾也在同步清單裡，它底下的東西不碰；以前從你資料夾搬進暫存區的檔案不碰（那些是你的）；捷徑（symlink）不碰。
- 不勾這個框的話，行為跟以前一模一樣：硬碟上一個檔都不會少。

## 0.18.35（2026-08-24）

- 🔴 **桌面小幫手多了「App 界面」：一打開就是九宮格，點一下就用得到**：以前小幫手只做一件事——把資料夾整理進知識庫；要用知識庫上的 App（例如寫一則筆記），得另外開瀏覽器登入雲端。現在小幫手最上面多了一頁「App 界面」，裡面是**你連的那個知識庫實際裝了的 App**，一個 icon 一個 App，點下去就在小幫手裡打開，不用再開瀏覽器。
- 這批 App **跟你在知識庫網頁上看到的是同一批**：清單直接跟知識庫要，桌面上不另存一份，所以你在任何一台電腦看到的都一樣；在雲端裝了新 App，回到這裡按「重新整理」就會出現。
- 沒有自己畫面的 App 也點得開：會列出它能做的事，一條一顆「現在執行」。
- 連了不只一個知識庫的話，「App 界面」上方可以切換要看哪一個。
- 還沒連上知識庫、或這個知識庫一個 App 都沒裝，畫面會直接說是哪一種情況，不會只給你一片空白。
- **原本的功能一項都沒少**：同步狀態與「立刻同步」搬到了每一頁都看得到的最上方，首頁、各知識庫、AI 設定、版本與更新都在側邊欄原來的位置。

## 0.18.34（2026-08-20）

- 🔴 **雲端現在看得到你資料夾的完整層次，不再只有第一層**：以前不管你的資料夾疊了幾層，雲端只認得最外面那一層——`專案/教育部標案/會議紀錄` 這種放在深處的資料夾，在知識庫裡完全不存在，只會以檔案路徑的一段文字出現。現在**每一層資料夾都有自己的一格**，而且**每一格都連著它的上一層**，所以你可以像在檔案總管裡一樣，從最外層一路點進最深的那個資料夾。每一格還會告訴你這一層直接放了幾份文件、連同底下的子資料夾一共幾份。
- 這些索引**不經 AI 萃取**（本機掃一遍就有答案），所以不吃你的每日額度，額度用完的時候照樣會更新。
- 空的資料夾目前還不會出現（要等掃描開始記錄資料夾本身）；已經同步過的內容不受影響。
- 🔑 **同一份檔同步到兩台電腦，問答的出處不再只看得到一台**：上一版已經讓每份原稿記住它來自哪一台機器，但 AI 回答時還是會把同名的檔案當成同一份而只列出其中一台。現在內容還是只留一份（不會重複），但出處那一格會把它存在的每一台都列出來。

## 0.18.33（2026-08-18）

- 🔴 **現在看得出每份原稿在哪一台電腦上**：以前知識庫只記得檔案的相對路徑，所以你在兩台電腦、或電腦加 NAS 上放了同名的檔，系統分不出誰是誰——問答的出處只會顯示其中一台，另一台就這樣消失了。現在每份原稿都會記住它來自哪一台機器，預設用「你的帳號@電腦名稱」，你可以改成自己看得懂的稱呼（例如「教育部 Leo 的 Mac」）。既有的資料不受影響，那一格會誠實地空著，不會憑空編一個機器名給你。

## 0.18.32（2026-08-18）

- 🔴 **Microsoft Store 版不會再漏發**：以前每次出新版時，Store 用的那個安裝檔要有人記得手動搬進發佈流程；忘了搬，出貨流程照樣顯示成功，而 Store 那邊就停在舊版。現在它跟 Mac 版、Windows 版走同一條路，漏不掉。

## 0.18.31（2026-08-18）

- 🔴 **版本號不再帶 `v`，就是三個數字**：以前你下載到的檔叫 `Arcrun-v0.18.30.dmg`，版本發佈頁也寫 `v0.18.30`；現在一律是 `Arcrun-0.18.31.dmg`、`0.18.31`。舊版本的名字不會回頭改，你手上已經裝好的那一份也完全不受影響。
- 🔴 **出貨時認錯版本，現在會當場被擋下**：以前若不小心把雲端那條產品線的版本誤認成桌面版的，整條出貨流程會一路亮綠通過；現在會停在那一步，並明白告訴你它實際量到的是哪一版。對你的意義是——不會再拿到一個「版本號是新的、內容卻是舊的」更新。

## v0.18.30（2026-08-18）

**建議更新**——這版**沒有新功能**，是把桌面版重新打包一次。

- 🔴 **Windows 版重新有得下載**：先前打包流程有個問題，同一輪只打得出 Mac 版，
  接著打 Windows 版時會被自己的檢查擋下來——結果就是**新版本只有 Mac 拿得到**。
  這版修好之後，Mac 與 Windows 兩邊會同時有新版，內容也保證一致。
- 你手上的資料與設定完全不受影響；沒有任何操作方式改變。

## v0.18.29（2026-08-16）

**建議更新**——這版修好兩件「你以為它在做的事，其實它沒在做」。

- 🔑 **「移除資料夾」現在真的會收回**：先前你把一個資料夾從清單移除，它**只是停止繼續看**——已經整理進雲端的知識**一筆都不會消失**，照樣搜得到、AI 照樣拿它回答。現在移除時會問你要不要**連同雲端的知識一起收回**，預設是收回；只想停止監看也可以選。
- 🔑 **不會再把別人的套件當成你的知識**：如果你掛的是一個軟體專案資料夾，先前它會連 `node_modules` 那類**依賴目錄**裡的說明文件一起讀進去——實測有一次產出的 27 張卡裡，**21 張是第三方套件的 API 文件與授權條款**，你自己的東西只有 5 張。現在那些不會再被收。
- 🔑 **有沒有用 git 不再影響收哪些檔**：先前「這個資料夾要怎麼收」會看它有沒有版控——所以**只要你在自己的筆記資料夾開一次版控，收進去的東西就會大幅減少，而畫面上不會有任何提示**。現在改成看資料夾**實際裝了什麼**。
- 這版**不影響你已經同步的資料**，只改今後怎麼收、以及移除時多一個選擇。

## v0.18.28（2026-08-16）

- ⚡ **一指到資料夾，馬上就能問「裡面有什麼」**：小幫手掃完資料夾（幾秒鐘）就會先把「有哪些檔案、最近改了什麼」做成一頁總覽送上知識庫，不用等 AI 逐份整理——就算當天的 AI 額度用完了，這類問題照樣答得出來。內容的深度整理照常在背景進行，一份都不會少；檔案有增刪時總覽會自動更新，不會堆出重複資料。
- 📚 **整理出來的不再是一檔一張流水卡，而是一份看得懂的 wiki**：每份文件變成「一張總覽卡＋幾張概念卡」，放在資料夾裡隱藏的 `.wiki/` 目錄——就算不裝任何軟體，用檔案總管也能點著連結讀。每一層都有自動維護的目錄（00-INDEX）：你的每一份檔案都列在上面，沒有可整理內容的（例如發票、清單）也會誠實標「空」，你分得出「沒東西」和「被漏掉」。卡片之間有雙向連結、每張卡都寫明出處原稿；你的原稿一個字都不會被動到。這次也把沒接 Gemini 金鑰的免費路一起補齊，不用自己接金鑰也拿到一樣完整的整理結果。
- 🔗 **卡片之間的關聯終於連得起來**：上一版換了新的卡片格式後，小幫手其實抓不到卡片彼此的關係，於是每張卡都變成孤零零的一張，知識庫裡搜到一張也連不到相關的其他卡。這次修好，同一份資料裡的概念會正確地互相連結。
- 📍 **搬動或改名資料夾後，舊卡片不會被誤刪**：以前判斷「這份卡片是不是已經被你刪掉」只認標題不認路徑——不同資料夾裡剛好同名的檔案，其中一份可能被誤判成「已經不在了」而被清掉。現在改成認路徑，不會再誤殺。
- 🛡️ **小幫手不會再動到你自己用 git 管理的檔案**：如果你監看的資料夾本身是一個 git 專案（例如你自己維護的筆記或 wiki），小幫手現在只讀不改——不會把你自己手寫的卡片搬走改名，也不會去碰你倉庫裡的程式碼，只整理你的文件內容。

## v0.18.27（2026-08-13）

- 🛡️ **監看的是筆記庫「裡面的某個資料夾」時，保護不會再失效**：上一版的筆記庫保護只認「你監看的那一層本身是不是庫」——如果你監看的其實是庫底下的子資料夾（例如 `KB/docs`），保護會誤判成「這不是筆記庫」，整理結果照樣被 Logseq／Obsidian 當成你自己的新頁面收編。現在改成往上找最近的庫根，不管你監看哪一層，保護都認得出來。
- 🏷️ **機器寫的檔案，一眼就看得出不是你自己的**：就算檔名不撞名，資料夾裡冒出一堆陌生新檔案還是會讓人心裡發毛。現在寫進筆記庫的整理產物一律帶固定前綴，你打開資料夾能馬上分辨哪些是自己寫的、哪些是小幫手整理出來的。

## v0.18.26（2026-08-11）

- 🗂️ **不會再把整理結果寫進你的 Logseq／Obsidian 筆記庫**：以前小幫手不會分辨你選的資料夾是
  不是筆記庫，整理出來的卡片會被 Logseq／Obsidian 當成「你自己寫的新頁面」顯示出來。
  現在會先認出這是不是筆記庫，是的話卡片改放到你看不到、筆記軟體也不會掃描的位置；
  一般資料夾的行為不變。
- 🛡️ **不會再無聲蓋掉你原本就有的檔案**：以前如果整理出來的檔名剛好跟你資料夾裡既有的檔案
  同名，會直接覆蓋、你的原稿就沒了。現在遇到同名會先把你原本的檔案備份一份，
  新內容才會寫進去，不會再有東西不見了都不知道。

## v0.18.25（2026-08-09）

- 🌱 **第一次打開改成兩步引導**：以前打開小幫手只有兩行字兩顆按鈕，看不懂在幹嘛。
  現在第一步先用三句話說清楚 Arcrun 是什麼，第二步用兩張卡片問你「已經有知識庫」還是
  「還沒有」——選「還沒有」會直接告訴你回來要按哪顆鈕連線，不會丟出去就找不到路回來。

## v0.18.24（2026-08-08）

- 🔴 **修好「失敗原因每幾秒就消失」**：以前一個檔案沒送上去，展開看原因會看到
  「這個檔是在舊版失敗的，當時沒有記下原因」——即使你完全沒有更新過。
  現在展開失敗檔案，看得到真正的失敗原因。
- 📊 **首頁改成看總量，不用逐檔猜**：以前首頁只顯示「這一輪」處理了幾份，
  如果你的資料夾有幾千份檔案，會搞不清楚「雲端只有一百多張卡，是壞了還是
  還在跑」。現在首頁直接告訴你：共幾份、已經送上去幾份、還在排隊幾份、
  送不上去幾份——四個數字相加就是你資料夾裡的總檔案數。「送不上去」的
  分類預設收起來，想看細節再展開。
- 🩺 **「疑難排解」按鈕搬進小幫手本體**：以前雲端網頁上的診斷按鈕看不到你電腦上的
  真實狀況（總檔案數、失敗分類、小幫手版本）——因為那顆按鈕跑在瀏覽器裡，
  碰不到你電腦的檔案。現在小幫手裡有一顆匯出診斷檔的按鈕，把雲端與本機的
  狀況合併成一份檔案，還看得出小幫手本身是不是還活著在跑（不會誤以為當機）；
  回報問題時附上這份檔案，我們就能一次看懂發生什麼事。
- 🔒 **診斷檔不會洩漏你電腦上的資料夾路徑**：以前如果同步引擎剛好停住，
  診斷檔裡的錯誤訊息會帶出你電腦完整的資料夾路徑（例如你的使用者名稱、
  桌面上的資料夾結構）。現在只會保留到資料夾名稱本身，你可以放心把診斷檔
  分享出來讓我們協助排查，不會連帶交出你電腦的目錄結構。

## v0.18.23（2026-08-08）

- 🔴 **修好「按了檢查更新，卻更新不了」**：以前按下「檢查更新」會跳出
  `解壓失敗：ditto: Couldn't read PKZip signature` 這種看不懂的錯誤，
  然後就卡在那裡——**只能自己去網站手動下載安裝**。
  原因是我們從 v0.18.5 起改用 `.dmg` 發佈 Mac 版，但更新程式還在用舊的解壓方式，
  **這個問題已經存在七個版本沒被發現**。現在按下去會真的更新完成。
- 🔁 **已經是最新版就不會再叫你重新啟動**：以前手動裝好新版之後，
  設定頁還是會顯示「新版已下載完成，重新啟動就會套用」，
  明明新舊版號一模一樣，卻一直催你重開。
  現在會實際比對版號，已經是最新版就把提示和殘留的暫存檔一起清掉。
- 🪟 **Windows 版現在也會自己更新**：以前 Windows 按檢查更新只會幫你開啟下載資料夾，
  要自己把檔案換掉。現在會直接完成更新並重新啟動。

## v0.18.22（2026-08-08）

- 🔴 **修好「一次丟一大批檔案，額度會爆掉」**：以前把幾百份檔案一次丟進資料夾，
  小幫手會逐一觸發雲端整理，短時間內衝爆你雲端帳號的免費額度，
  結果大部分檔案都失敗、只有前面幾份成功。
  現在改成分批慢慢消化：每一輪只處理一部分，**今天新寫的檔案永遠優先**，
  積壓的舊檔案不會擋住你正在用的東西。
- 💬 **額度用完時講人話**：偵測到雲端額度用完後，畫面會直接告訴你
  「今天已經整理幾份、明天早上會自動恢復、不花錢也沒關係」，
  不會再讓你看到一串看不懂的錯誤代碼。
- 🔁 **中斷後不用從頭來過**：以前同步到一半被強制關閉或電腦重開機，
  已經處理好的檔案也會被視為沒做過，得整批重跑。
  現在每處理完一份就立刻記住進度，下次啟動只會接著做真正還沒完成的部分。
- 🧹 **同一批資料的多種格式不會重複佔用額度**：如果你的資料夾裡有同一份筆記
  的好幾種格式（例如同時有 `.md`／`.json`／`.html`），現在只會挑一種送去整理，
  不會把同一份內容當三份處理。
- 🌱 **全新安裝會自動準備一個可以隨時刪除的示範資料夾**：第一次連上知識庫時，
  Documents 底下會出現一個「Arcrun 範例庫（可刪除）」，裡面已經放了幾份說明
  Arcrun 的筆記——不用自己找資料夾，馬上就能看到「丟檔案 → 變成知識卡 → 搜得到」
  的完整過程。看不順眼可以直接刪掉，刪掉就真的沒了；一旦你自己加了資料夾，
  這個示範資料夾也不會再自動出現。

## v0.18.21（2026-08-06）

- 🏪 **開始提供 Microsoft Store 版本（`.msix`）**：除了原本的 `.exe`，
  現在也一併發佈商店格式的安裝包，正在送審。
  上架後 Windows 就不會再把 Arcrun 當成可疑程式攔下來（商店版由微軟簽章）。

## v0.18.20（2026-08-06）

- 📋 **失敗清單改成「點開才看細節」**：以前把失敗原因直接攤在檔名旁邊，
  中文檔名被擠成一行一個字，很難讀。
  現在只列**檔名**，旁邊一個三角形，需要時點開才看原因（預設收合）——
  重點是先讓你看到「**哪幾個檔沒過**」。

## v0.18.19（2026-08-06）

- ✏️ **失敗訊息改成人話**：上一版雖然列出了失敗的檔案，但寫的是
  「上次失敗（第 5 次），5h38m38s 後重試（上面是自動重試的排程，真正的原因是前一次失敗）」
  ——**那是寫給工程師看的**。現在改成：
  「已經自動試過 5 次都沒成功，約 5 小時後會再試一次。」
  知道原因時則直接講原因（例如「今天的免費 AI 額度用完了」），把重試排程放在後面當補充。
  時間也不再精確到秒——你需要知道的是「大概多久」，不是 `5h38m38s`。

## v0.18.18（2026-08-06）

- 🔴 **失敗時會告訴你「是誰的錯、你要不要做什麼」**：以前只寫「⚠ N 份失敗」，
  你分不出「等一下就會自己好」跟「這個檔永遠不會成功」——而這兩件事的處理方式完全相反。
  現在會列出**檔名 + 原因**，例如：
  - 「今天的免費 AI 額度用完了 ⇒ 明天會自動恢復，這些檔案會自己補上，你不用做什麼」
  - 「這份 PDF 看起來是掃描的圖片 ⇒ 需要先做文字辨識（OCR），或換一份有文字的版本」
- 🧹 **不再把開發用的檔案放進你的資料夾**：以前小幫手會自動鋪一套開發者用的範本
  （`CLAUDE.md`、`scripts/`、`system-dev/` 共 37 個檔）到你看守的資料夾裡，
  把你的資料夾弄亂，而且**那些檔還會被當成你的知識收進知識庫**（於是多出你沒建過的「庫」）。
  現在完全不放了；已經放進去的那些也**不會再被當成知識**。
  > 已經多出來的庫，可以在 Portal 的「庫目錄管理」自己按「移除」。
- ✏️ 「有 N 個檔案沒有被整理」不再重複列出同一個檔名。

## v0.18.17（2026-08-06）

**如果你看到「⚠ N 份失敗」卻不知道是哪一份，請更新這一版。**

- 🔴 **失敗的檔案現在會列出檔名與原因**：以前首頁只寫「⚠ 3 份失敗」，
  你完全不知道是哪幾份、為什麼失敗，也就無從判斷要不要處理。
  現在會直接列出**檔名 + 失敗原因**（最多 8 份，總數照實講）。
- 🗂️ **出問題時可以一鍵打開紀錄檔資料夾**：同步引擎有狀況時，
  首頁會多一張「需要回報這個問題？」的卡，按一下就開啟存放紀錄檔的資料夾。
  （上一版說有這個功能，但按鈕**實際上沒做進畫面**，這版才真的有。）

## v0.18.16（2026-08-06）

**如果你看到「還沒連上知識庫」但明明已經連上了，請更新這一版。**

- 🔴 **不再誤報「還沒連上知識庫」**：明明已經新增好知識庫帳號、側邊欄也看得到，
  首頁卻跳出「需要你處理一下 ⇒ 還沒連上知識庫」。
  原因是判斷時看錯了地方（看的是舊版單一帳號的欄位，而你的是新版多帳號設定）。
- 🔴 **順便修好那句話指錯路**：它叫你「點托盤選單的『＋ 新增帳號…』」，
  但托盤選單早就只剩「結束 Arcrun」了，那個入口根本不存在。
  現在會正確指向左邊「知識庫」下方的**新增知識庫帳號**。

## v0.18.15（2026-08-06）

- 🪵 **診斷紀錄不再印出不存在的網址**：啟動訊息以前會寫成
  `→ /webhooks/named//rag_ingest/trigger`（沒有網域、還有雙斜線），
  看起來像設定壞掉——其實功能完全正常，只是那行字用錯了資料來源。
  誤導性的紀錄比沒有紀錄更麻煩，會害人往錯的方向找問題。現在印的是真正會用到的網址。

## v0.18.14（2026-08-06）

**第一次安裝的人請用這一版**——修好「剛裝好、連上知識庫之後卻不會開始整理」。

- 🔴 **連上知識庫後會立刻開始，不必重開程式**：以前**第一次安裝**的人會遇到——
  打開程式、連上知識庫、加了資料夾，畫面卻一直說「同步引擎沒有在跑」，
  要**自己想到把程式關掉再打開**才會動。
  原因是程式啟動時還沒有設定，就沒有把同步引擎準備好；之後設定好了也不會補啟動。
  現在設定一完成就會自己開始。
- ✏️ 順帶把「請結束 Arcrun 再重新開啟」這句話拿掉了——
  那是把該由程式做的事推給你。現在會直接說「正在啟動同步引擎，請稍候」，
  還沒連知識庫時則說「按『新增知識庫帳號』就會開始」。

## v0.18.13（2026-08-06）

**如果你更新到 v0.18.12 仍然看到「同步引擎一直啟動失敗」，請更新這一版。**

- 🔴 **已經裝過舊版的人，設定檔現在會自動修好**：上一版只修好了「全新安裝」，
  但**已經存在的設定檔不會被修復**——程式打開時只是讀取它，不會重寫，
  所以錯誤原封不動（畫面仍寫「缺必填欄位：manifest」）。
  現在程式一打開就會檢查並自動補齊，不需要你做任何事、也不用重裝。

## v0.18.12（2026-08-06）

- 🗂️ **出問題時，一鍵打開紀錄檔資料夾**：同步引擎有狀況時，首頁會多出一張
  「需要回報這個問題？」的卡片，按一下就直接開啟存放紀錄檔的資料夾
  （裡面的 `collector.log` 和 `app.log` 傳給我們就能查）。
  卡片上也會直接寫出資料夾路徑，方便自己找。
  > 紀錄檔**一直都在寫**，不需要開啟任何「偵錯模式」；這次只是補上找得到的入口。

## v0.18.11（2026-08-06）

**Windows 使用者請務必更新**——這版修好「裝了完全不會動」。

- 🔴 **修好「一直在看守中和沒有在跑之間閃、重開也沒用」**：
  這是**全新安裝**才會撞到的問題——設定檔少了一個必要欄位，
  同步引擎每次啟動都立刻失敗，程式就一直重試、畫面跟著閃。
  連帶的症狀是**加了資料夾也完全沒反應**（因為同步引擎根本沒跑起來過）。
  現在全新安裝就能正常運作。
  > ⚠️ **這一版只修好「全新安裝」**；已經裝過舊版的人**不會**被自動修好（見 v0.18.13）。
- 🔍 順帶：同步引擎出問題時，畫面會**顯示真正的錯誤訊息**，
  而不是只寫「exit status 2」這種看不懂的東西。

## v0.18.10（2026-08-06）

**Windows 使用者請更新**——這版讓「同步引擎沒在跑」說得出原因。

- 🔍 **「同步引擎沒有在跑」現在會說出原因**：以前畫面只會在「看守中」和「沒有在跑」
  之間閃、叫你重新開啟（但重開沒有用，因為原因沒變）。
  現在會直接寫「**同步引擎一直啟動失敗，已自動重試 N 次**」並附上錯誤訊息，
  而且畫面不再閃爍。同樣的訊息也會寫進記錄檔（`.arcrun-rag\app.log`），方便回報問題。

> ⏳ **還沒做到**：正式的安裝程式（開始功能表／解除安裝）**這版沒有**，仍是單一 `.exe`。
> 打包工具在我們的機器上壞掉了，正在換路。上架 Microsoft Store 後會一併解決。

## v0.18.9（2026-08-06）

**Windows 使用者請更新**——這版把「防毒軟體把 Arcrun 當成病毒刪掉」的機會降到最低。

- 🛡️ **不再有第二個檔案被寫到你的電腦裡**：上一版雖然只下載一個 `Arcrun.exe`，
  但它執行時會**自己解出一支同步引擎程式**放到硬碟再執行。
  這個動作在防毒軟體眼中跟惡意程式很像，Windows Defender 因此把整個檔案隔離
  （封測者實際遇到，訊息是「檔案包含病毒或潛在的垃圾軟體」）。
  現在同步引擎**直接內建在同一支程式裡**，不會再產生任何額外檔案。
- 📦 檔案也順帶變小了（26MB → 22MB）。
- 🔍 **「有些檔案沒有被整理」現在會說出是哪一個**：以前只寫「有 1 個不是文件的檔案」，
  你根本無從判斷那是什麼、也不知道自己是不是存錯格式了。現在會直接列出檔名（最多 5 個）。
- ✏️ 同一張卡不再把同一件事講兩次（以前會先寫「看起來不是文件，所以跳過了」，
  底下空的，然後又寫「另外有 1 個…」）。

> ℹ️ 這版**不保證**防毒軟體不再誤判——真正的解法是上架 Microsoft Store
> （商店版由微軟簽章，不會被誤判），我們正在辦。
> 如果還是被擋，請在「Windows 安全性 → 保護歷程記錄」把它選為「允許在裝置上」。

## v0.18.8（2026-08-06）

**Mac 使用者請務必更新**——這版修好「關不掉、所以新版裝不上去」。

- 🔴 **「結束 Arcrun」現在真的會結束**：以前在選單列圖示按右鍵選「結束 Arcrun」，
  程式其實**還活著**，只是視窗被藏起來——唯一關得掉的方法是「強制結束」。
  最直接的後果是**下載新版時蓋不過舊版**，不知道怎麼強制結束的人就卡在那裡了。
- 🖥️ **Dock 不再出現重複的圖示**：常駐小工具照慣例只在選單列出現一個圖示，
  但 Arcrun 之前**選單列和 Dock 兩邊都有**。現在只留選單列那一個。
  （順帶：它也不會再出現在「強制結束」清單裡了——那是同一個原因造成的。）
- 🔳 **視窗可以全螢幕了**：Mac 版左上角的綠色按鈕之前是灰的、按不動（Windows 版正常）。
- 📐 **視窗預設大小改成螢幕的 70%**（上一版的 50% 太小）。

## v0.18.7（2026-08-06）

**Windows 使用者請務必更新**——這版把 Windows 版幾個「根本不能用」的問題一次修掉。
Mac 使用者這版沒有功能變化，不更新也沒關係。

- 🪟 **下載下來只有一個檔案了**：以前是 zip，解開還有兩個 exe，
  很容易只拿走其中一個——而少拿那個，同步就永遠不會動，畫面還不會告訴你原因。
  現在**直接下載一個 `Arcrun.exe`，雙擊就跑**，不必解壓縮、不必找第二個檔。
- 🔴 **Windows 上「同步引擎沒有在跑」修好了**：以前不管同步引擎有沒有在跑，
  首頁**一律**顯示「同步引擎沒有在跑」——因為判斷方式用了一個 Windows 上根本不存在的指令。
  現在會誠實反映真實狀態。
- 🔴 **托盤不會再開出一堆圖示**：以前每點一次程式就多開一個，
  托盤會出現好幾個一模一樣的圖示，分不清該點哪個。
  現在**第二次點只會把既有視窗叫回來**。
- 🎨 **圖示換成 Arcrun 的標誌**：Windows 版的視窗與托盤圖示之前一直是開發工具的預設「W」，
  現在是正確的 Arcrun 標誌。
- 📐 **視窗大小改成螢幕的一半**：以前寫死的尺寸在部分筆電上會高到超出畫面，
  現在會依你的螢幕自動調整並置中。

## v0.18.6（2026-08-06）

**建議更新**——如果你曾經丟了檔案進資料夾、卻完全看不出發生什麼事，這版會直接告訴你原因。

- 🔴 **讀不了的檔案，現在會當場說出來**：以前丟一份**舊版 Word（.doc）、Keynote、Pages**
  這類檔案進資料夾，小幫手會**默默跳過、一個字都不說**——你只看到「我丟了檔，然後什麼都沒發生」，
  完全無從判斷是自己弄錯了、還是程式壞了。
  現在首頁會直接列出**哪幾個檔讀不了、分別是什麼格式**，並告訴你不用重丟、支援之後會自動補上。
  急著要的話，先用原本的軟體另存成 PDF 或 Word（.docx）放回同一個資料夾就行。
- 📄 目前讀得了的格式：Word（.docx）、PowerPoint（.pptx）、Excel（.xlsx）、PDF、CSV、純文字、Markdown。

## v0.18.5（2026-08-05）

**強烈建議更新**——如果你發現「語意搜尋什麼都搜不到」，或「同步明明做完了、首頁卻一直說等待中」，這版都修好了。

- 🔴 **語意搜尋搜不到東西，修好了**：上一版換了看得懂中文的新 AI 模型，但**分數門檻沒跟著調**，
  結果把正確答案全部擋掉——新上傳的檔案一律 0 筆，只有標題幾乎一字不差的舊檔偶爾才中。
  現在門檻改成跟著模型走，搜得到了。
  （這是雲端的修復，請到 portal 設定頁按「檢查更新」。）
- 🔴 **首頁狀態不再說謊**：以前把檔案拖進資料夾，整個整理＋上傳的過程首頁都顯示「等待中」，
  做完了也看不出來。現在**整理中會真的顯示「同步中」**，做完會顯示「幾點整理了幾份」，
  而且**不會過十幾秒就被清空**。
- 🍎 **Mac 安裝畫面補上拖曳版面**：打開 DMG 會看到 Arcrun 和「應用程式」左右並排的大圖示，
  照著把左邊拖到右邊就裝好了。
  （**請務必拖進「應用程式」再開**——直接在「下載」資料夾裡開，之後會更新不了。）

## v0.18.4（2026-08-05）

**強烈建議更新**——如果你遇過「同步卡住不動」或「同一份檔案在知識庫裡出現很多次」，這版都修好了。

- 🔴 **一個檔案失敗不再拖住整個資料夾**：以前某個檔上傳失敗，小幫手會**不停重試同一個檔**
  （實測撞了 1387 次、連續 11 小時），害其他檔全部排在後面。
  現在失敗會**隔一段時間再試**（1 分鐘 → 5 分鐘 → 15 分鐘…），其他檔照常同步。
- 🔴 **同一份檔不再重複堆積**：以前每同步一次就在知識庫多存一份副本
  （搜尋會出現 20 筆一模一樣的結果）。現在會先清掉舊的再存新的。
- 🔴 **刪掉的檔案真的從知識庫移除**：以前只是「標記為已刪除」但資料還留著，越積越多。
- 🎨 **全新桌面 App**：點小幫手圖示**直接開視窗**、每個知識庫**各自一頁**、可切換深／淺色。
- 🍎 Mac 改用 DMG 安裝（開啟後把 Arcrun 拖進「應用程式」再開）。
- 🪟 Windows 版同步更新（新介面 + 上述所有修復）。

> 💡 **雲端也要更新**：這版搭配的雲端修復包含「中文搜尋準確度大幅提升」
> （換了看得懂中文的 AI 模型）。請到 portal 設定頁按「檢查更新」。

## v0.15.7（2026-08-04）

**建議更新**——如果你之前更新失敗過，這版修好了。

- 🔴 **修好「更新完又跳回舊版」**：以前只有把 App 放在「應用程式」資料夾才更新得了；
  現在**放哪裡都能更新**
- 🍎 **Mac 改用 DMG 安裝**：打開就是「把 App 拖進應用程式」的標準畫面
- 🪟 **Windows 新增 MSIX**：可以像正式軟體那樣安裝
- App 更名為 `Arcrun`

## v0.15.6（2026-08-04）

**強烈建議更新**——這版把「要申請 Gemini 金鑰」這道門檻整個拿掉了。

- 🔴 **整理檔案改用雲端 AI，不再需要任何 API 金鑰**
- 舊設定會自動切換過去；原本填的 Gemini 金鑰會保留，想用可以在「AI 設定…」切回去
- 整理速度快約 5 倍（約 3 秒／檔，之前約 17 秒）
- AI 問答也不再需要金鑰

## v0.15.5（2026-08-04）

- 嘗試把預設改成雲端 AI（**但有 bug，實際沒生效**，請直接用 v0.15.6 以上）

## v0.15.4（2026-08-04）

- 托盤點多下不再產生多個圖示
- 錯誤訊息改成白話，並指名去哪裡設定

## 更早的版本

封測初期版本，建議直接更新到最新版。
