Publish mail_sprite via gitea-publish skill

SKILL.md

@@ -0,0 +1,349 @@
+---
+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. 找到合适的命令后直接执行

config.toml

@@ -0,0 +1,45 @@
+[accounts.default]
+email = "mayanfei@ccoop.cc"
+display-name = "掌渠"
+default = true
+[accounts.default.backend]
+type = "imap"
+host = "imap.feishu.cn"
+port = 993
+encryption.type = "tls"
+login = "mayanfei@ccoop.cc"
+[accounts.default.backend.auth]
+type = "password"
+raw = "hv5zwruPXaQJdCup"
+[accounts.default.message.send.backend]
+type = "smtp"
+host = "smtp.feishu.cn"
+port = 465
+encryption.type = "tls"
+login = "mayanfei@ccoop.cc"
+[accounts.default.message.send.backend.auth]
+type = "password"
+raw = "hv5zwruPXaQJdCup"
+
+[accounts.apes]
+email = "figmar@apescale.com"
+display-name = "元旷"
+default = false
+[accounts.apes.backend]
+type = "imap"
+host = "imap.feishu.cn"
+port = 993
+encryption.type = "tls"
+login = "figmar@apescale.com"
+[accounts.apes.backend.auth]
+type = "password"
+raw = "oJNzFK7fYAfgfjYE"
+[accounts.apes.message.send.backend]
+type = "smtp"
+host = "smtp.feishu.cn"
+port = 465
+encryption.type = "tls"
+login = "figmar@apescale.com"
+[accounts.apes.message.send.backend.auth]
+type = "password"
+raw = "oJNzFK7fYAfgfjYE"

config_apes.toml

@@ -0,0 +1,22 @@
+[accounts.default]
+email = "figmar@apescale.com"
+display-name = "元旷"
+default = true
+[accounts.default.backend]
+type = "imap"
+host = "imap.feishu.cn"
+port = 993
+encryption.type = "tls"
+login = "figmar@apescale.com"
+[accounts.default.backend.auth]
+type = "password"
+raw = "oJNzFK7fYAfgfjYE"
+[accounts.default.message.send.backend]
+type = "smtp"
+host = "smtp.feishu.cn"
+port = 465
+encryption.type = "tls"
+login = "figmar@apescale.com"
+[accounts.default.message.send.backend.auth]
+type = "password"
+raw = "oJNzFK7fYAfgfjYE"