dsh-bark-push 0.2.1 → 0.3.0
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 +17 -0
- package/README.md +49 -12
- package/cordis.patch.yml +12 -0
- package/docs/browser-notifications-design.md +691 -0
- package/docs/settings-0.3.0.png +0 -0
- package/lib/browser-notify.js +396 -0
- package/lib/client.js +255 -11
- package/lib/config.js +51 -0
- package/lib/events.js +21 -5
- package/lib/http.js +303 -65
- package/lib/index.js +25 -5
- package/lib/state.js +51 -7
- package/lib/ui.js +864 -185
- package/package.json +6 -4
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,22 @@
|
|
|
1
1
|
# Changelog
|
|
2
2
|
|
|
3
|
+
## 0.3.0 — 2026-11-20
|
|
4
|
+
|
|
5
|
+
- 新增独立的浏览器通知通道:回复完成、需要批准、等待选择三类事件可通过浏览器系统通知提醒;与 Bark/额外渠道的开关、Device Key 和发送队列完全分离。
|
|
6
|
+
- Settings 设为「通知」入口,重构为顶部 Tab + 概览工作区:推送渠道、通知规则、浏览器通知、静音管理各自独立;浏览器通知提供独立总开关、类型开关、前台免打扰、权限状态、测试通知和正文模板。
|
|
7
|
+
- 浏览器通知正文支持模板与占位符:`{status}`、`{session}`、`{summary}`、`{turn}`、`{tool}`、`{reason}`、`{question}`、`{questionCount}`、`{description}`;未知占位符保留,默认模板为 `{status} · {summary}` / `{status} · {tool} · {reason}` / `{status} · {question}`。
|
|
8
|
+
- 新增认证 SSE 路由 `GET /api/bark-push/browser-events`;Host 侧 `BrowserNotifyHub` 负责事件去重、短缓冲和短描述输出,Web 客户端用 EventSource 接收并调用 Notification API。
|
|
9
|
+
- 默认只在 DSH 页面打开且页面未获得焦点/其他会话时提醒;当前会话前台时按 `browserNotifySkipForeground` 跳过。点击通知只打开对应会话,审批仍需在 DSH 原生审批面板完成。
|
|
10
|
+
- 静音策略默认复用现有工作区/会话推送静音;`browserNotifyUsePushMutes=false` 时使用独立的 `browserMutedWorkspaces` / `browserMutedSessions`,设置页提供独立静音管理。
|
|
11
|
+
- 设置页新增保存台账:顶部显示「全部更改已保存 / 有未保存的更改」与上次保存时间,分区和顶部 Tab 显示未保存圆点;支持「放弃更改」和 `Ctrl/⌘+S` 快捷保存。静音切换明确标为即时生效,渠道「测试」提示会先保存当前配置。测试:102 / 102 通过。
|
|
12
|
+
- 修复静音列表中的长会话标题与 Session ID 撑宽设置页:列表列宽、条目和 meta 统一 `min-width: 0`,标题省略、ID 可换行,页面不再出现横向溢出。
|
|
13
|
+
|
|
14
|
+
## 0.2.2 — 2026-11-17
|
|
15
|
+
|
|
16
|
+
- 修复设置页「静音管理」会话列表混入大量未命名/未知会话的问题:catalog 不再枚举 `workspace.sessionIds` 中的全部历史条目,改用 DSH Web 同源的 `sessionController.list()`(冷会话标题来自持久化投影缓存),并以 `sessionQuery` / 实时会话作为降级来源。
|
|
17
|
+
- 会话可见性与 DSH 左侧会话列表保持一致:排除 `origin === "subagent"` 的子代理会话、`blank` 空白新会话,以及默认归档过滤器下的归档会话;置顶会话按置顶顺序优先,其余按最近活跃时间排序。
|
|
18
|
+
- 因静音记录而保留的已归档/不可见会话继续显示并标注,避免静音状态无法清除;设置页会话区新增数量徽标,副标题改用工作区名称而非 UUID。
|
|
19
|
+
|
|
3
20
|
## 0.2.1 — 2026-11-17
|
|
4
21
|
|
|
5
22
|
- 静音入口重排,避免与其它通知插件争抢会话行尾的 hover 按钮条:
|
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
|
-
|
|
10
|
+
当前版本 **0.3.0**:新增独立的浏览器通知通道,并将设置页重构为顶部 Tab 工作区。
|
|
11
|
+
|
|
12
|
+

