feat(help): rewrite Help page — trimmed Q/A, 10 sections, live search (#485)

* feat(help): rewrite English Q/A entries — trim, consolidate, refresh

The Help page had grown to ~50 entries over time, with several that
the UI itself answers (double-click to play, click the cover for
fullscreen, click the repeat button to cycle, …) and other groups
that were better folded into a single answer (rating + Skip-to-1★,
Internet Radio basics + supported formats, Device Sync overview +
filename template + cross-platform behaviour, …).

This pass:
- drops obviously-redundant entries (q4, q7, q8, q11, q22, q24, q25,
  and the trivial Settings → X pointers q12, q13, q15, q32, q42, q43)
- consolidates the natural groupings (q5+q31, q37+q38+q39, q53+q54+q55,
  q34+q35+q47, q26+q27+q28, q12+q41, q56+q57)
- adds entries for features that did not exist yet when the previous
  Q/A list was written: Orbit (Listen Together), Magic Strings
  sharing, LUFS Smart Loudness Normalization, Mini Player + Floating
  Player Bar, Smart Playlists, Track Preview, Search and Advanced
  Search, Statistics, Tracks library hub, Genre tag-cloud browser,
  Discord Rich Presence, Bandsintown tour dates, Multi-select +
  Shift-click range selection, Sidebar / Home / Artist Page
  customization, Sleep Timer, Open Source Licenses

Result: 45 focused entries across 10 sections (Getting Started /
Playback & Queue / Audio Tools / Library & Discovery / Lyrics /
Sharing & Social / Personalization / Power User / Offline & Sync /
Integrations & Troubleshooting), each one answering something the UI
does not already answer at a glance.

* feat(help): restructure into 10 sections with live search

Page is now organised into ten focused sections (Getting Started,
Playback & Queue, Audio Tools, Library & Discovery, Lyrics, Sharing
& Social, Personalization, Power User, Offline & Sync, Integrations
& Troubleshooting) each rendered as its own column-friendly accordion
group with a Lucide icon.

A search input lives in the page header. Typing filters every Q+A
pair across all sections by case-insensitive substring; sections that
end up empty are hidden, matched items are auto-expanded so the user
sees the answer without having to click each result, and a "no
results" empty state appears when the query matches nothing. Clearing
the input restores the manual accordion behaviour. An × button next
to the input clears the query in one click.

CSS uses dedicated `.help-search`, `.help-search-icon`,
`.help-search-input`, `.help-search-clear` rules instead of leaning
on the global `.input` class — the latter brought its own focus-ring
styles that doubled with the wrapper border. Focus state highlights
the wrapper border to `--accent` via `:focus-within`.

* i18n(help): translate the new Help page to 7 locales

Updates de, fr, nl, zh, nb, ru, es to match the new English Q/A
structure (45 entries across 10 sections, plus the live-search
labels: title, searchPlaceholder, noResults).

DE / FR / NL / NB / ES were translated directly. RU and ZH are
structurally correct but written at machine-translation quality;
both could use a pass from the original locale maintainers
(@cucadmuh for RU, @jiezhuo for ZH) — none of the wording is
load-bearing for the i18n keys, so the page renders correctly today
and refinements can land as follow-up touch-ups without coupling.

* docs: changelog + contributors for PR #485

Adds the v1.46.0 "Changed" entry and the Psychotoxical contributors
line for the Help page rewrite.
This commit is contained in:
Frank Stellmacher
2026-05-06 19:28:47 +02:00
committed by GitHub
parent 43d75e744b
commit e215694301
12 changed files with 1049 additions and 1081 deletions
+100 -120
View File
@@ -985,128 +985,108 @@ export const zhTranslation = {
},
help: {
title: '帮助',
searchPlaceholder: '搜索帮助…',
noResults: '没有匹配的主题。请尝试其他搜索词。',
s1: '入门指南',
q1: '支持哪些服务器?',
a1: 'Psysonic 可与任何 Subsonic 兼容服务器配合使用:Navidrome、Gonic、Subsonic、Airsonic 等。推荐使用 Navidrome。',
q2: '如何连接服务器?',
a2: '打开设置并点击"添加服务器"。输入服务器地址(如 192.168.1.100:4533)、用户名和密码。Psysonic 会在保存前测试连接 — 如果连接失败则不会存储任何信息。',
q3: '可以使用多个服务器吗',
a3: '可以。您可以在设置中添加任意数量的服务器,并随时切换。同一时间只能有一个服务器处于活动状态。',
s2: '播放',
q4: '如何播放音乐',
a4: '双击任意曲目即可播放。在专辑和艺术家页面,使用"全部播放"开始播放整张专辑。您也可以将曲目拖入队列面板。',
q5: '有哪些键盘快捷键',
a5: '空格键 = 播放 / 暂停 · Esc = 关闭全屏播放器。媒体键(播放/暂停、下一首、上一首)在所有平台上都有效。在 Linux 上,请使用播放器栏按钮作为媒体键。应用内快捷键和系统级全局快捷键可在 设置 → 键盘快捷键 / 全局快捷键 中自定义。',
q6: '什么是播放队列?',
a6: '队列显示所有即将播放的曲目。点击右上角标题栏的面板图标(正在播放指示器旁边)打开队列。您可以通过拖拽重新排序,使用随机播放按钮打乱顺序,并将队列保存为播放列表。',
q7: '如何打开全屏播放器',
a7: '点击底部播放器栏的专辑封面缩略图,或其旁边的展开图标。按 Esc 键关闭。',
q8: '重复播放如何工作',
a8: '点击播放器栏的重复按钮可在以下模式间循环:关闭 → 重复全部 → 重复单曲。',
s3: '音乐库',
q9: '如何下载专辑',
a9: '打开专辑详情页并点击"下载 (ZIP)"。服务器会先将专辑压缩为 ZIP 文件 — 对于大型专辑或无损文件(FLAC / WAV),在实际下载开始前可能需要一些时间。这是正常的:进度条会在服务器完成压缩并开始传输后显示。',
q10: '如何收藏曲目和专辑',
a10: '点击任意曲目行或专辑标题上的星形图标。收藏的项目会显示在侧边栏的收藏夹中。',
q11: '首页的英雄轮播是什么',
a11: '首页顶部的横幅会随机从您的音乐库中选择专辑,每 10 秒轮换一次。点击圆点可跳转到特定专辑,或点击横幅打开专辑。',
s4: '设置',
q12: '如何更改主题?',
a12: '设置 → 主题。从 8 个分组中的大量主题中选择:Psysonic 主题、媒体播放器、操作系统、游戏、电影、电视剧、社交媒体,以及开源经典(Catppuccin、Nord、Gruvbox、Nightfox)。',
q13: '如何更改语言?',
a13: '设置 → 语言。支持英语、德语、法语、荷兰语和中文。',
q15: '如何设置下载文件夹',
a15: '设置 → 应用行为 → 下载文件夹。选择任意文件夹 — 下载的专辑将以 ZIP 文件形式保存在那里。未设置自定义文件夹时,将使用浏览器的默认下载位置。',
s5: '歌曲记录',
q16: '歌曲记录如何工作?',
a16: 'Psysonic 直接向 Last.fm 发送记录 — 无需配置 Navidrome。在 设置 → Last.fm 中连接您的 Last.fm 账户并启用记录功能。',
q17: '何时发送记录?',
a17: '在您听完曲目的 50% 后提交记录。',
q22: '播放器栏中的波形是什么?',
a22: '波形进度条取代了传统的进度滑块。点击任意位置跳转到该位置,或拖动进行拖动播放。已播放部分显示蓝到紫的渐变,缓冲区域稍亮,未播放部分则淡化显示。',
q24: '可以随机打乱队列吗?',
a24: '可以。打开队列面板并点击队列标题栏的随机播放图标。当前播放曲目保持在第 1 位 — 其余曲目将随机重新排序。',
q25: '艺术家页面上的 Last.fm 和 Wikipedia 链接会在浏览器中打开吗?',
a25: '是的 — 它们会在您的默认系统浏览器中打开。点击时按钮会短暂显示确认标签。',
s7: '随机混音',
q26: '什么是随机混音?',
a26: '随机混音从您的整个音乐库中构建一个随机曲目的播放列表。通过侧边栏的"随机混音"打开并点击"新混音"。您可以在生成前调整曲目数量。',
q27: '什么是关键词过滤?',
a27: '关键词过滤会排除流派、标题或专辑名称包含特定词汇的曲目。有声读物会被自动过滤。在 设置 → 随机混音 中添加自定义关键词,或点击曲目列表中的任意流派标签即时添加。',
q28: '什么是超级流派混音',
a28: '超级流派混音将您的音乐库分组为宽泛的类别(摇滚、金属、电子、爵士、古典等),并从该风格构建一个专注的混音。在曲目列表下方选择类别标签。结果会随着每个子流派的获取而逐步显示。',
s6: '故障排除',
q18: '封面和艺术家图片加载缓慢。',
a18: '图片首次加载时从服务器磁盘获取,然后本地缓存 30 天。如果服务器存储较慢,首次访问页面可能需要一些时间。后续访问将瞬间完成。',
q19: '连接测试失败。',
a19: '检查 URL 包括端口(如 http://192.168.1.100:4533)。确保防火墙没有阻止连接。在本地网络上尝试使用 http:// 而非 https://。同时验证用户名和密码是否正确。',
q20: 'Linux 上没有音频。',
a20: 'Psysonic 提供 .debUbuntu/Debian)、.rpmFedora/RHEL)版本,以及通过 AUR 在 Arch/CachyOS 上安装(yay -S psysonic)。没有 AppImage。如果没有音频,请确保 PipeWire 或 PulseAudio 正在运行。',
q21: '应用在 Linux 上显示黑屏。',
a21: '这通常是 WebKitGTK 中的 GPU/EGL 驱动问题。使用 GDK_BACKEND=x11 WEBKIT_DISABLE_COMPOSITING_MODE=1 WEBKIT_DISABLE_DMABUF_RENDERER=1 启动。AUR 包和官方 .deb/.rpm 安装程序会自动设置这些环境变量。',
q29: '什么是交叉淡入淡出和无缝播放',
a29: '两者都是 设置 → 音频 中的实验性音频功能。无缝播放预缓冲下一首曲目以消除歌曲间的静音。交叉淡入淡出让当前曲目淡出同时下一首淡入 — 调整持续时间(1-10 秒)以符合您的喜好。',
q30: 'Psysonic 显示歌词吗',
a30: '是的。点击播放器栏的麦克风图标可在队列面板中打开歌词标签。Psysonic 自动从 LRCLIB 获取歌词。如果可用同步歌词,活动行会高亮并随歌曲实时滚动。如果只有纯文本歌词,则静态显示完整文本。',
q31: '可以自定义键盘快捷键吗',
a31: '可以。设置 → 键盘快捷键 允许您重新映射应用内操作(播放/暂停、下一首、上一首、音量增/减、全屏等)到任意按键。设置 → 全局快捷键 允许您分配即使 Psysonic 在后台也能触发的系统级快捷键。',
q32: '可以更改字体吗',
a32: '可以。设置 → 字体 允许您从 10 种字体中选择,包括 IBM Plex Mono、Fira Code、JetBrains Mono、Courier Prime 等。所选字体将应用于整个界面。',
s8: '离线模式',
q34: '什么是离线模式?',
a34: '离线模式(测试版)允许您将专辑缓存到设备,以便在没有活动服务器连接时收听。缓存的曲目存储在本地并直接从磁盘播放 — 播放期间不进行网络请求。',
q35: '如何缓存专辑以供离线使用',
a35: '打开任意专辑并点击专辑标题栏的下载图标。Psysonic 会在后台下载所有曲目。按钮上会显示进度。缓存完成后,图标变为绿色。您可以在离线音乐库页面(侧边栏)查看和移除缓存的专辑。',
q36: '离线缓存可以使用多少存储空间',
a36: '您可以在 设置 → 音乐库 中设置最大缓存大小。达到限制时,专辑页面会显示警告横幅。您可以从离线音乐库中删除单个专辑以释放空间。',
q37: '如何对歌曲、专辑和艺术家评分',
a37: 'Psysonic 通过 OpenSubsonic API 支持 15 星评分(需要 Navidrome ≥ 0.53)。可在专辑或播放列表曲目列表、右键菜单或播放器栏中对歌曲评分。专辑在详情页评分,艺术家在艺术家页评分。',
q38: '可以删除或更改评分吗',
a38: '可以。再次点击当前激活的星星即可完全删除评分——第二次点击同一颗星即可清除。点击其他星星可更改评分。',
q39: '什么是 Skip-to-1★ 和评分过滤器?',
a39: 'Skip-to-1★ 会在歌曲被连续手动跳过一定次数后自动赋予 1 星评分。在 设置 → 评分 中启用并设置阈值。同样可在此设置随机混音的最低星级过滤条件。',
q40: '什么是文件夹浏览器?',
a40: '文件夹浏览器(侧边栏)使用 Miller 列布局浏览服务器音乐目录。点击文件夹查看内容;点击播放图标直接播放或添加到队列。',
q41: '什么是主题调度器?',
a41: '设置 → 外观 → 自动切换主题:设置日间主题和夜间主题及开始时间,Psysonic 将在指定时间自动切换主题。',
q42: '可以调整界面缩放吗?',
a42: '可以。设置 → 外观 → 界面缩放 可将整个界面缩放至 80%–125%。',
q43: '可以更改进度条样式吗',
a43: '可以。设置 → 外观进度条样式 提供 10 种样式:波形、线条与点、条形、粗条形、分段、霓虹辉光、脉冲波、粒子轨迹、液体填充和复古磁带。',
q44: '什么是 AutoEQ',
a44: '设置 → 音频 中的 10 频段均衡器包含 AutoEQ 查找功能。输入耳机型号即可自动加载校正配置文件。',
q45: '什么是 Replay Gain',
a45: 'Replay Gain 标准化音量,使响亮和安静的专辑以一致的音量播放。在 设置 → 音频 → Replay Gain 中启用;选择曲目模式或专辑模式。',
q46: '什么是热缓存',
a46: '热缓存(Alpha,设置 → 音乐库)将队列中后续曲目预加载到磁盘,实现即时播放,对于慢速或远程服务器尤为有用。Psysonic 保留当前曲目和后续 5 首,达到大小限制时淘汰旧条目。',
q47: '可以将播放列表缓存到离线吗',
a47: '可以。在播放列表详情中点击下载图标,所有曲目将在后台下载。完全缓存后图标变为红色垃圾桶;再次点击即可从离线缓存中删除该播放列表。',
q48: '什么是无限队列?',
a48: '当队列播完且关闭了重复播放时,Psysonic会自动添加随机曲目,确保播放不会中断。自动添加的曲目显示在"— 自动添加 —"分隔符下方。',
q49: '可以通过命令行控制Psysonic吗',
a49: '可以。示例:psysonic --player play / pause / next / prev--player volume 75--player seek 15--player mute--player shuffle--player repeat off|all|one。还可以切换服务器、音频设备、筛选音乐库和搜索。完整帮助:psysonic --player --help。',
q50: '如何管理播放列表?',
a50: '通过侧边栏中的"播放列表"进入。点击"新建播放列表"创建。在详情页可拖拽排序、点击×删除曲目、通过搜索添加歌曲,还可使用"建议"获取智能推荐。',
q51: '可以备份和恢复设置吗?',
a51: '可以。设置→备份与恢复可将所有设置、服务器配置、主题和快捷键导出为JSON文件,在其他设备上导入即可一键恢复。',
q52: '如何更改音频输出设备?',
a52: '设置→音频→输出设备。Psysonic列出所有可用输出,选择后立即生效。若设备在应用启动后连接,可点击刷新按钮更新列表。',
q53: '什么是设备同步?',
a53: '设备同步可将专辑、播放列表或艺术家复制到USB或SD卡。通过侧边栏"Device Sync"打开,选择目标文件夹和来源,点击"传输到设备"。',
q54: '设备同步中的文件名模板是什么?',
a54: '模板控制曲目的命名和组织方式。使用预设或通过可点击的令牌自定义:{artist}、{album}、{title}、{track_number}、{disc_number}、{year},以及/作为文件夹分隔符。',
q55: '设备同步支持跨平台使用吗?',
a55: '支持。设备上的清单文件包含同步时使用的模板。在不同系统上,Psysonic能正确识别已存在的文件。',
s9: 'Device Sync',
q56: '什么是网络电台?',
a56: '网络电台页面可在Psysonic中播放任何直播流。电台来自Navidrome服务器,可通过管理面板添加或导入.pls/.m3u文件。播放使用HTML5音频。',
q57: '网络电台支持哪些流格式?',
a57: 'MP3、AAC、OGG Vorbis及大多数HLS流。MP3和AAC在所有平台均可使用。',
s10: '网络电台',
q58: 'Psysonic从哪里获取歌词?',
a58: '三个可配置来源(设置→歌词):Navidrome服务器、LRCLIB和网易云音乐。每个来源均可启用/禁用,并可拖拽调整优先级。',
q59: '有没有查看其他用户正在听什么的功能?',
a59: '有。点击右上角的广播图标,可查看Navidrome服务器上其他用户正在收听的内容,每10秒更新一次。',
a1: 'Psysonic 主要为 Navidrome 而构建,并完全兼容 Subsonic — Gonic、Airsonic、LMS 和其他 Subsonic-API 服务器也可使用。某些高级功能(评分、智能播放列表、Magic-String 共享、用户管理)需要 Navidrome。',
q2: '如何添加服务器?',
a2: '设置 → 服务器 → 添加服务器。输入 URL(例如 http://192.168.1.100:4533)、用户名和密码。Psysonic 会在保存前测试连接 — 失败则不保存任何内容。您可以添加任意数量的服务器并在标题栏中切换;同一时刻只有一个处于活动状态。',
q3: '快速 UI 介绍',
a3: '左侧栏用于导航,中间是 Mainstage / 各页面,底部是播放栏,右侧是队列面板(通过右上角紧邻 Now-Playing 指示器的图标打开)。顶部搜索栏搜索整个音乐库;"Now Playing"显示同一 Navidrome 服务器上其他用户正在听什么。',
s2: '播放与队列',
q4: '如何使用队列',
a4: '从右上角标题栏打开队列面板。拖动行重新排序,将其拖出以移除,或使用工具栏来打乱、将队列保存为播放列表或跳转到某曲目。可将行从面板拖出到其他位置作为转移。',
q5: 'Gapless 与 Crossfade — 区别',
a5: 'Gapless 预缓冲下一首曲目,使歌曲之间没有静音(适合现场专辑和 DJ 混音)。Crossfade 在 1–10 秒内将当前曲目淡出同时下一首淡入(适合混合播放)。两者互斥 — 启用其中一个会禁用另一个。在设置 → 音频中配置。',
q6: '什么是无限队列?',
a6: '队列结束且重复关闭时,Psysonic 会静默地从您的音乐库中追加相似/随机曲目,使播放永不停止。自动添加的曲目显示在"— 自动添加 —"分隔符下。通过队列标题栏中的无限符号图标切换;在设置 → 队列中将自动添加限制为某个流派。',
q7: '多选和 Shift+点击范围',
a7: '在专辑 / 新发行 / 随机专辑 / 播放列表上激活"选择"。点击一项以切换,然后按住 Shift 并点击另一项 — 可见顺序中两者之间的所有项都将被选中。Shift+点击从最近点击的锚点扩展。网格上方的工具栏提供批量操作(队列、下载、删除等)。',
q8: '键盘快捷键和全局热键',
a8: '默认应用内键:空格 = 播放 / 暂停,Esc = 关闭全屏 / 模态框,F1 = 快捷键速查表。设置 → 输入允许重新分配每个应用内动作(包括 Ctrl+Shift+P 等组合键)并设置即使 Psysonic 在后台或最小化时也能工作的系统级全局快捷键。多媒体键(播放/暂停、下一首、上一首)在所有平台上都可用。',
s3: '音频工具',
q9: 'Replay Gain 模式',
a9: '设置 → 音频 → Replay Gain。曲目模式将每首歌曲规范化到目标电平。专辑模式保留专辑内的响度曲线。自动模式根据队列是否来自单个专辑选择曲目或专辑。没有 Replay Gain 标签的曲目回退到可配置的前置放大。',
q10: '什么是 Smart Loudness Normalization (LUFS)',
a10: '设置 → 音频中 Replay Gain 的现代替代品。Psysonic 将每个曲目分析到 LUFS / EBU R128 并存储结果,以便整个音乐库的音量保持一致 — 包括没有 Replay Gain 标签的曲目。冷缓存分析在后台运行,CPU 使用约 35–40 % 持续约 1 分钟,然后降至 0。一次性设置目标响度(默认 −10 LUFS)。',
q11: 'EQ 和 AutoEQ',
a11: '设置 → 音频 → 均衡器中有一个 10 频段参数 EQ,带有手动频段和预设。旁边的 AutoEQ 从 AutoEQ 数据库为您的耳机型号拉取测量的校正配置文件并自动应用到频段 — 选择您的耳机,EQ 即对正确曲线。',
q12: '如何切换音频输出设备?',
a12: '设置 → 音频 → 输出设备。Psysonic 列出所有可用输出,选中后立即切换。刷新按钮重新扫描启动后接入的设备。Linux ALSA 名称如"sysdefault"会自动清理以提高可读性。',
q13: '什么是 Hot Cache',
a13: 'Hot Cache 将当前曲目和接下来的几首预加载到 RAM 和磁盘,使播放无缓冲延迟启动 — 在慢速 / 远程服务器上尤其有用。当达到大小限制时触发驱逐。在设置 → 音频中配置大小和防抖延迟(防止快速跳过时过度获取)。',
s4: '音乐库与发现',
q14: '评分和 Skip-to-1★ 如何工作',
a14: 'Psysonic 通过 OpenSubsonicNavidrome ≥ 0.53)支持 1–5 星评分。在曲目列表、右键菜单或播放栏中的艺术家名下方为曲目评分;在专辑页面为专辑评分;在艺术家页面为艺术家评分。Skip-to-1★(设置 → 音乐库 → 评分)在配置数量的连续跳过后自动分配 1 星。同一面板允许为生成的混音设置最低评分作为筛选条件。',
q15: '如何浏览 — 文件夹、流派、曲目?',
a15: '文件夹浏览器(侧边栏)以 Miller-column 布局浏览服务器的音乐目录树 — 点击文件夹进入,点击曲目或文件夹的播放图标以播放/添加。流派使用按曲目数量缩放的标签云视图;点击流派以打开。曲目是一个扁平的音乐库中心,带有可按列排序的虚拟列表和实时搜索。',
q16: '搜索和高级搜索?',
a16: '标题栏搜索栏在您输入时跨艺术家、专辑和曲目运行快速实时搜索。打开高级搜索(侧边栏)以获得更丰富的视图:按年份、流派、评分、格式、声道、采样率、BPM、心情过滤,并组合条件。右键单击任何结果会打开与其他地方相同的上下文菜单。',
q17: '什么是混音(Random / Genre / Super Genre / Lucky)?',
a17: 'Random Mix 从您的音乐库构建随机曲目播放列表;关键字过滤器通过流派/标题/专辑子字符串排除有声读物、喜剧等。Super Genre Mix 将您的音乐库按广泛风格分组(摇滚、金属、电子、爵士、古典…)并构建专注的混音。Lucky Mix 使用您的收听历史、评分和 AudioMuse-AI 相似曲目,一键组装即时播放列表。',
q18: '统计页面?',
a18: '统计(侧边栏)显示热门艺术家、热门专辑、热门曲目、流派分布、随时间变化的收听时间,以及在配置多个音乐文件夹时的每库范围。多个视图可作为可分享的卡片图像导出。',
q19: '如何将专辑下载为 ZIP',
a19: '专辑页面 → "下载(ZIP)"。服务器先压缩专辑 — 对于大型或无损专辑(FLAC / WAV),进度条仅在压缩完成且传输开始后才会出现。这是正常现象。',
s5: '歌词',
q20: '歌词来自哪里?',
a20: '设置 → 歌词中可配置三个来源:您的 Navidrome 服务器(嵌入式 / OpenSubsonic 歌词)、LRCLIB(社区贡献的同步歌词)和网易云音乐(庞大的亚洲 + 国际目录)。每个来源可启用/禁用并通过拖动重新排序。',
q21: '播放期间如何查看歌词?',
a21: '点击播放栏中的麦克风图标以打开队列面板内的歌词标签。同步歌词自动滚动并支持点击-跳转;纯文本歌词以静态块滚动。通过播放栏封面切换全屏播放器以获得带 mesh-blob 背景的沉浸式歌词视图。',
s6: '分享与社交',
q22: '什么是 Magic Strings',
a22: 'Magic Strings 是无需任何第三方服务器即可在 Psysonic 用户之间共享内容的简短复制粘贴令牌。Server-Invite 字符串让朋友通过一次粘贴加入您的 Navidrome;专辑 / 艺术家 / 队列 Magic Strings 在接收方打开相同的专辑 / 艺术家 / 队列。从分享菜单生成,粘贴到搜索栏以使用。',
q23: '什么是 Orbit',
a23: 'Orbit 是同步的一起听:主持人播放一首曲目,每个客人同步听到,客人可以建议曲目,主持人可以接受到队列中。从标题栏中的 Orbit 按钮启动会话,分享邀请链接,其他人可以从任何 Psysonic 安装加入。主持人拥有播放(跳过、搜索、队列) — 客人获得实时视图和建议框。会话是临时的,主持人关闭即结束。',
q24: '什么是 Now Playing 下拉?',
a24: '右上角标题栏的广播图标显示 Navidrome 服务器上其他用户当前正在听什么,每 10 秒刷新。您自己的条目在暂停时立即消失。按服务器划分,因此不会显示其他活动服务器上的用户。',
s7: '个性化',
q25: '主题和主题调度器?',
a25: '设置 → 外观 → 主题从 8 个组中的 60+ 个主题中选择(Psysonic、Mediaplayer、操作系统、游戏、电影、电视剧、社交媒体、Open Source Classics — Catppuccin / Nord / Gruvbox / Nightfox / Dracula)。Auto-Switch Theme 让您设置带启动时间的日间主题 + 夜间主题,使 Psysonic 自动切换。',
q26: '可以自定义侧边栏、首页和艺术家页面吗?',
a26: '可以 — 设置 → 个性化。侧边栏定制器让您拖动 nav 项目到所需顺序并隐藏您不使用的。首页定制器切换每个 Mainstage 行(Hero、Recent、Discover、Recently Played、Starred…)。艺术家页面定制器重新排序章节(Top Songs、专辑、单曲、合辑、相似艺术家等)并隐藏您从不查看的章节。',
q27: '什么是 Mini Player',
a27: '一个带有封面、传输控件和紧凑队列的小浮动窗口。从播放栏中的 mini-player 图标或其键盘快捷键打开。窗口在会话之间记住其位置和大小。在 Windows 上,mini-webview 在启动时预先创建,因此打开是即时的;Linux / macOS 通过设置 → 外观 → 预加载 mini player 选择加入。',
q28: '什么是 Floating Player Bar',
a28: '一个可选的播放栏样式(设置 → 外观),它从底部边缘脱离,带有主题背景、强调边框、圆角专辑封面和居中音量部分。在高显示器或紧凑主题上很有用。',
q29: '悬停时的曲目预览',
a29: '将鼠标悬停在曲目行上,点击封面上的小预览按钮,或从右键菜单触发预览 — Psysonic 通过相同的 Rust 音频引擎流式传输前 ~15 秒,因此响度规范化适用。对于您还没听过的专辑很有用。',
q30: '睡眠定时器',
a30: '点击播放栏中的月亮图标以打开睡眠定时器。选择持续时间(或"当前曲目结束"),Psysonic 会在结束时淡出并暂停。计时器运行时按钮显示圆形环和按钮内倒计时。',
q31: 'UI 缩放、字体、seekbar 样式?',
a31: '设置 → 外观 — 界面缩放(80–125%,不影响系统字体大小)、字体(10 种 UI 字体,包括 IBM Plex Mono、Fira Code、Geist、Golos Text…)、Seekbar 样式(波形分析 / pseudowave 确定性 / 线条与点 / 条形 / 厚条 / 分段 / 霓虹辉光 / 脉冲波 / 粒子轨迹 / 液体填充 / 复古磁带)。',
s8: '高级用户',
q32: 'CLI 播放器控制',
a32: 'Psysonic 二进制文件兼作运行中应用的远程控制。示例:psysonic --player play / pause / next / prev、--player volume 75、--player seek 15、--player shuffle、--player repeat off|all|one、--player rating 1-5。切换服务器、音频设备、音乐库;触发 Instant Mix;搜索艺术家 / 专辑 / 曲目。完整列表请运行 psysonic --player --help。bash 和 zsh 的 shell 自动补全可通过 psysonic completions 获得。',
q33: '智能播放列表(Navidrome',
a33: '智能播放列表是由规则定义的 Navidrome 端动态播放列表(流派 = 摇滚 AND 年份 > 2020 等)。Psysonic 中的播放列表页面允许使用可视化规则编辑器创建、编辑和删除它们 — Psysonic 通过 Navidrome 原生 API 进行操作。它们在应用其余部分中表现为普通播放列表,并在音乐库更改时自动更新。',
q34: '备份和恢复设置',
a34: '设置 → 存储 → 备份与恢复将服务器配置文件、主题、键绑定和其他设置导出到单个 JSON 文件。在另一台机器或重新安装后导入文件以一次恢复所有内容。服务器密码包含在内 — 请将文件保存在私密位置。',
q35: '在哪里查看所有开源许可证',
a35: '设置 → 系统 → Open Source Licenses。完整的依赖列表(cargo crates 和 npm 包)随构建附带捆绑的许可证文本。点击条目查看完整文本;顶部的精选高亮块突出显示用户可识别的库(Tauri、React、rodio、symphonia 等)。',
s9: '离线与同步',
q36: '离线模式 — 缓存专辑和播放列表?',
a36: '打开任何专辑或播放列表,点击标题中的下载图标 — Psysonic 在本地缓存每个曲目,使其无需网络调用即可从磁盘播放。离线音乐库页面(侧边栏)列出所有缓存内容,显示进行中的进度,并允许通过垃圾桶图标移除条目(在下载完成后出现)。',
q37: '离线存储限制?',
a37: '设置 → 音乐库 → 离线让您设置最大缓存大小。当达到限制时,专辑页面下载按钮显示警告横幅。通过从离线音乐库页面移除专辑或播放列表来释放空间。',
q38: 'Device Sync — 将音乐复制到 USB / SD?',
a38: 'Device Sync(侧边栏)将专辑、播放列表或整个艺术家复制到外部驱动器,以便在其他设备上离线收听。选择目标文件夹,从浏览器选项卡中选择源,点击"传输到设备"。Psysonic 写入清单(psysonic-sync.json),即使您在不同 OS 上以不同的文件名模板重新打开 Device Sync,也能知道哪些文件已经在那里。模板支持 {artist} / {album} / {title} / {track_number} / {disc_number} / {year} 令牌,使用 / 作为文件夹分隔符。',
s10: '集成与故障排除',
q39: 'Last.fm 抓取',
a39: '设置 → 集成Last.fm。一次连接您的账户,Psysonic 直接抓取到 Last.fm — 无需 Navidrome 配置。在听完曲目 50 % 后发送抓取。Now-playing pings 在开始时发送。',
q40: 'Discord Rich Presence',
a40: '设置 → 集成 → Discord 在您的 Discord 个人资料上显示当前曲目。在应用图标、您服务器的封面(通过 getAlbumInfo2 — 需要可公开访问的服务器)或 Apple Music 封面之间选择。使用令牌模板自定义显示字符串(详细信息、状态、提示)。',
q41: 'Bandsintown 巡演日期',
a41: '在设置 → 集成 → Now-Playing Info 中选择启用。然后 Now Playing 页面上的 Now Playing 选项卡通过 Bandsintown widget API 显示正在播放艺术家的即将到来的巡演日期。默认关闭 — 在您启用之前不发出任何请求。',
q42: 'Internet Radio — 播放实时流',
a42: 'Internet Radio(侧边栏)播放存储在您 Navidrome 服务器上的任何实时流(通过 Navidrome 管理 UI 添加电台)。播放通过浏览器 HTML5 音频引擎运行 — 大多数 EQ / Replay Gain / Loudness 设置不适用于电台,但 ICY 元数据(当前歌曲名)会显示。支持 MP3、AAC、OGG Vorbis 和大多数 HLS 流;编解码器支持取决于平台。',
q43: '连接测试失败 — 怎么办',
a43: '仔细检查 URL 包括端口(例如 http://192.168.1.100:4533)。在本地网络上 http:// 通常在 https:// 不工作的地方工作(无证书)。确保没有防火墙阻塞端口,并且用户名和密码正确。如果您的服务器位于反向代理之后,请先尝试直接 URL 以隔离原因。',
q44: '封面和艺术家图像加载缓慢。',
a44: '图像在首次查看时从服务器获取,然后本地缓存 30 天。如果您服务器的存储速度慢,第一次访问页面可能需要片刻;后续访问是即时的。Hot Cache 也对曲目有帮助,但图像缓存是独立的。',
q45: 'Linux 问题 — 黑屏或无声音',
a45: '黑屏通常是 WebKitGTK 中的 GPU / EGL 驱动程序问题 — 使用 GDK_BACKEND=x11 WEBKIT_DISABLE_COMPOSITING_MODE=1 WEBKIT_DISABLE_DMABUF_RENDERER=1 启动(AUR / .deb / .rpm 安装程序自动设置这些)。对于音频,确保 PipeWire 或 PulseAudio 正在运行。睡眠/唤醒后的音频丢失现在由 post-sleep 恢复钩子自动处理。',
},
queue: {
title: '队列',