Skip to content

Repository files navigation

StudyTracker Desktop

English

StudyTracker Desktop 是一款以個人使用為核心的桌面學習規劃、專注計時與活動回顧應用程式。產品採本地優先與隱私優先設計,目標是在沒有帳號或網路連線時,仍能管理學習內容並保有自己的紀錄。

目前已完成本機資料、學習規劃、工作階段、規則與隱私、統計及桌面整合介面,以及 Windows 背景活動追蹤、分心提醒與全黑專注模式基礎;備份、還原與發布流程仍在開發中,尚無正式發布版本。

核心方向

  • 管理科目、任務與每日學習計畫。
  • 提供計時、定時與番茄鐘。
  • 記錄桌面應用程式活動,並讓使用者控制記錄範圍。
  • 透過可調整的黑名單、白名單與提醒機制協助維持專注。
  • 提供本地統計、資料匯出、備份與還原。
  • 核心功能可離線使用,不以帳號或雲端服務為必要條件。

以上為完整產品方向;目前完成範圍以「目前已建立」為準。

目前已建立

  • 以月曆管理科目、任務與每日目標,並支援計時、定時、番茄鐘及可修正的工作階段紀錄。
  • 依隱私設定記錄 Windows 前景應用程式;可控制全日記錄、個別應用程式的記錄/隱藏與 Privacy 排程,且不讀取視窗標題或以鍵鼠閒置推斷專注狀態。
  • 提供黑名單、白名單、暫時允許、非全螢幕分心提醒與全黑專注模式。
  • 日/週/月統計涵蓋專注趨勢、科目與計畫、分心及應用程式時間,並提供熱區、累積圖與精確數值。
  • 資料保存在本機 SQLite;歷史、應用活動、規劃、規則與偏好可分組預覽及獨立清除。
  • 提供響應式亮/暗色介面,以及本機通知、系統匣控制、登入後自動啟動與手動更新檢查等 Windows 桌面整合。

開發需求

  • Node.js 24 或以上
  • npm 11 或以上
  • Rust 1.85 或以上
  • Windows 上建置 Tauri 所需的系統相依套件

開始開發

npm install
npm run tauri:dev

執行完整品質檢查:

npm run check

建立內嵌前端、不需安裝的單一 EXE:

npm run tauri:build:portable

免安裝版固定輸出至 target/release/studytracker-desktop.exe;Cargo、Tauri 與測試共用同一個 target/,不會再建立第二個 Release 目錄。免安裝僅代表不需安裝程式,使用者資料仍固定保存於 %APPDATA%\io.studytracker.desktop\studytracker-v5.sqlite3,不會因移動 EXE 而改變位置。

建立 Windows NSIS 安裝程式:

npm run tauri:build

兩種建置都會使用正式 Tauri 流程內嵌前端。請勿直接執行 cargo build --release;專案會拒絕未啟用正式資源協定的 Release 建置,以免產物誤連開發伺服器。正式發布、升級與移除驗收仍待後續完成。

文件

StudyTracker 專案

Desktop 是 StudyTracker 的桌面客戶端。主專案儲存庫尚未建立,建立後會補上正式連結。

未來預計依不同作業系統與裝置能力,逐步開發其他桌面及行動裝置版本。

授權

本專案採 Apache License 2.0 授權。

About

StudyTracker 的本地優先、隱私導向桌面客戶端

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages