# TikTokHelper

[English](README.md)

提供反馈：[supportURL](https://github.com/zimabx/TikTokHelper/issues)

TikTokHelper 是一个用于 TikTok Web 的浏览器用户脚本。它会在 TikTok 页面中加入一个轻量操作面板，让你可以在当前页面直接保存媒体、截取视频帧、查看作品详情，并自定义下载文件名。

<img width="200" alt="image" src="https://raw.githubusercontent.com/zimabx/TikTokHelper/main/src/img/th_download_btn.png" />

## 功能

- 下载当前视频/图集
- 截取当前视频帧
- 查看当前作品媒体信息
- 主页批量下载
- 评论区翻译
- 评论区图片保存
- 选择视频源偏好
- 使用模板自定义下载文件名
- 配置快捷键

<p align="left">
  <img width="300" alt="image" src="https://raw.githubusercontent.com/zimabx/TikTokHelper/main/src/img/th_homepage_dlbtn.png" />
</p>

## 安装

打开 [TikTokHelper](https://greasyfork.org/zh-CN/scripts/586881-tiktokhelper) 文件，需要提前安装 tampermonkey 插件。

## 使用

安装后，TikTokHelper 会在当前 TikTok 媒体区域附近加入一个小型浮动按钮。展开后可以使用：

- **下载**：保存当前视频，或保存图文作品中的全部图片。
- **视频帧**：截取当前可见视频帧，并提供复制或保存。
- **详情**：打开分栏详情面板，查看媒体资源、作者数据、作品数据和原始 JSON。
- **设置**：修改语言、自动主题、视频清晰度偏好、文件名规则、视频源列和快捷键。
- **翻译**：启用输入框右侧的翻译按钮，对当前评论进行翻译。

默认下载快捷键是 `M`。其他快捷键默认关闭，可在设置中自行配置。

## 更新说明

<details>
  <summary>1.1.X</summary>

<h3>1.1.2 Upcoming</h3>
<ul>
<li>新增评论翻译启动方式设置，支持手动开启 / 自动开启</li>
<li>启动页设置改为下拉菜单，支持原版 / 黑色启动页</li>
<li>统一个人主页批量下载按钮与视频页下载图标。</li>
<li>新增评论贴纸下载功能，点击贴纸后可直接下载原始资源。</li>
<li>修复推荐页直播内容识别失效的问题。</li>
</ul>
<h3>1.1.1</h3>
<ul>
<li>调整全屏显示模式下的下载按钮位置，现在显示在“更多”按钮下方。</li>
<li>新增黑色启动页，将加载初期白色背景变成黑色。</li>
</ul>
<h3>1.1.0</h3>
<ul>
<li>新增视频帧 PNG / JPG / WEBP 多格式保存，并优化视频帧复制与保存流程。</li>
<li>新增个人主页批量下载失败项重试，仅重新下载失败的作品或图集图片。</li>
<li>新增批量下载取消后的“继续下载”，自动跳过已经完成的作品和图片。</li>
<li>下载任务支持真正中止当前网络传输，取消后不再继续备用源、后续图片或后续作品。</li>
<li>优化评论翻译，改进批量翻译与缓存机制，减少重复请求并提升大量评论的翻译效率。</li>
<li>优化翻译结果判断与缓存，对无需翻译、返回原文等情况进行更准确的识别和复用。</li>
<li>优化图集下载与重试逻辑，只处理失败或尚未完成的图片。</li>
<li>优化个人主页作品解析，优先复用页面已有数据，减少不必要的数据扫描。</li>
<li>修复视频帧可能错误截取相邻视频的问题。</li>
<li>修复 Live 视频帧文件名错误以及错误使用普通作品信息的问题。</li>
<li>修复详情页下载与主下载生成的文件扩展名不一致的问题。</li>
<li>修复部分图片文件扩展名 fallback 判断异常的问题。</li>
<li>修复快捷键重复配置产生冲突的问题，并新增快捷键冲突提示。</li>
<li>优化下载取消、失败、部分成功、重试和继续下载时的状态与进度反馈。</li>
<li>优化文件名生成、图集编号以及多处界面交互细节。</li>
<li>清理部分冗余代码与无效逻辑，降低不必要的运行开销并提升整体稳定性。</li>
</ul>
</details>

## 其他

非 TikTok 官方产品、仅用于有权保存的内容

## License

MIT