Session-logs

Session-logs 是什么

Session-logs 面向 Clawdbot 本地会话目录，用 jq 和 rg 检索历史 JSONL，回答旧对话内容、日期、成本、Token 和工具使用问题。

适用场景

适合找回未进入记忆文件的父会话与历史上下文；不应用于窥探其他代理或未授权用户记录。

核心能力与工作机制

可列会话、按日期筛选、提取用户或助手文本、跨会话搜索、统计成本、消息、Token 和工具调用。

执行流程

确认 agentId、时间与关键词，先从 sessions.json 定位会话，再用最窄查询读取；大文件只提取相关字段。

输入与输出

需要目标代理、时间范围、关键词和允许读取的角色内容。输出匹配文本和统计，默认只读；原始日志可能包含完整工具参数和敏感数据。

依赖、账号与权限

需要本地会话文件、jq 与 rg，并拥有对应目录读取权限。

副作用、限制与风险

日志可能保存凭据、私聊和被删除内容，广泛搜索容易泄露无关信息。标准流程只读，但输出和临时文件可能复制敏感内容。

不适用边界

不得跨用户或跨代理越权读取，也不能把缺失日志推断成未发生。

失败处理与验收

索引不匹配时核对 agentId 和 session ID，大文件用流式筛选，解析坏行时保留证据。回到原始时间戳、角色和会话核对上下文，输出前脱敏并限制到用户问题。

适合谁使用

适合代理维护者排查历史，普通回忆优先使用已整理的安全记忆。

来源、版本与许可

本条目依据 SkillHub 热门榜、发布者详情和版本 1.0.0 的完整 SKILL.md 整理，核验日期为 2026 年 9 月 21 日。完整 SKILL.md 未声明许可证，公开可下载不代表可以任意复制、修改或再分发。 SkillHub 当前两套安全扫描状态为 benign、benign；该状态只是平台信号，不能替代对脚本、凭据、网络请求、数据外送与后续版本的人工审查。

常见问题

1. Session-logs 主要解决什么问题？

Session-logs 面向 Clawdbot 本地会话目录，用 jq 和 rg 检索历史 JSONL，回答旧对话内容、日期、成本、Token 和工具使用问题。适合找回未进入记忆文件的父会话与历史上下文；不应用于窥探其他代理或未授权用户记录。是否采用它，应以实际任务边界和可核验材料为准，不要因为榜单热度而跳过来源审查。

2. 开始前需要准备什么？

需要目标代理、时间范围、关键词和允许读取的角色内容。准备阶段不要代替用户猜测关键事实；缺少会改变路线、费用或权限的输入时，应先补齐再执行。

3. 它怎样完成任务并交付结果？

确认 agentId、时间与关键词，先从 sessions.json 定位会话，再用最窄查询读取；大文件只提取相关字段。每个阶段都要保留输入、决策、输出和检查点，不能把计划、预览或排队状态描述成最终交付。

4. 需要哪些工具、账号或权限？

需要本地会话文件、jq 与 rg，并拥有对应目录读取权限。凭据应放在安全环境中，并按最小权限授权；账号、网络或本地依赖不满足时应明确停止条件。

5. 它会产生哪些外部操作或副作用？

标准流程只读，但输出和临时文件可能复制敏感内容。涉及外部写入、上传、发送、付费或持久配置时，应在实际动作前说明影响范围并取得相应确认。

6. 哪些情况不适合使用？

不得跨用户或跨代理越权读取，也不能把缺失日志推断成未发生。超出来源明确能力、专业资质或授权范围时，应切换到更合适的工具或交给专业人员处理。

7. 失败或结果异常时怎样恢复？

索引不匹配时核对 agentId 和 session ID，大文件用流式筛选，解析坏行时保留证据。恢复时优先查询已有任务、日志或备份，避免无上限重试、重复扣费、重复发送或覆盖唯一原件。

8. 如何验收结果并控制风险？

回到原始时间戳、角色和会话核对上下文，输出前脱敏并限制到用户问题。验收应基于真实文件、页面、任务终态或权威来源，并把未能实际检查的部分明确标记出来。