SKILL.md — 腾讯微云管理 Skills 定义

使用方法：本文档定义了所有可用的腾讯微云管理 Skills。AI Agent 或开发者可根据此文档调用 Python 脚本完成云存储操作。

认证方式（二选一）：

# Method 1: QR code login (recommended)
python weiyun_skills/login.py --method qrcode

# Method 2: Copy cookies from browser
python weiyun_skills/login.py --method cookies --cookies "uin=o012345678; skey=@abcdef1234; ..."

调用方式：

# CLI
python weiyun_skills/main.py <command> [args] [options]

# Python SDK
from weiyun_skills.client import WeiyunClient
client = WeiyunClient()
client.<skill_name>(**params)

统一返回格式：

{ "success": true, "data": { ... }, "message": "ok" }

---

目录

• SKILL.md — 腾讯微云管理 Skills 定义
  • 目录
  • 1. 认证 Skills
    • 1.1 qrcode_login — 扫码登录
    • 1.2 cookies_login — Cookies 登录
  • 2. 文件管理 Skills
    • 2.1 list_files — 列出文件
    • 2.2 upload_file — 上传文件
    • 2.3 upload_folder — 上传文件夹
    • 2.4 download_file — 下载文件
    • 2.5 download_folder — 下载文件夹
    • 2.6 delete_file — 删除文件
    • 2.7 move_file — 移动文件
    • 2.8 copy_file — 复制文件
    • 2.9 rename_file — 重命名
    • 2.10 create_folder — 创建文件夹
    • 2.11 search_files — 搜索文件
  • 3. 分享管理 Skills
    • 3.1 create_share — 创建分享
    • 3.2 cancel_share — 取消分享
    • 3.3 list_shares — 列出分享
  • 4. 空间管理 Skills
    • 4.1 get_space_info — 空间信息
    • 4.2 get_recycle_bin — 回收站
    • 4.3 restore_file — 恢复文件
    • 4.4 clear_recycle_bin — 清空回收站
  • 附录 A：统一错误码
  • 附录 B：Cookies 关键字段说明

---

1. 认证 Skills

1.1 qrcode_login — 扫码登录

描述：生成腾讯微云登录二维码，用户使用微信/QQ 扫码完成认证。登录成功后自动保存 Cookies 到cookies.json。

CLI：

python weiyun_skills/login.py --method qrcode

Python：

from weiyun_skills.login import qrcode_login

cookies = qrcode_login()
# Terminal will display QR code, scan with WeChat/QQ
# After success, cookies are saved to cookies.json

输入参数参数名

类型	必填	默认值	说明	save_path
字符串	❌	cookies.json	Cookies 保存路径	输出参数

：参数名

类型	说明	success
布尔型	是否登录成功	uin
字符串	用户 UIN	nickname
字符串	用户昵称	cookies_str
字符串	Cookies 字符串	Cookies 字符串
保存路径	字符串	Cookies 保存路径

流程：

┌─────────────┐     ┌──────────────┐     ┌─────────────┐
│ Request QR  │────▶│ Display QR   │────▶│ User scans  │
│ code URL    │     │ in terminal  │     │ with WeChat  │
└─────────────┘     └──────────────┘     └──────┬──────┘
                                                 │
┌─────────────┐     ┌──────────────┐             │
│ Save to     │◀────│ Get cookies  │◀────────────┘
│ cookies.json│     │ from server  │
└─────────────┘     └──────────────┘

---

1.2 cookies_login — Cookies 登录

描述：使用从浏览器复制的 Cookies 字符串完成登录认证。

命令行界面：

python weiyun_skills/login.py --method cookies --cookies "uin=o012345678; skey=@abcdef1234; p_uin=o012345678; pt4_token=xxxxx; p_skey=xxxxx"

Python：

from weiyun_skills.login import cookies_login

cookies = cookies_login(
    cookies_str="uin=o012345678; skey=@abcdef1234; ..."
)

如何获取 Cookies：

1. 打开浏览器访问https://www.weiyun.com/并登录
2. 按F12打开开发者工具
3. 切换到Network（网络）标签页
4. 刷新页面，点击任意一个请求
5. 在Headers（请求头）中找到Cookie字段
6. 复制完整的 Cookie 值

输入参数：

参数名	类型	必填	默认值	说明
cookies_str	string	✅	-	从浏览器复制的 Cookie 字符串
save_path	string	❌	cookies.json	Cookies 保存路径

输出参数：

