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

第 1 条注释，第 1 行

//! pi（pi-coding-agent）适配器（独立目录约定 architecture.md#adapter-layout，

//! V30 自根级 adapters/pi.rs 目录化迁移）：

//! - 本模块是该 Agent 的稳定入口（统一接口实现与再导出）；

//! - [`detect`]：产品/格式探测与版本分派；

//! - [`versions`]：已验证格式实现的注册与映射，未收录数值默认回退最新内置解析器，

//!   固定源码已确认不兼容的版本（v1/v2/缺失 version）才 fail closed；

//! - 历史版本的格式实现一律保留在本目录内，不再回到根级单文件。

//!（空行）

//! 原始格式依据见 [`versions::session_v3`] 文件头（固定源码 pi-mono b4559750 +

//! 本机测试数据）；pi/omp 共用的用量解析和事件构造与扫描实现一起位于

//! [`versions::session_v3`] 并在此再导出（`map_pi_family` 仍留在跨 Agent 的

//! 根级 usage_map.rs，勿动）。

// pi/omp 家族共享辅助（原根级 pi.rs 的 pub(crate) 项，保持 crate 内旧路径可用；

// map_cost 仅本目录内使用，不再对外再导出）。

/// pi 适配器（无状态）。

// 使用 sessions 目录作为实例根；框架对相同实例去重。

// 手工根语义：含 sessions 子目录按 agent 根解析，否则按 sessions 目录本身。

// sessions/<encoded-cwd>/*.jsonl：深度 2，有界枚举；根下散落 jsonl 一并接受。

// 当前所有可尝试版本共用 session_v3（session 头内部按注册表分派，

// 已确认不兼容的版本跳过并记诊断）；注册表扩展多实现后在此按选择分派。