Appearance
采集能力
采集这一段做得细一点,后面才不会返工。
主页采集
在「采集」页粘贴 TikTok 主页链接或 @用户名,可勾选「每日定时采集」并设定时间。到点后台自动拉新视频,列表持久化在本地库。可导出 TXT 备份关注列表。
视频直采
粘贴单条或多条视频 URL,一次性入库,适合临时补素材。直采与主页采集共用同一套去重与失效判定。
下载与时效
采集阶段只入库元数据,不持久化 SaveTik 返回的临时 CDN 链接。下载发生在真正拉取那一刻:先看本地是否已有校验通过的 raw.mp4,没有才现查现下,拿到地址立即拉取。CDN 链接有时效,隔天再用必然 403。
去重与失效判定
| 情况 | 处理 |
|---|---|
| video_id 已存在 | 跳过,不产生重复素材 |
| 403 / 404 / 链接过期 | 视为源失效,重新解析后重试 |
| 文件过小 / 非视频 | 视为源失效 |
| 网络超时 / 429 | 指数退避重试,不标记永久失败 |
| 达到最大重试次数 | 流水线标记失败,保留 source_url 供人工再试 |
数据在哪
| 数据 | 位置 |
|---|---|
| 笔记列表与去重键 | 本机 runtime/db/notes.db |
| 原片 | 本机 runtime/notes/ |
| 采集日志 | 桌面端「采集」页内查看 |
