dsh-bark-push 0.2.2 → 0.3.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -1,5 +1,20 @@
1
1
  # Changelog
2
2
 
3
+ ## 0.3.1 — 2026-11-20
4
+
5
+ - 浏览器通知支持按类型设置「通知停留」:回复完成、需要批准、等待选择可分别选择自动消失或常驻;默认保持回复自动消失、审批与选择常驻。自动消失时长由浏览器/系统决定,常驻保留到手动关闭。
6
+
7
+ ## 0.3.0 — 2026-11-20
8
+
9
+ - 新增独立的浏览器通知通道:回复完成、需要批准、等待选择三类事件可通过浏览器系统通知提醒;与 Bark/额外渠道的开关、Device Key 和发送队列完全分离。
10
+ - Settings 设为「通知」入口,重构为顶部 Tab + 概览工作区:推送渠道、通知规则、浏览器通知、静音管理各自独立;浏览器通知提供独立总开关、类型开关、前台免打扰、权限状态、测试通知和正文模板。
11
+ - 浏览器通知正文支持模板与占位符:`{status}`、`{session}`、`{summary}`、`{turn}`、`{tool}`、`{reason}`、`{question}`、`{questionCount}`、`{description}`;未知占位符保留,默认模板为 `{status} · {summary}` / `{status} · {tool} · {reason}` / `{status} · {question}`。
12
+ - 新增认证 SSE 路由 `GET /api/bark-push/browser-events`;Host 侧 `BrowserNotifyHub` 负责事件去重、短缓冲和短描述输出,Web 客户端用 EventSource 接收并调用 Notification API。
13
+ - 默认只在 DSH 页面打开且页面未获得焦点/其他会话时提醒;当前会话前台时按 `browserNotifySkipForeground` 跳过。点击通知只打开对应会话,审批仍需在 DSH 原生审批面板完成。
14
+ - 静音策略默认复用现有工作区/会话推送静音;`browserNotifyUsePushMutes=false` 时使用独立的 `browserMutedWorkspaces` / `browserMutedSessions`,设置页提供独立静音管理。
15
+ - 设置页新增保存台账:顶部显示「全部更改已保存 / 有未保存的更改」与上次保存时间,分区和顶部 Tab 显示未保存圆点;支持「放弃更改」和 `Ctrl/⌘+S` 快捷保存。静音切换明确标为即时生效,渠道「测试」提示会先保存当前配置。测试:102 / 102 通过。
16
+ - 修复静音列表中的长会话标题与 Session ID 撑宽设置页:列表列宽、条目和 meta 统一 `min-width: 0`,标题省略、ID 可换行,页面不再出现横向溢出。
17
+
3
18
  ## 0.2.2 — 2026-11-17
4
19
 
5
20
  - 修复设置页「静音管理」会话列表混入大量未命名/未知会话的问题:catalog 不再枚举 `workspace.sessionIds` 中的全部历史条目,改用 DSH Web 同源的 `sessionController.list()`(冷会话标题来自持久化投影缓存),并以 `sessionQuery` / 实时会话作为降级来源。
package/README.md CHANGED
@@ -1,13 +1,15 @@
1
1
  # dsh-bark-push
2
2
 
3
- 把 **DeepSeek Harness(DSH)** 的回复、审批请求和用户选择请求推送到手机:默认使用 iPhone 的 **Bark**,并可同时启用 Gotify、ntfy、PushDeer、Server酱、PushPlus、额外 Bark 服务器或**自定义 Webhook**。
3
+ 把 **DeepSeek Harness(DSH)** 的回复、审批请求和用户选择请求推送到手机:默认使用 iPhone 的 **Bark**,并可同时启用 Gotify、ntfy、PushDeer、Server酱、PushPlus、额外 Bark 服务器或**自定义 Webhook**。另外提供独立的**浏览器通知**通道,适合桌面端在 DSH 页面打开时接收提醒。
4
4
 
5
5
  - 不修改 DSH 核心代码,只使用 DSH 的事件、服务、HTTP 路由和客户端 Slot。
6
6
  - 支持工作区级、对话级两层静音,状态持久化。
7
7
  - 通知发送完全异步:任一渠道故障不会阻塞对话、工具调用或审批流程。
8
- - 配置页、测试推送、静音管理都在 DSH 的 **Settings → 推送通知** 中完成。
8
+ - 配置页、测试推送、静音管理都在 DSH 的 **Settings → 通知** 中完成;页面使用顶部 Tab,把概览、推送渠道、通知规则、浏览器通知和静音管理分成五个独立工作区。
9
9
 
