email

Estrelas9

Forks4

Atualizado15 de junho de 2026 às 04:01

邮件处理工具（基于 IMAP）。搜索、读取、下载附件、移动邮件。触发场景： - 用户需要查看、搜索、管理邮件 - 用户需要下载邮件附件 - 用户需要移动、归档邮件 - 用户提到"邮件"、"邮箱"、"收件箱"、"附件"

Instalação

Instalar com Codex ou Claude Copie este prompt, cole no Codex, Claude ou outro assistente e deixe que ele revise a página da skill e instale para você.

Fonte

zrong

zrong/skills

Abrir repositório GitHub Ver repositórios do creator

Download

Ocupações relacionadasSOC

Baseado na classificação ocupacional SOC

Funcionários de correspondênciaEscritório e Suporte Administrativo·SOC 43-4021

Explorador de arquivos

3 arquivos

SKILL.md

readonly

name	email
description	邮件处理工具（基于 IMAP）。搜索、读取、下载附件、移动邮件。触发场景： - 用户需要查看、搜索、管理邮件 - 用户需要下载邮件附件 - 用户需要移动、归档邮件 - 用户提到"邮件"、"邮箱"、"收件箱"、"附件"

邮件处理 Skill

基于 IMAP 协议的邮件 CLI 工具。Python 3.13+ 必需。

首次使用

运行 init 命令交互式创建配置：

python3 scripts/email_tool.py init

会依次询问：

配置文件保存路径（默认 agent_config.toml，保存在当前项目目录）
账户名（默认 qqmail）
邮箱地址、IMAP/SMTP 服务器信息
密码/授权码

结果：

配置（含密码）写入 agent_config.toml（与其他 skill 共用同一配置文件）
密码同时写入 .env（优先级更高）
自动将 .env 加入 .gitignore
自动测试 IMAP 连接

配置说明

配置文件为 agent_config.toml（多 skill 共用，按 [skill名] 分区）。查找策略：当前目录 → skill 目录 → git 根目录。模板位于 skill 目录的 agent_config.example.toml。

agent_config.toml（[email] 区块）：

[email.accounts.qqmail]
email = "user@example.com"
imap_host = "imap.qq.com"
imap_port = 993
smtp_host = "smtp.qq.com"
smtp_port = 465
password = "your_app_password"

密码优先级（从高到低）：

.env 文件中的 EMAIL_{ACCOUNT}_PASSWORD 环境变量
agent_config.toml 中账户的 password 字段

环境变量命名规则：EMAIL_{ACCOUNT}_PASSWORD，ACCOUNT 为账户名大写。

脚本路径

相对于 skill 安装目录：scripts/email_tool.py

所有命令在项目目录下执行（配置文件通过三位置发现策略自动查找）。

命令速查

命令	用途	示例
`init`	交互式初始化配置	`email_tool.py init`
`folders`	列出所有文件夹	`email_tool.py folders`
`list`	搜索列出邮件	`email_tool.py list --subject "发票" --last 5`
`read`	读取邮件内容	`email_tool.py read --uid 12345`
`download`	下载附件	`email_tool.py download --subject "发票" --ext pdf --output-dir /tmp`
`move`	移动邮件	`email_tool.py move --subject "账单" --target-folder "账单" --yes`
`search-links`	从 HTML 提取链接	`email_tool.py search-links --subject "京东"`

通用参数

--config PATH：配置文件路径（默认使用 agent_config.toml 三位置发现策略）
--account NAME：账户名（默认 qqmail）
--subject TEXT：主题关键词搜索
--sender TEXT：发件人搜索
--since DD-Mon-YYYY：起始日期（如 01-Jan-2026）
--before DD-Mon-YYYY：截止日期
--last N：只处理最新 N 封

命令详情

init - 初始化配置

email_tool.py init
# 或指定配置路径
email_tool.py --config /path/to/agent_config.toml init

交互式询问账户信息，自动：

创建或追加到 agent_config.toml（[email.accounts.{name}] 区块）
将密码同时写入 .env（不覆盖已有内容）
将 .env 加入 .gitignore
测试 IMAP 连接

list - 列出邮件

email_tool.py list --subject "发票"
email_tool.py list --sender "jd.com" --last 3
email_tool.py list --subject "报告" --folder "工作"

输出 JSON 包含 uid、subject、from、date。

read - 读取邮件内容

email_tool.py read --uid 12345 12346
email_tool.py read --subject "发票" --last 1
email_tool.py read --uid 12345 --html

输出 JSON 包含 body、content_type、attachments（附件列表）。

download - 下载附件

email_tool.py download --uid 12345 --output-dir /tmp/attachments
email_tool.py download --subject "发票" --ext pdf --output-dir /tmp/invoices
email_tool.py download --subject "报销" --last 1 --output-dir .

move - 移动邮件

