Version: 0.4.4.dev.260307

feat: 🚀 增强会话管理与缓存机制

* 会话 ID 空值兜底，若 `conversation_id` 为空时自动生成 UUID
* 在响应头写入 `X-Conversation-ID`，供前端使用，保持同一会话状态

perf: ⚡ 会话状态缓存优化

* 当缓存未命中但 DB 已确认/创建会话后，调用 `SetConversationStatus` 回写 Redis
* 缓存写回失败时记录日志，不中断聊天主流程，确保业务流畅性

fix: 🐛 修复历史消息顺序问题与编译错误

* 修复历史消息顺序问题，保证返回的 N 条历史消息按时间正序喂给模型

  * 通过反转 `created_at desc` 查询结果的切片，确保模型输入顺序正确
* 修复 `fmt.Errorf` 参数不匹配问题，修正编译错误
* 整理 `agent-cache.go` 为标准 UTF-8 编码，避免 Go 编译报错 `invalid UTF-8 encoding`

feat: 🛠️ 独立构建 MCP 服务器

* 使用 `Codex` 构建独立于后端的 MCP 服务器，简化与 Codex 的协作
* 通过该服务器方便 Codex 直接测试和查看 Redis 与 MySQL 中的数据

infra/smartflow-mcp-server/.env.example

@@ -0,0 +1,46 @@
+# =========================
+# MCP server metadata
+# =========================
+MCP_SERVER_NAME=smartflow-mcp-server
+MCP_SERVER_VERSION=0.1.0
+MCP_PROTOCOL_VERSION=2024-11-05
+MCP_DEFAULT_CALLER=codex
+
+# =========================
+# Governance & safety
+# =========================
+MCP_TOOL_TIMEOUT_MS=5000
+MCP_RATE_LIMIT_RPS=5
+MCP_RATE_LIMIT_BURST=10
+MCP_MAX_RESULT_ROWS=500
+MCP_ENFORCE_WHITELIST=false
+MCP_AUDIT_LOG_PATH=logs/audit.log
+
+# Redis scan/value caps
+MCP_REDIS_SCAN_MAX_KEYS=200
+MCP_REDIS_SCAN_MAX_COUNT=200
+MCP_REDIS_VALUE_MAX_ITEMS=100
+MCP_REDIS_MAX_STRING_BYTES=4096
+
+# =========================
+# MySQL
+# =========================
+MYSQL_HOST=127.0.0.1
+MYSQL_PORT=3306
+MYSQL_USER=readonly_user
+MYSQL_PASSWORD=replace_me
+MYSQL_DATABASE=smartflow
+MYSQL_PARAMS=charset=utf8mb4&parseTime=true&loc=Local
+
+# Comma-separated whitelist (optional)
+# Example: MYSQL_ALLOWED_DATABASES=smartflow,analytics
+MYSQL_ALLOWED_DATABASES=smartflow
+# Example: MYSQL_ALLOWED_TABLES=smartflow.users,smartflow.tasks
+MYSQL_ALLOWED_TABLES=smartflow.users,smartflow.tasks
+
+# =========================
+# Redis
+# =========================
+REDIS_ADDR=127.0.0.1:6379
+REDIS_PASSWORD=
+REDIS_DB=0