Xpersona
W

Weiyun Skills

CLAWHUB · Unverified

微云网盘 MCP 接口完整技能。包含 weiyun.list、weiyun.list_by_category、weiyun.download、weiyun.delete、weiyun.upload、weiyun.gen_share_link、weiyun.rename_file、weiyun.rename_dir...

62
Rank
84
Safety
22k
Downloads

About

What it does, and when to use it.

Capability contract not published. No trust telemetry is available yet. 21.7K downloads reported by the source. Last updated 11/16/2026.

Avoid when

  • Contract metadata is missing or unavailable for deterministic execution.

Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing

Install and run

Setup complexity: low.

clawhub skill install s17bw1sf2hsjw09jmyh7nhzshn83h2gf:weiyun-skills
  1. Install using `clawhub skill install s17bw1sf2hsjw09jmyh7nhzshn83h2gf:weiyun-skills` in an isolated environment before connecting it to live workloads.
  2. No published capability contract is available yet, so validate auth and request/response behavior manually.
  3. Review the upstream CLAWHUB listing at https://clawhub.ai/wscats/weiyun-skills before using production credentials.

Contract: missing

curl -s "https://www.xpersona.co/api/v1/agents/clawhub-wscats-weiyun-skills-n-skills-2/snapshot"

Run-check

$0.02 USD

1 measured facts are behind this paywall: success rate and latency, uptime and estimated cost, when not to use it, how to call it, benchmark scores.

Agents pay $0.02 in USDC. A card payment is $0.50, the smallest a card allows.

Documentation

CLAWHUB

150,041 characters of source documentation, loaded on request.

Extracted files

5 files captured from the source.

SKILL.md

---
name: weiyun
description: 微云网盘 MCP 接口完整技能。包含 weiyun.list、weiyun.list_by_category、weiyun.download、weiyun.delete、weiyun.upload、weiyun.gen_share_link、weiyun.rename_file、weiyun.rename_dir、weiyun.create_dir、weiyun.move_dir、weiyun.move_file、check_skill_update 共 12 个 MCP Tool 的使用指南,以及 FTN 上传协议所需的 SHA1 分块计算脚本。当用户提到微云上传、MCP 上传、block_sha_list 计算、FTN 上传、微云文件管理或上述任一 Tool 名时触发。
description_zh: "管理腾讯微云网盘文件(列表、上传、下载、删除、分享)"
description_en: "Manage Tencent Weiyun cloud drive files (list, upload, download, delete, share)"
version: 1.0.10
display_name: "weiyun"
display_name_en: "weiyun"
visibility: "public"
---

# 微云网盘 MCP 技能

首次安装使用时,需要先完成本地安装和注册,详见 `references/auth.md`。

> **Windows 用户**:所有 `bash ./setup.sh` 命令请替换为 `powershell -ExecutionPolicy Bypass -File setup.ps1`,详见 `references/auth.md`。

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

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

### 1. 查看当前版本 version

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

### 2. 查看最新版本 latest

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

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

