Aichat 会话日志保存与压缩机制解析

会话日志保存机制

Aichat 项目采用了一种智能的会话日志保存机制，默认情况下会将完整的聊天会话内容保存在 YAML 格式的文件中。这些文件通常存储在用户配置目录下的 sessions 子目录中，文件名格式为 session_name.yaml。

日志文件包含两个主要部分：

1. messages 数组：保存原始完整的聊天消息记录
2. compressed_messages 数组：当启用压缩功能时生成的摘要信息

会话压缩功能解析

Aichat 的会话压缩功能实际上是一种智能摘要机制，它不会删除原始消息，而是生成一个简化的版本用于快速查看。这种设计既保留了完整对话历史，又提供了快速浏览的便利性。

压缩后的会话会在 YAML 文件中添加 compressed_messages 字段，而原始消息仍然保留在 messages 字段中。这种双重存储策略确保了数据完整性，同时优化了常用场景下的访问效率。

完整会话内容提取方法

虽然 Aichat 提供了内置命令查看会话信息，但默认输出可能会显示压缩后的摘要而非完整内容。要获取完整的会话记录，可以采用以下几种方法：

1. 直接查看 YAML 文件内容
2. 使用 yq 工具处理 YAML 文件
3. 编写自定义脚本提取所需信息

一个实用的 Bash 函数示例如下：

function aichatmd {
  yq -r '(
    [.compressed_messages[]?] + [.messages[]?]
    ) | map(
        select(.role | IN("user", "assistant"))
    )[] | "**\(.role | ascii_upcase):**\n\(
        .content | gsub("\n"; "\n")
    )\n"' "$HOME/.config/aichat/sessions/$1.yaml" |
  pandoc --wrap=preserve -t markdown - |
  batcat --style plain -l md
}

这个函数会：

1. 合并压缩和未压缩的消息
2. 过滤出用户和助手的对话
3. 格式化为易读的 Markdown
4. 使用 batcat 进行美观的输出渲染

技术实现建议

对于开发者而言，理解 Aichat 的会话存储机制有助于更好地利用这个工具：

1. 日志文件采用 YAML 格式，便于机器解析和人工阅读
2. 消息中包含 role 字段标识发言者身份
3. content 字段保存实际对话内容
4. 压缩功能不影响原始数据完整性

在实际使用中，用户可以根据需要选择查看完整日志或压缩摘要，Aichat 的设计已经考虑到了这两种使用场景的需求平衡。