AI 助手
AI 助手用于通过自然语言完成常见运维操作，例如查询玩家、修改血量、执行备份与查看日志。所有工具调用均受权限与开关控制，并写入审计记录。
配置模型
在「AI 设置」中填写模型服务地址、API Key 与模型名称。支持兼容 OpenAI Chat Completions 协议的服务。
保存后可在对话页面直接提问。模型不可用时，面板会显示具体的连接错误，不会静默失败。
工具开关
AI 的能力由工具定义决定。每个工具包含：
- 工具 ID 与用途说明。
- 所需权限。
- 默认开关状态。
- 当前是否可用，以及不可用的原因。
默认开启的工具覆盖日常查询与玩家操作，包括玩家列表、玩家操作、文档检索与工具清单。涉及命令执行、文件写入与通用 API 调用的工具默认关闭，需要用户手动开启。
工具关闭后，AI 仍然可以看到它的定义与用途，但调用会被拒绝，并收到明确原因。此时助手应当提示用户去「AI 设置 → 工具」开启，而不是改用其他方式尝试。
工具清单
在对话中可以直接要求助手列出当前工具，或使用「工具清单」工具查看：
- 全部工具的 ID、描述与所需权限。
- 是否开启、是否默认开启。
- 不可用时给出原因。
- 当前账号是否具备所需权限。
审批
高风险工具调用可配置为人工审批或自动审批：
- 人工审批：调用前在对话中显示审批卡片，由用户决定是否执行。
- 自动审批：由模型判断调用是否符合用户意图，并给出放行或拒绝的理由。
- 拒绝理由：无论哪种方式，拒绝都会附带明确原因，助手据此调整方案。
审批记录可在审计日志中查询。
权限模型
面板账号分为三档：
| 角色 | 说明 |
|---|---|
| 超级管理员 | 全部功能与面板设置 |
| 管理员 | 实例与玩家管理，受实例授权限制 |
| 普通用户 | 只读或按授权的操作 |
实例级权限包括文件、控制台、实例控制与资源管理。插件接口另有单独权限：玩家查看、玩家管理、背包编辑、世界管理与控制台。
AI 工具调用使用对话发起者本人的权限，不会获得超出该账号的能力。
安全说明
- 面板自身目录与监听端口对 AI 工具不可见、不可操作。
- 命令执行类工具在受限工作区内运行。
- 所有写操作均记录操作者、参数与结果。
- 建议仅为可信账号开启高风险工具。
常见问题
助手说没有某个能力
先查看工具清单确认该工具的开关与权限。若为默认关闭，请手动开启；若缺少权限，请由管理员在账号权限中授权。
调用一直等待
检查模型服务地址与网络连通性，以及 API Key 是否有效。长任务可能触发超时，可在设置中调整。
审批被自动拒绝
查看拒绝理由。若理由与预期不符，可改为人工审批，或调整提问方式后重试。