OpenLogi

设置和更新

在「设置」窗口中配置 OpenLogi 的应用偏好、权限、资源、网络访问与更新。

设置(Settings)窗口保存应用级偏好。窗口默认打开通用(General)。本页中可保存的偏好都位于 config.toml 的 [app_settings];操作按钮不会写入设置。完整文件请参阅配置参考。

打开窗口

在应用菜单中选择设置…(Settings…)。macOS 的菜单栏后台代理也可从设置…打开窗口。侧栏包含通用、更新、支持的平台上的权限、外观、资源和关于。macOS 还包含诊断。

通用(General)

通用用于选择鼠标配置文件的应用、滚动行为、启动方式、屏幕提示和后台代理图标。

设置窗口的通用页面

设置的通用页面。
控件作用配置键平台
鼠标按键配置文件(Mouse button profiles)选择鼠标指针(Mouse pointer)或焦点应用程序(Focused application)作为配置文件目标。键盘配置文件始终跟随焦点。mouse_profile_targetmacOS、Windows、Linux;不支持指针目标时使用焦点。
平滑滚动(Smooth scrolling)用有限的平滑动画替换符合条件的物理鼠标滚轮输入。触控板和其他连续像素输入保持原生行为。smooth_scrollmacOS、Windows、Linux
垂直滚动灵敏度(Vertical scroll sensitivity)设置传统垂直滚轮距离,范围为 1 至 100。默认值 14 为 1×。vertical_scroll_sensitivitymacOS、Windows、Linux
拇指滚轮灵敏度(Thumb Wheel sensitivity)设置拇指滚轮的滚动速度和离散操作阈值,范围为 1 至 100。默认值 14 为 1×。thumbwheel_sensitivitymacOS、Windows、Linux
惯性滚动(Momentum scrolling)设置所有开启平滑滚轮的鼠标的默认惯性滑动,并显示有几只鼠标单独设置。鼠标的指针标签页可以覆盖它。见滚动。momentum_scrollingmacOS、Windows、Linux;只在 macOS 上测试过
开机自启(Launch at login)登录后启动后台代理。launch_at_loginmacOS、Windows、Linux
登录项已在「系统设置」中被关闭(Login item disabled in System Settings)macOS 的系统设置关闭登录项时显示。打开登录项(Open Login Items)会打开重新启用的位置。无配置键macOS
显示在菜单栏(Show in menu bar)后台代理下次启动后显示或隐藏菜单栏状态项。show_in_menu_barmacOS
在通知区域显示(Show in the notification area)后台代理下次启动后显示或隐藏通知区域图标。show_in_menu_barWindows
低电量提示(Low battery notifications)已连接设备低电量时,在屏幕底部显示提示。low_battery_notificationsmacOS、Windows、Linux
锁定键提示(Lock key notifications)显示锁定键状态。macOS 仅显示 Caps Lock。Windows 和 Linux 还可显示 Num Lock 与 Scroll Lock。lock_key_notificationsmacOS、Windows、Linux

配置中存在 capture_mouse_events,但当前通用页面没有对应控件。该值为 false 时,后台代理不会安装操作系统鼠标钩子。因此按键重映射会停止,DPI 和 SmartShift 等 HID++ 功能仍可使用。

外观(Appearance)

外观用于更改界面语言和呈现方式。模式、主题、圆角和缩放会应用到正在运行的应用。

控件作用配置键平台
语言(Language)选择跟随系统(Follow system)或已内置的界面语言。languagemacOS、Windows、Linux
外观模式(Appearance mode)选择浅色、深色或跟随系统。appearancemacOS、Windows、Linux
配色主题(Color theme)为浅色或深色槽位选择主题。跟随系统模式仍会跟随系统。theme_light 或 theme_darkmacOS、Windows、Linux
应用图标(App icon)为程序坞、访达和启动台选择 OpenLogi 或 Prism 图标。app_iconmacOS
圆角(Corner radius)选择锐利(0)、默认值(主题值)或圆润(Round,12)。ui_radiusmacOS、Windows、Linux
界面缩放(Interface scale)将文字与基于 rem 的界面间距缩放为 90%、100%、110% 或 125%。ui_scalemacOS、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_updatesmacOS、Windows、Linux
自动下载并安装(Automatically download and install)检查发现更新后,在后台下载并暂存。OpenLogi 下次重启时应用更新。auto_install_updatesmacOS、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_sourcemacOS、Windows、Linux
自动下载设备图片(Automatically download device images)从所选来源下载已连接设备的图片。重新开启后会立即刷新。auto_download_assetsmacOS、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 覆盖它。探测 jsDelivr 镜像时(自动选择或 Fastly),OpenLogi 还会向 data.jsdelivr.com 查询最新的资源版本,最多等待一秒。

菜单栏和通知区域

后台代理拥有这些菜单。即使关闭 GUI,后台代理也能继续运行。

位置菜单项
macOS 菜单栏显示主窗口(Show Main Window)、设置…(Settings…)、关于 OpenLogi(About OpenLogi)、检查更新…(Check for Updates…)、退出 OpenLogi(Quit OpenLogi)
Windows 通知区域显示主窗口(Show Main Window)、退出 OpenLogi(Quit OpenLogi)

Windows 图标左键会执行显示主窗口。当前 Windows 菜单没有**设置…**或更新项。

本页目录