llms.txt@docs git:20261105.d14bf61A

Immutable. This exact content never changes and is served at /api/v1/blob/cea22cb9d5396926.

# DouyinDataReview

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

项目文档核对日期：2026-11-05。具体版本与安装包以 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 导出，导出时语音消息转成文字；每类不限条数，全部记录合计能存约 38 万条
- 本应用备份与抖音官方 JSON / ZIP 个人档案导入
- 在电脑上刷抖音首页推荐（工作台默认页），可看评论、点赞收藏、下载当前视频
- 本地内容搜索、视频及图文下载、批量 ZIP 下载，默认存到系统「下载」文件夹的「抖音视频」，可在设置里改
- 实时聊天与用户主动触发的续火花消息
- 本人创作者中心数据总览、作品数据、粉丝画像与评论分析，作品数据和粉丝画像能导出 CSV 表格，评论管理里可发评论和回复
- 按关键词、作者、话题、音乐屏蔽抖音推荐里的视频，软件里刷视频和 Chrome / Edge 网页都生效（网页要装一次扩展）
- 把想看的词条混进推荐，插入频率可调，也可以只看词条
- 内容库「我的评论」：看自己发过的评论和评论下收到的回复
- 使用记录：记下这台电脑每次打开软件和抖音网页的开始、结束时间与时长
- 直播观看与弹幕（只看不发）
- 可选 AI 助手：用对话查本人记录、替你用应用功能，也能通过 MCP 给 Claude Code / Codex 使用
- 本地持续报告与抖音年度回顾，导出 HTML 和 PNG
- 桌面版一键把视频送去独立应用拆片工坊（ReelLab）做 AI 解析与剪辑

## 常见问题与边界

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

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

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

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

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

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

### 抖音收藏有几万条，能全部备份吗？

DouyinDataReview 不限制观看历史、喜欢、收藏每类的条数，全部记录合计能存约 38 万条，快存满时会提示，已经存好的记录不受影响；记录变多后，每页的读取速度也不会跟着变慢。能读到多少取决于抖音接口当前返回的内容，不保证取全。中途某一类读取出错时，已读到的部分会先留下。

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

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

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

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

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

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

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

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

### 下载的抖音视频存在哪里？能改位置吗？

DouyinDataReview 桌面版把下载的视频、图文和批量 ZIP 默认存到系统「下载」文件夹里的「抖音视频」，不用每次选位置。要换地方，到「设置 → 数据」的「视频下载位置」点「更改」，点「打开」能直接打开这个文件夹。

### 怎么查看自己在抖音发过的评论和收到的回复？

DouyinDataReview 读取记录时会顺带整理抖音的评论通知，内容库的「我的评论」列出你发过的评论和评论下收到的回复，在应用里发的评论也会记进去。它不是完整的评论历史：抖音的通知只留最近 100 条，只有收到过回复的评论才读得到；每次读取都会并进本机，所以读得越早攒得越多。这些评论目前只能在应用里看，不写进 JSON 导出文件。

### 能看到自己每天刷了多久抖音吗？

能看到这台电脑上的时长。DouyinDataReview 右上角的「使用记录」记下每次打开软件窗口和浏览器抖音网页的开始、结束时间和时长，重叠的时段只算一次，记录存在本机。浏览器网页不用装扩展，但要先打开浏览器的远程调试，每次连接时点允许，可在「设置 → 读取」打开自动连接；页面留在后台的时间也算在内。手机上刷的时间记不到。

### 能导出抖音创作者中心的作品数据和粉丝画像吗？

能，只限登录的本人账号。在「创作者中心 → 作品管理」点「导出表格」，会翻完全部作品，把发布时间、描述、播放、点赞、评论、分享、收藏、完播率、2 秒跳出率等指标存成 CSV；「数据中心」的粉丝画像也能导出性别、年龄、活跃度、设备、地域和兴趣分布。私密、审核中的作品和创作者中心一样不给指标；粉丝满 300 才有画像。

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

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

### 电脑上刷抖音能按关键词屏蔽不想看的视频吗？

能。手机上可以用抖音 App 自带的屏蔽设置，入口以当前版本为准；在电脑上，可以用 DouyinDataReview 的「设置 → 推荐流」写屏蔽词条，一行一个词，可以限定只匹配标题、作者、话题或音乐，也支持正则。软件里刷视频直接生效；想在 Chrome、Edge 刷抖音网页时也过滤，就装一次应用自带的扩展。有三种处理方式：只记录不拦、隐藏、隐藏后替你点「不感兴趣」（只有网页上会点，每分钟最多 6 条）。被挡掉的视频能在内容库「推荐流挡掉的」里翻到。网页上已经显示的首屏和作品详情拦不掉，只记录命中，后面加载的推荐才会过滤。

### 能让抖音多推想看的内容，或者只看某个词条吗？

能。在 DouyinDataReview 的「设置 → 推荐流」填想看的词条（最多 20 个），应用用本人账号搜这些词，把相关视频插进推荐，频率可选每 1、2、3、5、10 条插一条，也可以选「只看词条」。软件和网页共用这份设置，网页上要装扩展并打开「网页插入视频」。命中屏蔽词的视频不会插入，搜索失败时照常刷推荐。视频是在你这边插进去的，不等于改了抖音给账号的推荐算法。

### 有 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。