Agent Skills
返回列表
💻

Dropbox 文件管理

开发编程 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/sundial-org-awesome-openclaw-skills-dropbox。

技能介绍

要解决什么问题

在 Agent 或 IDE 里做自动化时,经常需要读写 Dropbox 里的文件:列目录、搜文件名或正文、上传下载、删到回收站、读 UTF-8 文本。直接调 REST API 要自己管 OAuth、token 刷新和限流。本技能用 MCP 服务 和 CLI 封装这些能力,底层是 Swift + SwiftyDropbox,认证走 OAuth 2.0 PKCE,token 优先存 macOS Keychain。

核心能力与工作方式

启动 MCP 后,可通过工具完成:

  • list_directory:指定路径(默认 /)列文件与文件夹
  • search:按名称或内容搜索,可限定 path
  • upload / download:本地与云端路径需为绝对路径;upload 可选 overwrite
  • delete:删除路径对应项(进垃圾箱)
  • read_file:仅支持 UTF-8 文本
  • get_account_info:账户名与邮箱

认证推荐交互式 OAuth 登录:生成 PKCE、打开授权 URL、粘贴 code 换 access/refresh token,并自动刷新。Keychain 不可用时回退 ~/.dropbook/auth.json。大批量备份、同步建议文档中提到的 rclone,与 MCP 的分工是:代理式单文件操作用 MCP,海量传输用 rclone。

边界与注意点

  • 环境变量手填 token 的 legacy 方式不支持自动刷新,生产环境应走 OAuth。
  • API 有严格 rate limit,too_many_requests 时需退避;bulk 操作前先用 list_directory 校验路径。
  • read_file 只适合文本,不适合二进制或大文件场景;大文件应用 download 到本地再处理。
  • MCP 配置依赖项目 .mcp.json 与 Claude Code/Desktop 侧设置;常见错误见文档表(如 notConfigured、itemNotFound 需先 make login)。

使用场景

  • Claude 项目里要让 Agent 在 `/Projects/2024` 下列出文件再决定读哪一个
  • 自动化流水线把本地构建产物上传到 Dropbox 固定 `remotePath` 并可选覆盖
  • 在对话中按关键词搜索 Dropbox 全文,定位含某配置片段的 markdown
  • 需要删除误传的共享目录子路径,且要求走垃圾箱而非本地假删

适合人员

  • 维护多环境配置、要把密钥类文本从 Dropbox 只读拉进 Agent 上下文的 SRE
  • 用 Claude Code 做项目自动化、需在会话内 upload/download 而不想写 Python Dropbox SDK 的工程师
  • 在 macOS 上跑 MCP、希望 token 进 Keychain 并自动刷新的个人开发者
  • 定期把网盘目录备份到 NAS/Time Capsule、会按文档用 rclone 配合本技能做大批量同步的运维