Skip to content

Actions: add-task, suggestions

add-task — 添加转存任务

API: POST {AUTO_SAVE_BASE_URL}/api/add_task?token={AUTO_SAVE_TOKEN}

必填参数:

  • --name — 任务名称
  • --shareurl — 夸克网盘分享链接(如 https://pan.quark.cn/s/xxxxxx
  • --savepath — 保存路径(如 /影视/测试

可选参数:

  • --pattern — 文件匹配正则(如 (.*)\\.(mp4|mkv)
  • --replace — 替换规则

示例:

/autosave add-task --name "xxx" --shareurl "https://pan.quark.cn/s/xxx" --savepath "/xxx"
/autosave add-task --name "xxx" --shareurl "https://pan.quark.cn/s/xxx" --savepath "/xxx" --pattern "(.*)\\.(mp4|mkv)"

成功响应:

json
{
  "success": true,
  "code": 0,
  "message": "任务添加成功",
  "data": {
    "taskname": "string",
    "shareurl": "string",
    "savepath": "string"
  }
}

search — 搜索任务建议

API: GET {AUTO_SAVE_BASE_URL}/task_suggestions?q={query}&d={depth}&token={AUTO_SAVE_TOKEN}

必填参数:

  • --query — 搜索关键词

可选参数:

  • --depth — 搜索深度,默认 1
  • --tree — 获取有效资源的目录结构,默认不启用
  • --max-depth — 目录树最大深度,默认 3

功能增强: 搜索结果会进行有效性预检查,对每个结果调用 get_share_detail 接口验证有效性。有效结果排在前面,无效/过期的结果会标注"已失效"。结果会显示:标题、文件大小(size)、文件数量(all_file_num)、是否有效。

启用 --tree 参数后,会对有效性验证通过的资源获取目录结构,最多处理 3 个有效资源,每棵树最多遍历 --max-depth 层。

示例:

/autosave search --query "test"
/autosave search --query "团战" --depth 2
/autosave search --query "xxx" --tree          # 获取目录结构
/autosave search --query "xxx" --tree --max-depth 2

响应示例:

json
{
  "success": true,
  "data": [
    {
      "taskname": "...",
      "shareurl": "...",
      "content": "...",
      "datetime": "...",
      "channel": "...",
      "source": "...",
      "directory_tree": {
        "name": "文件夹名称",
        "type": "folder",
        "children": [
          {"name": "文件1.mp4", "type": "file", "size": 123456},
          {"name": "子文件夹", "type": "folder", "can_explore": true}
        ]
      }
    }
  ]
}

基于非商业使用许可证发布