dsh-bark-push 0.1.6 → 0.2.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,34 @@
1
1
  # Changelog
2
2
 
3
+ ## 0.2.1 — 2026-11-17
4
+
5
+ - 静音入口重排,避免与其它通知插件争抢会话行尾的 hover 按钮条:
6
+ - 移除 `sidebar.workspaces.session.row.action` 的铃铛;会话静音改由 `sidebar.workspaces.session.menu.item` slot 承担(见下),行「…」菜单与右键菜单共用,不会重复。
7
+ - 新增 `sidebar.session.row.trailing` 的**不可点**小铃铛标记,仅在该会话被静音时显示,保留状态可见性。
8
+ - 新增 `conversation.session.header.utilities` 的当前会话头部铃铛,提供一键静音/取消静音。
9
+ - 会话菜单项改用 `sidebar.workspaces.session.menu.item` slot,`order: 510`:该 slot 同时渲染进行「…」菜单与右键菜单,且整体位于内置「归档会话」之前,因此稳定排在其它插件项之后、归档之前;不再使用会受其它插件 order 影响的 `contextMenus` 注入。
10
+ - 会话菜单项优先渲染宿主原语 `@deepseek-ai/dsh-client-ui-primitives` 的 `MenuItemButton`,样式/间距/hover 完全跟随宿主;仅当宿主未注入该原语时回退到本地 `bark-menuItem` 样式。
11
+ - 会话菜单项样式按宿主菜单行对齐:`bark-menuItem` 使用 flex、左对齐、`6px 10px` 内边距、16px 图标与 hover 背景;修正先前裸 `<button>` 默认居中、与其它项不一致的问题。
12
+ - 修复设置页会话列表不完整:`/state` 的 catalog 现在返回“已加载会话 ∪ 工作区 sessionIds 中的持久化会话 ∪ 已静音会话”,未加载的会话标为离线;客户端据此为每个会话建立 workspace 映射,工作区静音标记不再依赖先点一次会话静音。
13
+ - 修复客户端首次拉取 `/state` 可能失败导致静音状态/映射空白:启动后按 600ms/1.5s/3s/6s/12s 重试,直到成功。
14
+ - 修复工作区静音对“未登记在 workspace.sessionIds 但位于工作区子目录”的会话不生效:服务端在精确路径匹配失败后按最长工作区路径前缀解析。
15
+ - 工作区静音增加常驻状态提示:客户端缓存 `session → workspace` 映射,会话行尾的铃铛标记现在同时反映“会话静音”和“工作区静音”,tooltip 分别显示「推送通知已静音」/「工作区推送通知已静音」。宿主未提供工作区行装饰 slot,因此标记落在该工作区的会话行上。
16
+ - 工作区菜单项 `order` 由 900 降到 199:宿主的「在文件夹显示/复制目录/打开目录/归档工作区」是一个 order 200 的 provider 组,因此放在 199 可整体位于「归档工作区」上方(无法插进组内,宿主未提供工作区菜单 slot)。
17
+ - 测试同步更新(83 / 83 通过);已用真实 `dsh web` 验证行尾铃铛消失、行「…」菜单静音项唯一、静音后出现行尾标记。
18
+
19
+ ## 0.2.0 — 2026-11-13
20
+
21
+ - 新增「更多推送渠道」:在 Bark 之外可同时启用 Gotify、ntfy、PushDeer、Server酱、PushPlus、额外 Bark 服务器与自定义 Webhook。每条通知并行投递到 Bark 和所有已启用渠道,渠道之间互相隔离,单个渠道失败不影响其他渠道或 DSH。
22
+ - 新增 `lib/channels.js`:数据驱动的渠道注册表 + 通用发送器(复用超时、指数退避重试、错误隔离)。新增渠道类型只需增加一条描述符。
23
+ - 管理页新增渠道卡片:按类型动态渲染参数、启用/停用、删除、**逐渠道测试**;敏感字段(Token/Key/Webhook 地址)只显示“已设置”,留空保存即保持原值。
24
+ - 「更多推送渠道」卡片内置独立的“保存配置”按钮(与上方共用同一保存逻辑);默认「测试推送」只测试内置 Bark(按设备逐条列出成功/失败),额外渠道各自用卡片上的「测试」单独验证,不会一次群发所有渠道;添加/删除/启停渠道会标记“有未保存的更改”。
25
+ - 保存反馈就地化:两张卡片各自的「保存配置」按钮在保存后就地显示“已保存 HH:MM:SS”或“保存失败:…”,滚动到任何位置都能确认;同时仍触发宿主浮层 toast。
26
+ - 配置页视觉与信息架构重塑(按 frontend-design 复盘):页面更名「推送通知」,不再堆叠同款圆角卡片;改为“分区 + 状态优先”的连续面板——顶部轻量健康条,下面依次是「默认渠道 · Bark」(含可折叠高级选项)、「通知规则」(卡片式开关)、「渠道」(每个渠道一行投递通道:状态点 / 类型标签 / 启用 / 参数展开 / 测试 / 删除)、「静音管理」。文案精简、按钮与焦点态统一、数字用等宽;设置导航与静音菜单文案同步为「推送通知」。
27
+ - 交互重构(遵循 DSH 插件最佳实践):管理页 iframe 无法固定底部 toast(宿主会把 iframe 撑到内容全高),改由客户端半注册官方 `shell.overlay` 框架级浮层来显示 toast——它位于顶层文档、盖在所有列之上,滚动到任何位置都可见;测试结果就近显示在触发它的卡片内,页面顶部状态改为轻量状态条。
28
+ - 配置新增 `channels` 数组(最多 20 个),`publicConfig` 对渠道密钥脱敏;新增 `POST /api/bark-push/test-channel` 单渠道测试路由。
29
+ - “恢复默认”保留已配置的 Device Key 与额外渠道,避免误删凭据。
30
+ - 测试:83 / 83 通过(新增 `test/channels.test.js`、默认测试仅 Bark 的回归用例)。
31
+
3
32
  ## 0.1.6 — unreleased
