通知与集成

dsh-notify-bark

pc439527/dsh-notify-bark · ★ 4

pc439527精选

Bark 推送通知到 iPhone:回合完成、等待回答、等待授权等事件由 Host 端发送。

许可证
MIT
收录
2026-08-14
维护状态
active
安装方式
github
npm
dsh-notify-bark
查看 manifest 检查详情
manifest 状态
已声明
manifest 路径
package.json#dsh
manifest 检查
2026-08-19
生命周期脚本
未发现

manifest 静态检查只记录声明与安装脚本,不代表兼容性或安全审查。

安装

dsh plugin --profile web add github:pc439527/dsh-notify-bark

GitHub 源码安装:首次需按提示配置 allowBuilds 构建授权后重试

安装与环境配置指引、插件开发教程见 DSH 中文社区文档 ↗

项目说明

原始 README · 正文语言:中文 · 阅读英文 README

目录
  1. 通知事件(9 个开关)
  2. 安装
  3. 配置通知
  4. 安装后提示找不到模块
  5. 安全与隐私
  6. 开发
  7. 结构
  8. 设计要点
  9. 参考与致谢
  10. 许可证

License: MIT · Requires: Node ^22.19 · DSH: 0.2.2-rc.1(内联 client 模块表时代) · Platform: DSH Host + Web 设置页

English · 简体中文