参数名	类型	说明
success	boolean	是否验证成功
uin	string	用户 UIN
昵称	字符串	用户昵称
保存路径	字符串	Cookies 保存路径

---

2. 文件管理技能

2.1 list_files — 列出文件

描述：列出微云指定目录下的所有文件和文件夹。

CLI：

python weiyun_skills/main.py list /
python weiyun_skills/main.py list /我的文档 --sort size --order desc

Python：

files = client.list_files("/我的文档", sort_by="size", sort_order="desc")

输入参数：

参数名	类型	必填	默认值	说明
remote_path	字符串	❌	/	目录路径，默认根目录
排序依据	字符串	❌	名称	排序字段：名称/大小/时间
排序顺序	字符串	❌	升序	排序方向：升序/降序
页码	整数	❌	1	分页页码
每页大小	整数	❌	100	每页数量

输出参数：

参数名	类型	说明
files	array	文件列表
files[].file_id	string	文件唯一 ID
files[].name	string	文件名
files[].type	string	file或folder
files[].size	integer	大小（字节）
files[].size_str	string	可读大小（如2.5 MB）
files[].path	string	完整路径
files[].updated_at	字符串	最后修改时间
total	整数	总数量

示例输出：

{
  "success": true,
  "data": {
    "files": [
      {
        "file_id": "f_abc123",
        "name": "report.pdf",
        "type": "file",
        "size": 2621440,
        "size_str": "2.5 MB",
        "path": "/我的文档/report.pdf",
        "updated_at": "2026-03-15 10:30:00"
      },
      {
        "file_id": "d_folder01",
        "name": "照片",
        "type": "folder",
        "size": 0,
        "size_str": "-",
        "path": "/我的文档/照片",
        "updated_at": "2026-03-14 08:00:00"
      }
    ],
    "total": 2
  },
  "message": "ok"
}

---

2.2 upload_file — 上传文件

描述：将本地文件上传到微云指定目录。支持大文件分片上传。

CLI：

python weiyun_skills/main.py upload ./report.pdf /我的文档/
python weiyun_skills/main.py upload ./big_video.mp4 /视频/ --overwrite

Python：

result = client.upload_file("./report.pdf", "/我的文档/report.pdf", overwrite=True)

输入参数：

参数名	类型	必填	默认值	说明
local_path	字符串	✅	-	本地文件路径
remote_path	字符串	✅	-	微云目标路径
覆盖	布尔值	❌	假	是否覆盖同名文件

输出参数：

参数名	类型	说明
file_id	字符串	上传后的文件 ID
name	字符串	文件名
size	整数	文件大小
remote_path	字符串	云端路径
md5	字符串	文件 MD5
uploaded_at	string	上传时间

---

2.3 upload_folder — 上传文件夹

描述：将本地文件夹递归上传到微云，自动创建对应的目录结构。跳过隐藏文件和__pycache__等缓存目录。

CLI：

# Upload folder to Weiyun root
python weiyun_skills/main.py upload-folder ./my_docs/

# Upload folder to a specific remote directory
python weiyun_skills/main.py upload-folder ./my_docs/ /目标文件夹/

# Overwrite existing files
python weiyun_skills/main.py upload-folder ./my_docs/ / --overwrite

Python：

# Upload to root
result = client.upload_folder("./my_docs/")

# Upload to a specific folder, overwrite existing
result = client.upload_folder("./my_docs/", remote_path="/目标文件夹/", overwrite=True)

输入参数：

参数名	类型	必填	默认值	说明
local_path	string	✅	-	本地文件夹路径
remote_path	string	❌	/	微云目标路径（/表示根目录）
overwrite	boolean	❌	false	是否覆盖同名文件

输出参数：

参数名	类型	说明
folder_name	string	上传的文件夹名称
uploaded_files	array	成功上传的文件列表
uploaded_files[].name	string	文件名
uploaded_files[].size	integer	文件大小（字节）
uploaded_files[].size_str	string	可读大小
uploaded_files[].instant_upload	boolean	是否秒传
failed_files	array	上传失败的文件列表
failed_files[].name	string	文件名
failed_files[].error	string	错误信息
uploaded_count	integer	成功上传数量
failed_count	integer	失败数量
total_size_str	string	总上传大小
elapsed	float	上传耗时（秒）

示例输出：

{
  "success": true,
  "data": {
    "folder_name": "upload_file",
    "uploaded_files": [
      {
        "name": "abc.txt",
        "size": 6,
        "size_str": "6.00 B",
        "instant_upload": false
      }
    ],
    "failed_files": [],
    "uploaded_count": 1,
    "failed_count": 0,
    "total_size_str": "6.00 B",
    "elapsed": 2.35
  },
  "message": "ok"
}

