PlainApp
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_themePDF 阅读跟随当前深色主题。 本地和远程均可读写
locale界面语言。 本地和远程均可读写
show_hidden_files在文件浏览中显示隐藏文件。 本地和远程均可读写
feed_font_scale订阅阅读器字体缩放比例。 本地和远程均可读写
editor_wrap_content编辑器长行自动换行。 本地和远程均可读写
editor_font_size编辑器字号。 本地和远程均可读写
editor_status_bar显示编辑器状态栏。 本地和远程均可读写
desktop_home_features桌面端首页显示的功能。 本地和远程均可读写
desktop_rail_features桌面导航栏中显示的功能。 本地和远程均可读写
media_excluded_dirsDirectories 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_portHTTP 监听端口。 仅本地可读写
https_portHTTPS 监听端口。 仅本地可读写
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)
}