10
- ![Bark 推送设置页(0.1.1,使用本地 mock Bark Server 验证)](docs/settings-0.1.1.png)
10
+ 当前版本 **0.3.1**:在 0.3.0 浏览器通知与顶部 Tab 设置页基础上,新增按类型设置通知停留。
11
+
12
+ ![Bark Push 通知设置页(0.3.0,概览工作区,使用本地 mock 验证)](docs/settings-0.3.0.png)
11
13
 
12
14
  ---
13
15
 
@@ -16,6 +18,9 @@
16
18
  | 能力 | 状态 | 说明 |
17
19
  |---|---|---|
18
20
  | Agent 正式回复推送 | ✅ 已实现、已测试 | 监听 `session/event` 的 `assistant/message` + `turn/end`,只在 `completed` 回合推送最后一条可见文本 |
21
+ | 浏览器通知(回复 / 批准 / 选择) | ✅ 已实现、已测试 | 独立 SSE 通道 + Notification API;仅页面打开时生效,不依赖 Bark |
22
+ | 浏览器通知正文模板 | ✅ 已实现、已测试 | 三类模板支持 `{status}`、`{tool}`、`{question}` 等占位符;短描述,不发送完整正文 |
23
+ | 浏览器通知静音策略 | ✅ 已实现、已测试 | 默认复用推送静音,可用 `browserNotifyUsePushMutes` 切换独立静音集合 |
19
24
  | 流式输出不重复推送 | ✅ 已实现、已测试 | 不监听 delta;每回合最多一条,按 `sessionId + turn` 去重 |
20
25
  | 需要批准推送 | ✅ 已实现、已测试 | 监听 `approval/asked` 审计事件,标题固定 `需要批准`,使用审批独立级别 |
21
26
  | 等待选择推送 | ✅ 已实现、已测试 | 观察 `user-questions/request` waterfall,通知后调用 `next()`,不影响真正的回答 UI,使用选择独立级别 |
@@ -152,14 +157,18 @@ dsh --profile web
152
157
 
153
158
  ### 4.1 Settings 页面
154
159
 
155
- Settings → **推送通知** 采用“分区 + 状态优先”的布局(不再是嵌套卡片):
160
+ Settings → **通知** 采用顶部 Tab + 工作区的产品化布局。页面先以**概览**说明事件从 DSH 流向 Bark 与浏览器的完整链路,再进入四个设置工作区:
161
+
162
+ - **推送渠道**:Bark Server、Device Key(掩码列表 / 追加 / 清空),以及 Gotify / ntfy / PushDeer / Server酱 / PushPlus / 额外 Bark / 自定义 Webhook;低使用率的 Bark 选项统一收进可折叠的「高级选项」。
163
+ - **通知规则**:总开关、回复 / 批准 / 选择 / 子代理五个开关。
164
+ - **浏览器通知**:独立总开关、回复 / 批准 / 选择类型开关、前台免打扰、权限状态、测试通知和正文模板。
165
+ - **静音管理**:推送通知与浏览器通知的工作区 / 会话静音;浏览器通知可以选择复用推送静音,或关闭复用后使用独立静音集合。
166
+
167
+ 页面顶部有一条**保存台账**:有修改时显示「有未保存的更改」和当前页导航圆点,保存后显示「全部更改已保存」和上次保存时间。可点「保存更改」或按 `Ctrl/⌘+S` 保存,点「放弃」恢复最近保存的配置。静音切换是即时生效,不需要点保存;渠道的「测试」会先保存当前配置。
156
168
 
157
- - **默认渠道 · Bark**:Bark Server、Device Key(掩码列表 / 追加 / 清空);分组、级别与铃声、标题与长度、网络重试、跳转调试等低使用率项收进可折叠的**「高级选项」**(默认折叠)。
158
- - **通知规则**:总开关、回复 / 批准 / 选择 / 子代理五个开关,用卡片式开关呈现,每个都有一句说明。
159
- - **渠道**:每个额外渠道是一行“投递通道”:左侧状态点(绿色=启用 / 空心=停用)、名称与类型标签、启用开关、参数(展开才编辑)、测试、删除;支持 Gotify / ntfy / PushDeer / Server酱 / PushPlus / 额外 Bark / 自定义 Webhook,可逐个添加。
160
- - **静音管理**:工作区 / 会话两层静音;会话列表与 DSH 左侧会话列表使用同一套可见性规则(隐藏子代理、空白新会话与已归档会话),失效但仍有静音记录的会话会保留以便取消。
169
+ 页面只显示 Device Key 与渠道密钥的掩码(例如 `TEST••••90`),完整值不会出现在页面、JSON API 或日志中。各设置工作区底部保留独立保存按钮,保存后**就地显示「已保存 HH:MM:SS」**,不依赖 toast、也不受滚动位置影响。
161
170
 