---

2.4 download_file — 下载文件

描述：从微云下载文件到本地。

CLI：

python weiyun_skills/main.py download /我的文档/report.pdf ./downloads/
python weiyun_skills/main.py download /我的文档/report.pdf ./downloads/ --overwrite

Python：

result = client.download_file("/我的文档/report.pdf", "./downloads/report.pdf")

输入参数：

参数名	类型	必填	默认值	说明
remote_path	string	✅	-	微云文件路径
local_path	string	✅	-	本地保存路径
overwrite	boolean	❌	false	是否覆盖本地文件

输出参数 参数名

类型	说明	local_path
string	本地保存路径	size
integer	文件大小	md5
string	MD5 校验值	elapsed
float	下载耗时（秒）	2.5 download_folder — 下载文件夹

---

描述

：从微云下载整个文件夹到本地。支持两种模式：递归下载（保留目录结构）和打包下载（下载为 zip 文件）。CLI

：Python

# Recursive download (preserves folder structure)
python weiyun_skills/main.py download-folder QQ ./downloads/
python weiyun_skills/main.py download-folder QQ ./downloads/ --overwrite

# Download as zip
python weiyun_skills/main.py download-folder QQ ./downloads/ --zip

：输入参数

# Recursive download
result = client.download_folder("QQ", "./downloads/")

# Download as zip
result = client.download_folder("QQ", "./downloads/", as_zip=True)

：参数名

类型	必填	必填	默认值	说明
folder_name	string	✅	-	微云上的文件夹名称
local_path	string	✅	-	本地保存目录（或 zip 文件路径）
overwrite	boolean	❌	false	是否覆盖已存在的本地文件
as_zip	boolean	❌	false	是否打包为 zip 下载

输出参数（递归模式）：

参数名	类型	说明
folder_name	字符串	文件夹名称
local_path	字符串	本地保存路径
downloaded_files	数组	成功下载的文件列表
downloaded_files[].name	字符串	文件名
downloaded_files[].local_path	字符串	本地路径
downloaded_files[].size	整数	文件大小（字节）
downloaded_files[].size_str	字符串	可读大小
failed_files	数组	下载失败的文件列表
failed_files[].name	字符串	文件名
failed_files[].error	字符串	错误信息
downloaded_count	整数	成功下载数量
failed_count	整数	失败数量
total_size_str	字符串	总下载大小
elapsed	浮点数	下载耗时（秒）

输出参数（zip 模式）：

参数名	类型	说明
local_path	字符串	zip 文件本地路径
size	整数	文件大小（字节）
size_str	字符串	可读大小
md5	字符串	MD5 校验值
耗时	浮点数	下载耗时（秒）

示例输出（递归模式）：

{
  "success": true,
  "data": {
    "folder_name": "QQ",
    "local_path": "./downloads/QQ",
    "downloaded_files": [
      {
        "name": "report.pdf",
        "local_path": "./downloads/QQ/report.pdf",
        "size": 8663503,
        "size_str": "8.26 MB"
      }
    ],
    "failed_files": [],
    "downloaded_count": 6,
    "failed_count": 0,
    "total_size_str": "33.11 MB",
    "elapsed": 5.88
  },
  "message": "ok"
}

---

2.6 delete_file — 删除文件

描述：删除微云文件或文件夹（移入回收站）。

CLI：

python weiyun_skills/main.py delete /我的文档/old_file.pdf
python weiyun_skills/main.py delete /我的文档/old_file.pdf --permanent

Python：

result = client.delete_file("/我的文档/old_file.pdf", permanent=False)

输入参数：

参数名	类型	必填	默认值	说明
remote_path	字符串	✅	-	文件/文件夹路径
永久删除	布尔型	❌	false	是否永久删除（跳过回收站）

输出参数：

参数名	类型	说明
deleted_path	字符串	已删除的路径
is_permanent	布尔型	是否永久删除
deleted_at	字符串	删除时间

---

2.7 move_file — 移动文件

描述：将文件或文件夹移动到另一个目录。

CLI：

python weiyun_skills/main.py move /我的文档/report.pdf /归档/2026/

Python：

result = client.move_file("/我的文档/report.pdf", "/归档/2026/")

输入参数：

参数名	类型	必填	默认值	说明
source_path	字符串	✅	-	源路径
target_path	字符串	✅	-	目标目录路径

