Package com.yapcli.tui.history

Class ConversationSnapshot

java.lang.Object

com.yapcli.tui.history.ConversationSnapshot

public class ConversationSnapshot
extends Object

对话历史快照（TUI 专用）。

职责： - 持久化对话历史到 ~/.yapcli/history/ 目录 - 支持按会话 ID 查询、列出、删除 - 每个会话一个 JSONL 文件（每行一条消息）

TUI 会话控制器会把用户输入、系统提示和 Agent 输出追加到当前快照。

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static final record	ConversationSnapshot.MessageRecord	消息记录。
static final record	ConversationSnapshot.SessionMeta	会话元数据。

Constructor Summary

Constructors

Constructor	Description
ConversationSnapshot(String sessionId)	创建新会话快照。

Method Summary

Modifier and Type	Method	Description
void	append(ConversationSnapshot.MessageRecord message)	追加消息。
void	appendAssistant(String content)	追加 Assistant 消息。
void	appendUser(String content)	追加用户消息。
static void	deleteSession(String sessionId)	删除会话。
static String	generateSessionId()	获取当前会话 ID（时间戳）。
List<ConversationSnapshot.MessageRecord>	getMessages()	获取所有消息。
String	getSessionId()	获取会话 ID。
static List<ConversationSnapshot.SessionMeta>	listSessions()	列出所有会话。
static ConversationSnapshot	load(String sessionId)	从文件加载会话（Day 5 完整实现）。
void	save()	保存到文件（Day 5 完整实现）。

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details

ConversationSnapshot

public ConversationSnapshot(String sessionId)

创建新会话快照。

Method Details

append

public void append(ConversationSnapshot.MessageRecord message)

追加消息。

appendUser

public void appendUser(String content)

追加用户消息。

appendAssistant

public void appendAssistant(String content)

追加 Assistant 消息。

getMessages

public List<ConversationSnapshot.MessageRecord> getMessages()

获取所有消息。

getSessionId

public String getSessionId()

获取会话 ID。

save

public void save()
          throws IOException

保存到文件（Day 5 完整实现）。

Throws:

IOException

load

public static ConversationSnapshot load(String sessionId)
                                 throws IOException

从文件加载会话（Day 5 完整实现）。

Throws:

IOException

listSessions

public static List<ConversationSnapshot.SessionMeta> listSessions()
                                                           throws IOException

列出所有会话。

Throws:

IOException

deleteSession

public static void deleteSession(String sessionId)
                          throws IOException

删除会话。

Throws:

IOException

generateSessionId

public static String generateSessionId()

获取当前会话 ID（时间戳）。