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)
> 
统一返回格式：
CODEBLOCK2

- 目录 - 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：

CODEBLOCK3

Python：

CODEBLOCK4

输入参数：

参数名	类型	必填	默认值	说明
INLINECODE1	INLINECODE2	❌	INLINECODE3	Cookies 保存路径

输出参数：

参数名	类型	说明
INLINECODE4	INLINECODE5	是否登录成功
INLINECODE6

流程：

CODEBLOCK5

1.2 cookies_login — Cookies 登录

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

CLI：

CODEBLOCK6

Python：

CODEBLOCK7

如何获取 Cookies：

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

输入参数：

参数名	类型	必填	默认值	说明
INLINECODE18	INLINECODE19	✅	-	从浏览器复制的 Cookie 字符串
INLINECODE20

string | ❌ | cookies.json | Cookies 保存路径 |

输出参数：

参数名	类型	说明
INLINECODE23	INLINECODE24	是否验证成功
INLINECODE25

2. 文件管理 Skills

2.1 list_files — 列出文件

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

CLI：

CODEBLOCK8

Python：

CODEBLOCK9

输入参数：

参数名	类型	必填	默认值	说明
INLINECODE31	INLINECODE32	❌	INLINECODE33	目录路径，默认根目录
INLINECODE34

输出参数：

参数名	类型	说明
INLINECODE51	INLINECODE52	文件列表
INLINECODE53

示例输出：

CODEBLOCK10

2.2 upload_file — 上传文件

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

CLI：

CODEBLOCK11

Python：

CODEBLOCK12

输入参数：

参数名	类型	必填	默认值	说明
INLINECODE72	INLINECODE73	✅	-	本地文件路径
INLINECODE74

输出参数：

参数名	类型	说明
INLINECODE79	INLINECODE80	上传后的文件 ID
INLINECODE81

2.3 upload_folder — 上传文件夹

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

CLI：

CODEBLOCK13

Python：

CODEBLOCK14

输入参数：

参数名	类型	必填	默认值	说明
INLINECODE92	INLINECODE93	✅	-	本地文件夹路径
INLINECODE94

输出参数：

参数名	类型	说明
INLINECODE101	INLINECODE102	上传的文件夹名称
INLINECODE103

示例输出：

CODEBLOCK15

2.4 download_file — 下载文件

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

CLI：

CODEBLOCK16

Python：

CODEBLOCK17

输入参数：

参数名	类型	必填	默认值	说明
INLINECODE127	INLINECODE128	✅	-	微云文件路径
INLINECODE129

输出参数：

参数名	类型	说明
INLINECODE134	INLINECODE135	本地保存路径
INLINECODE136

2.5 download_folder — 下载文件夹

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

CLI：

CODEBLOCK18

Python：

CODEBLOCK19

输入参数：

参数名	类型	必填	默认值	说明
INLINECODE142	INLINECODE143	✅	-	微云上的文件夹名称
INLINECODE144

输出参数（递归模式）：

参数名	类型	说明
INLINECODE152	INLINECODE153	文件夹名称
INLINECODE154

输出参数（zip 模式）：

参数名	类型	说明
INLINECODE180	INLINECODE181	zip 文件本地路径
INLINECODE182

示例输出（递归模式）：

CODEBLOCK20

2.6 delete_file — 删除文件

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

CLI：

CODEBLOCK21

Python：

CODEBLOCK22

输入参数：

参数名	类型	必填	默认值	说明
INLINECODE190	INLINECODE191	✅	-	文件/文件夹路径
INLINECODE192

boolean | ❌ | false | 是否永久删除（跳过回收站） |

输出参数：

参数名	类型	说明
INLINECODE195	INLINECODE196	已删除的路径
INLINECODE197

2.7 move_file — 移动文件

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

CLI：

CODEBLOCK23

Python：

CODEBLOCK24

输入参数：

参数名	类型	必填	默认值	说明
INLINECODE201	INLINECODE202	✅	-	源路径
INLINECODE203

string | ✅ | - | 目标目录路径 |

输出参数：

参数名	类型	说明
INLINECODE205	INLINECODE206	原路径
INLINECODE207

string | 新路径 |

2.8 copy_file — 复制文件

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

