dsh-tada
Verifieddsh-tada · v0.3.0 · MIT · Web UI
Native desktop notifications for DeepSeek Harness: turn completion, errors, approvals, and questions.
Install
dsh plugin add dsh-tada Confirm the layer applied with dsh --profile default --dump-config — see the install guide.
Source
Published to npm without a public repository. Inspect the package contents before installing.
Tags
Creators
Readme
dsh-tada
DeepSeek Harness 的原生桌面通知,按普通 DSH 插件安装即可使用。
English | 简体中文
当 Agent 完成一轮对话、出错、等待你批准或回答时,dsh-tada 会用打扰最小的方式提醒你:
| 你正在…… | 提醒方式 |
|---|---|
| 查看刚刚结束的会话 | 不提醒,内容已经在屏幕上 |
| 在 DSH 里查看其他会话 | 应用内提醒(toast) |
| 在其他应用里 | 系统通知 |
通知由 DeepSeek Harness 亲自发出,所以系统通知中心显示的是 DSH 的应用名和图标,点击通知即可打开对应会话。插件不修改 DSH 的任何代码,也没有运行时依赖,桌面端和 dsh web 都可以使用。
所有提醒都由插件观察到的 DSH 事件触发,不依赖模型自己决定何时提醒。
版本兼容性
dsh-tada 面向 DeepSeek Harness 0.2.2 版本线。设置页里的导航铃铛来自 DSH 的 settings.section.icon 槽位,该槽位从 0.2.2-alpha.3 起提供。插件在 engines.dsh 中声明了这一下限:更旧的 DSH 会直接拒绝加载本插件,而不是画出兜底图标。
| dsh-tada | DSH 要求 | 设置导航图标 |
|---|---|---|
| 0.3.x | ^0.2.2-alpha.3 |
通过 settings.section.icon 槽位注册 |
| 0.2.x | 未声明 | DOM 补丁;在 DSH 0.2.2+ 上铃铛旁会多出兜底齿轮 |
DSH 会把预发布版本计入 engines.dsh 匹配,因此 ^0.2.2-alpha.3 覆盖 0.2.2 正式版、其 rc 构建以及后续 0.2.3-* 夜间版。如果更新时被以 incompatible-version 拒绝,说明当前 DSH 不在该范围内:请升级 DSH,或安装适配该版本线的 dsh-tada。
安装
dsh plugin --profile desktop add dsh-tada # 桌面端
dsh plugin --profile web add dsh-tada # dsh web
可以用版本号锁定,例如 [email protected]。在网页界面中,也可以通过 设置 → 插件 → 添加插件 输入 dsh-tada 来安装。
从本地目录安装
dsh plugin --profile desktop add /path/to/dsh-tada
客户端构建产物已经提交到仓库,从本地目录安装不需要再执行安装或构建。
离线安装
目标机器无法访问 npm 时,先打包,再把 tarball 拷贝过去安装:
npm pack
dsh plugin --profile desktop add ./dsh-tada-0.3.0.tgz
配置
打开 设置 → 通知。点击 保存 后立即生效,无需刷新或重启。
- 通知内容——编辑标题和正文模板,支持实时预览。
- 应用内提醒——1–30 秒后自动消失,或一直显示,直到点击 查看 或 关闭。
- 通知行为——总开关和各事件开关。
- 高级——通知通道、应用名、通知语言、免打扰时段、最小提醒间隔、正文最大长度。
默认提醒的事件
| 事件 | 默认 |
|---|---|
| 轮次结束、出错、等待批准、等待回答 | 开启 |
| 子任务、工作流、目标完成 | 关闭 |
模板预设
标题和正文可以混排固定文字和以下预设:
| 预设 | 内容 |
|---|---|
{{app}} |
应用名(默认 DSH) |
{{event}} |
本地化的事件名,例如 任务完成 |
{{session}} |
会话标题 |
{{workspace}} |
工作区名 |
{{detail}} |
回复摘要、错误信息、问题内容或工具原因 |
默认标题为 {{event}},默认正文为 {{session}}。无法识别的预设会原样显示,方便发现拼写错误。
免打扰与提醒频率
- 免打扰时段使用
HH:MM-HH:MM格式,支持跨夜。它只静音自动的轮次结束提醒;审批、提问、子任务/工作流/目标提醒始终送达。 - 最小提醒间隔(默认 1500 毫秒)限制同一会话的轮次结束提醒频率。
- 通知正文默认跟随应用语言,也可以强制使用中文或英文。
常见问题
收不到系统通知? 桌面端通常会自动授予通知权限;在浏览器(
dsh web)中使用时,请在页面请求权限时允许通知。升级后提醒异常? 刷新 DSH 页面,让新的 Client 生效;Host 侧更新后需要重启 DSH。
需要排查问题? 仅本机可访问的状态接口会返回通知通道状态,其中不包含任何密钥:
curl -s "$DSH_WEB_URL/dsh-tada/status"
开发
npm install
npm test # 先重新构建客户端,再运行测试
npm run check # 构建 + 预检 + 测试
Host 部分在 lib/ 中,是普通的 ESM 代码。Client 部分由 src/client/ 构建为已提交的 client/client.js——请修改源码,不要直接改构建产物。
版本历史见 CHANGELOG.md。
许可证
MIT,详见 LICENSE。