Bangumi 追番记录应用：从零到日常使用的完整指南
【免费下载链接】Bangumi:electron: An unofficial https://bgm.tv ui first app client for Android and iOS, built with React Native. 一个无广告、以爱好为驱动、不以盈利为目的、专门做 ACG 的类似豆瓣的追番记录，bgm.tv 第三方客户端。为移动端重新设计，内置大量加强的网页端难以实现的功能，且提供了相当的自定义选项。 目前已适配 iOS / Android。项目地址: https://gitcode.com/GitHub_Trending/ba/Bangumi
新番更新日，你想顺手把追番进度记上，可网页版在手机上打开又慢又挤；换一台设备，还得重新对一遍看到第几集。这种"记进度比看番还费劲"的体验，每个追番的人大概都经历过。
Bangumi 就是为此做的：一个基于 React Native 开发、专门做 ACG 的追番记录应用，是 bgm.tv 的第三方客户端，无广告、免费，iOS 和安卓都能用。
读完这篇文章，你能拿到三样东西：十分钟跑通客户端的完整流程、追番进度和社区动态的日常用法、几项能明显提升体验的进阶设置。
它到底是什么
一句话：把 bgm.tv 的追番记录、时间线、社区内容，完整搬到手机上，并为移动端重新设计了布局和交互。
| 核心能力 | 一句话说明 |
|---|---|
| 进度管理 | 番剧、音乐、游戏的观看进度一处记录 |
| 时间线 / 超展开 | 刷关注动态、看社区帖子，还能按规则屏蔽内容 |
| 移动端增强 | 照片墙、词云、年鉴等网页端难做的功能 |
| 跨平台 | 同一套账号，iOS / Android 数据一致 |
这是应用的主界面风格，几乎涵盖网站所有页面，但都是按手机屏幕重新排版的。
从零跑起来
准备工作：电脑装好 Node.js 和 yarn；iOS 开发需要 macOS 加 Xcode，安卓需要 Android Studio 加一台开了 USB 调试的真机。
第一步，拉取项目代码
先拿到代码，这是后面一切的地基：
git clone https://gitcode.com/GitHub_Trending/ba/Bangumi cd Bangumi预期结果：项目目录里能看到 android、ios、packages 等文件夹。
第二步，切换环境并安装依赖
项目对三个环境做了预置，所以先切环境、再装依赖，顺序不能反：
cd packages/android yarn install cd ../.. && yarn env android多一句提醒：国内首次拉包可能偏慢，且旧依赖版本较多，建议全程用 yarn 而不是 npm。
预期结果：根目录的 package.json 已切换成目标环境的配置。
第三步，启动应用
再启动开发服务，然后用手机连上它：
cd ios && pod install cd .. && yarn dev预期结果：终端出现 Expo / Metro 启动页，iOS 用 Expo App 扫码、安卓走 USB 调试，手机里就能看到应用跑起来了。
跟着场景用
场景一：新番更新日，十秒记进度
你遇到：更新日刚刷完一集，懒得打开网页。→ 打开应用首页，找到正在追的条目。→ 点进作品，改一下已看集数。→ 得到：进度同步到 bgm.tv 账号，另一台设备上刷新就能看到。
场景二：用规则清理社区内容（动手项）
你遇到：社区超展开里总有些不想看的内容。→ 打开设置里的"多规则超展开屏蔽"。→ 挑一条屏蔽规则打开，并按需调整它匹配的关键词或用户。→ 得到：信息流里这类内容被自动折叠，剩下的都是想看的。
场景三：翻年鉴和照片墙，回看这一年
你遇到：年底想看看今年都看了什么。→ 打开年鉴或照片墙页面。→ 不用操作，直接看你的条目被铺成照片墙，评分和补完时间都在。→ 得到：一张能直接发出去回顾今年的"战绩图"。
年鉴页会把这一年的追番记录汇成一张图，适合年底存档。
让它更好用
深浅色双主题应用同时支持浅色和深色主题，跟随系统切换。晚上追番不用再把亮度拧到最低。
CDN 中间层加速封面图和大量静态数据走自费 CDN 覆盖。网页版加载慢的时候，客户端照样秒开。
本地文件夹条目管理自己建库的人可以把本地文件夹挂到条目上，还支持罗马音刮削，整理番剧目录省事不少。
AI 推荐与猜你喜欢不知道看什么的时候，首页的推荐位会直接给你答案。
踩坑急救包
依赖安装极慢或中途报错现象：首次安装半天装不完，或反复失败。原因：老依赖多，国内网络拉包不稳定。解法：别挂镜像，先换回官方源再重装：
npm config set registry https://registry.npmjs.org安卓提示 spawnSync adb ENOENT现象：安卓端启动直接报 adb 相关错误。原因：手机 USB 调试没开或电脑未授权。解法：开发者选项里打开 USB 调试，插线后在手机上点"允许"，给应用装好所需权限再试。
打包突然 read timeout现象：昨天还能打包，今天失败，报错里有 read timeout。原因：gradle 依赖缓存只有 24 小时，过期后拉不到包。解法：先清理再重新打包：
cd android && ./gradlew clean适不适合你
如果你有 bgm.tv 账号，平时主要用手机刷动态、记进度，它会补上网页版给不了的移动端体验；如果你只是想看番，注意它是记录和管理工具，不提供播放功能，可能用不上。
收个尾
到这里，你已经知道它是什么、怎么跑起来、怎么把它调得顺手。打开终端，敲下第一行 clone 命令，今晚就能在手机上用上它。如果跑通后有什么好用法，欢迎留言分享，让更多人少踩坑。
【免费下载链接】Bangumi:electron: An unofficial https://bgm.tv ui first app client for Android and iOS, built with React Native. 一个无广告、以爱好为驱动、不以盈利为目的、专门做 ACG 的类似豆瓣的追番记录，bgm.tv 第三方客户端。为移动端重新设计，内置大量加强的网页端难以实现的功能，且提供了相当的自定义选项。 目前已适配 iOS / Android。项目地址: https://gitcode.com/GitHub_Trending/ba/Bangumi
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
