获取技能工作区路径

将 HTTP 状态码转换为用户友好的错误消息

按 MCP Server ID 查询所有工具

列出技能工作区文件 直接从 S3 读取目录结构，支持子目录导航 @param skillId 技能 ID @param path 子目录路径，如 "scripts/"，为空表示根目录

获取 MCP 下的工具列表

判断是否像路径

召回长期记忆 @param userId 用户 ID @param query 查询语句 @param topK 召回数量 @return 召回结果 @author TellyJiang @since 2026-04-11

检索与查询文本最相关的长期记忆（使用原生 MilvusClientV2，支持 user_id filter） @param userId 用户 ID @param query 查询文本 @param topK 返回条数 @return 记忆文本列表（按相关性排序）

按用户和记忆键保存或更新 @param entity 用户记忆 @author TellyJiang @since 2026-04-18

更新用户级 MCP 配置

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

创建单个 SkillConfig：保存记录 + 上传文件到 S3 @return 新创建 skill 的 ID

创建用户（仅超级管理员） @param request 创建请求 @return 用户信息

递归删除目录

删除可管理记忆 @param userId 用户 ID @param memoryId 记忆主键 @author TellyJiang @since 2026-04-15

下载文件

下载并解析技能包

从 Msg 中提取文本内容

获取部门及其所有祖先部门的 ID 列表（含自身） <p> 从当前部门出发，沿 parentId 向上遍历直到顶级（parentId=0）， 返回所有途经部门的 ID。 </p> @param deptId 起始部门 ID @return 包含自身及所有祖先部门 ID 的列表，deptId 无效时返

根据用户名查询用户（登录 / 唯一性校验） @param username 用户名 @return 用户实体，不存在返回 null

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

读取上下文摘要（优先 Redis，miss 回源 DB 并回填） @param userId 用户 ID @param sessionId 会话 ID @return 摘要文本，不存在则返回 null

获取全局唯一的系统级向量模型 @return 向量模型配置，不存在时返回 null

提取消息文本 @param msg AgentScope 消息 @return 文本内容 @author TellyJiang @since 2026-04-12

处理不健康的实例

按用户和类型查询结构化记忆 @param userId 用户 ID @param memoryType 记忆类型 @return 结构化记忆 @author TellyJiang @since 2026-04-18

按用户ID列表查询用量记录

查询可管理记忆 @param userId 用户 ID @return 可管理记忆列表 @author TellyJiang @since 2026-04-15

按 ownerId 分页查询（用户级资源）

查询用户被授权的某类资源 ID 列表（包含用户直接授权 + 用户所属部门的授权） @param userId 用户 ID @param deptId 用户部门 ID（可为 null） @param resourceType 资源类型 @return 资源 ID 列表（去重）

保存对话长期记忆 @param userId 用户 ID @param sessionId 会话 ID @param content 记忆内容 @param importance 重要性 @return 保存结果 @author TellyJiang @since 2026-04-15

直接保存用户 Memory 画像 Markdown @param userId 用户 ID @param markdownContent Markdown 内容 @return 保存后的 Markdown 内容 @author TellyJiang @since 2026-04-15

直接保存用户画像 Markdown @param userId 用户 ID @param markdownContent Markdown 内容 @return 保存后的 Markdown 内容 @author TellyJiang @since 2026-04-15

扫描文本内容（SKILL.md 等）

搜索技能

启动 MCP Server

更新心跳时间

追加用户 Memory 画像 Markdown @param userId 用户 ID @param content 要追加的内容 @return 更新后的 Markdown 内容 @author TellyJiang @since 2026-04-15

追加会话记忆 @param userId 用户 ID @param sessionId 会话 ID @param message 消息内容 @param modelName 模型名称 @return 会话记忆 @author TellyJiang @since 2026-04-11

校验记忆提取请求权限 @param request 提取请求 @author TellyJiang @since 2026-04-11

校验结构化记忆写入权限 @param item 结构化记忆 @author TellyJiang @since 2026-04-11

拼接列名（支持表别名）

构建对话上下文 @param userId 用户 ID @param sessionId 会话 ID @param query 当前用户输入 @param topK 长期记忆召回数量 @return 上下文装配结果 @author TellyJiang @since 2026-04-16

构建菜单树 @param menus 所有菜单列表 @param parentId 父菜单 ID @return 菜单树

构建 AgentScope SessionKey @param userId 用户 ID @param sessionId 会话 ID @return SessionKey @author TellyJiang @since 2026-04-12

构建 StreamOptions（用于 agent.stream() 调用） <p> 订阅所有事件类型：REASONING（推理）+ TOOL_RESULT（工具调用结果）+ AGENT_RESULT（最终结果）。 增量模式（incremental=true），每个 Event 只包含新增的内容片段