temp-mail skill
This skill provides a Python CLI script to interact with the hosted Vortex API (GET /emails/{email}, DELETE /emails/{email}/clear).
Usage examples (scripts are in scripts/):
- - create: generates a random localpart and prints an address for the provided domain
- fetch: queries the Vortex HTTP API to list messages for an address
- poll: wait until messages arrive or timeout
- clear: delete all messages for an address
Run with uv: uv run {baseDir}/scripts/temp_mail.py (script includes shebang and metadata header similar to the hn skill)
Examples:
CODEBLOCK0
Defaults:
- - VORTEXURL: https://vtx-api.skyfall.dev
- default domain: skyfall.dev (override with VORTEXDOMAIN env var)
Install
CODEBLOCK1
Notes:
- - script uses httpx for requests; rich is optional and omitted from requirements
- random username generation mirrors the frontend behavior (lowercase alphanumeric), attempted to replicate falso randUserName behavior
- hosted instance includes multiple domains, e.g., dash.dino.icu, skyfall.dev, etc. When creating addresses, choose a domain from that list or let the script use the default
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 技能）
示例：
bash
生成一个随机地址
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
默认值：
- - VORTEXURL：https://vtx-api.skyfall.dev
- 默认域名：skyfall.dev（可通过 VORTEXDOMAIN 环境变量覆盖）
安装
bash
创建虚拟环境并安装依赖（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 中省略
- 随机用户名生成模拟了前端行为（小写字母数字），尝试复现 falso randUserName 的行为
- 托管实例包含多个域名，例如 dash.dino.icu、skyfall.dev 等。创建地址时，从该列表中选择一个域名，或让脚本使用默认域名
