前言¶

給 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