正文内容
" \ --html ``` #### 带附件的邮件 ```bash python3 send_email.py send \ --to recipient@example.com \ --subject "带附件的邮件" \ --body "请查看附件" \ --attachments "/path/to/file1.pdf" "/path/to/file2.png" ``` #### 抄送和密送 ```bash python3 send_email.py send \ --to recipient@example.com \ --cc cc1@example.com cc2@example.com \ --bcc bcc@example.com \ --subject "多人邮件" \ --body "邮件正文" ``` #### 自动检测 Markdown + 内嵌图片（最强推荐）⭐⭐⭐ **功能：** 自动检测 Markdown 格式，自动提取并内嵌图片，无需手动指定！ ```bash python3 send_email.py send \ --to recipient@example.com \ --subject "Markdown 邮件（自动检测图片）" \ --body "# 标题\n\n\n\n这是正文内容" ``` **工作流程：** 1. 脚本自动检测 Markdown 格式 2. 自动提取 Markdown 中的图片路径（支持 `` 语法） 3. 自动将 Markdown 转换为 HTML 4. 自动将图片转换为 CID 引用（`src="cid:image"`） 5. 图片直接显示在邮件正文中 **示例：发送包含多张图片的 Markdown** ```bash python3 send_email.py send \ --to recipient@example.com \ --subject "产品报告" \ --body "$(cat report.md)" ``` 其中 `report.md` 内容： ```markdown # 产品更新报告 ## 新功能展示 这是第一个功能截图：  这是第二个功能截图：  ## 总结 如有问题，请联系我们。 ``` **结果：** 收件人会收到一封格式美观的 HTML 邮件，图片直接显示在正文中！ --- #### 手动指定内嵌图片 **功能：** 图片直接显示在邮件正文中，不是链接。使用 CID（Content-ID）技术，兼容所有主流邮件客户端。 ```bash python3 send_email.py send \ --to recipient@example.com \ --subject "带内嵌图片的邮件" \ --html \ --body "正文内容
" \
--inline-images "/path/to/image.png"
```
**工作原理：**
1. 脚本会自动将 HTML 中的图片路径替换为 CID 引用（`src="cid:filename"`）
2. 图片作为内嵌资源添加到邮件中
3. 邮件客户端会直接显示图片，不需要点击链接
**多张图片示例：**
```bash
python3 send_email.py send \
--to recipient@example.com \
--subject "产品截图" \
--html \
--body "
" \
--inline-images "/path/to/screenshot1.png" "/path/to/screenshot2.png"
```
**重要提示：**
- `--inline-images` 必须配合 `--html` 参数使用（如未指定，会自动启用）
- 图片路径必须与 HTML 中的 `src` 属性完全一致
- 支持 PNG、JPG、JPEG、GIF、WebP 格式
- CID 会自动使用文件名（去掉扩展名），例如 `image.png` → `cid:image`
---
## 参数说明
### 发送命令 (`send`)
| 参数 | 说明 | 必填 |
|------|------|------|
| `--to` | 收件人邮箱 | ✅ |
| `--to-name` | 收件人名称 | ❌ |
| `--subject` | 邮件主题 | ✅ |
| `--body` | 邮件正文 | ✅ |
| `--html` | 使用 HTML 格式 | ❌ |
| `--template` | 使用指定模板渲染邮件（模板文件名） | ❌ |
| `--title` | 邮件标题（模板中使用，默认："邮件摘要"） | ❌ |
| `--attachments` | 附件路径（可多个） | ❌ |
| `--inline-images` | 内嵌图片路径（可多个，仅 HTML 模式） | ❌ |
| `--cc` | 抄送邮箱（可多个） | ❌ |
| `--bcc` | 密送邮箱（可多个） | ❌ |
### 发件人邮箱管理命令 (`username`)
| 参数 | 说明 |
|------|------|
| `--save` | 保存发件人邮箱到 keyring（会提示输入） |
| `--delete` | 删除保存的发件人邮箱 |
### 密码管理命令 (`password`)
| 参数 | 说明 |
|------|------|
| `--save` | 保存密码到 keyring（会提示输入） |
| `--delete` | 删除保存的密码 |
---
## 配置文件
配置文件保存在：`~/.send_email_config.json`
示例配置：
```json
{
"smtp": {
"host": "smtp.gd.chinamobile.com",
"port": 465,
"use_tls": false
},
"sender": {
"name": "Your Name"
}
}
```
**注意：** 发件人邮箱通过 `username --save` 命令存储在 keyring 中，不在配置文件中。
---
## 完整示例
### 示例 1: 发送 Markdown 邮件（自动检测并内嵌图片）⭐
创建一个 Markdown 文件 `newsletter.md`：
```markdown
# 今日新闻摘要
## 科技头条
AI 技术持续突破，以下是最新进展：
## 产品更新
新功能界面展示：
---
如需了解更多，请访问我们的官网。
```
发送邮件（超级简单，无需指定任何图片参数！）：
```bash
python3 send_email.py send \
--to recipient@example.com \
--subject "今日新闻摘要" \
--body "$(cat newsletter.md)"
```
**结果：** 脚本会自动：
1. 检测到 Markdown 格式
2. 提取 2 张图片路径
3. 转换为 HTML 并替换图片为 CID 引用
4. 内嵌图片到邮件中
5. 发送格式美观的 HTML 邮件
---
### 示例 2: 发送带内嵌图片的 HTML 邮件（手动指定）
假设你有两张产品截图：
```bash
cd ~/clawd/skills/send-email/scripts
# 准备 HTML 内容
cat > email_content.html << 'EOF'
大家好！
这是我们最新的产品截图：
第二个功能展示：
如有问题，请随时联系我们！
Best regards,
产品团队
" \
--inline-images "/path/to/image.png"
```
**何时使用手动指定：**
- 已有现成的 HTML 内容
- 不想使用 Markdown 转换
- 需要精确控制 CID 引用
---
### 示例 4: 结合 X 推文技能（自动工作流）⚡
假设你已经使用 `crawl-from-x` 和 `translate` 技能抓取并翻译了 X 推文，结果保存在 `posts_zh.md`。
现在发送邮件（一键搞定！）：
```bash
python3 send_email.py send \
--to your-email@example.com \
--subject "今日 X 推文摘要" \
--body "$(cat /path/to/posts_zh.md)"
```
**完整工作流：**
```bash
# 步骤 1: 抓取 X 推文
crawl-from-x 抓取
# 步骤 2: 翻译为中文
使用 translate 技能翻译最新的文件
# 步骤 3: 发送邮件（自动检测 Markdown + 图片）
python3 send_email.py send \
--to your-email@example.com \
--subject "今日 X 推文摘要" \
--body "$(cat $CLAWD/skills/crawl-from-x/results/*_zh.md)"
```
**自动化脚本：**
创建 `send-x-news.sh`：
```bash
#!/bin/bash
cd ~/clawd/skills/crawl-from-x/scripts
python3 craw_hot.py crawl
LATEST_MD=$(ls -t ~/clawd/skills/crawl-from-x/results/*.md | head -1)
python3 ~/clawd/skills/send-email/scripts/send_email.py send \
--to your-email@example.com \
--subject "$(date +'%Y-%m-%d') X 推文摘要" \
--body "$(cat $LATEST_MD)"
```
添加到 cron：
```bash
crontab -e
# 添加：每天早上 8:00 执行
0 8 * * * ~/clawd/skills/send-email/scripts/send-x-news.sh
```
---
## 模板功能
### 使用模板渲染邮件
使用 `--template` 参数可以让邮件内容使用指定的模板进行渲染，提供更美观的视觉效果。
```bash
python3 send_email.py send \
--to recipient@example.com \
--subject "今日 X 推文摘要" \
--body "$(cat posts_zh.md)" \
--template default \
--title "X 帖子摘要"
```
**参数说明：**
- `--template`：模板文件名（不含 .html 扩展名）
- 默认模板：`default`（仿照 x.com 样式）
- 模板位置：`templates/` 目录
- `--title`：邮件标题（模板中使用，默认："邮件摘要"）
### 默认模板（default）
send-email 技能内置了一个名为 `default` 的默认模板，具有以下特点：
- **设计风格**：现代、简约、商务、大气
- **视觉参考**：仿照 x.com 网页样式
- **布局**：卡片式布局，圆角边框
- **配色**：
- 背景：白色（#ffffff）
- 主要文字：深色（#0f1419）
- 次要文字：灰色（#536471）
- 链接：蓝色（#1d9bf0）
- 边框：浅灰色（#eff3f4）
- **响应式**：适配移动端和桌面端
- **支持内容**：文字、图片、链接
**模板变量：**
- `{{title}}`：邮件标题（通过 `--title` 参数设置）
- `{{subtitle}}`：副标题（自动生成时间戳）
- `{{content}}`：邮件正文内容
### 自定义模板
如果默认模板不满足需求，可以创建自定义模板：
1. 在 `templates/` 目录下创建新的 HTML 文件
2. 使用 `{{title}}`、`{{subtitle}}`、`{{content}}` 作为变量占位符
3. 使用时指定模板名称：
```bash
python3 send_email.py send \
--to recipient@example.com \
--subject "每周报告" \
--body "$(cat report.md)" \
--template my-template
```
**模板示例：** `templates/default.html`
```html
{{subtitle}}
`
- 图片会自动转换为 CID 引用，直接显示在邮件正文中
- 建议压缩图片大小（每张 < 500KB），避免邮件过大被拒收
- CID 使用文件名（去掉扩展名），例如 `myphoto.png` → `cid:myphoto`
6. **图片路径：**
- 使用绝对路径（推荐）
- 确保图片文件存在且可读
- 跳过 `http://` 和 `https://` 开头的图片链接（外链）
7. **附件路径：** 使用绝对路径或相对于执行目录的路径
8. **测试：** 首次使用时，建议先发送测试邮件给自己
9. **keyring 备用方案：** 如果 keyring 不可用，密钥会保存在 `~/.send_email_password` 和 `~/.send_email_username`（base64 编码），文件权限为 600。注意这不是加密，仅避免明文存储。
## 安全流程
```
1. 首次配置（中国移动邮箱）：
- python send_email.py smtp --host smtp.gd.chinamobile.com --port 465 --no-tls
- python send_email.py sender --name "Your Name"
- python send_email.py username --save --email your-email@gd.chinamobile.com
- python send_email.py password --save ← 输入密码
2. 后续发送：
- python send_email.py send --to to@example.com --subject "..." --body "..."
邮箱和密码自动从 keyring 读取
```
---
## 技术说明
### Markdown 自动检测
脚本会检测以下 Markdown 语法：
- 标题：`# 标题`
- 粗体：`**粗体**`
- 代码块：` ``` `
- 列表：`- 列表项` 或 `1. 列表项`
- 链接：`[文本](url)`
- **图片：`` ⭐**
检测到以上任一语法，会自动转换为 HTML 格式。
### 图片自动提取
支持两种语法：
**Markdown 语法：**
```
```
**HTML 语法：**
```html
```
脚本会：
1. 自动提取所有图片路径
2. 跳过 `http://` 和 `https://` 开头的链接
3. 将本地图片路径转换为 CID 引用
4. 内嵌到邮件中
### CID 工作原理
1. 图片作为 MIME part 添加到邮件
2. 每张图片分配 Content-ID（例如 `cid:myimage`）
3. HTML 中使用 `