# dry run（默认，只列出不移动）
email_tool.py move --subject "账单" --target-folder "账单"
# 执行移动
email_tool.py move --subject "账单" --target-folder "账单" --yes
# 只移动最新一封
email_tool.py move --subject "通知" --target-folder "归档" --last 1 --yes

文件夹名支持中文，自动处理 IMAP modified UTF-7 编码。优先使用 MOVE 命令，不支持时降级 COPY+DELETE。

search-links - 提取链接

email_tool.py search-links --subject "京东"
email_tool.py search-links --sender "didifapiao"

输出 JSON 包含 pdf_links、xml_links、invoice_numbers。

注意事项

Python 版本：必须 3.13+，无第三方依赖
QQ 邮箱需要使用授权码（非登录密码），在 QQ 邮箱设置 → 账户 → IMAP 服务中生成
密码安全：密码可存放在 agent_config.toml 的 password 字段中，或通过环境变量 EMAIL_{ACCOUNT}_PASSWORD 读取（环境变量优先）
IMAP 搜索支持中文（自动使用 UTF-8 charset）
QQ Mail BEFORE bug：QQ 邮箱 IMAP 在 CHARSET UTF-8 模式下 BEFORE 关键词返回空结果。工具已自动处理：服务端只发 SINCE，BEFORE 在本地按 Date 头过滤
move 命令默认 dry run，必须加 --yes 才执行
download 的 --ext 参数支持逗号分隔多个扩展名（如 pdf,xml）
日期格式为 IMAP 标准格式：DD-Mon-YYYY（如 15-Mar-2026）

Mais deste repositório

mesmo repositório

immich

zrong/skills

将本地图像和视频上传到 Immich 服务器，支持批量上传、管理 Album 和公开链接。网络资源下载由 video-downloader 负责；当用户提到"上传到 Immich"、"上传图片"、"备份照片"、"上传视频"、"下载视频并上传 Immich"时使用此技能。

2026-07-2810

video-downloader

zrong/skills

下载视频工具。处理抖音短链、抖音作品页、微信视频号 SPH 分享链接，以及 yt-dlp 支持的网站视频下载。触发场景： - 用户发来视频链接并要求”下载这个视频” - 用户要求下载抖音视频、图文、封面、音乐、JSON、评论 - 用户要求下载 YouTube、Bilibili、X、TikTok 等 yt-dlp 支持站点的视频 - 用户要求下载 weixin.qq.com/sph/ 格式的微信视频号分享链接 - 用户提到”yt-dlp””douyin-downloader””视频下载””抖音短链” - 用户要求获取抖音热搜榜或搜索抖音作品 - 用户要求刷新抖音 Cookie - 用户要求刷新微信视频号或腾讯元宝 Cookie

2026-07-2810

image-generation

zrong/skills

AI 图片生成与编辑。使用统一 CLI 调用 OpenAI Images、Google Gemini 原生图片 API、火山方舟 Seedream，支持多参考图、mask、批量生成、透明背景后处理，以及 Seedream 5.0 Pro 点选/框选式连续交互编辑。当用户提到生成图片、画图、封面图、配图、AI 生图、改图、修图、参考图编辑、Gemini 生图、Seedream 或交互编辑时使用。

2026-07-2010

media-use

zrong/skills

媒体处理工具集（基于 ffmpeg）。当用户需要视频转码、格式转换、压缩到指定大小、调整分辨率/帧率、添加 Logo 或图片水印、设置水印位置/尺寸/透明度、追加片头片尾、音频处理、视频裁剪/剪辑、合并/拼接、修复 m3u 下载损坏视频（faststart/moov atom）时使用。支持品牌视频一体化生成、目标 MB 两遍编码、H.264/H.265/AV1/VP9 批量转码、无损裁剪与合并、mp4 moov 前置修复。

2026-07-2010

seedance-2-video

zrong/skills

为 Sorb 的 Seedance 2.0 视频生成分析图片或参考视频，编写和优化中文视频提示词、图生视频方案、运镜设计、分镜板、首帧建议、长视频分段方案与剪辑节奏。用户明确提到 Seedance 2.0、图生视频、参考视频复刻、运镜、分镜、首尾帧、视频延长或长视频规划时使用；不要为普通图片生成或与 Seedance 无关的视频任务触发。

2026-07-1910

ui-extractor

zrong/skills

从静态图片中提取前景元素并分离 UI 组件，支持棋盘格背景去除、绿幕/蓝幕/白幕/黑幕关键色抠图、透视校正。当用户说"提取 UI 元素"、"分离组件"、"去除背景"、"棋盘格背景"、"绿幕抠图"、"checkerboard 抠图"、"抠图"时使用。

2026-06-1610

name	email
description	邮件处理工具（基于 IMAP）。搜索、读取、下载附件、移动邮件。触发场景： - 用户需要查看、搜索、管理邮件 - 用户需要下载邮件附件 - 用户需要移动、归档邮件 - 用户提到"邮件"、"邮箱"、"收件箱"、"附件"

邮件处理 Skill

