//! 对比模块的命令层。 //! //! 三件事:读取一侧的文件、把一侧的内容写回、对比两棵目录树。文本级差异计算全在前端 //! (`@codemirror/merge`);目录级扫描在 [`super::scan`]。 //! //! # 尺寸上限为什么要有两个 //! //! - [`DIFF_LARGE_MB`]:**软**阈值。超过就置 `large`,前端据此关掉未变化段折叠等 //! 高开销特性 —— 文件照样完整读出来,只是更省。 //! - [`DIFF_HARD_LIMIT`]:**硬**上限。超过直接拒绝。对比窗口天生同时持有两侧内容 //! (不像编辑器只有一篇),单侧 16MB 已经是「两份都塞进 WebView + CM6 状态」的 //! 上限量级;再大不是「慢」而是「卡死」,早拒绝比让用户等一分钟再失败好。 use std::path::Path; use std::time::{Duration, Instant}; use tauri::{AppHandle, Emitter, State}; use crate::editor::files; use super::scan; use super::types::{DiffFileDoc, DiffScanProgress, DiffSettings, DirDiffReport}; use super::DiffManager; /// 「大文件」软阈值(MB)。与编辑器设置的默认值一致。 const DIFF_LARGE_MB: u32 = 5; /// 硬上限(字节):单侧超过则拒绝读取。 const DIFF_HARD_LIMIT: u64 = 16 * 1024 * 1024; /// 二进制探测的头部字节数。**与 `editor::grep` 的判据一致**(头部含 NUL 即二进制), /// 否则会出现「搜索跳过了但对比工具显示了乱码」这种自相矛盾的行为。 const BINARY_SNIFF_BYTES: usize = 8 * 1024; /// 打开文件并读出头部,同时判断是否二进制(头部含 NUL 字节)。 /// /// 返回**同一个已打开的句柄**(读位置停在头部之后)与那段头部:文本文件随后要靠这个 /// 句柄继续整读(见 `files::read_file_after_head`)—— 于是文件只被打开一次,也不会 /// 出现「嗅探时与整读时文件已被换掉」的窗口。二进制则到此为止,绝不整读。 fn open_with_head(path: &Path) -> Result<(std::fs::File, Vec, bool), String> { use std::io::Read; let mut file = std::fs::File::open(path).map_err(|e| format!("读取文件失败: {e}"))?; let mut head = vec![0u8; BINARY_SNIFF_BYTES]; let read = file .read(&mut head) .map_err(|e| format!("读取文件失败: {e}"))?; head.truncate(read); let binary = head.contains(&0u8); Ok((file, head, binary)) } /// 写权限探测:以写模式打开但**不写入**(失败 → 只读)。 /// /// `editor::files` 里同名的函数是私有的(只服务编辑器自己的打开流程),这里重写一遍 /// 三行而不是把它提升为 `pub(crate)`:那个是模块内部细节,把它开放出去会让「谁在读 /// 权限探测」变得不清晰。 fn is_writable(path: &Path) -> bool { std::fs::OpenOptions::new().write(true).open(path).is_ok() } /// 读取对比窗口某一侧的文件。 /// /// 复用 `editor::files::read_file`(编码探测 / 换行归一 / 只读探测),并顺带登记 /// 授权 —— 于是该文件随后可以被 [`diff_write_file`] 写回。 #[tauri::command] #[specta::specta] pub fn diff_read_file(path: String) -> Result { let trimmed = path.trim(); if trimmed.is_empty() { return Err("路径为空".to_string()); } let p = Path::new(trimmed); let meta = std::fs::metadata(p).map_err(|e| format!("读取文件信息失败: {e}"))?; if meta.is_dir() { return Err("这是一个目录 —— 请切到「文件夹」模式并把它设为某一侧".to_string()); } if !meta.is_file() { return Err("目标不是普通文件".to_string()); } if meta.len() > DIFF_HARD_LIMIT { return Err(format!( "文件过大({} MB),超出对比窗口的 {} MB 上限", meta.len() / (1024 * 1024), DIFF_HARD_LIMIT / (1024 * 1024) )); } // 先读头部判断二进制(二进制到此为止、不整读),并把这段头部与**同一个句柄** // 交给文本读取路径复用 —— 同一个文件全程只打开一次 let (file, head, binary) = open_with_head(p)?; if binary { return Ok(DiffFileDoc::binary_of(p, &meta, is_writable(p))); } let doc = files::read_file_after_head(file, p, &meta, &head, DIFF_LARGE_MB)?; // 「打开过就能保存」:读取即登记授权(写回仍会再校验一次授权与写权限) files::authorize(Path::new(&doc.path)); Ok(DiffFileDoc::from_file_doc(doc)) } /// 把某一侧的内容写回磁盘。 /// /// `encoding` / `eol` 由前端回传**读取时探测到的值**,写回时原样还原 —— 一次「随手 /// 保存」不该把 GBK 文件变成 UTF-8、把 CRLF 变成 LF(那会在整个 diff 里掀起风暴)。 #[tauri::command] #[specta::specta] pub fn diff_write_file( path: String, content: String, encoding: String, eol: String, ) -> Result { let doc = files::write_file(&path, &content, &encoding, &eol, DIFF_LARGE_MB)?; Ok(DiffFileDoc::from_file_doc(doc)) } /// 探测一个路径是文件还是目录(`"dir"` / `"file"` / `"missing"`)。 /// /// 用途:拖入或 `?path=` 传进来的路径前端拿不到文件系统元信息,而对比窗口需要据此 /// 决定「进文件模式还是目录模式」。**刻意不新增 Rust 侧的状态**:只读一次 `metadata`, /// 不写盘、不需授权。 #[tauri::command] #[specta::specta] pub fn diff_path_kind(path: String) -> Result { let trimmed = path.trim(); if trimmed.is_empty() { return Err("路径为空".to_string()); } match std::fs::metadata(trimmed) { Ok(meta) if meta.is_dir() => Ok("dir".to_string()), Ok(meta) if meta.is_file() => Ok("file".to_string()), Ok(_) => Ok("missing".to_string()), Err(_) => Ok("missing".to_string()), } } /// 对比两棵目录树(只读)。 /// /// `skip_dirs` 是**目录名**清单(大小写不敏感):默认清单由前端给出(它是界面约定, /// 用户能否修改是 UI 的事),后端只负责按它执行 —— 同 `editor::grep` 把默认跳过清单 /// 留在前端的取舍。 /// /// 走 `spawn_blocking`:两遍目录遍历 + 最多 2000 次读盘都是同步阻塞 IO,放在 Tauri /// 命令线程上会占住它(范式同 `editor_search_in_path`)。 /// /// `scan_id` 由前端生成并随进度事件原样回传:进度事件是全局的,多选项卡并发扫描时 /// 前端据此只认自己那一轮(见 `constants::events::DIFF_SCAN_PROGRESS`)。 #[tauri::command] #[specta::specta] pub async fn diff_compare_dirs( app: AppHandle, scan_id: u64, left: String, right: String, skip_dirs: Vec, compare_content: bool, ) -> Result { tauri::async_runtime::spawn_blocking(move || { // 进度按**时间**节流(≥120ms 才发一条):整棵树可能有上万个条目、上千次读盘, // 逐条 emit 会把 IPC 打满;而按条目数节流在「条目少但每个都很大」时又会太稀。 // 最后一条进度由前端在命令返回时清掉,不依赖这里补齐。 let mut last_emit = Instant::now(); let mut progress = |phase: scan::ScanPhase, done: u64, total: u64| { if last_emit.elapsed() < Duration::from_millis(120) { return; } last_emit = Instant::now(); let phase = match phase { scan::ScanPhase::Walk => "scan", scan::ScanPhase::Compare => "compare", }; let payload = DiffScanProgress { scan_id, phase: phase.to_string(), done, total, }; let _ = app.emit(crate::constants::events::DIFF_SCAN_PROGRESS, payload); }; scan::compare_dirs(&left, &right, &skip_dirs, compare_content, &mut progress) }) .await .map_err(|e| format!("目录对比任务失败: {e}"))? } /// 读取对比模块设置。 #[tauri::command] #[specta::specta] pub fn diff_get_settings(state: State<'_, DiffManager>) -> DiffSettings { state.load_settings() } /// 保存对比模块设置。 /// /// 保存后**就地重注册**全局快捷键(`register_shortcut` 会先注销本模块的旧键,因此 /// 「清空快捷键」也能通过传空串生效)—— 同 `editor_save_settings`。 #[tauri::command] #[specta::specta] pub fn diff_save_settings( app: AppHandle, state: State<'_, DiffManager>, settings: DiffSettings, ) -> Result { let mut next = settings; next.heal(); state.save_settings(&next)?; state.init_on_launch(&app); Ok(next) }