编辑器模块(笔记)初版

This commit is contained in:
zhongluofeng committed 2026-09-30 18:12:53 +08:00
1 parent 7e65825d3e
commit ad987111a3
66 files changed
+17470 -283

No files matched your search

+153
View File
@@ -0,0 +1,153 @@
//! 「用 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<Mutex<Option<PathBuf>>> = std::sync::OnceLock::new();
fn pending_slot() -> &'static Mutex<Option<PathBuf>> {
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<PathBuf> {
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<I: IntoIterator<Item = String>>(args: I) -> Option<PathBuf> {
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(&note);
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(&note);
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(&note);
let _ = std::fs::remove_dir_all(note.parent().unwrap());
}
}