4
33
 
5
34
  - 静音管理的会话条目拆成标题、会话 ID、工作区三行;长 ID 自动换行,消除横向滚动条。
package/README.md CHANGED
@@ -1,11 +1,11 @@
1
1
  # dsh-bark-push
2
2
 
3
- 把 **DeepSeek Harness(DSH)** 的回复、审批请求和用户选择请求推送到 iPhone 的 Bark 插件。
3
+ 把 **DeepSeek Harness(DSH)** 的回复、审批请求和用户选择请求推送到手机:默认使用 iPhone 的 **Bark**,并可同时启用 Gotify、ntfy、PushDeer、Server酱、PushPlus、额外 Bark 服务器或**自定义 Webhook**。
4
4
 
5
5
  - 不修改 DSH 核心代码,只使用 DSH 的事件、服务、HTTP 路由和客户端 Slot。
6
6
  - 支持工作区级、对话级两层静音,状态持久化。
7
- - 通知发送完全异步:Bark 故障不会阻塞对话、工具调用或审批流程。
8
- - 配置页、测试推送、静音管理都在 DSH 的 **Settings → Bark 推送** 中完成。
7
+ - 通知发送完全异步:任一渠道故障不会阻塞对话、工具调用或审批流程。
8
+ - 配置页、测试推送、静音管理都在 DSH 的 **Settings → 推送通知** 中完成。
9
9
 
10
10
  ![Bark 推送设置页(0.1.1,使用本地 mock Bark Server 验证)](docs/settings-0.1.1.png)
11
11
 
@@ -25,6 +25,7 @@
25
25
  | 重启后静音仍有效 | ✅ 已实现、已测试 | `$DSH_HOME/bark-push/state.json`,模式 0600,原子写入 |
26
26
  | Bark 配置界面 | ✅ 已实现、已验证 | Settings 内嵌管理页,支持 Server、Device Key、Group、Icon、Sound、级别、长度、超时、重试、类型开关 |
27
27
  | 测试推送 | ✅ 已实现、已验证 | 设置页按钮;使用本地 Bark 兼容 mock 验证了完整请求载荷 |
28
+ | 更多推送渠道 | ✅ 已实现、已测试 | Gotify、ntfy、PushDeer、Server酱、PushPlus、额外 Bark、自定义 Webhook;与 Bark 并列,任一渠道失败互不影响 |
28
29
  | 点击通知跳转 | ✅ 已验证 | 通过客户端桥接 `?barkSession=<id>` 打开对应会话;DSH 本身没有可寻址的会话 URL |
29
30
  | 通知内直接批准/选择 | — 按设计不提供 | 交互仍由 DSH 负责;Bark 只负责提醒 |
30
31
  | 真实 iPhone 送达 | ✅ 已验证 | 已在真实 iPhone + Bark App 上验证通知可送达;Device Key 仅保存在本机 |
@@ -151,21 +152,14 @@ dsh --profile web
151
152
 
152
153
  ### 4.1 Settings 页面
153
154
 
