Session、上下文与 Memory

恢复持久 Session，理解上下文压缩，并把跨 Session Memory 与对话历史分开。

下面三项能力看起来都像“Agent 记得了”，但解决的是不同问题：

能力	作用范围	持久事实来源
Session	跨多个 Turn 的一段对话	Append-only Session Event
Context Compaction	长 Session 中有边界的 Model Input	从 Session 派生的 Checkpoint；原始日志保持不变
Memory	跨 Session 复用的上下文	单独配置的 Memory Plugin

不要用 Memory 代替 Session 历史，也不要把压缩摘要当作权威对话记录。

恢复一个 Session

默认 Session Adapter 会把事务化历史写入 ~/.lenso/agent/sessions.sqlite3。通过同一个 Profile 启动或恢复：

lenso-agent --profile code
lenso-agent --profile code --session <session-id>
lenso-agent-cli --profile code --session <session-id> \
  "Continue the review."

检查哪些不可变 Generation 接纳了其中的 Turn：

lenso-agent-cli sessions provenance --session <session-id>

Session Storage 会 Fail Closed。选定的持久 Store 不可用时，Host 不会静默退回内存 Transcript。

选择另一个 Session Adapter

SQLite 是默认实现。只有在透明文件或小型 Fixture 比并发事务存储更重要时，才选择 File Adapter：

directory = "/absolute/path/to/.lenso/agent/sessions"

description = "File-backed sessions"
instances = ["lenso.agent.session.file/local"]

迁移是通过 sessions export、sessions import 或 sessions migrate 完成的显式 Operator 动作；切换 Adapter 不会隐式复制或覆盖历史。

让长 Session 保持可用

Context Compaction 会缩小 Model Input，但不会删除权威 Session Log。内置离线 Adapter 会保留有边界的抽取式摘要与近期 Turn：

max_input_characters = 1048576
max_summary_characters = 8192
retain_recent_turns = 8

Agent Loop 决定何时压缩，并把 Checkpoint 记录为持久 Session Fact。替换 Compactor 只会改变投影算法，不会改变 Session 所有权。

有意识地添加跨 Session Memory

默认本地 Memory Adapter 使用 SQLite 与 FTS5。为每种 Experience 设置清晰 Scope，不要全局共享所有召回内容：

database = "/absolute/path/to/.lenso/agent/code-memory.sqlite3"
scope = "code"
max_records = 10000
max_item_characters = 16384
max_recall_items = 8
max_recall_characters = 16384

召回的 Memory 是低权限 Request Context。它不能重写 Session 级 System Instruction，也不能授予新的 Tool 权限。

继续阅读选择 Profile 与 Tool 权限，了解如何为不同 Experience 隔离 Storage 与 Memory Instance。