GoAnime 终极入门指南：终端里的动漫追番神器，搜索/播放/下载一站式搞定

GoAnime是一款用 Go 语言编写的终端动漫播放器与下载工具：在命令行里直接搜索、播放、下载动漫、电影与电视剧。它聚合 AllAnime、AnimeFire、FlixHQ 等多个数据源并发搜索、自动回退，支持在线选清晰度播放、批量离线下载、进度记忆续播、跳过片头，还能用 Anime4K 一键超分画质，同时支持英文与葡萄牙语（pt-BR）字幕内容。

✨ GoAnime 的 10 个核心功能

📦 前置依赖与一键安装步骤

GoAnime 唯一的前置依赖是媒体播放器mpv（建议最新版本）。

Linux / macOS

先安装 mpv：

# Debian / Ubuntu sudo apt install mpv -y # Fedora sudo dnf install mpv

macOS 用户可用brew install mpv。随后从项目 README.md 的 Installation 小节获取与你系统对应的预编译二进制（Linux amd64 / macOS），或直接用下面的通用方式：

通用方式（已安装 Go）

go install github.com/alvarorichard/Goanime/cmd/goanime@latest

Windows

推荐从 Releases 下载官方 Windows Installer 一键安装，并安装 mpv 后确保其位于系统 PATH。

安装完成后，验证一下：

goanime -h # 查看全部命令与选项 goanime --version # 查看当前版本

🚀 3 分钟上手：从搜索到播放

GoAnime 是交互式 TUI，操作路径非常短：

1. 终端输入goanime回车，进入搜索界面；
2. 输入想看的番名（如one piece），回车；
3. 用方向键在结果列表中选中目标番剧，回车；
4. 选择要观看的集数；
5. 选择清晰度，视频自动在 mpv 中启动播放。

也可以跳过交互提示，直接在命令行里搜索：

goanime "attack on titan"

💡 小技巧：搜索词直接用空格（one piece），不要用连字符。

⬇️ 离线下载命令速查表

配合-d下载模式，这些是最高频的命令：

goanime -d "one piece" 1 # 下载第 1 集 goanime -d -r "naruto" 1-5 # 下载第 1–5 集（区间） goanime -d -a "one piece" # 下载全部集数 goanime -dm -a "breaking bad" # 下载 TV/电影全部季与集（-dm 模式） goanime -d --quality 720p "demon slayer" 1 # 指定 720p 清晰度 goanime -d --source allanime "bleach" 10 # 指定数据源下载 goanime -d -o ~/Anime "naruto" 1 # 自定义输出目录

下载文件默认采用Plex 命名规范（如Anime - S01E01.mp4），方便媒体库直接识别。

🛠️ 进阶玩法

电影与电视剧：字幕 + 音轨任选

goanime --type movie "avengers" # 搜索电影 goanime --type tv "breaking bad" # 搜索 TV 剧集 goanime --type movie --subs spanish "spider-man" # 西语字幕 goanime --type movie --no-subs "matrix" # 关闭字幕 goanime --type movie --audio "pt-BR,english" "matrix" # 指定音轨语言

一键自动更新

goanime --update

交互式菜单里可选择立即更新、稍后再说，或先查看 Release Notes，详见 docs/AUTO_UPDATE.md。

AllAnime Smart Range：自动跳过片头片尾

goanime -d -r --source allanime --allanime-smart "vinland saga" 1-4

该模式会借助 AniSkip 自动裁剪片头/片尾，并使用优先镜像下载。

Anime4K 超分：老番画质翻新的秘密

goanime --upscale video.mp4 # 默认 2 倍超分 goanime --upscale --upscale-hq video.mp4 # 高质量模式（4 遍处理） goanime --upscale --upscale-scale 4 video.mp4 # 放大到 4 倍 goanime --upscale --upscale-gpu video.mp4 # GPU 编码输出

调试与性能

--debug输出详细错误与日志文件，--perf显示各阶段耗时指标，排查"搜索不到/播放失败"问题时非常好用。

🗂️ 源码结构与模块导航

GoAnime 的核心逻辑都放在internal/下，结构清晰，方便二次开发：

• cmd/goanime/main.go：程序入口，负责信号处理、参数解析与预预热
• internal/scraper/：各站点抓取器（AllAnime、AnimeFire、FlixHQ、SFlix 等）与源健康管理
• internal/player/：播放调度与清晰度选择
• internal/downloader/：动漫、电影与 HLS 下载
• internal/upscaler/：Anime4K 超分实现
• internal/tracking/：本地观看进度记录
• internal/tui/：终端交互与按键处理
• internal/api/：元数据抓取（TMDB/OMDB 等）

想进一步了解开发方式与构建选项（例如是否启用 SQLite 进度记录），可阅读 docs/Development.md、docs/BUILD_OPTIONS.md 和 docs/LIBRARY_USAGE.md。

GoAnime 同时提供库能力：pkg模块把搜索、列集、取流地址暴露为 API，几行 Go 代码即可在你的项目里复用，例如：

client := goanime.NewClient() results, err := client.SearchAnime("Naruto", nil)

❓ 常见问题

Windows 下提示找不到 mpv？安装 mpv 后确认其位于系统 PATH（where mpv有输出即可）。

搜不到我想看的番？尝试--source allanime或--source animefire指定数据源，或用--debug查看完整日志定位问题。

支持哪些语言？动漫内容支持英文与葡萄牙语字幕/配音；电影与 TV 剧集通过--subs/--audio自由选择字幕与音轨语言。

🎯 写在最后

三步完成第一次追番：装好 mpv → 安装 GoAnime →goanime后搜索、选集、播放。从在线流播到离线下载，再到 Anime4K 超分与进度记忆，GoAnime 把整个追番流程压缩进了一个终端命令。打开终端，今晚就看一集吧。