Microsoft 365 全栈命令行管家

Microsoft 365 全能 CLI 工具，一站式管理邮件、日历、网盘、文档等生产力套件，自动化办公首选

基本信息

• 技能名称?Mog
• 中文名称?Microsoft 365 全栈命令行管家
• 作者?visionik
• 分类?专业技能
• 版本?0.3.1
• 标签?cli, microsoft-365, automation, productivity, oauth, mail, calendar, onedrive, excel, onenote

使用方法

使用说明
核心用法
mog 是一款面向 Microsoft 365 生态的命令行工具，支持 9 大模块：Mail、Calendar、OneDrive、Contacts、Tasks、Word、PowerPoint、Excel、OneNote。采用统一的 OAuth 认证体系，通过 8 字符 slug 简化冗长的微软 GUID，支持管道操作和脚本自动化。
典型工作流 ：
邮件：搜索、发送（支持 Markdown/HTML/文件管道）、管理附件
日程：创建会议、查询空闲时间、ACL 权限管理
网盘：完整的文件操作（ls/upload/download/mkdir/move 等）
办公文档：Excel 单元格级读写、OneNote 笔记本管理、Word/PPT 批量导出
显著优点

1. 统一体验 ：与 gog （Google Ops Gadget）设计一致，跨云切换零成本
2. slug 系统 ：将微软 100+ 字符的 GUID 压缩为 8 位可读标识，命令行友好
3. 管道原生 ： cat draft.txt | mog mail send 支持标准 Unix 管道
4. 多格式支持 ：邮件正文支持纯文本、Markdown、HTML 三种模式
5. 企业级覆盖 ：包含目录查询（contacts directory）、空闲时间查询（freebusy）等商务场景
   潜在局限
   OAuth 依赖 ：需预先配置 Microsoft Graph API 权限，企业租户可能需要管理员审批
   功能边界 ：Excel 仅支持基础单元格操作，复杂公式/图表需借助原生工具
   平台锁定 ：专属于 Microsoft 365，不支持本地 Office 或其他云服务
   令牌持久化 ：虽采用 OS 级加密（0600 权限），但本地存储仍存在潜在泄露面
   适合人群
   DevOps/SRE 工程师：自动化报告发送、日程编排
   企业管理员：批量用户目录查询、权限审计
   开发者：将 Office 文档操作集成到 CI/CD 或内部工具链
   重度 CLI 用户：厌倦了 Outlook Web 界面的效率追求者
   常规风险
   权限过大 ：默认申请 Mail.ReadWrite、Calendars.ReadWrite 等广泛权限，需按需最小化
   令牌泄露 ： tokens.json 若被窃取可导致完整邮箱/网盘访问
   误操作 ： mog tasks clear 、 mog drive rm 等命令无二次确认，脚本中需谨慎
   API 限流 ：Microsoft Graph 存在调用配额，高频自动化需处理 429 错误