JiuMeng329/dsh-completion-notifier

README 摘要

dsh-completion-notifier A DeepSeek Harness (DSH) client plugin that watches conversations in real time and notifies you the moment a turn finishes — with an on-screen toast and a chime. 一个实时监控对话任务完成的 DSH 插件：当会话的这一轮生成结束时，右上角弹出文字提醒并播放提示音。 功能特性 - ✅ 实时检测「对话完成」：agent 停止生成的那一刻即触发 - ✅ 屏上文字提醒：右上角 Toast，自动消失 - ✅ 提示音：Web Audio 现场合成， 无需任何音频资源文件 - ✅ 声音开关：设置 → 常规 →「完成提示音」（ localStorage 持久化） - ✅ 双语文案：跟随界面中 / 英文设置 - ✅ 纯客户端插件，无 host 侧副作用 安装 前置：已安装 DSH，且有一个 web profile（ dsh web ）。 方式一：手动安装（推荐，开箱即用） 仓库里已带预构建产物 lib/ ，无需再编译。 1. 把本仓库放到 DSH 的 profile 依赖目录： 2. 在 profile 的 patch 层加入一行。编辑 %USERPROFILE%\.dsh\profiles\web\cordis.patch.yml ： 3. 重启： 方式二：dsh plugin（官方包管理器） 然后再按上面的方式把那一行写进 cordis.patch.yml ，并重启。 使用 1. 打开 web 界面，正常发起一轮对话； 2. 等 agent 这一轮回答结束，右上角会弹「任务完成」Toast，同时响两声提示音； 3. 想关掉声音：设置 → 常规 →「完成提示音」。 工作原理 DSH 运行时的 sessions 列表里，每个会话带一个 running 布尔位：agent 生成期间为 true ，本轮结束翻回 false 。插件在 shell.overlay （全屏浮层插槽）里渲染一个监听组件，跨渲染比较该位： - true → false ⇒ 判定「这一轮刚完成」⇒ 弹 Toast + 播提示音； - 首帧只播种基线，已空闲的会话不会误报。 开发 / 构建 源码用 TypeScript + React（JSX），构建用 tsdown 。推荐在 deepseek-harness 仓库内开发（共享构建工具会生成 window. ModuleLoader .load 包裹与 lib/types/ 布局）： 关键不变量（自建构建时需满足）见 tsdown.config.ts 注释与构建说明。 目录结构 License MIT

分类