前言¶

给 Agent 接网盘时，常见做法是自己写一套对接脚本：调接口、处理鉴权、轮询离线下载任务、转封装直链。这类代码不难，但边界多，容易在分享校验、图床防盗链、视频转码状态上反复改。下面介绍的 Skill 把这些操作收敛成一份声明，让 Agent 直接按能力清单调用。

这是什么¶

123云盘 是一个 community 来源的 Agent Skill，坐标 @user_6a4e0140/123yunpan，发布者 user_6a4e0140，当前版本 1.3.0，在 SkillHub 上分类为 ai-agent。

它解决的问题是：把 123 云盘的开放 API 操作暴露为 Agent 可调用的能力，避免在每个项目里重复实现上传、分享、离线下载这类逻辑。标签显示 requires_api_key=true，说明调用前需要先准备好 API key。

核心功能¶

按官方简介，覆盖的能力包括：

1. 文件管理：查看、整理云盘内的文件与目录。
2. 上传与下载：本地文件与云盘之间的双向传输。
3. 分享：生成分享链接。
4. 离线下载：提交离线下载任务并查询状态。
5. 直链：获取可直接访问的文件地址。
6. 图床：把图片托管到云盘并提供访问地址。
7. 视频转码：提交或查询视频转码任务。

安装与启用¶

官方地址：https://api.skillhub.cn/user_6a4e0140/123yunpan
SkillHub 页面：https://www.skillhub.cn/skills/user_6a4e0140/123yunpan

本次编写时无法抓取到上述页面正文，因此安装命令、目录位置、配置字段名均未能核实。可确认的信息如下：

坐标:   @user_6a4e0140/123yunpan
版本:   1.3.0
来源:   community
分类:   ai-agent
标签:   requires_api_key=true

启用前先准备好 123 云盘开放 API 的 key，具体申请入口和字段名请以官方页面为准。该 Skill 基于通用 SKILL.md 格式，具体支持的客户端（Cursor / Codex CLI / Claude Code）差异本次未能核实，不在此推测。

典型用法¶

官方页面未能抓取到可复现的调用示例，这里只给出与能力清单对应的调用方向，具体参数名请对照官方文档：

1. 列目录 → 走文件管理能力，先定位目录再列出条目。
2. 上传 → 先取本地文件路径，再提交上传请求，拿到云盘内文件标识。
3. 分享 → 用文件标识生成分享链接，注意有效期与提取方式。
4. 离线下载 → 提交任务后轮询状态，成功后再取直链。
5. 图床 → 上传图片后取直链，注意防盗链与路径拼接。
6. 视频转码 → 提交任务，按返回状态等待完成。

适用场景与注意¶

适合：需要让 Agent 在对话或任务流里直接操作 123 云盘，且希望少写对接代码的场景。

注意：

1. 需要 API key，凭证不要写进代码仓库或提交到日志。
2. 离线下载和视频转码是异步任务，调用方要能处理轮询和超时。
3. 直链和图床地址的可用性受 123 云盘策略影响，重要场景建议先验证可访问性。
4. 本次未能核实的安装与配置细节，请以官方页面为准，不要照搬本文猜测。

结尾¶

123云盘 Skill 的价值在于把 123 云盘开放 API 的常用操作收进一份声明，让 Agent 直接使用，不必每个项目重写对接代码。需要核对安装方式与配置字段时，从官方地址入手：https://api.skillhub.cn/user_6a4e0140/123yunpan