（126期）session-logs – 本地会话历史的智能检索专家

本地会话历史的智能检索专家 基于 jq 和 ripgrep 的本地会话日志查询工具，帮助用户快速检索历史对话、统计成本与消息量，实现对话数据的自主可控管理。 使用说明 核心用法 session-logs 是一个专为用户设计的本地会话历史检索工具，通过组合使用 jq（JSON 处理器）和 rg（ripgrep 高速搜索）两大标准命令行工具，实现对 Clawdbot 会话日志的深度查询与分析。用户可基于时间范围、关键词、角色类型（用户/助手/工具结果）等多维度筛选历史对话，并支持成本统计、消息计数、工具调用分析等高级功能。 典型使用场景包括：当用户提及"之前聊过的那个项目"或"上次的配置"时，助手可调用此技能快速定位相关会话；用户也可主动查询特定日期的对话、计算某段时间的 API 使用成本，或分析自己最常调用的工具类型。 显著优点 完全本地化：所有数据存储于 ~/.clawdbot/agents/<agentId>/sessions/，无需网络传输，隐私可控 标准工具链：仅依赖 jq 和 ripgrep，无额外依赖，轻量且跨平台兼容 灵活查询能力：支持 JSONL 行级解析，可按时间、角色、内容类型、成本等多字段组合过滤 成本透明化：内置成本汇总脚本，帮助用户追踪会话级别的 API 消耗 结构化输出：查询结果可直接用于后续自动化处理或报告生成 潜在缺点与局限性 技术门槛：需要用户熟悉命令行操作和 jq 查询语法，非技术用户上手成本较高 无可视化界面：纯文本输出，缺乏图形化的时间轴或对话树展示 性能瓶颈：大型会话文件（数 MB）的全文搜索可能较慢，虽可用 head/tail 采样但会损失完整性 索引依赖：跨会话搜索依赖 sessions.json 索引文件，若索引损坏需手动遍历 删除会话处理：已删除会话的 .deleted.<timestamp>> 命名规则需额外注意，查询时可能产生干扰 适合的目标群体 技术型用户：熟悉 Shell 脚本和 JSON 处理的开发者、运维人员 成本敏感用户：需要精细化追踪 AI 对话成本的个人或团队管理者 隐私优先用户：希望完全掌控对话数据、避免云端存储的用户 长期项目用户：会话历史跨越数周甚至数月，需要频繁回溯上下文的深度使用者 使用风险 数据误读风险：jq 查询语法错误可能导致过滤条件失效，返回不完整结果 路径硬编码风险：~/.clawdbot 路径假设可能因安装方式不同而失效 并发写入冲突：会话文件为 append-only JSONL，但极端情况下（如同时多进程写入）可能存在行损坏风险 敏感信息暴露：日志中可能包含用户输入的密码、密钥等敏感内容，查询结果需注意屏幕共享安全 原始说明 Search and analyze your own session logs (older/parent conversations) using jq.