设置与管理

配置 QoderWake 的偏好设置、系统设置，运行网络诊断，管理环境与设备，以及检查更新。

点击左下角齿轮后会先打开快捷菜单，再点击其中的「设置」进入完整设置页。设置页左侧包含「偏好设置」「系统设置」「网络诊断」「管理环境与设备」和「更新应用」。

设置项通常会自动保存。修改后切换页面再返回，仍显示新值即表示保存成功。

​

配置偏好设置

选择界面语言、AI 回复语言或主题，等待自动保存后重新进入本页确认。AI 回复语言只影响新会话的默认语言。

页面重新打开后仍显示所选值即表示保存成功。

​

配置系统设置

设置项	开启后的行为	建议
开机自动启动	系统登录时自动启动 QoderWake 后台进程	经常使用本地 Waker 或自动任务时开启
保持系统唤醒	对话或自动任务运行期间防止电脑自动睡眠	本地长任务、定时任务所在设备建议开启
允许远端配置管理	允许从其他设备修改 Waker、技能和连接器配置	有远端管理需求时开启

切换开关并等待自动保存。认证凭据、Token 和密钥仍保留在本机；文件和工具能力继续受项目及权限配置限制。

重新进入本页后开关状态不变即表示保存成功。

​

运行网络诊断

1. 点击「开始诊断」。
2. 等待 Gateway 认证、机器注册和 Work 回程检查完成。
3. 失败时展开该项，记录摘要和日志，修复登录、设备或网络问题后重新诊断。

Gateway 认证、机器注册和 Work 回程均显示通过即表示网络正常。

​

管理环境与设备

1. 点击「刷新」，核对设备名称、在线状态、版本和 Waker 数量。
2. 添加设备时点击「添加设备」，选择系统并复制命令，在目标机器完成安装和登录。
3. 返回设备页刷新，确认新设备出现；离线且不是当前设备的记录可按页面提示移除。

新设备出现在当前账号的环境与设备列表中，并显示可识别的在线状态即表示添加成功。

设备未出现时，在目标机器确认服务和账号：

qoderwake status
qoderwake whoami

确认服务已运行且登录的是同一账号，再回到页面刷新。

​

检查更新并让新版本生效

页面会显示当前运行版本并提供「检查更新」。记录当前版本，点击「检查更新」并按提示安装；确认没有重要任务运行后重启服务。

重启后”当前版本”显示为目标新版本，并且 Web Console、Waker 和任务页面能够正常打开即表示更新成功。

也可使用命令行检查、安装并重启：

qoderwake update --check
qoderwake update
qoderwake restart

登录失效但只需继续使用本地模式时，执行 qoderwake restart --force。

若更新已经安装，但重启后版本仍未变化，再次确认服务已重启，并执行 qoderwake status 核对运行版本。