跳到主要内容

CLI 模型介绍

360disk 是 360 AI 云盘的命令行入口，由 @aicloud360/mcp-server-disk 包提供（自 v0.8.0 起支持，含后续版本）。

它既可被开发者直接使用，也可被 AI Agent 作为 CLI Skill 调用。

CLI 模型的定位​

CLI 模型 = 360disk 命令体系 + 标准化输出协议 + 可脚本化运行方式。

典型链路：

Human/Agent -> 360disk command -> Services(DirOps/FileOps/CloudOps/UserOps) -> 360 OpenAPI

与 MCP Server / MCP Skill 的关系：

  • CLI 与 MCP Server 复用同一 Service 层，能力口径一致。
  • CLI Skill 只是把用户意图映射成 360disk 命令执行，不引入额外 API。

当前能力总览​

命令组与命令数​

共 5 个命令组，18 个命令：

  • auth: login / whoami / logout
  • user: info
  • dir: ls / mkdir
  • file: mv / rename / rm / search / share / url / save / upload / download
  • completion: install / uninstall / script

全局参数​

  • --api-key
  • --env
  • --sub-channel
  • --format json|text
  • --quiet
  • --timeout
  • --retries

鉴权优先级：--api-key > API_KEY > ~/.360disk/config.json

输出协议​

默认返回统一 CLIResponse：

{
  "success": true,
  "result": {},
  "meta": { "duration_ms": 123, "command": "dir ls" }
}
  • --format text：输出可读文本
  • --quiet：只输出 result，适合管道处理

错误码模型​

CLI 内置语义化错误码（如 AUTH_ERROR=3、NETWORK_ERROR=6、SERVER_ERROR=8），便于脚本和 Agent 做分支处理。

CLI Skill（面向 Agent）​

CLI Skill 使用 skill-cli-output/360disk-cli/SKILL.md 作为意图映射层，直接执行 360disk ...。

适合：

  • Claude Code / Cursor / Windsurf 等可执行 shell 的 Agent
  • 自动化流水线和批量任务
  • 强依赖 jq、管道、批处理的场景

何时选择 CLI 模型​

优先选 CLI 模型，当你需要：

  • 可观测、可重试、可组合的命令执行链路
  • 稳定 JSON 输出用于程序消费
  • 本地文件上传/下载与脚本编排

如果你更偏向 MCP Tool 原生调用，可参考 Skills 模型介绍 或 MCP Server 文档。

快速开始​

# 安装
npm install -g @aicloud360/mcp-server-disk

# 登录
360disk auth login --api-key <API_KEY>

# 列目录
360disk dir ls /

# 搜索并下载
NID=$(360disk --quiet file search "月报" | jq -r '.data.list[0].nid')
360disk file download "$NID" --dir ./output

相关文档​