CLI：

CODEBLOCK25

Python：

CODEBLOCK26

输入参数：

参数名	类型	必填	默认值	说明
INLINECODE209	INLINECODE210	✅	-	源路径
INLINECODE211

string | ✅ | - | 目标目录路径 |

输出参数：

参数名	类型	说明
INLINECODE213	INLINECODE214	源路径
INLINECODE215

2.9 rename_file — 重命名

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

CLI：

CODEBLOCK27

Python：

CODEBLOCK28

输入参数：

参数名	类型	必填	默认值	说明
INLINECODE219	INLINECODE220	✅	-	文件当前路径
INLINECODE221

string | ✅ | - | 新文件名 |

输出参数：

参数名	类型	说明
INLINECODE223	INLINECODE224	原路径
INLINECODE225

string | 新路径 |

2.10 create_folder — 创建文件夹

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

CLI：

CODEBLOCK29

Python：

CODEBLOCK30

输入参数：

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

输出参数：

参数名	类型	说明
INLINECODE229	INLINECODE230	文件夹 ID
INLINECODE231

2.11 search_files — 搜索文件

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

CLI：

CODEBLOCK31

Python：

CODEBLOCK32

输入参数：

参数名	类型	必填	默认值	说明
INLINECODE235	INLINECODE236	✅	-	搜索关键词
INLINECODE237

string | ❌ | all | 类型过滤：all/document/image/video/audio |
| page | integer | ❌ | 1 | 分页页码 |
| page_size | integer | ❌ | 50 | 每页数量 |

输出参数：

参数名	类型	说明
INLINECODE251	INLINECODE252	搜索结果列表
INLINECODE253

3. 分享管理 Skills

3.1 create_share — 创建分享

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

CLI：

CODEBLOCK33

Python：

CODEBLOCK34

输入参数：

参数名	类型	必填	默认值	说明
INLINECODE265	INLINECODE266	✅	-	文件/文件夹路径
INLINECODE267

输出参数：

参数名	类型	说明
INLINECODE273	INLINECODE274	分享 ID
INLINECODE275

示例输出：

CODEBLOCK35

3.2 cancel_share — 取消分享

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

CLI：

CODEBLOCK36

Python：

CODEBLOCK37

输入参数：

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

输出参数：

参数名	类型	说明
INLINECODE285	INLINECODE286	已取消的分享 ID
INLINECODE287

string | 取消时间 |

3.3 list_shares — 列出分享

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

CLI：

CODEBLOCK38

Python：

CODEBLOCK39

输入参数：

参数名	类型	必填	默认值	说明
INLINECODE289	INLINECODE290	❌	INLINECODE291	状态过滤：`all`/`active`/INLINECODE294
INLINECODE295

integer | ❌ | 1 | 分页页码 |
| page_size | integer | ❌ | 20 | 每页数量 |

输出参数：

参数名	类型	说明
INLINECODE301	INLINECODE302	分享列表
INLINECODE303

4. 空间管理 Skills

4.1 getspaceinfo — 空间信息

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

CLI：

CODEBLOCK40

Python：

CODEBLOCK41

输入参数：无

输出参数：

参数名	类型	说明
INLINECODE321	INLINECODE322	总空间（字节）
INLINECODE323

示例输出：

CODEBLOCK42

4.2 getrecyclebin — 回收站

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

CLI：

CODEBLOCK43

Python：

CODEBLOCK44

输入参数：

参数名	类型	必填	默认值	说明
INLINECODE340	INLINECODE341	❌	INLINECODE342	分页页码
INLINECODE343

integer | ❌ | 50 | 每页数量 |

输出参数：

参数名	类型	说明
INLINECODE346	INLINECODE347	回收站文件列表
INLINECODE348

4.3 restore_file — 恢复文件

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

CLI：

CODEBLOCK45

Python：

CODEBLOCK46

输入参数：

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

输出参数：

参数名	类型	说明
INLINECODE364	INLINECODE365	文件 ID
INLINECODE366

4.4 clearrecyclebin — 清空回收站

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

CLI：

CODEBLOCK47

Python：

CODEBLOCK48

输入参数：

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

输出参数：

