前言¶
DeepSeek Harness (DSH) 運行智能體時，開發者可能需要處理其他事務。當智能體長時間運行或處於後臺狀態時，瀏覽器通知往往不可靠，或者容易被忽略。下面介紹一個插件，它通過主機的操作系統進程播放真實的聲音，確保你在看手機或切換虛擬桌面時，依然能感知到智能體回合的結束或阻塞。
插件簡介¶
ruazero/dsh-task-chime 是一個 DSH 插件。它的核心作用是在智能體完成回合或需要人工介入時，播放真實的系統聲音。不同於網頁內的通知，該聲音由主機進程通過 ctx.shell 觸發，因此即便 DSH 窗口最小化或在後臺運行，聲音依然可聞。
核心能力¶
這個插件提供了以下具體能力：
- 兩個觸發時刻：區分“任務完成”和“智能體被阻塞等待輸入”（如審批或提問）。這兩個時刻分別對應不同的聲音和強度。
- 豐富的聲音庫：提供 13 種聲音選擇，包括系統音效、蜂鳴模式以及自定義音頻路徑。
- 四級強度控制：支持 L1（輕量）到 L4（警報）四個強度。L2 播放兩次，L3 包含前奏播放三次，L4 包含上升與下降前奏播放五次。
- 自動升級：任務超過 2 分鐘，強度提升一級；超過 10 分鐘，提升兩級（上限爲 L4）。
- 觸發範圍：可選擇僅對頂級會話（roots）生效，或包含子智能體會話。
- 時長閾值：短回合默認靜音，避免頻繁干擾。
- 防誤觸機制：只有在觀察到
running -> idle轉換時才觸發完成音；阻塞等待輸入時，需在寬限期後仍未解決才觸發。 - 按需觸發工具：暴露
task_chime工具，允許智能體在對話中直接說“ring me”來觸發提示音。
安裝與啓用¶
安裝命令如下：
dsh plugin --profile web add github:ruazero/dsh-task-chime
安裝後需要重啓 DSH（關閉並重新打開 DSH Desktop，或重啓 dsh web 進程）。該插件作爲配置包（bundle）安裝，聲明瞭 dsh.bundle.patch，無需手動編輯合成文件即可自動應用。
配置與模式¶
插件支持兩種運行模式，選擇取決於你對持久性的需求：
- 模式 A（配置包，永久）：通過上述命令安裝。該模式配置持久化，重啓 DSH 後依然有效，並適用於所有會話/項目。配置項寫入
settings.yaml的task-chime命名空間，或通過界面卡片修改。 - 模式 B（動態插件，臨時）：直接運行源碼，不進行安裝。該模式每次重啓都會丟失配置，僅對當前會話生效。它需要審批才能運行，並提供更豐富的控制面板。
典型用法¶
在 settings.yaml 中配置 task-chime：
task-chime:
enabled: true
sound: notify
level: 2
autoEscalate: true
scope: roots
registerTool: true
notifyOnInput: true
智能體可以通過調用 task_chime 工具來主動觸發提示音。例如，你只需說“ring me”，智能體會立即執行該工具，在主機上播放聲音。
注意事項¶
- 聲音來源：聲音由主機進程發出，因此在 DSH 窗口最小化、後臺運行或切換到其他虛擬桌面時依然可聽。
- 模式差異：務必區分模式 A 和模式 B。如果需要長期使用且配置跨會話保存，請使用模式 A。
- 源碼檢查：安裝前建議檢查源碼與許可證（MIT）。
總結¶
這個插件通過操作系統層面的聲音反饋，解決了 DSH 開發者在後臺運行智能體時難以感知狀態變更的問題。配合強度分級、自動升級和按需觸發工具，可以靈活地管理聽覺反饋。
更多詳情請訪問：ruazero/dsh-task-chime
