在 DeepSeek Harness (DSH) 的使用场景中，如果 Agent 的回复耗时较长，或者用户正在处理其他任务，就可能出现错过回复的情况。dsh-desktop-notify 插件通过系统原生的 Toast 通知机制，在 AI 完成回复时提供视觉反馈，无需保持 DSH 界面在前台。
这是什么¶
这是一个为 DSH 客户端提供桌面通知功能的插件。它由开发者 crazy-L118 维护，遵循 MIT 许可证。插件不依赖运行时环境，通过系统原生接口（Windows WinRT、macOS osascript、Linux notify-send）触发通知。
核心功能¶
- 系统原生通知：AI 完成回复时，弹出系统级通知。通知正文包含回复摘要，并标注当前的工作区与会话信息。
- 设置入口：开关位于
dsh 设置→通用→「桌面完成通知」。 - 过滤机制：仅当主对话完成时触发通知，子代理的后台任务完成不会弹窗。
- HTTP 调用：支持通过 HTTP 接口将通知推送到多台设备，实现跨端提醒。
安装与启用¶
安装时必须显式指定版本号 1.4.1，以确保安装到最新版本。
dsh plugin --profile web add dsh-desktop-notify@1.4.1
安装完成后，需要重启 dsh web 进程以使插件生效。
典型用法：HTTP 调用¶
如果需要在不操作电脑时收到通知，可以配置 HTTP 推送通道。
- 准备服务：准备任意一个能接收 HTTP POST 请求的服务（可以是自建服务，也可以是兼容的第三方推送服务），获取其接口地址与（可选）访问令牌。
- 开启开关：进入
dsh 设置→通用→「桌面完成通知」，打开开关。在下方会出现「HTTP 调用」选项，打开它。 - 添加设备：点击
「添加设备」。填写设备名称、服务器地址与访问令牌。可以继续添加多台设备，每台均可独立开关或删除。 - 数据推送：离开电脑后，AI 每完成一轮回复，插件会向所有启用且填写了地址的设备发送一条 POST 请求。请求体为 JSON 格式，包含
title（标题）、body（回复预览）、token（访问令牌）和icon（图标地址）字段。
适用场景与注意¶
- 独立通道：桌面通知与 HTTP 调用是两条独立通道。你可以只开启桌面通知、只开启 HTTP 调用，或两者同时开启。
- 并行发送：多台设备的推送是并行进行的，其中任一台失败不会影响其他设备的接收。
- 安全存储：访问令牌保存在本地
~/.dsh/desktop-notify.json文件中，仅发送至你配置的服务器地址。 - 图标配置：每台设备的
icon字段默认使用插件内置的assets/dsh-icon.jpg。留空则不发送该字段，支持自定义 URL 或一键恢复默认。 - 非官方产品：本项目与 DeepSeek / 深度求索不存在隶属、合作或官方背书关系。插件名使用官方推荐的 DSH 缩写，但在描述中仅作引用。
总结¶
dsh-desktop-notify 为 DSH 用户提供了从被动查看到主动接收的体验升级。它不仅能在本地提供即时反馈，还能通过 HTTP 机制将通知延伸至其他设备。所有配置均基于本地文件与接口调用，无需额外账号体系。
