refactor(rust): 拆 types.rs 第 4 步 — 会话 OCR 与屏卡域

Author: Aparencia

app/src-tauri/src/types.rs

@@ -14,10 +14,13 @@ mod types_session;
 mod types_knowledge;
 #[path = "types_note.rs"]
 mod types_note;
+#[path = "types_ocr.rs"]
+mod types_ocr;
 
 pub use types_session::*;
 pub use types_knowledge::*;
 pub use types_note::*;
+pub use types_ocr::*;
 
 /// 单条 ASR 转写片段。
 ///
@@ -101,99 +104,6 @@ pub struct NoteDraft {
     pub markdown: String,
 }
 
-/// 会话 OCR 块（关键帧画面文字 / 字幕区文字）。
-///
-/// @ai-context: region 取 subtitle | full（ADR-005：字幕区高频采样 vs 全帧低频采样）。
-/// @ai-context: v0.5.0 M4（REQ-048）：region_kind 为分区域 OCR 的版面类型标注
-///              （text/table/formula/code/unknown；旧数据/整帧直跑为 None）。
-/// @ai-context: v0.7.3（REQ-156，ADR-015）：bbox/screen_id 为屏卡体系的落库列——
-///              bbox 为检测框（帧坐标系，JSON {x,y,w,h}），screen_id 为采集时
-///              分配的屏号（NULL=旧数据无屏，视图层聚类兜底）。
-#[derive(Debug, Clone, Serialize, Deserialize, PartialEq)]
-pub struct SessionOcrBlock {
-    pub id: i64,
-    pub session_id: i64,
-    /// 关键帧相对会话起点的毫秒时间戳
-    pub timestamp_ms: u64,
-    pub text: String,
-    /// 识别置信度 0.0-1.0
-    pub score: f32,
-    /// subtitle | full
-    pub region: String,
-    /// 来源版面区域类型（kebab-case；None=整帧直跑/旧数据）
-    pub region_kind: Option<String>,
-    /// 检测框（帧坐标系；None=旧数据/无 bbox——下游必须容忍缺省）
-    #[serde(default)]
-    pub bbox: Option<TextBox>,
-    /// 屏号（采集时分配，会话内递增；None=旧数据无屏）
-    #[serde(default)]
-    pub screen_id: Option<i64>,
-}
-
-/// 新增会话 OCR 块入参。
-#[derive(Debug, Clone, Serialize, Deserialize, PartialEq)]
-pub struct NewSessionOcrBlock {
-    pub session_id: i64,
-    pub timestamp_ms: u64,
-    pub text: String,
-    pub score: f32,
-    pub region: String,
-    /// 来源版面区域类型（kebab-case；None=整帧直跑）
-    pub region_kind: Option<String>,
-    /// 检测框（帧坐标系；None=未知）
-    #[serde(default)]
-    pub bbox: Option<TextBox>,
-    /// 屏号（None=旧路径不分配）
-    #[serde(default)]
-    pub screen_id: Option<i64>,
-}
-
-/// 屏内结构块（表格/公式/代码区域，v0.7.3 REQ-159）。
-///
-/// @ai-context: 结构块不参与行合并（版面角色独立）；rendered 为精修产物
-///              （表格 Markdown / 公式 LaTeX / 代码原样），None=未精修/失败降级。
-#[derive(Debug, Clone, Serialize, Deserialize, PartialEq)]
-pub struct ScreenStructure {
-    /// table | formula | code
-    pub kind: String,
-    /// 原始 OCR 文本（未精修）
-    pub text: String,
-    /// 精修渲染产物（None=未精修/失败，徽标降级）
-    #[serde(default)]
-    pub rendered: Option<String>,
-}
-
-/// 画面要点屏（v0.7.3 REQ-155/158/160，ADR-015）。
-///
-/// @ai-context: 屏 = 老师翻一次页到下一个画面之间的静止画面——课堂记忆的天然单位。
-///              first_seen/last_seen 为屏内块最早/最晚时间戳（派生自成员块，
-///              不建屏表，ADR-006 派生视图传统）；image_ref 为 first_seen 时刻
-///              最近的归档 full 图（相对路径，asset:// 消费）。
-#[derive(Debug, Clone, Serialize, Deserialize, PartialEq)]
-pub struct SessionScreen {
-    pub session_id: i64,
-    /// 屏号（None=旧数据聚类派生）
-    #[serde(default)]
-    pub screen_id: Option<i64>,
-    pub first_seen_ms: u64,
-    pub last_seen_ms: u64,
-    /// 标题角色行（大字块；None=无 bbox 降级/无标题）
-    #[serde(default)]
-    pub title: Option<String>,
-    /// 正文行（行合并后，按阅读顺序）
-    #[serde(default)]
-    pub body: Vec<String>,
-    /// 图注/标签（短词，按位置排序）
-    #[serde(default)]
-    pub labels: Vec<String>,
-    /// 归档 full 图相对路径（None=无匹配图）
-    #[serde(default)]
-    pub image_ref: Option<String>,
-    /// 结构块（表格/公式/代码区域）
-    #[serde(default)]
-    pub structure: Vec<ScreenStructure>,
-}
-
 /// 决策/应用记录（v0.13.3 REQ-208；一表两面，kind 区分）。
 ///
 /// @ai-context: 对应 knowledge_decisions 表——decision=思辨面（决策），application=学习面

