35 KiB
35 KiB
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.xinkstone/arcrun-collectoryoulinhsieh/arcrun-collector⚠️ repo 還沒建，建它是 D20 人閘雲端 1.4.xinkstone/arcrun-ragyoulinhsieh/arcrun-rag落點宣告在
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.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）
- 托盤點多下不再產生多個圖示
- 錯誤訊息改成白話，並指名去哪裡設定
更早的版本
封測初期版本，建議直接更新到最新版。