feat: add app limits feature with daily usage limits and notifications

- Implemented a new Limits page to set daily usage limits for applications.
- Added functionality to search and select running or recent applications.
- Users can add, remove, and toggle limits for applications.
- Integrated local storage to persist limits across sessions.
- Added translations for limits feature in English and Chinese.
- Updated settings to include options for excluding TimeLens applications.
- Enhanced settings page with new UI elements for managing executable options.
- Updated API services to handle recent and running executables.
- Improved overall user experience with new UI components and styles.

Co-authored-by: Copilot <copilot@github.com>

Author: PythonSmall-Q

CHANGELOG.md

@@ -5,7 +5,77 @@ Format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 
 ---
 
-## [0.1.0][0.1.0]
+## [0.3.0] - 2026-04-25
+
+### Added
+
+#### Dashboard — Period Stats
+
+- **Day / Week / Month selector** — switch between daily, weekly, and monthly views from the dashboard header
+- **Week navigator** — `<select>` dropdown listing every week of the year; prev / next arrow buttons
+- **Month navigator** — `<select>` dropdown listing every month; prev / next arrow buttons
+- **Average daily usage** — displayed per period (weekly / monthly view) showing mean screen time per day
+- **Week-over-week comparison** — shows total usage change vs. the previous week (absolute + percentage delta, color-coded)
+- **Week date range labels** — week dropdown now shows `W17: Apr 21 – Apr 27` instead of the raw ISO code
+- **First day of week** — configurable in Settings (Monday or Sunday); affects the week date range display and data window
+
+#### Settings — Excluded Apps
+
+- New **Excluded Apps** section under Data settings
+- Searchable app list populated from currently running processes (Windows: `tasklist`) merged with recent historical executables
+- Checkbox-based multi-select; changes saved via a dedicated Save button
+- Excluded apps are hidden from all stats queries (dashboard, charts, rankings)
+- **Default exclude TimeLens** — on first run, TimeLens's own executable is auto-added to the exclusion list; a toggle in Settings can re-include it
+
+#### Widgets
+
+- **Start on launch** toggle per widget — each widget card in Widget Center now has a checkbox; widgets with this disabled are not restored at startup
+
+#### UI / UX
+
+- **Dropdown beautification** — unified `.ui-select` style with custom SVG chevron, 12 px rounded corners, and theme-aware option backgrounds
+- **Dropdown beautification (enhanced)** — 14 px rounded corners, subtle box-shadow, smooth hover/active scale transitions
+- **App exe path tooltip** — hovering over an app name in the ranked list shows the full executable path
+
+#### App Usage Limits (new page)
+
+- New **App Limits** sidebar page (`/limits`) for per-app daily usage warnings
+- Searchable app picker; per-limit enable/disable toggle and inline hour/minute editing
+- **80 % warning** — dismissable floating banner toast when 80 % of daily limit is reached
+- **90 % warning** — orange banner toast when 90 % of limit is reached
+- **100 % alert** — blocking modal popup when daily limit is fully consumed
+- Warning state stored in localStorage, reset daily (fires once per threshold per day)
+
+#### Update Check
+
+- On startup (4 s delay) TimeLens fetches the latest GitHub release
+- If a newer version is found, an **Update Available** modal shows release notes and a direct GitHub link
+- Users can dismiss or choose "Remind me later"
+
+#### Internationalization
+
+- **System language auto-detect** — on first launch, TimeLens automatically selects `zh-CN` if the OS locale is Chinese, otherwise defaults to `en`; preference is saved to localStorage
+- Language switcher removed from the Sidebar; language is now changed only from Settings
+- New **limits** i18n namespace (`en` / `zh-CN`) covering the App Limits page
+- `common` namespace extended with update-check message keys
+- `settings` namespace extended with week-start-day and exclude-TimeLens keys
+
+### Fixed
+
+- **Startup race condition** — `DbState` is now registered with Tauri's state manager *before* widget windows are restored, preventing early IPC calls from failing with a missing-state error
+- Two Rust compile errors introduced by `exe_path` tracking: missing tuple element in `monitor/mod.rs` and missing `start_on_launch` field in `WidgetConfig` initializer
+
+### Changed
+
+- `exe_path` column added to `app_usage` table; existing databases are migrated automatically via `ALTER TABLE`
+- `start_on_launch` column added to `widget_configs` table; existing databases are migrated automatically
+- New `ignored_apps` table created on first run
+- All stat queries now filter out rows whose `exe_path` is in the ignored-apps list
+- Version bumped to **0.3.0** in `package.json`, `Cargo.toml`, and `tauri.conf.json`
+
+---
+
+## [0.1.0]
 
 ### Added
 
@@ -44,4 +114,19 @@ Format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 - GitHub Actions CI (lint + typecheck + `cargo check`) on push/PR
 - GitHub Actions release workflow: builds Windows `.msi`/`.exe` + macOS universal `.dmg` on `v*` tags
 