app/src-tauri/src/types_ocr.rs

@@ -0,0 +1,99 @@
+//! @ai-context: 会话 OCR 落库块与画面要点屏（REQ-155~160 / ADR-005 / ADR-015）：关键帧文字块、屏内结构块、屏卡。
+//! @ai-context: 纯数据定义（0 impl / 0 IO / 0 副作用）；与引擎层内存态 OcrBlock（types_extract）语义不同——本文是落库/视图契约。
+//! @ai-context: 由 types.rs 门面 `#[path]` 声明 + `pub use` 再导出 ⇒ crate::types::X 引用路径逐字不变。
+
+use serde::{Deserialize, Serialize};
+use super::TextBox;
+
+/// 会话 OCR 块（关键帧画面文字 / 字幕区文字）。
+///
+/// @ai-context: region 取 subtitle | full（ADR-005：字幕区高频采样 vs 全帧低频采样）。
+/// @ai-context: v0.5.0 M4（REQ-048）：region_kind 为分区域 OCR 的版面类型标注
+///              （text/table/formula/code/unknown；旧数据/整帧直跑为 None）。
+/// @ai-context: v0.7.3（REQ-156，ADR-015）：bbox/screen_id 为屏卡体系的落库列——
+///              bbox 为检测框（帧坐标系，JSON {x,y,w,h}），screen_id 为采集时
+///              分配的屏号（NULL=旧数据无屏，视图层聚类兜底）。
+#[derive(Debug, Clone, Serialize, Deserialize, PartialEq)]
+pub struct SessionOcrBlock {
+    pub id: i64,
+    pub session_id: i64,
+    /// 关键帧相对会话起点的毫秒时间戳
+    pub timestamp_ms: u64,
+    pub text: String,
+    /// 识别置信度 0.0-1.0
+    pub score: f32,
+    /// subtitle | full
+    pub region: String,
+    /// 来源版面区域类型（kebab-case；None=整帧直跑/旧数据）
+    pub region_kind: Option<String>,
+    /// 检测框（帧坐标系；None=旧数据/无 bbox——下游必须容忍缺省）
+    #[serde(default)]
+    pub bbox: Option<TextBox>,
+    /// 屏号（采集时分配，会话内递增；None=旧数据无屏）
+    #[serde(default)]
+    pub screen_id: Option<i64>,
+}
+
+/// 新增会话 OCR 块入参。
+#[derive(Debug, Clone, Serialize, Deserialize, PartialEq)]
+pub struct NewSessionOcrBlock {
+    pub session_id: i64,
+    pub timestamp_ms: u64,
+    pub text: String,
+    pub score: f32,
+    pub region: String,
+    /// 来源版面区域类型（kebab-case；None=整帧直跑）
+    pub region_kind: Option<String>,
+    /// 检测框（帧坐标系；None=未知）
+    #[serde(default)]
+    pub bbox: Option<TextBox>,
+    /// 屏号（None=旧路径不分配）
+    #[serde(default)]
+    pub screen_id: Option<i64>,
+}
+
+/// 屏内结构块（表格/公式/代码区域，v0.7.3 REQ-159）。
+///
+/// @ai-context: 结构块不参与行合并（版面角色独立）；rendered 为精修产物
+///              （表格 Markdown / 公式 LaTeX / 代码原样），None=未精修/失败降级。
+#[derive(Debug, Clone, Serialize, Deserialize, PartialEq)]
+pub struct ScreenStructure {
+    /// table | formula | code
+    pub kind: String,
+    /// 原始 OCR 文本（未精修）
+    pub text: String,
+    /// 精修渲染产物（None=未精修/失败，徽标降级）
+    #[serde(default)]
+    pub rendered: Option<String>,
+}
+
+/// 画面要点屏（v0.7.3 REQ-155/158/160，ADR-015）。
+///
+/// @ai-context: 屏 = 老师翻一次页到下一个画面之间的静止画面——课堂记忆的天然单位。
+///              first_seen/last_seen 为屏内块最早/最晚时间戳（派生自成员块，
+///              不建屏表，ADR-006 派生视图传统）；image_ref 为 first_seen 时刻
+///              最近的归档 full 图（相对路径，asset:// 消费）。
+#[derive(Debug, Clone, Serialize, Deserialize, PartialEq)]
+pub struct SessionScreen {
+    pub session_id: i64,
+    /// 屏号（None=旧数据聚类派生）
+    #[serde(default)]
+    pub screen_id: Option<i64>,
+    pub first_seen_ms: u64,
+    pub last_seen_ms: u64,
+    /// 标题角色行（大字块；None=无 bbox 降级/无标题）
+    #[serde(default)]
+    pub title: Option<String>,
+    /// 正文行（行合并后，按阅读顺序）
+    #[serde(default)]
+    pub body: Vec<String>,
+    /// 图注/标签（短词，按位置排序）
+    #[serde(default)]
+    pub labels: Vec<String>,
+    /// 归档 full 图相对路径（None=无匹配图）
+    #[serde(default)]
+    pub image_ref: Option<String>,
+    /// 结构块（表格/公式/代码区域）
+    #[serde(default)]
+    pub structure: Vec<ScreenStructure>,
+}

