核心用法
该技能提供完整的 Microsoft Excel API（Microsoft Graph）代理能力，通过 Maton 托管的 OAuth 服务实现免配置接入。用户仅需获取 Maton API Key，即可对存储于 OneDrive 或 SharePoint 的 .xlsx 文件执行全量操作。
关键操作路径：
1. 连接管理：在 ctrl.maton.ai 创建/管理 OAuth 连接，支持多账户切换（通过 Maton-Connection 头部指定）
2. 文件定位：支持文件 ID 或路径两种模式访问工作簿
3. 数据操作：涵盖工作表（增删改）、单元格范围（读写/公式/格式）、表格（结构化数据）、图表（可视化）四大对象
4. 会话优化：对批量操作启用 createSession 可提升性能，会话约 5-7 分钟过期
典型场景代码：
# 读取单元格
GET .../range(address='A1:B10')
# 批量写入
PATCH .../range(address='A1:C4') {"values": [...]}
# 创建结构化表格
POST .../tables/add {"address": "A1:D10", "hasHeaders": true}显著优点
- 零配置接入：无需在 Azure AD 注册应用程序、配置重定向 URI、管理客户端密钥
- 原生 API 完整映射：直接透传 Microsoft Graph Excel 端点，功能对齐官方文档
- 多连接管理：支持同一用户绑定多个微软账户，通过头部灵活切换
- 企业级存储兼容：同时支持个人 OneDrive 和商业 SharePoint Online
- 会话机制：官方推荐的
workbook-session-id优化方案已内置支持
潜在局限
- 格式限制：仅支持
.xlsx（Open XML），不兼容传统.xls二进制格式 - URL 编码负担：工作表名含特殊字符、UUID 格式的表格 ID 需手动编码
- 网关依赖：所有请求需经过
gateway.maton.ai中转，存在单点延迟和可用性风险 - OAuth 管控：微软账户授权流程需在 Maton 控制面板完成，无法全自动化
- 环境变量陷阱：
$MATON_API_KEY在管道到jq等工具时可能解析失败（文档已警示）
适合人群
- 自动化脚本开发者：需程序化读写 Excel 的数据工程师、财务分析师
- 低代码集成场景：不愿维护微软 OAuth 令牌刷新逻辑的中小型团队
- 多账户管理需求：同时操作个人与工作微软账户的用户
常规风险
- 数据驻留：文件内容通过第三方网关（Maton）中转，虽使用 HTTPS，但需信任中间方
- 密钥泄露：
MATON_API_KEY泄露将导致账户内所有微软连接被滥用 - API 限流：微软 Graph API 存在调用配额，高频场景需处理 429 状态码
- 会话过期：长耗时批处理任务需监控会话有效期，避免操作中断