工具参数说明

本文档详细说明 Skill 模式支持的所有工具及其参数。

调用方式

命令行调用

python3 executor.py <tool-name> [param1=value1] [param2=value2]

Python 代码调用

from executor import MCPExecutor

executor = MCPExecutor()
result = executor.execute("file-list", path="/")
executor.close()

查询类工具

file-list

获取云盘指定路径下的文件和文件夹列表，支持分页查询。返回文件名、大小、创建时间、修改时间等详细信息。

参数

参数名	类型	必填	说明
path	string	❌	要查询的云盘路径，默认为根目录 '/'
page	number	❌	页码，默认从 0 开始
page_size	number	❌	每页显示的条目数，默认 50 条

示例

# 列出根目录
python3 executor.py file-list path=/

# 列出指定目录，带分页
python3 executor.py file-list path=/文档/ page=0 page_size=20

# 列出子目录
python3 executor.py file-list path=/工作/项目/

---

file-search

在云盘中根据关键词搜索文件和文件夹，支持按文件类型筛选和分页查询。返回符合条件的文件详细信息。

参数

参数名	类型	必填	说明
key	string	❌	搜索关键词，当 file_category 不为 -1 时可以为空，否则必填
file_category	number	❌	文件类型筛选：-1(全部)、0(其他)、1(图片)、2(文档)、3(音乐)、4(视频)
page	number	❌	页码，从 1 开始
page_size	number	❌	每页显示的条目数，默认 20 条，最大 100 条

示例

# 搜索包含"报告"的文件
python3 executor.py file-search key=报告

# 搜索所有文档类型文件
python3 executor.py file-search file_category=2

# 搜索图片，带分页
python3 executor.py file-search file_category=1 page=1 page_size=50

# 搜索视频文件
python3 executor.py file-search key=会议 file_category=4

---

user-info

获取 360 AI 云盘用户详细信息。

参数

无参数

示例

python3 executor.py user-info

返回信息

• 用户昵称
• 会员状态
• 总空间 / 已用空间 / 剩余空间
• 会员到期时间

---

get-download-url

获取云盘中文件的下载链接。可以通过文件 NID 或路径获取。

参数

参数名	类型	必填	说明
nid	string	❌	文件 NID，与 fpath 二选一必填
fpath	string	❌	文件路径，与 nid 二选一必填

示例

# 通过路径获取下载链接
python3 executor.py get-download-url fpath=/文档/报告.pdf

# 通过 NID 获取下载链接
python3 executor.py get-download-url nid=1234567890

---

操作类工具

make-dir

在云盘中创建新文件夹，支持指定路径。

参数

参数名	类型	必填	说明
fname	string	✅	要创建的文件夹完整路径，例如：/新文件夹/ 或 /文档/子文件夹/

示例

# 在根目录创建文件夹
python3 executor.py make-dir fname=/新文件夹/

# 在指定目录创建子文件夹
python3 executor.py make-dir fname=/文档/项目文件/

# 创建多级目录
python3 executor.py make-dir fname=/工作/2024/项目/

注意

文件夹路径必须以 / 开头和结尾

---

file-move

移动云盘中的文件或文件夹到指定位置。支持批量移动多个文件。

参数

参数名	类型	必填	说明
src_name	string	✅	源文件或文件夹路径，多个文件用竖线(|)分隔
new_name	string	✅	目标文件夹路径，例如：/目标文件夹/

示例

# 移动单个文件
python3 executor.py file-move src_name=/文件.txt new_name=/文档/

# 移动文件夹
python3 executor.py file-move src_name=/旧文件夹/ new_name=/归档/

# 批量移动多个文件
python3 executor.py file-move src_name=/文件1.txt|/文件2.txt|/文件3.txt new_name=/目标文件夹/

---

file-rename

重命名云盘中的文件或文件夹。

参数

参数名	类型	必填	说明
src_name	string	✅	原文件或文件夹的完整路径
new_name	string	✅	新的名称（仅文件名或文件夹名，不含父路径）

示例

# 重命名文件
python3 executor.py file-rename src_name=/文档/旧名称.doc new_name=新名称.doc

# 重命名文件夹
python3 executor.py file-rename src_name=/旧文件夹/ new_name=新文件夹/

注意

• 重命名文件夹时，新名称需要以 / 结尾
• new_name 只需要提供新名称，不需要包含父路径

---

file-share

生成云盘文件的分享链接。支持批量生成多个文件的分享链接。

参数

参数名	类型	必填	说明
paths	string	✅	要分享的文件全路径，多个文件用竖线(|)隔开

示例

# 分享单个文件
python3 executor.py file-share paths=/文档/报告.pdf

# 批量分享多个文件
python3 executor.py file-share paths=/文件1.txt|/文件夹2/文件2.txt|/图片/照片.jpg

---

file-save

通过 URL 或文本内容保存文件到云盘。

参数

参数名	类型	必填	说明
url	string	❌	文件下载地址；与 content 互斥且二选一
content	string	❌	文件内容（建议为 MD 文本）；与 url 互斥且二选一
upload_path	string	❌	云盘存储路径，必须以 / 开头和结尾。默认为 '/AI为我下载/YYYYMMDD/'
file_name	string	❌	保存到云盘的文件名，不含路径。如不填写则自动解析

示例

# 从 URL 下载并保存
python3 executor.py file-save url=https://example.com/document.pdf upload_path=/下载/

# 保存文本内容
python3 executor.py file-save content="# 会议笔记\n\n## 议题\n\n1. 项目进度" file_name=meeting-notes.md

# 保存到指定目录
python3 executor.py file-save url=https://example.com/image.jpg upload_path=/图片/收藏/ file_name=收藏图片.jpg

提示

• 使用 url 和 content 二选一
• 不指定 upload_path 时，默认保存到 /AI为我下载/YYYYMMDD/ 目录
• 不指定 file_name 时，会自动从 URL 解析文件名

---

输出格式

成功输出

{
  "success": true,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "操作成功！..."
      }
    ],
    "data": {...}
  }
}

错误输出

{
  "success": false,
  "error": "执行 MCP 工具失败: ..."
}

路径格式规范

类型	格式要求	正确示例	错误示例
文件路径	以 / 开头	/文档/报告.pdf	文档/报告.pdf
文件夹路径	以 / 开头和结尾	/文档/项目/	/文档/项目
多个文件	用 | 分隔	/文件1.txt|/文件2.txt	/文件1.txt,/文件2.txt

下一步

• 配置说明 - 详细的环境变量和连接模式配置
• Skill 模式介绍 - Skill 模式的概述和快速开始
• MCP Server 文档 - MCP Server 的完整文档