description: "DSH 桌面端(Windows / macOS)通知插件:任务完成或等待回答时弹系统通知,点通知直接回到对应会话。" kind: "package-reference"
dsh-desktop-notify
DeepSeek Harness 桌面端(Windows / macOS)的通知插件。
作用
- 任务完成提醒:一轮任务结束时弹系统通知,正文预览这轮回复的最后一段,留在通知中心。
- 等待你回答时提醒:提问、计划审阅、工具调用确认各有文案(工具确认带工具名)。
- 点通知直达会话:把 DSH 拉到前台,并切到那条通知对应的会话。
- 收进托盘也能找回:DSH 关窗口即隐藏到托盘,照样能恢复并置顶(Windows 上靠预编译的置顶程序)。
- 不误打扰:你看这条会话时不提醒;子智能体不单独提醒;1.5 秒同键去重、10 秒最多 6 条。
- 可配:三档触发时机,设置页里点选即生效。
安装
需要 DSH 桌面端(Windows 10/11 或 macOS)。下文 <profile> 指 profile 目录(看 $env:DSH_HOME 与 $env:DSH_PROFILE,不一定在默认位置),<包名> 指实际安装名(npm 上是 dsh-notify-focus)。
两个平台只在「怎么弹通知」上不同:
| Windows | macOS | |
|---|---|---|
| 原生程序 | 需要编译 bin\focus-window.exe |
不需要 |
| 协议登记 | 需要 dsh-notify:(HKCU) |
不需要 |
| 通知署名 | AUMID,写错会静默丢 toast | 由 App 的 bundle id 决定,无需配置 |
| 首次授权 | 无 | 系统会问一次「允许通知」 |
macOS 的实现与限制见 docs/macos-adaptation.md。
从 npm
把包加进 profile 的依赖(或用 DSH 的插件管理器安装):
npm --prefix <profile> install dsh-notify-focus<profile>\cordis.patch.yml末尾追加(改前先备份):- insert: - id: desktop-notify name: dsh-notify-focus在包目录里做一次本地初始化(编译置顶程序 + 登记协议):
cd <profile>\node_modules\dsh-notify-focus npm run setup完全退出 DSH 桌面端(托盘右键退出,不是关窗口)再打开。
从源码(Windows)
取源码到固定目录:
git clone https://github.com/MikatoMisaka/dsh-desktop-notify D:\Projects\own\dsh-notify编译并登记协议:
cd D:\Projects\own\dsh-notify npm run setup链进 profile(父目录
node_modules必须已存在):New-Item -ItemType Junction -Path <profile>\node_modules\dsh-desktop-notify -Target D:\Projects\own\dsh-notify<profile>\cordis.patch.yml末尾追加:- insert: - id: desktop-notify name: dsh-desktop-notify完全退出 DSH 桌面端再打开。
从源码(macOS)
取源码到固定目录:
git clone https://github.com/MikatoMisaka/dsh-desktop-notify ~/Projects/dsh-notify收尾(macOS 不编译任何东西,只打印提示与权限说明):
cd ~/Projects/dsh-notify npm run setup链进 profile(父目录
node_modules必须已存在):ln -s ~/Projects/dsh-notify <profile>/node_modules/dsh-desktop-notify<profile>/cordis.patch.yml末尾追加:- insert: - id: desktop-notify name: dsh-desktop-notify彻底退出 DSH(⌘Q)再打开;首次弹通知时允许「系统设置 → 通知 → DeepSeek Harness」。
卸载:删掉那段 insert → npm run protocol:uninstall(仅 Windows 需要)→ cmd /c rmdir <profile>\node_modules\<包名>(macOS 用 rm <profile>/node_modules/<包名>)→ 重启 DSH。
代码结构
lib/
├── index.js Host 主干:路由 / 限流 / 去重 / 回复预览 / 诊断日志(无平台分支)
├── client.js 浏览器半边:判该不该提醒;非 Windows 时自己弹系统通知
└── platform/
├── index.js 适配器选择器 + PlatformHost 契约
├── windows.js WinRT toast / AUMID 核对 / 协议 / 置顶程序 / click.json
└── delegated.js 非 Windows:Host 不弹,正文回给渲染进程
想知道「某个平台上做了什么」,只需要看 lib/platform/ 下对应的那一个文件。详细对照见
docs/macos-adaptation.md。
配置
界面
「设置 → 通用 → 任务完成提醒」三档按钮,选择存本机(localStorage),优先于 profile 默认值。
| 档位 | 含义 |
|---|---|
| 不在前台就提醒(默认) | 切走、最小化、收进托盘、锁屏都提醒;在前台但停在别的会话上也提醒 |
| 仅最小化时 | 只有最小化 / 收进托盘才提醒 |
| 总是提醒 | 包括你正盯着这条会话 |
profile
<profile>\cordis.patch.yml 里那条 insert 的 config:
| 键 | 默认值 | 含义 |
|---|---|---|
aumid |
com.deepseek.dsh |
仅 Windows:通知署名的 AppUserModelID;启动时会用 Get-StartApps 核一次登记状态。 |
fallbackAumid |
PowerShell 自己的 ID | 仅 Windows:主署名的备用身份;显式给空串表示关闭兜底。 |
sound |
true |
是否带提示音(仅 Windows 生效)。 |
trigger |
unfocused |
unfocused / minimized / always;仅当用户没在设置里选过时生效。 |
protocol |
true |
仅 Windows:是否登记 dsh-notify: 协议(点通知的快路径)。 |
debug |
true |
是否写日志:Windows %LOCALAPPDATA%\dsh-desktop-notify\host.log,macOS ~/Library/Logs/dsh-desktop-notify/host.log。 |
aumid 写错不会报错,只会让 toast 被静默丢掉;启动日志里看到 aumid-unregistered 就说明配置的 ID 没登记,跑 scripts\read-aumid.ps1 取真实值。
No comments yet. Be the first to write one.