feat(notes): v0.7.6 笔记纯本地结构渲染——章节标题+词汇表入笔记（REQ-177~181）

Author: Aparencia

app/src-tauri/src/commands_session.rs

@@ -12,15 +12,19 @@ use std::collections::HashSet;
 use tauri::State;
 
 use crate::ai_protocol::TextFilterDecision;
+use crate::analysis::analyze_session_opt;
 use crate::commands::{normalize_title, AppState, TITLE_MAX_CHARS};
 use crate::db::Db;
 use crate::db_sessions::SESSION_STATUS_RECORDING;
 use crate::note_filter::{apply_ai_decisions, filter_note, NoteFilterResult, PurifyEnv, RULE_VERSION};
+use crate::outline::{detect_outline_smart, OutlineConfig};
+use crate::structure_note::render_note_structure;
 use crate::types::{
     BatchNoteResult, ConvertedNote, NewNote, NewSession, NewSessionOcrBlock, NewSessionSegment,
     Note, Session, SessionDetail, SessionListItem, SessionOcrBlock, SessionSegment, SkippedNote,
 };
 use crate::ui_junk::UiJunkList;
+use crate::video_profile::ProfileKind;
 
 /// 会话列表单页上限。
 const LIST_LIMIT_MAX: u64 = 200;
@@ -189,6 +193,47 @@ fn load_note_material(
     Ok((session, segments, ocr_blocks))
 }
 
+/// 结构渲染接线（v0.7.6 REQ-177/178，双出口共用）。
+///
+/// @ai-context: 在 refresh_screen_points 之后调用——净化/配图/警示行先落定，
+///              结构层在其上叠加章节标题与词汇表块；预览与落库同函数同口径
+///              （REQ-081 单一管线双出口契约）。
+/// @ai-context: 输入为会话原料（segments/ocr_blocks）——章节检测/大纲标题/
+///              术语表均为纯本地规则（analysis/outline/glossary 复用）——
+///              不依赖云端 AI（本地优先铁律）；失败不阻断转笔记主链路
+///              （分析失败按空结构处理，不抛错）。
+fn apply_note_structure(
+    result: &mut NoteFilterResult,
+    db: &Db,
+    session: &Session,
+    segments: &[SessionSegment],
+    ocr_blocks: &[SessionOcrBlock],
+    env: &PurifyEnv,
+) {
+    // 档案驱动：章节检测/术语表按档案开关（网课开、口播关——analysis 内部门控）
+    let kind = session
+        .profile
+        .as_deref()
+        .map(ProfileKind::parse)
+        .unwrap_or(ProfileKind::Lecture);
+    let detail = SessionDetail {
+        session: session.clone(),
+        segments: segments.to_vec(),
+        ocr_blocks: ocr_blocks.to_vec(),
+        events: db.list_events(session.id).unwrap_or_default(),
+        screens: Vec::new(),
+    };
+    let analysis = analyze_session_opt(&detail, kind, &env.symbol);
+    let outline = detect_outline_smart(ocr_blocks, &result.ocr_screens, &OutlineConfig::default());
+    let _ = render_note_structure(
+        result,
+        &analysis.chapters,
+        &outline,
+        &analysis.glossary,
+        &env.config.structure,
+    );
+}
+
 /// 会话 → 笔记核心（v0.7.1 提取：单条与批量共用同一管线）。
 ///
 /// @ai-context: REQ-082：过滤链（UI 垃圾/重复合并/碎片/低置信/口语净化/口头禅