DeepSeek Harness(DSH)的 Bark 推送通知插件:DSH Host 端监听回合结束、等待回答、等待授权等事件,通过 Bark Server 把通知推送到 iPhone。通知完全在 Host 发送,关闭或刷新浏览器不影响推送。运行 Host 的电脑需要保持唤醒,DSH 持续运行且网络可用。

  • Host 半端(src/index.ts + lib/*.js):session/event 监听 + Bark HTTP 发送 + 插件条目自带的 Config schema(volatile 字段经 DSH 0.2 的 ctx.settings 配置文档持久化并热生效)+ barkNotify Typert Remote(随共享 /api 通道提供)。
  • 浏览器半端(src/client/ + lib/client.js):注册 settings.section 插槽,表单经挂载的 barkNotify Remote 命名空间读写 Host 配置;Bark 地址永不下发到浏览器,只显示脱敏状态(已配置:••••••••3F82)。

通知事件(9 个开关)

事件 触发条件 默认 Bark level
✅ 任务完成 turn/end reason completed 开 active
❌ 执行失败 turn/end reason error 开 timeSensitive
🚫 执行被阻塞 turn/end reason blocked 开 timeSensitive
⏹ 已中止 turn/end reason aborted 关 passive
⚠️ Token 达到上限 turn/end reason max-tokens 开 timeSensitive
⏸ 异常中断 turn/end reason interrupted 开 timeSensitive
❓ 等待你的回答 tool/call ask_user_question 开 timeSensitive
🔐 等待你的授权 approval/asked 开 timeSensitive
📋 计划待确认 tool/call exit_plan_mode 关 timeSensitive

标题固定为工作区名(session.header.cwd 最后一级),状态放在 body 第一行;可选附带 AI 最后一段回复、body 长度上限、Bark Group。

安装

从 GitHub 直接安装(仓库内置编译产物,克隆即可用,无需先构建):

dsh plugin --profile web add https://github.com/pc439527/dsh-notify-bark.git

或本地路径:

dsh plugin --profile web add /path/to/dsh-notify-bark

dsh plugin add 会执行 pnpm add(写入依赖 + dsh.profile.bundles),插件包自带的 cordis.patch.yml 插入 bark-notify 行。当前已在运行的 dsh web 通过 Cordis HMR 监听 profile 的 cordis.patch.yml——在用户层追加同一插入行即可热加载,无需重启服务:

# $DSH_HOME/profiles/web/cordis.patch.yml
- insert:
    - id: bark-notify
      name: 'dsh-notify-bark'

浏览器刷新设置页(齿轮 → Bark 通知)即可看到配置表单。

配置通知

  1. 在 iPhone 上安装 Bark,复制基础推送地址(例如 https://api.day.app/你的key)。
  2. 打开 设置 → Bark 通知,启用通知,粘贴地址并保存。已保存的地址仅显示脱敏状态。
  3. 点击 测试推送 确认手机能收到通知,再选择需要的通知事件,调整通知内容和分组。

设置页统一使用面板标题,只显示一次。全部配置项下方提供 Bark 开源仓库 ↗ 链接,点击会在新标签页打开 Bark 开源仓库。

安装后提示找不到模块

旧版依赖声明曾把 Host 运行时必需的 @deepseek-ai/schemastery 和 @deepseek-ai/dsh-typert-protocol 误放在 devDependencies 中,可能导致本地开发正常、别人安装后 Host 导入失败。现已将它们移至 dependencies,由包管理器随插件安装,无需删除 schema 或改写 RPC。

已安装旧 Git 修订的用户需要更新或重新安装包含本修复的修订;仅刷新页面不会补装依赖。如果仍然失败,请保留完整错误日志,并区分 ERR_MODULE_NOT_FOUND(模块解析失败)与 RPC 方法或服务不可用(需要核对宿主接口兼容性)。

安全与隐私

  • 无内置密钥:barkUrl 默认值为空,由每个部署者自行在设置页填写自己的 Bark 地址(https://api.day.app/你的key);本仓库不含任何真实凭据(测试仅用假 key testkey)。
  • 凭据不进浏览器:barkUrl 在 schema 中声明为 role('secret'),Remote 读取只回传脱敏状态(已配置:••••••••3F82),日志只输出 configured: true/false。
  • 配置只存 Host:写入 Host 端 profile 的 DSH 设置文档,不会上传到任何第三方;通知仅发送到你配置的 Bark 地址。
  • 地址栏支持粘贴 curl 示例:可以直接粘贴 Bark 文档里的 curl 示例(如 curl -X GET 'https://api.day.app/KEY/title/body?...')——插件会提取其中的 URL 并还原为基础地址;非 URL 文本会得到明确的错误提示,而不是晦涩的解析失败。

开发

pnpm install              # typescript / @types/node + DSH 0.2 peer 类型(锁文件 pnpm-lock.yaml)
pnpm run typecheck        # 用已安装的 DSH 0.2 包类型检查 Host 半端
pnpm run typecheck:client # 用 DSH 0.2 client 包类型检查浏览器半端源码
pnpm run build            # tsc 编译 Host 半端到 lib/;client bundle 直接维护在 lib/client.js
pnpm test                 # node:test 单元 + 冒烟测试(发送 / 映射 / 默认值 / 去重 / 脱敏 / remote 契约 / client bundle)

结构

dsh-notify-bark/
├── package.json          # dsh.client 声明 + bundle patch 声明 + 仓库元信息
├── pnpm-lock.yaml        # pnpm 锁文件
├── cordis.patch.yml      # 插件行插入
├── LICENSE               # MIT
├── src/
│   ├── index.ts          # Host 入口:Config schema + 事件监听 + Remote 服务
│   ├── bark-service.ts   # Bark HTTP 发送(超时 / 错误分类)
│   ├── event-listener.ts # session/event → 通知意图(去重 / 标题 / 内容)
│   ├── settings-store.ts # 设置模型 / schema / 默认值 / 脱敏
│   ├── remote-contract.ts # 双端共享的 remote 契约:载荷 / 校验 / 描述符
│   ├── bark-remote.ts    # barkNotify Remote 服务(get 脱敏 / set / test)
│   └── client/           # 浏览器半端源码(lib/client.js 为其 bundle 镜像)
├── lib/                  # 部署产物(tsc 编译的 Host + 手写 module-loader bundle)
└── tests/                # node:test 单元测试

设计要点

  • 通知走 Host:ctx.on('session/event') 直接监听(与 dsh-im-bridge 同路径),浏览器只是配置面板。
  • 配置存 Host:DSH 0.2 中插件条目本身就是它的设置命名空间,因此插件导出 Config schema,字段用 volatile()(稳定活引用,不重挂载),写入经 ctx.settings 落盘。插件通过 configure({ auto: false }) 关闭自动生成的配置页,自行维护 settings.section;barkNotify Remote 保持读取脱敏、set 只写不回显。
  • 设置写入带版本栅栏:set 方法从 ctx.settings.describe() 读取条目 revision 并传给 ctx.settings.update(),过期编辑器不会静默覆盖并发修改。
  • 凭据不进浏览器:barkUrl 声明为 role('secret') 且 Remote 只回传脱敏状态(已配置:••••••••3F82);日志只输出 configured: true/false。
  • 事件去重:sessionId + event.seq 键 + 有界台账,重连/重放不会重复推送。
  • 不用自建 RPC 通道:barkNotify 三个方法走标准的 Typert /api 网关(SRC 从活服务推导描述符),而非 connection.rpc.handle 自建通道——那是 DSH 0.2 中跨插件不可用的入口。

参考与致谢

  • 架构模式参考(仅借鉴设计,未复制代码):
    • dsh-im-bridge——session/event 监听路径(DeepSeek 内部插件,未公开);
    • dsh-codex-auth——设置页经专用 RPC 读写 Host 配置的模式(DeepSeek 内部插件,未公开)。
  • 插件运行平台:DeepSeek Harness(MIT)。
  • 推送服务:Bark(开源 iOS 推送服务)——本插件只向用户自行配置的 Bark 地址发送 HTTP 请求,不包含或分发 Bark 代码。

许可证

MIT。按现状提供,无任何明示或暗示的担保;因使用本插件造成的任何损失由使用者自行承担。贡献者提交代码即视为同意以 MIT 许可授权。