Documents

元史 yotta-logs

Try it

元史 —— 跨智能体的历史会话 / 记忆日志检索技能：零依赖检索 / 分析 JSONL、JSON、SQLite、Markdown 多格式会话与记忆文件，回溯旧对话与父会话上下文，为跨会话追溯提供原始日志依据。触发：用户问起先前聊过的内容 / 父会话 / 历史上下文、要查以前说过的结论、跨会话回溯某次讨论、需要从会话日志或记忆文件定位某段决策时。边界：仅读取本机自己的会话日志 / 记忆文件；不修改、不删除；只查本地不联网上传。

What it does

元史 —— 跨智能体的历史会话 / 记忆日志检索技能：零依赖检索 / 分析 JSONL、JSON、SQLite、Markdown 多格式会话与记忆文件，回溯旧对话与父会话上下文，为跨会话追溯提供原始日志依据。触发：用户问起先前聊过的内容 / 父会话 / 历史上下文、要查以前说过的结论、跨会话回溯某次讨论、需要从会话日志或记忆文件定位某段决策时。边界：仅读取本机自己的会话日志 / 记忆文件；不修改、不删除；只查本地不联网上传。

The skill document

元史（yotta-logs）

跨智能体的历史会话日志检索技能：零依赖检索 / 分析会话 JSONL 记录，回溯旧对话与父会话上下文，为跨会话追溯提供原始日志依据。

零依赖（Python 3.8+ 标准库），Windows + Linux + macOS 通用；Claude Code / Cursor / Codex / 通用 Agent 均可调用。

何时使用

  • 用户引用先前聊过的内容 / 父会话 / 历史上下文；
  • 要查以前说过的结论、决策、命令或结果；
  • 需要从会话日志定位某段讨论发生在哪个会话、什么时间、谁说的。

Do NOT trigger：

  • 只读：不修改、不删除任何会话记录；
  • 只查本地日志，不联网上传；
  • 语义记忆 / 长期知识请用元忆（yotta-memory）；本技能只管原始会话日志检索，二者互补。

快速使用

Windows 用 python，Linux/macOS 用 python3。

# 自动发现本机常见会话日志目录
python3 scripts/yotta_logs.py locate

# 列出目录下所有会话（ID / 日期 / 消息数 / 大小）
python3 scripts/yotta_logs.py scan --dir ~/.clawdbot/agents//sessions

# 跨会话检索关键词（时间线命中，默认脱敏）
python3 scripts/yotta_logs.py search "部署方案" --dir /path/to/sessions

# 正则 + 日期 + 会话过滤
python3 scripts/yotta_logs.py search "CI 失败" --regex --date 2026-08-26 --dir /path/to/sessions

# 提取单个会话原文
python3 scripts/yotta_logs.py session abc123 --dir /path/to/sessions

# 统计（消息 / token / 成本 / 每日汇总）
python3 scripts/yotta_logs.py stats --dir /path/to/sessions --daily

# 工具调用排行
python3 scripts/yotta_logs.py tools --dir /path/to/sessions

退出码（与元安 / 元审 / 元盾 / 元真家族一致）：0 = 成功；1 = 无匹配 / 空结果集；4 = 用法错误 / 致命异常。

工作流程（AI 智能体回溯历史时）

  1. 定位：locate 或 scan 找到会话日志目录与会话 ID；
  2. 检索：search 按关键词 / 正则跨会话命中，先看时间线片段；
  3. 提取：命中后 session 提取该会话原文；
  4. 核对：需要精确出处时用 --json 拿结构化结果（会话 ID / 行号 / 时间戳 / 角色）；
  5. 统计：需要成本 / token / 工具使用回顾时用 stats / tools。

