Zum Hauptinhalt springen
Y

dsh-mail-notify

yeho-gg/dsh-mail-notify

Lets the agent email you when a long task finishes or a scheduled check finds something, via a zero-dependency SMTP client.

Installation

dsh plugin --profile web add github:yeho-gg/dsh-mail-notify

README

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"
}
字段环境变量说明
hostDSH_MAIL_HOSTSMTP 服务器,默认走隐式 TLS(465)
portDSH_MAIL_PORT默认 465
userDSH_MAIL_USER登录账号
passDSH_MAIL_PASS163/QQ 邮箱要用授权码,不是登录密码
toDSH_MAIL_TO默认收件人(主人邮箱)
fromDSH_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 端口)
  • 单次一封、串行发送;批量通知请自己循环

Ähnliche Plugins