SimpleLogin CLI

使用 SimpleLogin 创建并管理注重隐私的邮箱别名。在注册服务、订阅新闻通讯或进行线上购物时，保护您的真实邮箱地址。

功能特性

• ✅ 创建自定义别名（前缀由您指定）
• ✅ 创建随机别名（系统自动生成）
• ✅ 列出所有别名及其状态
• ✅ 按需启用或禁用别名
• ✅ 智能域名检测（根据目标网站自动推荐别名）
• ✅ 支持多个邮箱账户
• ✅ 创建联系人并获取反向别名（用于回复已转发的邮件）
• ✅ 列出任意别名下的所有联系人
• ✅ 安全的 API 密钥管理

前提条件

1. SimpleLogin 账户 —— 请访问 https://simplelogin.io 注册
2. API 密钥 —— 在 SimpleLogin 控制台 → API Keys 中生成
3. 安全存储 API 密钥 —— 建议使用环境变量或密码管理器

安装

# 通过 ClawHub 安装（发布后可用）
clawhub install simplelogin-cli

# 或手动克隆
git clone https://github.com/mcclawd/simplelogin-cli.git

配置

选项 1：环境变量（快速配置）

export SIMPLELOGIN_API_KEY="your-api-key-here"

选项 2：Bitwarden / 密码管理器（推荐）

将您的 API 密钥存入密码管理器：

• 名称：SimpleLogin API Key
• 自定义字段：api_key = 您的 API 密钥

当系统中存在 Warden 或其他凭证管理工具时，该技能将自动读取此密钥。

使用方法

创建自定义别名

# 使用您指定的前缀创建别名
simplelogin create shopping
# → shopping@yourdomain.com

# 添加备注
simplelogin create amazon --note "Amazon purchases"
# → amazon@yourdomain.com

# 针对特定网站创建
simplelogin create --for github.com
# → github-xyz@simplelogin.com

创建反向别名（发件身份）

反向别名允许您以别名身份发送邮件。 请为每个收件人创建一个联系人：

# 为收件人创建联系人
simplelogin contact-create shopping@example.com amazon-support@amazon.com
# → 反向别名：abc123@simplelogin.co
# → 向该地址发送邮件 → 经 shopping@example.com 转发

# 输出 JSON 格式（适用于自动化脚本）
export SIMPLELOGIN_JSON=true
simplelogin contact-create shopping@example.com vendor@company.com
# → 返回完整 JSON，包含 reverse_alias 和 reverse_alias_address 字段

工作原理：

1. contact-create 调用 SimpleLogin API：POST /api/aliases/{id}/contacts
2. API 返回含混淆地址的 reverse_alias 字段
3. 向该反向别名发送邮件 → 经您的别名转发 → 显示发件人为该别名

典型场景：支持退款申请、客服咨询，或任何需隐藏真实身份的邮件发送行为。

创建随机别名

# 生成随机别名
simplelogin random
# → random_word123@simplelogin.com

# 添加备注
simplelogin random --note "Newsletter signup"

列出别名

# 显示最近创建的别名
simplelogin list

# 显示全部别名
simplelogin list --all

# 按域名筛选
simplelogin list --domain simplelogin.com

列出某别名下的联系人

# 显示某别名下所有联系人（即收件人）
simplelogin contact-list shopping@example.com
# → amazon-support@amazon.com → abc123@simplelogin.co
# → support@store.com → xyz789@simplelogin.co

管理别名

# 禁用别名
simplelogin disable shopping@yourdomain.com

# 启用别名
simplelogin enable shopping@yourdomain.com

# 删除别名
simplelogin delete shopping@yourdomain.com

创建联系人并获取反向别名

当您收到一封经别名转发的邮件，并希望回复发件人时，需先为该别名创建一个联系人。这将为您生成一个反向别名邮箱地址，使您发出的邮件经该别名转发后，显示为来自该别名。

# 为别名创建联系人（获取反向别名）
simplelogin contact-create  
# → 反向别名：xxxxx@simplelogin.co
# → 向该地址发送邮件 → 经您的别名转发

# 列出某别名下的所有联系人
simplelogin contact-list 
# → support@example.com → xxxxx@simplelogin.co

典型场景：您曾使用 shopping@yourdomain.com 注册某项服务，对方邮件已转发至您的真实邮箱。要回复，请执行：

simplelogin contact-create shopping@yourdomain.com support@example.com
# → 反向别名：bncxsoitvfvzjlxtohfzzq@simplelogin.co

# 现在将回复发送至该反向别名
echo "My reply" | mail -s "Re: Your subject" bncxsoitvfvzjlxtohfzzq@simplelogin.co

