Skip to content

Commit 7ddca78

Browse files
committed
docs: Update README.md
1 parent 96da5c5 commit 7ddca78

File tree

4 files changed

+14
-12
lines changed

4 files changed

+14
-12
lines changed

README.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -127,10 +127,10 @@ demo()
127127
<p>⭐ Mac OS、Windows 10 及以上用户可前往 <a href="https://github.com/JoeanAmier/TikTokDownloader/releases/latest">Releases</a> 或者 <a href="https://github.com/JoeanAmier/TikTokDownloader/actions">Actions</a> 下载已编译的程序,开箱即用!</p>
128128
<p>⭐ 本项目包含自动构建可执行文件的 GitHub Actions,使用者可以随时使用 GitHub Actions 将最新源码构建为可执行文件!</p>
129129
<p>⭐ 自动构建可执行文件教程请查阅本文档的 <code>构建可执行文件指南</code> 部分;如果需要更加详细的图文教程,请 <a href="https://mp.weixin.qq.com/s/TorfoZKkf4-x8IBNLImNuw">查阅文章</a>!</p>
130-
<p><strong>注意:Mac OS 平台可执行文件 <code>main</code> 可能需要从终端命令行启动;受设备限制,Mac OS 平台可执行文件尚未经过测试,无法保证可用性!</strong></p>
130+
<p><strong>注意:由于 Mac OS 平台的可执行文件 <code>main</code> 未经过代码签名,首次运行时会受到系统安全限制。请先在终端执行 <code>xattr -cr main.app</code> 命令移除安全标记,执行一次后即可正常运行。</strong></p>
131131
<hr>
132132
<ol>
133-
<li><b>运行可执行文件</b> 或者 <b>配置环境运行</b>
133+
<li><b>运行可执行文件</b> 或者 <b>配置环境运行</b>(二选一)
134134
<ol><b>运行可执行文件</b>
135135
<li>下载 <a href="https://github.com/JoeanAmier/TikTokDownloader/releases/latest">Releases</a> 或者 Actions 构建的可执行文件压缩包</li>
136136
<li>解压后打开程序文件夹,双击运行 <code>main</code></li>
@@ -148,7 +148,7 @@ demo()
148148
</li>
149149
<li>阅读 DouK-Downloader 的免责声明,根据提示输入内容</li>
150150
<li>将 Cookie 信息写入配置文件
151-
<ol><b>从剪贴板读取 Cookie</b>
151+
<ol><b>从剪贴板读取 Cookie(推荐)</b>
152152
<li>参考 <a href="https://github.com/JoeanAmier/TikTokDownloader/blob/master/docs/Cookie%E8%8E%B7%E5%8F%96%E6%95%99%E7%A8%8B.md">Cookie 提取教程</a>,复制所需 Cookie 至剪贴板</li>
153153
<li>选择 <code>从剪贴板读取 Cookie</code> 选项,程序会自动读取剪贴板的 Cookie 并写入配置文件</li>
154154
</ol>
@@ -211,7 +211,7 @@ demo()
211211
<li>程序下载文件时会先将文件下载至临时文件夹,下载完成后再移动至储存文件夹;程序运行结束时会清空临时文件夹</li>
212212
<li><code>批量下载收藏作品模式</code> 目前仅支持下载当前已登录 Cookie 对应账号的收藏作品,暂不支持多账号</li>
213213
<li>如果想要程序使用代理请求数据,必须在 <code>settings.json</code> 设置 <code>proxy</code> 参数,否则程序不会使用代理</li>
214-
<li>如果您的计算机没有合适的程序编辑 JSON 文件,建议使用 <a href="https://try8.cn/tool/format/json">JSON 在线工具</a> 编辑配置文件内容</li>
214+
<li>如果您的计算机没有合适的程序编辑 JSON 文件,建议使用 <a href="https://www.toolhelper.cn/JSON/JSONFormat">在线工具</a> 编辑配置文件内容,修改后需要重启软件才能生效。</li>
215215
<li>当程序请求用户输入内容或链接时,请注意避免输入的内容或链接包含换行符,这可能会导致预期之外的问题</li>
216216
<li>本项目不会支持付费作品下载,请勿反馈任何关于付费作品下载的问题</li>
217217
<li>Windows 系统需要以管理员身份运行程序才能读取 Chromium、Chrome、Edge 浏览器 Cookie</li>

