feat: 更新文档并添加 OneDrive 支持

- 在 overview.md 中添加 OneDrive 到存储后端对比 - 更新导航栏和 plume.config 以包含 OneDrive 链接 - 创建详细的 OneDrive 配置指南 - 从 GitHub 和 S3 文档中删除冗余章节 - 将 .env 和缓存目录添加到 .gitignore
2025-12-06 15:26:10 +08:00 · 2025-11-15 19:37:35 +08:00
parent 641a729592
commit 22b2339d3c
8 changed files with 415 additions and 723 deletions
--- a/docs/storage/overview.md
+++ b/docs/storage/overview.md
@@ -9,16 +9,16 @@ Cloud Index 支持多个存储后端，可根据需求选择合适的服务。

 ## 后端对比

-| 特性 | Cloudflare R2 | Amazon S3 | GitHub Repository |
-|-----|------------|----------|------------------|
-| **定价模式** | 流量免费 + 请求费 | 流量费 + 请求费 + 存储费 | 免费（通过 GitHub） |
-| **价格水平** | 💚 最低 | 💛 中等 | 💚 免费 |
-| **全球覆盖** | ✅ 全球 CDN | ✅ 全球 CDN | ✅ CDN 加速可选 |
-| **易用性** | ✅ 简单 | ⚠️ 中等 | ✅ 简单 |
-| **可扩展性** | ✅ 无限制 | ✅ 无限制 | ⚠️ 仓库大小限制（1GB） |
-| **性能** | 🚀 优秀 | 🚀 优秀 | 🚀 优秀（配合 CDN） |
-| **版本控制** | ❌ 无 | ❌ 无 | ✅ 自动 Git 历史 |
-| **适用场景** | 个人/小团队 | 企业 | 开源/文档 |
+| 特性 | Cloudflare R2 | Amazon S3 | OneDrive | GitHub Repository |
+|-----|------------|----------|----------|------------------|
+| **定价模式** | 流量免费 + 请求费 | 流量费 + 请求费 + 存储费 | 订阅制 | 免费（通过 GitHub） |
+| **价格水平** | 💚 最低 | 💛 中等 | 💰 付费/限时免费 | 💚 免费 |
+| **全球覆盖** | ✅ 全球 CDN | ✅ 全球 CDN | ✅ 全球覆盖 | ✅ CDN 加速可选 |
+| **易用性** | ✅ 简单 | ⚠️ 中等 | ✅ 简单 | ✅ 简单 |
+| **可扩展性** | ✅ 无限制 | ✅ 无限制 | ⚠️ 5GB-1TB+ | ⚠️ 仓库大小限制（1GB） |
+| **性能** | 🚀 优秀 | 🚀 优秀 | 🚀 优秀 | 🚀 优秀（配合 CDN） |
+| **版本控制** | ❌ 无 | ❌ 无 | ✅ 自动版本历史 | ✅ 自动 Git 历史 |
+| **适用场景** | 个人/小团队 | 企业 | 个人/企业协作 | 开源/文档 |

 ## 快速选择指南

@@ -83,43 +83,67 @@ Cloud Index 支持多个存储后端，可根据需求选择合适的服务。

 - 完全免费 ✅

+### 选择 OneDrive
+
+**如果你需要：**
+
+- ✅ Office 集成
+- ✅ 自动同步
+- ✅ 版本历史
+- ✅ 跨平台支持
+
+**推荐用途：**
+
+- 个人文档管理
+- 团队协作文件
+- Office 文档编辑
+- 照片和视频存储
+- 跨设备文件同步
+
+**成本估算：**
+
+- 个人版：免费 5GB，Microsoft 365 订阅 ¥398/年（1TB）
+- 企业版：¥75-150/用户/月
+
 ## 功能特性对比

 ### 文件操作

