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

@bit-ark/dsh-notify

v0.1.1

Published

Generic in-app notifications: top toast + session-header bell with tray, provided as the notifier client service

Downloads

258

Readme

dsh-notify

通用应用内通知插件:顶部 toast + 会话头铃铛/托盘,并对外提供 notifier 客户端服务供其他插件消费。

  • toast:屏幕顶部居中的瞬时通知(自动消失),点击可执行通知自带的 onClick。toast 宿主挂在 body 上,不依赖任何会话即可工作。
  • 铃铛/托盘:会话头工具区(conversation.session.header.utilities 插槽, order 0)的铃铛按钮,带未读计数徽标;点击展开通知托盘,可逐条「知道了」。
  • notifier 服务ctx.get('notifier') 暴露 { notify(input), dismiss(id) }。 消费方可选(特性探测):本插件未装载时消费方行为不变。

结构

index.js    宿主半:最小占位(无路由、无写操作)
client.js   客户端半:toast 宿主 + 铃铛/托盘 + notifier 服务
cordis.patch.yml  自带组合层:插入 dsh-notify 行

消费方式(给插件作者)

// 任意已装载的客户端插件(可选依赖,勿写进 inject):
const notifier = ctx.get('notifier')
if (notifier !== undefined) {
  notifier.notify({
    id: 'my-event-123',          // 同一 id 本会话只 toast 一次
    title: '发现新版本',          // toast 标题(必填)
    body: 'v1.2.3 可更新',       // 可选,托盘保留(当前托盘只展示 title)
    tone: 'update',              // 'update' | 'error' | 其他(绿点)
    onClick: () => { /* 点击 toast 的行为 */ },
  })
}

安装(已完成则跳过)

在 deepseek-harness checkout 目录执行(插件已发布到 npm,按名安装即可):

pnpm dsh plugin --profile web add @bit-ark/dsh-notify

生效方式

  • 本插件功能全在客户端半:改动后刷新页面即可(重启更稳妥)。dev:web watcher 不覆盖树外插件,属预期行为。

通用性说明

  • 纯客户端服务 + UI,不触碰 harness 私有实现;样式全部使用主题 token (--dsw-alias-*),深浅主题自动适配。
  • 不产生任何示例通知(无自检桩);真正的通知来自消费方(如 dsh-update 的 新版本提醒),保证业务闭环且共享时无噪音。