StillRead

StillRead 是一個輕量的本地桌面 PDF 朗讀工具。 上傳 PDF 後，它會抽出句子、建立章節導覽，並用本地 Kokoro、OpenAI TTS 或 Browser Voice 幫你逐句朗讀。

目前主線是 Tauri 本地 app + 單頁前端：

• 主入口：src/index.html
• TTS Worker：src/kokoro-worker.js
• 桌面殼：src-tauri/src/main.rs
• 打包設定：src-tauri/tauri.conf.json

功能

• 本地 Kokoro TTS，首次下載模型後可本機快取重用
• OpenAI TTS 直連模式，使用者自備 API Key
• Browser Voice fallback，不用等模型也能直接播
• 自動辨識標題，建立左側 Table of Contents
• 句子高亮與字詞高亮
• Bionic Reading、括號/表格/註腳過濾
• 棉花糖淺色主題 + Nocturnal Archive 深色主題

開發與打包

先安裝依賴：

npm install

本地開發：

npm run tauri:dev

正式打包：

npm run build:desktop

清理大型 build 產物：

npm run clean

打包後，macOS DMG 預設輸出位置是：

src-tauri/target/release/bundle/dmg/StillRead_<version>_<arch>.dmg

專案結構

src-tauri/
  src/main.rs
  tauri.conf.json
src/
  index.html
  kokoro-worker.js
  vendor/

舊的 FlashRead.html、backend/ Python sidecar 流程已從主線移除，不再是目前維護目標。

設計語言

• 淺色模式：Cotton / Marshmallow palette
  • 主色：#785561
  • 主容器色：#fed1df
  • 背景色：#faf9fc
• 深色模式：Nocturnal Archive
  • 主色：#d1a7b4
• 內文與 UI 優先使用系統字體堆疊（ui-serif / ui-sans-serif），降低冷啟動等待與遠端依賴。

License

MIT