dsh-plugin-attention-chime

在 DeepSeek Harness (DSH) 的開發流程中,agent 經常需要人類介入:回合結束後等待回覆、調用工具提問、或者執行審批操作。一旦你切換了標籤頁或去處理別的事務,這些請求可能會被忽略,agent 便會長時間處於空閒等待狀態。dsh-plugin-attention-chime 解決了這個問題,它通過 macOS 的系統提示音和通知橫幅,把「agent 需要你」變成聽得見、看得見、且可點擊跳轉的信號。

功能說明

這個插件主要提供以下能力:

  • 三類獨立提醒:針對「等待回覆」、「提問」和「審批」三種場景,提供獨立的開關、提示音和音量控制。
  • 系統通知與跳轉:彈出 macOS 系統通知橫幅。如果安裝了 terminal-notifier,點擊通知可以自動激活瀏覽器,並切換到標題匹配該會話的標籤頁。
  • 後臺任務守衛:插件會檢查 agent 是否有後臺任務(job)或正在運行的子代理。只有在 agent 確實空閒時纔會觸發提醒,避免誤報。
  • 升級提醒機制:如果長時間未理會,插件會按設定間隔重複提醒,並自動增加音量(每次 +0.5,上限 3),直到處理或達到最大次數。
  • 靈活配置:支持在設置頁的卡片中直接配置,也支持通過 cordis.patch.yml 進行 profile 補丁覆蓋。

安裝

在終端中執行以下命令進行安裝:

dsh plugin --profile web add github:YuChuanhui3/dsh-plugin-attention-chime

安裝後需要重啓 dsh web 以加載新的插件層。

注意:若想體驗點擊通知跳轉功能,需要先安裝 terminal-notifier。

配置與使用

安裝完成後,可以通過以下方式進行配置或測試。

設置頁配置

在 DSH 的設置界面中找到「插件 -> 可配置 -> 「注意力提醒」」卡片。在此處修改參數後即可生效,配置會持久化到 ~/.dsh/settings.yaml。

Profile 補丁覆蓋

也可以在 profile 的 cordis.patch.yml 中對配置進行覆蓋。需要注意的是,補丁會整行替換 config,因此必須提供完整的配置項。

試聽提示音

在安裝插件前,你可以先測試系統自帶的提示音,確認音效符合預期:

# 試聽回覆等待音效
afplay /System/Library/Sounds/Glass.aiff

# 試聽提問等待音效
afplay /System/Library/Sounds/Funk.aiff

# 試聽審批等待音效
afplay /System/Library/Sounds/Sosumi.aiff

環境與限制

  • 運行環境:插件全本地運行,不依賴任何外部服務,無遙測數據收集。但需要 macOS 環境,並授予系統權限(通知、自動化)。
  • 依賴要求:需要安裝 DeepSeek Harness 的 web profile。
  • 兼容性:兼容 dsh 0.1.2-rc 系列。
  • 標籤頁匹配策略:點擊跳轉時,插件通過標題包含會話名來匹配瀏覽器標籤頁。如果存在多個標題高度相似的標籤頁,可能會聚焦到錯誤的標籤頁。
羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