常见问题

Agent 找不到 Manager Skill

确认安装器输出的 Skill 目录与当前 Agent 类型一致，然后完全关闭并重新打开 Agent 会话。仍然无法识别时，将本页面和安装页面交给 Agent，让其检查安装目录和 SKILL.md 是否完整。

Node.js 版本不满足要求

Manager Skill 要求 Node.js 18 或更高版本。升级 Node.js 后重新运行安装器。

Manager Skill 安装包下载失败

确认 Agent 所在机器可以访问 Manager Skill 的固定下载地址。如果仍然无法下载，请检查网络和代理配置，或在浏览器中下载安装包后交给 Agent 安装。

登录失败或 Token 已失效

要求 Agent 使用 selectdb-manager 检查登录状态并生成重新登录命令。用户在自己的终端中执行命令并输入密码，不要把密码发送给 Agent。

如何切换 Manager 或账号

可以要求 Agent 查看已经配置的 Profile 并切换到指定 Profile。新增 Manager 或账号时，Agent 会生成交互式登录命令。建议使用能够区分环境和权限的名称，例如 production-readonly。

Manager 无法连接

检查 Enterprise Manager 地址、HTTPS 证书、网络和代理配置。连接失败只能证明当前无法访问 Manager，不能据此判断 Token、集群或节点状态。

提示没有权限

Manager Skill 复用当前 Manager 账号的权限。请让 Enterprise Manager 管理员为账号授予目标集群和目标操作所需的权限，不要尝试通过 SSH、直连 API 或其他账号绕过权限检查。

某项能力不可用

实际能力由 Manager 版本、运行模式、组件配置和账号权限共同决定。可以要求 Agent 说明缺少的能力和依赖；Agent 不应改用 curl、SSH、kubectl 或直连 Doris 作为替代方案。

Kubernetes 能力没有出现

确认连接的是 Kubernetes 模式的 Enterprise Manager，并检查 Manager 版本、Kubernetes 权限、Doris Operator、CRD 和目标集群状态。传统主机模式不会开放 Kubernetes 资源查询和变更能力。

查询不到慢 SQL 或 Query Profile

慢 SQL 依赖 Doris Audit Log、查询时间范围和账号权限。Query Profile 还依赖 Doris 是否仍然保留对应 Query ID 的 Profile。Profile 不存在时，可以继续结合慢 SQL、指标和日志分析，但不能推测缺失的 Fragment 或 Operator 数据。

操作预览已经变化

集群状态或目标参数发生变化时，Enterprise Manager 会拒绝旧的操作摘要。Agent 应重新生成并展示预览，用户确认新预览后才能继续。

等待操作超时

等待超时不代表 Manager 任务已经失败或取消。可以要求 Agent 查询该任务的当前状态。不要在状态未知时重复提交同一个变更。