常见问题
按遇到的现象查找，先检查状态和日志，再重试操作。
执行节点未上线
在节点主机以实际服务账号的权限运行：
gamex daemon status
gamex daemon doctorstatus 显示本机服务状态及可用的连接信息，doctor 检查 Docker 连接。节点到面板的连接由节点主动发起，需检查面板地址、系统时间、TLS、反向代理 WebSocket 转发和节点日志。自定义配置安装时，命令需要使用相同的 --config 路径。
详细步骤见接入节点。
节点在线，但服务器无法启动
- 检查 Docker 是否可用、镜像是否匹配节点架构、资源容量及端口是否冲突。
- 确认工作区已经部署，启动命令有效，且当前账号有写权限。
- 查看主服务控制台的退出原因，检查启动脚本、运行时路径和配置文件。
- 修复后启动或重启主服务，并查看服务诊断。容器仍在运行时，主服务也可能已经退出。
停止主服务后，Shell 和文件管理仍可用于排障。容器被重建时，仅 /workspace 中的数据保留，重建前应先定位原因。详见管理服务器。
服务显示运行，但玩家无法连接
- 核对游戏监听端口、TCP/UDP 协议和工作区端口映射。
- 检查主机防火墙、云安全组和路由器转发。
- 从玩家使用的网络实际连接游戏。
节点诊断只反映节点主机的检查结果。AI 的公网端口检查从面板服务器发起，只检查指定公网 IP 的 TCP 连接；UDP 探测也不能证明游戏服务可正常加入。
停服后仍能打开 Shell，环境变量修改却没有立即生效
主服务停止与工作区容器停止是不同操作。已有 Shell 可继续运行，变量和 Secret 的变更供新进程使用，不会替换已启动进程的环境。需要时重开 Shell 或重启主服务，见管理服务器。
长命令还在运行，但看不到之前的输出
先读取原 Shell 会话的最新输出，不要立即重复执行命令。旧输出被清理后仍可能保留最近一段；若会话已结束并被清理，则需查看任务日志或程序自己的日志。
AI 没有可选模型，或已保存模型不可用
请超级管理员在「智能体管理」中检查服务商凭据、方案、模型发现结果和启用状态。列表可见不代表已启用，无预设模型的方案初次发现后需要手动启用。为模型分工选择可用模型，并在会话中重新选择被禁用或移除的模型。
连接或流式空闲超时可检查服务商请求超时，修改作用于新任务。AI_PROVIDER_EMPTY_RESPONSE 表示空响应恢复已耗尽，AI_PROVIDER_INVALID_RESPONSE 表示响应或工具调用格式不符合要求。检查请求记录、上游状态及所选模型能力后再重试。配置步骤见AI 助手与自动化。
AI 不能读取服务器文件，或任务停在审批处
文件、日志和 Shell 操作使用工作区会话。管理面板对话交接任务后，可打开目标工作区查看进度；原对话仍可继续使用。确认账号仍有工作区权限，模式允许该操作，并从待处理提示打开问题或审批。
审批不能扩大账号权限，完全访问权限也保留必要的人工审批。无人值守定时任务遇到不能安全自动处理的询问、Secret 或审批时会以策略错误结束。任务失败、中断或归档后，后续队列会暂停，处理问题后可在面板点击「继续执行队列」。
插件无法安装，或安装后没有显示面板
检查版本撤销、签名、兼容性、配置和权限。不是所有插件都提供面板，有面板的插件还需在安装项运行设置中授权目标工作区。浏览器资源策略也必须允许所需来源。
详细步骤见安装与管理插件。
QQ 机器人已连接，却不回复或无法执行任务
依次确认接入模式、机器人凭据与平台事件配置、目标工作区授权、外部会话绑定和绑定人的当前权限。连接成功不等于已有有效绑定或可用模型。需要强验证的审批应返回面板处理，消息发送也受 QQ 平台窗口与限制约束。
具体设置、命令和接入诊断见QQ 机器人。
升级后面板提示数据库需要迁移
现有数据库启动时只校验迁移状态，不会自动迁移。先备份数据库、配置和加密密钥，停止旧面板，再用新版本和相同配置运行数据库迁移。每个数据库运行一个面板。源码和 Compose 的具体命令见升级与备份。
删除会话后记忆仍然存在
记忆单独保存，删除会话不会一并清除。打开会话的「记忆」可编辑或清除当前账号的个人记忆；绑定外部聊天前，先清除不适合分享的内容。详见AI 助手与自动化。
如何报告安全问题
通过对应仓库 SECURITY.md 的私密入口报告凭据或生产环境问题。
插件安全边界见插件权限与安全。