技能介绍

解决的问题

123云盘开放平台的接口覆盖认证、文件、分享、离线、直链与转码，直接调用时容易遇到 token 过期、code/data 解析、file_id 分页和分享链接拼接等问题。该技能用 scripts/123yunpan.py 将这些流程封装为稳定 CLI，方便 AI Agent 或脚本执行云盘操作。

如何工作

首次使用需要 client_id 与 client_secret，可写入配置；CLI 在 401 时刷新 access_token。常用命令包括 file list、file search、upload、download、share create 和 offline download，--json 输出单行 JSON。

核心能力包括：

文件管理：列表、详情、搜索、建目录、重命名、移动、复制、删除与恢复；
上传下载：V1/V2 上传、秒传复用、批量下载，支持逗号或空格分隔的 file_id；
分享与直链：创建分享、导出记录、生成完整直链和短直链；
离线与转码：离线下载、视频转码、M3U8/文件下载；
递归遍历：对多级目录做 BFS 遍历，适合查找所有文件。

注意边界

它更适合已有云盘凭证的自动化场景。深目录遍历可能产生大量 API 调用；删除前必须展示文件列表并确认；分享超过 20 个文件时通常导出 Excel。share create 只返回 shareID 与 shareKey，链接需拼接；短直链要求文件夹已开启直链。file tree 适合展示，批量操作仍应使用带 file_id 的列表或搜索结果。