@zyfgood/dsh-email-notify
v0.2.0
Published
DeepSeek Harness 插件:SMTP 邮件收发通知 — 注册 email_send(发信)与 email_check(IMAP 收信)两个模型工具,供 agent 汇报任务结果、定时任务通知、阅读/汇总收件邮件;凭证 env 引用不落盘,IMAP 主机按 SMTP 域名自动推导
Maintainers
Readme
@zyfgood/dsh-email-notify
DeepSeek Harness 邮件插件:注册 email_send(发信)与 email_check(收信)
两个模型工具,让 agent 发送任务结果/通知邮件、阅读/汇总收件邮件。
凭证(user/pass,邮箱「授权码」)SMTP 与 IMAP 共用;IMAP 主机默认从
host 推导(smtp.yeah.net → imap.yeah.net:993),可用 imapHost 覆盖。
从 dsh-feishu-bot v0.3.0 的邮件功能隔离而来(2026-08 起,公开的飞书 插件 v0.4.0+ 不再包含邮件能力)。
模型工具
email_send:发送邮件。参数subject、content、to(默认取配置, 未配置则发给SMTP_USER自己)、html。email_check:通过 IMAP 收取邮件。参数limit(1-10,默认 3,最新 N 封)、unseen_only、mailbox(默认 INBOX)、mark_read、max_chars(每封正文 200-8000,默认 2500)。返回发件人/主题/正文摘要与附件名,按新到旧排列。 未读模式走「先扫 flags 再取正文」两阶段,不依赖各服务器行为不一的 SEARCH。
安装(bundle 形态,一条命令)
dsh plugin --profile <name> add @zyfgood/dsh-email-notifyCLI 会把本包加入 profile 的 bundle 栈;随包 cordis.patch.yml 自动注入
email-notify 插件行(package.json 声明了 dsh.bundle.patch),重启 DSH 生效。
配置
~/.dsh/.env(Windows:%USERPROFILE%/.dsh/.env)写入凭证,loadLayeredEnv启动注入,密钥不写进任何配置文件:[email protected] SMTP_PASS=SMTP授权码 # 非登录密码;网易/QQ 邮箱的「授权码」对 SMTP/IMAP 同时有效SMTP 服务器按发件域名在随包 patch 中配置(默认
smtp.yeah.net:465):| 发件域 | host | |---|---| | yeah.net | smtp.yeah.net | | 163.com | smtp.163.com | | 126.com | smtp.126.com | | qq.com / foxmail.com | smtp.qq.com | | 其他 |
smtp.<域名>兜底 |非网易邮箱或要加默认收件人:在 profile 自己的
cordis.patch.yml里按id: email-notify覆盖(profile patch 在 bundle patch 之后合并;config 为整键替换,覆盖时请带上全部键):- id: email-notify name: '@zyfgood/dsh-email-notify' config: host: smtp.qq.com # IMAP 自动推导为 imap.qq.com port: 465 secure: true user: 'env:SMTP_USER' pass: 'env:SMTP_PASS' to: [email protected] # 可选,默认收件人
开发
npm run build # tsc → lib/
npm test # tests/smoke.mjs 冒烟测试(mock,不联网)
node tests/send-live.mjs [收件人] # 真实 SMTP 发送冒烟(读 ~/.dsh/.env)
node tests/receive-live.mjs 3 [--unseen] [--mark-read] # 真实 IMAP 收取冒烟License
MIT