> **Windows (PowerShell)** 用户注意:需先切换 UTF-8 编码,单引号内的 JSON 需改为转义双引号:
> ```powershell
> chcp 65001 >nul && mcporter call "https://www.weiyun.com/api/v3/mcpserver" "check_skill_update" --args "{`"version`": `"当前版本`"}"
> ```

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

| 字段 | 类型 | 说明 |
|------|------|------|
| `latest` | string | 最新版本号,格式为 MAJOR.MINOR.PATCH |
| `release_note` | string | 最新版本发布说明 |
| `instruction` | string | 更新指令 |

### 3. 更新版本

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

---

## 功能概述

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

| Tool 名称 | 功能 | 说明 |
|-----------|------|------|
| `weiyun.list` | 目录列表查询 | 按目录查看文件和子目录,支持分页和排序 |
| `weiyun.list_by_category` | 按分类拉取文件列表 | 按文档、图片、视频等分类分页拉取文件,支持续拉 |
| `weiyun.download` | 批量下载 | 批量获取文件的 HTTPS 下载链接 |
| `weiyun.delete` | 批量删除 | 批量删除文件或目录,支持回收站或彻底删除 |
| `weiyun.upload` | 文件上传 | 两阶段协议:预上传 + 分片上传,支持秒传 |
| `weiyun.gen_share_link` | 生成分享外链 | 为文件或目录生成分享短链接,支持设置分享密码 |
| `weiyun.rename_file` | 重命名文件 | 重命名微云网盘中的文件 |
| `weiyun.rename_dir` | 重命名目录 | 重命名微云网盘中的目录 |
| `weiyun.create_dir` | 创建文件夹 | 在微云网盘中创建文件夹 |
| `weiyun.move_dir` | 移动文件夹 | 移动微云网盘中的文件夹到目标目录 |
| `weiyun.move_file` | 移动文件 | 移动微云网盘中的文件到目标目录 |
| `check_skill_update` | 技能版本检查更新 | 检查当前 Skill 版本是否为最新,获取更新指令 |

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

## 触发场景

- 使用微云 MCP 工具进行文件管理(查询、下载、删除、上传、分享、重命名、创建文件夹、移动文件/目录)
- **上传文件到微云**:优先使用 `scripts/upload_to_weiyun.py` 一键完成,无需手动计算参数或调用 MCP
- 按分类(文档、图片、视频等)查找微云文件(`weiyun.list_by_category` Tool)
- 重命名微云文件或目录(`weiyun.rename_file`、`weiyun.rename_dir` Tool)
- 在微云中创建文件夹(`weiyun.create_dir` Tool)
- 移动微云文件或目录到其他位置(`weiyun.move_file`、`weiyun.move_dir` Tool)
- 实现或调试微云 MCP 文件上传(`weiyun.upload` Tool)
- 计算 `block_sha_list`、`check_sha`、`check_data` 等上传参数
- 理解微云两阶段上传协议(预上传 → 分片上传)
- 检查技能版本更新(`check_skill_update`)
- 调试 FTN 上传错误或 SHA1

_meta.json

{
  "ownerId": "kn78mv1912530wvdbf2vjcd3r982v66j",
  "slug": "weiyun-skills",
  "version": "1.0.10",
  "publishedAt": 1780323008292
}

references/auth.md

# 微云鉴权检查

微云授权流程,**必须按以下步骤执行**:

## 第一步:检查状态(立即返回)

**macOS / Linux:**
```bash
bash ./setup.sh weiyun_check_and_start_auth
```

**Windows (PowerShell):**
```powershell
powershell -ExecutionPolicy Bypass -File setup.ps1 weiyun_check_and_start_auth
```

| 输出 | 处理方式 |
|------|---------|
| `READY` | ✅ 直接执行用户任务,**无需后续步骤** |
| `AUTH_REQUIRED:<url>` | 向用户展示授权链接(见下方模板),**等待用户回复"已完成授权"后再执行第二步** |
| `ERROR:*` | 告知用户具体错误信息,并引导走**第三步人工兜底**手动设置 Token |

> ⛔ **严格禁止**:收到 `AUTH_REQUIRED` 后,必须先向用户展示授权链接,**等待用户发送新消息确认已完成授权**,才能进行第二步。

## 第二步:用户确认已完成授权后,主动查询 Token

> ✅ **触发条件**:用户在新消息中明确回复"已授权"、"完成了"、"已完成授权"、"授权好了"等确认信息后,**才执行本步骤**。

**macOS / Linux:**
```bash
bash ./setup.sh weiyun_fetch_token
```

**Windows (PowerShell):**
```powershell
powershell -ExecutionPolicy Bypass -File setup.ps1 weiyun_fetch_token
```

| 输出 | 处理方式 |
|------|---------|
| `TOKEN_READY` | ✅ 授权成功,继续执行用户任务 |
| `ERROR:not_authorized` | 告知用户:「您尚未完成授权,请在浏览器中完成后回复我。」(**不要重新生成链接**,等用户再次确认后重试本步骤) |
| `ERROR:expired` | 告知用户:「您的微云 Token 已过期,请访问 [获取新 Token](https://www.weiyun.com/act/openclaw) 重新获取,然后告诉我新的 Token,我来帮您重置。」(引导用户走**第三步人工兜底**手动设置 Token) |
| `ERROR:token_invalid` | 告知用户:「Token 已失效,请重新授权。」(需重新执行第一步) |
| `ERROR:*` | 告知用户具体错误信息(错误码+描述),并引导走**第三步人工兜底**手动设置 Token |

## 第三步:人工兜底

🔑 **检查 Token 配置**:可访问 [https://www.weiyun.com/act/openclaw](https://www.weiyun.com/act/openclaw) 获取 Token,再执行以下命令来设置 mcporter:

> ⚠️ **凭据安全提示**:以下命令会把 Token **明文持久化到本地 mcporter 配置文件**,该 Token 等同于您的微云访问凭据,可读写您账号下的网盘文件。AI Agent 在执行前请确保:
>
> 1. 当前环境是用户**本人专属的设备**,而非共享主机或临时容器;
> 2. 不要把 Token 输出 / 回显在对话中,不要写入会被持久化的脚本或 shell history;
> 3. 任务完成后如果是临时设备,建议执行 `mcporter config remove weiyun` 清理;
> 4. 一旦怀疑泄漏,请立即在 [https://www.weiyun.com/act/openclaw](https://www.weiyun.com/act/openclaw) 撤销旧 Token。

**macOS / Linux:**
```bash
# 使用传入的 Token 写入 mcporter 配置(weiyun)
mcporter config add weiyun "https://www.weiyun.com/api/v3/mcpserver" \
    --header "WyHeader=mcp_token=$Token" \
    --transport http \
    --scope home