app/src-tauri/src/types_session.rs

@@ -3,7 +3,7 @@
 //! @ai-context: 由 types.rs 门面 `#[path]` 声明 + `pub use` 再导出 ⇒ crate::types::X 引用路径逐字不变。
 
 use serde::{Deserialize, Serialize};
-use super::{SessionOcrBlock, SessionScreen};
+use super::types_ocr::{SessionOcrBlock, SessionScreen};
 
 // ────────────────────────────────────────────────────────────
 // 会话领域类型（REQ-010，ADR-004）

docs/standards/line-limit-exemptions.md

@@ -60,11 +60,11 @@
 | app/src/components/KnowledgeCanvasView.tsx | 466 | v0.13.8 画布主视图（RF 装配/拖拽防抖保存/视口持久化/自动排列）；v0.13.9 根卡 + 接线方向动态化；v0.14.1 布局/连线下拉 + 偏好读写（+72 行）+ 审查修复（布局 effect 原子化拆分建边 effect/prefsLoaded 控件门控/hasCore 统一 +31 行）——RF 状态与持久化编排内聚（元素构建已拆至 canvasElements/layout* 纯函数） | 若再增长：偏好读写与下拉拆至 useCanvasPrefs.ts；位置持久化拆至 useCanvasPositions.ts |
 | app/src-tauri/src/streaming_asr_tests.rs | 462 | 流式 ASR 测试域（端点处理/静音判定/段切分回归）单模块 #[path] 挂载 | 若再增长：端点处理组拆至 streaming_endpoint_tests.rs |
 | app/src-tauri/src/structure_note_tests.rs | 458 | v0.7.6（REQ-177~181）：结构渲染层单测域（章节插入位置/命名窗口/词汇表排序上限锚点/零回归护栏/JSON 往返）单模块 #[path] 挂载 | 若再增长：词汇表组拆至 structure_note_glossary_tests.rs |