README_EN.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -130,10 +130,10 @@ demo()
130130
<p>⭐ Mac OS and Windows 10 and above users can go to <a href="https://github.com/JoeanAmier/TikTokDownloader/releases/latest">Releases</a> or <a href="https://github.com/JoeanAmier/TikTokDownloader/actions">Actions</a> to download the compiled program, ready to use!</p>
131131
<p>⭐ This project includes GitHub Actions for automatic building executable files. Users can use GitHub Actions to build the latest source code into executable files at any time!</p>
132132
<p>⭐ For the automatic building executable files tutorial, please refer to the <code>Build of Executable File Guide</code> section of this document. If you need a more detailed step-by-step tutorial with illustrations, please <a href="https://mp.weixin.qq.com/s/TorfoZKkf4-x8IBNLImNuw">check out this article</a>!</p>
133-
<p><strong>Note: The executable file <code>main</code> on Mac OS may need to be started from the terminal command line. Due to device limitations, the executable file on the Mac OS platform has not been tested, and its usability cannot be guaranteed!</strong></p>
133+
<p><strong>Note: Due to the macOS platform's executable file <code>main</code> not being code-signed, it will be restricted by system security measures on first run. Please execute the command <code>xattr -cr main.app</code> in the terminal to remove the security flag, after which it can run normally.</strong></p>
134134
<hr>
135135
<ol>
136-
<li><b>Run the executable file</b> or <b>configure the environment to run</b>
136+
<li><b>Run the executable file</b> or <b>configure the environment to run</b>(choose one of the two)
137137
<ol><b>Run the executable file</b>
138138
<li>Download the executable file compressed file built by <a href="https://github.com/JoeanAmier/TikTokDownloader/releases/latest">Releases</a> or Actions.</li>
139139
<li>After extracting, open the program folder and double-click to run <code>main</code>.</li>
@@ -151,7 +151,7 @@ demo()
151151
</li>
152152
<li>Read the disclaimer of DouK-Downloader and enter content according to the prompt.</li>
153153
<li>Write Cookie Information into Configuration File
154-
<ol><b>Read Cookie from Clipboard</b>
154+
<ol><b>Read Cookie from Clipboard(Recommended)</b>
155155
<li>Refer to the <a href="https://github.com/JoeanAmier/TikTokDownloader/blob/master/docs/Cookie%E8%8E%B7%E5%8F%96%E6%95%99%E7%A8%8B.md">Cookie Extraction Tutorial</a>, copy the required Cookie to the clipboard</li>
156156
<li>Select the <code>Read Cookie from Clipboard</code> option, the program will automatically read the Cookie from the clipboard and write it into the configuration file</li>
157157
</ol>
@@ -215,7 +215,7 @@ demo()
215215
<li>When downloading files, the program first downloads them to a temporary folder and then moves them to the storage folder upon completion. The temporary folder will be emptied when the program ends.</li>
216216
<li>The <code>Batch Download Favorites Works Mode</code> currently only supports downloading Favorites works for the account corresponding to the currently logged-in Cookie and does not support multiple accounts.</li>
217217
<li>If you want the program to use a proxy to request data, you must set the <code>proxy</code> parameter in <code>settings.json</code>; otherwise, the program will not use a proxy.</li>
218-
<li>If your computer does not have a suitable program for editing JSON files, we recommend using the <a href="https://try8.cn/tool/format/json">JSON Online Tool</a> to edit the configuration file content.</li>
218+
<li>If your computer does not have a suitable program for editing JSON files, we recommend using the <a href="https://www.toolhelper.cn/JSON/JSONFormat">Online Tool</a> to edit the configuration file content, after modification, the software needs to be restarted to take effect.</li>
219219
<li>When the program prompts the user to input content or links, please be careful to avoid including newline characters, as this may cause unexpected issues.</li>
220220
<li>This project does not support downloading paid works. Please do not report any issues related to downloading paid works.</li>
221221
<li>On Windows systems, the program needs to be run as an administrator to read Cookies from Chromium, Chrome, and Edge browsers.</li>

docs/DouK-Downloader文档.md

