会话管理（Session Manager）需求文档（PRD / Markdown）

会话管理（Session Manager）需求文档（PRD / Markdown）

目标：对 **Codex / Claude Code** 的本地会话记录进行可视化管理，并提供“一键复制 / 一键终端恢复”能力。 范围：**v1 仅 macOS**，但必须预留多平台扩展入口。

---

1. 背景与问题

开发者同时使用 Codex CLI、Claude Code 时，常见痛点：

undefined

---

2. 目标与非目标

2.1 Goals（v1 必达）

undefined

2.2 Non-Goals（v1 不做）

undefined

---

3. 用户画像与使用场景

3.1 典型用户

undefined

3.2 核心场景（Top）

undefined

---

4. 产品形态与信息架构

4.1 信息架构

undefined

---

5. 功能需求（Functional Requirements）

5.1 会话发现与索引（Discovery & Indexing）

**FR-1** 扫描本地会话数据源，生成统一的 Session 列表

undefined

**FR-2** 本地索引（Cache/DB）

undefined

**FR-3** 数据源路径探测（可配置 + 多候选）

undefined

---

5.2 会话列表（List）

**FR-4** 列表展示字段（建议最小集）

undefined

**FR-5** 列表交互

undefined

**FR-6** 空态/异常态

undefined

---

5.3 会话详情（Detail）

**FR-7** 会话内容展示

undefined

**FR-8** 性能策略

undefined

---

5.4 恢复能力（Resume / Restore）

5.4.1 复制恢复命令（必做）

**FR-9** “复制恢复命令”按钮

undefined

说明：不同版本 CLI 命令可能略有差异，建议将命令模板做成可配置项（Settings），默认提供推荐模板。

5.4.2 复制会话目录（尽量做）

**FR-10** “复制会话目录”按钮

undefined

5.4.3 一键终端恢复（可选但强烈建议）

**FR-11** “在终端恢复”按钮（或下拉菜单）

undefined

**FR-12** 终端目标选择与记忆

undefined

---

6. 平台与扩展性设计（macOS v1 + Future-proof）

6.1 Provider Adapter 抽象（必须）

统一接口（示例）：

undefined