会话录制与回放

本文介绍 XTerminal 的会话录制功能，支持记录终端操作并在需要时回放查看。

功能概述

XTerminal 提供两种会话记录方式：

功能	说明	用途
会话日志	记录终端的文本输出	审计、问题追溯
会话录制	录制终端的可视化快照	操作回放、培训演示

会话日志

会话日志以文本形式记录终端的所有输出内容。

启用会话日志

设置路径：设置 > 通用终端 > 会话记录

配置选项

选项	说明
是否录制终端数据	启用/禁用会话录制功能
自动压缩日志	结束录制时压缩日志文件，节省存储空间
录制时间间隔	录制数据的采样间隔，单位为秒，最小值 1 秒

查看日志

点击 查看日志 按钮可以打开录制数据目录，查看已保存的终端数据。

日志文件特点：

• 按连接和时间组织存储
• 支持压缩存储以节省空间
• 包含时间戳信息

会话回放

会话回放功能可以像播放视频一样重现终端操作过程。

原理说明

XTerminal 定时对终端进行快照录制：

1. 按设定的时间间隔（默认 5 秒）捕获终端状态
2. 仅保存与上一帧不同的内容（增量录制）
3. 每帧包含时间戳和终端内容

打开回放工具

在会话记录设置页面，点击 打开工具 按钮启动回放工具。

回放控制

回放界面提供以下控制：

控制	说明
播放/暂停	开始或暂停回放
进度条	拖拽跳转到指定时间点
速度调节	调整回放速度
帧导航	逐帧查看

使用场景

会话录制与回放适用于：

1. 问题排查

   • 回放出现问题时的操作过程
   • 分析命令执行的上下文

2. 安全审计

   • 记录关键服务器的所有操作
   • 追溯异常操作的来源

3. 培训演示

   • 录制操作教程
   • 演示正确的操作流程

4. 工作记录

   • 保存重要操作的记录
   • 作为工作交接的参考

存储管理

存储位置

录制数据保存在本地数据目录中，可以通过"查看日志"按钮打开。

操作系统	默认存储路径
macOS	~/Library/Application Support/XTerminal/recordings/
Windows	%USERPROFILE%\AppData\Roaming\XTerminal\recordings\
Linux	~/.config/XTerminal/recordings/

存储格式与空间占用

文件组织结构

recordings/
├── {连接名称}/
│   ├── 2025-11-29_14-30-00.log      # 会话日志（文本）
│   ├── 2025-11-29_14-30-00.rec      # 会话录制（快照）
│   └── 2025-11-29_14-30-00.rec.gz   # 压缩后的录制文件

空间占用估算

使用场景	每小时存储空间	说明
轻度使用（少量输出）	约 1-5 MB	偶尔执行命令
中度使用（持续操作）	约 5-15 MB	正常运维工作
重度使用（大量日志）	约 15-50 MB	实时日志监控、编译输出等

提示

开启「自动压缩日志」可减少约 60-80% 的存储空间占用。

存储优化

为减少存储空间占用：

• 启用压缩：开启"自动压缩日志"选项
• 调整间隔：增大录制时间间隔（如设为 10 秒）
• 定期清理：删除不再需要的历史录制

注意事项

警告

• 录制功能会略微增加系统资源消耗
• 长时间录制会产生较大的存储文件
• 建议仅在需要时启用录制功能

---

下一步

• 命令补全 - 智能命令提示
• 基础操作 - 终端基本使用