-[0.1.0]: https://github.com/PythonSmall-Q/TimeLens/releases/tag/v0.1.0
+---
+
+#### Future Development
+
+
+| 方向                 | 具体想法                                                        |
+| -------------------- | --------------------------------------------------------------- |
+| **数据洞察**   | 生产力分数、专注时段识别、与历史均值的对比趋势图                |
+| **目标系统**   | 每日/每周使用目标（不只是限制，还有"至少用 X 小时"鼓励类）      |
+| **分类管理**   | 将 App 手动分入"工作/娱乐/社交"类别，按类别统计                 |
+| **报告导出**   | 周报/月报 PDF/CSV，可分享                                       |
+| **通知集成**   | Windows 原生通知（目前用内嵌 toast），支持声音提醒              |
+| **跨设备同步** | 可选云同步（S3/本地 NAS），多机汇总统计                         |
+| **专注模式**   | 限额触发时可选择屏蔽某应用窗口（需管理员权限）                  |
+| **API / 插件** | 暴露本地 REST API，让第三方工具（Obsidian、Raycast 等）读取数据 |
+| **移动端伴侣** | 查看统计的手机端 App（只读），Tauri 2.x 支持 Android/iOS        |

package.json

@@ -1,7 +1,7 @@
 {
   "name": "timelens",
   "private": true,
-  "version": "1.0.0",
+  "version": "0.3.0",
   "type": "module",
   "scripts": {
     "dev": "vite",

src-tauri/Cargo.lock

@@ -1,6 +1,6 @@
 [package]
 name = "timelens"
-version = "0.1.0"
+version = "0.3.0"
 description = "A screen time tracker and desktop widget manager"
 authors = []
 edition = "2021"
@@ -13,6 +13,10 @@ crate-type = ["staticlib", "cdylib", "rlib"]
 [build-dependencies]
 tauri-build = { version = "2", features = [] }
 
+[features]
+default = []
+macos-private-api = ["tauri/macos-private-api"]
+
 [dependencies]
 tauri = { version = "2", features = ["tray-icon", "image-png", "image-ico"] }
 tauri-plugin-shell = "2"

src-tauri/Cargo.toml

@@ -3,7 +3,10 @@ use chrono::Local;
 use tauri::State;
 
 use crate::db;
-use crate::models::{AppUsageSummary, HourlyDistribution, DailyUsage, TodoItem, WidgetConfig};
+use crate::models::{
+    AppUsageComparison, AppUsageSummary, DailyUsage, ExecutableOption, HourlyDistribution,
+    TodoItem, WidgetConfig,
+};
 
 pub type DbState = Arc<Mutex<rusqlite::Connection>>;
 
@@ -20,7 +23,11 @@ pub fn get_today_app_totals(db: State<DbState>) -> Result<Vec<AppUsageSummary>,
     let rows = db::get_daily_app_totals(&conn, &today()).map_err(|e| e.to_string())?;
     Ok(rows
         .into_iter()
-        .map(|(app_name, total_seconds)| AppUsageSummary { app_name, total_seconds })
+        .map(|(app_name, exe_path, total_seconds)| AppUsageSummary {
+            app_name,
+            exe_path,
+            total_seconds,
+        })
         .collect())
 }
 
@@ -31,10 +38,89 @@ pub fn get_app_totals_for_date(date: String, db: State<DbState>) -> Result<Vec<A
     let rows = db::get_daily_app_totals(&conn, &date).map_err(|e| e.to_string())?;
     Ok(rows
         .into_iter()
-        .map(|(app_name, total_seconds)| AppUsageSummary { app_name, total_seconds })
+        .map(|(app_name, exe_path, total_seconds)| AppUsageSummary {
+            app_name,
+            exe_path,
+            total_seconds,
+        })
         .collect())
 }
 
