工具参数说明

本文档详细说明 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()

CLI Skill 入口说明

本文档是 MCP Skill（executor.py） 的工具参数说明。
如果你使用 CLI Skill，建议通过 DISK_360_CLI='npx -y -p @aicloud360/360-ai-cloud-disk-cli@latest 360disk' 作为统一执行入口，详见 Skills 模型介绍 与 CLI Skill 接入指南。

查询类工具

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

返回信息

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

---

file-share

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

参数

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

示例

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

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

---

get-download-url

获取指定文件的下载链接，支持自动下载或仅返回链接（与 file-download-stdio 功能互补）。

参数

参数名	类型	必填	说明
path	string	✅	文件在云盘中的完整路径，必须以 / 开头
auto	boolean	❌	是否自动下载：true 为自动下载，false 为仅返回链接（默认 false）

示例

# 仅获取下载链接
python3 executor.py get-download-url path=/文件夹/报告.pdf

# 自动下载到默认目录
python3 executor.py get-download-url path=/文件夹/报告.pdf auto=true

# 自动下载到指定本地目录
python3 executor.py get-download-url path=/文件夹/报告.pdf auto=true downloadDir=/Users/qihoo/Downloads/

---

file-save

通过 URL 或文本内容保存文件到云盘（每个 URL 须单独一次调用）。

参数

参数名	类型	必填	说明
url	string	❌	单个文件下载地址；与 content 互斥且二选一（勿用 | 拼接多个 URL）
content	string	❌	文件内容（建议为 MD 文本）；与 url 互斥且二选一
upload_path	string	❌	云盘存储路径，必须以 / 开头和结尾。默认为 /AI为我下载/YYYYMMDD/
file_name	string	❌	保存到云盘的文件名，不含路径。如不填写则自动解析
is_rename	number	❌	同名文件处理策略：0=直接替换原文件，1=自动重命名。默认 1

示例

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

# 多个 URL 须多次调用（勿使用 url1|url2）
python3 executor.py file-save url=https://example.com/a.pdf upload_path=/下载/
python3 executor.py file-save url=https://example.com/b.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 is_rename=0

提示

• 使用 url 和 content 二选一
• 不指定 upload_path 时，默认保存到 /AI为我下载/YYYYMMDD/ 目录
• 不指定 file_name 时，会自动从 URL 解析文件名
• 多个下载链接请循环多次调用本工具，每次一个 url

返回说明

• 单文件保存时，返回单个任务结果，包含任务 ID、云盘路径、文件大小等信息。
• 多文件保存时，返回批量任务结果列表；Skill 展示层会逐项输出每个任务的保存结果。

---

输出格式

成功输出

{
  "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 的完整文档