添加安全扫描白名单请求

后台管理访问控制 Filter <p> 拦截 /admin/ 路径，只允许 SUPER_ADMIN 和 ADMIN 角色访问 其他角色访问返回 403 权限不足 </p> @author zhao

AgentScope Memory 对象实体 @author TellyJiang @since 2026-04-12

AgentScope Memory 对象 Mapper @author TellyJiang @since 2026-04-12

AgentScope Memory 对象仓储 @author TellyJiang @since 2026-04-12

AgentScope 用户画像索引实体 @author TellyJiang @since 2026-04-12

AgentScope 用户画像 Mapper @author TellyJiang @since 2026-04-12

AgentScope 用户画像仓储 @author TellyJiang @since 2026-04-12

AgentScope 长期记忆记录实体 @author TellyJiang @since 2026-04-12

AgentScope 长期记忆 Mapper @author TellyJiang @since 2026-04-12

AgentScope 长期记忆仓储 @author TellyJiang @since 2026-04-12

AgentScope 会话元数据实体 @author TellyJiang @since 2026-04-12

AgentScope 会话元数据 Mapper @author TellyJiang @since 2026-04-12

AgentScope 会话元数据仓储 @author TellyJiang @since 2026-04-12

批量更新Agent运行时配置

Agent运行时配置管理

获取Agent运行时配置默认值

Agent运行时配置实体

获取Agent运行时配置

Agent运行时配置变更历史实体

获取Agent运行时配置变更历史

Agent运行时配置历史响应

Agent运行时配置响应

更新Agent运行时配置

AgentScope 智能体工厂接口 @author TellyJiang @since 2026-04-14

AgentScope 对话门面接口 负责封装标准的 AgentScope 会话恢复、调用和保存流程。 @author TellyJiang @since 2026-04-14

AgentScope Memory 运行时服务 该接口直接面向 AgentScope 对话系统暴露短期记忆、长期记忆与会话状态能力， 是 memory 模块供外部 AgentScope 运行时接入的主入口。 @author TellyJiang @since 2026-04-12

AgentScope 模型解析接口 @author TellyJiang @since 2026-04-14

AgentScope 消息映射器 负责业务侧字符串消息与 AgentScope Msg 之间的双向映射。 @author TellyJiang @since 2026-04-12

基于 Spring Redis 的 AgentScope Session 实现 @author TellyJiang @since 2026-04-12

API Key 管理控制器 <p> 管理员为用户生成、重置、禁用 API Key。 所有接口仅超级管理员可操作。 </p> @author zhao @version v1.0 @date 2026/4/13

用户 API Key 实体类 <p> 一个用户对应一个 API Key，用于调用系统级资源时的身份认证。 </p> @author zhao @version v1.0 @date 2026/4/13

用户 API Key 实体类 <p> 一个用户对应一个 API Key，用于调用系统级资源时的身份认证。 </p> @author zhao @version v1.0 @date 2026/4/13

API Key 数据访问层 @author zhao @version v1.0 @date 2026/4/13

API Key 数据访问层 @author zhao @version v1.0 @date 2026/4/13

资源授权业务处理器 <p> 业务规则： <ul> <li>目标用户必须存在</li> <li>不能重复授权</li> </ul> @author zhao @version v1.0 @date 2026/4/13

资源授权请求 @param userId 被授权用户 ID @param resourceType 资源类型（MODEL / SKILL / MCP） @param resourceId 资源 ID

资源授权响应 @param id 授权记录 ID

设置角色自定义数据范围业务处理器 <p> 业务规则： <ul> <li>角色必须存在</li> <li>角色 dataScope 必须为 5（自定义），否则不允许设置部门列表</li> <li>所有指定的部门 ID 必须存在</li> <li>执行时全量替换（先清除旧

设置角色数据范围请求 @param roleId 角色ID @param deptIds 自定义数据范围的部门ID列表

设置角色数据范围响应

为角色分配权限业务处理器 <p> 业务规则： <ul> <li>角色必须存在</li> <li>权限必须存在</li> <li>不允许重复分配同一权限</li> </ul> @author zhao @version v1.0 @date 2026/4/9

为角色分配权限请求 @param roleId 角色ID @param permissionId 权限ID

为角色分配权限响应

为用户分配角色业务处理器 <p> 业务规则： <ul> <li>用户必须存在</li> <li>角色必须存在</li> <li>不允许重复分配同一角色</li> </ul> @author zhao @version v1.0 @date 2026/4/9

为用户分配角色请求 @param userId 用户ID @param roleId 角色ID

为用户分配角色响应

认证控制器 <p> 提供登录、登出接口。login 在网关白名单中，无需携带 token。 用户注册功能已移除，用户只能由管理员在后台管理界面创建。 </p> @author zhao devnomad-byte

对话模型可用性校验支持类 @author TellyJiang @since 2026-04-18

可用资源聚合查询控制器 <p> 返回当前用户可使用的所有资源（自己的用户级资源 + 被授权的系统级资源）。 </p> @author zhao

BaseConverter

@author zhao @version v1.0 @className BaseEntity @description 统一父类，createTime / updateTime 由 MybatisPlusMetaHandler 自动填充，开发时无需关心 @date 2026/4/9 14:27

业务处理抽象父类 <p> 定义统一的业务处理流程：先执行参数校验（check），再执行业务处理（process）。 所有具体的业务操作（如创建、更新、删除、查询等）均继承此类， 并实现 check 和 process 两个模板方法。 </p> <p>调用方式：通过 {@link #execute(O

批量测试 SYSTEM 公共模型连通性 <p> 流程： <ul> <li>查询所有 scope=SYSTEM 的模型</li> <li>逐个调用 ModelConnectivityTester 测试</li> <li>失败模型自动禁用（enabled=0）</li>

公共模型批量连通性测试响应

批量更新Agent运行时配置请求

Bucket 信息

Bucket 元数据

业务异常 <p> 在业务逻辑中主动抛出，由全局异常处理器统一捕获并返回给前端。 <p> 用法示例： <pre> throw new BusinessException(ResultCode.DATA_NOT_EXIST); throw new BusinessException("用户名已被

对话 Agent 工厂 <p> 每次对话请求时，根据模型配置和用户权限构建一个完整的 ReActAgent 实例。 Agent = ChatModel + Toolkit（记忆工具 + MCP + Skill）+ 系统提示词。 </p> @author zhao

对话上下文 Redis 缓存服务（Hash 结构） <p> Redis key = evolvehub:session:{userId}:{sessionId}，Hash 内含两个 field： <ul> <li><b>summary</b>：LLM 压缩后的摘要（轻量，每次对话必读，检索快）<

管理员导出对话历史

管理员查询会话的消息列表

管理员查询用户的会话列表

管理员查询有聊天记录的用户列表

长期记忆服务 <p> 基于 Milvus（Zilliz Cloud）实现长期记忆的存储、检索和管理。 <ul> <li>检索：将查询文本向量化 → Milvus 余弦相似度搜索 → 返回 Top-K 记忆文本</li> <li>提取：对话结束后，用 LLM 提取值得记忆的内容 → 向量化 →

对话消息实体 @author zhao @date 2026/4/14

对话消息 Mapper @author TellyJiang @since 2026-04-17

聊天模型工厂 <p> 根据模型配置（provider / baseUrl / apiKey / modelName）动态构建 AgentScope ChatModel 实例。 每次调用都会创建新实例，保证线程安全（AgentScope Model 有状态，不可共享）。 </p> <p> 支持的 pr