@@ -225,6 +270,9 @@ fn convert_to_note(
     // 重建口径一致；警示为正文行，用户可手动删除）
     crate::note_filter::apply_session_warning(&mut result, &session.status);
     crate::note_filter::refresh_screen_points(&mut result);
+    // v0.7.6（REQ-177/178）：结构渲染——章节标题 + 词汇表块（纯本地增强层；
+    // 无结构数据/分析失败 → 原样输出不阻断，见 apply_note_structure）
+    apply_note_structure(&mut result, db, &session, &segments, &ocr_blocks, env);
     let new = NewNote {
         title: result.title.clone(),
         content: result.markdown.clone(),
@@ -344,28 +392,27 @@ pub async fn batch_session_to_note(
 ///              kept 段），前端展示过滤统计卡/对照复查/一键落库。
 /// @ai-context: v0.7.3（REQ-160）：ocr_screens attach 归档图（预览屏卡配图；
 ///              目录缺失/无图 → 纯文本降级）。
+/// @ai-context: v0.7.6（REQ-177/178）：预览与落库同口径——结构渲染（章节
+///              标题 + 词汇表块）在预览即生效。
 #[tauri::command]
 pub async fn preview_session_note(
     state: State<'_, AppState>,
     id: i64,
 ) -> Result<NoteFilterResult, String> {
     let (session, segments, ocr_blocks) = load_note_material(&state.db, id)?;
-    let mut result = filter_note(
-        &session.title,
-        &segments,
-        &ocr_blocks,
-        &state.ui_junk,
-        &PurifyEnv {
-            config: state.purify.clone(),
-            symbol: state.symbol_normalize.clone(),
-            corrections: state.ocr_corrections.clone(),
-        },
-    );
+    let env = PurifyEnv {
+        config: state.purify.clone(),
+        symbol: state.symbol_normalize.clone(),
+        corrections: state.ocr_corrections.clone(),
+    };
+    let mut result = filter_note(&session.title, &segments, &ocr_blocks, &state.ui_junk, &env);
     let images_dir = state.data_dir.join("session-images").join(id.to_string());
     crate::screens::attach_images(&mut result.ocr_screens, &images_dir);
     // v0.7.5（REQ-170）：预览与落库同口径——异常会话预览即带警示行
     crate::note_filter::apply_session_warning(&mut result, &session.status);
     crate::note_filter::refresh_screen_points(&mut result);
+    // v0.7.6（REQ-177/178）：结构渲染（与 convert_to_note 同函数同口径）
+    apply_note_structure(&mut result, &state.db, &session, &segments, &ocr_blocks, &env);
     Ok(result)
 }
 

app/src-tauri/src/lib.rs

@@ -149,6 +149,8 @@ mod streaming_asr;
 mod structure_engine;
 mod structure_models;
 mod structure_tier;
+// v0.7.6（REQ-177/178）：笔记结构渲染层——章节标题 + 词汇表块（纯函数）
+mod structure_note;
 mod stutter_fold;
 mod subtitle;
 mod subtitle_detect;

app/src-tauri/src/note_filter.rs

@@ -42,8 +42,8 @@ pub struct PurifyEnv {
 }
 
 /// 笔记规则版本（REQ-171：notes.rule_version 落库值——笔记可回答"用哪版规则
-/// 生成"；净化链每次规则变更递增）。
-pub const RULE_VERSION: &str = "note-rules-0.7.5";
+/// 生成"；净化链每次规则变更递增；v0.7.6 结构渲染层接入 REQ-177~181）。
+pub const RULE_VERSION: &str = "note-rules-0.7.6";
 
 /// 口头禅词集（REQ-163 删除判定 + REQ-085 AI Filler 候选共用）。
 ///
@@ -117,6 +117,15 @@ pub struct FilterStats {
     /// v0.7.5 扩展：修辞问句删除数（自问自答）
     #[serde(default)]
     pub rhetorical: usize,
+    /// v0.7.6（REQ-180）：结构渲染——插入的章节标题数
+    #[serde(default)]
+    pub chapters: usize,
+    /// v0.7.6（REQ-180）：结构渲染——有 outline 标题命中的章节数
+    #[serde(default)]
+    pub titled_chapters: usize,
+    /// v0.7.6（REQ-180）：结构渲染——词汇表条目数
+    #[serde(default)]
+    pub glossary_terms: usize,
 }
 
 /// 合并条目（相邻重复合并 / AI merge 展示层拼接）。

app/src-tauri/src/note_filter_golden_tests.rs

@@ -300,3 +300,92 @@ fn open_question_kept_in_note() {
     assert_eq!(result.stats.rhetorical, 0);
     assert!(result.markdown.contains("大家思考一下为什么"));
 }
+
+// ────────────────────────────────────────────────
+// v0.7.6 扩展（REQ-181）：结构渲染黄金语料——章节标题 + 词汇表
+// ────────────────────────────────────────────────
+
+/// 会话31 实证：净化产物 → 结构渲染叠加章节标题（outline 命中命名）。
+///
+/// @ai-context: 模拟命令层接线顺序（filter_note → apply_session_warning →
+///              refresh_screen_points → render_note_structure）；章节边界由
+///              chapter_detect 语义构造（网课档案）——本测试钉结构渲染产出，
+///              章节检测本身由 chapter_detect_tests 覆盖。
+#[test]
+fn session31_structure_chapter_headings_from_outline() {
+    // Arrange：两章内容（边界 9000ms/30000ms）+ 章节窗口内 outline 标题
+    let segments = vec![
+        asr(1, 0, 5000, "项目启动是一个艺术"),
+        asr(2, 10_000, 15_000, "这是项目章程"),
+        asr(3, 35_000, 40_000, "这是项目范围说明书"),
+    ];
+    let blocks = vec![
+        block(2_000, "项目启动", 0.9),
+        block(12_000, "项目章程", 0.9),
+        block(36_000, "项目范围", 0.9),
+    ];
+    let mut result = run("测试", &segments, &blocks);
+    // Act：命令层接线语义——警示行（finished 无）+ 刷新 + 结构渲染
+    apply_session_warning(&mut result, "finished");
+    refresh_screen_points(&mut result);
+    let chapters = vec![
+        crate::chapter_detect::ChapterBoundary { time_ms: 9_000, votes: 2, topic_drop: 0.5 },
+        crate::chapter_detect::ChapterBoundary { time_ms: 30_000, votes: 2, topic_drop: 0.4 },
+    ];
+    let outline = vec![
+        crate::outline::OutlineEntry { time_ms: 12_000, text: "项目章程".to_string() },
+        crate::outline::OutlineEntry { time_ms: 36_000, text: "项目范围".to_string() },
+    ];
+    let _ = crate::structure_note::render_note_structure(
+        &mut result,
+        &chapters,
+        &outline,
+        &[],
+        &crate::structure_note::NoteStructureConfig::default(),
+    );
+    // Assert：两章标题带时间锚点；章节名取各自窗口内 outline 标题
+    // （第一章窗口 [9s,30s) 命中 12s"项目章程"；第二章窗口 [30s,∞) 命中
+    // 36s"项目范围"——窗口归属正确，跨窗口不串）
+    assert!(result.markdown.contains("## 项目章程 [00:09]"), "第一章取窗口内标题");
+    assert!(result.markdown.contains("## 项目范围 [00:30]"), "第二章取窗口内标题");
+    // 统计可序列化（purify_stats 落库口径）
+    let json = serde_json::to_string(&result.stats).expect("stats serializable");
+    assert!(json.contains("chapters") && json.contains("titled_chapters"));
+}
+
+/// 会话31 实证：结构渲染词汇表块——术语候选 → 尾部词汇表（锚点回跳）。
+#[test]
+fn session31_structure_glossary_block() {
+    // Arrange：术语"项目章程"在 kept 段出现（锚点）；无 kept 出现术语不带锚点
+    let segments = vec![asr(1, 12_000, 15_000, "这是项目章程的要点")];
+    let mut result = run("测试", &segments, &[]);
+    apply_session_warning(&mut result, "finished");
+    refresh_screen_points(&mut result);
+    let glossary = vec![
+        crate::glossary::GlossaryCandidate {
+            term: "项目章程".to_string(),
+            ocr_count: 5,
+            asr_count: 1,
+            score: 8.0,
+        },
+        crate::glossary::GlossaryCandidate {
+            term: "WBS".to_string(),
+            ocr_count: 3,
+            asr_count: 0,
+            score: 3.0,
+        },
+    ];
+    // Act
+    let _ = crate::structure_note::render_note_structure(
+        &mut result,
+        &[],
+        &[],
+        &glossary,
+        &crate::structure_note::NoteStructureConfig::default(),
+    );
+    // Assert：词汇表块在尾部；命中术语带 [MM:SS] 锚点；未命中不带；统计落库
+    assert!(result.markdown.ends_with("词汇表\n\n- [00:12] 项目章程（画面 ×5 / 语音 ×1）\n- WBS（画面 ×3 / 语音 ×0）"));
+    assert_eq!(result.stats.glossary_terms, 2);
+    let json = serde_json::to_string(&result.stats).expect("stats serializable");
+    assert!(json.contains("glossary_terms"));
+}

app/src-tauri/src/purify_config.rs

@@ -64,6 +64,8 @@ pub struct PurifyConfig {
     pub ocr_correct: bool,
     /// 段落时间戳锚点 [MM:SS] 前缀（REQ-165，可开关）
     pub anchor_timestamps: bool,
+    /// v0.7.6（REQ-179）：结构渲染配置（章节标题/词汇表块——嵌套 JSON 可校准）
+    pub structure: crate::structure_note::NoteStructureConfig,
 }
 
 impl Default for PurifyConfig {
@@ -92,6 +94,7 @@ impl Default for PurifyConfig {
             filler_delete: true,
             ocr_correct: true,
             anchor_timestamps: true,
+            structure: crate::structure_note::NoteStructureConfig::default(),
         }
     }
 }