globalCopyFiles API 文档

接口描述

将本地文件系统中的多个文件拷贝到工作空间的指定目录。

通常用于从外部导入资源文件。

注意: 目标目录路径 (`destDir`) 相对于工作空间根目录。要拷贝到 data 目录，路径必须以 data/ 开头。要拷贝到临时目录 temp，路径必须以 temp/ 开头。

源文件路径 (`srcs`) 是本地文件系统的绝对路径。

请求

方法: POST

路径: `/api/file/globalCopyFiles`

认证: 需要 Token

请求体 (JSON)

参数	类型	必需	描述
`srcs`	array[string]	是	源文件路径数组 (本地文件系统的绝对路径)。例如 `["/Users/user/Downloads/image1.png", "/Users/user/Downloads/image2.jpg"]`。
`destDir`	string	是	目标目录路径，相对于工作空间根目录。例如 `data/assets` 或 `temp/uploads`。必须包含正确的路径前缀。

请求示例

将本地下载的文件拷贝到数据目录下的 assets:

{
    "srcs": [
        "C:/Users/MyUser/Downloads/report.pdf",
        "/home/user/Pictures/logo.svg"
    ],
    "destDir": "data/assets"
}

将本地临时文件拷贝到工作空间的 temp 目录:

{
    "srcs": ["/tmp/temp_export.zip"],
    "destDir": "temp"
}

响应

成功响应 (200 OK)

成功复制后，返回一个对象，其中 `files` 字段包含一个映射，键是原始临时文件路径，值是在 `data/assets/` 下生成的新文件名。

{
    "code": 0,
    "msg": "",
    "data": {
        "files": {
            "C:/Users/用户名/AppData/Local/Temp/copied-image.png": "assets/20230518120000-abcdefgh.png",
            "/tmp/another-file.pdf": "assets/20230518120001-ijklmnop.pdf"
        }
    }
}

失败响应

如果请求失败（例如，路径无效、文件不存在、复制失败等），将返回错误信息。

{
    "code": -1,
    "msg": "Copy file failed: ...", // 或其他错误信息
    "data": null
}

在线测试

注意: 此接口操作的是操作系统级的临时文件路径，在线测试器无法直接模拟。你需要确保提供的 `paths` 是当前操作系统中实际存在的临时文件路径。

全局复制文件 API (`/api/file/globalCopyFiles`)