⚙️ 偏好面板
DualSubs 的偏好面板用于配置已安装的插件、字幕与歌词处理方式及第三方 API,无需安装 BoxJs。面板由整个 DualSubs 项目共用,使用 PreferencePanes 配置模板。
进入设置页面
- 安装并启用需要设置的平台插件:YouTube、Netflix 或 Spotify。各插件均提供自身配置和本机存储 API,可独立读写本平台设置;使用 Universal 及「合成器」「翻译器」「外部源」等共用面板时,再安装并启用 Universal。
- 在安装插件的设备上保持代理工具运行,确认模块/插件已启用、
dualsubs.github.io的 HTTPS 解密生效。 - 点击官网导航栏的「偏好面板」;手机上可先展开导航菜单。也可直接用浏览器打开 https://dualsubs.github.io/preferences/。
- 选择显示版本号的入口进入面板。修改选项或输入内容后自动保存,无需额外点击保存按钮;重新进入面板可核对已保存的值。
设置保存在当前代理工具的持久化存储中,与 BoxJs 共用原有设置。更换设备或代理工具后,设置不会自动同步。
入口显示「未安装」或无法打开时,请检查对应插件是否已更新并启用、浏览器流量是否经过该代理工具,以及 dualsubs.github.io 的 HTTPS 解密是否正常。仅打开网页不能代替安装插件。
配置来源与优先级
为避免模块/插件参数覆盖在线面板或 BoxJs 中保存的设置,默认采用「持久化存储优先」(Storage=PersistentStore)。没有保存的字段继续使用模块/插件参数,再回退到脚本默认值。
「[储存] 配置类型」位于代理工具的模块/插件参数中,不在在线面板或 BoxJs 中设置:
如需继续优先使用模块/插件中的配置,将「[储存] 配置类型」设为「插件配置优先」(Storage=Argument)。旧安装中已保存的配置类型不会随模块更新自动改变;使用在线面板前,请确认其为 PersistentStore。
选择对应面板
「合成器」「翻译器」「外部源」及 API 面板为共用设置,影响使用对应功能的各平台。字幕位置和翻译服务应在对应的共用面板调整;持久化配置优先时,共用面板已保存的同名设置会覆盖平台模块参数。
设置项与默认值
下表列出正式版在线面板的默认值;已有保存值会继续保留。模块/插件参数与开发版的差异在后文单独列出。
Universal
语言选项包括中文(自动/简体/香港/繁体)、英语、西班牙语、日语、韩语、德语、法语、土耳其语和高棉语;主语言另有「自动」。主语言和副语言表示字幕语言,显示在哪一行由「合成器」或「翻译器」的位置设置决定。
YouTube
首次使用时,请在播放器「字幕 → 自动翻译」中选择一次目标语言;以后自动显示会沿用该语言。源语言来自当前字幕轨道。在线 YouTube 面板不提供固定语言字段。
Netflix 与 Spotify
合成器
翻译器
外部源
翻译器 API
先在「翻译器 API」填写认证信息,再在「翻译器」选择对应服务。使用默认 Google Translate 无需填写这些认证信息。
模块/插件参数
在线面板按功能拆分设置,模块/插件参数仍保留常用快捷选项:
开发版面板差异
- Universal 增加「外挂字幕」(
External)选项,以及美式英语、西班牙语地区和[CC]字幕选项;默认启用类型仍为官方字幕、翻译字幕。 - YouTube 的歌词默认启用翻译歌词和外部歌词(
Translate、External)。 - 「翻译器」增加百度翻译、百度翻译开放平台、有道翻译、有道智云、Microsoft Bing、DeepL X;翻译结果缓存数量(
CacheSize)默认为10。 - 「外部源」增加外部字幕服务商(
SubVendor),默认网页地址(URL)。启用 Universal 的「外挂字幕」后,在「外部源 API」填写完整 HTTP(S) 字幕文件地址(URL,默认空),支持 WebVTT 和 SRT。 - 「翻译器 API」增加 DeepL X 的终结点(
DeepLX.Endpoint)和认证内容(DeepLX.Auth),默认均为空。 - 「外部源 API」增加网易云音乐手机号码(
NeteaseMusic.PhoneNumber)和密码(NeteaseMusic.Password),默认均为空。
使用 BoxJs 配置
BoxJs 仍可配置相同的持久化设置,安装与订阅方法见 BoxJs 指南。在线面板和 BoxJs 修改的是同一份数据,后保存的值生效;配置来源仍由模块/插件的 Storage 参数决定。