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 端口)
- 单次一封、串行发送;批量通知请自己循环
Links
More in this category
xmanrui/dsh-im★ 3648
Connect IM bots to DeepSeek Harness via QR codes or bot credentials (9 channels: Feishu, WeChat, DingTalk, WeCom, QQ, Slack, Telegram, Discord, and WhatsApp).
shaobeichen/dsh-pocket★ 3000
Remote phone access to the DSH Web UI: scan a QR code for LAN or public (cloudflared tunnel) access with real-time sync, a mobile-adaptive layout, and a settings tab.
c1overzz/dsh-bili-scroll★ 1421
Let your DSH agent browse Bilibili on its own, read subtitles, write a daily digest, and @ you when it finds something worth your attention.
OpenPetsHQ/openpets#dsh★ 1401
Bridges DeepSeek Harness lifecycle status, errors, and approval requests to a locally running OpenPets desktop companion.
inclusionAI/Avernet#deepseek-harness-channel-bcn★ 605
Connects DeepSeek Harness to Avernet's Bot Collaboration Network over WebSocket V2, with automatic onboarding, isolated agent sessions, tool-call events, and multi-bot routing tools.
zaofan-make/dsh-qqbot★ 260
QQ official bot channel (enhanced fork of tencent-connect/dsh-qqbot): full agent chat in groups and DMs, rich media, an auto-tagged sticker library with AI image replies, join approval, mute and broadcast, scheduled wakeups, remote approvals over QQ, interactive cards, multi-account instances, extensions, member profiles, and token-saving value-scored wakeups.
Community comments
Comments are public GitHub Discussions. Loading them connects to GitHub and Giscus; a GitHub account is required to post.