154
- Settings → **Bark 推送** 提供:
155
+ Settings → **推送通知** 采用“分区 + 状态优先”的布局(不再是嵌套卡片):
155
156
 
156
- - Bark Server URL
157
- - Device Key 掩码列表、追加、清空
158
- - Group / Icon / 普通铃声 / 重要铃声
159
- - 普通级别 / 重要级别
160
- - 总开关、回复 / 批准 / 选择 / 子代理开关
161
- - 回复标题来源、标题前缀、标题最大长度、正文最大长度
162
- - 请求超时、最大重试次数、重试间隔
163
- - 点击通知打开会话
164
- - 公共访问地址(可选)
165
- - **测试推送**
166
- - 工作区/会话静音管理
157
+ - **默认渠道 · Bark**:Bark Server、Device Key(掩码列表 / 追加 / 清空);分组、级别与铃声、标题与长度、网络重试、跳转调试等低使用率项收进可折叠的**「高级选项」**(默认折叠)。
158
+ - **通知规则**:总开关、回复 / 批准 / 选择 / 子代理五个开关,用卡片式开关呈现,每个都有一句说明。
159
+ - **渠道**:每个额外渠道是一行“投递通道”:左侧状态点(绿色=启用 / 空心=停用)、名称与类型标签、启用开关、参数(展开才编辑)、测试、删除;支持 Gotify / ntfy / PushDeer / Server酱 / PushPlus / 额外 Bark / 自定义 Webhook,可逐个添加。
160
+ - **静音管理**:工作区 / 会话两层静音。
167
161
 
168
- 页面只显示 Device Key 的掩码(例如 `TEST••••90`),完整值不会出现在页面、JSON API 或日志中。
162
+ 页面只显示 Device Key 与渠道密钥的掩码(例如 `TEST••••90`),完整值不会出现在页面、JSON API 或日志中。每个分区底部都有「保存全部更改」按钮,保存后**就地显示「已保存 HH:MM:SS」**,不依赖 toast、也不受滚动位置影响。
169
163
 
170
164
  ### 4.2 配置字段
171
165
 
@@ -174,6 +168,7 @@ Settings → **Bark 推送** 提供:
174
168
  | `enabled` | `true` | 总开关 |
175
169
  | `server` | `https://api.day.app` | Bark Server 根地址;可带子路径,末尾 `/push` 会被归一化 |
176
170
  | `deviceKeys` | `[]` | 一个或多个 Device Key;最多 20 个 |
171
+ | `channels` | `[]` | 额外推送渠道数组;见 4.6。每个元素为 `{ id, type, label, enabled, config }`,最多 20 个 |
177
172
  | `group` | `DSH` | Bark 通知分组 |
178
173
  | `icon` | `''` | 图标 URL,可选 |
179
174
  | `soundReply` | `''` | 回复通知铃声,可选;留空用 Bark/系统默认 |
@@ -210,6 +205,7 @@ Settings → **Bark 推送** 提供:
210
205
  ### 4.4 敏感信息
211
206
 
212
207
  - Device Key 优先通过 Settings 页面填写,写入 `state.json`(`0600`)。
208
+ - 额外渠道的 Token / Key / Webhook 地址等敏感字段同样只写入 `state.json`(`0600`),API 与页面只回传“已设置”。
213
209
  - 如果写在 `cordis.patch.yml`,该文件通常对整个 profile 可读;这是部署方的选择。
214
210
  - 日志只输出掩码,例如 `TEST••••90`;错误消息中的 Key 会被替换为 `••••`。
215
211
  - 消息正文不会写入日志。
@@ -231,6 +227,53 @@ Settings → **Bark 推送** 提供:
231
227
 
232
228
  旧版本的 `levelNormal` / `levelImportant` / `soundNormal` / `soundImportant` 仍作为迁移回退读取,但管理页只编辑新的三组独立字段。
233
229
 
