指南
安裝與首次啟動
第一次使用時，先確認系統環境與安裝來源，避免把權限或檔案路徑問題帶進後續閱讀流程。
- 從官網下載安裝包，並將應用程式拖入系統應用程式資料夾。
- 首次開啟時，依照系統提示完成安全驗證與權限確認。
- 進入設定頁檢查預設閱讀目錄、介面語言與詞典狀態是否正常。
補充說明
- 建議優先使用最新穩定版本。
- 若系統攔截應用程式啟動，請先確認安裝包來源是否為官網。
指南
匯入書籍與開始閱讀
留白閱讀器更適合連續閱讀，而不是碎片化練習，建議先從篇幅適中的 EPUB 或 Markdown 書籍開始。
- 在書庫中點擊匯入，選擇 EPUB 或 Markdown 檔案。
- 匯入後檢查章節目錄、段落換行與正文編碼是否正常。
- 依照自己的英文程度調整註解密度，再開始第一輪閱讀。
補充說明
- 若書籍排版異常，請先檢查來源檔案是否完整。
- 大型書籍首次匯入時可能需要額外解析時間。
指南
匯入專業詞典
如果你正在閱讀醫學、法律、電腦或學術材料，建議補充更專業的詞典檔案，而不是只依賴預設釋義。
- 進入設定中的詞典管理。
- 匯入 Mdx 或 Stardict 格式詞典檔案。
- 設定預設主詞典，並依需求調整詞典優先順序。
補充說明
- 匯入前請確認詞典檔案版權與來源合規。
- 詞典檔案較大時，首次索引可能持續數十秒。
指南
已知詞與註解層級
留白閱讀器的核心體驗來自「已知詞追蹤 + 註解減法」，建議先建立自己的標記規則。
- 閱讀時點掉你已經掌握的單字，讓系統逐步建立已知詞庫。
- 依照目前閱讀難度調整註解顯示層級，不必追求一次性關閉所有提示。
- 定期回看閱讀統計，確認自己的閱讀流暢度是否持續提升。
補充說明
- 如果誤標了單字，應盡早在詞庫中修正。
- 更適合在真實閱讀語境中累積詞彙，而不是當成背單字工具。
指南
備份與遷移資料
更換電腦、重灌系統或嘗試測試版前，請先完成本地備份，這是使用個人開發者應用時最重要的習慣之一。
- 匯出或備份本地資料庫檔案。
- 同時備份詞典檔案、設定檔與自訂資源目錄。
- 在新裝置匯入後，優先核對詞庫、閱讀進度與詞典載入狀態。
補充說明
- 遷移完成後，先抽查最近閱讀的幾本書是否能正常開啟。
- 在同步功能正式上線前，資料遷移仍以手動備份為主。
指南
常見故障排查
遇到無法匯書、詞典未生效或閱讀進度異常時，先做基礎排查，通常能在幾分鐘內定位問題。
- 重新啟動應用程式，並確認使用的是最新穩定版。
- 檢查書籍檔案、詞典檔案與資料庫路徑是否仍然存在且可存取。
- 如果問題仍然存在，整理重現步驟、系統版本與錯誤截圖後聯絡支援。
補充說明
- 涉及資料異常時，請先備份目前的本地資料庫。
- 提交回饋時附上問題檔案樣本，通常能明顯縮短排查時間。
聯絡支援前
先準備這些資訊，排查會更快
- 你的系統版本與應用程式版本號
- 問題發生前的具體操作步驟
- 相關截圖、錯誤提示或日誌片段
- 是否已經嘗試重新啟動應用程式、重新匯入檔案或還原備份
目前支援範圍
個人開發者維護下的支援邊界
- 支援 EPUB 與 Markdown 等目前版本已說明的匯入格式
- 支援本地詞典匯入、閱讀資料備份與手動遷移相關說明
- 對於第三方詞典、書籍來源檔案本身的版權與品質問題，只能提供相容性層面的建議