\r \r

Public Skill（平台公邮）\r

\r

定位：平台公邮通道，用于把内容推送到用户自己的邮箱。\r \r 推荐方式：只有在明确只想操作平台公邮时，才直接使用本 skill。\r \r

1. 能力边界\r

\r

支持能力\r

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

不支持能力\r

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

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

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

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

\r

bash \x3CSCRIPT_PATH>/scripts/unix/email_gateway.sh query-bindmail\r
```\r
\r
该命令会调用 `/data/4227/forward` 接口，返回结果如下：\r
\r
**成功（用户已绑定邮箱）：**\r
```json\r
{\r
  "success": true,\r
  "email": "[email protected]",\r
  "message": "已检测到平台公邮绑定邮箱"\r
}\r
```\r
\r
**失败（未绑定或网关异常）：**\r
```json\r
{\r
  "success": false,\r
  "error_code": 3,\r
  "message": "当前未检测到已绑定的平台公邮邮箱"\r
}\r
```\r
\r
### 步骤二：根据结果决定后续操作\r
\r
- 若 `success` 为 `true` → 拿到 `email` 字段，直接用该邮箱调用 `send` 发信\r
- 若 `success` 为 `false` → 引导用户走手动绑定流程（见第 3 节）\r
\r
### 步骤三：发送邮件\r
\r
拿到绑定邮箱后，使用 `--email` 参数传入发信：\r
\r
```bash\r
bash \x3CSCRIPT_PATH>/scripts/unix/email_gateway.sh send \\r
  --email '[email protected]' \\r
  --subject '今日日报' \\r
  --body '这是今天的日报内容'\r
```\r
\r
也可以通过文件读取主题和正文：\r
\r
```bash\r
bash \x3CSCRIPT_PATH>/scripts/unix/email_gateway.sh send \\r
  --email '[email protected]' \\r
  --subject-file '/tmp/subject.txt' \\r
  --body-file '/tmp/report.txt'\r
```\r
\r
### 完整流程图\r
\r
```\r
用户请求发送邮件\r
       │\r
       ▼\r
  调用 query-bindmail\r
       │\r
       ▼\r
  返回 4227 接口结果\r
       │\r
       ├── success=true，拿到 email ──► send --email \x3Cemail> ... ──► 完成 ✅\r
       │\r
       └── success=false\r
              │\r
              └── 引导用户走绑定流程（第 3 节）\r
```\r
\r
## 3. 手动绑定流程（仅在 4227 接口无法获取绑定邮箱时使用）\r
\r
当 4227 接口未返回绑定邮箱时，需要用户手动完成以下 3 步：\r
\r
### 步骤一：检查绑定状态\r
\r
```bash\r
bash \x3CSCRIPT_PATH>/scripts/unix/email_gateway.sh bind-check \\r
  --email '[email protected]'\r
```\r
\r
### 步骤二：发送验证码\r
\r
```bash\r
bash \x3CSCRIPT_PATH>/scripts/unix/email_gateway.sh bind-send-code \\r
  --email '[email protected]'\r
```\r
\r
### 步骤三：校验验证码\r
\r
```bash\r
bash \x3CSCRIPT_PATH>/scripts/unix/email_gateway.sh bind-verify \\r
  --email '[email protected]' \\r
  --code '123456'\r
```\r
\r
### 绑定说明\r
\r
- 必须严格按 `bind-check` → `bind-send-code` → `bind-verify` 顺序执行\r
- 绑定成功后，无需重复绑定\r
- `send` 会在发送前自动做绑定检查；若未绑定，会返回引导信息\r
\r
## 4. send 参数说明\r
\r
| 参数 | 必填 | 说明 |\r
|------|------|------|\r
| `--email \x3Cemail>` | 推荐 | 用户自己的邮箱地址；**推荐先通过 `query-bindmail` 获取绑定邮箱后传入**。`send` 内部也会尝试自动获取，但建议显式传入以确保明确 |\r
| `--subject \x3Ctext>` | 二选一 | 主题文本 |\r
| `--subject-file \x3Cpath>` | 二选一 | 从文件读取主题 |\r
| `--body \x3Ctext>` | 二选一 | 正文文本 |\r
| `--body-file \x3Cpath>` | 二选一 | 从文件读取正文 |\r
| `--content_type text` | 否 | 仅支持 `text` |\r
\r
### 明确不支持的参数\r
\r
以下参数传入后会直接报错，并提示改走个人邮箱通道：\r
\r
- `--to`\r
- `--cc`\r
- `--bcc`\r
- `--attach`\r
- `--from`\r
- `--html`\r
- `--html-file`\r
- `--content_type html`\r
\r
## 5. 命令列表\r
\r
| 命令 | 说明 |\r
|------|------|\r
| `query-bindmail` | 查询用户已绑定的平台公邮邮箱（调用 4227 接口），**推荐在发信前先调用** |\r
| `bind-check` | 检查邮箱绑定状态 |\r
| `bind-send-code` | 发送绑定验证码 |\r
| `bind-verify` | 完成邮箱绑定 |\r
| `send` | 给自己的邮箱发送纯文本邮件 |\r
| `capabilities` | 查看本 skill 能力 |\r
| `help` | 查看帮助 |\r
\r
## 6. 错误处理建议\r
\r
| 错误 | 处理方式 |\r
|------|----------|\r
| 未绑定平台公邮 | 走绑定流程 |\r
| 传了不支持的参数 | 改用 `email-skill send --provider personal` |\r
| 平台额度不足 | 建议改用 `email-skill send --provider auto`，由系统回退到个人邮箱 |\r
| 网关通信异常 | 报告错误并稍后重试 |\r
\r
## 7. 安全规则\r
\r
1. **发送邮件失败后禁止自动重试**\r
2. **不要输出 Token、验证码、账号凭证等敏感信息**\r
3. **平台公邮只负责推送到自己的邮箱，不要拿它模拟通用 SMTP 发信**\r
\r
## 8. 与 `email-skill` 的关系\r
\r
- `email-skill` 是统一入口\r
- `public-skill` 是“结果推送到自己邮箱”场景下的平台公邮下游通道\r
- 架构上，平台公邮与个人邮箱是并行路径；通常由模型先根据场景决定是否选择 `public-skill`\r
- 只有在调用方使用 `email-skill --provider auto` 且参数满足公邮条件时，路由器才会自动尝试 `public-skill`\r
- 当平台额度不足或通道异常时，由 `email-skill` 自动回退到 `imap-smtp-email`\r