Files
backend_v2/internal/model/crawl_task.go
toom1996 51e3d13383 feat: 抓取进度可见 + 已入库秀预检(避免重复下载)
一、防重复下载
图片 key 是内容 sha1,不下载无法判断是否已存在;又没存 source_url,
于是每次重爬都把几百张已下过的图再下一遍(线上实测 Celine 62 分钟、0 新增)。
新增 GET /admin/internal/shows/covered?brand_uid=,按 (年份,季节,类型)
聚合已入库图片数,供 spider 抓前整场跳过。

二、进度可见
一次抓取可能跑几十分钟,此前只有 running/done,看不出「在干什么」,
也分不清「慢」和「卡死」。
- crawl_tasks 增加 progress_done/total/text/at
- POST /admin/internal/crawl/tasks/:id/progress(spider 每场 + 每批图片上报)
- GET /admin/crawl/live(页面 4 秒轮询,局部刷新状态/进度/已提交)
- progress_at 超过 10 分钟没更新标黄「可能卡住」
- 渲染测试守住进度列与轮询锚点
2026-10-25 21:22:56 +08:00

64 lines
3.7 KiB
Go
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

package model
// CrawlTask 后台派发给爬虫服务的「品牌抓取任务」。
//
// 与 ingest_jobs 的分工:
// - ingest_jobs:一场走秀的入库任务,由后端 worker 消费(下载图 / 写库 / 编码);
// - crawl_tasks:一个品牌的抓取任务,由 spider 服务领取执行(可能在另一台机器)。
//
// 两层解耦的好处:后台只需表达「我要爬哪些品牌」,不必关心 spider 在哪、跑几个。
// spider 拉不到任务就空转,任务积压也不会影响已有数据的读写。
const (
CrawlQueued = "queued" // 待领取
CrawlRunning = "running" // 已被某个 worker 领取
CrawlDone = "done" // 执行完成(不代表每场都入库成功,见 last_error)
CrawlFailed = "failed" // 执行失败(spider 进程报错 / 品牌在 Vogue 无页面等)
CrawlCanceled = "canceled" // 后台手动取消
)
// CrawlStuckTimeoutSec 是 running 任务的租约时长:超过该时长仍未回报,
// 视为 worker 已崩溃(断电 / 被杀),任务可被重新领取,避免永久卡在 running。
const CrawlStuckTimeoutSec = 900
// CrawlMaxAttempts 自动重试上限;达到后置 failed,需后台手动「重试」。
const CrawlMaxAttempts = 3
// CrawlTask 品牌抓取任务。
// 时间字段与项目其它表一致,统一用 Unix 秒(uint32)。
type CrawlTask struct {
ID uint32 `gorm:"primaryKey;column:id" json:"id"`
BrandID uint32 `gorm:"column:brand_id;not null" json:"brand_id"`
// Status 见上方常量;默认 queued。
Status string `gorm:"column:status;size:16;not null;default:'queued'" json:"status"`
// Priority 越大越先被领取;用于「手动加的」优先于「批量加的」。
Priority int16 `gorm:"column:priority;not null;default:0" json:"priority"`
// MaxShows 单品牌最多抓几场(0=不限)。批量重爬历史品牌时用它控制入库量。
MaxShows int16 `gorm:"column:max_shows;not null;default:0" json:"max_shows"`
// Worker 领取者标识(主机名 + 进程号),便于排查「谁跑的」。
Worker string `gorm:"column:worker;size:64;not null;default:''" json:"worker"`
// LockedAt 领取时间,配合 CrawlStuckTimeoutSec 做租约回收。
LockedAt uint32 `gorm:"column:locked_at;not null;default:0" json:"locked_at"`
// Attempts 已被领取次数;用于自动重试与放弃判定。
Attempts int16 `gorm:"column:attempts;not null;default:0" json:"attempts"`
// ShowsSubmitted 本任务向 ingest 提交了多少场走秀(spider 回报)。
ShowsSubmitted int32 `gorm:"column:shows_submitted;not null;default:0" json:"shows_submitted"`
LastError string `gorm:"column:last_error;type:text" json:"last_error"`
// 进度:spider 每处理完一场秀上报一次。
// 一次抓取可能跑几十分钟,没有这四项后台只能看到「执行中」,分不清慢和卡死。
ProgressDone int16 `gorm:"column:progress_done;not null;default:0" json:"progress_done"`
ProgressTotal int16 `gorm:"column:progress_total;not null;default:0" json:"progress_total"`
ProgressText string `gorm:"column:progress_text;size:160;not null;default:''" json:"progress_text"`
ProgressAt uint32 `gorm:"column:progress_at;not null;default:0" json:"progress_at"`
CreatedAt uint32 `gorm:"column:created_at;not null;default:0" json:"created_at"`
UpdatedAt uint32 `gorm:"column:updated_at;not null;default:0" json:"updated_at"`
}
// TableName 指定表名。
func (CrawlTask) TableName() string { return "crawl_tasks" }
// CrawlTaskRow 是列表/领取接口用的投影行,附带品牌名(列表展示与拼 Vogue URL 都用得上)。
type CrawlTaskRow struct {
CrawlTask
BrandName string `gorm:"column:brand_name"`
}