技能介绍

为什么需要这个技能

直接调用 Microsoft Graph API 操作 OneDrive，意味着要自己处理 OAuth token 刷新、scope 协商和错误重试这些样板逻辑。团队内部的脚本常常散落着硬编码的 client ID 和过期 token，轮换密钥时只能逐个脚本翻找，审计时也很难说清谁在访问哪个目录。这个技能把凭据托管交给 OOMOL，统一通过 oo CLI 执行，让自动化脚本只回答一个问题：对哪个文件做什么。

核心能力

技能封装了 13 个 action，覆盖日常文件管理的完整链路：

文件传输：upload_file 上传单个文件（可选自动创建父目录），download_file 与 download_file_by_path 按 ID 或路径取回文件并放入中转存储，download_item_as_format 先转换成 Microsoft Graph 支持的格式再下载。
元数据操作：get_drive、get_root、get_item 查询驱动器或条目的元数据，update_item_metadata 完成重命名、移动或属性更新，update_file_content 直接替换已有文件的内容。
目录与搜索：create_folder 创建目录，list_folder_children 列出直接子项，search_items 按关键词搜索文件和文件夹。
生命周期：delete_item 把条目移入回收站而非物理删除，留出后悔窗口。

调用方式

所有 action 都通过 oo CLI 执行，凭据由 OOMOL 在服务端注入，本地脚本和 CI 环境都不会接触原始 token。执行任何 action 前，先用 oo connector schema 拉取实时的输入输出契约，确认字段名、类型和必填项，再据此构造 --data 参数。响应统一为 { "data": ..., "meta": { "executionId": "..." } }，执行 ID 位于 meta.executionId 下，便于排查和审计。

安全边界与适用场景

读取类 action（get / list / search）是幂等的，可以直接执行。写入、更新、上传类 action 会改变 OneDrive 状态，执行前需要与用户确认 payload 和预期效果；delete_item 属于破坏性操作，必须锁定目标路径并获得显式批准后才能执行。这个技能适合批量整理文档库、同步构建产物到云盘、自动生成报告并上传这类场景；不适合需要细粒度权限代理或跨 tenant 联合访问的需求，这类场景仍要在 OOMOL 应用侧配置对应的 OAuth scope。