会话回复通知 platinum952/dsh-session-notify

dsh-session-notify

给 DeepSeek Harness 会话用的回复通知。

工作区多了以后，经常同时开好几个会话。你正在看的那个之外，别的会话回复完了也应该提醒你。
这个插件盯着 Host 上的所有会话，后台会话一回复完，就往 Web UI 顶部居中推一张微信式的 toast：

- 标题 —— <工作文件夹名>-<会话标题>，单行，超长省略。
- 描述 —— AI 回复的前几个字，两行，超出用 ... 省略。
- 堆叠 —— 最多六张，新的在上；旧的不自动消失，关掉才走。
- 关闭 —— 每张右上角都有 ×。
- 跳转 —— 点卡片直接打开对应会话。
- 样式 —— 浅灰卡片 + 大范围柔和阴影，18px 圆角，上下渐变，从上到下淡入淡出。
- 安静 —— 你正在看的会话不弹；子 agent 会话也不弹。

安装

这个包是一个 DSH bundle：一个 Host 行加一个浏览器半体。在运行中的 profile 里，用 package.json 所在目录安装：

plugin_manager install_bundle target: /绝对路径/dsh-session-notify

或者在 profile 里用命令行：

pnpm add /绝对路径/dsh-session-notify

然后把 dsh-session-notify 加进 profile 的 cordis.patch.yml（或者在插件管理页里打开这一行）。
装完刷新一次页面：浏览器半体是从已安装的包提供的，新开页面才会生效。

卸载用 plugin_manager remove_bundle（或者删掉那一行）。

配置

浏览器半体读不到 Loader 行配置，所以可调项是 client.js 顶部的常量。改完刷新页面即可：

| 选项 | 默认 | 含义 |
| maxToasts | 6 | 屏幕上最多几张卡片，超出的从底部挤掉。 |
| ttlMs | 0 | 自动消失延时；0 表示不自动消失，只能手动关；大于 0 时窗口在后台会暂停计时。 |
| pageMessages | 8 | 一次尾部读取请求的消息条数。 |
| maxBodyChars | 200 | 保留的回复摘录上限；显示几行由 CSS 决定。 |
| includeActiveSession | false | 当前窗口正在看的会话也弹。 |

实现方式

全部逻辑都在浏览器里跑，Host 半体只是一个空的 Loader 入口。

1. 浏览器半体订阅转发过来的 api-session/status，在会话停止运行时动作。
2. 读该会话的 projection 水位（session/projections），里面带持久标题和生效中的工作目录。
3. 通过 session/page 读一页以该水位结尾、按消息对齐的历史，取这一页里最后一条 assistant 消息。
4. 如果这条消息就是这一轮的回复，就把它发到全帧的 shell.overlay slot 上。整个过程不会打开会话，所以一条通知只是一次短读，不碰工作区视图。

插件不保存任何持久状态：刷新页面就是空栈，只通知页面打开期间完成的回复。

session Remote 命名空间用 ctx.get('remote.session') 取，而不是 ctx.remote.session：命名空间挂在 Client 根上，而 remote.session 属性是走调用方 fiber 的 associate 表解析的，在插件上下文里是 undefined。

兼容性

基于 DeepSeek Harness 0.2.x（@deepseek-ai/dsh-）开发。依赖的是已发布的浏览器 wire API ——转发的 api-session/ 事件、session.projections / session.page 两个 Remote 方法，以及 shell.overlay slot。这些接口还在 pre-stable 阶段：Harness 改了其中任何一个，插件都需要跟着发一版。

样式只用公开的 --dsw-alias-* 主题 token 和 --dsh-frame-overlay-top 内边距，所以明暗主题和 Windows 标题栏都是继承来的，没有自己实现一套。

开发

npm test # node --test：通过假的 Client context 跑行为测试
node --check client.js

测试和页面一样通过 window.__ModuleLoader__ 加载 client.js，直接驱动真实的事件处理、 projection 和 page 读取、store 与卡片结构。没有构建步骤，也没有依赖。

许可证

MIT，见 LICENSE。