用途:当用户提到之前或父级会话、询问历史对话内容,而记忆中不存在相关上下文时,可用本技能检索完整会话历史。
存储位置:会话日志位于 ~/.otto/agents/<agentId>/sessions/,其中 agentId 取自系统提示 Runtime 行的 agent=<id>。该目录含 sessions.json(会话键到会话 ID 的索引)与 <session-id>.jsonl(每个会话的完整记录)。文件为追加式 JSONL,每行一个 JSON 对象,体积可能达数 MB。已删除会话带 .deleted.<timestamp> 后缀。
结构:每行 type 为 session(元数据)或 message;含 timestamp;message.role 为 user、assistant 或 toolResult;message.content[] 含文本、思考或工具调用(筛选 type=="text" 可读内容);message.usage.cost.total 为单次响应费用。
常见用法:按日期和大小列出会话、查找某天会话、提取用户消息、在助手回复中按关键词搜索(jq 配合 rg -i)、统计单会话费用与每日费用、统计消息与 token 数量、分析工具调用分布,以及在全部会话中搜索短语(rg -l)。涉及大文件时可用 head/tail 采样。
限制:资料未提供安装、权限、版本兼容及除 jq、rg 外的依赖说明。