feat(refine): diff_markdown_ops 暴露整篇有序行级 diff 流

Author: Aparencia

app/src-tauri/src/commands_notes_version.rs

@@ -11,7 +11,7 @@ use tauri::State;
 use crate::commands::AppState;
 use crate::db_ai_usage::AiUsageRecord;
 use crate::db_notes_versions::NoteVersion;
-use crate::note_diff::{diff_markdown, diff_sections, DiffOp, SectionDiff};
+use crate::note_diff::{diff_markdown, diff_sections, diff_stats, DiffOp, SectionDiff};
 use crate::types::Note;
 
 /// 版本列表（旧→新；含惰性首快照——旧数据迁移兼容）。
@@ -80,6 +80,31 @@ pub fn diff_markdown_sections(old_md: String, new_md: String) -> Vec<SectionDiff
     diff_sections(&old_md, &new_md)
 }
 
+/// 整篇有序行级 diff 响应（diff_markdown_ops 数据源——三态流 + 行数统计）。
+#[derive(Debug, Clone, serde::Serialize)]
+#[serde(rename_all = "camelCase")]
+pub struct MarkdownDiffOps {
+    /// 有序三态流（base/refined 各行全集划分——LCS 保序，前端按栏消费染色）
+    pub ops: Vec<DiffOp>,
+    pub added: usize,
+    pub removed: usize,
+}
+
+/// 任意两篇 markdown 的整篇有序行级 diff（精修工作台行级标色/差异模式）。
+///
+/// @ai-context Why（批 3 / 用户问题11）：工作台此前只有章节分组
+///              diff_markdown_sections（丢失行间顺序，无法行级染色）；
+///              note_versions_diff 需 DB 版本 id，只读/内存文本对比不可用——
+///              补薄命令直接暴露 note_diff::diff_markdown 全文档流（纯函数
+///              复用，无第二套 diff 引擎）；前端三入口（会话级/笔记级/只读）
+///              统一经本命令对"实际展示的两版文本"取数，保证行与渲染对齐。
+#[tauri::command]
+pub fn diff_markdown_ops(old_md: String, new_md: String) -> MarkdownDiffOps {
+    let ops = diff_markdown(&old_md, &new_md);
+    let (added, removed, _) = diff_stats(&ops);
+    MarkdownDiffOps { ops, added, removed }
+}
+
 /// 读版本并校验归属（diff 输入防御）。
 fn get_version_for_note(state: &AppState, note_id: i64, version_id: i64) -> Result<NoteVersion, String> {
     let v = state
@@ -92,3 +117,66 @@ fn get_version_for_note(state: &AppState, note_id: i64, version_id: i64) -> Resu
     }
     Ok(v)
 }
+
+#[cfg(test)]
+mod tests {
+    use super::*;
+
+    /// AAA：整篇有序流——前后未变行保序、中段删除/新增按原始出现序交错
+    /// （工作台染色按流消费即得各栏行序，无需二次对齐）。
+    #[test]
+    fn diff_markdown_ops_keeps_whole_document_order() {
+        // Arrange：首行未变、中段一删一增、尾行未变
+        let old_md = "甲\n删我\n尾".to_string();
+        let new_md = "甲\n加我\n尾".to_string();
+        // Act
+        let out = diff_markdown_ops(old_md, new_md);
+        // Assert：三态各自一个且有序（unchanged → removed → added）
+        assert_eq!(
+            out.ops,
+            vec![
+                DiffOp::Unchanged("甲".into()),
+                DiffOp::Removed("删我".into()),
+                DiffOp::Added("加我".into()),
+                DiffOp::Unchanged("尾".into()),
+            ]
+        );
+        assert_eq!((out.added, out.removed), (1, 1));
+    }
+
+    /// AAA：空侧边界——单侧全量标记，另一侧无行。
+    #[test]
+    fn diff_markdown_ops_empty_side_counts_every_line() {
+        // Arrange
+        let out = diff_markdown_ops(String::new(), "新增1\n新增2".to_string());
+        // Act/Assert：空基线的整篇都是新增
+        assert_eq!(out.ops.len(), 2);
+        assert!(out.ops.iter().all(|o| matches!(o, DiffOp::Added(_))));
+        assert_eq!((out.added, out.removed), (2, 0));
+
+        let out = diff_markdown_ops("删1\n删2".to_string(), String::new());
+        // Assert：空精修版的整篇都是删除
+        assert!(out.ops.iter().all(|o| matches!(o, DiffOp::Removed(_))));
+        assert_eq!((out.added, out.removed), (0, 2));
+    }
+
+    /// AAA：serde 契约——顶层 camelCase + DiffOp 外部小写标签
+    /// （与前端 types/notes.ts DiffOp 联合类型逐字对齐）。
+    #[test]
+    fn diff_markdown_ops_serializes_camel_case_and_lowercase_tags() {
+        // Arrange/Act
+        let out = diff_markdown_ops("旧\n同".to_string(), "新\n同".to_string());
+        let json = serde_json::to_value(&out).unwrap();
+        // Assert：顶层键 camelCase（ops/added/removed）
+        assert!(json.get("ops").is_some());
+        assert!(json.get("added").is_some());
+        assert!(json.get("removed").is_some());
+        assert!(json.get("ops").unwrap().is_array());
+        // Assert：op 条目为外部小写标签 {removed: "旧"} / {added: "新"} / {unchanged: "同"}
+        assert_eq!(json["ops"][0]["removed"], "旧");
+        assert_eq!(json["ops"][1]["added"], "新");
+        assert_eq!(json["ops"][2]["unchanged"], "同");
+        assert_eq!(json["added"], 1);
+        assert_eq!(json["removed"], 1);
+    }
+}

app/src-tauri/src/lib.rs

@@ -934,6 +934,9 @@ pub fn run() {
             commands_notes_version::note_versions_usage,
             commands_notes_version::note_by_session,
             commands_notes_version::diff_markdown_sections,
+            // 批 3（问题11）：整篇有序行级 diff（精修工作台三入口统一取数——
+            // 章节分组 diff 丢失行间顺序，note_versions_diff 需 DB 版本 id）
+            commands_notes_version::diff_markdown_ops,
             // 结构模型与课后精修（REQ-047/049/050 模型版：下载/状态/精修）
             commands_refine::structure_model_download,
             commands_refine::structure_model_status,

app/src/types/notes.ts

@@ -217,6 +217,14 @@ export interface NoteVersion {
 /** 段级 diff 操作（Rust DiffOp：三态外部标签） */
 export type DiffOp = { unchanged: string } | { added: string } | { removed: string };
 
+/** 整篇有序行级 diff 响应（Rust MarkdownDiffOps；camelCase——diff_markdown_ops：
+ * 工作台行级染色/差异模式数据源，ops 按 base/refined 原始出现序交错） */
+export interface MarkdownDiffOps {
+  ops: DiffOp[];
+  added: number;
+  removed: number;
+}
+
 /** AI 成本记录（Rust AiUsageRecord；camelCase 契约） */
 export interface AiUsageRecord {
   id: number;