360 AI 云盘 CLI

@aicloud360/360-ai-cloud-disk-cli 是 360 AI 云盘的官方命令行工具（命令名：360disk）。它提供了 30 个强大的文件操作和云盘管理命令，支持结构化 JSON 输出，非常适合终端用户和 AI Agent 通过 Shell 直接调用。

结合 360-ai-cloud-disk-cli-skill（CLI Skill），它可以让任意支持执行系统命令的智能体框架（如 Claude Code, OpenClaw, OpenCode, Cursor 等）快速拥有云盘文件感知和读写能力。

安装

npm install -g @aicloud360/360-ai-cloud-disk-cli

或者使用 npx 零安装运行：

npx -y @aicloud360/360-ai-cloud-disk-cli@latest dir ls /

快速开始

1. 登录鉴权

360disk auth login --api-key <你的_API_KEY>

登录成功后，配置将保存在 ~/.360disk/config.json 中。 (API_KEY 可在 360 AI 云盘 Web 端开发者中心获取。)

2. 常用操作示例

# 查看用户信息
360disk user info

# 列出根目录文件
360disk dir ls /

# 搜索文件
360disk file search "工作汇报"

# 获取文件真实下载链接（带时效和防盗链）
360disk file url <file_id>

# 上传本地文件到云盘目录
360disk file upload ./local-file.txt /remote-dir/

# 下载云盘文件到本地目录
360disk file download <file_id> ./local-dir/

# 分享文件（生成分享链接和提取码）
360disk file share /文档/报告.pdf

# 递归备份本地目录到云盘
360disk claw-backup --source ~/.cc-switch --dest /cc-switch-backup/

# 递归恢复云盘目录到本地
360disk claw-restore --remote /cc-switch-backup/ --target ~/.cc-switch-restored

# 启动自动备份监听
360disk claw-auto-backup enable --source ~/.cc-switch --dest /cc-switch-backup/

命令组概览

本 CLI 工具提供 8 个顶级命令/命令组共 30 个子命令，覆盖绝大部分云盘核心能力：

• auth: login / 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 / --dest —— 递归上传本地目录到云盘目录
• claw-restore: --remote / --target —— 递归恢复云盘目录到本地目录
• claw-auto-backup: enable / disable / status —— 监听目录变化并自动备份到云盘
• completion: install / uninstall / script —— Shell 自动补全

高级特性

• 结构化输出：所有命令默认返回 JSON（包含 success, result, meta），同时支持 --format text 和 --quiet 模式。
• 统一错误码：提供语义化的错误码并与进程退出码对应，极利于自动化脚本集成。
• 管道集成：支持 stdin 输入、批量操作，可完美与 jq 等终端利器组合。
• 超时/重试：内建 --timeout 和 --retries 全局稳定选项。

更多资源

• Skills 仓库: 如果你正在开发 AI Agent，推荐搭配 360-ai-cloud-disk-cli-skill 使用。
• 在线文档: 360 AI 云盘开放平台文档
• 问题反馈: 提交 Issue 到 yifangyun/ecs-yunpan-skills

许可证

Apache-2.0