桌面通知 starsYHyh/dsh-plugins

dsh-plugins

我在 DeepSeek Harness（简称 dsh）桌面端用的一组本地插件。

这里的插件都是 profile 级本地插件：不发布到 npm，装在 ~/.dsh/profiles/<profile>/ 下，靠 cordis.patch.yml 里的一行注册——因此不会被应用更新覆盖，也随时可以整目录删掉。

插件

| 插件 | 说明 | 位置 |
| dsh-notify | 会话事件的本机通知：回合完成、或需要你授权/回答时弹系统横幅；只在你不看页面时打扰 | plugins/dsh-notify/ |
| dsh-browser 定制版 | Chrome 侧边栏助手，把浏览器标签页交给 dsh 来读和点；含 @ 引用标签页、模型/推理等级菜单、消息时间与复制、右键「向 DeepSeek 提问」 | 独立 fork → 分支 · Release |
| dsh-chat-manager | 会话历史管理：搜索归档、恢复会话、安全删除。第三方（作者 WSL043，MIT），这里只做推荐 | npm i dsh-chat-manager |

dsh-browser 为什么不放进本仓库：它是上游 omdsh-dev/dsh-browser 的 fork（MIT）。保持 fork 形态才能持续 git rebase 跟进上游、并向上游提 PR；搬进本仓库会把这两件事都丢掉，所以这里只保留入口链接。

安装 dsh-notify

前提：已安装 DeepSeek Harness 桌面端。本插件通过页面自己的 Notification API 弹通知（所以通知显示为 DeepSeek Harness 的身份、且遵守系统专注模式），面向桌面 GUI。

1. 放置插件

git clone https://github.com/starsYHyh/dsh-plugins.git
cp -R dsh-plugins/plugins/dsh-notify ~/.dsh/profiles/<profile>/plugins/

<profile> 通常是 desktop（桌面 App）或 web（dsh web / CLI）。

2. 注册到 profile

在 ~/.dsh/profiles/<profile>/cordis.patch.yml 末尾追加：

- insert:
- id: dsh-notify
name: ./plugins/dsh-notify/lib/index.js

name 是相对该 patch 文件所在目录的路径，所以插件目录必须和 cordis.patch.yml 同级放在 plugins/ 下。

3. 重启 dsh

桌面 App 用 Cmd+Q 完全退出再启动。

验证装好了

应用内置开发者工具（Console）里：

__dshNotify.state() // shapeOk 应为 true，running 与界面一致
__dshNotify.test() // 立刻弹一条测试通知

macOS 不给前台应用弹横幅：先把窗口切到别的应用，再回车执行 __dshNotify.test()。

离线回归测试（纯逻辑，不需要 dsh 在跑）：

node plugins/dsh-notify/test/harness.mjs

卸载

1. 删掉 cordis.patch.yml 里上面那段 - insert:；
2. 删掉 ~/.dsh/profiles/<profile>/plugins/dsh-notify/；
3. 重启 dsh。

可调行为

设置存在页面 localStorage 里，改完立即生效（只影响渲染进程，重启页面后仍保留）：

| 键 | 默认 | 含义 |
| dshNotify.enabled | 1 | 0 关闭全部通知（保留订阅） |
| dshNotify.greet | 1 | 0 关闭启动时的「通知已开启」提示 |
| dshNotify.silent | 0 | 1 静音（只弹横幅不响） |
| dshNotify.always | 0 | 1 即使你正看着页面也弹通知 |
| dshNotify.subagents | 0 | 1 子会话（subagent）完成也通知 |
| dshNotify.settleMs | 1500 | 回合结束后的稳定判断窗口（0–10000 ms） |

例：localStorage.setItem('dshNotify.silent','1')。

触发规则、边界情况和架构说明见 plugins/dsh-notify/README.md。

许可

本仓库自有代码（dsh-notify）为 MIT，见 LICENSE。

dsh-notify 依赖 DeepSeek Harness 的内部客户端契约（uiSession 会话投影、 window.__ModuleLoader__ 的 bundle 约定），dsh 大版本更新后可能需要适配。
插件对此有防御：形状不符时只打印一条明确的警告并把 shapeOk 置为 false，不会静默失效、也不会影响页面。