dsh-mail-notify

让 DSH 主动给主人邮箱发一封提示。适合：长任务跑完、定时巡检发现问题、人已经离开电脑但想知道结果。

配置

配置文件 ~/.dsh/mail.json（也可以全用环境变量覆盖）：

{
  "host": "smtp.example.com",
  "port": 465,
  "user": "you@example.com",
  "pass": "你的授权码，不是登录密码",
  "to": "you@example.com",
  "from": "you@example.com"
}

字段	环境变量	说明
host	DSH_MAIL_HOST	SMTP 服务器，默认走隐式 TLS（465）
port	DSH_MAIL_PORT	默认 465
user	DSH_MAIL_USER	登录账号
pass	DSH_MAIL_PASS	163/QQ 邮箱要用授权码，不是登录密码
to	DSH_MAIL_TO	默认收件人（主人邮箱）
from	DSH_MAIL_FROM	缺省同 user

什么时候该用（重要）

只发重要的、人离开电脑后仍然需要看到的内容：

• 长任务跑完的总结（比如一次批量迁移、一次整晚的构建）
• 阶段性进度汇报（几小时以上的工作告一段落）
• 自动化 / 定时巡检发现的问题或提醒（PR 合并了、CI 挂了、仓库有新 issue）

不要发： 闲聊、日常问答、临时确认、每次小改动的流水账、"我开始了"这种开场白。同一件事不要重复发。宁可不发，也不要污染邮箱。

工具

mail_notify(subject, body, to?) —— 纯文本，返回 { ok, to, subject, note? }。

{ "subject": "夜间巡检：插件市场能搜到了", "body": "PR #15322 已合并。\nhttps://github.com/..." }

实现说明

• 只用 Node 标准库的 tls，没有第三方依赖（插件通过 link: 装，自己带不了 node_modules）
• 隐式 TLS（465）+ AUTH LOGIN，正文非 ASCII 时分块 base64，标题用 encoded-word
• DATA 阶段做了 dot-stuffing，正文里以 . 开头的行不会被当成结束符

限制

• 不支持附件和 HTML 正文
• 不支持 STARTTLS（587 端口）
• 单次一封、串行发送；批量通知请自己循环