# 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 要拆掉的那種扭曲。
>
> 📌 **兩份都不是網頁，是出貨原稿。** 使用者讀的是
> [GitHub 版本發佈](https://github.com/youlinhsieh/arcrun-rag/releases)，由 `installer/scripts/github-release.mjs` 拿這兩份檔的段落產生。

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

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

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

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

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

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

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

---

## 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）

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

## 更早的版本

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