Dropbox文件管理

技能简介

该技能通过MCP服务器和CLI命令管理Dropbox文件，采用Swift原生实现，集成SwiftyDropbox SDK，支持OAuth 2.0 PKCE认证流程，并将令牌安全存储于macOS Keychain。

能做什么

• 列出、搜索、上传、下载、删除Dropbox文件
• 读取云端文本文件内容
• 获取账户信息（名称、邮箱）
• 通过MCP工具或CLI命令操作

使用说明

1. 安装依赖

brew install rclone

2. 克隆并构建项目

git clone https://github.com/RyanLisse/Dropbook.git
cd Dropbook
make build

3. OAuth登录（推荐）

export DROPBOX_APP_KEY="your_key"
export DROPBOX_APP_SECRET="your_secret"
make login

此流程生成PKCE验证器，打开授权URL，交换令牌后存入Keychain，支持自动刷新。

4. 启动MCP服务器

make mcp

5. CLI命令示例

make list                           # 列出根目录
swift run dropbook search "关键词"   # 搜索文件
swift run dropbook upload /本地路径 /远程路径
swift run dropbook download /远程路径 /本地路径

输入与输出

见下方输入与输出表格。

风险提示

• 需妥善保管DROPBOX_APP_KEY和APP_SECRET，避免泄露
• 环境变量方式存储的令牌不支持自动刷新，建议生产环境使用OAuth登录
• 删除操作会将文件移入回收站，非永久删除
• read_file仅支持UTF-8编码的文本文件

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/ryanlisse/dropbox/SKILL.md
来源类型：GitHub仓库