SuperAPI AI 工具集

session-brain

智能体与模型

查看项目

更新于 10-15 19:57

技能介绍

用途:在 Claude 会话历史上构建可搜索的主题图谱,用于梳理、聚类近期或陈旧的会话主题。输出为侧车目录 ~/.claude/session-brain/,不会写入 vault。

主要能力:核心计算由 obsidian-wiki CLI 中的确定性 Python 完成,用户只需为聚类命名,一轮即可完成,无需阅读转录文本。

使用方式:

  1. 构建:obsidian-wiki sessions-build --json。约 1000 个会话冷启动约 3 秒,增量不到 1 秒,仅重读大小或修改时间变化的转录。可用标志:--full 忽略缓存全部重读;--mutual 更紧凑的小聚类;--half-life N 调整近期半衰期(默认 90 天);--min-sim 0.15 减少边;--skip name 排除项目(子串匹配,传裸名)。
  2. 命名未命名聚类:obsidian-wiki sessions-clusters --unnamed --json,依据 top_terms 和 exemplars 写 3–5 词名称与一句话摘要,再用 obsidian-wiki sessions-name --from - 提交。名称按主导词汇存入 names.json,可跨重建保留。
  3. 报告图谱:读取 clusters.json,说明最大主题、最热主题(近 30 天对比前 60 天)、沉寂主题、桥接会话,并可用 open ~/.claude/session-brain/graph.html 打开可视化。

适用场景:映射或聚类会话、查看近期或陈旧主题、发现主题交汇点。

限制:绝不从本技能写入 vault;约 40% 的长期缓存仅以 history.jsonl 提示形式存在,这些会话有节点但无法加载;图谱为派生数据,可用 --full 重建。若聚类词汇确实不连贯,应如实命名而非编造主题。