QQ邮箱附件直发

要解决的问题

QQ 邮箱 MCP 的 SendMessage 发附件时，要求先把文件 base64 编码成上万字符，再原样写进工具参数。模型手工转录 base64 串时，O/0/I/l/1 这类字符极易抄错一位，服务器会直接拒收并报 content 校验失败。附件越大、串越长，链路越脆弱——根源在于模型参与了本不该参与的字符串搬运。

工作原理

这个技能用 Python 直连 QQ 邮箱 SMTP 服务，绕开了上述环节：

• 底层用标准库 smtplib + ssl 建立加密连接；
• 附件的 base64 由脚本在代码内通过 email.encoders.encode_base64 完成，模型只传文件路径，不接触长字符串；
• 脚本 ~/.workbuddy/send_qqmail.py 自包含、无第三方依赖；
• 配置读取 ~/.workbuddy/qqmail_config.json，形如 {"email":"75536278@qq.com","auth_code":"你的SMTP授权码"}；也可临时用环境变量 QQMAIL_EMAIL / QQMAIL_AUTH_CODE 覆盖。

首次使用需一次性配置：登录 QQ 邮箱网页版 → 设置 → 账户 → 开启 POP3/SMTP 服务，生成授权码（不是登录密码）并写入配置文件。

使用方式

• 多收件人：--to "a@qq.com,b@qq.com"，逗号分隔；
• 支持任意附件类型；中文文件名按 RFC2231 编码，不会乱码；
• 脚本只用标准库（smtplib / ssl / email），任意 Python 3 环境都能运行。

注意点

• 收件人邮箱必须真实存在；当前绑定邮箱为 75536278@qq.com（注意不是 75537289）；
• 授权码仅保存在本机配置文件，不要写进代码或提交到仓库；
• 未配置授权码时，脚本会打印清晰指引并以退出码 2 结束，不会静默失败。