阿里邮箱管理

任务目标

• 本 Skill 用于：管理阿里邮箱用户和邮件数据
• 能力包含：用户信息查询、邮件详情获取、邮件列表搜索、分页查询
• 触发条件：用户需要查询企业邮箱用户、查看邮件内容、搜索邮件列表

前置准备

• 依赖说明：需要安装阿里邮箱SDK

```bash

npm install alimail-node-sdk

```

• 认证方式：OAuth2 client_credentials
• 必填环境变量：
• ALMAIL_APP_ID：阿里邮箱应用 ID
• ALMAIL_SECRET：阿里邮箱应用 Secret

操作步骤

标准流程

1. 执行具体操作
• 获取用户信息：调用 scripts/get_user.js
• 获取邮件详情：调用 scripts/get_message.js
• 搜索邮件：调用 scripts/search_messages.js

1. 处理结果
• 解析返回的JSON数据
• 根据业务需求提取关键信息
• 提供清晰的总结和建议

可选分支

• 当 需要获取扩展字段：在参数中指定 select 字段
• 当 需要分页查询：使用 search_messages.js 的 cursor 机制
• 当 遇到API限流：SDK会自动处理重试，建议适当降低请求频率

资源索引

• API参考：
• references/alimail-api.md (何时读取：需要了解API参数、字段定义、KQL查询语法)

注意事项

• 邮件搜索支持KQL查询语法，详见参考文档
• 使用时必须配置 ALMAIL_APP_ID 和 ALMAIL_SECRET

使用示例

示例1：获取用户信息

node scripts/get_user.js --email "zhangsan@example.com" --select "phone,managerInfo"

示例2：获取邮件详情

node scripts/get_message.js --email "zhangsan@example.com" --message-id "AAMkAGI2T..." --select "body,toRecipients"

示例3：搜索邮件

node scripts/search_messages.js --email "zhangsan@example.com" --query 'fromEmail="alice@example.com"' --size 20