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 架构说明](frontend-react-migration.md)。返回按实际浏览器历史和保存的来源状态处理；不为每个页面生成 return 查询参数。播放器的 item、part 查询参数保存作品及播放部分，可刷新后重新校验授权并恢复页面。

协议实现以[React 页面路由](../web/src/app/router/routes.tsx)及[影音 feature](../web/src/features/media/)为准。冻结 v2 原型同步这些页面路径；其中作品 ID、查询参数和状态参数仍只用于设计演示。