DSH HUB
HomePlugin StorePlugin PacksCommunityRankingsResourcesPublish Guide
Plugin source
Back to catalog

MikatoMisaka /

MikatoMisaka/dsh-desktop-notify

Verified

DSH(DeepSeek Harness)桌面端通知插件:任务完成 / 等待回答时弹 Windows 通知,点通知回到对应会话。

★ 1 Stars0 Forks0 IssuesN/A Community rating0 Confirmed installs
View on GitHub
READMESource: main@613e597e

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

  1. 把包加进 profile 的依赖(或用 DSH 的插件管理器安装):

    npm --prefix <profile> install dsh-notify-focus
    
  2. <profile>\cordis.patch.yml 末尾追加(改前先备份):

    - insert:
        - id: desktop-notify
          name: dsh-notify-focus
    
  3. 在包目录里做一次本地初始化(编译置顶程序 + 登记协议):

    cd <profile>\node_modules\dsh-notify-focus
    npm run setup
    
  4. 完全退出 DSH 桌面端(托盘右键退出,不是关窗口)再打开。

从源码(Windows)

  1. 取源码到固定目录:

    git clone https://github.com/MikatoMisaka/dsh-desktop-notify D:\Projects\own\dsh-notify
    
  2. 编译并登记协议:

    cd D:\Projects\own\dsh-notify
    npm run setup
    
  3. 链进 profile(父目录 node_modules 必须已存在):

    New-Item -ItemType Junction -Path <profile>\node_modules\dsh-desktop-notify -Target D:\Projects\own\dsh-notify
    
  4. <profile>\cordis.patch.yml 末尾追加:

    - insert:
        - id: desktop-notify
          name: dsh-desktop-notify
    
  5. 完全退出 DSH 桌面端再打开。

从源码(macOS)

  1. 取源码到固定目录:

    git clone https://github.com/MikatoMisaka/dsh-desktop-notify ~/Projects/dsh-notify
    
  2. 收尾(macOS 不编译任何东西,只打印提示与权限说明):

    cd ~/Projects/dsh-notify
    npm run setup
    
  3. 链进 profile(父目录 node_modules 必须已存在):

    ln -s ~/Projects/dsh-notify <profile>/node_modules/dsh-desktop-notify
    
  4. <profile>/cordis.patch.yml 末尾追加:

    - insert:
        - id: desktop-notify
          name: dsh-desktop-notify
    
  5. 彻底退出 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 取真实值。

—/ 5

No ratings yet

Verified DSH bundle

Commit 613e597e6351

Community comments

No comments yet. Be the first to write one.

DSH HUB

A community index for DSH plugins. Not an official GitHub or DeepSeek AI product.

CommunityResourcesAPIAbout