-| 操作 | R2 | S3 | GitHub |
-|-----|-----|-----|---------|
-| 上传 | ✅ | ✅ | ✅ |
-| 下载 | ✅ | ✅ | ✅ |
-| 删除 | ✅ | ✅ | ✅ |
-| 列表 | ✅ | ✅ | ✅ |
-| 重命名 | ✅ | ✅ | ✅ |
-| 复制 | ✅ | ✅ | ⚠️ (需支持) |
-| 移动 | ✅ | ✅ | ⚠️ (需支持) |
+| 操作 | R2 | S3 | OneDrive | GitHub |
+|-----|-----|-----|----------|---------|
+| 上传 | ✅ | ✅ | ✅ | ✅ |
+| 下载 | ✅ | ✅ | ✅ | ✅ |
+| 删除 | ✅ | ✅ | ✅ | ✅ |
+| 列表 | ✅ | ✅ | ✅ | ✅ |
+| 重命名 | ✅ | ✅ | ✅ | ✅ |
+| 复制 | ✅ | ✅ | ✅ | ⚠️ (需支持) |
+| 移动 | ✅ | ✅ | ✅ | ⚠️ (需支持) |

 ### 高级功能

-| 功能 | R2 | S3 | GitHub |
-|-----|-----|-----|---------|
-| 公开访问 URL | ✅ | ✅ | ✅ |
-| 预签名 URL | ✅ | ✅ | ✅ |
-| CDN 集成 | ✅ | ✅ | ✅ |
-| 版本控制 | ❌ | ⚠️ (付费) | ✅ |
-| 生命周期策略 | ✅ | ✅ | ❌ |
-| 访问控制 | ✅ | ✅ | ✅ (Git 权限) |
+| 功能 | R2 | S3 | OneDrive | GitHub |
+|-----|-----|-----|----------|---------|
+| 公开访问 URL | ✅ | ✅ | ✅ | ✅ |
+| 预签名 URL | ✅ | ✅ | ✅ | ✅ |
+| CDN 集成 | ✅ | ✅ | ✅ | ✅ |
+| 版本控制 | ❌ | ⚠️ (付费) | ✅ | ✅ |
+| 生命周期策略 | ✅ | ✅ | ❌ | ❌ |
+| 访问控制 | ✅ | ✅ | ✅ | ✅ (Git 权限) |
+| Office 在线编辑 | ❌ | ❌ | ✅ | ❌ |
+| 缩略图预览 | ⚠️ | ⚠️ | ✅ | ❌ |

 ## 性能基准

 基于 1 千次请求、1GB 文件的测试：

-| 操作 | R2 | S3 | GitHub |
-|-----|-----|-----|---------|
-| **列表** | ~50ms | ~80ms | ~150ms |
-| **上传** | ~300ms | ~350ms | ~500ms |
-| **下载** | ~100ms | ~120ms | ~200ms |
-| **删除** | ~100ms | ~120ms | ~200ms |
+| 操作 | R2 | S3 | OneDrive | GitHub |
+|-----|-----|-----|----------|---------|
+| **列表** | ~50ms | ~80ms | ~120ms | ~150ms |
+| **上传** | ~300ms | ~350ms | ~400ms | ~500ms |
+| **下载** | ~100ms | ~120ms | ~150ms | ~200ms |
+| **删除** | ~100ms | ~120ms | ~150ms | ~200ms |

-*注：实际性能取决于网络距离和文件大小*
+> **注意**：实际性能取决于网络距离和文件大小

 ## 成本对比（月均）

@@ -133,51 +157,25 @@ Cloud Index 支持多个存储后端，可根据需求选择合适的服务。
 |-----|-------|--------|--------|------|
 | **R2** | 免费 | $0.36 | 免费 | **$0.36** 💚 |
 | **S3** | $2.30 | $0.50 | $4.57 | **$7.37** |
+| **OneDrive** | ¥33/月 | 免费 | 免费 | **¥33/月** (1TB) |
 | **GitHub** | 免费 | 免费 | 免费 | **免费** 🎉 |

