摘要

aDict 3.0 是一次重寫，但它不是為了把 App 變得陌生。這次重寫的目標，是讓查詞、離線詞庫、收藏、歷史與跨平台體驗變得更可靠、更清楚，也讓 MDict / StarDict 等本地詞典格式在同一套體系下持續打磨。

如果你只是日常查單詞，3.0 最理想的結果應該是：你不需要理解背後發生了什麼，但會感覺 App 更穩、更快、更容易恢復到你熟悉的查詞狀態。

<aside> ✅ 狀態說明：本文已按目前 3.0 實作狀態修正。已接入或已實現的能力用「已納入」「已接入」描述；只有仍待產品決策、兼容性覆蓋或體驗打磨的部分才放在後續驗收。

</aside>

為什麼需要重寫

aDict 從一開始就是一個很個人化的詞典工具：介面要乾淨、查詞要直接、深色模式要舒服，也要讓使用者可以使用自己的 MDict 詞庫。這些方向沒有改變。

但隨著功能增加，舊版本裡有些能力已經不適合繼續用舊方式堆上去。例如 MDict 詞庫、iCloud 文件、WebView 顯示、收藏、歷史、URL scheme 與不同平台的介面，都需要更穩定的基礎。3.0 就是為了把這個基礎重新打好。

使用者會感受到什麼

1. 查詞流程更穩定

3.0 會把「使用者輸入文字」「選擇哪本詞典」「詞典是否找到結果」「如何顯示內容」這幾件事分清楚。這樣做的好處是，空結果、詞典不存在、網路錯誤、解析失敗不會再被混成同一種模糊狀態。

2. MDict 詞庫會成為更正式的一等功能

aDict 2.0 已經支援 MDict；3.0 不是重新承諾這件事，而是把它升級成更可靠的核心能力。MDictCLI / MDictProviderKit 已經承擔原生 Swift 解析、lookup、suggest、resource discovery 與 .mdd 資源提取，後續重點是把這些能力在 App 內打磨成穩定體驗。

3. 收藏與歷史會更像真正的使用者資料

3.0 已經把詞庫文件和使用者資料分開處理。詞庫文件仍然是使用者自己的 .mdx / .mdd / CSS 文件；收藏與查詞歷史則由 App 自己管理，並已建立基礎能力。這樣可以讓收藏去重、歷史排序、重新查詞、刪除與後續同步都更可控。

4. 介面不必一次全部改掉

3.0 的重點不是把 UI 全部推倒重做，而是先讓核心查詞路徑可靠。介面會跟著新架構逐步整理，但目標不是讓老使用者重新學一次，而是保留 aDict 原本輕巧、低干擾的使用感。

哪些東西會保留