安装与下载
官网安装包和 Steam 两条路、国内下载、自动更新。装完 → 快速开始。
先选一条路：
| 你从哪装 | 怎么做 |
|---|---|
| Steam | 打开 ECHO 商店页，加入库后点安装。装完从 Steam 启动。详见 Steam 版怎么用。 |
| 官网安装包 | 打开 下载页面，拿最新 Windows 安装包，双击安装。 |
装好以后，都按 快速开始 导入一个小文件夹，先听几首歌。
大多数人选官网安装包就行。便携包给临时测试用。GitHub 打不开就用官网镜像。已经在用 Steam，就别再下官网包去覆盖。
下面是官网安装包的下载入口、国内网络和更新细节。Steam 版的更新跟 Steam 走。
推荐优先用官网的 下载页面。这个页面会读取当前站点同步到的最新版本，并给出 Windows 安装包路径。
想直接看发布源，可以打开 GitHub Releases：
GitHub Releases 是发布源，官网下载目录是镜像和自动更新入口。正常情况下，发布后服务器会把安装包同步到本站的 /update/stable/win/ 路径，下载页面和自动更新都会用这份镜像。
Windows 用户怎么选
Section titled “Windows 用户怎么选”| 类型 | 推荐给 | 说明 |
|---|---|---|
| 安装包 | 日常长期用 | 正常 Windows 应用方式安装，大多数人选这个 |
| 便携包 | 临时测试 | 放独立目录运行，自动更新不一定跟得上 |
| GitHub 原始附件 | 想核对发布源 | 可从 Releases 下，国内网络可能不稳 |
大多数用户选安装包就行。下载后双击安装，按提示完成。首次启动建议先导入一个小音乐文件夹测试，别马上把整块硬盘都扫进去。
国内下载速度
Section titled “国内下载速度”中国大陆用户直接访问 GitHub 大文件附件时，速度可能不稳定，也可能连接中断。官网镜像的目的就是减少这种情况：用户访问下载页时优先拿本站已经同步好的安装包，而不是每次都直连 GitHub 附件。
如果官网下载也慢，可以按这个顺序试：
- 先刷新 下载页面，确认是否已经同步到最新版本。
- 换一个网络环境，例如手机热点或更稳定的宽带。
- 再试 GitHub Releases 原始附件。
- 如果两个入口版本号不一致，优先相信 GitHub Releases 是发布源，但请等官网同步完成后再下载。
如何确认拿到的是最新版本
Section titled “如何确认拿到的是最新版本”下载页面会显示当前同步到的版本号。GitHub Releases 页面会显示发布源里的最新 tag。
你可以这样判断：
| 检查项 | 应该看到 |
|---|---|
| 下载页面版本 | 与最新 Release tag 一致 |
| 安装包文件名 | 包含版本号，例如 ECHO-NEXT-Setup-26.6.4.exe |
| 自动更新清单 | /update/stable/win/latest.yml 指向同一版本 |
| 更新日志 | 更新日志 能看到同版本说明 |
第一次安装建议
Section titled “第一次安装建议”- 从 下载页面 或 GitHub Releases 获取安装包。
- 安装前关闭旧版本 ECHO Next。
- 安装到默认位置即可，除非你明确需要自定义路径。
- 第一次启动后先导入一个小文件夹测试。
- 确认能播放、能显示封面、能搜索歌曲。
- 再导入完整曲库。
- 如果播放没有声音，先回到默认输出，不要直接清数据库。
自动更新怎么工作
Section titled “自动更新怎么工作”ECHO Next 客户端应读取本站的 /update/stable/win/latest.yml。这个文件由发布同步流程生成，格式兼容 electron-updater。
同步流程会做这些事：
- 读取
https://github.com/Moekotori/ECHO/releases的最新发布。 - 找到 Windows 安装包。
- 下载到
public/update/stable/win/。 - 计算 electron-updater 需要的
sha512。 - 生成
/update/stable/win/latest.yml。 - 写入站点更新日志内容。
这意味着 GitHub 是源头，官网是更适合普通用户下载和自动更新的入口。
安装后遇到问题
Section titled “安装后遇到问题”| 现象 | 先做什么 |
|---|---|
| Windows 提示未知发布者 | 确认来源是官网或 GitHub Releases，不要从第三方网盘下载 |
| 双击没反应 | 重新下载安装包，确认文件没有下载中断 |
| 启动后没声音 | 看 快速开始 和 音频输出 |
| 曲库为空 | 先导入一个小文件夹，不要直接扫全盘 |
| 自动更新失败 | 手动访问 下载页面 下载最新安装包 |
| 想用 Steam 版 | 不要覆盖 Steam 目录。看 Steam 版怎么用 |
如果你要反馈安装问题，请带上版本号、下载入口、Windows 版本、安装包文件名和错误截图。