Cloud Manager

云存储管家 专业版

付费版专享能力

核心能力

能力域

针对能力域,自动解析输入参数、调度任务队列、格式化输出,返回结构化响应. 输入: 用户提供能力域相关的配置参数、输入数据和处理选项. 输出: 返回能力域的处理结果。- 验证返回数据的完整性和格式正确性

• 参考能力域的配置文档进行参数调优

多云统一视图

针对多云统一视图,自动解析输入参数、调度任务队列、格式化输出,返回结构化响应. 输入: 用户提供多云统一视图相关的配置参数、输入数据和处理选项. 输出: 返回多云统一视图的处理结果。- 验证返回数据的完整性和格式正确性

• 参考多云统一视图的配置文档进行参数调优

跨盘迁移

针对跨盘,自动解析输入参数、调度任务队列、格式化输出,返回结构化响应. 输入: 用户提供跨盘迁移相关的配置参数、输入数据和处理选项. 输出: 返回跨盘迁移的处理结果。- 验证返回数据的完整性和格式正确性

• 参考跨盘迁移的配置文档进行参数调优

适用场景

场景一：家庭多成员多设备统一管理（家庭管理员角色）

家庭成员分别使用 iPhone（iCloud）和 Android（Google Drive），照片散落在两个云盘。专业版提供多云统一视图：

# 添加云盘账户
cloud-manager account add --provider icloud --email "user@example.com"
cloud-manager account add --provider gdrive --email "user@gmail.com"
# ...
# 查看统一文件视图
cloud-manager files list --all-providers --sort-by date
# ...
# 查看存储用量聚合
cloud-manager storage summary --all-providers

场景二：家庭相册共享与权限控制（家庭管理员角色）

创建家庭相册共享文件夹，为不同成员设置不同权限：

# 创建家庭共享文件夹
cloud-manager share create --name "家庭相册" --type folder
# ...
# 邀请成员并设置权限
cloud-manager share invite --folder "家庭相册" \
  --member "spouse@example.com" --role editor
cloud-manager share invite --folder "家庭相册" \
  --member "child@example.com" --role viewer
# ...
# 查看共享权限矩阵
cloud-manager share matrix --folder "家庭相册"

场景三：小团队文档协作（团队管理员角色）

团队需要共享文档库，并按角色控制权限。专业版提供团队权限模型：

# 创建团队文档库
cloud-manager team create --name "产品文档库" --provider onedrive
# ...
# 批量设置成员权限
cloud-manager team members --library "产品文档库" --file members.csv

场景四：定时自动备份（注重数据安全的用户）

配置每日自动备份规则，无需手动触发：

# 配置每日照片自动备份
cloud-manager backup rule create \
  --source "~/Pictures" \
  --target "gdrive://Photos/$(date +%Y/%m)" \
  --schedule "daily 02:00" \
  --retain 90d
# ...
# 配置文档每周备份
cloud-manager backup rule create \
  --source "~/Documents" \
  --target "onedrive://Backup/Documents" \
  --schedule "weekly sunday 03:00" \
  --retain 12w
# ...
# 查看所有备份规则
cloud-manager backup rule list

场景五：存储用量深度分析（成本优化角色）

云盘存储成本上升，需要识别哪些文件占用空间并进行优化：

# 生成存储分析报表
cloud-manager storage analyze --provider all --format markdown --output report.md
# ...
# 按文件类型分析
cloud-manager storage analyze --group-by type --top 10
# ...
# 识别大文件
cloud-manager storage find --size ">500MB" --older-than "180d"

场景六：跨云盘迁移（更换主云盘的用户）

从 Dropbox 迁移到 OneDrive，专业版提供向导式流程：

# 启动迁移向导
cloud-manager migrate wizard \
  --source dropbox \
  --target onedrive \
  --path "/Work" \
  --strategy "copy-then-verify"
# ...
# 查看迁移进度
cloud-manager migrate status --job-id abc123

使用流程

前置准备（约 60 秒）

1. 确认已安装对应云盘的客户端或可访问网页版
2. 准备好各云盘的账户凭据
3. 配置专业版工作目录：

export CLOUD_MANAGER_HOME="$HOME/.cloud-manager"
export CLOUD_MANAGER_CONFIG="$CLOUD_MANAGER_HOME/config.yaml"

验证专业版能力（约 30 秒）

# 添加优秀个云盘账户
cloud-manager account add --provider gdrive --email "you@gmail.com"
# ...
# 查看存储聚合
cloud-manager storage summary

依赖说明

运行环境

