npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2026 – Pkg Stats / Ryan Hefner

@zyfgood/dsh-email-notify

v0.2.0

Published

DeepSeek Harness 插件:SMTP 邮件收发通知 — 注册 email_send(发信)与 email_check(IMAP 收信)两个模型工具,供 agent 汇报任务结果、定时任务通知、阅读/汇总收件邮件;凭证 env 引用不落盘,IMAP 主机按 SMTP 域名自动推导

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-notify

CLI 会把本包加入 profile 的 bundle 栈;随包 cordis.patch.yml 自动注入 email-notify 插件行(package.json 声明了 dsh.bundle.patch),重启 DSH 生效。

配置

  1. ~/.dsh/.env(Windows:%USERPROFILE%/.dsh/.env)写入凭证,loadLayeredEnv 启动注入,密钥不写进任何配置文件:

    [email protected]
    SMTP_PASS=SMTP授权码    # 非登录密码;网易/QQ 邮箱的「授权码」对 SMTP/IMAP 同时有效
  2. 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.<域名> 兜底 |

  3. 非网易邮箱或要加默认收件人:在 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