基于 IMAP 协议的邮件 CLI 工具。Python 3.13+ 必需。

首次使用

运行 init 命令交互式创建配置：

python3 scripts/email_tool.py init

会依次询问：

配置文件保存路径（默认 agent_config.toml，保存在当前项目目录）
账户名（默认 qqmail）
邮箱地址、IMAP/SMTP 服务器信息
密码/授权码

结果：

配置（含密码）写入 agent_config.toml（与其他 skill 共用同一配置文件）
密码同时写入 .env（优先级更高）
自动将 .env 加入 .gitignore
自动测试 IMAP 连接

配置说明

agent_config.toml（[email] 区块）：

[email.accounts.qqmail]
email = "user@example.com"
imap_host = "imap.qq.com"
imap_port = 993
smtp_host = "smtp.qq.com"
smtp_port = 465
password = "your_app_password"

密码优先级（从高到低）：

.env 文件中的 EMAIL_{ACCOUNT}_PASSWORD 环境变量
agent_config.toml 中账户的 password 字段

环境变量命名规则：EMAIL_{ACCOUNT}_PASSWORD，ACCOUNT 为账户名大写。

脚本路径

相对于 skill 安装目录：scripts/email_tool.py

所有命令在项目目录下执行（配置文件通过三位置发现策略自动查找）。

命令速查

命令	用途	示例
`init`	交互式初始化配置	`email_tool.py init`
`folders`	列出所有文件夹	`email_tool.py folders`
`list`	搜索列出邮件	`email_tool.py list --subject "发票" --last 5`
`read`	读取邮件内容	`email_tool.py read --uid 12345`
`download`	下载附件	`email_tool.py download --subject "发票" --ext pdf --output-dir /tmp`
`move`	移动邮件	`email_tool.py move --subject "账单" --target-folder "账单" --yes`
`search-links`	从 HTML 提取链接	`email_tool.py search-links --subject "京东"`

通用参数

--config PATH：配置文件路径（默认使用 agent_config.toml 三位置发现策略）
--account NAME：账户名（默认 qqmail）
--subject TEXT：主题关键词搜索
--sender TEXT：发件人搜索
--since DD-Mon-YYYY：起始日期（如 01-Jan-2026）
--before DD-Mon-YYYY：截止日期
--last N：只处理最新 N 封

命令详情

init - 初始化配置

email_tool.py init
# 或指定配置路径
email_tool.py --config /path/to/agent_config.toml init

交互式询问账户信息，自动：

创建或追加到 agent_config.toml（[email.accounts.{name}] 区块）
将密码同时写入 .env（不覆盖已有内容）
将 .env 加入 .gitignore
测试 IMAP 连接

list - 列出邮件

email_tool.py list --subject "发票"
email_tool.py list --sender "jd.com" --last 3
email_tool.py list --subject "报告" --folder "工作"

输出 JSON 包含 uid、subject、from、date。

read - 读取邮件内容

email_tool.py read --uid 12345 12346
email_tool.py read --subject "发票" --last 1
email_tool.py read --uid 12345 --html

输出 JSON 包含 body、content_type、attachments（附件列表）。

download - 下载附件

email_tool.py download --uid 12345 --output-dir /tmp/attachments
email_tool.py download --subject "发票" --ext pdf --output-dir /tmp/invoices
email_tool.py download --subject "报销" --last 1 --output-dir .

move - 移动邮件

# dry run（默认，只列出不移动）
email_tool.py move --subject "账单" --target-folder "账单"
# 执行移动
email_tool.py move --subject "账单" --target-folder "账单" --yes
# 只移动最新一封
email_tool.py move --subject "通知" --target-folder "归档" --last 1 --yes

文件夹名支持中文，自动处理 IMAP modified UTF-7 编码。优先使用 MOVE 命令，不支持时降级 COPY+DELETE。

search-links - 提取链接

email_tool.py search-links --subject "京东"
email_tool.py search-links --sender "didifapiao"

输出 JSON 包含 pdf_links、xml_links、invoice_numbers。

注意事项

Python 版本：必须 3.13+，无第三方依赖
QQ 邮箱需要使用授权码（非登录密码），在 QQ 邮箱设置 → 账户 → IMAP 服务中生成
密码安全：密码可存放在 agent_config.toml 的 password 字段中，或通过环境变量 EMAIL_{ACCOUNT}_PASSWORD 读取（环境变量优先）
IMAP 搜索支持中文（自动使用 UTF-8 charset）
QQ Mail BEFORE bug：QQ 邮箱 IMAP 在 CHARSET UTF-8 模式下 BEFORE 关键词返回空结果。工具已自动处理：服务端只发 SINCE，BEFORE 在本地按 Date 头过滤
move 命令默认 dry run，必须加 --yes 才执行
download 的 --ext 参数支持逗号分隔多个扩展名（如 pdf,xml）
日期格式为 IMAP 标准格式：DD-Mon-YYYY（如 15-Mar-2026）