读取工作区 @param userId 用户 ID @param sessionId 会话 ID @return 工作区 @author TellyJiang @since 2026-04-16

获取当前线程的用户 ID @return 用户 ID，未设置时返回 null

分页查询角色列表 @param pageNum 页码，默认为1 @param pageSize 每页条数，默认为10 @return 分页角色列表

根据ID查询角色详情 @param id 角色ID @return 角色实体信息

保存向量记忆 @param userId 用户 ID @param deptId 部门 ID @param sessionId 会话 ID @param content 内容 @param importance 重要性 @param memoryKind 记忆归类 @param roundStar

删除向量记忆 @param vectorDocId 向量文档 ID @author TellyJiang @since 2026-04-15

设置当前线程的用户 ID @param userId 用户 ID

获取 MCP 运行状态

设置全局向量模型（有则更新，无则创建） @param request 向量模型配置 @return 设置后的向量模型配置

获取 MCP 运行状态（真正探测连接） 1. 查数据库中 RUNNING 状态的记录 2. 检查内存中是否有对应的 McpSyncClient 3. 如果有 client，尝试 listTools() 探测连接是否真正存活 4. 如果 client 丢失或连接已死，修正数据库状态

获取当前配置的 bucket 名称

格式化召回结果 @param results 召回结果 @return 格式化文本 @author TellyJiang @since 2026-04-14

校验当前操作者是否可访问目标用户记忆 @param targetUserId 目标用户 ID @author TellyJiang @since 2026-04-11

根据主键查询用户 @param id 用户 ID @return 用户实体，不存在返回 null

检查文件是否存在

创建 AgentScope 智能体 @param userId 用户 ID @param sessionId 会话 ID @param modelName 模型名称 @return 智能体 @author TellyJiang @since 2026-04-14

发送消息并返回 SSE 流 <p> 如果 request.sessionId 为空，自动创建新会话；否则校验已有会话归属。 SSE 流的第一条事件为 session_created（仅新建会话时），告知前端 sessionId。 </p> @param request 发送消息请求 @return

根据用户 ID 查询画像 @param userId 用户 ID @return 画像对象 @author TellyJiang @since 2026-04-12

获取全局配置

获取当前操作者部门 ID @return 部门 ID @author TellyJiang @since 2026-04-16

批量查询用户

保存工作区 @param workspace 工作区 @author TellyJiang @since 2026-04-16

序列化对象 @param value 待序列化对象 @return JSON 字符串 @author TellyJiang @since 2026-04-12

更新实例

上传文件

清除当前线程的用户 ID

反序列化对象 @param json JSON 内容 @param clazz 目标类型 @param <T> 泛型类型 @return 目标对象 @author TellyJiang @since 2026-04-12

根据主键查询对象 @param id 主键 @return 对象实体 @author TellyJiang @since 2026-04-12

更新角色信息 <p>包含角色名/角色编码排他唯一性校验，dataScope变更时自动清理自定义部门列表。</p> @param request 更新角色请求体 @return 更新结果

同步方式获取向量（阻塞等待） @param text 待向量化的文本 @return 向量数组

根据 MCP Config ID 查询运行中的实例

管理员分页查询会话列表（支持数据权限过滤 + 关键字搜索 + 日期范围） scope=1 (SUPER_ADMIN): 不过滤，直接查全部 scope=4: 仅本人数据 scope=3: 仅本部门 scope=2: 本部门及子部门 scope=5: 自定义部门列表 @param dataScop

保存或更新对象 @param entity 对象实体 @author TellyJiang @since 2026-04-12

设置当前线程的数据权限上下文 @param context 数据权限上下文

为用户分配角色 <p>校验用户和角色是否存在，以及是否已存在相同的关联关系。</p> @param request 分配角色请求体（包含用户ID和角色ID） @return 分配结果

构建 Redis Key @param userId 用户 ID @param sessionId 会话 ID @return evolvehub:session:{userId}:{sessionId}

根据模型配置构建 ChatModel 实例 @param config 模型配置实体 @return ChatModelBase 实例（OpenAIChatModel 或 AnthropicChatModel）

获取用户 Memory 画像 @param userId 用户 ID @return Markdown 内容 @author TellyJiang @since 2026-04-11

分页查询当前用户的 MCP 配置列表

归一化重要性分值 @param importance 原始分值 @return 归一化结果 @author TellyJiang @since 2026-04-11

查询相似向量记忆 @param userId 用户 ID @param query 查询文本 @param topK 数量 @return 召回结果 @author TellyJiang @since 2026-04-15

测试模型连通性 @param provider 提供商标识（如 openai / deepseek / anthropic） @param baseUrl 自定义基址，为空时使用提供商默认地址 @param apiKey API 密钥 @return 测试结果

修改用户（超级管理员和普通管理员） @param request 修改请求 @return 用户信息

构建存储路径

禁用数据权限过滤（在查询完成后调用）

启用数据权限过滤（在需要过滤的查询前调用）