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

第 1 条注释，第 1 行

//! pi 探测与版本分派：有界读取首行，确认 Agent 身份（`type=session` 头）后按

//! [`super::versions`] 注册表选择格式实现。

//!（空行）

//! 约定（architecture.md#unknown-version，V30）：

//! - 首行不是 JSON / 不是 session 头 ⇒ 未知格式，fail closed，不把任意未知文件

//!   交给猜测逻辑；

//! - version 已收录（3）⇒ KnownVersion；未收录数值（如 4）⇒ LatestFallback

//!   （带兼容标记）；

//! - 固定源码已确认不兼容的 version（1、2）与缺失 version（v1/v2 时代不写该字段

//!   的 legacy 形态）⇒ UnsupportedVersion，不尝试回退。

/// 探测一个 pi session 文件并按注册表分派。

// Agent 身份/输入类型已确认；version 非整数（异常形态）与缺失同按 None 处理，

// 统一走注册表分派（v1/v2 时代不写 version 字段，legacy 形态已确认不兼容）。