安装 EXE
从官方下载页获取版本化安装包，先核对文件大小和 SHA-256，再按安装向导完成安装。
GAE DATA RETURN / GUIDE
从账号激活到查看数据
按照以下步骤完成连接、登录、同步和数据查看。TikTok 登录与验证码均在官方页面内完成。
01
DOWNLOAD & INSTALL
选择对应系统的客户端
Windows 10/11 64 位设备下载 x64 EXE；搭载 Apple 芯片且运行 macOS 13 或更高版本的设备下载 arm64 DMG。两个版本的账号隔离、同步和看板能力一致。
安装 DMG
下载 DMG 并核对 SHA-256，再将应用拖入“应用程序”。当前 Mac 包不支持 Intel 处理器。
保留系统安全保护
内测包若显示来源、SmartScreen 或开发者验证提示，请先核对下载域名和 SHA-256，不要关闭 Windows 或 macOS 的系统安全功能。
02
ACTIVATE
获取激活码并建立连接
向平台负责人获取与发行账号对应的一次性激活码。打开客户端，将激活码粘贴到输入框并点击“激活连接”。成功后，该账号会出现在账号下拉框中。
激活码是一次性的
激活码有效期由管理员设置，最长为生成后 1 年（365 天），成功使用一次后立即失效。该期限不限制激活后的客户端使用时长。若提示无效、已过期或已使用，请联系平台负责人重新生成，不要反复尝试旧码。
03
OFFICIAL LOGIN
在隔离浏览器登录 TikTok
在账号下拉框中选择需要登录的连接，点击“登录 TikTok”，然后只在弹出的官方页面中输入登录信息并完成验证码。
- 不要在客户端控制页填写 TikTok 密码。
- 每个发行账号使用独立登录会话，账号之间不会共用 Cookie。
- 添加多个账号时，为每个账号分别完成“激活—登录”。
- 登录状态失效后，重新打开该账号的登录窗口完成官方授权。
04
SYNC ALL ACCOUNTS
同步全部已登录账号
账号下拉框用于管理登录账号和打开某个账号的看板；两个同步按钮都会按顺序处理客户端内全部已经登录的账号。
同步剧集表现
回传平台提供的播放量、有效观看、完播、观看时长、点赞、评论、收藏、分享等指标。
同步作品收益
回传作品收入以及 IAA、订阅、购买、保底等平台实际返回的收益字段。
- 同步完成
- 该类数据已成功回传。
- 部分完成
- 部分账号成功，未登录或异常账号已跳过。
- 需要重新授权
- 重新打开对应账号的 TikTok 登录窗口。
- 同步失败
- 根据客户端提示检查网络、登录状态和账号权限。
05
SECURE DASHBOARD
从客户端打开自己的数据看板
在账号下拉框选择要查看的账号，点击右上角“打开数据看板”。普通数据看板只显示当前所选账号的数据。
不要转发看板地址
看板不能通过公开网页直接进入。访问票据由客户端临时签发，兑换后立即失效；页面会话过期后，从客户端重新点击打开即可。
06
READ THE DATA
使用数据看板
总览
查看剧集总数、播放、有效观看、互动、作品收入、排行榜和最近回传。
剧集表现
按剧名搜索、排序并查看各项表现指标和历史快照。
作品收益
查看收入构成、作品排名和平台返回的收益明细。
统计时间
支持最近回传、昨日、近 7 天、近 30 天和自定义日期范围。
截至期末
读取结束日期之前最近一次累计快照，适合查看某个时点的总体规模。
区间新增
使用期末累计值减去期初基线。没有期初基线的作品会保留提示，但不会被误算成新增。
作品收益
按平台结算月份展示，不将月度收益推算或平均拆分到每天。
刷新看板读取服务端已保存数据
≠
重新加载当前看板，不会让客户端重新访问平台。
实时同步 / 全部同步请求在线客户端重新获取
客户端必须保持运行，并且相关 TikTok 账号登录有效。
07
TROUBLESHOOTING
常见问题
激活码为什么不能使用？
激活码可能已过期或已被使用。联系平台负责人重新生成一次性激活码。
为什么某个账号在同步时被跳过？
通常是该连接尚未登录、登录状态失效或账号没有相应页面权限。打开对应账号的 TikTok 登录窗口检查。
为什么打开看板后没有最新数据？
刷新只会读取服务端已有数据。请保持客户端打开并执行对应同步，完成后再刷新看板。
关闭客户端后，已经回传的数据还在吗？
还在。剧集表现、作品收益和历史快照保存在服务端，客户端离线不会清空。看板会显示各类数据的最近回传时间；离线期间可以查看、筛选和汇总已存数据，但不能获取新的平台数据。普通看板仍需有效的账号访问会话；会话失效后须从客户端重新打开。
为什么区间新增提示缺少期初基线？
该作品可能在所选区间内首次采集，系统没有区间开始前的累计快照，因此不会猜测其新增量。
采集完但网络断开，数据会丢吗？
完整批次先在客户端加密暂存，恢复网络或重新打开客户端后自动补传。服务端确认完整保存前，看板保留上次数据。未采集完整的批次不会自动提交，需要重新同步；校验被拒绝的批次可手动重试。请勿卸载客户端或清理应用数据目录，否则本地待回传数据可能丢失。
解除授权会删除数据吗？
不会。解除授权停止旧设备与普通网页会话的访问，已保存数据仍可由管理员查看。归档也保留数据；只有管理员二次确认永久清除后才会删除。
为什么作品收益按月份显示？
作品收益按 TikTok 返回的结算月份保存和统计，不根据采集日期拆成日收入。
为什么不能直接通过网址进入普通看板？
普通看板需要由已授权客户端签发临时票据，以保证每个客户端只能查看自己所选账号的数据。
系统提示安装包来源或开发者验证怎么办？
当前 Windows 包尚未签名；Mac 应用已完成 Developer ID 签名、但尚未完成 Apple 公证。请先确认下载域名并核对下载页 SHA-256；不要关闭系统安全功能，如无法安装请联系平台负责人。