> ## Documentation Index
> Fetch the complete documentation index at: https://docs.qoder.com/llms.txt
> Use this file to discover all available pages before exploring further.
# 设置与管理
> 配置 QoderWake 的偏好设置、系统设置，运行网络诊断，管理环境与设备，以及检查更新。
点击左下角齿轮后会先打开快捷菜单，再点击其中的「设置」进入完整设置页。设置页左侧包含「偏好设置」「系统设置」「网络诊断」「管理环境与设备」和「更新应用」。
设置项通常会自动保存。修改后切换页面再返回，仍显示新值即表示保存成功。
## 配置偏好设置
选择界面语言、AI 回复语言或主题，等待自动保存后重新进入本页确认。AI 回复语言只影响新会话的默认语言。
页面重新打开后仍显示所选值即表示保存成功。
## 配置系统设置
| 设置项 | 开启后的行为 | 建议 |
| -------- | ------------------------ | --------------------- |
| 开机自动启动 | 系统登录时自动启动 QoderWake 后台进程 | 经常使用本地 Waker 或自动任务时开启 |
| 保持系统唤醒 | 对话或自动任务运行期间防止电脑自动睡眠 | 本地长任务、定时任务所在设备建议开启 |
| 允许远端配置管理 | 允许从其他设备修改 Waker、技能和连接器配置 | 有远端管理需求时开启 |
切换开关并等待自动保存。认证凭据、Token 和密钥仍保留在本机；文件和工具能力继续受项目及权限配置限制。
重新进入本页后开关状态不变即表示保存成功。
## 运行网络诊断
1. 点击「开始诊断」。
2. 等待 Gateway 认证、机器注册和 Work 回程检查完成。
3. 失败时展开该项，记录摘要和日志，修复登录、设备或网络问题后重新诊断。
Gateway 认证、机器注册和 Work 回程均显示通过即表示网络正常。
## 管理环境与设备
1. 点击「刷新」，核对设备名称、在线状态、版本和 Waker 数量。
2. 添加设备时点击「添加设备」，选择系统并复制命令，在目标机器完成安装和登录。
3. 返回设备页刷新，确认新设备出现；离线且不是当前设备的记录可按页面提示移除。
新设备出现在当前账号的环境与设备列表中，并显示可识别的在线状态即表示添加成功。
设备未出现时，在目标机器确认服务和账号：
```bash theme={null}
qoderwake status
qoderwake whoami
```
确认服务已运行且登录的是同一账号，再回到页面刷新。
## 检查更新并让新版本生效
页面会显示当前运行版本并提供「检查更新」。记录当前版本，点击「检查更新」并按提示安装；确认没有重要任务运行后重启服务。
重启后"当前版本"显示为目标新版本，并且 Web Console、Waker 和任务页面能够正常打开即表示更新成功。
也可使用命令行检查、安装并重启：
```bash theme={null}
qoderwake update --check
qoderwake update
qoderwake restart
```
登录失效但只需继续使用本地模式时，执行 `qoderwake restart --force`。
若更新已经安装，但重启后版本仍未变化，再次确认服务已重启，并执行 `qoderwake status` 核对运行版本。