```

**Windows (PowerShell):**
```powershell
# 使用传入的 Token 写入 mcporter 配置(weiyun)
mcporter config add weiyun "https://www.weiyun.com/api/v3/mcpserver" --header "WyHeader=mcp_token=$Token" --transport http --scope home
```

或者直接使用 setup 脚本一键设置:
```powershell
powershell -ExecutionPolicy Bypass -File setup.ps1 weiyun_set_token <你的Token>
```

## 授权链接展示模板

当第一步输出 `AUTH_REQUIRED:<url>` 时,向用户展示:

> 🔑 **需要先完成微云授权**
>
> 请在**浏览器**中打开以下链接完成授权:**[点击授权微云]({url})**
>
> ⚠️ 请使用 **QQ 或微信** 扫码 / 登录授权
>
> ⏰ **授权码有效期为 5 分钟**,请尽快完成授权,超时后需重新发起请求(重新执行第一步)
>
> ✅ **完成授权后,请回复我「已完成授权」,我会继续帮您完成操作**

> ⛔ **AI 注意**:展示上方授权链接后,**必须停止等待**,不得自动调用 `weiyun_fetch_token` 或任何其他工具。只有当用户在下一条新消息中明确回复确认后,才能继续执行第二步。

## 错误说明

| 错误 | 含义 |
|------|------|
| `ERROR:mcporter_not_found` | 缺少依赖,请先安装 Node.js |
| `ERROR:not_authorized` | 用户尚未在浏览器完成授权,等待用户确认后重试 |
| `ERROR:expired` | 授权码已过期,重新执行第一步 |
| `ERROR:token_invalid` | Token 鉴权失败,重新授权 |
| `ERROR:save_token_failed` | Token 写入配置失败 |
| `ERROR:no_code` | 未找到授权码,需重新执行第一步 |
| `ERROR:network` | 网络请求失败,检查网络后重试 |

references/mcp_api.md

# 微云 MCP API 完整参考

## 服务信息

- MCP 服务地址:`https://www.weiyun.com/api/v3/mcpserver`(Stateless HTTP 模式)

---

## Tool: weiyun.list — 目录列表查询

查询微云网盘的目录内容,支持按目录查看文件和子目录,支持分页和排序。

### 请求(McpListReq)

| 字段 | 类型 | 必填 | 说明 |
|------|------|------|------|
| get_type | uint32 | 否 | 获取类型:0-所有(默认),1-仅目录,2-仅文件,其他值返回所有 |
| offset | uint32 | 否 | 分页起始偏移量,从 0 开始 |
| limit | uint32 | **是** | 每页返回数量,最大 50 |
| order_by | uint32 | 否 | 排序字段:0-不排序(默认),1-按名字排序,2-按修改时间排序 |
| asc | bool | 否 | 排序方向:true-升序,false-降序(默认) |
| dir_key | string | 否 | 要查询的目录 key(hex 编码),为空则使用 token 绑定的 dirkey |
| pdir_key | string | 否 | 要查询的父目录 key(hex 编码),为空则使用 token 绑定的 pdirkey |

### 响应(McpListRsp)

