# DouyinDataReview

> DouyinDataReview 是免费开源的抖音数据导出与年度报告桌面应用，支持 Windows x64 和 macOS Apple Silicon。它保存本人账号可访问的观看历史、喜欢、收藏和好友聊天记录，可选择导出为 JSON，并在本机生成抖音年度回顾（Douyin Wrapped）；还能在电脑上刷抖音推荐、查看本人创作者中心数据，并提供可选的 AI 助手。

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

## 项目与文档

- [下载与项目介绍](https://zhangyukwiver.github.io/DouyinDataReview/): 平台、功能、安装与常见问题。
- [数据导出与年度报告指南](https://zhangyukwiver.github.io/DouyinDataReview/guide.html): 导出步骤、官方档案导入、覆盖范围、数据流向与源码依据。
- [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 服务。
- 本地与联网：记录保存和报告统计在本机完成；在线采集需要联网及有效登录凭据；默认不调用 AI 服务，可选的 AI 助手装上后才会把对话发给你自己配的模型。

## 功能

- 抖音观看历史、喜欢、收藏与好友聊天记录采集及 JSON 导出，导出时语音消息转成文字
- 本应用备份与抖音官方 JSON / ZIP 个人档案导入
- 在电脑上刷抖音首页推荐（工作台默认页），可看评论、点赞收藏、下载当前视频
- 本地内容搜索、视频及图文下载、批量 ZIP 下载
- 实时聊天与用户主动触发的续火花消息
- 本人创作者中心数据总览、作品数据、粉丝画像与评论分析，评论管理里可发评论和回复
- 抖音网页推荐流过滤（Chrome / Edge 扩展），直播观看与弹幕（只看不发）
- 可选 AI 助手：用对话查本人记录、替你用应用功能，也能通过 MCP 给 Claude Code / Codex 使用
- 本地持续报告与抖音年度回顾，导出 HTML 和 PNG
- 桌面版一键把视频送去独立应用拆片工坊（ReelLab）做 AI 解析与剪辑

## 常见问题与边界

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

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

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

安装桌面版，在首屏用抖音 App 扫码，核对账号并勾选「读取视频」和／或「读取聊天」后确认导入。读取完成后，在「设置 → 数据」点「导出数据」，勾选需要的观看历史、喜欢、收藏或聊天，保存为 JSON。聊天默认不勾选，导出不会重新读取记录；勾选聊天时，语音消息会经抖音转成文字写进文件，这一步需要联网并登着原账号。聊天备份含已保存的好友消息及会话信息，不含群聊正文。

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

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

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

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

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

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

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

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

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

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

### 能在电脑上刷抖音推荐吗？

能。DouyinDataReview 进工作台默认打开「刷视频」，播放器嵌在页面里，接着本人账号的首页推荐往下刷，可以看评论、点赞收藏，或把当前视频下载到本机。直播和广告不放进来；刷到的视频会像在网页上一样记进抖音观看历史。点赞、收藏、评论要先在「设置 → 隐私」打开「允许在抖音上操作」。

### 有 AI 助手吗？能接 Claude Code 或 Codex 吗？

有，可选、默认不装，在「设置 → AI」安装。它能用对话查本人的观看记录、私信和创作者数据，或替你搜抖音、下载作品、整理文件夹、开始读取；模型用你自己填的 OpenAI 兼容接口，或本机的 Codex / Claude Code。应用开着时还在本机提供 MCP 接口，Claude Code、Codex 可以直接调用同一套功能。发私信、点赞、评论这类别人看得到的操作，每次都要你在应用里点「允许」。

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

应用免费、源码采用 MIT 许可。个人记录保存和报告统计在本机完成；在线采集只请求抖音，默认不调用 AI 服务；装了可选的 AI 助手，对话和它查到的数据才会发给你自己在设置里填的模型接口或本机 Codex / Claude Code。AI 视频解析与剪辑已拆成独立应用拆片工坊（ReelLab）：只有你在桌面版点「送去」按钮送到拆片工坊的那条视频（文件和标题、作者、链接、时长）会复制给它，之后的数据流由拆片工坊自己说明。抖音 Cookie 和整份个人记录不会交给它。

### 会被封号吗？

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

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

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