# 腾讯云COS文档预览方案调研

## 调研背景
为了实现小程序中附件（PDF、Word、Excel、PPT等）的在线预览功能，需要调研腾讯云COS相关的文档预览解决方案。

## 调研结果

### 1. 腾讯云COS原生支持
腾讯云COS本身主要提供对象存储服务，不直接提供文档预览功能。但可以结合其他服务实现文档预览。

### 2. 小程序原生支持
微信小程序提供了基础的文档预览能力：
- **wx.openDocument**: 支持打开PDF、Word、Excel、PPT等文档
- **wx.previewImage**: 支持图片预览
- **video组件**: 支持视频播放

### 3. 第三方文档预览方案

#### 3.1 微软Office Online预览服务
- **服务地址**: `http://view.officeapps.live.com/op/view.aspx?src=文档URL`
- **支持格式**: Word(docx, dotx)、Excel(xlsx, xlsb, xls, xlsm)、PowerPoint(pptx, ppsx, ppt, pps, potx, ppsm)
- **限制条件**:
  - 文档必须外网可访问
  - Word和PowerPoint文档小于10MB
  - Excel文档小于5MB
  - 文档URL必须是域名且为80端口
- **安全风险**: 文档可能被上传到微软服务器

#### 3.2 开源文档预览服务 (kkFileView)
- **项目地址**: https://gitee.com/kekingcn/file-online-preview
- **支持格式**: doc、docx、ppt、pptx、xls、xlsx、pdf、zip、rar、mp4、mp3、txt等
- **部署方式**: Spring Boot应用，需要自行部署
- **依赖环境**: Redis(可选)、OpenOffice或LibreOffice

#### 3.3 Vue-Office组件库
- **适用场景**: 前端直接预览
- **支持格式**: docx、xlsx、pdf、pptx
- **使用方式**: 
  - 网络地址预览
  - ArrayBuffer/Blob数据预览
  - 文件上传预览

### 4. 推荐方案

#### 方案一：小程序原生 + 微软Office Online（推荐）
```javascript
// 图片预览
wx.previewImage({
  current: imageUrl,
  urls: [imageUrl]
})

// 视频播放
wx.navigateTo({
  url: `/pages/video/video?url=${encodeURIComponent(videoUrl)}`
})

// Office文档预览（使用微软服务）
const officeUrl = `http://view.officeapps.live.com/op/view.aspx?src=${encodeURIComponent(docUrl)}`
wx.navigateTo({
  url: `/pages/webview/webview?url=${encodeURIComponent(officeUrl)}`
})

// PDF文档预览
wx.downloadFile({
  url: pdfUrl,
  success: (res) => {
    wx.openDocument({
      filePath: res.tempFilePath
    })
  }
})
```

#### 方案二：自建文档预览服务
1. 部署kkFileView服务
2. 将COS文档URL传递给预览服务
3. 在小程序中通过webview打开预览页面

#### 方案三：前端直接预览（限制较多）
使用Vue-Office等前端组件库，但需要考虑小程序环境的兼容性。

## 实施建议

### 短期方案（立即可用）
1. **图片**: 使用`wx.previewImage`
2. **视频**: 使用自定义视频播放页面
3. **PDF**: 使用`wx.openDocument`下载后预览
4. **Office文档**: 使用微软Office Online服务（需要文档外网可访问）

### 长期方案（更好的用户体验）
1. 部署自建的文档预览服务（如kkFileView）
2. 确保文档的外网访问能力
3. 在小程序中集成webview组件用于文档预览

## 安全考虑
1. 使用微软Office Online服务时，文档可能被上传到微软服务器
2. 自建预览服务可以更好地控制数据安全
3. 敏感文档建议使用本地下载预览方式

## 成本分析
1. **微软Office Online**: 免费，但有安全风险
2. **自建服务**: 需要服务器资源和维护成本
3. **小程序原生**: 免费，但功能有限

## 结论
建议采用**方案一**作为初期实现，后续根据业务需求和安全要求考虑部署自建文档预览服务。