fix: 修复 TikTok 平台批量下载合集作品功能

修复其他已知问题

Closes #599

Author: JoeanAmier

README.md

@@ -18,6 +18,7 @@
 <br>
 <p>🔥 <b>TikTok 发布/喜欢/合辑/直播/视频/图集/音乐；抖音发布/喜欢/收藏/收藏夹/视频/图集/实况/直播/音乐/合集/评论/账号/搜索/热榜数据采集工具：</b>完全开源，基于 HTTPX 模块实现的免费数据采集和文件下载工具；批量下载抖音账号发布、喜欢、收藏、收藏夹作品；批量下载 TikTok 账号发布、喜欢作品；下载抖音链接或 TikTok 链接作品；获取抖音直播推流地址；下载抖音直播视频；获取 TikTok 直播推流地址；下载 TikTok 直播视频；采集抖音作品评论数据；批量下载抖音合集作品；批量下载 TikTok 合辑作品；采集抖音账号详细数据；采集抖音用户 / 作品 / 直播搜索结果；采集抖音热榜数据。</p>
 <p>⭐ 本项目历史名称：<code>TikTokDownloader</code></p>
+<p>📣 本项目将于未来进行代码结构重构，目标是让代码更加稳健，并具备更好的可维护性与扩展性；如果你对项目设计、实现方式或优化思路有想法，欢迎提出建议或参与讨论！</p>
 <hr>
 
 # 📝 项目功能

README_EN.md

@@ -18,6 +18,7 @@
 <br>
 <p>🔥 <b>TikTok Posts/Liked/Mix/Live/Video/Image/Music; DouYin Posts/Liked/Favorites/Collections/Video/Image/LivePhoto/Live/Music/Mix/Comments/Account/Search/Hot Board Data Acquisition Tools:</b> Fully open-source, free data collection and file download tool based on HTTPX module implementation; batch download of DouYin account posts works, liked works, favorites works and collections works; batch download of TikTok account posts works and liked works; download of DouYin linked or TikTok linked works; obtain DouYin live stream addresses; download DouYin live stream video; obtain TikTok live stream addresses; download TikTok live stream video; collect DouYin works comments data; batch download of DouYin Mix works; batch download of TikTok Mix works; collect detailed data of DouYin accounts; collect DouYin user/works/live search results; collect DouYin Hot Board data.</p>
 <p>⭐ Previous project names: <code>TikTokDownloader</code></p>
+<p>📣 This project will undergo code structure refactoring in the future, with the goal of making the code more robust and providing better maintainability and extensibility. If you have any thoughts on project design, implementation methods, or optimization ideas, you are welcome to make suggestions or participate in discussions!</p>
 <p>⭐ Due to the author's limited energy, I was unable to update the English document in a timely manner, and the content may have become outdated, partial translation is machine translation, the translation result may be incorrect, Suggest referring to Chinese documentation. If you want to contribute to translation, we warmly welcome you.</p>
 <hr>
 

docs/DouK-Downloader文档.md

@@ -16,8 +16,9 @@
 </div>
 <br>
 <p>🔥 <b>TikTok 发布/喜欢/合辑/直播/视频/图集/音乐；抖音发布/喜欢/收藏/收藏夹/视频/图集/实况/直播/音乐/合集/评论/账号/搜索/热榜数据采集工具：</b>完全开源，基于 HTTPX 模块实现的免费数据采集和文件下载工具；批量下载抖音账号发布、喜欢、收藏、收藏夹作品；批量下载 TikTok 账号发布、喜欢作品；下载抖音链接或 TikTok 链接作品；获取抖音直播推流地址；下载抖音直播视频；获取 TikTok 直播推流地址；下载 TikTok 直播视频；采集抖音作品评论数据；批量下载抖音合集作品；批量下载 TikTok 合辑作品；采集抖音账号详细数据；采集抖音用户 / 作品 / 直播搜索结果；采集抖音热榜数据。</p>
-<p>⭐ <b>项目版本：<code>5.8 Beta</code>；文档更新日期：<code>2025/10/25</code></b></p>
+<p>⭐ <b>项目版本：<code>5.8 Beta</code>；文档更新日期：<code>2025/11/3</code></b></p>
 <p>⭐ <b>项目文档正在完善，如果发现任何错误或描述模糊之处，请告知作者以便改进！本项目历史名称：<code>TikTokDownloader</code></b></p>
