深色模式
App 设置
YuerKey App 提供丰富的设置选项，分为两大部分：设备设置（远程配置 YuerKey 设备）和 App 偏好（配置 App 本身的行为和外观）。
设备设置
通过 App 连接 YuerKey 设备后，你可以远程修改设备的各项设置，无需在设备的小屏幕上逐项操作。
提示
修改设备设置需要 App 与设备保持连接。设置修改后实时同步到设备。
显示
控制 YuerKey 设备的屏幕显示参数。
| 设置项 | 说明 | 范围 |
|---|---|---|
| 屏幕亮度 | 调节 LCD 屏幕的背光亮度 | 25% - 100%，支持滑动调节 |
| 自动锁屏时间 | 不操作后自动关闭屏幕并锁定设备 | 30 秒 / 1 分钟 / 2 分钟 / 5 分钟 / 10 分钟 / 永不 |
屏幕亮度建议：
- 日常使用：50%-70%
- 强光环境：80%-100%
- 省电模式：25%-40%
语言
切换 YuerKey 设备的界面显示语言：
| 语言 | 说明 |
|---|---|
| 简体中文 | 所有菜单、提示使用简体中文显示 |
| English | 所有菜单、提示使用英文显示 |
切换语言后，设备会立即应用新的语言设置，无需重启。
提示
设备语言和 App 语言是独立设置的，互不影响。
日期与时间
管理 YuerKey 设备的时间设置，准确的时间对 TOTP 验证码至关重要。
同步时间
点击「同步时间」按钮，将手机的当前时间通过蓝牙同步到 YuerKey 设备。
建议在以下情况下同步时间：
- 首次配对设备后
- 设备长时间断电后
- TOTP 验证码不被网站接受时
- 更换时区后
时区设置
选择设备所在的时区，范围从 UTC-12 到 UTC+14。时区影响设备屏幕上显示的当前时间。
注意
TOTP 验证码基于 UTC 时间计算，与时区设置无关。时区仅影响设备屏幕上的时间显示。
安全
配置设备的安全相关选项。
修改 PIN
更改设备的锁屏 PIN 码：
- 点击「修改 PIN」
- 输入当前 PIN（首次设置则跳过）
- 输入新 PIN（4-8 位数字）
- 再次输入新 PIN 确认
- 修改成功
重要
请牢记你的 PIN 码。连续输错多次后设备会被锁定，需要恢复出厂设置才能解除。
锁屏模式
设置设备的锁屏保护级别：
| 模式 | 说明 | 安全级别 |
|---|---|---|
| 无锁屏 | 设备不锁定，任何人可操作 | 低 |
| 简单锁屏 | 锁屏后按任意键解锁，仅防误触 | 中 |
| PIN 保护 | 锁屏后需要输入 PIN 解锁 | 高 |
建议日常使用选择「PIN 保护」模式，确保设备丢失后数据安全。
存储
管理设备的存储设置。
存储类型
选择 USB 存储使用的介质：
| 类型 | 说明 |
|---|---|
| Flash | 使用设备内置 Flash 存储 |
| SD 卡 | 使用外接 SD 卡（需硬件支持） |
USB 存储
开启或关闭 USB 大容量存储功能。开启后，YuerKey 连接电脑时会被识别为可移动磁盘。
详细说明参见 USB 存储。
HTTP 文件服务器
开启或关闭 Web 文件管理功能。开启后，同一局域网内的设备可以通过浏览器访问 YuerKey 上的文件。
详细说明参见 USB 存储 - HTTP 文件服务器。
系统
设备系统级设置。
检查更新
手动检查固件是否有新版本：
- 点击「检查更新」
- 设备通过 WiFi 连接更新服务器
- 如果有新版本，显示版本号和更新说明
- 选择「立即更新」开始 OTA 更新
详细说明参见 固件更新。
WiFi 设置
管理设备的 WiFi 连接：
- 点击「WiFi 设置」
- App 显示可用的 WiFi 网络列表
- 选择网络并输入密码
- 连接成功后设备记住该网络
设备支持记住多个 WiFi 网络，自动连接已知网络。
恢复出厂设置
将设备恢复到出厂状态：
- 点击「恢复出厂设置」
- App 显示警告信息
- 输入设备 PIN 确认
- 在 YuerKey 设备上按确认键二次确认
- 设备开始重置
警告
恢复出厂设置会清除设备上的所有数据，包括：
- 密码保险库中的所有凭证
- 所有 OTP 令牌
- PIV 证书和密钥
- OpenPGP 密钥
- WiFi 配置
- 所有配对信息
此操作不可逆！请在执行前确保已备份重要数据。
关于
查看设备的详细信息：
| 信息 | 说明 |
|---|---|
| 固件版本 | 当前固件的版本号 |
| 硬件版本 | 硬件修订版本 |
| 序列号 | 设备唯一标识 |
| MAC 地址 | 蓝牙 MAC 地址 |
| 存储用量 | 已使用/总计存储空间 |
| 运行时间 | 自上次开机以来的运行时间 |
App 偏好
以下设置仅影响 App 本身，不会影响 YuerKey 设备。
主题
自定义 App 的外观主题：
| 选项 | 说明 |
|---|---|
| 跟随系统 | 自动匹配手机系统的深色/浅色模式（默认） |
| 浅色模式 | 始终使用浅色主题，白色背景 |
| 深色模式 | 始终使用深色主题，深色背景 |
| AMOLED 纯黑 | 深色模式下使用纯黑背景 |
AMOLED 纯黑模式
专为 OLED/AMOLED 屏幕优化：
- 使用纯黑（#000000）背景
- OLED 屏幕显示纯黑时像素完全关闭，更省电
- 在暗光环境下对眼睛更友好
Material You 动态取色
在 Android 12 及以上系统中，App 支持 Material You 动态取色：
- 自动提取系统壁纸的主色调
- 将主色调应用到 App 的按钮、图标、强调色等元素
- 让 App 的配色与你的手机整体风格保持一致
其他平台（iOS、桌面）使用 App 默认配色方案。
语言
切换 App 的界面语言：
| 语言 | 说明 |
|---|---|
| 跟随系统 | 自动匹配手机系统语言（默认） |
| 简体中文 | 强制使用简体中文 |
| English | 强制使用英文 |
安全
生物识别锁定
开启后，每次打开 App 都需要通过生物识别验证身份：
| 平台 | 支持的验证方式 |
|---|---|
| Android | 指纹、面部识别、设备 PIN/密码 |
| iOS | Face ID、Touch ID |
| 桌面端 | 系统生物识别（如 Windows Hello） |
开启步骤：
- 进入 App 设置 → 安全
- 打开「生物识别锁定」开关
- 验证生物识别（首次开启需确认）
- 设置完成
建议
强烈建议开启生物识别锁定，防止他人打开 App 查看你的凭证和 OTP 信息。
锁定时机
可以配置 App 在何时自动锁定：
| 选项 | 说明 |
|---|---|
| 立即锁定 | 每次切出 App 都需要重新验证 |
| 1 分钟 | 切出 App 超过 1 分钟后需要验证 |
| 5 分钟 | 切出 App 超过 5 分钟后需要验证 |
通知
配置 App 的通知行为：
| 通知类型 | 说明 | 默认 |
|---|---|---|
| 连接状态 | 设备连接/断开时通知 | 开启 |
| 固件更新 | 发现新固件版本时通知 | 开启 |
| 安全警报 | PIN 输错过多等安全事件 | 开启 |
关于
查看 App 的信息：
| 信息 | 说明 |
|---|---|
| App 版本 | 当前 App 的版本号 |
| 构建号 | 内部构建编号 |
| 开源许可 | 查看使用的开源库及其许可证 |
| 隐私政策 | 查看隐私政策 |
| 服务条款 | 查看服务条款 |
设置同步
设备设置的持久化
通过 App 修改的设备设置直接写入 YuerKey 设备的 NVS（非易失性存储），即使设备断电也不会丢失。
App 偏好的持久化
App 偏好设置保存在手机本地：
- 卸载 App 后设置会丢失
- 重新安装 App 后需要重新配置偏好
- 不同设备上的 App 偏好独立，互不影响
常见问题
修改设备设置后没有生效？
- 确认设备已连接（App 显示「已连接」）
- 等待几秒，部分设置需要短暂时间同步
- 如问题持续，断开重连设备后重试
恢复出厂设置后怎么重新配对？
恢复出厂设置会清除设备上的所有配对信息。你需要在 App 中也取消配对该设备，然后按照 配对与连接 的步骤重新配对。
深色模式下某些内容看不清？
尝试切换到标准「深色模式」而非「AMOLED 纯黑」模式。AMOLED 纯黑模式在非 OLED 屏幕上可能导致对比度不足。