230
+ ### 4.6 更多推送渠道
231
+
232
+ Bark 是内置的第一渠道(仍用上面的 `server` / `deviceKeys` 配置)。除此之外,可以在设置页「更多推送渠道」中添加任意数量的额外渠道,每条通知会**同时**投递到 Bark 和所有已启用且已填写完整的渠道。每个渠道独立开关、独立超时与重试;某个渠道失败只影响它自己,不会阻断其他渠道或 DSH 本身。
233
+
234
+ 支持的渠道类型:
235
+
236
+ | 类型 `type` | 名称 | 必要参数 | 可选参数 |
237
+ |---|---|---|---|
238
+ | `gotify` | Gotify(自建) | `server`、`token` | `priority`(0–10,默认 5) |
239
+ | `ntfy` | ntfy | `topic` | `server`(默认 `https://ntfy.sh`)、`token`(Bearer) |
240
+ | `pushdeer` | PushDeer | `pushKey` | `server`(默认 `https://api2.pushdeer.com`) |
241
+ | `serverchan` | Server酱³ | `sendKey` | — |
242
+ | `pushplus` | PushPlus | `token` | — |
243
+ | `bark` | 额外 Bark 服务器 | `deviceKey` | `server`(默认 `https://api.day.app`)、`group`、`level` |
244
+ | `webhook` | 自定义 Webhook | `url` | `method`(POST/PUT/GET)、`contentType`、`headers`、`bodyTemplate` |
245
+
246
+ **自定义 Webhook 模板**占位符:`{{title}}`、`{{body}}`、`{{kind}}`、`{{url}}`。默认请求体为 `{"title":"{{title}}","body":"{{body}}","kind":"{{kind}}","url":"{{url}}"}`;`headers` 接受 JSON 对象字符串(如 `{"Authorization":"Bearer …"}`)。返回 2xx 视为成功。
247
+
248
+ **密钥与隐私**:所有 Token、Key、Webhook 地址等敏感字段只保存在 `state.json`(`0600`),管理页与 `/api` 返回中只显示“已设置”,不会回传明文。编辑时敏感字段留空表示**保持原值**;要清除请删除该渠道或重新填写。
249
+
250
+ **逐渠道测试**:每个渠道卡片上的「测试」按钮会先保存当前配置,再只对该渠道发一条测试通知,结果**就地显示在该渠道卡片内**,便于逐个确认参数是否正确。Bark 卡片里的「测试推送」**只测试内置的 Bark(默认渠道)**,按设备逐条列出成功/失败,不会把额外渠道一起发一遍;要测某个额外渠道就点它卡片上的「测试」。
251
+
252
+ **保存反馈**:Bark 卡与「更多推送渠道」卡各自的「保存配置」按钮在保存后会**就地显示**「已保存 HH:MM:SS」或「保存失败:…」,无需滚动或依赖 toast 也能确认结果;渠道有增删改未保存时会提示「有未保存的更改」。此外所有操作仍会触发宿主浮层 toast。
253
+
254
+ **反馈与布局**:管理页以 iframe 嵌入 Settings,宿主会把 iframe 撑到内容全高,因此页面内的「固定底部 toast」会落在整页最底部而不可见。所以所有操作提示改由客户端半通过 `shell.overlay`(DSH 官方的框架级浮层座位,位于顶层文档、盖在所有列之上)渲染,滚到哪都可见;测试结果则就近显示在触发它的卡片里。页面顶部只保留一条轻量状态条(启用状态 / 设备数 / 渠道数 / 上次结果)。
255
+
256
+ Loader / profile 也可以用 YAML 预置渠道,例如:
257
+
258
+ ```yaml
259
+ channels:
260
+ - id: ch_gotify_home
261
+ type: gotify
262
+ label: 家里的 Gotify
263
+ enabled: true
264
+ config:
265
+ server: https://gotify.example.com
266
+ token: Axxxxxxxx
267
+ priority: "5"
268
+ - id: ch_hook_ci
269
+ type: webhook
270
+ enabled: true
271
+ config:
272
+ url: https://example.com/dsh-hook
273
+ method: POST
274
+ contentType: application/json
275
+ ```
276
+
234
277
  ---
235
278
 
236
279
  ## 5. Bark 配置示例
@@ -288,15 +331,17 @@ curl -X POST 'https://api.day.app/push' \
288
331
 
289
332
  ### 6.1 工作区静音
290
333
 
291
- - 在左侧工作区列表右键点击工作区 → **静音 Bark 通知** / **取消静音 Bark 通知**。
292
- - 或在 Settings → Bark 推送 → **工作区** 列表中勾选。
334
+ - 在左侧工作区列表右键点击工作区 → **静音推送通知** / **取消静音推送通知**。
335
+ - 或在 Settings → 推送通知 → **工作区** 列表中勾选。
336
+ - 工作区被静音后,其下每个会话行都会显示一个**不可点的铃铛标记**(tooltip 为“工作区推送通知已静音”)。宿主没有工作区行的装饰 slot,因此标记落在该工作区的会话行上;工作区静音本来就会抑制这些会话。
293
337
  - 按稳定的 `WorkspaceId` 保存,不受路径重命名影响。
294
338
 
295
339
  ### 6.2 对话静音
296
340
 
