docs: 更新文档描述，简化视频合集/视频列表的配置

amtoaer · Jan 17, 2025 · 60604ae · 60604ae
1 parent 276fb5b
commit 60604ae
Show file tree

Hide file tree

Showing 4 changed files with 8 additions and 12 deletions.
diff --git a/docs/assets/collection.webp b/docs/assets/collection.webp
diff --git a/docs/assets/season.webp b/docs/assets/season.webp
diff --git a/docs/assets/series.webp b/docs/assets/series.webp
diff --git a/docs/collection.md b/docs/collection.md
@@ -1,23 +1,19 @@
 # 获取视频合集/视频列表信息
 
-要说明的是，视频合集和视频列表虽然在哔哩哔哩网站交互上行为类似，但在接口层级是两个不同的概念。可以简单将视频列表理解为一个老旧版本的视频合集。
+视频合集和视频列表虽然在哔哩哔哩网站交互上行为类似，但在接口层级是两个不同的概念，程序配置中需要对两者做出区分。
 
-在调试过程中我注意到视频列表的 ID 可以通过某种规则转换为视频合集的 ID，从而成功调用视频合集的接口，但由于不清楚具体的转换策略，在 bili-sync 的实现中还是将其当成两种类型处理。
+## 配置形式与区分方法
 
-## 区分方法
-
-这两种类型可以很容易地通过如下手段区分：
-1. 两者的名称前缀不同，视频合集会有显式的“合集”字样
-2. 两者的图标不同
+在 bili-sync 的设计中，视频合集的 key 为 `season:{mid}:{season_id}`，而视频列表的 key 为 `series:{mid}:{series_id}`。
 
-如下图所示，“合集【命运方舟全剧情解说】”是视频合集，而“阿拉德冒险记”是视频列表。
-![image](./assets/collection.webp)
+新版本 b 站网页端已经对两种类型做了初步整合，将需要的参数展示在了视频合集/视频列表的 URL 中，不再需要手动查看接口。URL 的路径格式为：
 
-在 bili-sync 的设计中，视频合集的 key 为 `season:{mid}:{season_id}`，而视频列表的 key 为 `series:{mid}:{series_id}`。
 
-## 参数获取
+```
+/{mid}/lists/{id}?type={season/series}
+```
 
-了解了区分方法后，我们可以通过如下步骤获取视频合集/视频列表的信息。
+点开你想要订阅的视频合集/视频列表详情，查看 URL 即可拼接出对应的 key。
 
 ### 视频合集