OMP 转录根目录¶

原生聊天查找、历史记录发现和历史路径允许列表在执行主机上使用 src/main/ai-vault/omp-session-root.ts。解析器遵循活动运行时环境，而不是扫描每个配置档。

该行为与 OMP 的 packages/utils/src/dirs.ts 一致：

• 在 Linux 和 macOS 上，已存在的 $XDG_DATA_HOME/omp 会选择该应用的 sessions 目录，即使旧版转录同时存在。sessions 目录本身可以尚不存在。没有隐式的 ~/.local/share 回退。
• 命名配置档仅在其自身的 omp/profiles/<name> 路径存在时使用 XDG； 否则使用配置档的配置根下的 agent/sessions 目录。
• OMP_PROFILE 优先于 PI_PROFILE，包括显式空的规范值。命名配置档忽略自定义的 PI_CODING_AGENT_DIR 值。默认模式尊重自定义代理目录，但由较低优先级配置档 派生的继承代理路径除外。PI_CONFIG_DIR 按上游规定，相对于所属主机的 主目录选择配置根。
• Orca 保留其旧版 OMP_CODING_AGENT_DIR sessions 根覆盖和前缀规范化。显式扫描根 覆盖环境发现。空扫描覆盖、文件系统根扫描覆盖以及无效配置档名称会拒绝发现； 它们绝不会回退到不同配置档或进程工作目录。

桌面扫描器子进程允许列表仅转发所需的目录/配置档变量。SSH 中继发现仍从其主机 拥有的主目录构建旧版根，并且在此不会获得 XDG/配置档发现。客户端的 XDG/配置档值 不会应用到 WSL 主目录根。精确的 hook 路径以及现有 WSL 认证/拒绝仍然具有权威性。 线路字段或操作码均未改变；旧客户端接收现有的会话记录结构。

这会解析环境可见的配置。按命令的 --profile 选择或仅在代理内部加载的目录值， 不会被从未收到它们的运行时推断；hook 报告的转录路径仍然是精确路径。

使用以下命令运行只读的上游一致性冒烟测试：

ORCA_BACKGROUND_LAUNCH=1 bun tests/tools/omp-session-root-upstream-smoke.mjs /path/to/oh-my-pi

该冒烟测试使用一次性主目录/data 根，并将 Orca 的结果与 OMP 的实际目录解析器 进行比较。它不会发起模型请求。单元测试还覆盖 Windows XDG 排除、旧版覆盖规范化 和拒绝路径。

要进行实际的持久化到读取器验证，请运行：

ORCA_BACKGROUND_LAUNCH=1 bun tests/tools/omp-transcript-root-reader-smoke.mjs /path/to/oh-my-pi

这会通过 OMP 的 SessionManager 创建默认和命名配置档转录，同时旧版目录仍然存在， 然后通过 Orca 的原生读取器按会话 ID 解析并解码每一项。所有文件使用一次性根； 不会运行模型。