• Agent 平台：支持 SKILL.md 的任意 AI Agent（Claude Code / Cursor / Codex / Gemini CLI 等）
• 操作系统：Windows / macOS / Linux
• Shell：bash 4.0+ 或 PowerShell 5.0+
• 网络：可访问对应云盘服务

第三方依赖

API Key 配置

• 各云盘 OAuth Token：存储于 $CLOUD_MANAGER_HOME/credentials/（已 gitignore）
• 禁止：在 SKILL.md 或脚本中硬编码账户密码或 Token
• 轮换建议：OAuth Token 建议每 90 天重新授权一次

可用性分类

• 分类：MD+EXEC（纯 Markdown 指令，部分功能需要 exec 命令行执行能力）
• 说明：基于 Markdown 的 AI Skill，通过自然语言指令驱动 Agent 调用命令行工具完成任务

API Key配置方式:

export API_KEY="your_api_key_here"

配置后需重启会话或开启新终端生效。API Key应妥善保管,避免泄露到版本控制系统.

输入格式

输出格式

{
  "success": true,
  "data": {
    "overall_grade": "A",
    "total_score": 92,
    "max_score": 100,
    "summary": "处理完成",
    "details": [
      {
        "item": "代码风格",
        "status": "pass",
        "score": 95,
        "comment": "符合规范"
      },
      {
        "item": "安全合规",
        "status": "warn",
        "score": 80,
        "comment": "符合规范"
      }
    ],
    "improvements": [
      {
        "priority": "high",
        "suggestion": "建议优化",
        "expected_gain": "+5分"
      },
      {
        "priority": "medium",
        "suggestion": "建议优化",
        "expected_gain": "+3分"
      }
    ]
  },
  "error": null
}

异常处理

依赖说明(补充)

国内替代方案:

• OpenAI GPT → 智谱GLM-4 / 百度文心一言 / 通义千问 / DeepSeek

案例展示

多云账户配置

在 $CLOUD_MANAGER_HOME/config.yaml 中配置多云账户：

accounts:
  - provider: icloud
    email: user@example.com
    sync_interval: 3600
  - provider: gdrive
    email: user@gmail.com
    sync_interval: 1800
  - provider: onedrive
    email: user@outlook.com
    sync_interval: 3600
  - provider: dropbox
    email: user@dropbox.com
    sync_interval: 3600
# ...
backup:
  default_retain: 90d
  max_concurrent: 3
  checkpoint: true
# ...
sharing:
  default_role: viewer
  expire_default: 30d

家庭共享权限矩阵

团队权限矩阵

定时备份规则

常见问题

Q1：多云账户添加后无法同步？

检查三项：账户凭据是否有效、网络是否可访问对应云盘、sync_interval 是否设置过短（建议至少 1800 秒）.

Q2：家庭共享文件夹的配额怎么算？

共享文件夹的存储配额由所有者账户承担。例如户主创建的家庭相册，存储占用计入户主的 iCloud 配额，不计入子女的配额.

Q3：团队权限矩阵修改后多久生效？

权限变更实时生效。但已登录的成员可能需要重新打开客户端才能看到最新权限。建议变更后通知成员刷新.

Q4：定时备份规则没有按时触发？

检查三项：系统时区是否正确、cloud-manager 守护进程是否运行、调度时间是否与系统休眠冲突。建议备份时间设在设备常开时段.

Q5：跨盘迁移中途失败怎么办？

专业版默认启用检查点。迁移失败后执行 cloud-manager migrate resume --job-id 即可从断点恢复，已迁移的文件不会重复处理.

Q6：存储分析报表显示的占用与云盘官方不一致？

部分云盘将"共享给我的文件"计入我的配额，部分不计入。专业版默认只统计"我拥有的文件"，可通过 --include-shared 参数包含共享文件.

Q7：版本历史清理后能恢复吗？

不能。版本历史清理是物理删除，无法恢复。建议清理前先导出关键版本到本地归档.

Q8：如何识别重复文件？

专业版提供去重命令，基于文件内容哈希识别重复：

cloud-manager dedup find --provider all --min-size "1MB"

去重结果输出到 CSV，确认后可批量删除.

Q9：多个云盘的同一份文件如何同步？

专业版不提供"实时双向同步"（这会带来冲突风险）。建议使用"主从同步"：指定一个云盘为主，其他为从，定期单向同步.

Q10：专业版与免费版可以共存吗？

可以。两个版本 slug 不同，可同时安装。日常单盘操作用免费版，多云管理与自动化用专业版.

错误处理

已知限制

• 依赖云服务，需要网络连接
• 需要有效的云服务凭证和配置好的CLI环境
• 产生的云资源可能产生费用，使用前请确认计费方式
• 不同区域的服务可用性和功能支持可能存在差异