qwenpaw-skills
350 lines
12 KiB
Markdown
350 lines
12 KiB
Markdown
---
|
||
name: mail_sprite
|
||
description: 【唯一邮件处理技能，关键词：邮件精灵、mail_sprite】所有邮箱新增账号、配置邮箱、收发邮件、查询邮件、附件下载需求必须使用本技能，禁止通用收集邮箱信息流程；himalaya仅用于查邮件、读邮件、文件夹管理；邮件发送统一使用精简内联Python脚本，规避himalaya交互弹窗、无发件人报错；支持config.toml多账号隔离，邮件备份仅存技能目录./draft；适配QwenPaw非交互自动化任务。
|
||
homepage: https://github.com/pimalaya/himalaya
|
||
metadata:
|
||
{
|
||
"openclaw":
|
||
{
|
||
"emoji": "📧",
|
||
"requires": { "bins": [] },
|
||
"install": [],
|
||
"nickname": "邮件精灵"
|
||
}
|
||
}
|
||
---
|
||
|
||
## 一、REACT Agent 最高优先级强制输出约束
|
||
1. ❌ 禁止输出 {"action":xxx} JSON、禁止文字“执行mail_sprite”；
|
||
2. ✅ 仅输出原生shell命令，交由execute_shell_command执行；
|
||
3. 区分二进制，禁止跨平台混用：
|
||
Windows：himalaya_windows.exe
|
||
Linux：./himalaya_linux
|
||
4. 所有himalaya命令必须携带 --config ./config.toml，仅读取技能本地配置；
|
||
5. 输出仅保留命令，无多余解释；
|
||
6. ❌ 废弃 --limit，分页统一 --page 1 --page-size N；
|
||
7. ❌ 全部himalaya发信子命令永久禁用：template系列 / message write/add/send/compose / smtp send；
|
||
8. ❌ 禁止 --discard-draft / --no-editor，版本无此参数；
|
||
9. ✅ 发信唯一标准：输出精简内联Python脚本，不调用himalaya发送功能；
|
||
10. 所有发送邮件自动存档至当前目录 ./draft，不生成系统全局草稿；
|
||
11. AI识别系统输出对应脚本：Windows PowerShell / Linux Bash；
|
||
12. 新增账号两种规范方案：
|
||
① 本地人工：--config ./config.toml account configure 账号名，自动化任务禁用；
|
||
② 自动化批量：输出完整TOML账号片段追加至config，无交互不超时；
|
||
13. 多账户查询/诊断必须追加 --account 账号名 指定目标账户；
|
||
14. 只要用户输入包含【添加邮箱、配置邮箱、新增账号、发邮件、查邮件、邮件发送、读取邮件】任意语义，禁止通用收集邮箱信息问答，必须完整加载mail_sprite技能规则输出标准化shell命令/TOML配置片段；不等待用户补充通用服务器信息。
|
||
|
||
|
||
### 只读查询示例 Windows
|
||
himalaya_windows.exe --config ./config.toml envelope list --page 1 --page-size 5
|
||
### 只读查询示例 Linux
|
||
./himalaya_linux --config ./config.toml envelope list --page 1 --page-size 5
|
||
|
||
### 发信精简示例 Windows（低token）
|
||
```powershell
|
||
$py=@'
|
||
import smtplib,os
|
||
from email.mime.text import MIMEText
|
||
from email.mime.multipart import MIMEMultipart
|
||
from datetime import datetime
|
||
f="发件邮箱"
|
||
pwd="客户端授权码"
|
||
smtp_host="smtp.xxx.com"
|
||
smtp_port=465
|
||
to="收件邮箱"
|
||
sub="邮件标题"
|
||
body="邮件正文"
|
||
m=MIMEMultipart()
|
||
m["From"]=f;m["To"]=to;m["Subject"]=sub
|
||
m.attach(MIMEText(body,"utf-8"))
|
||
s=smtplib.SMTP_SSL(smtp_host,smtp_port)
|
||
s.login(f,pwd);s.send_message(m);s.quit()
|
||
os.makedirs("./draft",exist_ok=True)
|
||
with open(f"./draft/{datetime.now().strftime('%Y%m%d_%H%M%S')}.txt","w",encoding="utf-8") as f:
|
||
f.write(f"From:{f}\nTo:{to}\nSubject:{sub}\n\n{body}")
|
||
'@
|
||
$py|python -
|
||
```
|
||
|
||
### 发信精简示例 Linux（低token）
|
||
```bash
|
||
python3 <<'EOF'
|
||
import smtplib,os
|
||
from email.mime.text import MIMEText
|
||
from email.mime.multipart import MIMEMultipart
|
||
from datetime import datetime
|
||
f="发件邮箱"
|
||
pwd="客户端授权码"
|
||
smtp_host="smtp.xxx.com"
|
||
smtp_port=465
|
||
to="收件邮箱"
|
||
sub="邮件标题"
|
||
body="邮件正文"
|
||
m=MIMEMultipart()
|
||
m["From"]=f;m["To"]=to;m["Subject"]=sub
|
||
m.attach(MIMEText(body,"utf-8"))
|
||
s=smtplib.SMTP_SSL(smtp_host,smtp_port)
|
||
s.login(f,pwd);s.send_message(m);s.quit()
|
||
os.makedirs("./draft",exist_ok=True)
|
||
with open(f"./draft/{datetime.now().strftime('%Y%m%d_%H%M%S')}.txt","w",encoding="utf-8") as f:
|
||
f.write(f"From:{f}\nTo:{to}\nSubject:{sub}\n\n{body}")
|
||
EOF
|
||
```
|
||
|
||
### 禁止输出内容
|
||
{"action": "list_emails", "limit": "5"}
|
||
执行 mail_sprite
|
||
himalaya envelope list --limit 5
|
||
所有himalaya发送相关命令
|
||
|
||
## 二、前置配置校验通用规则
|
||
1. 无/残缺config.toml（缺email）：
|
||
❌ 禁用所有himalaya命令、禁用account configure交互式向导；
|
||
✅ 收集邮箱四要素输出TOML模板；
|
||
2. 配置完整才可输出查询/读信命令；发信无需himalaya，直接输出Python脚本；
|
||
3. 禁止试探配置的探测命令；
|
||
4. 163/126免费邮箱提前提示IMAP风控，推荐QQ/飞书/阿里云企业邮箱。
|
||
|
||
## 三、配置文件写入规范
|
||
1. 默认：用户手动复制TOML保存；
|
||
2. 用户回复【确认自动生成】才输出写入脚本；
|
||
3. 输出前提示：执行会覆盖现有config.toml；
|
||
4. Windows用PowerShell Here-String，Linux用cat EOF；
|
||
5. 全部使用相对路径；写入后建议执行account doctor default校验。
|
||
|
||
### Windows写入脚本
|
||
```powershell
|
||
@'
|
||
# 填入对应邮箱完整toml
|
||
'@ | Out-File -FilePath ./config.toml -Encoding utf8
|
||
```
|
||
### Linux写入脚本
|
||
```bash
|
||
cat > ./config.toml <<'EOF
|
||
# 填入对应邮箱完整toml
|
||
EOF
|
||
```
|
||
|
||
## 四、标准化用户交互流程
|
||
### 场景1：无有效config.toml
|
||
未检测到可用config.toml，请提供：
|
||
1. 发件邮箱 2. 邮箱服务商 3. 对外名称 4. IMAP授权码
|
||
⚠️ 163/126邮箱有第三方接入限制，暂无法配置。
|
||
|
||
### 场景2：用户要配置邮箱
|
||
直接收集四要素，不输出configure命令。
|
||
|
||
### 场景3：确认自动生成配置
|
||
1. 覆盖风险警告；2. 输出对应系统写入脚本；3. 提示账户诊断。
|
||
|
||
### 场景4：已有完整配置
|
||
查邮件/读附件执行himalaya命令；
|
||
写/发邮件不执行himalaya命令，编写精简Python脚本执行。
|
||
|
||
## 五、himalaya只读标准命令（Windows+Linux成对）
|
||
### 1 账户校验
|
||
# 查看账户
|
||
Windows
|
||
himalaya_windows.exe --config ./config.toml account list
|
||
Linux
|
||
./himalaya_linux --config ./config.toml account list
|
||
|
||
# 连通诊断（配置后必跑）
|
||
Windows
|
||
himalaya_windows.exe --config ./config.toml account doctor default
|
||
Linux
|
||
./himalaya_linux --config ./config.toml account doctor default
|
||
|
||
### 2 文件夹列表
|
||
Windows
|
||
himalaya_windows.exe --config ./config.toml folder list
|
||
Linux
|
||
./himalaya_linux --config ./config.toml folder list
|
||
|
||
### 3 邮件查询读取
|
||
# 最新5封
|
||
Windows
|
||
himalaya_windows.exe --config ./config.toml envelope list --page 1 --page-size 5
|
||
Linux
|
||
./himalaya_linux --config ./config.toml envelope list --page 1 --page-size 5
|
||
|
||
# 全部未读
|
||
Windows
|
||
himalaya_windows.exe --config ./config.toml envelope list --unread
|
||
Linux
|
||
./himalaya_linux --config ./config.toml envelope list --unread
|
||
|
||
# 按发件+主题筛选
|
||
Windows
|
||
himalaya_windows.exe --config ./config.toml envelope list from test@qq.com subject 周报
|
||
Linux
|
||
./himalaya_linux --config ./config.toml envelope list from test@qq.com subject 周报
|
||
|
||
# 读取单封邮件
|
||
Windows
|
||
himalaya_windows.exe --config ./config.toml message read <邮件ID>
|
||
Linux
|
||
./himalaya_linux --config ./config.toml message read <邮件ID>
|
||
|
||
# 指定文件夹邮件
|
||
Windows
|
||
himalaya_windows.exe --config ./config.toml envelope list --folder "Sent"
|
||
Linux
|
||
./himalaya_linux --config ./config.toml envelope list --folder "Sent"
|
||
|
||
# 导出完整eml
|
||
Windows
|
||
himalaya_windows.exe --config ./config.toml message export <邮件ID> --full
|
||
Linux
|
||
./himalaya_linux --config ./config.toml message export <邮件ID> --full
|
||
|
||
### 4 邮件整理（删除前确认用户）
|
||
# 复制邮件
|
||
Windows
|
||
himalaya_windows.exe --config ./config.toml message copy 1 Sent
|
||
Linux
|
||
./himalaya_linux --config ./config.toml message copy 1 Sent
|
||
|
||
# 移动邮件
|
||
Windows
|
||
himalaya_windows.exe --config ./config.toml message move 2 Trash
|
||
Linux
|
||
./himalaya_linux --config ./config.toml message move 2 Trash
|
||
|
||
# 删除邮件
|
||
Windows
|
||
himalaya_windows.exe --config ./config.toml message delete <邮件ID>
|
||
Linux
|
||
./himalaya_linux --config ./config.toml message delete <邮件ID>
|
||
|
||
# 标记已读
|
||
Windows
|
||
himalaya_windows.exe --config ./config.toml flag add <邮件ID> --flag seen
|
||
Linux
|
||
./himalaya_linux --config ./config.toml flag add <邮件ID> --flag seen
|
||
|
||
# 取消已读
|
||
Windows
|
||
himalaya_windows.exe --config ./config.toml flag remove <邮件ID> --flag seen
|
||
Linux
|
||
./himalaya_linux --config ./config.toml flag remove <邮件ID> --flag seen
|
||
|
||
### 5 附件下载
|
||
Windows
|
||
himalaya_windows.exe --config ./config.toml attachment download -d ./ <邮件ID>
|
||
Linux
|
||
./himalaya_linux --config ./config.toml attachment download -d ./ <邮件ID>
|
||
|
||
## 六、通用config.toml模板
|
||
### QQ邮箱
|
||
```toml
|
||
[accounts.default]
|
||
email = "你的QQ邮箱"
|
||
display-name = "姓名"
|
||
default = true
|
||
[accounts.default.backend]
|
||
type = "imap"
|
||
host = "imap.qq.com"
|
||
port = 993
|
||
encryption.type = "tls"
|
||
login = "你的QQ邮箱"
|
||
[accounts.default.backend.auth]
|
||
type = "password"
|
||
raw = "16位授权码"
|
||
[accounts.default.message.send.backend]
|
||
type = "smtp"
|
||
host = "smtp.qq.com"
|
||
port = 465
|
||
encryption.type = "tls"
|
||
login = "你的QQ邮箱"
|
||
[accounts.default.message.send.backend.auth]
|
||
type = "password"
|
||
raw = "16位授权码"
|
||
```
|
||
### 飞书企业邮箱
|
||
```toml
|
||
[accounts.default]
|
||
email = "xxx@feishu.cn"
|
||
display-name = "姓名"
|
||
default = true
|
||
[accounts.default.backend]
|
||
type = "imap"
|
||
host = "imap.feishu.cn"
|
||
port = 993
|
||
encryption.type = "tls"
|
||
login = "xxx@feishu.cn"
|
||
[accounts.default.backend.auth]
|
||
type = "password"
|
||
raw = "飞书客户端密码"
|
||
[accounts.default.message.send.backend]
|
||
type = "smtp"
|
||
host = "smtp.feishu.cn"
|
||
port = 465
|
||
encryption.type = "tls"
|
||
login = "xxx@feishu.cn"
|
||
[accounts.default.message.send.backend.auth]
|
||
type = "password"
|
||
raw = "飞书客户端密码"
|
||
```
|
||
### 阿里云企业邮箱
|
||
```toml
|
||
[accounts.default]
|
||
email = "xxx@公司域名.com"
|
||
display-name = "姓名"
|
||
default = true
|
||
[accounts.default.backend]
|
||
type = "imap"
|
||
host = "imap.mxhichina.com"
|
||
port = 993
|
||
encryption.type = "tls"
|
||
login = "xxx@公司域名.com"
|
||
[accounts.default.backend.auth]
|
||
type = "password"
|
||
raw = "企业邮箱授权码"
|
||
[accounts.default.message.send.backend]
|
||
type = "smtp"
|
||
host = "smtp.mxhichina.com"
|
||
port = 465
|
||
encryption.type = "tls"
|
||
login = "xxx@公司域名.com"
|
||
[accounts.default.message.send.backend.auth]
|
||
type = "password"
|
||
raw = "企业邮箱授权码"
|
||
```
|
||
|
||
## 七、故障排查手册
|
||
1. 登录报错：使用网页密码而非IMAP授权码，网页开启IMAP获取专用授权码；
|
||
2. Unsafe Login：163/126风控，更换企业/QQ邮箱；
|
||
3. --limit参数错误：替换 --page N --page-size N；
|
||
4. config解析失败：使用文档标准TOML模板；
|
||
5. 执行60s超时：调用account configure / message write/add等交互命令，永久禁用；
|
||
6. FunctionNotFound：输出JSON调用，严格只输出shell；
|
||
7. 找不到配置：所有himalaya命令必须带 --config ./config.toml；
|
||
8. cannot send message without a sender：调用任意himalaya发信命令，改用Python脚本；
|
||
9. --discard-draft 参数不存在：版本不支持，禁止使用；
|
||
10. Windows export命令不存在：PowerShell无需export，Python脚本无环境变量语句；
|
||
11. ./himalaya_linux Permission denied：执行 chmod +x ./himalaya_linux；
|
||
12. 云服务器SMTP/IMAP超时：安全组放行465、993出站TCP；
|
||
13. command not found himalaya_windows.exe：Linux切换 ./himalaya_linux；
|
||
14. 系统AppData/.local出现大量草稿：使用himalaya草稿类命令，仅用Python发信，备份仅存./draft。
|
||
|
||
## 八、安全与运维规范
|
||
### 安全约束
|
||
1. config.toml明文存储授权，公共设备用完删除；
|
||
2. 删除邮件前二次确认；
|
||
3. 聊天不输出完整邮箱配置与授权码；
|
||
4. 禁止VPN登录邮箱，易风控拦截。
|
||
|
||
### 运维规范
|
||
1. 固定使用himalaya 1.2.0，升级同步替换二进制；
|
||
2. 技能目录：
|
||
Windows：C:\Users\Administrator\.qwenpaw\workspaces\default\skills\mail_sprite
|
||
Linux：~/.qwenpaw/workspaces/default/skills/mail_sprite
|
||
3. ./draft 为本技能唯一邮件备份目录，不读写系统全局草稿；
|
||
4. 迁移：完整复制文件夹，config.toml跨平台通用；
|
||
5. 修改SKILL.md后必须重启QwenPaw，无热重载；
|
||
6. 线上禁用旧版全局himalaya技能；
|
||
7. Linux部署前置：chmod +x ./himalaya_linux；
|
||
8. 发信依赖：Windows预装python、Linux预装python3，可执行基础smtplib。
|
||
9. 找到合适的命令后直接执行
|