输出参数：

参数名	类型	说明
source_path	字符串	原路径
target_path	字符串	新路径

---

2.8 copy_file — 复制文件

描述：复制文件或文件夹到另一个目录。

CLI：

python weiyun_skills/main.py copy /我的文档/report.pdf /备份/

Python：

result = client.copy_file("/我的文档/report.pdf", "/备份/")

输入参数：

参数名	类型	必填	默认值	说明
source_path	string	✅	-	源路径
target_path	string	✅	-	目标目录路径

输出参数：

参数名	类型	说明
source_path	string	源路径
target_path	字符串	副本路径
新文件ID	字符串	副本文件ID

---

2.9 rename_file — 重命名

描述：重命名文件或文件夹。

CLI：

python weiyun_skills/main.py rename /我的文档/report.pdf "年度报告.pdf"

Python：

result = client.rename_file("/我的文档/report.pdf", "年度报告.pdf")

输入参数：

参数名	类型	必填	默认值	说明
remote_path	字符串	✅	-	文件当前路径
new_name	字符串	✅	-	新文件名

输出参数：

参数名	类型	说明
old_path	string	原路径
new_path	string	新路径

---

2.10 create_folder — 创建文件夹

描述：在微云上创建文件夹，支持递归创建多级目录。

CLI：

python weiyun_skills/main.py mkdir /工作/2026/Q1/报告

Python：

result = client.create_folder("/工作/2026/Q1/报告")

输入参数：

参数名	类型	必填	默认值	说明
remote_path	string	✅	-	文件夹路径

输出参数：

参数名	类型	说明
folder_id	string	文件夹 ID
path	string	完整路径
created_at	string	创建时间

---

2.11 search_files — 搜索文件

描述：按关键词搜索微云中的文件。

CLI：

python weiyun_skills/main.py search "报告"
python weiyun_skills/main.py search "报告" --type document

Python：

results = client.search_files("报告", file_type="document")

输入参数：

参数名	类型	必填	默认值	说明
关键词	字符串	✅	-	搜索关键词
文件类型	字符串	❌	全部	类型过滤：全部/文档/图片/视频/音频
页码	整数	❌	1	分页页码
每页大小	整数	❌	50	每页数量

输出参数：

参数名	类型	说明
results	array	搜索结果列表
results[].file_id	string	文件 ID
results[].name	string	文件名
results[].type	string	类型
results[].size_str	string	可读大小
results[].path	string	路径
total	integer	匹配总数

---

3. 分享管理 Skills

3.1 create_share — 创建分享

描述：为文件或文件夹创建分享链接，支持设置密码和有效期。

CLI：

python weiyun_skills/main.py share /我的文档/report.pdf
python weiyun_skills/main.py share /我的文档/report.pdf --expire 7 --password abc1

Python：

share = client.create_share(
    "/我的文档/report.pdf",
    expire_days=7,
    password="abc1"
)
print(share["share_url"])

输入参数：

参数名	类型	必填	默认值	说明
remote_path	string	✅	-	文件/文件夹路径
password	string	❌	null	分享密码（4 位）
expire_days	integer	❌	0	有效天数，0 为永久

输出参数参数名

类型	说明	share_id
string	分享 ID	share_url
string	分享链接	password
string	分享密码	expire_at
string	过期时间	created_at
string	创建时间	示例输出

：3.2 cancel_share — 取消分享

{
  "success": true,
  "data": {
    "share_id": "s_abc123",
    "share_url": "https://share.weiyun.com/xxxx",
    "password": "abc1",
    "expire_at": "2026-03-22 21:00:00",
    "created_at": "2026-03-15 21:00:00"
  },
  "message": "ok"
}

---

描述

：取消已创建的分享链接。CLI

：Python

python weiyun_skills/main.py unshare s_abc123

：：

result = client.cancel_share("s_abc123")

输入参数：

参数名	类型	必填	默认值	说明
share_id	string	✅	-	分享 ID

输出参数：

参数名	类型	说明
share_id	string	已取消的分享 ID
cancelled_at	string	取消时间

---

3.3 list_shares — 列出分享

描述：列出当前用户所有的分享链接。

CLI：

python weiyun_skills/main.py shares
python weiyun_skills/main.py shares --status active

Python输入参数

shares = client.list_shares(status="active")

：参数名

类型	必填	默认值	说明	status
字符串	❌	all	状态过滤：	all/active/expiredpage
整数	❌	1	分页页码	page_size
整数	❌	20	每页数量	输出参数