该邮件将显示为来自 shopping@yourdomain.com，从而保护您的真实邮箱地址不被暴露。

API 参考文档

simplelogin create [prefix]

创建自定义别名。

选项：

• prefix —— 别名前缀（@ 符号之前的部分）
• --note, -n —— 添加备注或描述
• --for, -f —— 基于主机名建议别名（例如 amazon.com）
• --mailbox, -m —— 指定邮箱账户 ID（默认：首个可用邮箱）

示例：

simplelogin create shopping
simplelogin create amazon --note "Prime member"
simplelogin create --for netflix.com --note "Streaming"

simplelogin random

创建随机别名。

选项：

• --note, -n —— 添加备注或描述
• --word, -w —— 使用单词组合式随机别名（默认为 UUID 风格）
• --mailbox, -m —— 指定邮箱账户 ID

示例：

simplelogin random
simplelogin random --note "Forum signup"
simplelogin random --word

simplelogin contact-create

为别名创建一个联系人（即收件人），使其支持以该别名身份发送邮件。

参数：

• alias —— 别名邮箱地址
• contact —— 收件人邮箱地址

返回值：reverse_alias —— 向该地址发送邮件即可实现以您的别名身份发出

选项：

• （JSON 模式）设置 SIMPLELOGIN_JSON=true 以获得完整 JSON 响应

示例：

simplelogin contact-create amazon@alias.com refunds@merchant.com
simplelogin create --for nordvpn.com support@nordvpn.com  # 自动建议别名

simplelogin contact-list

列出某别名下已配置的所有联系人（即收件人）。

参数：

• alias —— 别名邮箱地址

返回值：联系人邮箱列表及其对应的反向别名

simplelogin list

列出您的所有别名。

选项：

• --all, -a —— 显示全部别名（不仅限于最近创建的）
• --domain, -d —— 按域名筛选
• --enabled —— 仅显示已启用的别名
• --disabled —— 仅显示已禁用的别名

simplelogin disable|enable|delete

管理现有别名。

示例：

simplelogin disable shopping@yourdomain.com
simplelogin enable shopping@yourdomain.com
simplelogin delete temp@simplelogin.com

simplelogin contact-create

为别名创建联系人并获取其反向别名地址。

参数：

• alias —— 您的别名邮箱（例如 shopping@yourdomain.com）
• contact —— 对方邮箱（例如 support@vendor.com）

示例：

simplelogin contact-create shopping@yourdomain.com support@vendor.com
# → 该联系人 support@vendor.com 已存在
# → 反向别名：bncxsoitvfvzjlxtohfzzq@simplelogin.co
# → 向该地址发送邮件 → 经 shopping@yourdomain.com 转发

什么是反向别名？
反向别名是一种特殊邮箱地址：向它发送邮件时，会经您的 SimpleLogin 别名转发，并显示为来自该别名（从而隐藏您的真实邮箱）。这是您回复已转发邮件的标准方式。

simplelogin contact-list

列出某别名下所有联系人及其对应的反向别名。

参数：

• alias —— 您的别名邮箱

示例：

simplelogin contact-list shopping@yourdomain.com
# → support@vendor.com → bncxsoitvfvzjlxtohfzzq@simplelogin.co
# → info@newsletter.com → atltfoczaqdtplypkciksufkpsnjpiqzvrnqrfptjjyxgomx@simplelogin.co

Agent / JSON 模式

如需在程序化场景（Agent、脚本等）中使用，请设置 SIMPLELOGIN_JSON=true：

export SIMPLELOGIN_JSON=true
simplelogin create shopping --note "Test"
# → {"email":"shopping@yourdomain.com","id":12345,"status":"created"}

安全说明

• 🔐 API 密钥绝不会保存在本技能中 —— 请始终使用环境变量或密码管理器
• 🔐 别名信息完全私有 —— SimpleLogin 不记录也不出售您的数据
• 🔐 开源项目 —— SimpleLogin 源码可在 https://github.com/simple-login 审阅

故障排查

“未找到 API 密钥”

请确认已正确设置 SIMPLELOGIN_API_KEY 环境变量，或已在密码管理器中妥善保存密钥。

“无可选后缀”

请检查您的 SimpleLogin 账户状态。免费账户的可用后缀数量有限。

邮件进入垃圾箱

测试邮件出现此情况属正常现象。Gmail 可能将程序化发送的邮件标记为可疑。请检查您的垃圾邮件文件夹。

贡献指南

欢迎提交贡献！请遵循现有代码风格，并为新增功能编写对应测试用例。

许可证

MIT 许可证 —— 详见 LICENSE 文件