免登录管理 YouTube 视频库:NouTube 本地书签与历史记录功能详解
免登录管理 YouTube 视频库:NouTube 本地书签与历史记录功能详解
NouTube 是一款面向 Android、iOS 和桌面的开源 YouTube / YouTube Music 播放器,最大的亮点之一是:不登录账号也能拥有自己的"视频库"——本地书签(Bookmark)、历史记录(History)、文件夹整理,全部保存在设备本地,配合导入导出功能,还能把 YouTube 官方 Takeout 数据"搬"进来。本文带你快速上手这套免登录的视频库管理体系。
为什么"免登录"管理视频库很香?
在官方 App 里,书签和历史都绑定 Google 账号:
- 换设备要重新登录,隐私数据也集中在云端;
- 不登录就只能"裸看",收藏过的视频、看了一半的内容无处安放。
NouTube 的做法是 Local-First(本地优先):
| 功能 | 官方 App | NouTube |
|---|---|---|
| 收藏视频/频道/歌单 | 需登录 | ✅ 免登录,本地保存 |
| 浏览历史 | 需登录 | ✅ 免登录,自动记录 |
| 文件夹分类 | 无 | ✅ 自由创建 |
| 续播(上次看到哪) | 需登录 | ✅ 自动保存进度 |
数据存在手机上(MMKV 加密存储)或浏览器里(IndexedDB),见 states/bookmarks.ts 与 states/history.ts 中的持久化配置。
30 秒上手:星标收藏你的视频
在看视频、频道、播放列表(YouTube Music 里则是歌曲、艺术家)页面,点一下 星标(★) 就能收藏/取消收藏,逻辑在 lib/bookmarks.ts:
- 自动抓取页面标题作为书签名;
- 自动保存缩略图(视频封面、频道头像等);
- 收藏后进入本地视频库,随时点开。
💡 小技巧:收藏频道时,NouTube 还会尝试抓取频道 ID(channel_id),为后续的 Feed 订阅和 CSV 导出做准备。
视频库界面:像管理文件一样管理内容
点顶部工具栏的 📚 库按钮(入口在 components/header/NouHeader.tsx)即可打开 Library(视频库) 面板:
- 标签页分类:YouTube 侧分为"视频 / 频道 / 播放列表",YouTube Music 侧分为"歌曲 / 艺术家 / 播放列表"(见 components/modal/LibraryModal.tsx);
- 文件夹管理:点右上角的文件夹按钮新建文件夹,把书签归类整理,文件夹数据独立保存在 states/folders.ts;
- 单个书签操作:长按或点右侧菜单,可"编辑标题 / 移动到文件夹 / 分享 / 删除"(components/bookmark/BookmarkItem.tsx)。
删除书签是"软删除 + 可撤销":数据先标记为 deleted,底部会弹出撤销条,手滑了也能救回来(states/bookmarks.ts)。
历史记录:看过的东西,一键回到进度
历史面板由 components/modal/HistoryModal.tsx 实现,几个实用细节:
- 自动去重:反复看同一个视频不会产生多条记录,只有"最近更新"的那条会置顶;
- 上限 1000 条(states/history.ts),自动滚动淘汰最旧记录;
- 进度条可视化:每条记录显示已看比例的红条,一眼看出哪些"看了一半";
- 智能续播:点历史记录会回到 上次观看位置往前 5 秒;如果上次是看到最后 15 秒看完的,则从头播放(components/history/HistoryItem.tsx);
- 一键清除:顶部"清除"按钮清空当前列表,同样支持撤销。
📌 桌面端还有快捷键:Ctrl/Cmd + H 直接呼出历史面板(desktop/src/renderer/lib/shortcuts.ts)。
历史记录同样"免登录":它不依赖 Google 账号,YouTube 和 YouTube Music 的历史还自动分开显示,互不干扰。
进阶玩法:导入旧收藏、备份与迁移
这是 NouTube 最容易被低估的部分——它能把你账号里多年的积累"解放"出来。
1️⃣ 从 YouTube Takeout 批量导入
打开 components/modal/HistoryModal.tsx 关联的导入流程(importCsv),支持直接导入 YouTube 官方数据导出包里的 CSV:
- 订阅的频道 → 自动变成"频道"书签,并抓取频道头像;
- 播放列表 → 自动生成同名文件夹 + 视频书签;
- YouTube Music 歌曲 → 归入音乐库。
它按"数据形状"而非表头识别 CSV,所以非英文的本地化导出文件也能用(lib/import.ts)。也支持直接粘贴 URL 列表批量收藏(lib/import.ts)。
2️⃣ 导出为 CSV,随时备份
exportBookmarksCsv 会把当前视频库导出成标准 CSV,包含 url、title、folder、tab、thumbnail、channel_id 六列(lib/export.ts)。换机、迁移到桌面端,重新导入即可完整还原——连文件夹结构都不会丢。
3️⃣ 云端同步(可选)
如果你最终选择登录账号,书签会同步到 Supabase 云端表 nou_bookmarks(lib/supabase/sync/bookmarks.ts),实现手机 / 桌面 / 浏览器插件之间的多端一致。不登录则数据仅存本地,隐私完全自主。
这套功能适合谁?
- 无账号党 / 隐私敏感用户:不注册、不上传,本地即是你的视频库;
- 重度收藏者:文件夹 + Takeout 导入,把多年的订阅和播放列表整理进一个干净的库;
- 多端用户:本地存储保证各端可用,CSV 导入导出保证数据可带走,云端同步按需开启。
快速上手清单 ✅
- 安装 NouTube(Android / iOS / 桌面 / 浏览器插件),无需登录即可使用;
- 看到想收藏的视频/频道,点 ★ 星标;
- 打开顶部 📚 库面板,新建文件夹整理书签;
- 需要"找回旧收藏"时,用 YouTube Takeout 的 CSV 一键导入;
- 看一半的视频去历史面板,点击即可从断点续播。
小结:NouTube 用"本地书签 + 本地历史 + 文件夹 + CSV 导入导出"四件套,把视频库的管理权还给了用户本身——不登录,也能拥有完整、私密、可迁移的 YouTube 视频库。