session-logs

核心用法

session-logs 是一个专为用户设计的本地会话历史检索工具，通过组合使用 jq（JSON 处理器）和 rg（ripgrep 高速搜索）两大标准命令行工具，实现对 Clawdbot 会话日志的深度查询与分析。用户可基于时间范围、关键词、角色类型（用户/助手/工具结果）等多维度筛选历史对话，并支持成本统计、消息计数、工具调用分析等高级功能。

典型使用场景包括：当用户提及"之前聊过的那个项目"或"上次的配置"时，助手可调用此技能快速定位相关会话；用户也可主动查询特定日期的对话、计算某段时间的 API 使用成本，或分析自己最常调用的工具类型。

显著优点

1. 完全本地化：所有数据存储于 ~/.clawdbot/agents/<agentId>/sessions/，无需网络传输，隐私可控
2. 标准工具链：仅依赖 jq 和 ripgrep，无额外依赖，轻量且跨平台兼容
3. 灵活查询能力：支持 JSONL 行级解析，可按时间、角色、内容类型、成本等多字段组合过滤
4. 成本透明化：内置成本汇总脚本，帮助用户追踪会话级别的 API 消耗
5. 结构化输出：查询结果可直接用于后续自动化处理或报告生成

潜在缺点与局限性

1. 技术门槛：需要用户熟悉命令行操作和 jq 查询语法，非技术用户上手成本较高
2. 无可视化界面：纯文本输出，缺乏图形化的时间轴或对话树展示
3. 性能瓶颈：大型会话文件（数 MB）的全文搜索可能较慢，虽可用 head/tail 采样但会损失完整性
4. 索引依赖：跨会话搜索依赖 sessions.json 索引文件，若索引损坏需手动遍历
5. 删除会话处理：已删除会话的 .deleted.<timestamp>> 命名规则需额外注意，查询时可能产生干扰

适合的目标群体

• 技术型用户：熟悉 Shell 脚本和 JSON 处理的开发者、运维人员
• 成本敏感用户：需要精细化追踪 AI 对话成本的个人或团队管理者
• 隐私优先用户：希望完全掌控对话数据、避免云端存储的用户
• 长期项目用户：会话历史跨越数周甚至数月，需要频繁回溯上下文的深度使用者

使用风险

• 数据误读风险：jq 查询语法错误可能导致过滤条件失效，返回不完整结果
• 路径硬编码风险：~/.clawdbot 路径假设可能因安装方式不同而失效
• 并发写入冲突：会话文件为 append-only JSONL，但极端情况下（如同时多进程写入）可能存在行损坏风险
• 敏感信息暴露：日志中可能包含用户输入的密码、密钥等敏感内容，查询结果需注意屏幕共享安全

核心用法

session-logs 是一个纯文档型 Skill，专门用于帮助用户查询、搜索和分析 ClawDBot 历史会话日志。其核心功能围绕本地存储的 JSONL 格式会话文件展开，提供了一系列基于 jq 和 rg 的命令行查询示例，包括：按日期列出会话、提取特定日期的会话、筛选用户/助手消息内容、关键词搜索、成本统计、消息计数、工具调用分析等。

显著优点

1. 零安全攻击面：纯 Markdown 文档型 Skill，无可执行代码，所有代码块均为示例脚本，用户需手动执行
2. 功能实用完整：涵盖会话管理的常见场景，从基础浏览到高级分析（成本追踪、工具使用统计）一应俱全
3. 查询效率高：利用 jq 的流式处理和 rg 的高性能搜索，适合处理大型日志文件
4. 隐私保护优秀：完全本地操作，无外部 API 调用，数据不离开用户设备

潜在缺点与局限性

1. 依赖外部工具：要求系统预装 jq 和 ripgrep，Windows 用户配置成本较高
2. 无自动化封装：所有操作需手动复制粘贴命令，缺乏交互式界面或一键执行功能
3. 路径硬编码风险：示例中的 ~/.clawdbot/agents/<agentId>/sessions/ 路径可能因部署环境变化而失效
4. T3 来源可信度：来自个人开发者账号，缺乏企业级维护承诺和长期支持保障

适合人群

• 需要审计对话历史的高级用户
• 希望追踪 API 成本的技术管理员
• 依赖 ClawDBot 进行长期项目且需上下文检索的专业用户
• 熟悉命令行工具（jq/rg）的开发者

常规风险

• 误操作风险：用户可能错误修改日志文件（尽管工具为只读示例）
• 路径暴露：日志文件路径在文档中明文展示，多用户环境需注意权限设置
• 工具链污染：若 jq 或 rg 来自非官方源，存在供应链攻击可能（建议验证工具来源）