云存储管理器(免费版)

面向多云存储场景的统一文件管理工具，覆盖主流对象存储与网盘服务，提供上传、下载、同步、成本核算等核心能力。

概述

本工具为多云存储操作提供统一抽象层，屏蔽各家Provider的API差异，让用户用单一命令完成跨云操作。设计目标：

• 统一API：一套命令操作S3、GCS、Azure Blob、R2、B2等所有Provider
• 成本透明：操作前预估出口流量费、API调用费，避免账单意外
• 校验严谨：API 200不代表成功，必须检查文件大小与校验和
• 断点续传：大文件分块上传，网络中断可恢复

核心能力

核心功能执行

用input_params参数进行配置。

输入: 用户提供核心功能执行所需的指令和必要参数。 处理: 解析核心功能执行的输入参数,完成核心逻辑,返回结构化响应。 输出: 返回核心功能执行的响应数据,包含状态码、结果和日志。

• 执行此能力时使用input_params参数,支持创建/查询/导出操作

参数配置与调用

用config_options参数进行配置。

输入: 用户提供参数配置与调用所需的指令和必要参数。 处理: 解析参数配置与调用的输入参数,完成核心逻辑,返回结构化响应。 输出: 返回参数配置与调用的响应数据,包含状态码、结果和日志。

• 执行此能力时使用config_options参数,支持修改/重置/导入操作

结果处理与输出

用output_format参数进行配置。

输入: 用户提供结果处理与输出所需的指令和必要参数。 处理: 解析结果处理与输出的输入参数,完成核心逻辑,返回结构化响应。 输出: 返回结果处理与输出的响应数据,包含状态码、结果和日志。

• 执行此能力时使用output_format参数,支持导出/保存/转换操作 能力覆盖范围：本skill的核心能力覆盖以下场景关键词：跨云存储服务统一、管理文件的上传、同步与成本核算、支持多、基础操作、面向多云存储场景、的统一文件管理工、AWS、Cloudflare、Backblaze、等对象存储与、Google、等网盘服务、核心能力等。这些关键词对应description中声明的使用场景,均已在上述能力点中提供对应的操作支持。

使用场景

场景1：从S3迁移数据到R2降低出口费（独立开发者角色）

独立开发者希望将S3上的1TB归档数据迁移到Cloudflare R2（零出口费）：

csm transfer \
  --source s3://my-bucket/archive/ \
  --target r2://my-bucket/archive/ \
  --estimate-cost \
  --checkpoint ./transfer-state.json

执行前估算：

• 数据量：1024 GB
• S3出口费：$92.16（$0.09/GB）
• R2存储费：$15.36/月（$0.015/GB）
• API调用费：约$5
• 预计耗时：约3.5小时（按100MB/s带宽）
• 总成本：约$112

场景2：跨Provider备份重要文件（运维工程师角色）

运维工程师需要将关键配置文件同时备份到Azure Blob与Backblaze B2：

csm upload \
  --file ./configs/ \
  --targets azure-blob://backup/configs/,b2://backup/configs/ \
  --compress \
  --encrypt

场景3：从Dropbox下载共享文件夹（个人用户角色）

个人用户从Dropbox共享文件夹下载所有图片到本地：

csm download \
  --source dropbox://shared/photos-2024/ \
  --target ./local-photos/ \
  --filter "*.jpg,*.png" \
  --parallel 4

场景4：Drive与OneDrive单向同步（团队负责人角色）

将团队Drive中的项目文档单向同步到OneDrive作为备份：

csm sync \
  --source gdrive://team-project/docs/ \
  --target onedrive://backup/team-project/ \
  --direction one-way \
  --delete-distant false \
  --schedule "0 2 * * *"

不适用场景

以下场景云存储管理器(免费版)不适合处理：

• 实际人员绩效评估
• 财务预算审批
• 合同法务审核

触发条件

需要项目管理、任务规划、进度跟踪、团队协作时使用。不适用于非本工具能力范围的需求。

使用流程

Step 1：配置Provider凭据

csm config add s3 \
  --access-key $AWS_ACCESS_KEY_ID \
  --secret-key $AWS_SECRET_ACCESS_KEY \
  --region us-east-1
# ...
csm config add r2 \
  --account-id $CLOUDFLARE_ACCOUNT_ID \
  --access-key $R2_ACCESS_KEY \
  --secret-key $R2_SECRET_KEY \
  --endpoint https://<account>.r2.cloudflarestorage.com

凭据存储在~/.csm/credentials/（已chmod 600）。

Step 2：列出所有已配置Provider

csm config list

输出：

Configured providers:
  - s3 (us-east-1)
  - r2 (auto)
  - azure-blob (eastus)

Step 3：执行第一次上传

csm upload \
  --file ./report.pdf \
  --target s3://my-bucket/reports/

输出：

Uploading report.pdf to s3://my-bucket/reports/
  Size: 2.4 MB
  Estimated cost: $0.001 (PUT requests)
  Progress: ████████████████████ 100%
  Uploaded in 1.2s
  Verification: MD5 match ✓

关键规则

规则1：操作前预估成本

任何大文件或批量操作前，使用--estimate-cost预估：