能力

  • 零依赖检索：Python 3.8+ 标准库，不依赖 jq / rg 等外部工具；
  • 容错解析：字段缺失 / 坏行自动跳过并计数，可容忍不同智能体的 JSONL 形态差异；
  • 默认脱敏：输出自动打码疑似密钥 / token / 口令（--no-redact 关闭）；
  • 多维度过滤：关键词 / 正则 / 日期 / 会话 ID / 别名 / 角色；
  • 结构化输出：--json 输出纯净 JSON（含行号 / 时间戳 / 角色）；
  • 只读安全：只读本地日志，不修改、不删除、不联网。

参考文档

  • references/format.md — 会话日志 JSONL 格式与 sessions.json 索引说明
  • references/cli.md — CLI 子命令 / 参数 / 退出码 / JSON schema 详解
  • references/security.md — 安全边界 / 脱敏规则 / 与元忆的差异化

责任声明

本技能只做本地会话日志的只读检索；输出原文片段可能包含隐私，默认脱敏且仅用于本机回溯，请勿将检索结果外传。

Related skills

元忆 yotta-memory

元忆 —— 有权限边界的文件式智能体记忆。文件式、零依赖、可 diff/可回滚：让任何 AI 智能体活过会话，开工 recall 恢复上下文、重要信息 remember 落盘、收工归档。类型体系 FACT（公共共享）/ PREF / BOUND / COMMIT（私密隔离）。触发：记住、别忘了、记一笔、记忆、remember、recall、跨会话、上次说到、续测、交接、归档、记忆盘、共享记忆、局域网记忆、画像、开工上下文、记忆守则、profile、context、越用越懂、语义检索、反馈、维护、蒸馏、feedback、maintain、distill、explain、自我学习、自我进化、自我提升、查看平台分页、recall 候选预过滤、任务相关记忆、--focus、--embedding、压缩遗忘、consolidate、周期摘要、自动合并、分类型衰减、回滚

2 installs1 stars

元察 yotta-logwatch

元察 —— 跨智能体的安全日志分析检测技能：零依赖自研解析 auth/secure、Web 访问日志（common/combined）、PowerShell 脚本块日志、Windows 事件日志（Security/System），检测爆破 / webshell / 扫描 / 异常登录 / 可疑脚本块 / 可疑进程 / 账户操作 / 日志清空，输出时间线与中文教学报告。触发：用户给出登录日志 / Web 访问日志 / PowerShell 日志 / Windows 事件日志，要分析入侵痕迹、排查异常活动、审计本地日志时。边界：只读本地日志文件；不联网、不主动扫描、不修改任何其内容；仅用于已获授权 / 自有资产的安全审计。

元习 yotta-learn

元习 —— 跨智能体的学习闭环技能：把错误、纠正与洞见沉淀为 .learnings/ 条目，供后续会话与技能改进复用。触发：命令失败、用户纠正、发现更好的做法、请求缺失能力、外部接口故障、知识过时、需要沉淀经验时；或用户说 记一笔/学习/沉淀/self-improvement/learnings 等。边界：不写入私密/敏感信息（除非用户明确要求）；不自动改动系统文件。

Memory System

自动记忆维护与知识提炼流水线：WAL写前日志→MEMORY.md→每日日志→Obsidian同步，含Insight Miner数据分析和双链发现

元引 yotta-prompt

元引 —— 意图澄清 + 生态入口技能：用户输入一句模糊的话 / 一个词时，识别意图、给出 2-4 个候选方向、深挖（目标/范围/输出/约束），再串联到对应元阁技能输出可直接运行的提示词。常驻注入（always-load）：每次新会话开始自动生效，接住「不会用 AI、不知道怎么提问」的用户。触发：用户不知道怎么提问、不知道想要什么、输入模糊的一句话 / 一个词、想被引导到合适技能时。边界：只澄清意图、不预设立场、不做安全评审；提示词不人为设限（不违规/不犯法/不越狱即可）；不做 prompt 美化；纯本地离线。

Memory Store

跨会话、跨 Agent 存储与检索结构化记忆