用途:搜索存储在 session JSONL 文件中的完整对话历史。当用户引用较早的或父级对话,或询问此前说过什么、而记忆文件中没有相关信息时使用。
位置与结构:会话日志位于 ~/.thinkfleetbot/agents/<agentId>/sessions/,其中 agentId 取自系统提示 Runtime 行的 agent=<id>。sessions.json 是会话键到会话 ID 的索引;<session-id>.jsonl 为每个会话的完整记录。每个 .jsonl 文件包含 type(session 元数据或 message)、timestamp(ISO 时间戳)、message.role(user、assistant 或 toolResult)、message.content[](文本、思考或工具调用,筛选 type=="text" 可得可读内容)、message.usage.cost.total(每次回复成本)。
常见查询示例:列出按日期和大小排序的会话;查找某一天的会话;提取用户消息;在助手回复中搜索关键词;统计会话总成本与每日成本;统计消息数和 token;统计工具使用分布;跨所有会话搜索短语。主要依赖 jq,关键词搜索可配合 rg。
提示:会话为仅追加的 JSONL,每行一个 JSON 对象;大会话可达数 MB,可用 head/tail 采样;sessions.json 索引将聊天提供方映射到会话 ID;已删除会话带 .deleted.<timestamp> 后缀。使用时需注意日志路径、agentId 取值以及仅限文本筛选以减少噪声。具体安装方式与更多细节暂未提供。