//! 「用 Thing 打开」的参数解析与事件投递。 //! //! # 两条入口,同一份逻辑 //! //! 1. **冷启动**:安装器注册的文件关联让 Windows 用 `thing.exe <文件路径>` 启动本应用; //! 2. **热启动**:应用已在运行时双击 `.md`,会起第二个进程,由 //! `tauri-plugin-single-instance` 把它的命令行参数转交给第一个实例。 //! //! 两条路径的输入形态完全一样(都是命令行参数),因此共用 [`note_path_from_args`]。 //! 解析成功后统一发 [`crate::constants::events::NOTES_OPEN_FILE`],**窗口由前端创建** —— //! Rust 侧不持有窗口 label 策略,也不该知道「用户是不是想让它在已有窗口里打开」。 use std::path::{Path, PathBuf}; use std::sync::Mutex; /// 「启动时命令行指定的文件」缓存。 /// /// # 为什么需要缓存而不是启动时直接 `emit` /// /// 冷启动的顺序是:`setup` 跑完 → 创建主窗口 → WebView 加载前端 → 前端注册监听。 /// 在 `setup` 里 `emit` 时前端还没开始监听,事件**直接丢掉**了 —— 表现是 /// 「双击 .md 打开了应用,但笔记没打开」。 /// /// 因此这里把路径存下来,由前端在注册完监听后**主动取一次** /// (`notes_take_pending_file`)。取走即清空,避免下次打开窗口时又被翻出来。 static PENDING: std::sync::OnceLock>> = std::sync::OnceLock::new(); fn pending_slot() -> &'static Mutex> { PENDING.get_or_init(|| Mutex::new(None)) } /// 记下「启动时想打开的文件」(由 `setup` 调用)。 pub fn remember_pending_file(path: PathBuf) { if let Ok(mut slot) = pending_slot().lock() { *slot = Some(path); } } /// 取出并清空待打开文件(由 `notes_take_pending_file` 命令调用)。 pub fn take_pending_file() -> Option { pending_slot() .lock() .ok() .and_then(|mut slot| slot.take()) } /// 从一组命令行参数里挑出「看起来是笔记文件」的那个路径。 /// /// # 为什么需要挑而不是直接用 `args[1]` /// /// 关联启动时命令行长这样:`thing.exe D:\笔记\会议.md`; /// 但从「开始菜单 → 打开」启动时可能有别的开关参数;开发模式下还有 `cargo run --`。 /// 这里只认「**存在**的文件 + 笔记类扩展名」,其余一律忽略 —— /// 宁可漏开一个窗口,也不要因为一个参数把主窗口的启动逻辑搞乱。 /// /// 认的扩展名比「只有 .md」宽一点:`.markdown` / `.mdx` 也常见,且编辑器都能处理 /// (打开后走「库外文件」路径,不影响库内笔记的 `.md` 约定)。 /// /// # 为什么要 `.is_file()` /// /// 参数里出现 `foo.md` 但那个文件其实不存在(用户删了、路径编码错了)时, /// 让前端去报「文件不存在」不如在这里就静默忽略 —— 前端那条路径会开一个空窗口。 pub fn note_path_from_args>(args: I) -> Option { for arg in args { let trimmed = arg.trim().trim_matches('"'); if trimmed.is_empty() || trimmed.starts_with('-') { continue; } let lower = trimmed.to_ascii_lowercase(); let is_note_ext = lower.ends_with(".md") || lower.ends_with(".markdown") || lower.ends_with(".mdx"); if !is_note_ext { continue; } let path = PathBuf::from(trimmed); if path.is_file() { return Some(path); } } None } /// 通知前端「要打开这个文件」(窗口由前端创建)。 pub fn emit_open_file(app: &tauri::AppHandle, path: &Path) { use tauri::Emitter; let payload = serde_json::json!({ "path": path.to_string_lossy() }); if let Err(e) = app.emit(crate::constants::events::NOTES_OPEN_FILE, payload) { crate::logger::log_warn("notes", &format!("发出打开文件事件失败: {e}")); } } #[cfg(test)] mod tests { use super::*; fn temp_note(name: &str) -> PathBuf { let dir = std::env::temp_dir().join(format!("thing-notes-args-{}", std::process::id())); std::fs::create_dir_all(&dir).unwrap(); let path = dir.join(name); std::fs::write(&path, "# x").unwrap(); path } #[test] fn picks_markdown_path_and_ignores_flags() { let note = temp_note("会议.md"); let args = vec![ "--some-flag".to_string(), "not-a-file".to_string(), note.to_string_lossy().to_string(), ]; assert_eq!(note_path_from_args(args), Some(note.clone())); let _ = std::fs::remove_file(¬e); let _ = std::fs::remove_dir_all(note.parent().unwrap()); } #[test] fn accepts_markdown_and_mdx_too() { let note = temp_note("a.markdown"); assert_eq!( note_path_from_args(vec![note.to_string_lossy().to_string()]), Some(note.clone()) ); let _ = std::fs::remove_file(¬e); let _ = std::fs::remove_dir_all(note.parent().unwrap()); } #[test] fn ignores_non_markdown_and_missing_files() { // 非笔记扩展名 assert_eq!(note_path_from_args(vec!["C:\\a\\b.txt".to_string()]), None); // 不存在的 .md:静默忽略(否则会开一个空窗口) assert_eq!( note_path_from_args(vec!["C:\\definitely\\missing\\x.md".to_string()]), None ); // 空参数与开关 assert_eq!( note_path_from_args(vec!["".to_string(), "-v".to_string()]), None ); } #[test] fn strips_surrounding_quotes() { let note = temp_note("带 空格.md"); let quoted = format!("\"{}\"", note.to_string_lossy()); assert_eq!(note_path_from_args(vec![quoted]), Some(note.clone())); let _ = std::fs::remove_file(¬e); let _ = std::fs::remove_dir_all(note.parent().unwrap()); } }