参数名	类型	说明
INLINECODE373	INLINECODE374	删除文件数
INLINECODE375

附录 A：统一错误码

错误码	说明
INLINECODE379	Cookies 已过期，需重新登录
INLINECODE380

错误响应格式：

CODEBLOCK49

附录 B：Cookies 关键字段说明

Cookie 名称	说明
INLINECODE393	用户 QQ 号标识
INLINECODE394

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

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

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

方法1：扫码登录（推荐）

python weiyun_skills/login.py --method qrcode

方法2：从浏览器复制 Cookies

python weiyun_skills/login.py --method cookies --cookies uin=o012345678; skey=@abcdef1234; ...

调用方式：
bash

CLI

python weiyun_skills/main.py [args] [options]

Python SDK

from weiyun_skills.client import WeiyunClient
client = WeiyunClient()
client.(params)

统一返回格式：
json
{ success: true, data: { ... }, message: ok }

- 目录 - 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 getspace_info — 空间信息 - 4.2 getrecycle_bin — 回收站 - 4.3 restore_file — 恢复文件 - 4.4 clearrecycle_bin — 清空回收站 - 附录 A：统一错误码 - 附录 B：Cookies 关键字段说明

1. 认证 Skills

1.1 qrcode_login — 扫码登录

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

CLI：

bash
python weiyun_skills/login.py --method qrcode

Python：

python
from weiyunskills.login import qrcodelogin

cookies = qrcode_login()

终端将显示二维码，使用微信/QQ 扫码

成功后，Cookies 保存到 cookies.json

输入参数：

参数名	类型	必填	默认值	说明
save_path	string	❌	cookies.json	Cookies 保存路径

输出参数：

参数名	类型	说明
success	boolean	是否登录成功
uin

流程：

┌─────────────┐ ┌──────────────┐ ┌─────────────┐
│ 请求二维码 │────▶│ 在终端显示 │────▶│ 用户使用 │
│ URL │ │ 二维码 │ │ 微信扫码 │
└─────────────┘ └──────────────┘ └──────┬──────┘
│
┌─────────────┐ ┌──────────────┐ │
│ 保存到 │◀────│ 从服务器获取 │◀────────────┘
│ cookies.json│ │ Cookies │
└─────────────┘ └──────────────┘

1.2 cookies_login — Cookies 登录

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

CLI：

bash
python weiyunskills/login.py --method cookies --cookies uin=o012345678; skey=@abcdef1234; puin=o012345678; pt4token=xxxxx; pskey=xxxxx

Python：

python
from weiyunskills.login import cookieslogin

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

如何获取 Cookies：

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

输入参数：

参数名	类型	必填	默认值	说明
cookiesstr	string	✅	-	从浏览器复制的 Cookie 字符串
savepath

string | ❌ | cookies.json | Cookies 保存路径 |

输出参数：

参数名	类型	说明
success	boolean	是否验证成功
uin

2. 文件管理 Skills

2.1 list_files — 列出文件

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

CLI：

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

Python：

python
files = client.listfiles(/我的文档, sortby=size, sort_order=desc)

输入参数：

参数名	类型	必填	默认值	说明
remotepath	string	❌	/	目录路径，默认根目录
sortby

输出参数：

参数名	类型	说明
files	array	文件列表
files[].file_id

string | 文件唯一 ID |
| files

微云管理

微云管理

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 getspaceinfo — 空间信息

4.2 getrecyclebin — 回收站

4.3 restore_file — 恢复文件

4.4 clearrecyclebin — 清空回收站

附录 A：统一错误码

附录 B：Cookies 关键字段说明

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

方法1：扫码登录（推荐）

方法2：从浏览器复制 Cookies

CLI

Python SDK

目录

1. 认证 Skills

1.1 qrcode_login — 扫码登录

终端将显示二维码，使用微信/QQ 扫码

成功后，Cookies 保存到 cookies.json

1.2 cookies_login — Cookies 登录

2. 文件管理 Skills

2.1 list_files — 列出文件

标签

通过对话安装

方式一：安装 SkillHub 和技能

方式二：设置 SkillHub 为优先技能安装源

通过命令行安装

下载

相关推荐

self-improvement

self-improvement

self-improvement

self-improvement