feat: add recent files list and entry point

Add a recent-files model, widget, and home-screen integration
so users can quickly reopen recently accessed workbooks.

Author: uednd

Cargo.lock

@@ -9,6 +9,7 @@ edition = "2024"
 [dependencies]
 color-eyre = "0.6.3"
 crossterm = "0.29.0"
+dirs-next = "2"
 ratatui = "0.30.1"
 arboard = "3"
 replace-homedir = "0.1"

Cargo.toml

@@ -1,4 +1,7 @@
-use std::time::{Duration, Instant};
+use std::{
+    path::PathBuf,
+    time::{Duration, Instant},
+};
 
 use crossterm::event::{self, Event, KeyCode, KeyEventKind, KeyModifiers, MouseEventKind};
 use ratatui::{
@@ -10,6 +13,7 @@ use ratatui::{
 
 use crate::{
     exit::ExitHandler,
+    model::{recent::RecentFiles, table_path::resolve_table_path},
     screen::{EventResult, FrameState, Screen, ScreenCommand, home::MenuScreen},
     theme::Theme,
     widget::footer::Footer,
@@ -44,25 +48,33 @@ impl BlinkState {
 
 pub struct App {
     theme: Theme,
-    cwd: String,
+    cwd: PathBuf,
+    recent: RecentFiles,
     active_screen: Box<dyn Screen>,
     exit_handler: ExitHandler,
     blink: BlinkState,
     footer: Footer,
 }
 
 impl App {
-    pub fn new() -> Self {
-        let full_cwd = std::env::current_dir()
-            .map(|p| p.display().to_string())
-            .unwrap_or_else(|_| String::from("."));
-        let display_cwd = replace_homedir::replace_homedir(&full_cwd, "~");
+    pub fn new(initial_file: Option<String>) -> Self {
+        let cwd = std::env::current_dir().unwrap_or_else(|_| PathBuf::from("."));
+        let display_cwd = replace_homedir::replace_homedir(&cwd.display().to_string(), "~");
         let theme = Theme::dark();
+        let mut recent = RecentFiles::load();
+        let active_screen: Box<dyn Screen> = if let Some(file) = initial_file {
+            let path = resolve_table_path(&file, &cwd);
+            recent.add(&path);
+            Box::new(crate::screen::editor::TableScreen::new(theme, path))
+        } else {
+            Box::new(MenuScreen::new(theme, cwd.clone(), recent.items().to_vec()))
+        };
 
         Self {
             theme,
-            cwd: full_cwd.clone(),
-            active_screen: Box::new(MenuScreen::new(theme, full_cwd)),
+            cwd,
+            recent,
+            active_screen,
             exit_handler: ExitHandler::new(Duration::from_secs(1)),
             blink: BlinkState::new(),
             footer: Footer::new(display_cwd, APP_VERSION.to_string(), theme),
@@ -151,11 +163,24 @@ impl App {
     fn process_cmd(&mut self, cmd: ScreenCommand) {
         match cmd {
             ScreenCommand::OpenEditor { path } => {
+                self.recent.add(&path);
                 self.active_screen =
                     Box::new(super::screen::editor::TableScreen::new(self.theme, path));
             }
+            ScreenCommand::RemoveRecent { path } => {
+                self.recent.remove(&path);
+                self.active_screen = Box::new(MenuScreen::new(
+                    self.theme,
+                    self.cwd.clone(),
+                    self.recent.items().to_vec(),
+                ));
+            }
             ScreenCommand::GoHome => {
-                self.active_screen = Box::new(MenuScreen::new(self.theme, self.cwd.clone()));
+                self.active_screen = Box::new(MenuScreen::new(
+                    self.theme,
+                    self.cwd.clone(),
+                    self.recent.items().to_vec(),
+                ));
             }
         }
     }

src/app.rs

@@ -12,7 +12,8 @@ mod widget;
 
 fn main() -> color_eyre::Result<()> {
     color_eyre::install()?;
-    let mut app = app::App::new();
+    let initial_file = std::env::args().nth(1);
+    let mut app = app::App::new(initial_file);
     ratatui::run(|terminal| {
         crossterm::execute!(std::io::stdout(), crossterm::event::EnableMouseCapture)?;
         let result = app.run(terminal);

src/main.rs

@@ -1,4 +1,6 @@
 pub mod cell;
 pub mod formula;
 pub mod limits;
+pub mod recent;
+pub mod table_path;
 pub mod workbook;

src/model/mod.rs

@@ -0,0 +1,125 @@
+use serde::{Deserialize, Serialize};
+use std::{
+    fs,
+    path::{Path, PathBuf},
+    time::{SystemTime, UNIX_EPOCH},
+};
+
+const RECENT_LIMIT: usize = 10;
+
+#[derive(Debug, Clone, Serialize, Deserialize, PartialEq, Eq)]
+pub struct RecentFile {
+    pub path: PathBuf,
+    pub name: String,
+    pub opened_at: u64,
+}
+
+/// 最近打开文件的数据源。
+///
+/// App 持有该类型；UI 只读取 `items()` 并通过命令请求修改。
+pub struct RecentFiles {
+    storage_path: PathBuf,
+    items: Vec<RecentFile>,
+}
+
+impl RecentFiles {
+    pub fn load() -> Self {
+        let storage_path = recent_json_path();
+        let items = fs::read_to_string(&storage_path)
+            .ok()
+            .and_then(|raw| serde_json::from_str::<Vec<RecentFile>>(&raw).ok())
+            .map(normalize_items)
+            .unwrap_or_default();
+
+        Self {
+            storage_path,
+            items,
+        }
+    }
+
+    pub fn items(&self) -> &[RecentFile] {
+        &self.items
+    }
+
+    pub fn add(&mut self, path: impl AsRef<Path>) {
+        let path = stable_path(path.as_ref());
+        self.items
+            .retain(|file| !same_stable_path(&file.path, &path));
+        self.items.insert(
+            0,
+            RecentFile {
+                name: display_name(&path),
+                path,
+                opened_at: now_secs(),
+            },
+        );
+        self.items.truncate(RECENT_LIMIT);
+        self.save();
+    }
+
+    pub fn remove(&mut self, path: impl AsRef<Path>) {
+        let path = stable_path(path.as_ref());
+        self.items
+            .retain(|file| !same_stable_path(&file.path, &path));
+        self.save();
+    }
+
+    fn save(&self) {
+        if let Some(parent) = self.storage_path.parent() {
+            let _ = fs::create_dir_all(parent);
+        }
+        if let Ok(json) = serde_json::to_string_pretty(&self.items) {
+            let _ = fs::write(&self.storage_path, json);
+        }
+    }
+}
+
+pub fn recent_json_path() -> PathBuf {
+    dirs_next::config_dir()
+        .unwrap_or_else(|| PathBuf::from("."))
+        .join("mini-excel")
+        .join("recent.json")
+}
+
+fn normalize_items(mut items: Vec<RecentFile>) -> Vec<RecentFile> {
+    items.sort_by(|a, b| b.opened_at.cmp(&a.opened_at));
+
+    let mut unique = Vec::new();
+    for item in items {
+        let path = stable_path(&item.path);
+        if unique.iter().any(|file: &RecentFile| file.path == path) {
+            continue;
+        }
+        unique.push(RecentFile {
+            name: display_name(&path),
+            path,
+            opened_at: item.opened_at,
+        });
+        if unique.len() == RECENT_LIMIT {
+            break;
+        }
+    }
+    unique
+}
+
+fn stable_path(path: &Path) -> PathBuf {
+    path.canonicalize().unwrap_or_else(|_| path.to_path_buf())
+}
+
+fn same_stable_path(candidate: &Path, stable: &Path) -> bool {
+    stable_path(candidate) == stable
+}
+
+fn display_name(path: &Path) -> String {
+    path.file_name()
+        .and_then(|name| name.to_str())
+        .unwrap_or("untitled.mxlsx")
+        .to_string()
+}
+
+fn now_secs() -> u64 {
+    SystemTime::now()
+        .duration_since(UNIX_EPOCH)
+        .unwrap_or_default()
+        .as_secs()
+}

src/model/recent.rs

@@ -0,0 +1,20 @@
+use std::path::{Path, PathBuf};
+
+const TABLE_EXTENSION: &str = "mxlsx";
+
+pub fn resolve_table_path(input: &str, cwd: &Path) -> PathBuf {
+    let raw = PathBuf::from(input);
+    let with_extension = if raw.extension().is_some() {
+        raw
+    } else {
+        raw.with_extension(TABLE_EXTENSION)
+    };
+
+    let absolute = if with_extension.is_absolute() {
+        with_extension
+    } else {
+        cwd.join(with_extension)
+    };
+
+    absolute
+}

src/model/table_path.rs

@@ -6,6 +6,7 @@ use crate::{
     screen::ScreenCommand,
     theme::Theme,
 };
+use std::path::PathBuf;
 
 use super::{mode::Selection, viewport::Viewport};
 
@@ -16,7 +17,7 @@ use super::{mode::Selection, viewport::Viewport};
 pub struct TableContext {
     pub theme: Theme,
     pub viewport: Viewport,
-    path: String,
+    path: PathBuf,
     wb: Workbook,
     selection: Option<Selection>,
     copied_region: Option<Selection>,
@@ -35,7 +36,7 @@ pub struct SelectionStats {
 
 impl TableContext {
     /// 创建编辑器共享状态。
-    pub fn new(theme: Theme, path: String, wb: Workbook) -> Self {
+    pub fn new(theme: Theme, path: PathBuf, wb: Workbook) -> Self {
         Self {
             theme,
             path,

src/screen/editor/context.rs

@@ -9,6 +9,7 @@ mod viewport;
 
 use crossterm::event::{KeyEvent, MouseEvent, MouseEventKind};
 use ratatui::{Frame, layout::Rect, style::Style, widgets::Block};
+use std::path::PathBuf;
 
 use crate::{
     model::{
@@ -34,9 +35,9 @@ pub struct TableScreen {
 }
 
 impl TableScreen {
-    pub fn new(theme: Theme, path: String) -> Self {
+    pub fn new(theme: Theme, path: PathBuf) -> Self {
         let wb = Workbook::load(&path).unwrap_or_else(|_| {
-            let name = std::path::Path::new(&path)
+            let name = path
                 .file_stem()
                 .and_then(|s| s.to_str())
                 .unwrap_or("untitled")