reader/docs/media-navigation.md

影音导航与路由

顶部栏

手机首页点击频道标题或切换图标显示阅读、影视、音乐、有声书菜单；无底部频道 tab。点击外部、选择频道或 Escape 关闭菜单。桌面首页使用顶部频道链接，下方为频道内分类。

二级页显示返回、页面标题和当前页面的操作，不显示频道切换。设置、收藏、资源详情、播放器各自拥有路由。媒体库筛选位于列表工具栏左侧，版本、排序等选择器使用统一主题弹层。阅读界面和书架设置维持原有结构。

路由表

channel 表示 video、music 或 audiobook；itemId、part、libraryId 均为真实资源标识。

页面	Hash 地址
频道首页	#/media/video、#/media/music、#/media/audiobook
影视分类	#/media/video/movies、#/media/video/series
音乐分类	#/media/music/albums、#/media/music/artists、#/media/music/tracks
有声书分类	#/media/audiobook/books、#/media/audiobook/narrators
收藏	#/media/favorites，scope 和 offset 保存筛选、分页
搜索	#/media/search?q=…&scope=…
历史、待播队列	#/media/:channel/history；#/media/queue
设置	#/media/:channel/settings，以及 theme、browse、playback、plugins、account 子页
媒体库管理	#/media/:channel/settings/libraries
新建、编辑、权限	#/media/:channel/settings/libraries/new、#/media/:channel/settings/libraries/:libraryId/edit、#/media/:channel/settings/libraries/:libraryId/permissions
扫描与刮削	#/media/:channel/settings/tasks
作品详情	#/media/:channel/items/:itemId
资料、匹配、章节	#/media/:channel/items/:itemId/metadata、match、chapters
版本、结构管理	#/media/:channel/items/:itemId/editions/:editionId；#/media/:channel/items/:itemId/structure
播放	#/media/:channel/player?item=…&part=…
歌词、播放队列、播放章节	#/media/:channel/player/lyrics、#/media/:channel/player/queue、#/media/:channel/player/chapters
文件夹、文件	#/media/:channel/folders/:libraryId?path=…&offset=…；文件继续使用该路由并追加 asset=…
演播者、演播作品	#/media/audiobook/narrators/:narrator，以及 /media/audiobook/narrators/:narrator/works/:workId

路由表之外保留少量旧深链接兼容：/media、/media/music 和 /media/audiobook 会进入对应频道默认页；未知媒体路径回到 /media/video。书源与系统旧入口的兼容规则见React 架构说明。返回按实际浏览器历史和保存的来源状态处理；不为每个页面生成 return 查询参数。播放器的 item、part 查询参数保存作品及播放部分，可刷新后重新校验授权并恢复页面。

协议实现以React 页面路由及影音 feature为准。冻结 v2 原型同步这些页面路径；其中作品 ID、查询参数和状态参数仍只用于设计演示。