你不在电脑前时由 agent 邮件提醒你:稳定 SMTP(不重试 535)、连接与空闲超时,并带 --check 自检。
安装
# GitHub 源码(首次需按提示配置 allowBuilds 构建授权后重试)
dsh plugin --profile web add github:JamesYasR/dsh-email-push-master
装任何插件都等于在你的机器上跑第三方代码,权限和你本人一样大——能读你的文件、用你的凭据、访问网络,工具审批管不到它。GitHub 来源的插件还会在安装时执行构建脚本——pnpm 默认拦截,所以安装可能停在 ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED 或 ERR_PNPM_IGNORED_BUILDS;dsh 会打印出需要添加的确切键名,把它加进该 profile 的 pnpm-workspace.yaml 的 allowBuilds 下,重跑一次即可装上。放行构建本身就是一次信任判断:请只安装可信来源,并尽量锁定 commit(github:owner/repo#sha)。
README
English | 中文
你不在电脑前时,agent 用邮件提醒你回来。
你在 DSH(或其他 AI 编码 agent)里派一个长任务 goal,然后离开电脑。当 agent 完成、卡住、或需要你决策时,它发一封邮件到你手机邮箱——你看到就回来。单向通知,不做远程指挥。
来源与修复
本项目是 dsh-notify-skill 的 fork(MIT 开源),做了稳定性加固:
- 去掉
535自动重试(旧版会把账号越试越锁)、修复subject/text崩溃; - 新增连接/空闲超时、
--check自检、结构化错误分类、完整邮件头。
详见 CHANGELOG.md。
设计理念:自带发送器,避免手写兜底
本 skill 打包一个零依赖实现——sender.mjs(只用 Node 内置 tls/net),让 agent 在每个正常 DSH 会话里都能确定地发信(DSH 本身就跑在 Node 上)。发送器内置:连接/空闲超时、结构化错误分类(535/550/网络)、535 绝不重试(避免触发账号风控)、完整邮件头。SKILL.md 仍然承载完整契约:
- 何时通知(goal 完成 / 阻塞 / 提问决策前 / 长任务节点),
- 写什么(具体、用你的语言、简短),
- 配置契约(
config.json:发件邮箱、SMTP 授权码、收件邮箱;QQ/163 邮箱自动推断服务器), - 配置缺失时如何引导用户获取 SMTP 授权码,
- 故障处理与安全规则。
万一 Node 真的不可用(极少见),agent 应该停下来告诉用户,而不是手写 SMTP;手写 SMTP 正是间歇性 535 认证失败的主要来源。
触发时机
| 时机 | 建议标记 |
|---|---|
| goal 完成 | done |
| goal 阻塞/卡住 | block |
| 即将向你提问决策时 | question |
| 长任务关键节点 | info |
agent 必须通过自带的发送器发信(不要自己手写 SMTP):
node sender.mjs "标题" "正文" # 读取旁边的 config.json 并发送
node sender.mjs --check # 只验证配置 + SMTP 认证,不真正发信
经验备注(Windows):.NET
SmtpClient在 465 隐式 TLS 上有已知挂起问题——自带发送器改用node:tls,无此问题。
兼容性
| DSH 版本 | 状态 |
|---|---|
0.2.0-rc.2(当前 npm latest) |
支持 —— 已对实际运行时逐项验证 |
< 0.2.0-rc.2(如 0.1.2-rc.1) |
不支持 —— 1.3.0 对齐的是当前插件 API |
>= 0.3.0 |
尚未适配 —— DSH 改动插件 API 后需同步更新 |
DSH 会校验插件的 @deepseek-ai/dsh-* peerDependencies 是否满足当前运行时,不满足时安装阶段直接拒绝,
而不是等到运行后崩溃:
dsh: installation rejected: Plugin dsh-email-push-master@1.3.0 is incompatible with dsh 0.3.0: peerDependencies {...}
安装(DSH)
插件安装(推荐) —— 本 skill 以 DSH 插件形式发布,自动注册到 ctx.skills:
dsh plugin --profile web add dsh-email-push-master
或用 GitHub 源:dsh plugin --profile web add github:JamesYasR/dsh-email-push-master。装完重启一次 dsh web,会话 skill 目录里就会出现它。
桌面版:可以直接装进 desktop profile(先完全退出桌面版,它持有 profile 锁):
dsh plugin --profile desktop add dsh-email-push-master
也可以只装 web profile,然后浏览器打开 dsh web 打印的地址——桌面版外壳复用同一个 web server,
两边的设置界面完全一致。
手动安装(不装插件) —— DSH 也会从 <dshHome>/skills/<name>/SKILL.md 发现 skill(默认 ~/.dsh/skills),文件监视器热加载:
git clone https://github.com/JamesYasR/dsh-email-push-master.git "$HOME/.dsh/skills/notify"
也可以手动把文件夹复制到 ~/.dsh/skills/notify/。新会话立即生效。
配置(一次性,约 5 分钟)
直接让 agent 用这个 skill,它也会引导你完成。
- 获取 SMTP 授权码(不是登录密码):
- QQ 邮箱:网页版 → 设置 → 账户 → 开启「POP3/SMTP 服务」→ 生成 16 位授权码
- 163 邮箱:网页版 → 设置 → POP3/SMTP/IMAP/SMTP → 开启 → 新增授权码
- 复制
config.example.json为config.json并填写:{ "email": { "smtpHost": "", "smtpPort": 465, "useSsl": true, "from": "your-address@qq.com", "authCode": "16位授权码", "to": "recipient@example.com" } }smtpHost可留空,按地址自动推断(@qq.com→smtp.qq.com,@163.com→smtp.163.com,465 SSL)。 - 测试:让 agent 发一条测试通知即可(它会调用自带的发送器)。
其他 agent(Claude Code、Codex 等)
无需任何兼容工作——现在的 agent 很聪明,把 SKILL.md 和配置契约指给它;让它使用自带的发送器,不要重新实现 SMTP。
安全
config.json(含你的 SMTP 授权码)和notify.log已 gitignore——绝不要强推入库。授权码泄露等于别人能用你的邮箱发信。- skill 指令要求 agent 绝不打印或提交授权码。
License
快速开始
dsh plugin --profile web add github:JamesYasR/dsh-email-push-master
装完重启 dsh web,到 设置 → 邮件推送 里填写服务商 / 发送服务器 / 发件邮箱 / 密钥 / 收件邮箱即可;
也可用 node sender.mjs --check 做认证自检。
设置页由主机端 /dsh-email-push/config 与 /dsh-email-push/test 两条路由支撑;SMTP 授权码从不回显到浏览器
(返回掩码 + hasAuthCode 标记,留空即保留原值)。
链接
同类插件
xmanrui/dsh-im★ 3574
通过二维码或机器人凭据将 IM 机器人接入 DeepSeek Harness(支持飞书、微信、钉钉、企业微信、QQ、Slack、Telegram、Discord 和 WhatsApp 共 9 种渠道)。
shaobeichen/dsh-pocket★ 2955
手机远程访问 DSH Web 界面:扫码即用局域网或公网(cloudflared 隧道)访问,实时同屏、移动端适配布局,带设置页管理。
OpenPetsHQ/openpets#dsh★ 1400
将 DeepSeek Harness 的生命周期状态、错误与审批请求,桥接到本地运行的 OpenPets 桌面伙伴。
c1overzz/dsh-bili-scroll★ 1393
让你的 DSH 自己刷 B站 —— 读字幕原文挑内容、写日报,遇到值得看的会发评论 @ 你。
inclusionAI/Avernet#deepseek-harness-channel-bcn★ 602
通过 WebSocket V2 将 DeepSeek Harness 接入 Avernet Bot 协作网络,支持自动注册、Agent 会话隔离、工具调用事件和多 Bot 路由工具。
zaofan-make/dsh-qqbot★ 251
QQ 官方机器人通道(tencent-connect/dsh-qqbot 的增强 fork):群/私聊ai陪聊、富媒体收发、表情包打标入库+检索发图、入群审批/禁言/群发、定时唤醒、QQ 远程审批与提问卡、互动按钮卡、多账号多实例、扩展接口、群友记忆注入、按消息价值唤醒省token、上下文自动压缩、悬浮球设置面板。
社区评论
评论公开保存在 GitHub Discussions。加载评论会连接 GitHub 和 Giscus;发表内容需要 GitHub 账号。