| 字段 | 类型 | 说明 |
|------|------|------|
| pdir_key | string | 当前列表的父目录 key(hex 编码) |
| total_dir_count | uint32 | 子目录总数量 |
| total_file_count | uint32 | 文件总数量 |
| dir_list | McpDirItem[] | 目录列表 |
| file_list | McpFileItem[] | 文件列表 |
| finish_flag | bool | 是否已拉取完毕,true 表示已全部返回 |
| error | string | 错误信息,操作失败时返回具体的错误描述 |

### McpDirItem(目录项)

| 字段 | 类型 | 说明 |
|------|------|------|
| dir_key | string | 目录 key(hex 编码) |
| dir_name | string | 目录名称 |
| dir_ctime | int64 | 目录创建时间,单位毫秒 |
| dir_mtime | int64 | 目录修改时间,单位毫秒 |

### McpFileItem(文件项)

| 字段 | 类型 | 说明 |
|------|------|------|
| file_id | string | 文件唯一标识符 |
| filename | string | 文件名称 |
| file_size | int64 | 文件大小,单位字节 |
| file_ctime | int64 | 文件创建时间,单位毫秒 |
| file_mtime | int64 | 文件修改时间,单位毫秒 |
| pdir_key | string | 所在目录 key(hex 编码) |

### 注意事项

- 查询范围由 `mcp_token` 绑定的 `dirkey` 和 `pdirkey` 决定
- 腾讯文档类型的文件会被自动过滤,不出现在返回结果中

---

## Tool: weiyun.list_by_category — 按分类拉取文件列表

按微云文件分类分页拉取文件列表,支持文档、图片、视频等分类以及 `server_version` 续拉。

### 请求(McpListByCategoryReq)

| 字段 | 类型 | 必填 | 说明 |
|------|------|------|------|
| category_id | uint64 | 否 | 分类 ID(位运算值),有值时优先于 `lib_id` 和 `suffix_list`。例如:1-doc、2-excel、4-ppt、8-pdf、64-image、512-腾讯文档、4095-全部 |
| lib_id | int32 | 否 | 库 ID:1-文档,2-图片,3-音乐,4-视频,5-其他。`category_id` 有值时会忽略此字段 |
| local_version | string | 否 | 上次返回的 `server_version`,用于增量续拉;首次请求传空字符串 |
| group_id | int32 | 否 | 分组 ID。文档库:0-全部,1-doc,2-xls,3-ppt,4-pdf,50-腾讯文档 Doc,51-腾讯文档 Sheet,52-腾讯文档表单;图片/视频库可传相册分组 ID |
| suffix_list | string[] | 否 | 指定后缀列表,仅文档库和其他库有效,例如 `["docx", "xlsx"]` |
| count | int32 | **是** | 本次拉取数量,最大 100 |
| sort_type | int32 | 否 | 排序类型:0-创建时间,1-修改时间,2-名称,3-拍摄时间,4-大小 |
| is_desc_order | bool | 否 | 是否降序排列:true-降序(默认),false-升序 |

### 响应(McpListByCategoryRsp)

| 字段 | 类型 | 说明 |
|------|------|------|
| server_version | string | 服务端游标;下一次请求请回填到 `local_version` 以继续拉取 |
| finish_flag | bool | 是否已拉取完成,true 表示当前条件下已经没有更多结果 |
| file_list | McpFileItem[] | 分类文件列表(结构同 `weiyun.list` 的 `McpFileItem`) |
| error | string | 错误信息,操作失败时返回具体的错误描述 |

### 注意事项

- 该接口要求同时携带真实微云 cookie(如 `uid`、`uid_key`)和 `mcp_token`
- `category_id` 为位运算值,可组合使用(例如 `1 | 2 | 4 = 7` 表示 doc + excel + ppt)
- 首次请求 `local_version` 传空字符串,后续续拉时回填上次响应的 `server_version`
- 当 `finish_flag` 为 `true` 时表示已无更多数据

---

## Tool: weiyun.download — 批量下载

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

### 请求(McpDownloadReq)

| 字段 | 

references/upload_protocol.md

# 微云上传协议参考

## 1. 上传流程概览

