desktop/src-tauri/crates/core/src/adapters/omp/detect.rs

第 1 条注释，第 1 行

//! omp 探测与版本分派：有界读取前 4 行，确认 Agent 身份（首行 `type:"title"`

//! 或 `type:"session"`，session 头在前 4 行内定位）后按 [`super::versions`]

//! 注册表选择格式实现。

//!（空行）

//! 规则见 architecture.md#unknown-version，保留首行检查的四种结果。

//! - 首行不是 JSON / 首行类型既非 title 也非 session ⇒ 未知格式，fail closed；

//! - 有 title 但前 4 行内无 session 头 ⇒ Pending（可能仍在首次写入中）；

//! - session 头 version 已收录 ⇒ KnownVersion；未收录或缺失 ⇒ LatestFallback

//!   （带兼容标记，先尝试最新内置解析器，不直接拒绝）。

/// 探测一个 omp 会话文件并按注册表分派。

// omp 文件首行为 title（v=1），session 头在其后；有界读前 4 行定位。

// Agent 身份/输入类型已确认，按注册表分派；未收录/缺失版本回退最新

// 内置解析器并带兼容标记（V30；omp 旧版格式尚未核验，不直接拒绝）。

// 有 title 但前 4 行内无 session 头：可能仍在首次写入中，下轮重探。