session-logs

session-logs 技能为 GeminiClaw 代理程序框架提供强大的接口，用于查询与分析历史活动。此工具专为需要审视多轮对话、审计代理程序决策以及进行自主作业成本分析的开发者与进阶用户所设计。通过利用存储在工作空间内存中的结构化 JSONL 数据，该技能能以程序化方式存取响应文本、工具执行状态及 Token 消耗指标，是性能优化与调试复杂代理程序工作流程的关键工具。

• 使用 ripgrep (rg) 在所有历史会话响应中进行细粒度的关键字搜索，确保高速的模式匹配能力。

• 分析工具执行频率，并识别导致错误或意外失败的异常工具调用。

• 计算累计与每日的 Token 消耗趋势，以管理预算并优化 LLM 提示词效率。

• 检索结构化会话数据，包括 RunID、时间戳及手动输入或心跳事件等触发来源。

• 存取与搜索与 Obsidian 兼容的 Markdown 摘要，其中包含摘要 (TL;DR)、关键决策及对话上下文。

• 利用 jq 过滤器解析嵌套的 JSONL 结构，以获取特定元数据，例如失败的工具调用或浏览器导航 (browser_navigate) 等特定工具名称。

• 请确保根据 geminiclaw_status 工具或 GEMINI.md 设置正确配置 {workspace} 路径。

• 请注意，摘要会在会话闲置时自动生成，亦可通过 geminiclaw session summary 指令手动强制执行。

• 若在处理 JSONL 日志首行时遇到文件处理错误，请使用 jq 过滤掉 null 项目。

• 本技能旨在 GeminiClaw 环境内执行，确保分析过程保留在 Docker 沙盒内，以实现最高的安全性与隐私保护。

• 为了发挥最佳效用，请确保您在具备标准 Unix 工具组 (包含 jq、rg 与 awk) 的终端机环境中执行这些查询。