• 出口流量费（egress）
• API调用费（PUT/GET/LIST等）
• 存储费用（按月计算）

规则2：API 200不等于成功

API返回200仅表示请求被接受，必须额外验证：

• 文件大小匹配（Content-Length）
• 校验和匹配（MD5或SHA256）
• 文件可被读取（HEAD请求验证）

规则3：删除前必须验证备份

任何删除操作前：

• 确认备份存在且可恢复
• 备份与源文件校验和一致
• 保留删除审计日志

规则4：处理部分失败

长时间操作可能中途失败：

• 启用--checkpoint保存进度
• 失败时使用--resume恢复
• 已成功项不重复执行（幂等）

已知限制

各家Provider速率限制差异巨大：

• 当前为免费版本,如需完整功能请升级到付费版获取全部能力

跨Provider概念差异映射

示例

凭据配置文件

# ~/.csm/credentials.yaml
providers:
  s3:
    access_key: ${AWS_ACCESS_KEY_ID}
    secret_key: ${AWS_SECRET_ACCESS_KEY}
    region: us-east-1
# ...
  r2:
    account_id: ${CLOUDFLARE_ACCOUNT_ID}
    access_key: ${R2_ACCESS_KEY}
    secret_key: ${R2_SECRET_KEY}
# ...
  azure-blob:
    connection_string: ${AZURE_STORAGE_CONNECTION_STRING}
# ...
  gdrive:
    client_id: ${GDRIVE_CLIENT_ID}
    client_secret: ${GDRIVE_CLIENT_SECRET}
    refresh_token: ${GDRIVE_REFRESH_TOKEN}
# ...
defaults:
  parallel: 4
  chunk_size: 8MB
  retry: 3
  timeout: 300s

同步规则配置

# sync-rules.yaml
rules:
  - name: archive-to-r2
    source: s3://hot-data/
    target: r2://archive/
    schedule: "0 3 * * 0"  # 每周日凌晨3点
    filter: "*.log,*.tar.gz"
    compress: true
    encrypt: true
    delete-after: false  # 源不删除
    notify: feishu

最佳实践

1. 凭据最小权限：每个Provider仅授予必要操作权限（如只读备份场景仅授予GET）
2. 凭据轮换：每90天轮换AccessKey，使用csm config rotate s3
3. 大文件分块：>100MB文件启用分块上传，单块8-16MB
4. 跨区传输避开高峰：跨Region传输避开UTC 14:00-18:00高峰
5. 校验和必检：所有上传下载后验证MD5/SHA256
6. 删除前dry-run：使用--dry-run预览将删除的文件
7. 检查点持久化：长任务务必启用--checkpoint，避免从头重试
8. 限速保护：批量操作启用--rate-limit 100，避免触发Provider限流

常见问题

Q1：跨Region传输为什么这么慢？

A：跨Region带宽受Provider出口限制，建议启用Provider的加速端点（如S3 Transfer Acceleration、Azure ExpressRoute）。

Q2：上传大文件中断后能否续传？

A：可以。启用--checkpoint保存进度，失败后--resume恢复，已上传分块不重复。

Q3：API返回200但文件实际不存在？

A：这是常见陷阱，必须执行HEAD请求验证文件存在与大小匹配。本工具自动执行此验证。

Q4：如何避免账单意外？

A：所有操作前使用--estimate-cost预估，重点关注egress费用（常被忽视）。

Q5：免费版支持多少个Provider同时配置？

A：免费版支持配置多个Provider凭据，但单次操作仅支持单源单目标。

错误处理

依赖说明

运行环境

• Agent平台：支持SKILL.md的任意AI Agent（Claude Code / Cursor / Codex / Gemini CLI等）
• 操作系统：Windows / macOS / Linux
• 网络：可访问目标Provider的API端点

依赖详情

API Key 配置

• AWS凭据：AWS_ACCESS_KEY_ID与AWS_SECRET_ACCESS_KEY环境变量
• Cloudflare R2凭据：CLOUDFLARE_ACCOUNT_ID与R2 AccessKey对
• Azure Blob连接串：AZURE_STORAGE_CONNECTION_STRING
• Google Drive OAuth：GDRIVE_CLIENT_ID/CLIENT_SECRET/REFRESH_TOKEN
• 存储建议：使用~/.csm/credentials/目录统一管理，文件权限600
• 禁止：在Git仓库或脚本中硬编码任何凭据

可用性分类

• 分类：MD+EXEC（Markdown指令驱动+命令行工具执行能力）
• 说明：基于Markdown的AI Skill，通过自然语言指令驱动Agent调用云存储API完成操作

免费版限制

本免费体验版聚焦个人与单源单目标场景，限制以下高级能力：

• ❌ 批量跨云迁移（多源多目标并发）
• ❌ 实时同步与双向冲突解决
• ❌ 跨Provider数据复制策略（如S3→R2→B2三副本）
• ❌ 高级加密与密钥管理服务集成
• ❌ 多用户协作与权限共享
• ❌ 智能分层存储自动分级
• ❌ 自定义压缩与去重
• ❌ 详细成本分析与可视化报告

解锁全部高级能力请使用专业版：cloud-storage-manager-pro