Twilight Echo

当前安装包由个人开发者发布，尚无商业代码签名证书，因此 Windows SmartScreen 可能显示“未知发布者”。请从本项目的 GitHub Releases 下载，并在发布页提供 .sha256 文件时核对安装包的校验值。

在安装包所在文件夹打开 PowerShell，运行下面的命令，将引号内的名称替换为实际文件名，然后与发布页的 SHA-256 比对：

Get-FileHash -LiteralPath '.\你下载的安装包文件名.exe' -Algorithm SHA256

macOS 与 Linux 可使用 shasum -a 256 <文件名> 或 sha256sum -c <文件名>.sha256 核对。

播放已有本地音乐无需登录音乐平台账号。在线推荐、网络音源、在线歌词获取、电台和播客等功能需要网络；部分在线内容还需要对应平台的登录或订阅权限。

这些页面默认不固定在侧栏。打开「全部页面」，或通过侧栏「编辑页面」显示「统计仪表盘」「电台 / 播客」「网络源」，也可以用 Ctrl + K 查找入口。侧栏支持调整页面顺序和隐藏不常用项。

先确认地址与根路径：地址可写 https://nas.local，也可写 nas.local 并单独填写端口。使用 HTTPS 时可写明 https://，或把端口填为 443。用户名/口令走标准 Basic 认证；如果服务器强制要求 Digest 认证，会提示「仅支持 Basic」，此时需要在服务器端启用 Basic 或使用其他挂载方式。

匿名源可直接串流播放；需要认证的来源会先下载到「网络源缓存」再播放，可在网络源页面查看缓存大小并清理。连接超时、认证失败、路径不存在等都会给出结构化提示。若服务器使用自签名证书，HTTPS 连接会被拒绝，请改用受信任证书，或在可信内网中改用 HTTP。

先确认文件夹中有受支持的音频文件，并等待扫描完成。在「设置 → 媒体库与存储」检查目录、自动扫描和扫描状态，必要时展开「扫描与诊断」执行完整重扫。标题栏「任务与通知」也能查看扫描进度。

下载目录在曲库之外时，可在下载完成项点击「加入曲库（复制）」；应用会保留原文件，并把副本加入已配置的音乐目录。也可以直接把下载目录添加到媒体库。

先检查播放器音量、静音状态和 Windows 音量混合器，再到「设置 → 播放与音效」确认输出设备；暂停播放后可用左右声道测试音检查输出。如果启用了 WASAPI 独占模式，设备可能被播放器独占；日常多应用同时播放时，使用共享模式更方便。

内置网易云音乐与第三方音源均依赖对应平台服务，可用内容受账号权限、所在地区和平台策略影响。扩展由各自作者维护，可先检查登录状态并更新扩展；仍有问题时，向对应扩展作者反馈。使用账号和内容时，请遵守对应服务条款。

在「设置 → 播放与音效 → 歌曲衔接 → Twilight AutoMix」选择自然或 DJ 模式，再开始播放队列。AutoMix 默认关闭，当前已开放试用；自然模式侧重保留歌曲内容，DJ 模式允许更长重叠、对拍和更明显的片头／片尾调整。不适合混音或过渡准备失败时会回退常规播放。

基础 AutoMix 不需要安装分轨包。需要人声、贝斯分轨辅助时，在 Releases 找到当前版本对应的 Assets（附件），下载分轨运行包，再在上述设置中点击「安装分轨包…」选择 ZIP 文件。按运行包能力选择自动、GPU 或 CPU；分轨会额外占用内存或显存，详见发布说明。

打开「设置 → 系统与关于 → 备份与恢复」，导出个人数据；在新电脑上选择备份并预览，勾选恢复类别、选择冲突处理方式，并把原音乐目录映射到新位置。确认后，在下次启动时执行恢复。

个人数据备份包含曲库索引、歌单收藏、队列、当前播放、歌词修改、播放书签、电台、播客、收听统计和版本关系。音频文件需要另行复制，账号登录、插件和封面缓存不随备份迁移。 设置与主题配置使用同一区域的「设置备份」单独导出、导入。

打开「设置 → 系统与关于」检查更新，可选择稳定或测试频道，并查看更新说明、下载进度与安装状态。Windows 使用完整安装包升级，下载支持中断恢复，并在安装前校验文件大小和 SHA-256；任务与通知中心也能查看更新进度。后台检查只提示新版本，下载和安装由你决定。

也可以从 Releases 手动下载安装包；当前版本的变化见 v1.3.1 发布说明。

• 共享与独占：WASAPI Shared（共享）经过 Windows 系统混音；Exclusive（独占）可在设备允许时进行格式直通。日常播放无需开启独占。
• DSD：Native DSD、DoP 与 SACD ISO 的实际播放模式取决于设备、驱动和发布包。WASAPI 与 CoreAudio 没有平台级 native DSD 通道，会使用 DoP 或 PCM 回退；Linux 仅在兼容的 ALSA hw: 设备上尝试 native DSD。DSD / 直通播放会绕过部分 DSP，这是预期行为。
• ASIO 与 VST3：Windows x64 的 ASIO 兼容层仍属实验性，真实设备支持尚未验证；VST3 的实际运行与设备兼容性同样尚未完成验证。请结合发布包能力清单与应用中的输出诊断判断。
• 重采样与转换：PCM SRC 支持 SWR；SoXR 随构建可选。SoX 档位是请求配置，实际是否使用 SoX、回退到 SWR，或本引擎没有进行重采样，请查看 DSP「输出与性能」或输出诊断中的 SRC 状态。旧引擎没有提供运行时证据时会显示「未验证」；设备或系统混音器仍可能另行转换。实验性 PCM→DSD64/128/256 由 CPU 执行，不代表完整高品质 SDM；当前不提供 CUDA SDM。
• 原样输出与混音：EQ、DSP 和 AutoMix 可能改变输出样本。需要 bit-perfect 时，应关闭会改变信号的处理，并以播放时的 HiFi 状态和原因说明为准；AutoMix 分轨可使用 GPU，不代表核心音频链路提供 CUDA 加速。

更详细的能力状态见发布能力说明，实际发布包以随附的 audio-capabilities.json 与 release-capability-status.json 为准。

CoreAudio 与 ALSA 后端已存在，但目前没有经过与 Windows 同等级别的发布和真实设备验证。现阶段建议普通用户使用 Windows 版本；macOS / Linux 构建供开发、测试和贡献使用。