save-session

智能分析当前会话内容，提取关键信息（项目进度、实施方案、关键决策、文件变更），并保存到分层存储结构中。

核心特性:

• 📊 智能提取: 自动识别 TodoWrite、AskUserQuestion、文件操作等关键信息
• 💾 分层存储: 摘要文件 + 完整日志，兼顾查询效率和数据完整性
• 🔍 防失真: 保留完整对话记录，避免压缩导致信息丢失
• 🌐 跨平台: 完全兼容 Windows / macOS / Linux

---

执行步骤

1. 定位当前会话文件

找到 Claude Code 当前会话的 JSONL 文件。

位置：~/.claude/projects/ 目录下

匹配规则：

• 项目目录名包含当前工作目录的路径信息
  • 例如：项目在 /Users/user/my-project
  • 对应目录可能是：-Users-user-my-project/
• 文件名格式：{session-uuid}.jsonl
• 排除 agent- 开头的文件
• 选择最新的文件（按修改时间）

如果找不到：

• 输出错误信息
• 说明可能原因：
  • 当前不在 Claude Code 会话中
  • 会话数据已被清理
  • 项目路径不匹配

提取信息：

• 会话文件的完整路径
• 会话 UUID（文件名不含扩展名）

2. 读取并解析会话数据

a. 使用 Read 工具读取整个 JSONL 文件

# 读取会话文件
Read tool: $CURRENT_SESSION

b. 解析 JSONL 数据并提取关键信息

• 使用 Python 脚本处理 JSON 数据（跨平台兼容）
• 提取以下信息：
  • 第一条用户消息（作为会话标题）
  • 所有用户消息和 AI 响应
  • TodoWrite 工具调用（进度信息）
  • AskUserQuestion 工具调用（关键决策）
  • Write/Edit 工具调用（文件变更）
  • 消息时间戳（开始和结束时间）

c. 解析脚本实现

import json
import sys
from datetime import datetime

# 读取 JSONL 并解析
messages = []
todos = []
decisions = []
file_changes = []

for line in sys.stdin:
    msg = json.loads(line.strip())
    messages.append(msg)

    # 提取 TodoWrite
    if msg.get('type') == 'tool_use' and msg.get('name') == 'TodoWrite':
        todos.append(msg.get('input', {}).get('todos', []))

    # 提取 AskUserQuestion
    if msg.get('type') == 'tool_use' and msg.get('name') == 'AskUserQuestion':
        decisions.append({
            'timestamp': msg.get('timestamp'),
            'questions': msg.get('input', {}).get('questions', []),
            'answers': msg.get('input', {}).get('answers', {})
        })

    # 提取文件操作
    if msg.get('type') == 'tool_use' and msg.get('name') in ['Write', 'Edit']:
        file_changes.append({
            'operation': 'created' if msg.get('name') == 'Write' else 'modified',
            'path': msg.get('input', {}).get('file_path', ''),
            'timestamp': msg.get('timestamp')
        })

# 输出结果
print(json.dumps({
    'messages': messages,
    'todos': todos,
    'decisions': decisions,
    'file_changes': file_changes
}))