前言¶
在 DeepSeek Harness（DSH）里跑长任务时，模型一轮回复结束、等待你继续输入，界面往往不在前台。Claude Code、Codex 等工具会在完成时给出系统级提示；DSH 默认没有同等机制，切到其他窗口后容易错过「可以接着干」的时机。下面介绍社区插件 dsh-session-toast：在每一轮 turn/end 时，于 Windows 11 右下角弹出原生 Toast（必要时降级为托盘气泡），并在 DSH 处于前台时默认不打扰。
这是什么¶
dsh-session-toast 是 DSH 宿主侧插件，维护者为 LeeeWM，在 SkillHub 目录中归类为客户端。它监听会话的 session/event → turn/end，把完成或出错等状态转成一条 Windows 通知，正文通常包含会话标题、用时与轮次编号；无标题时退回工作目录名。插件仅面向 Windows（win32），其他平台会自动不激活。许可证为 MIT，当前仓库版本为 0.2.0，在 package.json 中声明与 DSH 0.2.1-rc.3 兼容。
安装时请统一使用包名 dsh-session-toast。README 说明：npm 上的 dsh-session-notifier 属于另一位作者，与本项目无关，按旧名安装可能装错。
核心功能¶
完成通知与过滤¶
默认在 completed 与 error 两种结束原因下通知（可通过 notifyOn 调整为仅完成、或包含 aborted 等）。子代理会话默认忽略，避免一次主任务弹出多条；需要时可设 notifySubagents: true。
前台感知与去抖¶
onlyWhenUnfocused 默认为 true：当前前台窗口进程名匹配 dshProcessNames（默认 DeepSeek Harness）时不弹通知。收到 turn/end 后还有 1.2 秒去抖（debounceMs 可调）；若其间发生 turn/start，会取消上一条待发通知，减少连续轮次刷屏。
投递方式¶
宿主侧用 Node 内置模块监听事件，通过 powershell.exe 执行仓库内的 notify.ps1；payload 以 base64(UTF-8 JSON) 传入 argv，避免中文与 emoji 受代码页影响。通知优先走 WinRT ToastNotificationManager，不可用时降级 NotifyIcon 气泡。无 npm 运行时依赖，也不依赖 BurntToast。
可配置项概览¶
config 共 15 个可选键，省略即用默认值。常用项包括：enabled、sound、language（zh / en）、minTurnDurationMs（过短轮次不通知）、mode（auto / toast / balloon）、dryRun（只打 payload 不弹窗，便于测试）、logFile（notify.ps1 诊断日志）。完整表格见 GitHub README。
安装与启用¶
插件以当前 DSH 进程权限运行；安装前建议浏览仓库源码与 MIT 许可证，确认符合本机策略。
非桌面 profile（web / headless / tui 等）¶
README 推荐从 GitHub 安装，命令如下（将 <profile> 换成实际 profile 名）：
dsh plugin --profile <profile> add github:LeeeWM/dsh-session-toast
dsh --profile <profile> --dump-config | Select-String "dsh-session-toast"
输出中应能看到与 dsh-session-toast 相关的配置段（文档示例为 # == dsh-session-toast）。
桌面 profile¶
桌面 profile 由 Electron 独占管理，CLI 会拒绝安装。需在 DSH Plugins → Add plugin → Install a third-party plugin 中填写插件目录的绝对路径，再 Install → Enable now。若 UI 支持直接填 GitHub 包名，也可尝试 github:LeeeWM/dsh-session-toast；仓库文档以目录安装为准。
本地 link 安装¶
dsh plugin --profile <profile> add "C:\path\to\dsh-session-toast"
修改 index.js 或 notify.ps1 后，需禁用再启用插件或重启 DSH 才会加载新代码。
从 v0.2.0 起若仍保留旧 id dsh-session-notifier，应在 Plugins 中 Remove 后按上法重装 dsh-session-toast，并用 --dump-config 确认插件行存在。
典型用法¶
覆盖默认配置¶
在机器级用户层 $DSH_HOME/cordis.patch.yml 中对插件行做整行覆盖（文档提醒：不要手改桌面 profile 目录下的 package.json / cordis.patch.yml）。示例：
- id: dsh-session-toast
name: dsh-session-toast
config:
enabled: true
notifyOn: completed-and-error
onlyWhenUnfocused: false
sound: true
language: zh
debounceMs: 800
notifySubagents: false
mode: auto
logFile: 'C:\Users\Lenovo\.dsh\logs\dsh-session-toast.log'
onlyWhenUnfocused: false 表示即使 DSH 在前台也弹出，适合需要始终提醒的场景。
排查「装了但没通知」¶
- 用
dsh --profile <profile> --dump-config确认插件已启用，输出含dsh-session-toast段；仅出现在package.json依赖而未进入 bundle 时不会加载。 - 检查 Windows 设置 → 系统 → 通知 与勿扰模式。
- 设置
logFile查看notify.ps1日志；或设环境变量DSH_SESSION_TOAST_DEBUG=1，在 DSH 控制台查看turn/end是被过滤、前台跳过还是已投递。
临时调试可用：dsh --profile <test> --patch <overlay.yml>。
适用场景与注意¶
适合在 Windows 11 上使用 DSH、且经常在后台跑多轮对话的开发者。系统需自带 Windows PowerShell 5.1；Node 20+ 由 DSH 运行时提供。
需注意：Toast 约 5 秒后自动消失，插件不实现点击回焦 DSH；勿扰或系统通知总开关关闭时 Toast 可能被静默丢弃，可尝试 mode: balloon。通知正文含本地会话标题，不联网。多会话并行时按会话分别通知。
DSH 生态强调「一切皆插件」；SkillHub 目录 为社区站点，与 DeepSeek / 幻方无官方从属关系。
结尾¶
dsh-session-toast 把 DSH 的轮次结束事件映射为 Windows 原生通知，并用前台检测与去抖控制打扰程度。进一步了解配置、工作原理与开发验证命令，见仓库 README。
- 目录页：https://www.skillhub.cn/plugins/LeeeWM/dsh-session-toast
- GitHub：https://github.com/LeeeWM/dsh-session-toast
