API 参考
偏好设置
应用配置。全量读取需要开启开发者模式;按 key 读取和写入遵循下方 Rust 注册白名单。
偏好设置键 (63)
访问权限遵循各配置项的注册策略;全量读取原始偏好值需要开启开发者模式。
| 键名 | 用途 | 访问权限 |
|---|---|---|
| dlna | 启用 DLNA 服务。 | 本地和远程均可读写 |
| device_name | 设备显示名称。 | 本地和远程均可读写 |
| feed_auto_refresh | 启用订阅源自动刷新。 | 本地和远程均可读写 |
| feed_auto_refresh_interval | 订阅源自动刷新间隔,单位为秒。 | 本地和远程均可读写 |
| feed_auto_refresh_only_wifi | 仅通过 Wi-Fi 自动刷新订阅源。 | 本地和远程均可读写 |
| ai_image_search_enabled | 启用图像语义搜索。 | 本地和远程均可读写 |
| ai_image_search_model | 选中的图像搜索模型。 | 本地和远程均可读写 |
| dlna_allowed_senders | 允许的 DLNA 发送方身份。 | 本地和远程均可读写 |
| dlna_denied_senders | 禁止的 DLNA 发送方身份。 | 本地和远程均可读写 |
| dark_theme | 主题选择:USE_DEVICE_THEME、ON 或 OFF。 | 本地和远程均可读写 |
| amoled_dark_theme | 启用 AMOLED 深色主题。 | 本地和远程均可读写 |
| pdf_follow_dark_theme | PDF 阅读跟随当前深色主题。 | 本地和远程均可读写 |
| locale | 界面语言。 | 本地和远程均可读写 |
| show_hidden_files | 在文件浏览中显示隐藏文件。 | 本地和远程均可读写 |
| feed_font_scale | 订阅阅读器字体缩放比例。 | 本地和远程均可读写 |
| editor_wrap_content | 编辑器长行自动换行。 | 本地和远程均可读写 |
| editor_font_size | 编辑器字号。 | 本地和远程均可读写 |
| editor_status_bar | 显示编辑器状态栏。 | 本地和远程均可读写 |
| desktop_home_features | 桌面端首页显示的功能。 | 本地和远程均可读写 |
| desktop_rail_features | 桌面导航栏中显示的功能。 | 本地和远程均可读写 |
| media_excluded_dirs | Directories hidden from media pages; file indexing and file search remain available. | 本地和远程均可读写 |
| desktop_upload_dirs | 按桌面媒体类别保存的上传目录路径。 | 本地和远程均可读写 |
| audio_sort_by | 音频库排序方式。 | 本地和远程均可读写 |
| video_sort_by | 视频库排序方式。 | 本地和远程均可读写 |
| image_sort_by | 图片库排序方式。 | 本地和远程均可读写 |
| doc_sort_by | 文档库排序方式。 | 本地和远程均可读写 |
| file_sort_by | 文件浏览排序方式。 | 本地和远程均可读写 |
| pkg_sort_by | 已安装应用排序方式。 | 本地和远程均可读写 |
| audio_play_mode | 音频循环或随机播放模式。 | 本地和远程均可读写 |
| audio_playback_speed | 音频播放倍速。 | 本地和远程均可读写 |
| pomodoro_settings | 番茄钟工作、休息和轮次配置。 | 本地和远程均可读写 |
| screen_mirror_quality | 屏幕镜像画质预设。 | 本地和远程均可读写 |
| clipboard_directions | 各对端设备的剪贴板同步方向。 | 仅本地可读写 |
| http_port | HTTP 监听端口。 | 仅本地可读写 |
| https_port | HTTPS 监听端口。 | 仅本地可读写 |
| background_service_enabled | 启用后台服务。 | 仅本地可读写 |
| remote_access | 启用远程访问。 | 仅本地可读写 |
| developer_mode | 启用开发者工具及完整的偏好设置或数据库访问。 | 仅本地可读写 |
| allow_any_host | 允许使用任意 HTTP 主机名的请求。 | 仅本地可读写 |
| nearby_discoverable | 允许附近设备发现本设备。 | 仅本地可读写 |
| notification_filter | 通知同步过滤配置。 | 仅本地可读写 |
| launcher_shortcuts | 配置的启动器快捷方式。 | 仅本地可读写 |
| image_grid_cells_per_row | 图片网格列数。 | 仅本地可读写 |
| video_grid_cells_per_row | 视频网格列数。 | 仅本地可读写 |
| https | 启用 HTTPS。 | 仅本地可读写 |
| web_address_bar_expanded | 展开远程访问地址栏。 | 仅本地可读写 |
| password | 本地密码配置。 | 仅本地可读写 |
| password_type | 选中的密码模式。 | 仅本地可读写 |
| login_require_approval | 远程登录需要本地确认。 | 仅本地可读写 |
| api_permissions | 授予远程 API 客户端的功能权限。 | 仅本地可读写 |
| dev_token | 开发访问令牌配置。 | 仅本地可读写 |
| log_level | 应用日志级别。 | 仅本地可读写 |
| auto_check_update | 自动检查应用更新。 | 仅本地可读写 |
| skip_version | 要跳过的应用更新版本。 | 仅本地可读写 |
| mdns_hostname | 用于本地发现的 mDNS 主机名。 | 本机或具备 HTTP_SERVER 能力的已登录远程端 |
| recent_selected_dirs | 本设备最近确认的绝对目录路径,最多 8 条,最新在前。Windows 使用正斜杠,盘根写 D:/,不写 D:。 ["D:/Projects/Photos", "E:/Backup/Photos"] | 本地或有文件权限的已登录远程客户端 |
| app_home_features | 原生工具页面及其远程视图显示的功能。 | 本地可读写,远程只读 |
| opaque_server_setup | 内部 OPAQUE 密码认证服务端配置。 | 仅限 Rust 内部使用 |
| opaque_password_record | 内部 OPAQUE 密码注册记录。 | 仅限 Rust 内部使用 |
| client_id | 内部持久化设备身份。 | 仅限 Rust 内部使用 |
| adb_token | 用于本地命令访问的内部授权令牌。 | 仅限 Rust 内部使用 |
| master_secret | 内部主密钥。 | 仅限 Rust 内部使用 |
| signature_key_pair | 内部设备签名密钥对。 | 仅限 Rust 内部使用 |
类型定义
graphql
type Subscription {
prefsChanged: Boolean!
}
type Mutation {
removePref(key: String!): Boolean!
setPref(key: String!, value: JSON!): Boolean!
}
type Query {
prefs(keys: [String!]): JSON!
}
scalar JSON操作
subscription
prefsChanged
接收偏好设置变更信号;收到后重新获取所需配置字段。
graphql
subscription prefsChanged {
prefsChanged
}mutation
removePref
移除允许修改的偏好值。auto_check_update 和 skip_version 会重置为默认值;读写范围见下方白名单。
graphql
mutation removePref($key: String!) {
removePref(key: $key)
}mutation
setPref
写入 Rust 注册且允许修改的偏好 key,校验值并应用对应配置效果;读写范围见下方白名单。
graphql
mutation setPref($key: String!, $value: JSON!) {
setPref(key: $key, value: $value)
}query
prefs
省略 keys 或传 null 时返回全部已存储的原始偏好(包括内部 key),需要开启开发者模式。指定 key 时按白名单读取;传空数组返回空对象。
graphql
query prefs($keys: [String!]) {
prefs(keys: $keys)
}