用途：分析 Pi Agent 的结构化日志（.log/*.jsonl），提供多维度统计与问题诊断，适用于日常巡检、问题排查、性能分析、模型评估和容量规划。
日志格式：JSONL，每行一个 JSON 对象，包含 schema、timestamp、level（info/warn/error）、tag、message、context（role、sessionId、cwd、pid）、meta（model、duration_ms 等）和 traceId 字段。
使用方式：运行内置脚本 python3 ~/.pi/agent/skills/pi-log-analyzer/scripts/analyze.py [目录路径] [天数]。目录路径默认 .log/，天数默认 3。例如分析最近 7 天：python3 ~/.pi/agent/skills/pi-log-analyzer/scripts/analyze.py .log/ 7。
输出内容：概览统计（日志条数、会话数、时间跨度）、级别分布、模块活跃度、角色活动、模型使用、每小时活跃度热力图、警告详情。也可用 Python 手动读取日志做更细致分析。
常见标签：auto-extract（自动记忆提取）、checkpoint（定时保存点）、daily-memory（每日记忆写入）、vector（向量索引）、pending（待处理项）、repair（记忆修复）、embedding（嵌入生成）、knowledge（知识库操作）。
问题诊断：auto-extract parse failed 通常因 LLM 返回格式不符（返回推理过程、JSON 被截断或含 thinking 标签），建议检查模型是否支持结构化输出，优先使用 DeepSeek V4 Flash。模型调用失败时检查 meta.model 字段并对比 models.json 配置。
限制：资料未提供安装方式、依赖要求、可视化报告的具体形式及收费信息。