+<p>⭐ Due to the author’s limited time and energy, the complete English documentation for this project is not yet available. If you wish to read the full documentation, we recommend using AI translation tools to assist your understanding. If you would like to contribute to the translation, your help is warmly welcomed.</p>
 <hr>
 <h1>快速入门</h1>
 <p>⭐ 本项目包含手动构建可执行文件的 GitHub Actions，使用者可以随时使用 GitHub Actions 将最新源码构建为可执行文件！</p>

docs/Release_Notes.md

@@ -4,5 +4,7 @@
 2. 修复部分 TikTok 账号提取 sec_user_id 失败的问题
 3. 修复 API 模式搜索接口多页数据报错的问题
 4. 修复 API 模式搜索接口结果为空报错的问题
-5. 服务器模式默认启用局域网访问
-6. 更新数据接口请求参数
+5. 修复 TikTok 平台批量下载合集作品功能
+6. 服务器模式默认启用局域网访问
+7. 更新数据接口请求参数
+8. 修复其他已知问题

src/application/main_terminal.py

@@ -1695,6 +1695,7 @@ async def deal_mix_detail(
                     mix_data,
                     mode="mix",
                     mix_id=mix_obj.mix_id,
+                    mix_title=mix_obj.mix_title,
                     mark=mark,
                     api=api,
                     tiktok=tiktok,

src/extract/extractor.py

@@ -896,24 +896,28 @@ def preprocessing_data(
                     )
                     return id_, name, mark
                 case "mix":
-                    item = self.__select_item(
-                        data,
-                        mix_id,
-                        (self.extract_params_tiktok if tiktok else self.extract_params)[
-                            "mix_id"
-                        ],
-                    )
-                    id_, name, mark = self.__extract_pretreatment_data(
-                        item,
-                        (self.extract_params_tiktok if tiktok else self.extract_params)[
-                            "mix_id"
-                        ],
-                        (self.extract_params_tiktok if tiktok else self.extract_params)[
-                            "mix_title"
-                        ],
-                        mark,
-                        mix_title,
-                    )
+                    if tiktok:
+                        id_ = mix_id
+                        name = self.cleaner.filter_name(
+                            mix_title,
+                        ).strip()
+                        mark = self.cleaner.filter_name(
+                            mark,
+                            name,
+                        ).strip()
+                    else:
+                        item = self.__select_item(
+                            data,
+                            mix_id,
+                            self.extract_params["mix_id"],
+                        )
+                        id_, name, mark = self.__extract_pretreatment_data(
+                            item,
+                            self.extract_params["mix_id"],
+                            self.extract_params["mix_title"],
+                            mark,
+                            mix_title,
+                        )
                     return id_, name, mark
                 case "collects":
                     collect_name = self.cleaner.filter_name(

src/interface/mix_tiktok.py

@@ -28,7 +28,7 @@ def __init__(
         # self.detail_id = detail_id  # 未使用
         self.cursor = cursor
         self.count = count
-        self.api = f"{self.domain}api/mix/item_list/"
+        self.api = f"{self.domain}api/collection/item_list/"
         self.text = _("合辑作品")
 
     def generate_params(
@@ -37,7 +37,8 @@ def generate_params(
         return self.params | {
             "count": self.count,
             "cursor": self.cursor,
-            "mixId": self.mix_id,
+            "collectionId": self.mix_id,
+            "sourceType": "113",
         }
 
     async def run(

src/link/extractor.py

@@ -171,7 +171,7 @@ class ExtractorTikTok(Extractor):
     account_link = compile(r"\S*?(https://www\.tiktok\.com/@[^\s/]+)\S*?")
 
     detail_link = compile(
-        r"\S*?https://www\.tiktok\.com/@[^\s/]+/(?!playlist)(?:(?:video|photo)/(\d{19}))?\S*?"
+        r"\S*?https://www\.tiktok\.com/@[^\s/]+/(?!playlist|collection)(?:(?:video|photo)/(\d{19}))?\S*?"
     )  # 作品链接
 
     mix_link = compile(