-## 迁移指南
-
-### R2 → S3
-
-```bash
-# 使用 aws cli 迁移
-aws s3 sync s3://r2-bucket/ s3://s3-bucket/ \
-  --source-profile r2 \
-  --profile s3
-```
-
-### S3 → R2
-
-```bash
-# 使用 aws cli 迁移
-aws s3 sync s3://s3-bucket/ s3://r2-bucket/ \
-  --source-profile s3 \
-  --profile r2 \
-  --endpoint-url https://account.r2.cloudflarestorage.com
-```
-
-### GitHub → R2
-
-```bash
-# 1. 从 GitHub 克隆仓库
-git clone https://github.com/user/repo.git
-cd repo
-
-# 2. 使用工具上传到 R2
-# 使用 rclone、aws cli 等工具
-```
+> **说明**：OneDrive 个人版 5GB 免费，Microsoft 365 订阅 ¥398/年（约 ¥33/月）提供 1TB 空间

 ## 如何选择

 ### 决策树

-```
+```text
 是否需要完全免费？
 ├─ 是 → GitHub Repository ✅
 └─ 否
-    └─ 是否需要企业级功能？
-        ├─ 是 → Amazon S3 ✅
-        └─ 否 → Cloudflare R2 ✅（最佳平衡）
+    └─ 是否需要 Office 集成？
+        ├─ 是 → OneDrive ✅
+        └─ 否
+            └─ 是否需要企业级功能？
+                ├─ 是 → Amazon S3 ✅
+                └─ 否 → Cloudflare R2 ✅（最佳平衡）
 ```

 ### 快速决策表
@@ -186,9 +184,11 @@ cd repo
 |-----|------|------|
 | 个人博客 | GitHub | 免费且简单 |
 | 小团队文件 | R2 | 成本低，性能好 |
+| Office 文档 | OneDrive | Office 集成，在线编辑 |
 | 企业应用 | S3 | 功能完整，支持好 |
 | 大规模存储 | R2 | 流量免费，成本最低 |
-| 版本控制重要 | GitHub | 自动 Git 历史 |
+| 版本控制重要 | GitHub/OneDrive | 自动版本历史 |
+| 团队协作 | OneDrive | 实时协作，权限管理 |

 ## 后续配置

@@ -196,17 +196,11 @@ cd repo

 - **[Cloudflare R2 配置](./r2.md)** - 详细配置步骤
 - **[Amazon S3 配置](./s3.md)** - AWS S3 设置
+- **[OneDrive 配置](./onedrive.md)** - Microsoft OneDrive 配置
 - **[GitHub 存储配置](./github.md)** - GitHub 仓库配置

 ## 常见问题

-### Q: 可以中途更换存储后端吗？
-
-**A:** 可以！只需修改 `.env` 文件中的 `STORAGE_TYPE` 环境变量。但需要：
-
- 手动迁移现有文件
- 重新配置凭证
-
 ### Q: 多个后端能同时使用吗？

 **A:** 目前不支持，但可以：
@@ -221,19 +215,9 @@ cd repo

 - **R2**: 每月前 1000 万请求免费 ✅
 - **S3**: 新用户 12 个月免费套餐
+- **OneDrive**: 个人用户 5GB 免费 ✅
 - **GitHub**: 完全免费（通过 GitHub）✅

-### Q: 如何监控使用成本？
-
-**A:**
-
- **R2**: Cloudflare 控制面板实时显示
- **S3**: AWS 成本管理器
- **GitHub**: 不产生成本
-
 ## 获取帮助

- 📖 [R2 详细配置](./r2.md)
- 📖 [S3 详细配置](./s3.md)
- 📖 [GitHub 详细配置](./github.md)
 - 🐛 [提交 Issue](https://github.com/RhenCloud/Cloud-Index/issues)