阿里邮箱自动化 Skill

这是一个面向中文用户的 Codex Skill，用于在 Codex 中通过自然语言自动化阿里邮箱企业版。

安装后，用户不需要记忆底层脚本命令。直接在 Codex 里说明要做什么，Codex 会根据 SKILL.md、INDEX.md 和 references/ 自动选择合适的脚本、处理登录态、读取邮箱界面，并在需要时要求确认。

推荐用法

适合这样对 Codex 说：

• 帮我总结今天收件箱里的重要邮件。
• 帮我查找最近一周带附件的邮件，并列出附件名。
• 帮我从指定文件夹里找出和某个项目相关的邮件。
• 帮我把搜索结果整理成摘要，不需要展示完整正文。
• 帮我基于这封邮件创建回复草稿，但不要发送。
• 帮我把测试文件夹中符合条件的邮件移动到另一个文件夹，执行前先让我确认。

这个 Skill 更适合稳定、可重复、低干扰的自动化任务。尤其推荐用于摘要、搜索、快照、附件发现、草稿准备，以及经过确认的标记/移动等邮箱整理工作。

不建议把它用于无人值守发送邮件、删除邮件、修改邮箱设置、大批量高风险变更，或每封邮件都需要人工判断的任务。

首次登录会发生什么

首次使用涉及邮箱内容的任务时，Codex 会先初始化一个专用浏览器会话。

默认设置项：

• 登录入口：https://qiye.aliyun.com/
• 推荐邮箱界面：阿里邮箱 v5.1
• 默认 CDP 端口：9222
• 默认 profile：default
• 运行时目录：.runtime/profiles/<profile>/
• 会话文件：session-state.json 和 session-meta.json

如果还没有保存登录态，Codex 会打开一个可见浏览器窗口让用户登录。用户完成登录后，Codex 会保存筛选后的会话状态，关闭临时登录窗口，重新启动无头浏览器，并把后续自动化连接到这个无头浏览器中。

.runtime/ 是私有运行时目录，包含浏览器 profile 和筛选后的会话状态。不要提交、分享或复制其中的内容。

命令行安装

推荐通过 npm 包安装。安装命令会把 Skill 文件复制到 Codex 的 skills 目录中，而不是要求用户手动运行底层邮箱脚本。

Windows PowerShell

npx @crafteverywhere/alimail-automation-skill@latest install

macOS / Linux

npx @crafteverywhere/alimail-automation-skill@latest install

安装后，重启 Codex 或开启一个新会话，让技能索引刷新。之后直接用中文自然语言调用即可。

如果你是从 GitHub 克隆源码进行开发，也可以在仓库目录中运行：

node scripts/install-skill.mjs install --force

更新已安装版本

Windows PowerShell：

npx @crafteverywhere/alimail-automation-skill@latest install --force

macOS / Linux：

npx @crafteverywhere/alimail-automation-skill@latest install --force

安全规则

• 不保存明文密码。
• 永远不要展示 cookie 值、密码或原始 session storage。
• 发件人/收件人、主题、正文、附件名等邮件内容，可以在用户明确要求查看具体邮件，或任务本身确实需要时展示。
• 无人值守日志、批量报告和后台自动化输出默认应尽量克制；优先使用摘要、片段、计数、hash 和 fingerprint，除非用户明确选择展示邮件原文。
• 附件内容不要直接粘贴到对话中，除非用户明确要求查看；更推荐下载到明确指定的本地目录。
• 只读操作可以自动运行。
• 草稿操作只应保存草稿，不自动发送邮件。
• 标记、移动、打标签、删除、发送和设置变更都需要明确确认，并在执行前重新校验目标。
• 读取邮件详情可能会把未读邮件标记为已读；只有在已知邮件为已读，或用户接受这个副作用时才应打开详情。

自动化最佳实践

• 让任务范围尽量明确：文件夹、关键词、时间窗口和数量上限越清楚，结果越稳定。
• 先做搜索、摘要、快照或 dry-run 计划，再执行任何会改变邮箱状态的操作。
• 默认报告使用 fingerprint、hash、摘要和片段；只有在用户明确要求时展示邮件原文。
• 在专用测试文件夹里验证标记和移动规则，再应用到真实文件夹。
• 为不同账号、租户或定时任务使用不同 profile。
• 当阿里邮箱提示重新登录，或接口返回认证错误时，让 Codex 重新初始化会话。
• 定时任务和无人值守任务应优先保持只读。相比实时改动邮箱，摘要、快照、附件发现和草稿准备更适合作为默认自动化。

目录结构

• SKILL.md：Skill 入口和运行规则。
• INDEX.md：脚本路由索引。
• references/：按需加载的参考文档。
• scripts/latest/runner/：CDP、会话、RPC、并发和写入辅助模块。
• scripts/latest/atomic/：底层邮箱操作。
• scripts/latest/composite/：面向用户任务的组合工作流。
• tests/smoke/：基础校验、隐私扫描和计划契约测试。