跳到主要内容

CLI 模型介绍

360disk 是 360 AI 云盘的命令行入口，由 @aicloud360/360-ai-cloud-disk-cli 包提供（自 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。

当前能力总览​

命令组与命令数​

共 8 个顶级命令组，31 个子命令：

  • auth: login / login-wechat / whoami / logout
  • user: info
  • dir: ls / mkdir
  • file: mv / trans-copy / rename / rm / search / share / url / node-info / origin-size / clear-dir / config / save / append / exists / upload / download
  • claw-backup: 递归将本地目录备份到云盘（--source-dir / --claw-name）
  • claw-restore: 递归将云盘目录恢复到本地（--remote / --target）
  • claw-auto-backup: enable / disable / status —— 监听本地目录变化并防抖触发备份
  • 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、扫码相关 22–27），便于脚本和 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/360-ai-cloud-disk-cli

# 登录（API Key 或微信扫码二选一）
360disk auth login --api-key <API_KEY>
# 或：360disk auth login-wechat（可加 --env test；Agent 建议 --format json 解析两行，或 --qr-mode file 仅首行给 PNG 路径）

# 列目录
360disk dir ls /

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

# 递归备份本地目录到云盘 / 从云盘恢复（可选）
360disk claw-backup --source-dir ~/.cc-switch --claw-name /cc-switch-backup/ --force
360disk claw-restore --remote /cc-switch-backup/ --target ~/.cc-switch-restored

# 启用目录变更自动备份（后台常驻进程，详见命令参考）
360disk claw-auto-backup enable --source-dir ~/.cc-switch --claw-name /cc-switch-backup/

相关文档​