|
|
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
|
+
- **静音管理**:推送通知与浏览器通知的工作区 / 会话静音;浏览器通知可以选择复用推送静音,或关闭复用后使用独立静音集合。
|
|
156
166
|
|
|
157
|
-
|
|
158
|
-
- **通知规则**:总开关、回复 / 批准 / 选择 / 子代理五个开关,用卡片式开关呈现,每个都有一句说明。
|
|
159
|
-
- **渠道**:每个额外渠道是一行“投递通道”:左侧状态点(绿色=启用 / 空心=停用)、名称与类型标签、启用开关、参数(展开才编辑)、测试、删除;支持 Gotify / ntfy / PushDeer / Server酱 / PushPlus / 额外 Bark / 自定义 Webhook,可逐个添加。
|
|
160
|
-
- **静音管理**:工作区 / 会话两层静音。
|
|
167
|
+
页面顶部有一条**保存台账**:有修改时显示「有未保存的更改」和当前页导航圆点,保存后显示「全部更改已保存」和上次保存时间。可点「保存更改」或按 `Ctrl/⌘+S` 保存,点「放弃」恢复最近保存的配置。静音切换是即时生效,不需要点保存;渠道的「测试」会先保存当前配置。
|
|
161
168
|
|
|
162
|
-
页面只显示 Device Key 与渠道密钥的掩码(例如 `TEST••••90`),完整值不会出现在页面、JSON API
|
|
169
|
+
页面只显示 Device Key 与渠道密钥的掩码(例如 `TEST••••90`),完整值不会出现在页面、JSON API 或日志中。各设置工作区底部保留独立保存按钮,保存后**就地显示「已保存 HH:MM:SS」**,不依赖 toast、也不受滚动位置影响。
|
|
170
|
+
|
|
171
|
+
静音会话列表对长标题和 Session ID 做了省略与换行约束,不会把设置页撑出屏幕。
|
|
163
172
|
|
|
164
173
|
### 4.2 配置字段
|
|
165
174
|
|
|
@@ -191,6 +200,16 @@ 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
|
+
| `browserNotifySkipForeground` | `true` | 当前会话且页面在前台时不提醒 |
|
|
208
|
+
| `browserNotifyUsePushMutes` | `true` | 复用推送通知的工作区/会话静音;关闭后使用独立浏览器静音集合 |
|
|
209
|
+
| `browserNotifyReplyBody` | `{status} · {summary}` | 回复完成正文模板 |
|
|
210
|
+
| `browserNotifyApprovalBody` | `{status} · {tool} · {reason}` | 需要批准正文模板 |
|
|
211
|
+
| `browserNotifyQuestionBody` | `{status} · {question}` | 等待选择正文模板 |
|
|
212
|
+
| `browserNotifyMaxBodyLength` | `200` | 浏览器通知正文最大字符数(32–500) |
|
|
194
213
|
| `stateFile` | 由 `DSH_HOME` 推导 | 仅 Loader 配置:覆盖 `state.json` 路径;管理页不暴露 |
|
|
195
214
|
|
|
196
215
|
### 4.3 优先级
|
|
@@ -274,6 +293,21 @@ channels:
|
|
|
274
293
|
contentType: application/json
|
|
275
294
|
```
|
|
276
295
|
|
|
296
|
+
### 4.7 浏览器通知
|
|
297
|
+
|
|
298
|
+
浏览器通知是独立的 Web Notification 通道,默认关闭,不依赖 Bark Device Key 或任何推送渠道。它只在 DSH 页面打开时工作;页面关闭、浏览器退出或移动端 Safari 页面通知请继续使用 Bark。
|
|
299
|
+
|
|
300
|
+
特点:
|
|
301
|
+
|
|
302
|
+
- **独立控制**:`browserNotifyEnabled` 与 Bark 的 `enabled` 分离,三个类型开关也独立于推送通知规则。
|
|
303
|
+
- **前台免打扰**:默认在“当前会话且页面可见、窗口有焦点”时跳过通知;可关闭该开关。
|
|
304
|
+
- **正文模板**:三个类型分别支持 `{status}`、`{session}`、`{summary}`、`{turn}`、`{tool}`、`{reason}`、`{question}`、`{questionCount}`、`{description}` 占位符;未知占位符原样保留,空模板回退默认值。
|
|
305
|
+
- **短内容**:正文只包含状态和短描述,不发送完整回复正文、工具参数、命令或图片。
|
|
306
|
+
- **静音策略**:默认复用推送通知的工作区/会话静音;关闭 `browserNotifyUsePushMutes` 后使用独立的浏览器静音集合,可在设置页单独管理。
|
|
307
|
+
- **批准限制**:通知内不提供“允许 / 拒绝”按钮;点击通知只打开对应会话,审批仍由 DSH 原生审批面板完成。
|
|
308
|
+
|
|
309
|
+
浏览器通知仅支持页面打开时生效,不包含 Web Push。浏览器权限按浏览器单独授予;配置本身按 DSH profile 共享。
|
|
310
|
+
|
|
277
311
|
---
|
|
278
312
|
|
|
279
313
|
## 5. Bark 配置示例
|
|
@@ -332,7 +366,7 @@ curl -X POST 'https://api.day.app/push' \
|
|
|
332
366
|
### 6.1 工作区静音
|
|
333
367
|
|
|
334
368
|
- 在左侧工作区列表右键点击工作区 → **静音推送通知** / **取消静音推送通知**。
|
|
335
|
-
- 或在 Settings → 推送通知 → **工作区** 列表中勾选。
|
|
369
|
+
- 或在 Settings → 通知 → 推送通知 → **工作区** 列表中勾选。
|
|
336
370
|
- 工作区被静音后,其下每个会话行都会显示一个**不可点的铃铛标记**(tooltip 为“工作区推送通知已静音”)。宿主没有工作区行的装饰 slot,因此标记落在该工作区的会话行上;工作区静音本来就会抑制这些会话。
|
|
337
371
|
- 按稳定的 `WorkspaceId` 保存,不受路径重命名影响。
|
|
338
372
|
|
|
@@ -341,7 +375,7 @@ curl -X POST 'https://api.day.app/push' \
|
|
|
341
375
|
- 会话行尾「…」菜单或右键菜单 → **静音推送通知** / **取消静音推送通知**(不再占用行尾 hover 按钮条,避免与其它插件抢位)。
|
|
342
376
|
- 正在打开的会话:顶部工具区有一个铃铛,可快速静音/取消静音当前会话。
|
|
343
377
|
- 被静音的会话行会显示一个**不可点的小铃铛标记**,状态一眼可见。
|
|
344
|
-
- 或在 Settings → 推送通知 → **会话** 列表中勾选,支持按标题/ID 过滤。列表包含当前已加载的会话**以及工作区中已持久化但暂未加载的会话**(离线会话标为“离线”),不会只显示一部分。
|
|
378
|
+
- 或在 Settings → 通知 → 推送通知 → **会话** 列表中勾选,支持按标题/ID 过滤。列表包含当前已加载的会话**以及工作区中已持久化但暂未加载的会话**(离线会话标为“离线”),不会只显示一部分。
|
|
345
379
|
|
|
346
380
|
### 6.3 优先级与持久化
|
|
347
381
|
|
|
@@ -367,6 +401,8 @@ curl -X POST 'https://api.day.app/push' \
|
|
|
367
401
|
},
|
|
368
402
|
"mutedWorkspaces": ["4f8c1e2a-..."],
|
|
369
403
|
"mutedSessions": ["session-59e92616-..."],
|
|
404
|
+
"browserMutedWorkspaces": [],
|
|
405
|
+
"browserMutedSessions": [],
|
|
370
406
|
"lastTest": {
|
|
371
407
|
"at": "2026-11-12T03:14:51.990Z",
|
|
372
408
|
"ok": true,
|
|
@@ -385,9 +421,10 @@ curl -X POST 'https://api.day.app/push' \
|
|
|
385
421
|
| `GET` | `/api/bark-push/ui` | 管理页 HTML |
|
|
386
422
|
| `POST` | `/api/bark-push/config` | 保存配置;支持 `addDeviceKeys`、`deviceKeys`、`clearDeviceKeys`、`reset` |
|
|
387
423
|
| `POST` | `/api/bark-push/mute` | `{kind:'workspace'|'session', id, muted}` |
|
|
388
|
-
| `POST` | `/api/bark-push/toggle` | `{kind, id}` 原子切换 |
|
|
424
|
+
| `POST` | `/api/bark-push/toggle` | `{kind, id, channel?: 'push'| 'browser'}` 原子切换 |
|
|
389
425
|
| `POST` | `/api/bark-push/test` | 测试推送(Bark + 所有已启用渠道) |
|
|
390
426
|
| `POST` | `/api/bark-push/test-channel` | `{id}` 只测试一个额外渠道 |
|
|
427
|
+
| `GET` | `/api/bark-push/browser-events` | 浏览器通知 SSE 事件流(`text/event-stream`) |
|
|
391
428
|
|
|
392
429
|
POST 需要 `x-dsh-bark-action: 1` 和 `content-type: application/json`,作为 DSH Host/Origin 检查之外的第二道同源栅栏。
|
|
393
430
|
|
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
|