DeepSeek Harness Plugin

YEHO-gg/dsh-mail-notify

Stars ★ 0 Category Notifications & Integrations Added 2026-11-16

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

Install

# from GitHub (first run asks for allowBuilds approval — follow the hint, retry)

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

Any plugin you install runs third-party code with your own permissions — it can read your files, use your credentials, and reach the network, and tool approvals don’t sandbox it. GitHub-sourced plugins also run build scripts at install time — pnpm blocks those until you allow them, so an install can stop with ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED or ERR_PNPM_IGNORED_BUILDS; dsh prints the exact key to add under allowBuilds in your profile’s pnpm-workspace.yaml, and the install works on the next run. Allowing a build is a trust decision: only install sources you trust, and pin a commit (github:owner/repo#sha).

README

This plugin publishes its README in Chinese only.

让 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 端口)
  • 单次一封、串行发送;批量通知请自己循环

Content from the project README on GitHub ↗

Links

More in this category

View the whole category →

Community comments

Comments are public GitHub Discussions. Loading them connects to GitHub and Giscus; a GitHub account is required to post.