写入摘要到 Redis（同时刷新 TTL） @param userId 用户 ID @param sessionId 会话 ID @param summary 摘要文本

判断扫描结果是否可以跳过 所有级别（包括 CRITICAL）均可被 force-proceed 忽略

检查实例是否健康

清理 UTF-8 内容中的无效字符（PostgreSQL TEXT 不允许 0x00）

提交完整问答回合 @param userId 用户 ID @param sessionId 会话 ID @param userMessage 用户消息 @param assistantMessage 助手回复 @param modelName 模型名称 @return 最新会话状态 @author

将 McpSchema.Tool 转换为实体

统计指定部门下的用户数量（删除部门前的关联检查） @param deptId 部门 ID @return 该部门下的用户数

构建 ReActAgent 实例 @param modelConfig 模型配置 @param userId 当前用户 ID @param sessionId 当前会话 ID @param sysPrompt 系统提示词 @return 组装完成的 ReActAgent

创建部门（超级管理员和普通管理员） @param request 创建请求 @return 部门信息

为用户创建 API Key @param userId 用户 ID @return 创建的 API Key 实体

创建 MCP 客户端

删除 MCP 配置下的所有工具

删除用户（仅超级管理员） @param userId 用户 ID @return 空

检测有效工作目录 如果 ZIP 解压后只有一个顶层目录（GitHub 下载格式如 servers-main/）， 自动提升到该目录作为工作目录

自动检测 Node.js 包入口文件 优先级：package.json 的 bin 字段 > main 字段 > 常见路径猜测 返回相对路径（相对于工作目录）

获取向量维度 @return 向量维度 @author TellyJiang @since 2026-04-15

发现并保存工具

检查用户是否已被授权某个资源 @param userId 用户 ID @param resourceType 资源类型（MODEL / SKILL / MCP） @param resourceId 资源 ID @return true 表示已授权

检查用户是否已被授权某个资源 @param userId 用户 ID @param resourceType 资源类型（MODEL / SKILL / MCP） @param resourceId 资源 ID @return true 表示已授权

提取会话记忆 @param request 提取请求 @return 提取结果 @author TellyJiang @since 2026-04-11

异步提取会话记忆 @param request 提取请求 @author TellyJiang @since 2026-04-15

生成 sk- 前缀的 API Key @return 格式为 sk-{32位随机hex} 的密钥

生成 sk- 前缀的 API Key @return 格式为 sk-{32位随机hex} 的密钥

获取所有真正运行中的实例 过滤掉 client 已丢失的"孤儿"记录

根据邮箱查询用户（唯一性校验） @param email 邮箱地址 @return 用户实体，不存在返回 null

根据手机号查询用户（唯一性校验） @param phone 手机号 @return 用户实体，不存在返回 null

根据规则ID查询

根据用户 ID 查询 @param userId 用户 ID @return API Key 实体，不存在返回 null

根据用户 ID 查询 @param userId 用户 ID @return API Key 实体，不存在返回 null

获取配置（单条）

根据文件扩展名获取 Content-Type

获取当前操作者用户 ID @return 当前用户 ID @author TellyJiang @since 2026-04-11

获取所有启用的规则

获取 Hub 名称

获取 MCP 客户端

懒加载 + 双重检查锁构建 EmbeddingModel

获取 AgentScope Session 实例 @return Session 对象 @author TellyJiang @since 2026-04-12

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

插入新配置

按部门列表 + 关键字搜索用户（用于对话历史管理） @param deptIds 可见部门列表（null/空表示不限部门） @param keyword 用户名/昵称关键字（可选） @param pageNum 页码 @param pageSize 每页条数

查询用户可用的系统级 MCP 服务（通过授权 ID 列表）

查询用户自建的已启用 MCP 服务 @param ownerId 用户 ID @return 已启用的 MCP 配置列表

查询用户被授权的某类资源 ID 列表 @param userId 用户 ID @param resourceType 资源类型 @return 资源 ID 列表

列出指定 bucket、前缀下的文件，支持 delimiter（文件夹浏览）

用户登录 @param request 登录请求体（username + password） @return token 及用户信息

角色标签映射

* 解析 SSE 数据块

记录配置变更

将结构化画像渲染为 Markdown @param profile 画像对象 @return Markdown 内容 @author TellyJiang @since 2026-04-11

执行 npm install

保存向量记忆 @param item 结构化记忆 @return 保存结果 @author TellyJiang @since 2026-04-11

写入/更新用户的 MEMORY.md @param userId 用户 ID @param content Markdown 内容

批量保存工具

对文本内容执行所有规则扫描