核心用法
OneDrive Skill 是 Maton 平台提供的 Microsoft Graph API 代理服务，通过单一的 MATON_API_KEY 即可调用完整的 OneDrive 功能。用户需先在 ctrl.maton.ai 完成 OAuth 授权建立连接，随后即可通过 gateway.maton.ai 代理端点执行操作。
该 Skill 支持完整的 CRUD 操作：浏览驱动器和文件夹结构、按 ID 或路径获取文件、创建文件夹、上传下载文件（含 4MB+ 大文件分块上传）、重命名/移动/复制/删除项目。路径寻址采用 :path: 语法，如 /root:/Documents/report.pdf。分享功能支持生成匿名/组织内链接，也可邀请特定用户并设置读写权限。
显著优点
1. 零 OAuth 维护：Maton 托管令牌刷新，用户只需关心业务逻辑
2. 标准 Microsoft Graph：完整兼容官方 API，文档丰富，生态成熟
3. 多连接管理：支持多 OneDrive 账户，通过 Maton-Connection 头切换
4. 预认证下载 URL：@microsoft.graph.downloadUrl 可直接分发，无需二次鉴权
5. OData 查询支持：$select、$filter、$orderby 等参数灵活取数
潜在局限
- 单点依赖：Maton 网关故障将完全中断服务
- 隐私合规：文件流经第三方代理，敏感数据需谨慎评估
- 速率限制：受 Microsoft Graph 限速约束（429 错误需退避重试）
- 无原生 SDK：需自行封装 HTTP 调用，无官方客户端库
适合人群
- 需要自动化 OneDrive 文件流转的开发者/运维团队
- 构建文档管理、备份同步、协作工具的 SaaS 产品
- 希望快速集成微软云存储而无需维护 OAuth 复杂度的中小团队
常规风险
| 风险类型 | 说明 |
|---------|------|
| 凭证泄露 | `MATON_API_KEY` 泄露可导致账户被滥用，需严格保管 |
| 权限过度 | OAuth 授权时可能授予过多范围，应按最小权限原则配置 |
| 数据残留 | 删除 Skill 连接后，Maton 侧可能保留元数据日志 |
| 分享失控 | 匿名链接一旦外泄难以追踪，重要文件建议用邀请制分享 |
建议：生产环境启用连接审计日志，定期轮换 API Key，敏感文件采用端到端加密后上传。