Public Skill（平台公邮）

定位：平台公邮通道，用于把内容推送到用户自己的邮箱。

推荐方式：只有在明确只想操作平台公邮时，才直接使用本 skill。

1. 能力边界

支持能力

| 能力 | 状态 | |------|------| | 查询绑定邮箱（query-bindmail） | ✅ | | 检查绑定状态（bind-check） | ✅ | | 发送绑定验证码（bind-send-code） | ✅ | | 完成邮箱绑定（bind-verify） | ✅ | | 发送纯文本邮件到自己的邮箱 | ✅ |

不支持能力

| 能力 | 说明 | |------|------| | 发给第三方收件人（--to） | ❌ 仅支持发送到自己的邮箱 | | 抄送 / 密送（--cc / --bcc） | ❌ | | 附件（--attach） | ❌ | | HTML 邮件（--html / --html-file） | ❌ 仅支持纯文本 | | 自定义发件人（--from） | ❌ | | 收件 / 检索 / 下载附件 | ❌ |

2. 推荐流程：自动获取绑定邮箱 → 直接发信

进入 public-skill 后，第一步必须先调用 query-bindmail 命令查询用户已绑定的邮箱，再根据结果决定后续操作。

步骤一：查询绑定邮箱（query-bindmail）

bash <SCRIPT_PATH>/scripts/unix/email_gateway.sh query-bindmail

该命令会调用 /data/4227/forward 接口，返回结果如下：

成功（用户已绑定邮箱）：

{
  "success": true,
  "email": "user@qq.com",
  "message": "已检测到平台公邮绑定邮箱"
}

失败（未绑定或网关异常）：

{
  "success": false,
  "error_code": 3,
  "message": "当前未检测到已绑定的平台公邮邮箱"
}

步骤二：根据结果决定后续操作

若 success 为 true → 拿到 email 字段，直接用该邮箱调用 send 发信
若 success 为 false → 引导用户走手动绑定流程（见第 3 节）

步骤三：发送邮件

拿到绑定邮箱后，使用 --email 参数传入发信：

bash <SCRIPT_PATH>/scripts/unix/email_gateway.sh send \
  --email 'user@qq.com' \
  --subject '今日日报' \
  --body '这是今天的日报内容'

也可以通过文件读取主题和正文：

bash <SCRIPT_PATH>/scripts/unix/email_gateway.sh send \
  --email 'user@qq.com' \
  --subject-file '/tmp/subject.txt' \
  --body-file '/tmp/report.txt'

完整流程图

用户请求发送邮件
       │
       ▼
  调用 query-bindmail
       │
       ▼
  返回 4227 接口结果
       │
       ├── success=true，拿到 email ──► send --email <email> ... ──► 完成 ✅
       │
       └── success=false
              │
              └── 引导用户走绑定流程（第 3 节）

3. 手动绑定流程（仅在 4227 接口无法获取绑定邮箱时使用）

当 4227 接口未返回绑定邮箱时，需要用户手动完成以下 3 步：

步骤一：检查绑定状态

bash <SCRIPT_PATH>/scripts/unix/email_gateway.sh bind-check \
  --email 'you@example.com'

步骤二：发送验证码

bash <SCRIPT_PATH>/scripts/unix/email_gateway.sh bind-send-code \
  --email 'you@example.com'

步骤三：校验验证码

bash <SCRIPT_PATH>/scripts/unix/email_gateway.sh bind-verify \
  --email 'you@example.com' \
  --code '123456'

绑定说明

必须严格按 bind-check → bind-send-code → bind-verify 顺序执行
绑定成功后，无需重复绑定
send 会在发送前自动做绑定检查；若未绑定，会返回引导信息

4. send 参数说明

| 参数 | 必填 | 说明 | |------|------|------| | --email <email> | 推荐 | 用户自己的邮箱地址；推荐先通过 query-bindmail 获取绑定邮箱后传入。send 内部也会尝试自动获取，但建议显式传入以确保明确 | | --subject <text> | 二选一 | 主题文本 | | --subject-file <path> | 二选一 | 从文件读取主题 | | --body <text> | 二选一 | 正文文本 | | --body-file <path> | 二选一 | 从文件读取正文 | | --content_type text | 否 | 仅支持 text |

明确不支持的参数

以下参数传入后会直接报错，并提示改走个人邮箱通道：

--to
--cc
--bcc
--attach
--from
--html
--html-file
--content_type html

5. 命令列表

| 命令 | 说明 | |------|------| | query-bindmail | 查询用户已绑定的平台公邮邮箱（调用 4227 接口），推荐在发信前先调用 | | bind-check | 检查邮箱绑定状态 | | bind-send-code | 发送绑定验证码 | | bind-verify | 完成邮箱绑定 | | send | 给自己的邮箱发送纯文本邮件 | | capabilities | 查看本 skill 能力 | | help | 查看帮助 |

6. 错误处理建议

| 错误 | 处理方式 | |------|----------| | 未绑定平台公邮 | 走绑定流程 | | 传了不支持的参数 | 改用 email-skill send --provider personal | | 平台额度不足 | 建议改用 email-skill send --provider auto，由系统回退到个人邮箱 | | 网关通信异常 | 报告错误并稍后重试 |

7. 安全规则

发送邮件失败后禁止自动重试
不要输出 Token、验证码、账号凭证等敏感信息
平台公邮只负责推送到自己的邮箱，不要拿它模拟通用 SMTP 发信

8. 与 `email-skill` 的关系

email-skill 是统一入口
public-skill 是“结果推送到自己邮箱”场景下的平台公邮下游通道
架构上，平台公邮与个人邮箱是并行路径；通常由模型先根据场景决定是否选择 public-skill
只有在调用方使用 email-skill --provider auto 且参数满足公邮条件时，路由器才会自动尝试 public-skill
当平台额度不足或通道异常时，由 email-skill 自动回退到 imap-smtp-email