名称： temp-mail
描述： 基于 Vortex (vortex.email) 的临时邮箱助手。适用于需要一次性地址的注册流程：创建邮箱（随机本地部分）、轮询消息、获取并清空邮箱。
主页： https://vortex.skyfall.dev
元数据： {"clawdis":{"emoji":"✉️","requires":{"bins":["curl"]}}}

temp-mail 技能

本技能提供一个 Python CLI 脚本，用于与托管的 Vortex API（GET /emails/{email}、DELETE /emails/{email}/clear）进行交互。

使用示例（脚本位于 scripts/ 目录下）：

• create：生成随机本地部分，并为指定域名打印邮箱地址
• fetch：查询 Vortex HTTP API，列出指定地址的邮件
• poll：等待邮件到达或超时
• clear：删除指定地址的所有邮件

使用 uv 运行：uv run {baseDir}/scripts/temp_mail.py（脚本包含 shebang 和类似于 hn 技能的元数据头）

示例：

# 生成随机地址
uv run {baseDir}/scripts/temp_mail.py create

# 获取指定地址的邮件
uv run {baseDir}/scripts/temp_mail.py fetch alice@dash.dino.icu

# 轮询直到邮件到达（超时 60 秒）
uv run {baseDir}/scripts/temp_mail.py poll alice@dash.dino.icu --timeout 60

# 清空邮箱
uv run {baseDir}/scripts/temp_mail.py clear alice@dash.dino.icu

默认值：
- VORTEX_URL: https://vtx-api.skyfall.dev
- 默认域名: skyfall.dev（可通过 VORTEX_DOMAIN 环境变量覆盖）

安装

# 创建虚拟环境并安装依赖（Unix）
python -m venv .venv
source .venv/bin/activate
python -m pip install --upgrade pip
python -m pip install -r scripts/requirements.txt

# 或使用 uv，它会自动创建临时虚拟环境，例如：
uv run {baseDir}/scripts/temp_mail.py create

注意事项：
- 脚本使用 httpx 发送请求；rich 为可选依赖，未包含在 requirements.txt 中
- 随机用户名生成遵循前端行为（小写字母数字组合），尝试复现 falso randUserName 的行为
- 托管实例包含多个域名，例如 dash.dino.icu、skyfall.dev 等。创建地址时，请从该列表中选择域名，或让脚本使用默认域名