[ PROMPT_NODE_25932 ]
Claude Code 会话管理
[ SKILL_DOCUMENTATION ]
# Claude Code 会话
Claude Code 的会话智能插件。读取 Claude Code 写入 `~/.claude/projects/` 的 JSONL 会话文件,并使其可搜索和可分析。
## 功能说明
Claude Code 将每个会话记录为 JSONL 文件 — 包含消息、工具调用、令牌计数、差异、任务。此插件读取这些文件并提供两个接口。大多数操作是只读的;删除和清理技能可以在明确调用时删除会话文件。
**11 种技能**可直接在 Claude Code 中使用:
| 技能 | 用途 |
|-------|---------|
| `/session-search "query"` | 在所有会话中进行全文搜索 |
| `/session-stats` | 令牌使用情况、模型分布、工具调用明细 |
| `/session-list` | 按最近时间、大小或持续时间列出会话 |
| `/session-detail` | 深入查看特定会话 |
| `/session-diff` | 比较两个会话 — 文件、工具、主题 |
| `/session-timeline` | 项目会话的时间轴视图 |
| `/session-resume` | 从任何会话生成上下文恢复提示词 |
| `/session-tasks` | 查找跨会话的待处理和孤立任务 |
| `/session-export` | 将会话导出为整洁的 Markdown |
| `/session-cleanup` | 查找空、微小或陈旧的会话 |
| `/session-delete` | 删除会话及其关联任务 |
**Web 仪表板**位于 `localhost:3000`,包含四个视图:仪表板(汇总统计)、会话(带批量操作的可排序表格)、搜索(带上下文片段的全文搜索)、任务(按状态分组并检测孤立任务)。
## 安装
bash
/plugin marketplace add apappascs/claude-code-sessions
/plugin install claude-code-sessions@claude-code-sessions
无需 API 密钥。无需配置。无运行时依赖。它读取磁盘上已有的内容。
对于仪表板:
bash
bun run ui
# → http://localhost:3000
## 架构
相同的 TypeScript 模块驱动技能、仪表板和 CLI:
lib/formatters.ts — 纯工具函数,无 I/O
lib/session-parser.ts — 将单个 JSONL 文件解析为结构化数据
lib/session-store.ts — 扫描所有会话、聚合、搜索
ui/server.ts — HTTP 端点 + 静态文件服务
每个 lib 文件都可以作为独立的 CLI 运行:
bash
bun run lib/session-store.ts list --sort recency --limit 10
bun run lib/session-store.ts search "database migration" --since 2025-01-01
bun run lib/session-parser.ts stats path/to/session.jsonl
## 使用场景
- 查找几周前解决特定问题的会话
- 查看哪些项目