Yandex 360 CLI (Disk, Calendar, Mail)

通过 Yandex OAuth API 的 Yandex 网盘、日历、邮件命令行工具

安装

概览

Yandex 360 CLI(简称 yax)是一款专为 Yandex 云生态设计的命令行工具,通过官方 OAuth API 实现对 Yandex 网盘、日历和邮件服务的自动化操作。该工具采用 Node.js 编写,无需依赖外部服务即可独立运行,适合开发者和系统管理员在脚本化流程中集成个人或企业 Yandex 360 资源管理。尽管其功能覆盖核心办公场景,但受限于 Yandex 对邮件服务的接口策略,目前仅支持信息查询与 SMTP 发送,无法进行完整的收件箱管理。整体架构简洁高效,所有通信均基于标准 HTTP 协议完成,不依赖第三方中间件,确保在受限网络环境中的可用性。

核心功能特点

  1. 支持 Yandex 网盘基础操作:包括目录信息查看、文件列表浏览、新建文件夹、上传本地文件至云端以及下载远程文件到本地
  2. 提供日历事件管理能力:可通过 CalDAV 协议列出用户所有日历,并创建带时区感知的新日程项,适用于自动化任务调度
  3. 实现邮件基本功能:虽无完整 IMAP/SMTP 客户端,但可通过 SMTP 发送邮件,同时展示账户基本信息,满足轻量级通知需求
  4. 完全基于 OAuth 2.0 认证机制,保障用户数据安全,避免明文存储凭据
  5. 纯 JavaScript 实现,无外部运行时依赖,部署灵活,兼容主流操作系统

适用场景

Yandex 360 CLI 特别适合需要在自动化脚本中调用 Yandex 云服务的技术用户。例如,运维人员可在 CI/CD 流程中自动上传构建产物至 Yandex 网盘,或将日志归档到指定路径;开发者则可利用其快速生成日历提醒,辅助测试计划安排。对于使用 Yandex 360 作为主要办公套件的小型企业或个人用户,该工具可替代图形界面完成日常文件同步与会议管理,提升工作效率。尽管邮件功能受限,但在仅需发送告警通知或批量消息的场景下仍具实用价值。由于全程采用标准 Web API 交互,即使在容器化平台如 Railway 上也能稳定运行,不受传统端口封锁影响。