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