Lines changed: 5 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -16,12 +16,13 @@
1616
</div>
1717
<br>
1818
<p>🔥 <b>TikTok 发布/喜欢/合辑/直播/视频/图集/音乐;抖音发布/喜欢/收藏/收藏夹/视频/图集/实况/直播/音乐/合集/评论/账号/搜索/热榜数据采集工具:</b>完全开源,基于 HTTPX 模块实现的免费数据采集和文件下载工具;批量下载抖音账号发布、喜欢、收藏、收藏夹作品;批量下载 TikTok 账号发布、喜欢作品;下载抖音链接或 TikTok 链接作品;获取抖音直播推流地址;下载抖音直播视频;获取 TikTok 直播推流地址;下载 TikTok 直播视频;采集抖音作品评论数据;批量下载抖音合集作品;批量下载 TikTok 合辑作品;采集抖音账号详细数据;采集抖音用户 / 作品 / 直播搜索结果;采集抖音热榜数据。</p>
19-
<p>⭐ <b>项目版本:<code>5.8 Beta</code>;文档更新日期:<code>2025/8/22</code></b></p>
19+
<p>⭐ <b>项目版本:<code>5.8 Beta</code>;文档更新日期:<code>2025/10/25</code></b></p>
2020
<p>⭐ <b>项目文档正在完善,如果发现任何错误或描述模糊之处,请告知作者以便改进!本项目历史名称:<code>TikTokDownloader</code></b></p>
2121
<hr>
2222
<h1>快速入门</h1>
2323
<p>⭐ 本项目包含手动构建可执行文件的 GitHub Actions,使用者可以随时使用 GitHub Actions 将最新源码构建为可执行文件!</p>
2424
<p>⭐ 自动构建可执行文件教程请查阅本文档的 <code>构建可执行文件指南</code> 部分;如果需要更加详细的图文教程,请 <a href="https://mp.weixin.qq.com/s/TorfoZKkf4-x8IBNLImNuw">查阅文章</a>!</p>
25+
<p><strong>注意:由于 Mac OS 平台的可执行文件 <code>main</code> 未经过代码签名,首次运行时会受到系统安全限制。请先在终端执行 <code>xattr -cr main.app</code> 命令移除安全标记,执行一次后即可正常运行。</strong></p>
2526
<ol>
2627
<li><b>运行可执行文件</b> 或者 <b>配置环境运行</b>
2728
<ol><b>运行可执行文件</b>
@@ -41,7 +42,7 @@
4142
</li>
4243
<li>阅读 DouK-Downloader 的免责声明,根据提示输入内容</li>
4344
<li>将 Cookie 信息写入配置文件
44-
<ol><b>从剪贴板读取 Cookie</b>
45+
<ol><b>从剪贴板读取 Cookie(推荐)</b>
4546
<li>参考 <a href="https://github.com/JoeanAmier/TikTokDownloader/blob/master/docs/Cookie%E8%8E%B7%E5%8F%96%E6%95%99%E7%A8%8B.md">Cookie 提取教程</a>,复制所需 Cookie 至剪贴板</li>
4647
<li>选择 <code>从剪贴板读取 Cookie</code> 选项,程序会自动读取剪贴板的 Cookie 并写入配置文件</li>
4748
</ol>
@@ -180,7 +181,7 @@ built with gcc 14.2.0 (crosstool-NG 1.27.0.18_7458341)
180181
<p>配置文件:项目根目录下的 <code>./Volume/settings.json</code> 文件,可以自定义设置程序部分运行参数。</p>
181182
<p>若无特殊需求,大部分配置参数无需修改,直接使用默认值即可。</p>
182183
<p><b><code>cookie</code>、<code>cookie_tiktok</code> 与 <code>device_id</code>参数为必需参数,必须设置该参数才能正常使用程序</b>;其余参数可以根据实际需求进行修改!</p>
183-
<p>如果您的计算机没有合适的程序编辑 JSON 文件,建议使用 <a href="https://try8.cn/tool/format/json">JSON 在线工具</a> 编辑配置文件内容。</p>
184+
<p>如果您的计算机没有合适的程序编辑 JSON 文件,建议使用 <a href="https://www.toolhelper.cn/JSON/JSONFormat">在线工具</a> 编辑配置文件内容,修改后需要重启软件才能生效。</p>
184185
<p>注意: 手动修改 <code>settings.json</code> 后需要重新运行程序才会生效!</p>
185186
<h2>参数说明</h2>
186187
<table>
@@ -758,6 +759,7 @@ built with gcc 14.2.0 (crosstool-NG 1.27.0.18_7458341)
758759
<p>自动读取本地浏览器的 Cookie 数据,并提取所需 Cookie 写入配置文件。</p>
759760
<p>成功写入配置文件后,程序会提示当前 Cookie 登录状态!</p>
760761
<p>Windows 系统需要以管理员身份运行程序才能读取 Chromium、Chrome、Edge 浏览器 Cookie!</p>
762+
<p><strong>兼容性提醒:此功能依赖的第三方模块已长期未更新,可能无法正常支持最新浏览器版本。若功能出现异常,请尝试手动获取 Cookie!</strong></p>
761763
<h2><del>扫码登录获取 Cookie</del></h2>
762764
<p><del>程序自动获取抖音登录二维码,随后会在终端输出二维码,并使用系统默认图片浏览器打开二维码图片,使用者通过抖音 APP 扫码并登录账号,操作后关闭二维码图片窗口,程序会自动检查登录结果并将登录后的 Cookie 写入配置文件。</del></p>
763765
<p><b>注意:</b>扫码登录可能会导致抖音账号被风控,该功能仅限学习研究,未来可能禁用或移除该功能!</p>

src/application/main_terminal.py

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -576,7 +576,7 @@ async def deal_account_detail(
576576
"favorite",
577577
"collection",
578578
}:
579-
return
579+
return None
580580
self.logger.info(
581581
_(
582582
"如果账号发布作品均为共创作品且该账号均不是作品作者时,请配置已登录的 Cookie 后重新运行程序,其余情况请无视该提示!"

0 commit comments

Comments
 (0)