跨环境会话历史挖掘。把 Claude Code、Grok、Kimi、Codex、Kimix 等对话变成可搜索的知识资产，生成本机 AI 使用回顾 HTML，并提供跨环境 Token 用量与缓存命中率统计。
分析过一次的会话不再重复解析；索引增量更新，检索走 SQLite FTS5。零 pip 依赖，clone 即用。
# 方式一：npx 一键安装
npx -y skills add taxueseek/session-digger -g --all
# 方式二：git clone
git clone https://github.com/taxueseek/session-digger.git
cd session-digger仅需 Python 3.6+ 标准库。克隆后可直接运行 python3 scripts/ 下工具。
git clone https://github.com/taxueseek/session-digger.git ~/.claude/plugins/session-digger装完可用：/recall /analyze /trend /reflect /import 等。
herdr plugin install taxueseek/session-digger| 能力 | 触发 |
|---|---|
| 搜索历史会话 | sd-search |
| 模糊搜索 | sd-fuzzy-search（fzf，可降级） |
| 最近会话 | sd-sessions |
| 统计面板 | sd-stats / sd-stats-pane |
| 话题趋势 | sd-trend |
| Skill 差距 / 自检 | sd-skill-gap / sd-skill-health |
| 重建索引 | sd-reindex |
# 1. 建索引（一次即可，后续增量）
python3 scripts/index-builder.py build
# 2. 搜索
scripts/recall-lite.sh "认证 bug"
# 3. 全局统计
python3 scripts/sd-recall.py stats
# 4. 本机使用回顾 HTML（浏览器打开）
python3 scripts/reflect-report.py --months 3 --open
# 5. 趋势
python3 scripts/trend-engine.py period-over-period --unit week第一次成功： 索引建好 → recall-lite 搜到历史句 → reflect-report 看到本机用时与各家分布。
/reflect 生成自包含 HTML（不上网），适合复盘「用了多久、花在哪、什么时候忙」。
v0.9.6 亮点：
| 能力 | 说明 |
|---|---|
| 首页用量总览 | 用时概况 + Token 消耗 + 模型偏好（双栏） |
| 单环境隔离 | 进入 Kimi 等子页时，洞察按当前 list 现算，不混 Claude 等全库汇总 |
| 主题 | 跟随系统 / 奶油暖色 / 深褐 / 纯黑 / 冷蓝 / 墨纸 |
| 环境标记 | 侧栏色条标记当前家；主题名与强调色不被劫持 |
| 读数诚实 | 有记录才画；错误率非绝对正确率；中文标签「要盯 / 留意 / 提一嘴」 |
python3 scripts/reflect-report.py --months 3 --open
# 输出默认：~/.claude/.session-digger/reports/reflect-YYYY-MM-DD.html- 跨环境搜索 — Claude / Grok / Kimi / ZCode / Codex / Kimix 等 13+ 环境一网打尽
- Token 用量统计 — 跨环境汇总各模型账单级 token 与缓存命中率（
/usage） - 错误根因分析 — 单会话错误模式 + 用户意图分类（
/analyze→ deep-analysis） - 环境健康诊断 — 跨 AI 编码环境自检（
/env-doctor） - 导入外部对话 — 微信 JSON/CSV、会议记录、纯文本
- 极速检索 — FTS5 + mtime 增量缓存
- 趋势分析 — 周/月环比，纯算术聚合
- 使用回顾 — 本机 HTML：热力日历、任务结构、Token / 模型
- 记忆时效 — 永久 / 周期 / 一次性分层
- 技能差距 — 跨会话痛点 → SKILL.md 提案（需人工确认）
- 自动记忆 —
remember.py从索引生成memory/*.md - Herdr 集成 — 动作 + 统计面板 + 工作树预热
| 命令 | 用途 |
|---|---|
/recall <topic> |
搜索历史决策、错误、话题 |
/recap [N] |
总结近期会话 |
/reflect |
本机多环境使用回顾 HTML |
/timeline |
会话 + git 时间线 |
/topics |
话题切分 |
| 命令 | 用途 |
|---|---|
/usage |
跨环境 Token 用量 + 缓存命中率统计 |
/analyze |
重试循环、错误模式、意图分类 |
/dashboard |
全局概览、记忆状态 |
| 命令 | 用途 |
|---|---|
/index |
构建/更新 FTS 索引 |
/import |
导入外部对话 |
/audit /extract /prune /apply |
记忆生命周期 |
python3 scripts/sd-recall.py search <keyword>
python3 scripts/sd-recall.py sessions
python3 scripts/sd-recall.py stats
python3 scripts/reflect-report.py --months 3 --open
python3 scripts/trend-engine.py period-over-period --unit week
python3 scripts/skill-gap-finder.py --min-occurrences 3
python3 scripts/remember.py
| 环境 | 格式要点 |
|---|---|
| Claude Code | JSONL |
| Grok Build | chat_history.jsonl + events.jsonl |
| Kimi Code | wire.jsonl |
| Kimix CLI | jsonl（复用 Grok Build 适配器） |
| Codex | response_item + event_msg |
| Cursor | agent-transcripts JSONL + SQLite |
| WorkBuddy | parentId 树 |
| Trae CN | LLM 摘要层 |
| ZCode | SQLite + transcript.jsonl |
| DIM / Reasonix | memory / sessions 目录 |
| DimCode | SQLite 数据库 |
| 任意聊天 | JSON/CSV/文本（dialog-adapter.py） |
未知 JSONL 由 SchemaProbe 探测；路径经环境变量探测，不绑定本机固定目录。
| 层 | 脚本 | 作用 |
|---|---|---|
| 0 PARSE | echolib/ + jsonl-core |
原文 → 统计（ground truth） |
| 1 INDEX | index-builder.py |
SQLite 持久化 / 增量 |
| 2 TREND | trend-engine + deep-analysis |
聚合 + 单会话错误根因 |
| 3 DECISION | skill-gap-finder + experience-synthesis |
提案（人工审批） |
- 新增 Kimix CLI 环境适配器（
_adapters_kimix.py） ENV_REGISTRY添加 Kimix 环境（~/.kigi/sessions/）- 支持
/usage跨环境汇总 Kimix CLI token 用量与缓存命中率
- 专精优先协议：意图匹配子技能直接加载，避免主命令空转
- 索引先行：分析前确认 SQLite FTS5 索引可用
- deep-analysis 挂载 combo_map
- hub 边界卫生 +
_helpers补充_empty_stats - 新增
_policy.PROVIDER_POLICY与usage_tier门控 - Codex token 真源修复（
total_token_usage嵌套字段 + 累计快照取 max）
- 路由表收敛为 5 主命令：
/recall/usage/reflect/analyze/dashboard - 新增
/usage：跨环境汇总各模型账单级 token 与缓存命中率
- token 与缓存命中按 session_role 分列（主对话 / 子代理不混算）
- 主表仅会话均命中率；异常单独列；禁止默认加权
input_includes_cache显式语义（非缓存 leg vs 总量含缓存）
- 首页用量总览：用时 / Token / 模型偏好
- 洞察按当前时段与环境现算；子页不混全库汇总
- 主题对比度校准；环境色与主题名解耦
- 中文发现标签与读数免责
session-digger v0.9.19 · 本机优先 · 只读会话 · 不上网报告