SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场claude-tracker-suite

claude-tracker-suite

办公与效率

查看项目

更新于 10-16 02:23

技能介绍

Claude Tracker Suite 是一套用于管理 Claude Code 会话历史的工具集，可跨所有项目搜索、浏览、监控和管理会话。

用途

该套件围绕 Claude Code 的会话记录（transcript）构建，帮助用户找回、恢复和整理历史会话。核心场景包括：按主题或 ID 查找会话、浏览带完整元数据的近期会话、恢复崩溃或非活跃会话、检测哪些会话仍有进程在运行、以及为新机器生成 ~/.claude/ 配置。

主要能力

  • 搜索：claude-tracker-search 支持关键词或会话 ID 前缀查找。默认路径查询会话全文索引（对用户与助手对话文本建立 FTS5 索引），并与标题、slug、摘要、首条提示的元数据 FTS 合并，采用 bm25 列权重（custom_title 3x、auto_title 2x、summary 2x、first_prompt 1.5x、slug 1x）。多词查询按会话级别逐词匹配，可通过 references/synonyms.json 的同义词组扩展，并在 AND 无结果时回退到 OR 并标注部分匹配。结果包含高亮片段。
  • 前标题回退：默认搜索还会检查 title_history，让当前标题已改但旧标题匹配查询的会话以“former-title matches”标题出现，并显示旧名称、来源、日期及完整时间线链接。
  • 交互式选择器：claude-tracker-pick 使用 fzf 模糊查找近期会话并预览，Enter 在 Ghostty 打开，Ctrl-O 在当前终端恢复，Ctrl-Y 复制恢复命令。
  • 索引与摘要：index-transcripts.js 增量构建/刷新 transcript 全文索引并提取标题历史事件；backfill-summaries.js 生成缺失的会话摘要（默认禁用，需 --enable）。
  • 会话恢复：claude-tracker-resume 查找并恢复崩溃/非活跃会话，支持 --tmux、--zsh、--all、--dry-run；若 --resume 在过期会话上失败，会自动在该项目目录启动新会话。
  • 存活检测：claude-tracker-alive 通过 pgrep + lsof 交叉比对运行中的 claude 进程与近期会话文件，支持 --running、--stale、--json。
  • 自动摘要守护进程：claude-tracker-watch 监视 ~/.claude/projects/*/sessions-index.json 变化，缓存摘要并重新生成 active-projects.md，支持 --status、--daemon、--stop、--verbose。
  • 近期会话：claude-tracker-recent 显示最近 N 个会话的完整元数据（标题、标签、摘要、模型、成本、轮次、git 分支、会话 ID、恢复命令），支持 --limit、--json、--project、--model、--since。
  • 其他：会话标签（tag-session.js）、书签（checkpoint-session.js）、短语捕获与搜索（quote-session.js）、工作区快照与恢复（save-workspace.js / restore-workspace.sh）、项目发现与 CLAUDE.md 脚手架（detect-projects.js）、新机器配置生成（bootstrap-claude-setup.js）、套件自审计（audit-suite.js）、搜索回归测试（search-regression.js）。

使用方式

所有命令委托给独立 Node.js 脚本，避免内联 node -e 的 shell 转义问题。脚本共享 ~/.claude/lib/tracker-utils.js（路径解码、会话解析、git remote 检测）和 ~/.claude/lib/tracker-db.js（SQLite 访问，better-sqlite3，WAL 模式）。

快速开始示例：

  • 按主题搜索：claude-tracker-search "kothar mac mini"
  • 按会话 ID 前缀查找：node ~/.claude/skills/claude-tracker-suite/scripts/search-sessions.js --id d7b8f4dd
  • 仅按名称/slug 搜索：claude-tracker-search "thera" --name
  • 列出前 10 个会话并在 cmux 标签打开：node ~/.claude/skills/claude-tracker-suite/scripts/open-sessions.js
  • 检查存活：claude-tracker-alive
  • 在 tmux 恢复崩溃会话：claude-tracker-resume --tmux
  • 启动自动摘要守护进程：claude-tracker-watch --daemon

索引刷新：node ~/.claude/skills/claude-tracker-suite/scripts/index-transcripts.js（增量，跳过未变更文件）；--rebuild 全量重建。增量索引依据文件大小、mtime 和提取器版本（当前 EXTRACTOR_VERSION 4）判断是否跳过。读取错误不会被记录为已索引，避免部分读取永久遮蔽内容。

摘要回填默认禁用，需 --enable（或 TRACKER_SUMMARIZER=1）。可用 --provider openrouter 切换后端（默认模型 moonshotai/kimi-k2，密钥来自 OPENROUTER_API_KEY 或 ~/.config/env/secrets.env）。--dry-run 可预览片段而不调用 LLM。

适用场景

适合频繁使用 Claude Code、需要跨项目检索历史会话、恢复中断工作、追踪会话成本与模型、以及在新机器上快速搭建 ~/.claude/ 配置的用户。

限制

  • 已知词法限制：会话只能通过其中实际出现的词被找到；语义（rlama）层被列为未来修复方向。
  • 原生 Claude Code 会话摘要约在 v2.1.31（2026 年 2 月）后停止生成，sessions-index.json 的 summary 字段对新会话已过时，需使用 backfill-summaries.js 或 transcript 索引。
  • 部分功能依赖 macOS 环境（如 Ghostty、cmux、Terminal.app、launchd、macOS 通知）。
  • VS Code 相关路径已禁用，回退到 Ghostty 并给出警告。
  • 自动命名路径（update-active-projects.py 的一次性 claude --model haiku 调用）默认关闭，需设置 TRACKER_AUTO_NAME=1。
  • 具体收费、价格、平台支持范围等资料未提供。