-| app/src/components/NoteListView.tsx | 450 | 超硬限（>600 行），不允许豁免 —— v0.20.12 批 7 接线 + 审查修复轮 4（refreshToken 组序重拉）净增（646→654）——**超 600 硬限随 TD-2026-09-09-A 登记（值刷新）** | **超硬限必须拆**：拖拽/移动接线拆至 useNoteOrders.ts（既有登记计划兑现） |
 | app/src-tauri/src/db_note_group_clean_tests.rs | 447 | REQ-316（批 7）测试域：判定表（自动/系列/手动/改判/五类残留/影响面外/级联卫生）+ 写路径集成 16 例，单模块 #[path] 挂载 | 若再增长：写路径集成组拆至 db_note_group_clean_flow_tests.rs |
 | app/src-tauri/src/commands_session.rs | 443 | v0.6.0 M6 + v0.7.6 审查硬拆后回归：会话命令域（CRUD/质量报告/课程分组/段搜索）内聚；笔记转换管线已拆至 commands_session_note.rs；M2 修复（search_ocr_blocks 传 data_dir 参数） | 若再增长：course/search 拆至 commands_session_extra.rs |
 | app/src-tauri/src/symbol_normalize.rs | 443 | v0.6.0 M1（REQ-060）：口语符号映射域（映射表/上下文守卫/中文数字解析）内聚；数字解析与守卫共享字符判定 | 若再增长：parse_chinese_number/replace_number_runs 拆至 symbol_numbers.rs |
 | app/src-tauri/src/commands_goals_plan.rs | 442 | 规划＝单次同步调用 + spawn_blocking（10-30s 交互等待可接受，（自动摘取，待细化） | 若再增长：按职责拆分 |
+| app/src/components/NoteListView.tsx | 442 | 超硬限（>600 行），不允许豁免 —— v0.20.12 批 7 接线 + 审查修复轮 4（refreshToken 组序重拉）净增（646→654）——**超 600 硬限随 TD-2026-09-09-A 登记（值刷新）** | **超硬限必须拆**：拖拽/移动接线拆至 useNoteOrders.ts（既有登记计划兑现） |
 | app/src/App.tsx | 439 | 根装配（页面切换/焦点跨页直达状态机/全局事件监听）+ v0.20.5 行动页 + v0.20.10 批 5 复习页 Tab/深链/保活挂载（f702d876）——登记值 363 过期，实测纠偏 | 若再增长：焦点跨页直达 state 族拆至 useFocusRouting.ts |
 | app/src-tauri/src/screens.rs | 437 | v0.7.3（REQ-155/156/160）：画面要点屏构建编排（分组/聚类/图匹配 IO）+ 可消费块过滤扩展——编排与纯函数分层（纯函数在 screen_merge.rs） | 若再增长：filter_usable_blocks 拆至 screen_filter.rs |
 | app/src/pages/KnowledgePage.tsx | 437 | v0.13.8 画布接线越线（原 296）：中栏「画布」标签 + 树/画布双入口 + v0.15 左列/详情列状态迁移（useColumnLayout + 折叠窄条 + 宽度 prop）——页面编排层内聚（数据获取/选中态/标签态为页面本地状态），子组件已全部下沉（Tree/Canvas/DetailPanel/Wizard/ConceptCardRow/Sample） | 若再增长：中栏视图块（树/画布/概念/模型 + 标签栏）拆至 KnowledgeMiddlePane.tsx，SystemCard 拆至 SystemSidebarCard.tsx |