文件管理

// 获取文件详细信息
const res = await smh.file.infoFile({
    spaceId: 'your-space-id',
    filePath: '/test.xlsx',
    info: 1,
    historyId: '123',
    purpose: 'preview',
});

if (res.status === 200) {
    console.log('文件信息获取成功', res.data);
}

const res = await smh.file.getCover({
    spaceId: 'your-space-id',
    filePath: '/video.mp4',
    preview: 1,
    size: 256,
    scale: 12,
    widthSize: 256,
    heightSize: 256,
    frameNumber: 1
});

// 服务端返回 302，axios 会自动跟随跳转，res.status 为最终响应的 200
// 浏览器端无法禁用自动跟随；如需封面 URL 本身，请改用 infoFile 获取 cosUrl，
// 或直接把本接口的请求地址交给 <img src> 使用（浏览器会自动跳转）
console.log('封面获取成功，状态码:', res.status);

// 获取 HTML 格式预览
const res = await smh.file.previewFile({
    spaceId: 'your-space-id',
    filePath: '/foo/bar.pptx',
    preview: 1,
    type: 'html',
});

// 服务端返回 302，axios 会自动跟随跳转，res.status 为最终响应的 200
// 如需在页面中展示预览，可直接把本接口的请求地址用于 <iframe src>（HTML 预览）
// 或 <img src>（type 为 pic 时的 JPG 预览），浏览器会自动跳转
console.log('预览获取成功，状态码:', res.status);

const res = await smh.file.checkFileStatus({
    spaceId: 'your-space-id',
    filePath: '/test.xlsx',
});

if (res.status === 200) {
    console.log('文件存在');
}

const res = await smh.file.getFileInfoByInode({
    spaceId: 'your-space-id',
    inode: '46bb40dd044f66340006425bd913af6f'
});

if (res.status === 200) {
    console.log('文件信息获取成功', res.data);
}

const res = await smh.file.copyFile({
    spaceId: 'your-space-id',
    filePath: '/dest/test.xlsx',
    conflictResolutionStrategy: 'rename',
    copyFileRequest: {
        copyFrom: '/test.xlsx'
    }
});

if (res.status === 200) {
    console.log('文件复制成功', res.data);
}

const res = await smh.file.moveFile({
    spaceId: 'your-space-id',
    filePath: '/dest/test.xlsx',
    conflictResolutionStrategy: 'rename',
    moveFileRequest: {
        from: '/test.xlsx'
    }
});

if (res.status === 200) {
    console.log('文件移动成功', res.data);
}

// 移入回收站
const res = await smh.file.deleteFile({
    spaceId: 'your-space-id',
    filePath: '/test.xlsx',
    permanent: 0,
});

if (res.status === 200) {
    console.log('文件已移入回收站', res.data);
}

const res = await smh.file.createSymlink({
    spaceId: 'your-space-id',
    filePath: '/test.xlsx',
    conflictResolutionStrategy: 'rename',
    createSymlinkRequest: {
        linkTo: '/dest/test.xlsx'
    }
});

if (res.status === 200) {
    console.log('符号链接创建成功', res.data);
}

const res = await smh.file.convertFile({
    spaceId: 'your-space-id',
    filePath: '/dest/test.pdf',        // 目标文件路径
    convert: 1,
    conflictResolutionStrategy: 'rename',
    convertFileRequest: {
        convertFrom: '/documents/test.docx' // 源文件路径
    }
});

if (res.status === 202) {
    console.log('转码任务已提交，任务ID:', res.data.taskId);
    // 通过任务管理接口轮询转码结果
}

const res = await smh.file.checkFileDeletion({
    spaceId: 'your-space-id',
    inode: '46bb40dd044f66340006425bd913af6f'
});

if (res.status === 200) {
    console.log('删除信息:', res.data);
}

const res = await smh.recent.listRecentlyUsedFile({
    spaceId: 'your-space-id',
    listRecentlyUsedFileRequest: {
        marker: 'xxx',
        limit: 20,
        filterActionBy: 'preview',
        type: ['pdf', 'word'],
        withPath: true
    }
});

if (res.status === 200) {
    console.log('获取最近使用文件成功', res.data);
}

// 使用预定义类型
type: 'document'

// 使用预定义类型数组
type: ['pdf', 'word', 'excel']

// 使用文件扩展名数组
type: ['.pdf', '.doc', '.xlsx']

{
  "nextMarker": "xxx",
  "contents": [
    {
      "name": "文档.docx",
      "spaceId": "space-id-1",
      "inode": "xxxxx",
      "size": "2048576",
      "actionType": "preview",
      "operationTime": "2025-12-03T10:30:00Z",
      "creationTime": "2025-12-01T08:00:00Z",
      "crc64": "xxxxxx",
      "path": ["folder1", "文档.doc"]
    }
  ]
}

// 创建最简单的虚拟文件
const res = await smh.file.createVirtualFile({
    spaceId: 'your-space-id',
    filePath: '/documents/reference.vfile',
    virtualFile: 1,
});

// 通过路径收藏
const res = await smh.favorite.createFavorite({
    spaceId: 'your-space-id',
    createFavoriteRequest: {
        path: '/documents/report.docx'
    }
});

// 通过 inode 收藏
const res2 = await smh.favorite.createFavorite({
    spaceId: 'your-space-id',
    createFavoriteRequest: {
        inode: '46bb40dd044f66340006425bd913af6f'
    }
});

{
  "inode": "46bb40dd044f66340006425bd913af6f"
}

// 使用 marker/limit 分页方式
const res = await smh.favorite.listFavorite({
    spaceId: 'your-space-id',
    marker: 'xxx',
    limit: 20,
    orderBy: 'favoriteTime',
    orderByType: 'desc',
    withPath: true
});

if (res.status === 200) {
    console.log('获取收藏列表成功', res.data);
    console.log('下一页标识:', res.data.nextMarker);
    res.data.contents.forEach(item => {
        console.log(`文件名: ${item.name}, 收藏时间: ${item.favoriteTime}`);
    });
}

// 使用 page/pageSize 分页方式
const res2 = await smh.favorite.listFavorite({
    spaceId: 'your-space-id',
    page: 1,
    pageSize: 20,
    orderBy: 'favoriteTime',
    orderByType: 'desc'
});

if (res2.status === 200) {
    console.log('总数:', res2.data.totalNum);
}

{
  "nextMarker": "xxx",
  "totalNum": 50,
  "contents": [
    {
      "spaceId": "space-id-1",
      "type": "file",
      "inode": "46bb40dd044f66340006425bd913af6f",
      "name": "文档.docx",
      "size": "2048576",
      "creationTime": "2025-12-01T08:00:00Z",
      "modificationTime": "2025-12-02T10:30:00Z",
      "favoriteTime": "2025-12-03T14:20:00Z",
      "fileType": "document",
      "path": ["文档", "文档.docx"],
      "userId": "test-user-id",
      "eTag": "abc123def456",
      "contentType": "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
      "crc64": "1234567890123456789",
      "previewByDoc": true,
      "previewByCI": false,
      "previewAsIcon": true
    }
  ]
}