297
- - 会话右键菜单 → **静音 Bark 通知** / **取消静音 Bark 通知**。
298
- - 或会话行尾的 🔔/🔕 按钮。
299
- - 或在 Settings → Bark 推送 → **会话** 列表中勾选,支持按标题/ID 过滤。
341
+ - 会话行尾「…」菜单或右键菜单 → **静音推送通知** / **取消静音推送通知**(不再占用行尾 hover 按钮条,避免与其它插件抢位)。
342
+ - 正在打开的会话:顶部工具区有一个铃铛,可快速静音/取消静音当前会话。
343
+ - 被静音的会话行会显示一个**不可点的小铃铛标记**,状态一眼可见。
344
+ - 或在 Settings → 推送通知 → **会话** 列表中勾选,支持按标题/ID 过滤。列表包含当前已加载的会话**以及工作区中已持久化但暂未加载的会话**(离线会话标为“离线”),不会只显示一部分。
300
345
 
301
346
  ### 6.3 优先级与持久化
302
347
 
@@ -341,7 +386,8 @@ curl -X POST 'https://api.day.app/push' \
341
386
  | `POST` | `/api/bark-push/config` | 保存配置;支持 `addDeviceKeys`、`deviceKeys`、`clearDeviceKeys`、`reset` |
342
387
  | `POST` | `/api/bark-push/mute` | `{kind:'workspace'|'session', id, muted}` |
343
388
  | `POST` | `/api/bark-push/toggle` | `{kind, id}` 原子切换 |
344
- | `POST` | `/api/bark-push/test` | 测试推送 |
389
+ | `POST` | `/api/bark-push/test` | 测试推送(Bark + 所有已启用渠道) |
390
+ | `POST` | `/api/bark-push/test-channel` | `{id}` 只测试一个额外渠道 |
345
391
 
346
392
  POST 需要 `x-dsh-bark-action: 1` 和 `content-type: application/json`,作为 DSH Host/Origin 检查之外的第二道同源栅栏。
347
393
 
@@ -419,7 +465,7 @@ cd dsh-bark-push
419
465
  npm test
420
466
  ```
421
467
 
422
- 当前结果:**63 / 63 通过**(Node v24,`node:test`)。
468
+ 当前结果:**83 / 83 通过**(Node v24,`node:test`)。
423
469
 
424
470
  | 验收场景 | 对应测试 |
425
471
  |---|---|
@@ -433,6 +479,7 @@ npm test
433
479
  | Bark 故障不影响 Agent | `notifier.test.js`、`integration.test.js` |
434
480
  | Device Key 不出现在日志/API | `bark.test.js`、`config.test.js`、`integration.test.js` |
435
481
  | 重试与 4xx 行为 | `bark.test.js` |
482
+ | 更多渠道请求构造、密钥掩码、逐渠道测试 | `channels.test.js` |
436
483
  | 客户端 Settings/菜单/深链注册 | `client.test.js` |
437
484
 
438
485
  ### 9.2 真实 DSH 启动验证
@@ -574,6 +621,7 @@ dsh-bark-push/
574
621
  │ ├── events.js # session/event + user-questions waterfall
575
622
  │ ├── notifier.js # 静音、去重、异步投递、测试
576
623
  │ ├── bark.js # Bark POST /push 客户端 + 重试
624
+ │ ├── channels.js # 更多渠道注册表 + 通用发送器
577
625
  │ ├── format.js # Markdown→纯文本、摘要、三种通知
578
626
  │ ├── config.js # 归一化、掩码、endpoint
579
627
  │ ├── state.js # state.json 原子持久化
@@ -591,6 +639,7 @@ dsh-bark-push/
591
639
  ├── format.test.js
592
640
  ├── state.test.js
593
641
  ├── bark.test.js
642
+ ├── channels.test.js
594
643
  ├── events.test.js
595
644
  ├── notifier.test.js
596
645
  ├── http.test.js
package/cordis.patch.yml CHANGED
@@ -14,6 +14,12 @@
14
14
  # Device keys may also be added from the Settings page (recommended:
15
15
  # the state file is mode 0600 and the key never enters this patch).
16
16
  deviceKeys: []
17
+ # Extra delivery channels beyond Bark. Each item is
18
+ # { id, type, label, enabled, config: {...} }
19
+ # where type is one of: gotify | ntfy | pushdeer | serverchan |
20
+ # pushplus | bark | webhook. Prefer adding them from the Settings page,
21
+ # which keeps their tokens in the 0600 state file instead of this patch.
22
+ channels: []
17
23
  group: DSH
18
24
  soundReply: ''
19
25
  soundApproval: ''