{"_id":"@crafteverywhere/alimail-automation-skill","name":"@crafteverywhere/alimail-automation-skill","dist-tags":{"latest":"0.1.0"},"versions":{"0.1.0":{"name":"@crafteverywhere/alimail-automation-skill","version":"0.1.0","description":"Codex skill for automating AliMail Enterprise through a local authenticated browser profile.","type":"module","bin":{"alimail-skill":"scripts/install-skill.mjs"},"scripts":{"validate":"node tests/smoke/validate-skill.mjs && node tests/smoke/validate-privacy.mjs && node tests/smoke/validate-plans.mjs && node tests/smoke/validate-installer.mjs","validate:privacy":"node tests/smoke/validate-privacy.mjs","validate:plans":"node tests/smoke/validate-plans.mjs","validate:installer":"node tests/smoke/validate-installer.mjs","install-skill":"node scripts/install-skill.mjs","cli":"node scripts/latest/runner/cli.mjs","status":"node scripts/latest/runner/cli.mjs status","session-summary":"node scripts/latest/runner/cli.mjs session-summary","list-visible":"node scripts/latest/runner/cli.mjs list-visible"},"repository":{"type":"git","url":"git+https://github.com/crafteverywhere/alimail-helper.git"},"bugs":{"url":"https://github.com/crafteverywhere/alimail-helper/issues"},"homepage":"https://github.com/crafteverywhere/alimail-helper#readme","keywords":["codex","skill","alimail","automation"],"engines":{"node":">=20"},"gitHead":"6fbd7d8f0c260d963378f4b8249ce53685815ec7","_id":"@crafteverywhere/alimail-automation-skill@0.1.0","_nodeVersion":"24.13.1","_npmVersion":"11.8.0","dist":{"integrity":"sha512-odIfYbJcjHTF+m+I/+ieBgOeoaz4+K+NwFE14xg415mR+wb0SBeFfxkhrd7qEECkVHzv1khRSbbR3K/G3wIlIQ==","shasum":"c1f489f09e9a4bc18561c80900a155b7aa8d578b","tarball":"https://registry.npmjs.org/@crafteverywhere/alimail-automation-skill/-/alimail-automation-skill-0.1.0.tgz","fileCount":43,"unpackedSize":211498,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQD7pNz1VTlYSNXhKHPPKzcEfD9M4oL/+lDqg5tWmDCCZQIgWYUGS079J6qUbqz2JpXxwhfSJGGoIefcqAegFOokOsU="}]},"_npmUser":{"name":"crafteverywhere","email":"crafteverywhere1990@gmail.com"},"directories":{},"maintainers":[{"name":"crafteverywhere","email":"crafteverywhere1990@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/alimail-automation-skill_0.1.0_1780127816162_0.45866789022495946"},"_hasShrinkwrap":false}},"time":{"created":"2026-05-30T07:56:55.946Z","0.1.0":"2026-05-30T07:56:56.308Z","modified":"2026-05-30T07:56:56.564Z"},"maintainers":[{"name":"crafteverywhere","email":"crafteverywhere1990@gmail.com"}],"description":"Codex skill for automating AliMail Enterprise through a local authenticated browser profile.","homepage":"https://github.com/crafteverywhere/alimail-helper#readme","keywords":["codex","skill","alimail","automation"],"repository":{"type":"git","url":"git+https://github.com/crafteverywhere/alimail-helper.git"},"bugs":{"url":"https://github.com/crafteverywhere/alimail-helper/issues"},"readme":"# 阿里邮箱自动化 Skill\n\n<p>\n  <a href=\"./README.en.md\"><strong>English</strong></a>\n</p>\n\n这是一个面向中文用户的 Codex Skill，用于在 Codex 中通过自然语言自动化阿里邮箱企业版。\n\n安装后，用户不需要记忆底层脚本命令。直接在 Codex 里说明要做什么，Codex 会根据 `SKILL.md`、`INDEX.md` 和 `references/` 自动选择合适的脚本、处理登录态、读取邮箱界面，并在需要时要求确认。\n\n## 推荐用法\n\n适合这样对 Codex 说：\n\n- 帮我总结今天收件箱里的重要邮件。\n- 帮我查找最近一周带附件的邮件，并列出附件名。\n- 帮我从指定文件夹里找出和某个项目相关的邮件。\n- 帮我把搜索结果整理成摘要，不需要展示完整正文。\n- 帮我基于这封邮件创建回复草稿，但不要发送。\n- 帮我把测试文件夹中符合条件的邮件移动到另一个文件夹，执行前先让我确认。\n\n这个 Skill 更适合稳定、可重复、低干扰的自动化任务。尤其推荐用于摘要、搜索、快照、附件发现、草稿准备，以及经过确认的标记/移动等邮箱整理工作。\n\n不建议把它用于无人值守发送邮件、删除邮件、修改邮箱设置、大批量高风险变更，或每封邮件都需要人工判断的任务。\n\n## 首次登录会发生什么\n\n首次使用涉及邮箱内容的任务时，Codex 会先初始化一个专用浏览器会话。\n\n默认设置项：\n\n- 登录入口：`https://qiye.aliyun.com/`\n- 推荐邮箱界面：阿里邮箱 v5.1\n- 默认 CDP 端口：`9222`\n- 默认 profile：`default`\n- 运行时目录：`.runtime/profiles/<profile>/`\n- 会话文件：`session-state.json` 和 `session-meta.json`\n\n如果还没有保存登录态，Codex 会打开一个可见浏览器窗口让用户登录。用户完成登录后，Codex 会保存筛选后的会话状态，关闭临时登录窗口，重新启动无头浏览器，并把后续自动化连接到这个无头浏览器中。\n\n`.runtime/` 是私有运行时目录，包含浏览器 profile 和筛选后的会话状态。不要提交、分享或复制其中的内容。\n\n## 命令行安装\n\n推荐通过 npm 包安装。安装命令会把 Skill 文件复制到 Codex 的 skills 目录中，而不是要求用户手动运行底层邮箱脚本。\n\n### Windows PowerShell\n\n```powershell\nnpx @crafteverywhere/alimail-automation-skill@latest install\n```\n\n### macOS / Linux\n\n```bash\nnpx @crafteverywhere/alimail-automation-skill@latest install\n```\n\n安装后，重启 Codex 或开启一个新会话，让技能索引刷新。之后直接用中文自然语言调用即可。\n\n如果你是从 GitHub 克隆源码进行开发，也可以在仓库目录中运行：\n\n```powershell\nnode scripts/install-skill.mjs install --force\n```\n\n## 更新已安装版本\n\nWindows PowerShell：\n\n```powershell\nnpx @crafteverywhere/alimail-automation-skill@latest install --force\n```\n\nmacOS / Linux：\n\n```bash\nnpx @crafteverywhere/alimail-automation-skill@latest install --force\n```\n\n## 安全规则\n\n- 不保存明文密码。\n- 永远不要展示 cookie 值、密码或原始 session storage。\n- 发件人/收件人、主题、正文、附件名等邮件内容，可以在用户明确要求查看具体邮件，或任务本身确实需要时展示。\n- 无人值守日志、批量报告和后台自动化输出默认应尽量克制；优先使用摘要、片段、计数、hash 和 fingerprint，除非用户明确选择展示邮件原文。\n- 附件内容不要直接粘贴到对话中，除非用户明确要求查看；更推荐下载到明确指定的本地目录。\n- 只读操作可以自动运行。\n- 草稿操作只应保存草稿，不自动发送邮件。\n- 标记、移动、打标签、删除、发送和设置变更都需要明确确认，并在执行前重新校验目标。\n- 读取邮件详情可能会把未读邮件标记为已读；只有在已知邮件为已读，或用户接受这个副作用时才应打开详情。\n\n## 自动化最佳实践\n\n- 让任务范围尽量明确：文件夹、关键词、时间窗口和数量上限越清楚，结果越稳定。\n- 先做搜索、摘要、快照或 dry-run 计划，再执行任何会改变邮箱状态的操作。\n- 默认报告使用 fingerprint、hash、摘要和片段；只有在用户明确要求时展示邮件原文。\n- 在专用测试文件夹里验证标记和移动规则，再应用到真实文件夹。\n- 为不同账号、租户或定时任务使用不同 profile。\n- 当阿里邮箱提示重新登录，或接口返回认证错误时，让 Codex 重新初始化会话。\n- 定时任务和无人值守任务应优先保持只读。相比实时改动邮箱，摘要、快照、附件发现和草稿准备更适合作为默认自动化。\n\n## 目录结构\n\n- `SKILL.md`：Skill 入口和运行规则。\n- `INDEX.md`：脚本路由索引。\n- `references/`：按需加载的参考文档。\n- `scripts/latest/runner/`：CDP、会话、RPC、并发和写入辅助模块。\n- `scripts/latest/atomic/`：底层邮箱操作。\n- `scripts/latest/composite/`：面向用户任务的组合工作流。\n- `tests/smoke/`：基础校验、隐私扫描和计划契约测试。\n","readmeFilename":"README.md","_rev":"1-a5e8431ceba8f8fd18be2e0da2079f3f"}