Chat History Store

失败：

{
  "ok": false,
  "code": "<error-code>",
  "message": "human-readable",
  "retryable": true,
  "nextAction": "what to do"
}

Workflow

1. 定义会话与消息模型：会话粒度（conversation），消息粒度（message），保存最小必要字段。
2. SQLite schema 与迁移：
   • 使用稳定主键（例如 conversationId、messageId）。
   • 为检索字段（conversationId、createdAt、tags、必要的 sourceDocId）创建索引。
3. 实现写入路径：
   • create：当 conversationId 不存在时创建（或由 orchestrator 决定）。
   • append：追加消息并返回成功与写入计数。
4. 实现读取路径：
   • get：按会话 ID 取指定消息范围。
   • search：按时间/标签过滤取候选上下文。
5. 导出能力（可选但推荐）：
   • 支持导出 JSON/Markdown（由上层指定格式）。
6. 一致性策略：
   • SQLite 写入失败返回可重试错误；
   • 会话不存在按约定：创建新会话或返回 NOT_FOUND（在失败策略里写清楚）。

Failure 与 Fallback

• SQLite 连接失败：DB_UNAVAILABLE（retryable=true）。
• 会话不存在：NOT_FOUND（retryable=false）。
• 输入不合法：INVALID_PARAMS（retryable=false）。

Non-goals

• 不生成回复文本（由 ai-response-orchestrator / markdown-summarizer 完成）。
• 不做 embedding/index（由索引相关 skills 完成）。