dsh-bark-push 0.1.6 → 0.2.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 +13 -0
- package/README.md +65 -18
- package/cordis.patch.yml +6 -0
- package/lib/channels.js +528 -0
- package/lib/client.js +127 -15
- package/lib/config.js +106 -1
- package/lib/http.js +70 -0
- package/lib/index.js +20 -5
- package/lib/notifier.js +76 -23
- package/lib/ui.js +627 -155
- package/package.json +8 -2
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,18 @@
|
|
|
1
1
|
# Changelog
|
|
2
2
|
|
|
3
|
+
## 0.2.0 — 2026-11-13
|
|
4
|
+
|
|
5
|
+
- 新增「更多推送渠道」:在 Bark 之外可同时启用 Gotify、ntfy、PushDeer、Server酱、PushPlus、额外 Bark 服务器与自定义 Webhook。每条通知并行投递到 Bark 和所有已启用渠道,渠道之间互相隔离,单个渠道失败不影响其他渠道或 DSH。
|
|
6
|
+
- 新增 `lib/channels.js`:数据驱动的渠道注册表 + 通用发送器(复用超时、指数退避重试、错误隔离)。新增渠道类型只需增加一条描述符。
|
|
7
|
+
- 管理页新增渠道卡片:按类型动态渲染参数、启用/停用、删除、**逐渠道测试**;敏感字段(Token/Key/Webhook 地址)只显示“已设置”,留空保存即保持原值。
|
|
8
|
+
- 「更多推送渠道」卡片内置独立的“保存配置”按钮(与上方共用同一保存逻辑);默认「测试推送」只测试内置 Bark(按设备逐条列出成功/失败),额外渠道各自用卡片上的「测试」单独验证,不会一次群发所有渠道;添加/删除/启停渠道会标记“有未保存的更改”。
|
|
9
|
+
- 保存反馈就地化:两张卡片各自的「保存配置」按钮在保存后就地显示“已保存 HH:MM:SS”或“保存失败:…”,滚动到任何位置都能确认;同时仍触发宿主浮层 toast。
|
|
10
|
+
- 配置页视觉与信息架构重塑(按 frontend-design 复盘):页面更名「推送通知」,不再堆叠同款圆角卡片;改为“分区 + 状态优先”的连续面板——顶部轻量健康条,下面依次是「默认渠道 · Bark」(含可折叠高级选项)、「通知规则」(卡片式开关)、「渠道」(每个渠道一行投递通道:状态点 / 类型标签 / 启用 / 参数展开 / 测试 / 删除)、「静音管理」。文案精简、按钮与焦点态统一、数字用等宽;设置导航与静音菜单文案同步为「推送通知」。
|
|
11
|
+
- 交互重构(遵循 DSH 插件最佳实践):管理页 iframe 无法固定底部 toast(宿主会把 iframe 撑到内容全高),改由客户端半注册官方 `shell.overlay` 框架级浮层来显示 toast——它位于顶层文档、盖在所有列之上,滚动到任何位置都可见;测试结果就近显示在触发它的卡片内,页面顶部状态改为轻量状态条。
|
|
12
|
+
- 配置新增 `channels` 数组(最多 20 个),`publicConfig` 对渠道密钥脱敏;新增 `POST /api/bark-push/test-channel` 单渠道测试路由。
|
|
13
|
+
- “恢复默认”保留已配置的 Device Key 与额外渠道,避免误删凭据。
|
|
14
|
+
- 测试:77 / 77 通过(新增 `test/channels.test.js`、默认测试仅 Bark 的回归用例)。
|
|
15
|
+
|
|
3
16
|
## 0.1.6 — unreleased
|
|
4
17
|
|
|
5
18
|
- 静音管理的会话条目拆成标题、会话 ID、工作区三行;长 ID 自动换行,消除横向滚动条。
|
package/README.md
CHANGED
|
@@ -1,11 +1,11 @@
|
|
|
1
1
|
# dsh-bark-push
|
|
2
2
|
|
|
3
|
-
把 **DeepSeek Harness(DSH)**
|
|
3
|
+
把 **DeepSeek Harness(DSH)** 的回复、审批请求和用户选择请求推送到手机:默认使用 iPhone 的 **Bark**,并可同时启用 Gotify、ntfy、PushDeer、Server酱、PushPlus、额外 Bark 服务器或**自定义 Webhook**。
|
|
4
4
|
|
|
5
5
|
- 不修改 DSH 核心代码,只使用 DSH 的事件、服务、HTTP 路由和客户端 Slot。
|
|
6
6
|
- 支持工作区级、对话级两层静音,状态持久化。
|
|
7
|
-
-
|
|
8
|
-
- 配置页、测试推送、静音管理都在 DSH 的 **Settings →
|
|
7
|
+
- 通知发送完全异步:任一渠道故障不会阻塞对话、工具调用或审批流程。
|
|
8
|
+
- 配置页、测试推送、静音管理都在 DSH 的 **Settings → 推送通知** 中完成。
|
|
9
9
|
|
|
10
10
|