```
MCP 客户端 (AI Agent)
    │
    │  1. 在本地计算 block_sha_list、check_sha、check_data
    │     (使用 scripts/gen_block_info_list.py 或等价逻辑)
    │
    ├─── 2. 预上传 ──→ weiyun.upload(upload_key="")
    │         │
    │         └── 返回: file_exist(是否秒传), upload_key, channel_list, ex
    │
    ├─── 3. 分片上传 (循环) ──→ weiyun.upload(upload_key="xxx")
    │         │
    │         └── 返回: upload_state(1=继续/2=完成/3=等待), channel_list, ex
    │
    └─── 4. 完成 (upload_state == 2)
```

**关键原则**:哈希计算在**客户端**完成。服务端在预上传阶段不接收原始文件数据用于哈希计算。

## 2. 预上传参数说明

预上传时需要提供以下参数(通过 `weiyun.upload` MCP Tool 传入):

| 参数 | 类型 | 必填 | 说明 |
|------|------|------|------|
| filename | string | **是** | 文件名称 |
| file_size | uint64 | **是** | 文件大小(字节) |
| file_sha | string | **是** | 整个文件的 SHA1(40 字符 hex),必须等于 block_sha_list 最后一个值 |
| file_md5 | string | 否 | 整个文件的 MD5(32 字符 hex),用于秒传校验 |
| block_sha_list | string[] | **是** | 分块 SHA1 列表(每个 40 字符 hex) |
| check_sha | string | **是** | SHA1 校验中间状态(40 字符 hex) |
| check_data | string | 否 | 文件末尾校验字节的 Base64 编码 |
| pdir_key | string | 否 | 上传目标目录 key(不填使用 token 绑定目录) |

### 预上传响应判断

- `file_exist=true` → 秒传成功,上传完毕
- `file_exist=false` → 使用返回的 `upload_key`、`channel_list`、`ex` 进行分片上传

## 3. 分片上传参数说明

| 参数 | 类型 | 必填 | 说明 |
|------|------|------|------|
| upload_key | string | **是** | 预上传返回的 upload_key |
| channel_list | McpChannelInfo[] | **是** | 预上传返回的通道列表 |
| channel_id | uint32 | **是** | 使用的通道编号 |
| ex | string | **是** | 预上传返回的扩展字段 |
| file_data | bytes | **是** | 分片数据(JSON 传输时为 base64) |
| filename | string | **是** | 文件名称 |

### 上传状态

| 状态码 | 含义 |
|--------|------|
| 1 | 需要上传下一分片 |
| 2 | 上传完成 |
| 3 | 等待其他通道完成 |

## 4. 分块 SHA1 算法 — 详细步骤

### 常量

- `BLOCK_SIZE = 524288`(512KB)

### 文件大小派生变量

```
lastBlockSize = file_size % BLOCK_SIZE
如果 lastBlockSize == 0:lastBlockSize = BLOCK_SIZE

checkBlockSize = lastBlockSize % 128
如果 checkBlockSize == 0:checkBlockSize = 128

beforeBlockSize = file_size - lastBlockSize
```

### 逐步算法

```
sha1 = new SHA1()   // 单个共享的 SHA1 对象

// 第一步:处理最后一块之前的所有块
for offset in range(0, beforeBlockSize, BLOCK_SIZE):
    data = read_file(offset, BLOCK_SIZE)
    sha1.update(data)
    block_sha_list.append(sha1.get_internal_state_little_endian())
    // get_internal_state_little_endian() 返回 h0-h4 以小端序输出的 20 字节 hex 编码

// 第二步:处理最后一块的前半部分,计算 check_sha
between_data = read_file(beforeBlockSize, lastBlockSize - checkBlockSize)
sha1.update(between_data)
check_sha = sha1.get_internal_state_little_endian()

// 第三步:处理文件末尾的 checkBlockSize 字节
check_data_bytes = read_file(file_size - checkBlockSize, checkBlockSize)
sha1.update(check_data_bytes)
file_sha = sha1.hexdigest()  // 标准 SHA1 含 finalization(大端序)
check_data = base64_encode(check_data_bytes)

// 第四步:最后一块的 sha = file_sha(不是内部状态!)
block_sha_list.append(file_sha)
```

### 内部状态提取(get_state)

`get_state()` 函数读取 SHA1 内部寄存器 h0-h4(每个 32 位),以**小端序**字节顺序输出:

```python
result = b""
for h in (h0, h1, h2, h3, h4):
    result += struct.pack("<I", h)  # 小端序 uint32
return result.hex()  # 40

Sponsored

Ads related to Weiyun Skills and adjacent AI workflows.