OpenLogi设置和更新
在「设置」窗口中配置 OpenLogi 的应用偏好、权限、资源、网络访问与更新。
设置（Settings）窗口保存应用级偏好。窗口默认打开通用（General）。本页中可保存的偏好都位于 config.toml 的 [app_settings]；操作按钮不会写入设置。完整文件请参阅配置参考。
打开窗口
在应用菜单中选择设置…（Settings…）。macOS 的菜单栏后台代理也可从设置…打开窗口。侧栏包含通用、更新、支持的平台上的权限、外观、资源和关于。macOS 还包含诊断。
通用（General）
通用用于选择鼠标配置文件的应用、滚动行为、启动方式、屏幕提示和后台代理图标。
| 控件 | 作用 | 配置键 | 平台 |
|---|---|---|---|
| 鼠标按键配置文件（Mouse button profiles） | 选择鼠标指针（Mouse pointer）或焦点应用程序（Focused application）作为配置文件目标。键盘配置文件始终跟随焦点。 | mouse_profile_target | macOS、Windows、Linux；不支持指针目标时使用焦点。 |
| 平滑滚动（Smooth scrolling） | 用有限的平滑动画替换符合条件的物理鼠标滚轮输入。触控板和其他连续像素输入保持原生行为。 | smooth_scroll | macOS、Windows、Linux |
| 垂直滚动灵敏度（Vertical scroll sensitivity） | 设置传统垂直滚轮距离，范围为 1 至 100。默认值 14 为 1×。 | vertical_scroll_sensitivity | macOS、Windows、Linux |
| 拇指滚轮灵敏度（Thumb Wheel sensitivity） | 设置拇指滚轮的滚动速度和离散操作阈值，范围为 1 至 100。默认值 14 为 1×。 | thumbwheel_sensitivity | macOS、Windows、Linux |
| 开机自启（Launch at login） | 登录后启动后台代理。 | launch_at_login | macOS、Windows、Linux |
| 登录项已在「系统设置」中被关闭（Login item disabled in System Settings） | macOS 的系统设置关闭登录项时显示。打开登录项（Open Login Items）会打开重新启用的位置。 | 无配置键 | macOS |
| 显示在菜单栏（Show in menu bar） | 后台代理下次启动后显示或隐藏菜单栏状态项。 | show_in_menu_bar | macOS |
| 在通知区域显示（Show in the notification area） | 后台代理下次启动后显示或隐藏通知区域图标。 | show_in_menu_bar | Windows |
| 低电量提示（Low battery notifications） | 已连接设备低电量时，在屏幕底部显示提示。 | low_battery_notifications | macOS、Windows、Linux |
| 锁定键提示（Lock key notifications） | 显示锁定键状态。macOS 仅显示 Caps Lock。Windows 和 Linux 还可显示 Num Lock 与 Scroll Lock。 | lock_key_notifications | macOS、Windows、Linux |
配置中存在 capture_mouse_events，但当前通用页面没有对应控件。该值为 false 时，后台代理不会安装操作系统鼠标钩子。因此按键重映射会停止，DPI 和 SmartShift 等 HID++ 功能仍可使用。
外观（Appearance）
外观用于更改界面语言和呈现方式。模式、主题、圆角和缩放会应用到正在运行的应用。
| 控件 | 作用 | 配置键 | 平台 |
|---|---|---|---|
| 语言（Language） | 选择跟随系统（Follow system）或已内置的界面语言。 | language | macOS、Windows、Linux |
| 外观模式（Appearance mode） | 选择浅色、深色或跟随系统。 | appearance | macOS、Windows、Linux |
| 配色主题（Color theme） | 为浅色或深色槽位选择主题。跟随系统模式仍会跟随系统。 | theme_light 或 theme_dark | macOS、Windows、Linux |
| 应用图标（App icon） | 为程序坞、访达和启动台选择 OpenLogi 或 Prism 图标。 | app_icon | macOS |
| 圆角（Corner radius） | 选择锐利（0）、默认值（主题值）或圆润（Round，12）。 | ui_radius | macOS、Windows、Linux |
| 界面缩放（Interface scale） | 将文字与基于 rem 的界面间距缩放为 90%、100%、110% 或 125%。 | ui_scale | macOS、Windows、Linux |
语言选择器内置以下语言代码：be、cs、da、de、en、es、fr、it、nl、nb、pl、pt-PT、pt-BR、fi、sv、tr、el、ru、uk、ja、zh-CN、zh-HK、zh-TW 和 ko。
更新（Updates）
更新显示当前版本、更新状态和已识别的安装来源。默认关闭检查更新。首次运行的检查更新？对话框会把任一选择写入 update_prompt_seen。选择启用（Enable）还会立即检查一次。
| 控件 | 作用 | 配置键 | 平台 |
|---|---|---|---|
| 检查更新（Check for updates） | 开启后每次启动检查一次。它本身不会下载更新。 | check_for_updates | macOS、Windows、Linux |
| 自动下载并安装（Automatically download and install） | 检查发现更新后，在后台下载并暂存。OpenLogi 下次重启时应用更新。 | auto_install_updates | macOS、Windows、Linux |
| 检查更新（Check for Updates） | 不论自动检查设置如何，都运行用户请求的检查。该操作可变为下载并安装（Download & Install）或重启以更新（Restart to Update）。 | 无配置键 | macOS、Windows、Linux |
| 安装来源（Installation source） | 显示已检测到的 macOS 应用包、Windows MSI 或便携版 ZIP、Homebrew cask、Linux 安装包、Nix 存储或未识别来源。 | 无配置键 | macOS、Windows、Linux |
| 更新来源（Update source） | 通过查看更新日志（View changelog）打开 GitHub Releases。 | 无配置键 | macOS、Windows、Linux |
嵌入 Sparkle 的 macOS 发布应用包使用 Sparkle。Sparkle 检查 appcast，并在退出时安装更新。这是 v0.8.14 加入的 macOS 更新路径。Windows 使用内置更新器和 MSI 发布文件。Linux、未打包构建和无法使用 Sparkle 的 macOS 应用包也使用同一内置更新器。
更新器会识别 Homebrew、DEB、RPM、Arch、Nix 和 Windows 安装来源，以便显示。它不会根据识别结果选择包管理器更新器。对于 Homebrew 或 Linux 安装包，请使用安装来源的更新方式。发布版 Flatpak 是没有远程仓库的一次性安装包。因此 flatpak update 无法找到新版本；请安装较新的 .flatpak 安装包。
资源（Assets）
资源用于管理设备图片镜像和每用户图片缓存。默认开启自动下载设备图片。
| 控件 | 作用 | 配置键 | 平台 |
|---|---|---|---|
| 资源来源（Asset source） | 选择自动选择（推荐）（Automatic (recommended)）、OpenLogi、Cloudflare 或 Fastly。自动选择会并发访问内置镜像，并使用第一个健康的镜像。OPENLOGI_ASSETS 会覆盖此选择。 | asset_source | macOS、Windows、Linux |
| 自动下载设备图片（Automatically download device images） | 从所选来源下载已连接设备的图片。重新开启后会立即刷新。 | auto_download_assets | macOS、Windows、Linux |
| 刷新资源（Refresh assets） | 立即重新下载已连接设备的图片。 | 无配置键 | macOS、Windows、Linux |
| 清空缓存（Clear cache） | 删除每用户缓存，然后重新获取当前设备的图片。 | 无配置键 | macOS、Windows、Linux |
| 缓存位置（Cache location） | 在文件管理器中打开已下载图片所在的文件夹。 | 无配置键 | macOS、Windows、Linux |
缓存根目录为 OpenLogi 数据目录中的 assets。如果无法解析主目录，应用会改用 ./assets。
权限（Permissions）
权限仅显示在 macOS 和 Linux。Windows 不显示权限页面。
| 控件 | 作用 | 配置键 | 平台 |
|---|---|---|---|
| 辅助功能（Accessibility） | 为后台代理授予手势和按键重映射所需的访问权限。 | 无配置键 | macOS |
| 输入监控（Input Monitoring） | 允许读取 HID++ 数据，包括蓝牙直连鼠标。 | 无配置键 | macOS |
| 蓝牙（Bluetooth） | 允许使用 CoreBluetooth。HID 访问不需要此权限。 | 无配置键 | macOS |
| 摄像头（Camera） | 允许预览 Logitech 摄像头。仅在连接 Logitech 摄像头时显示此项。 | 无配置键 | macOS |
| 输入设备访问（Input device access） | 报告输入设备访问状态，并在访问被拒绝时说明所需的 udev 规则。 | 无配置键 | Linux |
诊断（Diagnostics）
诊断仅显示在 macOS。输入拦截（Input interception）会报告已知的鼠标事件流拦截应用。此类拦截可能导致指针卡顿或按键重复触发。
| 控件 | 作用 | 配置键 | 平台 |
|---|---|---|---|
| 输入拦截（Input interception） | 检查当前 macOS 事件监听器中已知的输入冲突。 | 无配置键 | macOS |
关于（About）
关于显示当前构建，并提供支持入口。
| 控件 | 作用 | 配置键 | 平台 |
|---|---|---|---|
| GitHub、更新日志（Changelog）、文档（Documentation）和报告问题（Report an issue） | 打开仓库、发布页面、文档或问题追踪器。 | 无配置键 | macOS、Windows、Linux |
| 复制诊断信息（Copy Diagnostics） | 把 Markdown 诊断报告复制到剪贴板。 | 无配置键 | macOS、Windows、Linux |
| 在文件管理器中显示（Show in file manager） | 打开包含 config.toml 的目录。 | 无配置键 | macOS、Windows、Linux |
网络访问（Network access）
OpenLogi 没有持续轮询的更新器。更新页面称检查更新是唯一可选的对外请求，但资源代码也会发起可配置的资源请求。以下内容说明当前发布版的准确行为。
| 网络请求 | OpenLogi 何时发起 | 默认状态 |
|---|---|---|
| 更新清单或 Sparkle appcast 检查 | 仅在开启检查更新，或你选择检查更新时，每次启动检查一次。 | 关闭 |
| 更新文件下载 | 选择下载并安装后，或已开启自动检查且发现更新并启用自动下载并安装后。 | 关闭 |
| 资源索引和设备图片下载 | 只有自动下载设备图片已开启且构建允许自动同步时自动发起。没有完整资源应用包的发布构建和调试构建允许同步。OPENLOGI_SYNC 可强制开启或关闭。 | auto_download_assets 默认开启 |
| 资源索引和设备图片下载 | 重新开启自动下载设备图片、在自动下载开启时改变资源来源、选择刷新资源或选择清空缓存时发起。手动刷新和清空会绕过自动下载与应用包限制。 | 用户操作 |
资源请求先获取资源索引。之后仅下载已连接设备中不存在或已过期的文件。选择资源镜像会固定该来源，除非 OPENLOGI_ASSETS 覆盖它。
菜单栏和通知区域
后台代理拥有这些菜单。即使关闭 GUI，后台代理也能继续运行。
| 位置 | 菜单项 |
|---|---|
| macOS 菜单栏 | 显示主窗口（Show Main Window）、设置…（Settings…）、关于 OpenLogi（About OpenLogi）、检查更新…（Check for Updates…）、退出 OpenLogi（Quit OpenLogi） |
| Windows 通知区域 | 显示主窗口（Show Main Window）、退出 OpenLogi（Quit OpenLogi） |
Windows 图标左键会执行显示主窗口。当前 Windows 菜单没有**设置…**或更新项。