# DouyinDataReview

> DouyinDataReview 是免费开源的抖音数据导出与年度报告桌面应用，支持 Windows x64 和 macOS Apple Silicon。它保存本人账号可访问的观看历史、喜欢、收藏和好友聊天记录，可选择导出为 JSON，并在本机生成抖音年度回顾（Douyin Wrapped）。

项目文档核对日期：2026-10-24。具体版本与安装包以 Releases 为准。

## 项目与文档

- [下载与项目介绍](https://zhangyukwiver.github.io/DouyinDataReview/): 平台、功能、安装与常见问题。
- [数据导出与年度报告指南](https://zhangyukwiver.github.io/DouyinDataReview/guide.html): 导出步骤、官方档案导入、覆盖范围、AI 数据流与源码依据。
- [GitHub 仓库与 README](https://github.com/ZhangYukwiver/DouyinDataReview): 实现方式、功能边界和源码运行。
- [最新发布](https://github.com/ZhangYukwiver/DouyinDataReview/releases/latest): 已发布版本和安装包。
- [问题反馈](https://github.com/ZhangYukwiver/DouyinDataReview/issues): Bug 与功能建议。
- [MIT 许可](https://github.com/ZhangYukwiver/DouyinDataReview/blob/main/LICENSE): 源码使用许可。

## 项目事实

- 项目性质：独立开发的非官方开源工具，与抖音及字节跳动无隶属、授权或合作关系。
- 支持平台：Windows 10 / 11 x64；macOS Apple Silicon（M1 及更新）；界面语言为中文。
- 数据来源：本人账号可访问的抖音接口、本应用备份，或抖音官方个人信息下载档案；面向抖音（Douyin），不支持国际版 TikTok。
- 导出与报告：记录按勾选项导出 JSON，聊天默认不勾选；年度报告可导出独立 HTML 和 1080 × 1440 PNG。
- 费用与许可：应用免费，源码采用 MIT 许可；可选 AI 支持自配接口或本机已登录的 Codex / Claude Code，使用自己的订阅或服务商计费。
- 本地与联网：记录保存和报告统计在本机完成；在线采集需要联网及有效登录凭据；可选 AI 解析与剪辑会通过所配置接口或本机 CLI 向相应 AI 服务发送输入。

## 功能

- 抖音观看历史、喜欢、收藏与好友聊天记录采集及 JSON 导出
- 本应用备份与抖音官方 JSON / ZIP 个人档案导入
- 本地内容搜索、视频及图文下载、批量 ZIP 下载
- 实时聊天与用户主动触发的续火花消息
- 本人创作者中心数据总览、作品数据与粉丝画像（只读）
- 本地持续报告与抖音年度回顾，导出 HTML 和 PNG
- 可选 AI 视频工作台，解析与剪辑支持自配接口或本机 Codex / Claude Code，剪辑工程可导入剪映草稿箱

## 常见问题与边界

### DouyinDataReview 是什么？适合谁用？

DouyinDataReview 是免费开源的抖音数据导出与分析桌面应用，适合备份本人抖音观看历史、喜欢、收藏和好友聊天记录，整理内容库、查看创作者数据，以及制作个人年度回顾。它是独立开发的非官方工具，面向抖音（Douyin），不支持国际版 TikTok。

### 怎么导出抖音观看历史和聊天记录？

安装桌面版，在首屏用抖音 App 扫码，核对账号并勾选「读取视频」和／或「读取聊天」后确认导入。读取完成后，在「设置 → 数据」点「导出数据」，勾选需要的观看历史、喜欢、收藏或聊天，保存为 JSON。聊天默认不勾选，导出本身不会触发平台读取；聊天备份含已保存的好友消息及会话信息，不含群聊正文。

### 能导出全部抖音历史记录吗？

不能保证。DouyinDataReview 只能读取抖音接口当前返回且本人账号有权访问的记录，无法恢复接口已经不提供的数据。年度报告只反映已保存记录及其日期和字段；持续采集可以积累记录，也可导入抖音官方个人信息下载档案补充分析。

### 抖音官方「个人信息下载」的档案能直接用吗？

能。在采集器页「或者导入个人档案」处点「选择文件」，选择官方导出的 JSON 或 ZIP，可不登录抖音生成报告。可用统计取决于档案实际包含的字段和日期；该导入仅在本次打开期间使用，关闭应用后需重新导入。

### 需要安装浏览器扩展或一直开着浏览器吗？

不需要扩展。桌面版可在首屏扫码登录并导入凭据，无需另外配置浏览器。从源码运行时，可通过 Chrome 144+、带远程调试开关的 Edge 或 macOS Comet 导入本人登录凭据。导入成功后自动断开；凭据有效时可关闭浏览器继续采集，失效或需要验证时重新登录并导入。

### 有没有像 Spotify Wrapped 那样的抖音年度报告？

有。DouyinDataReview 用本机保存的观看、喜欢、收藏和聊天记录生成抖音年度回顾（Douyin Wrapped），提供内容年志、档案馆和海报三种风格，可导出独立 HTML 与 1080 × 1440 的 PNG 分享图。报告不需要 AI 接口，数据不全时也不会补造缺失记录。此页的示例报告使用合成数据，可免安装预览。

### 能批量下载抖音里喜欢和收藏的视频吗？

能。内容库点「批量下载」进入多选，选中的视频会打包成 ZIP 保存到本机；图文作品会下载全部图片。探索页的用户主页也支持下载作品。在线下载需要网络、有效会话，以及当前账号可访问的作品。

### 收费吗？数据会传到哪里？

应用免费、源码采用 MIT 许可。可选 AI 视频工作台支持自配接口或本机已登录的 Codex / Claude Code，使用自己的订阅或服务商计费。个人记录保存和报告统计在本机完成；在线采集会请求抖音。AI 解析向所选 AI 服务发送视频或本机提取的镜头截图等输入；AI 剪辑会发送对话、素材清单、时间线和工具检索到的记录摘要，解析参考视频时还可能发送视频或截图；生成图片和视频需在 AI 剪辑设置中开启（填 Key，方舟也可勾选借用已填的 Key，即梦、小云雀、LibTV 用本机命令行），之后画面说明和选作参考的素材图片会发给你配置的图片接口（默认 OpenAI）和你选的视频服务（火山方舟 Seedance、即梦、小云雀或 LibTV），按服务商计费，每次生成视频前会先问你。接口模式保存设置时会发送测试小视频；本机 CLI 仅使用文字、截图和节拍，仍会联网请求相应 AI 服务。抖音 Cookie 和整份个人记录不作为 AI 输入发送；完整数据流见使用指南。

### 会被封号吗？

没法保证不会。工具使用本人账号导入的会话，但采集依赖抖音未公开承诺的私有接口，接口变化可能导致功能失效或触发账号风控。请仅用于本人账号和个人数据管理；发送消息、点赞和评论等操作由用户主动触发。

### 支持哪些系统？能在手机或 Intel Mac 上安装吗？

已提供的桌面安装包支持 Windows 10 / 11 x64 和 macOS Apple Silicon（M1 及更新）。目前没有原生手机安装包、Intel Mac 安装包或 Linux 安装包。开发者可从源码运行 Web 工作台；手机在可信局域网连接电脑采集器的方式见仓库 README。