安装与下载

这一页说明 ECHO Next 应该从哪里下载、下载后怎么安装，以及为什么官网会同时保留站内下载和 GitHub Releases。

下载入口

推荐优先使用官网的 下载页面。这个页面会读取当前站点同步到的最新版本，并给出 Windows 安装包路径。

如果你想直接看发布源，可以打开 GitHub Releases：

GitHub Releases

GitHub Releases 是发布源，官网下载目录是镜像和自动更新入口。正常情况下，发布后服务器会把安装包同步到本站的 /update/stable/win/ 路径，下载页面和自动更新都会使用这份镜像。

Windows 用户怎么选

类型	适合谁	说明
安装包	日常长期使用	会按正常 Windows 应用方式安装，适合大多数用户
便携包	临时测试、隔离使用	放到独立目录运行，不适合所有自动更新场景
GitHub 原始附件	想核对发布源的人	可直接从 Releases 页面下载，但国内网络可能不稳定

大多数用户选安装包即可。下载后双击安装，按提示完成。首次启动时建议先导入一个小音乐文件夹测试，不要马上把整块硬盘都扫进去。

国内下载速度

中国大陆用户直接访问 GitHub 大文件附件时，速度可能不稳定，也可能出现连接中断。官网镜像的目的就是减少这种情况：用户访问下载页时优先拿本站已经同步好的安装包，而不是每次都直连 GitHub 附件。

如果官网下载也慢，可以按这个顺序尝试：

1. 先刷新 下载页面，确认是否已经同步到最新版本。
2. 换一个网络环境，例如手机热点或更稳定的宽带。
3. 再尝试 GitHub Releases 原始附件。
4. 如果两个入口版本号不一致，优先相信 GitHub Releases 是发布源，但请等待官网同步完成后再下载。

如何确认拿到的是最新版本

下载页面会显示当前同步到的版本号。GitHub Releases 页面会显示发布源里的最新 tag。

你可以这样判断：

检查项	应该看到
下载页面版本	与最新 Release tag 一致
安装包文件名	包含版本号，例如 ECHO-NEXT-Setup-26.6.4.exe
自动更新清单	/update/stable/win/latest.yml 指向同一版本
更新日志	更新日志 能看到同版本说明

如果官网版本落后，通常是同步任务还没跑完。等几分钟后刷新下载页即可。

第一次安装建议

1. 从 下载页面 或 GitHub Releases 获取安装包。
2. 安装前关闭旧版本 ECHO Next。
3. 安装到默认位置即可，除非你明确需要自定义路径。
4. 第一次启动后先导入一个小文件夹测试。
5. 确认能播放、能显示封面、能搜索歌曲。
6. 再导入完整曲库。
7. 如果播放没有声音，先回到默认输出，不要直接清数据库。

自动更新怎么工作

ECHO Next 客户端应读取本站的 /update/stable/win/latest.yml。这个文件由发布同步流程生成，格式兼容 electron-updater。

同步流程会做这些事：

1. 读取 https://github.com/Moekotori/ECHO/releases 的最新发布。
2. 找到 Windows 安装包。
3. 下载到 public/update/stable/win/。
4. 计算 electron-updater 需要的 sha512。
5. 生成 /update/stable/win/latest.yml。
6. 写入站点更新日志内容。

这意味着 GitHub 是源头，官网是更适合普通用户下载和自动更新的入口。

安装后遇到问题

现象	先做什么
Windows 提示未知发布者	确认来源是官网或 GitHub Releases，不要从第三方网盘下载
双击没反应	重新下载安装包，确认文件没有下载中断
启动后没声音	看 快速开始 和 音频输出
曲库为空	先导入一个小文件夹，不要直接扫全盘
自动更新失败	手动访问 下载页面 下载最新安装包

如果你要反馈安装问题，请带上版本号、下载入口、Windows 版本、安装包文件名和错误截图。