openclaw-voc-skill/dist/skills/quickly-video-library/SKILL.md

---

name: quickly-video-library description: 查询一键成片历史视频列表，支持按taskId、日期筛选和分页，并可记录视频下载次数

version: 1.1.0

一键成片 — 视频库管理 (Quickly Video Library)

技能目的

查询历史生成的短视频列表，支持分页、按任务/日期筛选，并记录视频下载次数。可独立使用，也可作为一键成片工作流的可选下游。

调用链（Workflow）

独立使用: quickly-video-library(list) → 浏览全部历史视频
  ↓
工作流下游: quickly-video-create → quickly-video-query → quickly-video-library(taskId) → 查看本次生成的视频
  ↓
用户保存视频后: quickly-video-library(recordDownload, videoId) → 下载计数+1

输入参数

action: list（分页查询）

参数	类型	必填	说明
page	integer	❌	页码，从1开始，默认1
pageSize	integer	❌	每页条数，默认20
taskId	string	❌	按任务ID筛选（不传则查全部）
dateStart	string	❌	开始日期 ISO 8601，如 2026-03-01T00:00:00.000Z
dateEnd	string	❌	结束日期 ISO 8601

action: recordDownload（记录下载）

参数	类型	必填	说明
videoId	string	✅	视频 objectId（优先）或 preId

执行流程

1. 浏览视频库：调用 list 获取分页视频列表

   POST https://server.fmode.cn/api/functions
   Content-Type: application/json
   Body: { "id": "sWvRr8RvPT", "_ApplicationId": "ncloudmaster", "action": "list", "page": 1, "pageSize": 20 }
   

2. 按任务筛选：传入 taskId 查看某次生成任务的所有视频

3. 按日期筛选：传入 dateStart + dateEnd 查看某时间段内的视频

4. 记录下载：用户保存视频后调用 recordDownload，全局下载计数+1

调用的底层 Skill

• 无（本 Skill 为独立查询，不依赖其他 Skill）
• 被 quickly-video-create 工作流可选调用

返回格式

{
  "code": 200,
  "success": true,
  "total": 15,
  "data": [
    {
      "objectId": "xBtdUG9gTv",
      "taskId": "2039371716671352832",
      "preId": "1775059079891",
      "coverUrl": "https://img.kuaizi.co/video/.../cover.jpg",
      "videoUrl": "https://img.kuaizi.co/video/.../video.mp4",
      "videoName": "客厅隔断推拉门新选择",
      "videoDuration": 15.2,
      "downloadCount": 3,
      "createdAt": "2026-04-01T15:59:20.241Z"
    }
  ]
}

核心业务场景

• 商家浏览历史生成视频，选择满意的下载发布
• Agent 工作流：生成视频后引导用户查看视频库
• 运营统计：按日期范围查看视频生成量和下载次数

注意事项

• 移动端保存视频必须使用原始视频 URL（非 blob URL），否则微信长按无法触发保存
• 支持 Web Share API 时优先调用 navigator.share()；不支持时显示长按保存引导

依赖

• Parse 云函数 sWvRr8RvPT（部署在 server.fmode.cn）