Now liveThe Skillselion MCP - thousands of ranked skills, loaded into your agent mid-task. No install.Get it →
bighardperson avatar

Weiyun

  • 8 installs
  • 33 repo stars
  • Updated April 26, 2026
  • bighardperson/computer-science-skills-collection

Weiyun is a Claude skill and MCP integration that manages Tencent Weiyun cloud-drive files with list, upload, download, delete, and share tools.

About

Weiyun is an MCP skill for managing Tencent Weiyun cloud-drive files. It exposes six MCP tools to list, download, delete, upload, and generate share links, plus a version-check tool. Uploads use a two-stage protocol where the client computes streaming SHA1 block hashes locally before sending metadata, enabling instant dedup uploads. A developer uses it to script Weiyun file management or implement its upload protocol.

  • Manages Tencent Weiyun cloud-drive files via 6 MCP tools
  • list, download, delete, upload, and gen_share_link plus a version-check tool
  • Two-stage upload with client-side streaming SHA1 block hashing

Weiyun by the numbers

  • 8 all-time installs (skills.sh)
  • Ranked #1,522 of 2,719 Automation & Workflows skills by installs in the Skillselion catalog
  • Data as of Jul 30, 2026 (Skillselion catalog sync)
At a glance

weiyun capabilities & compatibility

Uses a hosted Weiyun MCP server; a Weiyun account/token is needed to access the user's own drive.

Capabilities
file management · cloud storage · file sharing
Use cases
devops
Runs
Remote server
Pricing
Free
From the docs

What weiyun says it does

Manage Tencent Weiyun cloud drive files (list, upload, download, delete, share)
SKILL.md
提供微云(Weiyun)网盘通过 MCP 协议进行文件管理的完整能力,包含 **6 个 MCP Tool**
SKILL.md
微云文件上传采用**两阶段协议**
SKILL.md
文件哈希计算和 `block_sha_list` 生成**必须在客户端/本地完成**
SKILL.md
npx skills add https://github.com/bighardperson/computer-science-skills-collection --skill weiyun

Add your badge

Show developers this skill is listed on Skillselion. Paste this into your README.

Listed on Skillselion
Installs8
repo stars33
Last updatedApril 26, 2026
Repositorybighardperson/computer-science-skills-collection

What it does

Manage Tencent Weiyun cloud-drive files (list, upload, download, delete, share) through MCP tools.

Who is it for?

Scripting Tencent Weiyun cloud-drive file operations via MCP

Skip if: Downloading files from Weiyun share links; it only handles files in the user's own drive

When should I use this skill?

You need to list, upload, download, delete, or share Tencent Weiyun cloud-drive files

What you get

Programmatic Weiyun file management including uploads with instant dedup

  • file list
  • download links
  • share links

By the numbers

  • 6 MCP tools
  • two-stage upload protocol
  • 512KB (524288-byte) block size

Files

SKILL.mdMarkdownGitHub ↗

微云网盘 MCP 技能

版本更新检查(每天首次使用前必须执行)

每天使用本 SKILL 前进行一次更新检查,按照如下步骤执行:

1. 查看当前版本 version

读取本文件顶部 frontmatter 中的 version 字段;格式为 MAJOR.MINOR.PATCH

2. 查看最新版本 latest

通过命令获取最新版本信息 latest,输入参数 version 为上一步获取的当前版本:

mcporter call "https://www.weiyun.com/api/v3/mcpserver" "check_skill_update" --args '{"version": "当前版本"}'

JSON 格式数据返回,返回参数示例:

字段类型说明
lateststring最新版本号,格式为 MAJOR.MINOR.PATCH
release_notestring最新版本发布说明
instructionstring更新指令

3. 更新版本

如果当前版本 version 低于最新版本 latest,则遵循 instruction 指令进行更新,或提示用户更新。

---

功能概述

提供微云(Weiyun)网盘通过 MCP 协议进行文件管理的完整能力,包含 6 个 MCP Tool

