> ## Documentation Index
> Fetch the complete documentation index at: https://docs.newenergycoder.club/llms.txt
> Use this file to discover all available pages before exploring further.

# public-skill

> 平台公邮：用于将天气、日报、报告、提醒等内容推送到用户自己的邮箱，零配置完成消息留存

| 项目 | 内容                                                                                                                                                                                                                                                                  |
| -- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 来源 | [skills/public-skill/SKILL.md](https://github.com/new-energy-coder-club/new_energy_coder_club/blob/Skill/skills/public-skill/SKILL.md)                                                                                                                              |
| 分类 | QClaw/OpenClaw 平台                                                                                                                                                                                                                                                   |
| 安装 | 克隆 [Skill 分支](https://github.com/new-energy-coder-club/new_energy_coder_club/tree/Skill) 后，将 `skills/public-skill/` 目录复制到 `~/.claude/skills/`（Claude Code）、`~/.trae/skills/`（Trae IDE）或 `~/.qclaw/skills/`（QClaw/OpenClaw），详见 [Skill 安装方式](/community/skill-branch) |

# 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 theme={null}
bash <SCRIPT_PATH>/scripts/unix/email_gateway.sh query-bindmail
```

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

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

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

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

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

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

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

### 步骤三：发送邮件

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

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

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

```bash theme={null}
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 theme={null}
bash <SCRIPT_PATH>/scripts/unix/email_gateway.sh bind-check \
  --email 'you@example.com'
```

### 步骤二：发送验证码

```bash theme={null}
bash <SCRIPT_PATH>/scripts/unix/email_gateway.sh bind-send-code \
  --email 'you@example.com'
```

### 步骤三：校验验证码

```bash theme={null}
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. 安全规则

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

## 8. 与 `email-skill` 的关系

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