桌面通知 (dsh-desktop-notify)
给别人装?看 安装说明 ——从「发现」页添加索引源即可一键安装。
DeepSeek Harness跑任务时,你不用一直盯着窗口。这个插件在三个时刻弹出 DeepSeek Harness自己发出的系统通知,并播放对应的提示音:
| 时刻 | 通知内容 | 提示音 |
|---|---|---|
| 任务跑完 | 会话标题 +任务已完成 | 完成通知音 |
| 出错 /中断 /达上限 | 会话标题 +具体原因 | 失败&报错通知音 |
| 需要你回答 /授权 | 问题标题 +正文,或工具名 +理由 | 询问通知音 |
通知由 DeepSeek Harness发出
横幅显示 DSH的图标和名字,点一下直接回到应用,不会再打开「脚本编辑器」。
插件分两半:Host侧判断时机(它看得到全部会话事件,包括子代理和授权请求),Client侧在页面里真的弹通知、播音效。Host不调用 osascript。
一个容易误会的现象
**DeepSeek Harness正处于最前面的窗口时,macOS会抑制它自己的通知横幅。**这是系统行为,不是插件坏了——切到别的应用再跑任务就能看到。
(排查时我也是先被这一点骗过:窗口在前台测了两次都「没弹」,把 Finder切到前面后立刻出现。)
配置
在 插件 ›桌面通知 ›配置里改,或编辑 cordis.patch.yml:
- id: dsh-desktop-notify
config:
enabled: true #总开关
onTurnEnd: true #任务跑完时提醒
onTurnEndFailures: true #失败 /中断 /超上限也提醒
onQuestion: true #需要你选择时提醒
onApproval: true #需要你授权时提醒
rootSessionsOnly: true #只提醒主会话,不被子代理刷屏
sound: true #播放提示音
settleMs:1200 #结束后的静默期
title: DeepSeek Harness #通知标题
行为说明
- 只提醒一次:每轮
turn/end先等settleMs(默认1.2秒)。这期间若同一会话又开始新一轮(追问自动接续),取消这次提醒。 - 不重复提醒:你正要回答或授权时,那条「需要你」已说明情况,紧接着的「任务结束」不再弹。
- 不提醒子代理:默认
rootSessionsOnly: true。 - 不改会话记录:只监听已有事件,不写会话日志,也不额外发模型请求。
提示音
三段录音(各2秒,AAC)放在 sounds/:done.m4a、failure.m4a、question.m4a。
浏览器要求页面先有一次交互才允许自动播放。若某个音效没响,先随便点一下页面;通知本身不受影响(横幅设成静音,声音由我们自己的音效负责)。
首次使用
macOS第一次会问是否允许 DeepSeek Harness发通知,点「允许」。没看到横幅时依次确认:系统设置 ›通知 › DeepSeek Harness已允许;没开专注模式;DSH不是当前前台应用。
自检
想确认链路是否正常,可以直接打这几个本地接口:
curl http://127.0.0.1:58194/api/desktop-notify/status{S*3}#页面是否在轮询、通知权限如何
curl http://127.0.0.1:58194/api/desktop-notify/test{S*5}#立刻发三条测试通知
status里 polls持续增长说明页面在正常轮询;reports记录页面每次弹通知的结果(成功 /权限被拒 /抛错原因)。
关闭
在 插件里禁用,或把 enabled设为 false。关掉后不注册监听器、不轮询、不弹通知。
No comments yet. Be the first to write one.