dsh-session-notice：DSH 会话 Bark 通知插件

前言¶

DeepSeek Harness（DSH）采用插件化架构，开发者常需监控智能体会话的运行状态。dsh-session-notice 是一个联网工具类插件，通过集成 Bark 服务，允许用户在会话界面切换「会通知」状态，并在该会话的轮次停止时自动经 Bark 推送到手机。

插件信息¶

• 名称: dsh-session-notice
• 维护者: Dalcui
• 分类: 联网工具
• 许可: MIT

安装与配置¶

适配 DSH 版本 0.1.5 – 0.2.0-rc.2。

1. 安装：

    dsh plugin --profile web add github:Dalcui/dsh-session-notice

若安装后插件行未自动生效，需重启 web profile：

    launchctl kickstart -k gui/$(id -u)/io.deepseek.dsh-web

2. 配置密钥：
   进入「插件管理」→「已安装」→ 找到 dsh-session-notice → 展开「设置」。

   • Bark 服务器: 默认官方 https://api.day.app，也可使用自建服务器。
   • 设备密钥: 在 Bark App 内查看，仅显示末 4 位。密钥只存 Host 侧，不落浏览器、不进日志。

3. 测试连通：
   点击「测试推送」，系统会依次检查三步：

   1. 服务器可达（GET /ping）
   2. 测试推送送达（POST /push）
   3. 诊断 key 是否已注册（GET /register/<key>，仅在失败时执行）

使用步骤¶

回到任意会话，点击头部状态栏中的铃铛按钮（单色图标，无文字）。该状态为独立且持久化（服务重启后保持）。开启后，该会话每次轮次停止都会触发推送。

行为说明¶

• 正常结束: 推送最后一条文本消息。若文本过长，按「首段 + 末段」摘要，并标注总字数。
• 异常停止: 推送完整的错误内容与必要信息（如 Token 上限、崩溃等）。
• 用户主动停止: 不会触发通知。
• 摘要长度: 默认 200 字，超出按规则摘要。

技术细节与注意事项¶

• 版本兼容:
  • dsh 0.2.0: 插件需在 peerDependencies 声明兼容的 dsh 运行时版本，否则启动时会被跳过。
  • dsh 0.1.7: 配置入口从 settings.plugin.item 迁移到了 plugins.bundle.config。
• 网络传输: 默认使用 directFetch（绕开环境代理劫持），避免因 Node 环境变量导致的推送失败。
• 消息限制: 协议层 JSON ≤ 3900 字节，超时 8 秒且默认不自动重试。
• 折叠 ID: 使用 sha1(sessionId|turn) 前 16 位，用于 APNs 折叠。

参考链接¶

• GitHub 仓库
• 社区目录