发布 5.1 版本

Author: JoeanAmier

README.md

@@ -82,7 +82,7 @@
 
 [![演示视频](docs/程序运行演示.png)](https://www.bilibili.com/video/BV1Nu4y1L7LW/)
 
-<p><b>点击图片观看演示视频，建议通过配置文件进行管理账号，更多介绍请查阅 <a href="https://github.com/JoeanAmier/TikTokDownloader/wiki/Documentation">文档</a></b></p>
+<p><b>🎥 点击图片观看演示视频，建议通过配置文件进行管理账号，更多介绍请查阅 <a href="https://github.com/JoeanAmier/TikTokDownloader/wiki/Documentation">文档</a></b></p>
 
 # 📈 项目状态\(Status\)
 
@@ -186,6 +186,8 @@ TikTokDownloader
 |  采集热榜数据  | ❌无需登录  |
 | 下载账号收藏作品 | ✔️需要登录 |
 
+**Cookie 仅需在失效后重新写入配置文件，并非每次运行程序都要写入配置文件！**
+
 **程序获取数据失败时，可以尝试更新 Cookie 或者使用已登录的 Cookie！**
 
 <hr>
@@ -194,8 +196,7 @@ TikTokDownloader
 
 <ul>
 <li>程序提示用户输入时，直接回车代表返回上级菜单，输入 <code>Q</code> 或 <code>q</code> 代表结束运行</li>
-<li>由于获取账号喜欢作品和收藏作品数据仅返回喜欢 / 收藏作品的发布日期，不返回操作日期，因此程序需要获取全部喜欢 / 收藏作品数据再进行日期筛选；如果作品数量较多，可能会花费较长的时间；可通过 <code>pages</code> 参数控制请求次数</li>
-<li>使用 <code>SQLite</code> 格式储存数据时，重复获取作品数据将会更新点赞收藏等统计数据</li>
+<li>由于获取账号喜欢作品和收藏作品数据仅返回喜欢 / 收藏作品的发布日期，不返回操作日期，因此程序需要获取全部喜欢 / 收藏作品数据再进行日期筛选；如果作品数量较多，可能会花费较长的时间；可通过 <code>max_pages</code> 参数控制请求次数</li>
 <li>获取私密账号的发布作品数据需要登录后的 Cookie，且登录的账号需要关注该私密账号</li>
 <li>批量下载账号作品或合集作品时，如果对应的昵称或标识发生变化，程序会自动更新已下载作品文件名称中的昵称和标识</li>
 <li>程序下载文件时会先将文件下载至临时文件夹，下载完成后再移动至储存文件夹；程序运行结束时会清空临时文件夹</li>
@@ -204,7 +205,7 @@ TikTokDownloader
 <li>如果想要程序使用代理，必须在 <code>settings.json</code> 设置 <code>proxies</code> 参数，否则程序不会使用代理</li>
 <li>部分使用者反馈，新发布的作品过早下载会下载到低分辨率的文件，一段时间后才能下载到高分辨率文件，但时间规律尚不明确</li>
 <li>退出程序时，请以正常方式结束运行或者按下 Ctrl + C 结束运行，不要直接点击终端窗口的关闭按钮结束运行，否则会导致数据丢失</li>
-<li>程序默认不启用请求延时，但是建议使用者编辑 <code>src/Customizer.py</code> 文件启用随机延时或固定延时，可以降低被抖音风控的概率</li>
+<li>程序默认不启用请求延时，但是建议使用者编辑 <code>src/Customizer.py</code> 文件启用随机延时或固定延时，避免频繁请求导致被抖音风控</li>
 </ul>
 <hr>
 

docs/TikTokDownloader文档.md

@@ -363,6 +363,38 @@
 
 <p><strong>服务器部署模式：</strong> 仅 <code>cookie</code>、<code>proxies</code>、<code>max_retry</code> 参数生效，其余参数均不生效，但仍需正确编辑配置文件。</p>
 <h2>参数详解</h2>
+<h3>下载喜欢作品</h3>
+
+```json
+{
+  "accounts_urls": [
+    {
+      "mark": "",
+      "url": "账号主页链接-1",
+      "tab": "favorite",
+      "earliest": "",
+      "latest": ""
+    },
+    {
+      "mark": "",
+      "url": "账号主页链接-2",
+      "tab": "post",
+      "earliest": "",
+      "latest": ""
+    },
+    {
+      "mark": "",
+      "url": "账号主页链接-3",
+      "tab": "favorite",
+      "earliest": "",
+      "latest": ""
+    }
+  ]
+}
+```
+
+<p>将待下载的账号信息写入配置文件，每个账号对应一个对象/字典，<code>tab</code> 参数设置为 <code>favorite</code> 代表批量下载喜欢作品，支持多账号。</p>
+
 <h3>文件储存路径</h3>
 
 ```json
@@ -643,10 +675,10 @@ document.body.removeChild(downloadLink);
 <p><strong>输入：</strong><code>猫咪 3 2</code> 等效于 <code>猫咪 直播搜索 2</code></p>
 <p><strong>含义：</strong> 关键词：<code>猫咪</code>；搜索类型：<code>直播搜索</code>；页数：<code>2</code></p>
 <h3>采集抖音热榜数据</h3>
-<p>采集 <code>抖音热榜</code>、<code>娱乐榜</code>、<code>社会榜</code>、<code>挑战榜</code> 数据并储存至文件；必须设置 <code>storage_format</code> 参数才能正常使用。</p>
+<p>无需输入，采集 <code>抖音热榜</code>、<code>娱乐榜</code>、<code>社会榜</code>、<code>挑战榜</code> 数据并储存至文件；必须设置 <code>storage_format</code> 参数才能正常使用。</p>
 <p>储存名称格式：<code>实时热榜数据_采集时间_热榜名称</code></p>
 <h3>批量下载收藏作品</h3>
-<p>需要在配置文件写入已登录的 Cookie，并在 <code>owner_url</code> 参数填入对应的账号主页链接和账号标识（可选）；目前仅支持采集当前 Cookie 对应账号的收藏作品。</p>
+<p>无需输入，需要在配置文件写入已登录的 Cookie，并在 <code>owner_url</code> 参数填入对应的账号主页链接和账号标识（可选）；目前仅支持采集当前 Cookie 对应账号的收藏作品。</p>
 <p>如果未设置 <code>owner_url</code> 参数，程序会使用临时字符串作为账号昵称和 UID。</p>
 <p>账号文件夹格式为 <code>UID123456789_mark_收藏作品</code> 或者 <code>UID123456789_账号昵称_收藏作品</code></p>
 <h2>Web API 接口模式</h2>

docs/WebAPI模式截图.png

@@ -72,7 +72,7 @@ class TikTokDownloader:
     # print(PROJECT_ROOT)  # 调试使用
 
     VERSION = 5.1
-    STABLE = False
+    STABLE = True
 
     REPOSITORY = "https://github.com/JoeanAmier/TikTokDownloader"
     LICENCE = "GNU General Public License v3.0"

docs/WebUI模式截图1.png

@@ -414,7 +414,7 @@ def get_settings_data(self) -> dict:
             "max_retry": self.max_retry,
             "max_pages": self.max_pages,
             "default_mode": int(self.default_mode),
-            "ffmpeg": self.ffmpeg.path,
+            "ffmpeg": self.ffmpeg.path or "",
         }
 
     def update_settings_data(self, data: dict, ):
@@ -451,6 +451,7 @@ def _check_system_type():
             return ['x-terminal-emulator'], False
 
     def __check_ffmpeg_path(self, path: Path):
+        # return None  # 调试使用
         return self.__check_system_ffmpeg() or self.__check_system_ffmpeg(path)
 
     def download(self, data: list[tuple], proxies, timeout, user_agent):