输出参数参数名

类型	说明	shares
array	分享列表	shares[].share_id
string	分享 ID	shares[].share_url
string	分享链接	shares[].file_name
string	文件名	shares[].status
string	状态	shares[].view_count
integer	查看次数	shares[].download_count
integer	下载次数	shares[].created_at
string	string	创建时间
shares[].expire_at	string	过期时间
total	integer	总数量

---

4. 空间管理 技能

4.1 get_space_info — 空间信息

描述：获取微云存储空间使用情况。

CLI：

python weiyun_skills/main.py space

Python：

info = client.get_space_info()
print(f"Used: {info['used_space_str']} / {info['total_space_str']}")

输入参数：无

输出参数：

参数名	类型	说明
total_space	integer	总空间（字节）
total_space_str	string	可读总空间（如10 GB）
used_space	integer	已用空间（字节）
used_space_str	string	可读已用空间
free_space	integer	剩余空间（字节）
free_space_str	string	可读剩余空间
usage_percent	float	使用百分比
file_count	integer	文件总数
folder_count	integer	文件夹总数

示例输出：

{
  "success": true,
  "data": {
    "total_space": 10737418240,
    "total_space_str": "10.00 GB",
    "used_space": 5368709120,
    "used_space_str": "5.00 GB",
    "free_space": 5368709120,
    "free_space_str": "5.00 GB",
    "usage_percent": 50.0,
    "file_count": 1234,
    "folder_count": 56
  },
  "message": "ok"
}

---

4.2 get_recycle_bin — 回收站

描述获取回收站中的文件列表。

CLI：

python weiyun_skills/main.py recycle

Python：

items = client.get_recycle_bin()

输入参数：

参数名	类型	必填	默认值	说明
page	integer	❌	1	分页页码
page_size	integer	❌	50	每页数量

输出参数：

参数名	类型	说明
files	array	回收站文件列表
files[].file_id	字符串	文件 ID
files[].name	字符串	文件名
files[].size_str	字符串	可读大小
files[].original_path	字符串	原始路径
files[].deleted_at	字符串	删除时间
total	整数	总数量
total_size_str	字符串	回收站总大小

---

4.3 restore_file — 恢复文件

描述：从回收站恢复文件到原始位置。

命令行界面：

python weiyun_skills/main.py restore f_del001

Python：

result = client.restore_file("f_del001")

输入参数：

参数名	类型	必填	默认值	说明
file_id	string	✅	-	回收站中的文件 ID

输出参数：

参数名	类型	说明
file_id	string	文件 ID
restored_path	string	恢复后路径
restored_at	string	恢复时间

---

4.4 clear_recycle_bin — 清空回收站

描述：清空回收站，永久删除所有回收站文件。⚠️ 此操作不可逆！

CLI：

python weiyun_skills/main.py clear-recycle --confirm

Python：

result = client.clear_recycle_bin(confirm=True)

输入参数：

参数名	类型	必填	默认值	说明
confirm	boolean	✅	-	必须为true才执行

输出参数：

参数名	类型	说明
deleted_count	integer	删除文件数
freed_space_str	string	释放的空间大小
cleared_at	string	清空时间

---

附录 A：统一错误码

错误码	说明
AUTH_EXPIRED	Cookies 已过期，需重新登录
AUTH_FAILED	认证失败
FILE_NOT_FOUND	文件不存在
FOLDER_NOT_FOUND	文件夹不存在
SPACE_FULL	空间已满
FILE_TOO_LARGE	文件过大
DUPLICATE_NAME	名称重复
PERMISSION_DENIED	权限不足
RATE_LIMITED	请求频率超限
NETWORK_ERROR	网络错误
SHARE_EXPIRED	分享已过期
INVALID_PARAM	参数无效
QR_EXPIRED	二维码已过期，需刷新
QR_CANCELLED	用户取消了扫码

错误响应格式：

{
  "success": false,
  "data": null,
  "message": "Cookies expired, please re-login",
  "error_code": "AUTH_EXPIRED"
}

---

附录 B：Cookies 关键字段说明

Cookie 名称	说明
uin	用户 QQ 号标识
skey	会话密钥
p_uin	加密的用户标识
p_skey	加密的会话密钥
pt4_token	PT4 认证 Token
pt2gguin	辅助认证字段

提示：并非所有 Cookie 字段都是必需的，核心字段为uin、skey、p_skey。

部分文章来自各大搜索引擎，如有侵权，请与我联系删除。