如何手动触发任务?

命令行工具使用指南

📥 下载队列调试

手动执行监控下载队列任务

php artisan queue:work --queue=slow --verbose

说明： 启动一个新的队列工作者进程，监控并执行 slow 队列中的任务，显示详细的执行日志。

---

🖼️ 封面管理

可选参数

参数	说明	示例
--target	目标封面 (favorite, subscription, video, upper)	--download

⚠️ 低版本升级时缺失封面或者有需要时执行：

php artisan app:scan-cover-image --target=favorite
php artisan app:scan-cover-image --target=subscription
php artisan app:scan-cover-image --target=video
php artisan app:scan-cover-image --target=upper

---

🎬 视频文件管理

扫描本地视频文件

如果视频已经下载但数据库记录丢失或未及时更新，可通过此命令重新扫描文件并更新数据库：

php artisan app:scan-video-file

可选参数

参数	说明	示例
--video-id	指定具体的视频ID	--video-id=12345
--force	强制扫描所有视频（包括已标记为下载的视频）	--force
--download	视频文件不存在时自动下载	--download

使用示例

# 强制下载某个视频
php artisan app:scan-video-file --download  --force --video-id=12345

# ⚠️[谨慎] 强制下载所有视频( 如果不存在 )
php artisan app:scan-video-file --download  --force

# 只在视频文件缺失的时候去下载某个视频
php artisan app:scan-video-file --download --video-id=12345

# 只在视频文件缺失的时候下载所有视频
php artisan app:scan-video-file --download 

更新视频分P信息

遇到视频信息不更新时，或者长期无法下载，可以手动指定更新分P信息。更新后会被定时任务下载视频。

# ⚠️ 全量更新：如果收藏的视频过多，可能会触发风控
php artisan app:update-fav --update-video-parts=true 

# 指定更新某个视频
php artisan app:update-fav --update-video-parts=true --update-video-parts-video-id=123

---

⭐ 收藏夹管理

更新收藏夹基础信息

php artisan app:update-fav --update-fav=true

更新收藏夹内视频信息（指定页数）

php artisan app:update-fav --update-fav-videos=true --update-fav-videos-page=1

说明： 更新指定页数的收藏夹视频信息，适用于增量更新。定时任务去轮询发现新视频，避免全量更新引起风控。

更新收藏夹内视频信息（全量更新）

php artisan app:update-fav --update-fav-videos=true

说明： 全量更新收藏夹内所有视频信息，适用于完整同步。夜间凌晨执行全量更新任务。

---

收藏夹完整更新流程

# 1. 更新收藏夹基础信息
php artisan app:update-fav

# 2. 全量更新收藏夹内视频信息
php artisan app:update-fav --update-fav-videos=true