用途：Claude Code 将会话记录以 JSONL 文件保存在 ~/.claude/projects/<project-key>/<session-id>.jsonl。本工具用捆绑的脚本列出候选会话，或将会话导出为按项目组织的 Markdown 转录，包含摘要、清晰的用户/Claude 对话以及关联的工具调用详情。默认输出目录为 ~/.claude/session-markdown，导出前需告知用户，若用户指定自定义目录也需说明。
主要能力：支持两种模式。full 模式导出全部匹配会话，适合归档、备份、广泛搜索或“转换所有会话”；specific 模式先列出候选会话再让用户选择单个导出。提供过滤与选项：--project <text> 按项目文件夹键名过滤；--session <text> 按会话 id 或文件名过滤；--since YYYY-MM-DD 按修改日期；--limit N 限制最近修改的 N 个；--mode specific --list-candidates 打印编号候选表不导出；--mode specific --pick N 导出编号对应的候选；--include-tool-details-inline 将完整工具输入/结果内嵌到主 Markdown，默认主转录保留紧凑可折叠工具摘要并通过 sidecar 文件链接完整内容。
使用方式：可在任意目录运行，例如：python3 /path/to/claude-session-manager/scripts/manage_claude_sessions.py；等价显式形式：python3 /path/to/claude-session-manager/scripts/manage_claude_sessions.py
--source ~/.claude/projects
--output ~/.claude/session-markdown。specific 模式候选流程：先运行 python3 /path/to/claude-session-manager/scripts/manage_claude_sessions.py --mode specific --list-candidates --limit 20，可加 --project my-repo --since 2026-06-01 等过滤；将编号候选行（含修改时间、项目键、短会话 id、cwd、首条用户提示摘录）呈现给用户选择；用户选定编号后用相同过滤条件加 --pick N 重新运行。若已有精确会话 id 或唯一片段，可先用 --session 加 --list-candidates 确认，仅在候选列表恰好一个匹配时用 --pick 1 导出。
适用场景：需要归档、备份或搜索 Claude Code 会话；只转换某一个会话；在转换前检视最近会话。导出结构为 ~/.claude/session-markdown/ 下含 index.md 与 <project-key>/index.md、<session-id>.md、tool-details/<session-id>.tools.md；会话 Markdown 含摘要（源路径、项目键、会话 id、cwd、时间戳、事件/消息/工具计数、首条用户提示摘录）、链接的工具详情文件、## Timeline 时间线（编号三级标题，ISO-8601 格式，如 ### N. user - <ISO> 与 ### N. assistant - <ISO>），以及 <tool_call_000001> 形式的紧凑工具引用。阅读时先看主 Markdown，仅在需要精确命令输入、文件内容、搜索结果或完整工具输出时打开 sidecar；大会话不要默认加载整个 sidecar，应搜索特定工具引用。
限制与注意：转录数据属隐私，可能含提示、文件内容、命令输出、误粘贴的密钥与工具结果；不要删除或修改原始 .jsonl 文件；大会话优先使用 sidecar 工具详情，内嵌工具载荷会令 Markdown 难以搜索和加载。其余细节暂未提供。