Repository navigation
modify_v1
本次改版內容
對應 commit:3d25f67 (Stabilize reader rendering and WSL build)
修復
- 修復 EPUB 閱讀或背景渲染時間較長時,ESP32-C3 可能因 watchdog 逾時而重啟的問題。
- 修復進入休眠、等待按鍵放開、啟動序列埠等待等流程中,長時間等待可能觸發 watchdog 的問題。
- 修復 EPUB 頁面快取讀取失敗後會遞迴重新渲染的問題,避免極端情況下造成堆疊持續增長。
- 修復 EPUB 閱讀器背景渲染 log 的
Serial.printf參數錯誤,避免讀取到不正確的堆疊資料。 - 修復書庫或搜尋結果為空時,按鍵導覽可能發生除以零的問題。
- 修復檔案列表分頁計算可能產生無效頁面大小的問題。
- 修復 EPUB 章節選擇頁翻頁時,可能產生負數選取索引的問題。
- 修復檔案管理器頂部選單可選項目數量不正確,導致可能選到未啟用項目的問題。
改善
- 在 EPUB 內容解析、頁面渲染、灰階輸出、閱讀器桌布載入/儲存、封面產生、最近閱讀清單載入、檔案搜尋與檔案複製等耗時流程中加入 watchdog reset。
- 最近閱讀封面產生進度改為先計算安全的進度步進值,避免重複運算並降低空集合風險。
- 檔案列表翻頁邏輯改為夾限與邊界檢查,讓空資料、短頁面與頁尾操作更穩定。
WSL / Linux 編譯相容性
- 修正
HardwareSerial.h標頭大小寫,解決 Linux/WSL 檔案系統大小寫敏感造成的編譯失敗。 - 新增
.gitattributes,固定 shell script 使用 LF 換行,避免 WSL bash 執行測試腳本時受 CRLF 影響。 RELEASE_NOTES.md已加入.gitignore,這份本地發行說明不會被提交到 Git。
驗證結果
- WSL
pio run:default通過。 - WSL
pio run:gh_release、gh_release_rc、slim通過。 - WSL hyphenation 評估通過:
- English: 99.1023%
- French: 100%
- German: 97.7289%
- Russian: 97.2167%
- Spanish: 99.0236%
pio check完成,PlatformIO 狀態為PASSED。
已知狀況
pio check仍會列出既有的 XTC 與第三方函式庫 cppcheck 提示,這次改版未處理該範圍。pio test目前沒有 PlatformIO 格式的測試套件可執行;本次使用專案既有的 WSL hyphenation 評估腳本作為完整測試的一部分。