更新面试记录 @param id 面试记录ID @param request 更新请求 @return 更新后的面试记录

Update evaluation status on session entity (shared by Producer/Consumer/Controller)

用不可预测的分隔符包裹用户文本。 格式：{@code <data-boundary-{uuid片段}-{label}> ... </data-boundary-{uuid片段}-{label}>} UUID 片段使攻击者无法提前构造伪造分隔符。

清理文本并限制最大长度 @param text 原始文本 @param maxLength 最大长度 @return 清理后的文本（可能被截断）

下载文件（通用方法） @param fileKey 文件存储键 @return 文件字节数组

Get the default ChatClient based on app.ai.default-provider. @return The default ChatClient instance

获取或恢复会话（优先从缓存获取）

获取缓存的会话

获取会话信息

将临时向量任务提升为当前知识库的正式向量数据。

发送消息到 Stream

Write 32-bit integer in little-endian format

清理文本并移除所有换行符（转为空格） 适用于需要单行显示的场景 @param text 原始文本 @return 单行文本

从存储下载文件并解析内容 @param storageKey 存储键 @param originalFilename 原始文件名 @return 提取的文本内容

Extract session ID from WebSocket URI path Path format: /ws/voice-interview/{sessionId}

创建一个支持过滤的 Mock Answer 简化版本：仅用于测试，手动过滤结果 @param allDocuments 所有文档 @param allowedKbIds 允许的 kb_id 列表（如果为 null，则返回所有文档）

Get chat history for session Load conversation history from database

获取知识库统计信息

Handle STT result from callback (partial = live; final = committed segment for LLM).

获取知识库列表（支持状态过滤和排序） @param vectorStatus 向量化状态，null 表示不过滤 @param sortBy 排序字段，null 或 "time" 表示按时间排序 @return 知识库列表

Resume interview session 恢复面试会话 @param sessionId Session ID @return SessionResponseDTO with WebSocket URL

将缓存会话转换为 DTO

将知识库实体列表转换为列表项DTO列表

更新分析状态

更新评估状态

更新向量化状态

Write 16-bit short in little-endian format

Cache session in Redis

计算文件的 SHA-256 哈希值 @param file MultipartFile 文件 @return 十六进制哈希字符串

创建使用 Long 类型 kb_id 的文档（模拟旧数据格式）