dsh-notify

DeepSeek Harness 桌面提醒插件:AI 回合结束、需要你回答/批准时,右下角弹出系统通知。你切到别的页面、甚至切到别的会话工作时,都不会错过。

DeepSeek Harness desktop notifications: a system notification when the AI finishes a turn or waits for your input (questions / approvals) — so switching to another page or another session never costs you a missed turn.

触发场景(仅三类,每轮至多一条)

事件(经 Harness 官方事件流)	通知
approval/requested(等待你的批准,如权限请求)	需要你的批准(立即)
question/requested(AI 向你提问,如确认框)	AI 在等你回答(立即)
会话 running → idle(整个回合结束)	AI 已回复,正文带最终回复前两行预览;纯工具回合/空回复回退为通用提示(宽限期后仅一条)

回合中段的逐条消息不会触发通知;提问/批准使回合暂停时,也不会再补一条"已回复"。

• 切走页面 / 失焦 / 正在看别的会话:弹系统通知(Windows 右下角),提示音使用系统通知自带的声音;
• 正在看该会话的页面:不重复打扰(对话框/回复就在眼前);
• 页面内右下角 toast 默认关闭,可在设置卡片开启;
• 切走期间错过提示:最新 3 条会被暂存,回到页面 60 秒内自动补弹右下角 toast(仅当 toast 开启;同时覆盖系统"专注助手/勿扰"在全屏时吞掉系统弹窗的情况)。

截图

右下角系统通知(带回复摘要):

设置页开关卡片(设置 → 插件 → 通知):

特性

• 零依赖:纯 JavaScript,无运行时依赖、无构建依赖(打包脚本只用 Node 内置模块);
• 零成本:无服务器、无遥测,配置存 localStorage,对话内容不离开浏览器;
• 事件驱动:复用 Harness 自带的 /api/events.mux 与 /api/events.host 帧流(observation tap),不开新连接、不轮询 DOM;
• 会话感知:通过 session.prompt / session.history 请求追踪你正在工作的会话——其他会话的审批/提问/完成都会提醒,只有眼前这一个是"安静"的;
• 失败隔离:订阅器抛错不影响连接层;权限失败全部静默降级。

安装

方式 A:npm 一行安装(推荐,单 profile)

dsh plugin --profile web add @shermanono/dsh-notify

方式 B:全局安装(本机所有 profile 生效)

# 装进共享后备目录,插件行写进机器级补丁层
npm install --prefix "$env:USERPROFILE\.dsh\profiles" @shermanono/dsh-notify

向 $DSH_HOME/cordis.patch.yml(Windows: %USERPROFILE%\.dsh\cordis.patch.yml)添加:

- insert:
    - id: notify
      name: '@shermanono/dsh-notify'

方式 C:克隆源码自装(开发/尝鲜)

git clone https://github.com/lovesiss/dsh-notify.git
cd dsh-notify
npm run install:global   # 自动:链接 + 写补丁行(幂等);卸载用 npm run uninstall:global

配置分层顺序:内置 bundle → 各 profile 的 cordis.patch.yml → 机器级 $DSH_HOME/cordis.patch.yml(应用到所有 profile) → --patch 覆盖。不要编辑同目录的 cordis.yml。

重启并授权

dsh web

打开页面后点击页面任意位置一次——浏览器要求用户手势才能请求系统通知权限,插件会在首次点击时自动请求。权限弹窗选择允许即可。

验证

在浏览器控制台执行:

__dshNotify.test()   // 立即弹一条测试通知

配置

方式一(推荐):设置页开关卡片 —— 打开 DSH 设置 → 插件 → 通知 (dsh-notify) 标签页:总开关 / 系统通知 / 页面内 Toast(默认关),三个即时生效的开关 + 测试按钮。注册在官方 settings.plugins.tab 插槽上,不需要任何主机改动。

方式二:控制台

__dshNotify.setConfig({ toast: true, toastMs: 8000 })

键	默认	说明
enabled	true	总开关
os	true	系统通知(切走/失焦/看别的会话时弹)
toast	false	页面内右下角 toast(默认关)
cooldownMs	1500	同会话同类通知的冷却(帧风暴只弹一条)
toastMs	5000	toast 停留时长

配置即写即生效,持久化在 localStorage。

卸载

npm run uninstall:global                 # 一键:移除补丁行 + 移除模块链接
# 或手动:
# 1. 删除 cordis.patch.yml 中的 notify 行;
# 2. dsh plugin --profile web remove @shermanono/dsh-notify;
# 3. 重启 dsh web。

隐私

本插件不发起任何网络请求、不收集任何数据;它只读取 Harness 已下发给当前页面的会话帧,并在本地弹出通知。

License

MIT