+#[tauri::command]
+pub fn get_app_totals_in_range(
+    start_date: String,
+    end_date: String,
+    db: State<DbState>,
+) -> Result<Vec<AppUsageSummary>, String> {
+    let conn = db.lock().map_err(|e| e.to_string())?;
+    let rows = db::get_app_totals_in_range(&conn, &start_date, &end_date).map_err(|e| e.to_string())?;
+    Ok(rows
+        .into_iter()
+        .map(|(app_name, exe_path, total_seconds)| AppUsageSummary {
+            app_name,
+            exe_path,
+            total_seconds,
+        })
+        .collect())
+}
+
+#[tauri::command]
+pub fn get_app_comparison_in_ranges(
+    current_start: String,
+    current_end: String,
+    previous_start: String,
+    previous_end: String,
+    db: State<DbState>,
+) -> Result<Vec<AppUsageComparison>, String> {
+    let conn = db.lock().map_err(|e| e.to_string())?;
+    let current = db::get_app_totals_in_range(&conn, &current_start, &current_end)
+        .map_err(|e| e.to_string())?;
+    let previous = db::get_app_totals_in_range(&conn, &previous_start, &previous_end)
+        .map_err(|e| e.to_string())?;
+
+    let mut map: std::collections::BTreeMap<String, (String, i64, i64)> =
+        std::collections::BTreeMap::new();
+    for (name, exe_path, secs) in current {
+        map.insert(name, (exe_path, secs, 0));
+    }
+    for (name, exe_path, secs) in previous {
+        if let Some(v) = map.get_mut(&name) {
+            v.2 = secs;
+            if v.0.is_empty() {
+                v.0 = exe_path;
+            }
+        } else {
+            map.insert(name, (exe_path, 0, secs));
+        }
+    }
+
+    let mut rows: Vec<AppUsageComparison> = map
+        .into_iter()
+        .map(|(app_name, (exe_path, current_seconds, previous_seconds))| {
+            let delta_seconds = current_seconds - previous_seconds;
+            let delta_ratio = if previous_seconds > 0 {
+                delta_seconds as f64 / previous_seconds as f64
+            } else if current_seconds > 0 {
+                1.0
+            } else {
+                0.0
+            };
+
+            AppUsageComparison {
+                app_name,
+                exe_path,
+                current_seconds,
+                previous_seconds,
+                delta_seconds,
+                delta_ratio,
+            }
+        })
+        .collect();
+
+    rows.sort_by(|a, b| b.current_seconds.cmp(&a.current_seconds));
+    Ok(rows)
+}
+
 /// Returns hourly usage distribution for today (hour 0-23 → seconds).
 #[tauri::command]
 pub fn get_today_hourly(db: State<DbState>) -> Result<Vec<HourlyDistribution>, String> {
@@ -126,3 +212,76 @@ pub fn remove_widget_config(id: String, db: State<DbState>) -> Result<(), String
     let conn = db.lock().map_err(|e| e.to_string())?;
     db::delete_widget_config(&conn, &id).map_err(|e| e.to_string())
 }
+
+#[tauri::command]
+pub fn get_ignored_apps(db: State<DbState>) -> Result<Vec<String>, String> {
+    let conn = db.lock().map_err(|e| e.to_string())?;
+    db::get_ignored_apps(&conn).map_err(|e| e.to_string())
+}
+
+#[tauri::command]
+pub fn set_ignored_apps(exe_paths: Vec<String>, db: State<DbState>) -> Result<(), String> {
+    let conn = db.lock().map_err(|e| e.to_string())?;
+    db::set_ignored_apps(&conn, &exe_paths).map_err(|e| e.to_string())
+}
+
+#[tauri::command]
+pub fn get_recent_executables(limit: Option<u32>, db: State<DbState>) -> Result<Vec<ExecutableOption>, String> {
+    let conn = db.lock().map_err(|e| e.to_string())?;
+    let rows = db::get_recent_executables(&conn, limit.unwrap_or(200) as i64)
+        .map_err(|e| e.to_string())?;
+    Ok(rows
+        .into_iter()
+        .map(|(app_name, exe_path)| ExecutableOption { app_name, exe_path })
+        .collect())
+}
+
+#[tauri::command]
+pub fn get_running_executables() -> Result<Vec<ExecutableOption>, String> {
+    #[cfg(target_os = "windows")]
+    {
+        use std::collections::BTreeSet;
+        use std::process::Command;
+
+        let output = Command::new("tasklist")
+            .args(["/fo", "csv", "/nh"])
+            .output()
+            .map_err(|e| e.to_string())?;
+
+        if !output.status.success() {
+            return Ok(vec![]);
+        }
+
+        let text = String::from_utf8_lossy(&output.stdout);
+        let mut set = BTreeSet::new();
+        for line in text.lines() {
+            let line = line.trim();
+            if line.is_empty() {
+                continue;
+            }
+            let first = line
+                .trim_matches('"')
+                .split("\",\"")
+                .next()
+                .unwrap_or("")
+                .trim();
+            if first.is_empty() {
+                continue;
+            }
+            set.insert(first.to_string());
+        }
+
+        return Ok(set
+            .into_iter()
+            .map(|exe| ExecutableOption {
+                app_name: exe.clone(),
+                exe_path: exe,
+            })
+            .collect());
+    }
+
+    #[cfg(not(target_os = "windows"))]
+    {
+        Ok(vec![])
+    }
+}

src-tauri/src/commands/storage_cmd.rs

@@ -37,6 +37,7 @@ pub async fn create_widget(
         opacity: 0.88,
         always_on_top_mode: "focus".to_string(),
         pinned: false,
+        start_on_launch: true,
     };
 
     build_widget_window(&app, &config)?;