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 倉庫
• 社區目錄