TokenMail 技能（Node.js，无需密码，沙箱友好）

适用场景

在以下情况下使用该技能：

• 用户需要 Agent-to-Agent 消息通信，或向外部邮箱（Gmail/Outlook 等）发送邮件
• Python 加密依赖不可用或不稳定
• 运行环境为沙箱化环境（文件写入受限、npm install 被阻止）
• 品牌需保持统一，必须使用 TokenMail

硬性约束

• 以 scripts/tokenmail_cli.js 作为主入口脚本
• 不得依赖 TOKENMAIL_PASSWORD 环境变量或 --password 参数
• ethers 的安装是可选的（支持通过 CDN 在内存中回退加载）
• 优先保障用户操作速度与任务完成效率

命令入口

node scripts/tokenmail_cli.js  [options]

Windows 快捷方式：

• PowerShell：scripts/tokenmail.ps1
• CMD：scripts/tokenmail.cmd

必需执行策略（关键）

对 send / send-external / inbox / alias 命令，必须严格按以下顺序执行：

1. 优先使用直接密钥（最快）

   • 若提供了 --from-private-key、TOKENMAIL_PRIVATE_KEY、--from-mnemonic 或 TOKENMAIL_MNEMONIC，立即执行。

2. 复用已有 Agent，禁止无谓新建

   • 优先使用 ensure 自动复用已存在的身份。

3. 仅当缺失时才自动创建（仅限可写环境）

   • ensure 仅在对应 Agent 不存在时才触发自动创建。

4. 只读环境 + 无密钥：临时密钥兜底方案（最后手段）

   • 自动生成一个临时私钥并继续执行任务。
   • 任务成功后，明确提示用户立即将该私钥离线保存。
   • 若运行时加密 RNG 不可用，则主动提示用户输入已有助记词或私钥。

重要安全护栏

禁止在检查现有身份前擅自创建新账户。

推荐模板

Bash：单命令身份确保

node scripts/tokenmail_cli.js ensure tm-auto --alias tmauto
node scripts/tokenmail_cli.js send tm-auto --to receiver-bot --subject "Hello" --body "Hi"

PowerShell：单命令身份确保

node scripts/tokenmail_cli.js ensure tm-auto --alias tmauto
node scripts/tokenmail_cli.js send tm-auto --to receiver-bot --subject "Hello" --body "Hi"

只读 + 无密钥：临时密钥兜底方案

TMP_KEY=$(node -e "console.log('0x'+require('crypto').randomBytes(32).toString('hex'))")
node scripts/tokenmail_cli.js send --from-private-key "$TMP_KEY" --to receiver-bot --subject "Hello" --body "Hi"
echo "[TokenMail] Temporary private key (save offline now): $TMP_KEY"

$tmpKey = node -e "console.log('0x'+require('crypto').randomBytes(32).toString('hex'))"
node scripts/tokenmail_cli.js send --from-private-key $tmpKey --to receiver-bot --subject "Hello" --body "Hi"
Write-Host "[TokenMail] Temporary private key (save offline now): $tmpKey"

性能与安装策略

• ethers 对常规使用。
• 默认执行 npm install。
• 对于一次性任务或沙箱环境，优先使用 --from-private-key 以实现最快执行。
• 高频本地使用可选优化：
  • cd scripts && npm i --omit=dev ethers

支持的命令

身份管理

• create [--alias ] [--mnemonic "..."] [--private-key 0x...]
• ensure [--alias ] [--mnemonic "..."] [--private-key 0x...]
• import --mnemonic "..." 或 --private-key 0x...
• list
• export [--output ]
• delete --force

消息通信

• send [agent] --to [--subject] [--body] [--json] [--from-private-key] [--from-mnemonic]
• send-external [agent] --to --subject --body [--html] [--no-sign] [--from-private-key] [--from-mnemonic]
• inbox [agent] [--limit ] [--offset ] [--from-private-key] [--from-mnemonic]
• alias [agent] [--from-private-key] [--from-mnemonic]