|
|
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 →
|
|
155
|
+
Settings → **推送通知** 采用“分区 + 状态优先”的布局(不再是嵌套卡片):
|
|
155
156
|
|
|
156
|
-
- Bark Server
|
|
157
|
-
-
|
|
158
|
-
-
|
|
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
|
|
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 配置示例
|
|
@@ -341,7 +384,8 @@ curl -X POST 'https://api.day.app/push' \
|
|
|
341
384
|
| `POST` | `/api/bark-push/config` | 保存配置;支持 `addDeviceKeys`、`deviceKeys`、`clearDeviceKeys`、`reset` |
|
|
342
385
|
| `POST` | `/api/bark-push/mute` | `{kind:'workspace'|'session', id, muted}` |
|
|
343
386
|
| `POST` | `/api/bark-push/toggle` | `{kind, id}` 原子切换 |
|
|
344
|
-
| `POST` | `/api/bark-push/test` |
|
|
387
|
+
| `POST` | `/api/bark-push/test` | 测试推送(Bark + 所有已启用渠道) |
|
|
388
|
+
| `POST` | `/api/bark-push/test-channel` | `{id}` 只测试一个额外渠道 |
|
|
345
389
|
|
|
346
390
|
POST 需要 `x-dsh-bark-action: 1` 和 `content-type: application/json`,作为 DSH Host/Origin 检查之外的第二道同源栅栏。
|
|
347
391
|
|
|
@@ -419,7 +463,7 @@ cd dsh-bark-push
|
|
|
419
463
|
npm test
|
|
420
464
|
```
|
|
421
465
|
|
|
422
|
-
当前结果:**
|
|
466
|
+
当前结果:**77 / 77 通过**(Node v24,`node:test`)。
|
|
423
467
|
|
|
424
468
|
| 验收场景 | 对应测试 |
|
|
425
469
|
|---|---|
|
|
@@ -433,6 +477,7 @@ npm test
|
|
|
433
477
|
| Bark 故障不影响 Agent | `notifier.test.js`、`integration.test.js` |
|
|
434
478
|
| Device Key 不出现在日志/API | `bark.test.js`、`config.test.js`、`integration.test.js` |
|
|
435
479
|
| 重试与 4xx 行为 | `bark.test.js` |
|
|
480
|
+
| 更多渠道请求构造、密钥掩码、逐渠道测试 | `channels.test.js` |
|
|
436
481
|
| 客户端 Settings/菜单/深链注册 | `client.test.js` |
|
|
437
482
|
|
|
438
483
|
### 9.2 真实 DSH 启动验证
|
|
@@ -574,6 +619,7 @@ dsh-bark-push/
|
|
|
574
619
|
│ ├── events.js # session/event + user-questions waterfall
|
|
575
620
|
│ ├── notifier.js # 静音、去重、异步投递、测试
|
|
576
621
|
│ ├── bark.js # Bark POST /push 客户端 + 重试
|
|
622
|
+
│ ├── channels.js # 更多渠道注册表 + 通用发送器
|
|
577
623
|
│ ├── format.js # Markdown→纯文本、摘要、三种通知
|
|
578
624
|
│ ├── config.js # 归一化、掩码、endpoint
|
|
579
625
|
│ ├── state.js # state.json 原子持久化
|
|
@@ -591,6 +637,7 @@ dsh-bark-push/
|
|
|
591
637
|
├── format.test.js
|
|
592
638
|
├── state.test.js
|
|
593
639
|
├── bark.test.js
|
|
640
|
+
├── channels.test.js
|
|
594
641
|
├── events.test.js
|
|
595
642
|
├── notifier.test.js
|
|
596
643
|
├── 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: ''
|