session-history

用户希望了解此项目近期会话的概况。

快速开始

memory_sessions { "project": "<current-project-id>", "limit": 20 }

预期输出：

7f3a9c2 · app · 2026-06-07 09:00 · completed · 14 obs
  - decision: Rotate refresh tokens on every use
b21d004 · app · 2026-06-05 14:00 · completed · 9 obs
  - code: limit.ts counts per-IP

原因

只展示工具返回的会话和观察结果。历史记录为空也是有效答案，绝不能以此为由编造过去的工作。

工作流

1. 使用主机记录的确切项目标识，并在需要时将 agentId 传递给 memory_sessions。如果项目标识未知，请通过 nextCursor 分页浏览会话，并在选择最近的 20 个会话前，按目录边界匹配规范化后的 cwd。绝不能替换为其他项目。
2. 在每一页中保留范围筛选条件；达到请求的数量或 nextCursor 为 null 时停止。注明显示的历史记录是否为部分页面。按时间倒序排列：会话 ID（前 8 位）、项目、开始时间、状态。
3. 对于有观察结果的会话，显示关键要点（类型和标题）。
4. 注明每个会话的观察结果总数。
5. 如果存在会话摘要，展示其标题和关键决策。

反面示例

错误：工具返回两个会话，你却描述为“多个会话持续推进”，并补充对话中记得的其他会话。

正确：只展示实际返回的两个会话，并列出各自真实的 ID、状态和观察结果数量。

检查清单

• 展示的每个会话都来自工具响应。
• 选择展示范围前，已检查项目／目录范围。
• 顺序为时间倒序。
• 每个会话的观察结果数量与响应一致。
• 没有编造或合并会话或要点。

另请参阅

• recap：按日期分组并显示要点的相同数据。
• handoff：直接跳转到最近的会话。
• recall：按主题搜索所有会话。

故障排除

如果 memory_sessions 不可用，请参阅 TROUBLESHOOTING.md。