| name | chat-history-recovery |
| description | 恢复任务的历史上下文：当用户引用之前的对话（「刚才」「之前」「上次」之类）、 或你怀疑 agent 进程重启过、当前上下文不完整时、用 `read` 工具读任务的 `events.jsonl` 把所需的历史事件找回来。 |
ai-flow Chat 历史上下文恢复
本任务的所有历史事件（之前你的回复、用户的消息、你调过的工具、思考过程等）都按时间序追加在 events.jsonl 里、JSONL 格式（每行一条 JSON 事件）。
文件位置
文件绝对路径由 ai-flow 启动时的初始 prompt 已经告诉你（变量 eventsLogPath、形如 /Users/.../data/tasks/<task_id>/events.jsonl）。
事件 schema
{ "id": "ev_xxx", "ts": 1234567890, "kind": "assistant_message", "text": "...", "meta": { ... } }
kind 取值：
assistant_message：你之前说过的话user_reply：用户之前发过的消息
meta.images：用户附过的图片（含 absPath / mimeType）meta.attachments：用户附过的文件 / 目录路径
tool_call：你调过的工具（read / grep / shell / write / edit / 其他 MCP 等）thinking：你的思考过程info / error：系统消息 / 错误
什么时候该 read 这个文件
- 用户问「刚才」「之前」「上次」「你说的那个」之类、明显引用历史的话题
- 你感觉缺少上下文、不知道「之前做到哪了 / 用户为啥这样问」
- 进程曾经重启过（你启动时如果发现自己是新 agent、用户消息却像在接续话题）
怎么用
- 直接调
read（SDK 内置工具、名字就是 read、不是 read_file）读那个绝对路径
- 文件可能很大、按需 grep 关键词 / 看末尾几十行 即可、不需要全读
- 文件可能不存在或为空（首次启动）、安全忽略
- 找到相关事件 → 抽取其
text 字段拼到当前回复的上下文里
不要做的事
- 不要每次回复前都查（浪费 token、Cursor SDK 后端有自己的 context 管理）
- 不要主动总结历史给用户（用户已经在 UI 看到了完整时间线）
- 不要把 events.jsonl 整段贴给用户（这是内部 log、用户不需要看 raw 数据）
