终端会话回放

功能说明

一个命令行工具，用于记录、回放和导出终端会话。可捕获命令、输出内容及时间信息，便于后续查看、文档编写或与团队成员共享。在标准 script 命令基础上封装了更简洁的接口，并增加了额外功能。

主要特性：

• 记录会话 - 使用简单命令开始记录终端会话
• 回放会话 - 按原始时间间隔播放已记录的会话
• 导出为 Markdown - 将会话转换为可读性强的文档格式
• 会话管理 - 列出、查看和删除已记录的会话
• 元数据支持 - 为会话添加标题、描述和标签
• 时间控制 - 调整回放速度，或跳过时间延迟以快速浏览

使用方法

记录会话：

./scripts/main.py record --output session1

回放会话：

./scripts/main.py replay --input session1

导出为 Markdown：

./scripts/main.py export --input session1 --output session1.md

列出已记录的会话：

./scripts/main.py list

完整命令参考：

./scripts/main.py help

命令说明

• record：开始记录终端会话

- --output：会话名称（默认：基于时间戳）

- --title：会话标题（用于元数据）

- --desc：会话描述

- --tags：逗号分隔的标签

• replay：回放已记录的会话

- --input：要回放的会话名称

- --speed：回放速度倍数（默认：1.0）

- --no-timing：跳过时间延迟，立即显示内容

• export：将会话导出为 Markdown

- --input：要导出的会话名称

- --output：输出的 Markdown 文件路径（默认：session_name.md）

- --include-timing：导出时包含时间信息

• list：列出所有已记录的会话

- --filter-tags：按标签过滤

• info：显示会话的元数据

- --input：会话名称

• delete：删除一个会话

- --input：要删除的会话名称

输出内容

会话默认存储在 ~/.terminal-sessions/ 目录中：

• session_name.typescript：原始终端录制内容（script 命令输出）
• session_name.timing：用于回放的时间数据
• session_name.meta.json：元数据文件（包含标题、描述、标签、时间戳）

导出生成的 Markdown 示例：

# 终端会话：项目初始化

**记录时间：** 2026-03-11 10:30:00
**持续时间：** 2 分钟 15 秒

$ git clone https://github.com/example/project

Cloning into 'project'...

remote: Enumerating objects: 100, done.

remote: Counting objects: 100% (100/100), done.

remote: Compressing objects: 100% (80/80), done.

remote: Total 100 (delta 20), reused 80 (delta 15), pack-reused 0

Receiving objects: 100% (100/100), 1.5 MiB | 3.5 MiB/s, done.

Resolving deltas: 100% (20/20), done.

$ cd project

$ npm install

...

## 限制说明

- 需要系统安装 `script` 命令（Linux/macOS 默认支持，Windows 需通过 WSL 或 Cygwin）
- 无法记录图形界面程序或鼠标操作
- 极快的终端输出可能无法完全捕捉
- 长时间录制会导致会话文件较大
- 导出为 Markdown 时，颜色和格式可能无法保留
- 依赖终端对 `script` 命令的支持

## 使用示例

记录一次调试会话：

./scripts/main.py record --output debug-session --title "调试 API 问题" --tags "debug,api"

... 在终端中进行操作 ...

exit # 或按 Ctrl+D 结束录制

以 2 倍速度回放：

./scripts/main.py replay --input debug-session --speed 2.0

导出用于文档：

./scripts/main.py export --input debug-session --output DEBUGGING.md

## 安装说明

`script` 命令在 Linux 和 macOS 系统中通常已预装。Windows 用户请使用 WSL 或 Cygwin。

该工具会在用户主目录下创建 `~/.terminal-sessions/` 目录用于存储录制文件。