Tool 名称功能说明
weiyun.list目录列表查询按目录查看文件和子目录,支持分页和排序
weiyun.download批量下载批量获取文件的 HTTPS 下载链接
weiyun.delete批量删除批量删除文件或目录,支持回收站或彻底删除
weiyun.upload文件上传两阶段协议:预上传 + 分片上传,支持秒传
weiyun.gen_share_link生成分享外链为文件或目录生成分享短链接
check_skill_update技能版本检查更新检查当前 Skill 版本是否为最新,获取更新指令

核心架构原则:文件哈希计算和 block_sha_list 生成必须在客户端/本地完成。服务端只接收预计算好的哈希值,不会接收原始文件数据来计算哈希。这种设计是为了防止海量请求打爆服务器的存储和 CPU。

详细参考文档

  • MCP API 完整参考:references/mcp_api.md(所有 Tool 的请求/响应字段详解)
  • 上传协议详解:references/upload_protocol.md(两阶段上传、分块 SHA1 算法、check_sha/check_data 计算)

触发场景

  • 使用微云 MCP 工具进行文件管理(查询、下载、删除、上传、分享)
  • 上传文件到微云:优先使用 scripts/upload_to_weiyun.py 一键完成,无需手动计算参数或调用 MCP
  • 实现或调试微云 MCP 文件上传(weiyun.upload Tool)
  • 计算 block_sha_listcheck_shacheck_data 等上传参数
  • 理解微云两阶段上传协议(预上传 → 分片上传)
  • 检查技能版本更新(check_skill_update
  • 调试 FTN 上传错误或 SHA1 校验不匹配问题

接口一览

1. weiyun.list — 目录列表查询

查询微云网盘的目录内容,返回子目录和文件列表。

请求参数

字段类型必填说明
get_typeuint32获取类型:0-所有,1-仅目录,2-仅文件
offsetuint32分页起始偏移量,从 0 开始
limituint32每页返回数量,最大 50
order_byuint32排序字段:0-不排序,1-按名字,2-按修改时间
ascbooltrue-升序,false-降序(默认)
dir_keystring要查询的目录 key(hex 编码),为空则使用 token 绑定的 dirkey
pdir_keystring要查询的父目录 key(hex 编码),为空则使用 token 绑定的 pdirkey

响应:返回 pdir_key(父目录 key)、dir_list(目录列表)、file_list(文件列表)、finish_flag(是否拉取完毕)。

注意:腾讯文档文件会被自动过滤,不出现在返回结果中。

2. weiyun.download — 批量下载

批量获取微云文件的 HTTPS 下载链接。

注意事项

本功能无法下载微云分享的链接里面的文件,只能下载用户微云网盘中的文件。

请求参数

字段类型必填说明
itemsMcpDownloadFileItem[]需要下载的文件列表

每个 McpDownloadFileItem 包含 file_id(文件 ID)和 pdir_key(所在目录 key),均为必填。

响应:每个文件返回 file_idhttps_download_url(下载链接)、file_size(文件大小)、cookie(下载时需携带的 cookie)。

权限校验:只能下载当前用户拥有的文件(通过 pdir_key 判断目录所有权)。

3. weiyun.delete — 批量删除

批量删除微云网盘中的文件或目录。

请求参数

字段类型必填说明
file_listMcpDeleteFileItem[]待删除的文件列表(file_id + pdir_key
dir_listMcpDeleteDirItem[]待删除的目录列表(dir_key + pdir_key
delete_completelyboolfalse-移到回收站(默认),true-彻底删除

注意file_listdir_list 至少要填一个。

响应:返回 freed_space(释放的空间字节数)和 freed_index_cnt(删除的文件/目录总数)。

4. weiyun.gen_share_link — 生成分享外链

为微云文件或目录生成分享短链接。

请求参数

字段类型必填说明
file_listMcpShareFileItem[]待分享的文件列表(file_id + pdir_key
dir_listMcpShareDirItem[]待分享的目录列表(dir_key + pdir_key
share_namestring分享名称,不填则使用第一个文件或目录名

注意

file_listdir_list 至少要填一个。

分享外链无法使用本 skill 进行下载,需要提示用户打开网页进行下载

⚠️ 关键:pdir_key 不能为空!

  • pdir_key 必须使用 weiyun.list 响应中顶层的 `pdir_key`,而不是文件自身的 pdir_key 字段(该字段可能为空字符串)
  • 如果传空的 pdir_key,可能导致分享链接异常,强烈建议调用方显式传入正确的 pdir_key
  • 错误示例:直接用 file_list[i].pdir_key(可能为空)
  • 正确示例:使用 weiyun.list 响应顶层的 pdir_key 字段值

响应:返回 short_url(分享短链接)和 share_name(分享名称)。

5. weiyun.upload — 文件上传

微云文件上传采用两阶段协议

阶段一:预上传

发送文件元数据和分块 SHA1 列表,检查是否可以秒传,或获取上传通道。

必填字段filenamefile_sizefile_shablock_sha_listcheck_sha 可选字段file_md5check_datapdir_key

关键行为file_sha 必须等于 block_sha_list 的最后一个值,否则校验会失败。

响应判断

  • file_exist=true → 秒传成功,上传完毕
  • file_exist=false → 使用返回的 upload_keychannel_listex 进行分片上传
阶段二:分片上传

根据预上传返回的通道列表,逐片上传文件数据。

必填字段upload_keychannel_listchannel_idexfile_datafilename

上传状态

  • 1 = 继续上传下一分片
  • 2 = 上传完成
  • 3 = 等待其他通道完成

6. check_skill_update — 技能版本检查更新

检查当前 Skill 版本是否为最新,如有新版本则返回更新指令。

请求参数

字段类型必填说明
versionstring当前 Skill 版本号,格式 MAJOR.MINOR.PATCH

响应

字段类型说明
lateststring最新版本号,格式 MAJOR.MINOR.PATCH
release_notestring最新版本发布说明
instructionstring更新指令(需要更新时遵循此指令执行)

注意:每天首次使用本 Skill 前必须执行一次版本检查(详见文档顶部「版本更新检查」章节)。

分块 SHA1 计算算法

这是上传功能最核心的部分。微云不使用标准的独立分块 SHA1,而是使用流式 SHA1 内部状态

算法步骤(分块大小 = 512KB = 524288 字节)

1. 创建一个共享的 SHA1 哈希对象 2. 对于除最后一块之外的每个块:

  • 读取 524288 字节并 update() 到 SHA1 对象
  • 提取 SHA1 内部寄存器(h0, h1, h2, h3, h4)以小端序输出
  • 输出为 40 字符 hex 字符串 → 该块的 sha

3. 对于最后一块(可能不足 524288 字节):

  • 继续用相同 SHA1 对象 update 剩余数据
  • sha 值为整个文件的标准 SHA1 hexdigest(大端序,含 finalization)

check_sha 和 check_data 计算

用于服务端防篡改验证:

lastBlockSize = file_size % 524288(若为 0 则取 524288)
checkBlockSize = lastBlockSize % 128(若为 0 则取 128)

check_sha:处理完所有非最后块后,继续 update 最后块中前 (lastBlockSize - checkBlockSize) 字节,
           然后取 SHA1 内部寄存器 h0-h4 小端序输出为 hex
check_data:文件末尾 checkBlockSize 字节的 Base64 编码

使用脚本

一键上传脚本(推荐)

直接上传本地文件到微云,整合了参数计算 + 预上传 + 分片上传的完整流程:

# 基本用法
python3 scripts/upload_to_weiyun.py /path/to/file --token <mcp_token> --env_id <env_id>

# 指定上传目录
python3 scripts/upload_to_weiyun.py /path/to/file --token <mcp_token> --pdir_key <dir_key>

# 使用环境变量
export WEIYUN_MCP_TOKEN=<mcp_token>
export WEIYUN_ENV_ID=<env_id>
python3 scripts/upload_to_weiyun.py /path/to/file

脚本参数:

参数必填说明
file_path本地文件路径(位置参数)
--tokenMCP token(或设 WEIYUN_MCP_TOKEN 环境变量)
--env_id环境标识(如 sit-0cd15bb3,或设 WEIYUN_ENV_ID
--pdir_key上传目标目录 key(不填使用 token 绑定目录)
--mcp_urlMCP 服务地址(默认 https://www.weiyun.com/api/v3/mcpserver
--max_rounds最大上传轮数(默认 50)

上传策略:循环「预上传获取通道 → 上传一片 → 重新预上传」直到完成。每次预上传会自动跳过已成功的分片(offset 随进度递增),支持秒传。

AI Agent 使用时:只需要 execute_command 运行此脚本即可,无需手动计算 block_sha_list 或调用 MCP。

参数计算脚本

仅计算上传参数(不执行上传),用于调试或手动调用 MCP:

python3 scripts/gen_block_info_list.py /path/to/file

输出包括:block_sha_listfile_shafile_md5check_shacheck_datablock_sizeblock_count

两个脚本均包含纯 Python 的 SHA1 实现,支持提取未经 finalization 的内部状态 — 这是 Python 标准库 hashlib.sha1 无法做到的。

错误码说明

MCP 接口在出现异常时会返回以下错误码,调用方可根据错误码进行相应处理:

错误码名称说明
117401ERR_RATE_LIMIT每日调用配额已耗尽,请明天再试
117402ERR_MCP_TOKEN_INVALIDMCP token 无效或已过期,请重新生成 token
117403ERR_MCP_PARAM_EMPTY请求必填参数为空(如删除接口 file_list 和 dir_list 都为空)
117404ERR_MCP_PARAM_INVALID请求参数不合法(如 file_id 或 pdir_key 格式错误)
117405ERR_MCP_PERMISSION_DENIED无权操作非本人目录的文件
117406ERR_MCP_BACKEND_FAIL后端服务调用失败,请稍后重试

处理建议

  • 117401:等待次日零点配额自动重置,或开通微云会员提升配额
  • 117402:重新生成 token
  • 117403/117404:检查请求参数是否完整且格式正确
  • 117405:确认操作的文件/目录属于当前用户
  • 117406:属于服务端临时异常,可重试

常见操作工作流

工作流 1:查找并下载文件

当需要在微云中找到某个文件并下载到本地时,按以下步骤操作:

第一步:查询根目录

调用 weiyun.list,参数:limit=50, get_type=0
  • 响应中的 file_list 包含文件,dir_list 包含子目录
  • 记住响应顶层的 `pdir_key`(后续下载需要用到)
  • 如果文件在根目录 → 进入第三步
  • 如果文件不在根目录 → 需要遍历子目录(第二步)

第二步:遍历子目录查找文件

调用 weiyun.list,参数:
  dir_key = <子目录的 dir_key>(从 dir_list 中获取)
  pdir_key = <子目录所在父目录的 pdir_key>(即上一次 list 响应顶层的 pdir_key,或子目录所在目录的 dir_key)
  limit = 50

⚠️ 关键:查询子目录时 dir_keypdir_key 的含义:

  • dir_key:要查询的目标子目录的 key(从 dir_list 中的 dir_key 字段获取)
  • pdir_key:该子目录所在的父目录 key(从上一级 weiyun.list 响应顶层的 pdir_key 获取)

如果还有嵌套子目录,递归重复此步骤。

第三步:获取下载链接

调用 weiyun.download,参数:
  items = [{"file_id": "<文件的 file_id>", "pdir_key": "<文件所在目录的 pdir_key>"}]
  • file_id:从 file_list 中获取
  • pdir_key:使用 weiyun.list 响应中顶层的 `pdir_key`(不是文件自身的 pdir_key 字段)

第四步:下载文件到本地

curl -s -L -o <本地文件名> -b "<cookie>" "<https_download_url>"
  • -L:跟随重定向(必须)
  • -b:携带 cookie(从 download 响应中获取,格式如 FTN5K=08bfd4be
  • 下载完成后验证文件大小与 file_size 一致

工作流 2:上传文件到微云

推荐方式(一键脚本):

# 1. 先查根目录获取 pdir_key
# 调用 weiyun.list limit=50 → 记住响应中的 pdir_key

# 2. 上传
python3 scripts/upload_to_weiyun.py /path/to/file --pdir_key <pdir_key>

手动方式:参见上方「5. weiyun.upload — 文件上传」章节。

工作流 3:生成分享链接

# 1. 先查目录获取文件信息和 pdir_key
调用 weiyun.list → 找到目标文件的 file_id,记住响应**顶层** pdir_key

# 2. 生成分享链接(pdir_key 必须非空!)
调用 weiyun.gen_share_link,参数:
  file_list = [{"file_id": "<file_id>", "pdir_key": "<响应顶层的 pdir_key>"}]
  share_name = "<文件名>"

⚠️ 关键pdir_key 必须使用 weiyun.list 响应中顶层的 `pdir_key`,绝对不能传空字符串!文件项中的 pdir_key 字段可能为空,不可使用。

工作流 4:删除文件

# 1. 先查目录获取文件信息
调用 weiyun.list → 找到目标文件的 file_id,记住响应顶层 pdir_key

# 2. 删除
调用 weiyun.delete,参数:
  file_list = [{"file_id": "<file_id>", "pdir_key": "<pdir_key>"}]
  delete_completely = false  (移到回收站,更安全)

认证机制

所有 MCP 工具需要通过 WyHeader HTTP 头传递 mcp_token

WyHeader: mcp_token=<token>

常见问题

1. 上传文件应该怎么做:直接用 python3 scripts/upload_to_weiyun.py <文件路径> --pdir_key <目录key>,无需手动计算参数或调用 MCP 2. 下载时 pdir_key 应该填什么:使用 weiyun.list 响应中顶层的 `pdir_key`,而不是文件自身的 pdir_key 字段(该字段可能为空字符串) 3. 生成分享链接时 pdir_key 不能为空:必须先调用 weiyun.list,使用响应顶层的 `pdir_key`(不是 file_list[i].pdir_key,该字段通常为空)。pdir_key 为空会导致分享链接打开异常 4. 查询子目录时 pdir_key 怎么填:填入子目录所在父目录的 key。对于根目录下的子目录,就是根目录 weiyun.list 响应顶层的 pdir_key 5. 下载时需要携带 cookieweiyun.download 返回的下载链接需要用 curl -b "<cookie>" 携带 cookie 值,同时 -L 跟随重定向 6. 上传报 "Cannot upload to a directory that you do not own":必须指定 --pdir_key 参数。先调用 weiyun.list 获取响应中顶层的 pdir_key 7. 分片上传通道 len=0:每轮上传完一片后,返回的通道列表可能全部 len=0,需要重新预上传获取下一批通道。upload_to_weiyun.py 已自动处理此问题 8. SHA1 不匹配:确保分块 SHA 值使用流式 SHA1 内部状态(小端序),而非独立分块 SHA1 9. file_sha 被覆盖:服务端用最后一个 block 的 SHA 覆盖 file_sha — 两者必须相等 10. Base64 双重编码:MCP 框架自动将 base64 字符串转为 bytes 传给 file_data 字段,服务端会再次进行 Base64 解码 11. 通道 ID 不匹配:上传分片时 channel_id 必须与 channel_list 中某个条目匹配 12. 环境标识:SIT 环境需在 Cookie 中携带 env_id=sit-xxxxx 13. 权限校验:下载、删除、分享操作会校验目录所有权,非本人目录的文件会被跳过 14. 腾讯文档过滤:列表查询会自动过滤腾讯文档类型的文件 15. pip install requests:上传脚本依赖 requests 库,如提示缺少请先安装:pip install requests 16. 所有需要 pdir_key 的操作(下载、删除、分享、上传),都应使用 weiyun.list 响应顶层pdir_key,而不是文件/目录条目自身的 pdir_key 字段

Related skills

FAQ

How many MCP tools does Weiyun provide?

It provides six MCP tools: weiyun.list, weiyun.download, weiyun.delete, weiyun.upload, weiyun.gen_share_link, and check_skill_update for version checks.

How does Weiyun's upload work?

It uses a two-stage protocol: a preupload that sends file metadata and block SHA1 list to check for instant upload, then chunked upload of file data. File hashing must be computed on the client, not the server.

This week in AI coding

Five minutes, every Monday - the tools, releases and tactics for developers.

unsubscribe anytime.