Agent Skills
返回列表
📁

OneDrive Graph 命令行技能

办公效率 更新于 2026.08.30

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

请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/acedatacloud-skills-microsoft-onedrive。

技能介绍

要解决什么问题

在终端或自动化脚本里操作 OneDrive / SharePoint,经常要对着 Microsoft Graph 文档拼 URL、处理 OAuth、分辨文件夹与文件的 JSON 形态,还要避免误删、误覆盖或对外分享。这个技能把常用 Drive 操作整理成可复用的 Recipes,统一用 curl + jq,并假定访问令牌在环境变量 $MICROSOFT_ONEDRIVE_TOKEN 里。

技能如何工作

每次应先调用 /me,确认令牌有效并弄清当前操作的账户与 drive。Graph 返回标准 JSON;失败时把 {"error": {"code", "message"}} 原样展示。

覆盖的典型操作包括:

  • 浏览:根目录与子路径(路径段用 : 分隔,如 :/Documents/Q1:/children)
  • 检索:search(q=...);空查询会 400,可按扩展名如 .pdf 搜类型
  • 元数据:最近修改、与我共享 等列表
  • 下载:按 item id 或路径;大文件走分块 upload session(>4MB)
  • 写入:小文件上传、建文件夹(@microsoft.graph.conflictBehavior:rename / replace / fail)
  • 变更:PATCH 重命名/移动;删除前应先取名称并与用户确认
  • 分享:createLink(type/scope)前必须确认
  • SharePoint:列站点、读站点内文件(需 Sites.Read.All)

查询习惯上 始终带 $select,浏览 $top=10、搜索 $top=25;路径中的 ID 需 URL 编码(可用 jq -sRr @uri)。

边界与注意点

  • 401 InvalidAuthenticationToken:令牌过期,需重装连接器。
  • 403 accessDenied:scope 不足(例如只读令牌却上传),需重装并勾选写入相关 scope。
  • 429:遵循 Retry-After。
  • 404:检查 id/路径大小写。

删除、覆盖、移动、批量操作、对外分享遵循 prepare → present → execute,不得在未确认时执行破坏性动作。

使用场景

  • 在终端列出 OneDrive 根目录并区分文件夹与子文件数量,再决定下一步脚本逻辑
  • 按 `:/Documents/Q1:/children` 路径浏览子目录,用 `$filter` 筛出大于 1MB 的 docx
  • 没有关键词时用 `search(q='.pdf')` 跨文件夹查找 PDF,避免空查询触发 400
  • 上传小于 4MB 的文件到指定路径,并用 `conflictBehavior=rename` 处理同名文件

适合人员

  • 在 CI 或 cron 里用 Graph 列举网盘文件、再同步到内网备份服务器的平台工程师
  • 需从 SharePoint 站点批量核对合同附件路径与大小的采购合规专员
  • 不想开浏览器、却要用令牌在 shell 里上传周报 markdown 的技术写作者
  • 为多租户环境排查 401/403 时要知道是令牌过期还是 scope 不足的集成开发者