162
- 页面只显示 Device Key 与渠道密钥的掩码(例如 `TEST••••90`),完整值不会出现在页面、JSON API 或日志中。每个分区底部都有「保存全部更改」按钮,保存后**就地显示「已保存 HH:MM:SS」**,不依赖 toast、也不受滚动位置影响。
171
+ 静音会话列表对长标题和 Session ID 做了省略与换行约束,不会把设置页撑出屏幕。
163
172
 
164
173
  ### 4.2 配置字段
165
174
 
@@ -191,6 +200,19 @@ Settings → **推送通知** 采用“分区 + 状态优先”的布局(不
191
200
  | `linkToSession` | `true` | 生成 `?barkSession=` 点击链接 |
192
201
  | `publicBaseUrl` | `''` | 覆盖 advertised URL;留空时自动使用 `ctx.webApp.getAdvertisedUrl()` |
193
202
  | `trace` | `false` | 保留字段;默认不输出消息内容 |
203
+ | `browserNotifyEnabled` | `false` | 浏览器通知总开关;与 Bark 的 `enabled` 独立 |
204
+ | `browserNotifyOnReply` | `true` | 浏览器通知:回复完成 |
205
+ | `browserNotifyOnApproval` | `true` | 浏览器通知:需要批准 |
206
+ | `browserNotifyOnQuestion` | `true` | 浏览器通知:等待选择 |
207
+ | `browserNotifyReplyPersistent` | `false` | 回复通知常驻;关闭时自动消失 |
208
+ | `browserNotifyApprovalPersistent` | `true` | 批准通知常驻;关闭时自动消失 |
209
+ | `browserNotifyQuestionPersistent` | `true` | 选择通知常驻;关闭时自动消失 |
210
+ | `browserNotifySkipForeground` | `true` | 当前会话且页面在前台时不提醒 |
211
+ | `browserNotifyUsePushMutes` | `true` | 复用推送通知的工作区/会话静音;关闭后使用独立浏览器静音集合 |
212
+ | `browserNotifyReplyBody` | `{status} · {summary}` | 回复完成正文模板 |
213
+ | `browserNotifyApprovalBody` | `{status} · {tool} · {reason}` | 需要批准正文模板 |
214
+ | `browserNotifyQuestionBody` | `{status} · {question}` | 等待选择正文模板 |
215
+ | `browserNotifyMaxBodyLength` | `200` | 浏览器通知正文最大字符数(32–500) |
194
216
  | `stateFile` | 由 `DSH_HOME` 推导 | 仅 Loader 配置:覆盖 `state.json` 路径;管理页不暴露 |
195
217
 
196
218
  ### 4.3 优先级
@@ -274,6 +296,24 @@ channels:
274
296
  contentType: application/json
275
297
  ```
276
298
 
299
+ ### 4.7 浏览器通知
300
+
301
+ 浏览器通知是独立的 Web Notification 通道,默认关闭,不依赖 Bark Device Key 或任何推送渠道。它只在 DSH 页面打开时工作;页面关闭、浏览器退出或移动端 Safari 页面通知请继续使用 Bark。
302
+
303
+ ![浏览器通知停留设置](docs/settings-browser-persistence.png)
304
+
305
+ 特点:
306
+
307
+ - **独立控制**:`browserNotifyEnabled` 与 Bark 的 `enabled` 分离,三个类型开关也独立于推送通知规则。
308
+ - **前台免打扰**:默认在“当前会话且页面可见、窗口有焦点”时跳过通知;可关闭该开关。
309
+ - **通知停留**:回复完成、需要批准、等待选择三类通知可分别选择「自动消失」或「常驻」;自动消失的具体时长由浏览器和操作系统决定,常驻会保留到手动关闭(部分平台仍可能按系统通知策略收起)。
310
+ - **正文模板**:三个类型分别支持 `{status}`、`{session}`、`{summary}`、`{turn}`、`{tool}`、`{reason}`、`{question}`、`{questionCount}`、`{description}` 占位符;未知占位符原样保留,空模板回退默认值。
311
+ - **短内容**:正文只包含状态和短描述,不发送完整回复正文、工具参数、命令或图片。
312
+ - **静音策略**:默认复用推送通知的工作区/会话静音;关闭 `browserNotifyUsePushMutes` 后使用独立的浏览器静音集合,可在设置页单独管理。
313
+ - **批准限制**:通知内不提供“允许 / 拒绝”按钮;点击通知只打开对应会话,审批仍由 DSH 原生审批面板完成。
314
+
315
+ 浏览器通知仅支持页面打开时生效,不包含 Web Push。浏览器权限按浏览器单独授予;配置本身按 DSH profile 共享。
316
+
277
317
  ---
278
318
 
279
319
  ## 5. Bark 配置示例
@@ -332,7 +372,7 @@ curl -X POST 'https://api.day.app/push' \
332
372
  ### 6.1 工作区静音
333
373
 
334
374
  - 在左侧工作区列表右键点击工作区 → **静音推送通知** / **取消静音推送通知**。
335
- - 或在 Settings → 推送通知 → **工作区** 列表中勾选。
375
+ - 或在 Settings → 通知 → 推送通知 → **工作区** 列表中勾选。
336
376
  - 工作区被静音后,其下每个会话行都会显示一个**不可点的铃铛标记**(tooltip 为“工作区推送通知已静音”)。宿主没有工作区行的装饰 slot,因此标记落在该工作区的会话行上;工作区静音本来就会抑制这些会话。
337
377
  - 按稳定的 `WorkspaceId` 保存,不受路径重命名影响。
338
378
 
@@ -341,7 +381,7 @@ curl -X POST 'https://api.day.app/push' \
341
381
  - 会话行尾「…」菜单或右键菜单 → **静音推送通知** / **取消静音推送通知**(不再占用行尾 hover 按钮条,避免与其它插件抢位)。
342
382
  - 正在打开的会话:顶部工具区有一个铃铛,可快速静音/取消静音当前会话。
343
383
  - 被静音的会话行会显示一个**不可点的小铃铛标记**,状态一眼可见。
344
- - 或在 Settings → 推送通知 → **会话** 列表中勾选,支持按标题/ID 过滤。列表包含当前已加载的会话**以及工作区中已持久化但暂未加载的会话**(离线会话标为“离线”),不会只显示一部分。
384
+ - 或在 Settings → 通知 → 推送通知 → **会话** 列表中勾选,支持按标题/ID 过滤。列表包含当前已加载的会话**以及工作区中已持久化但暂未加载的会话**(离线会话标为“离线”),不会只显示一部分。
345
385
 
346
386
  ### 6.3 优先级与持久化
347
387
 
@@ -367,6 +407,8 @@ curl -X POST 'https://api.day.app/push' \
367
407
  },
368
408
  "mutedWorkspaces": ["4f8c1e2a-..."],
369
409
  "mutedSessions": ["session-59e92616-..."],
410
+ "browserMutedWorkspaces": [],
411
+ "browserMutedSessions": [],
370
412
  "lastTest": {
371
413
  "at": "2026-11-12T03:14:51.990Z",
372
414
  "ok": true,
@@ -385,9 +427,10 @@ curl -X POST 'https://api.day.app/push' \
385
427
  | `GET` | `/api/bark-push/ui` | 管理页 HTML |
386
428
  | `POST` | `/api/bark-push/config` | 保存配置;支持 `addDeviceKeys`、`deviceKeys`、`clearDeviceKeys`、`reset` |
387
429
  | `POST` | `/api/bark-push/mute` | `{kind:'workspace'|'session', id, muted}` |
388
- | `POST` | `/api/bark-push/toggle` | `{kind, id}` 原子切换 |
430
+ | `POST` | `/api/bark-push/toggle` | `{kind, id, channel?: 'push'| 'browser'}` 原子切换 |
389
431
  | `POST` | `/api/bark-push/test` | 测试推送(Bark + 所有已启用渠道) |
390
432
  | `POST` | `/api/bark-push/test-channel` | `{id}` 只测试一个额外渠道 |
433
+ | `GET` | `/api/bark-push/browser-events` | 浏览器通知 SSE 事件流(`text/event-stream`) |
391
434
 
392
435
  POST 需要 `x-dsh-bark-action: 1` 和 `content-type: application/json`,作为 DSH Host/Origin 检查之外的第二道同源栅栏。
393
436
 
package/cordis.patch.yml CHANGED
@@ -41,3 +41,15 @@
41
41
  retryDelayMs: 500
42
42
  linkToSession: true
43
43
  publicBaseUrl: ''
44
+ # Independent browser notification channel. It is off by default and
45
+ # does not depend on Bark keys or channels.
46
+ browserNotifyEnabled: false
47
+ browserNotifyOnReply: true
48
+ browserNotifyOnApproval: true
49
+ browserNotifyOnQuestion: true
50
+ browserNotifySkipForeground: true
51
+ browserNotifyUsePushMutes: true
52
+ browserNotifyReplyBody: '{status} · {summary}'
53
+ browserNotifyApprovalBody: '{status} · {tool} · {reason}'
54
+ browserNotifyQuestionBody: '{status} · {question}'
55
+ browserNotifyMaxBodyLength: 200