前言¶
在使用 DeepSeek Harness 進行 Agent 開發時，Agent 在執行任務或等待用戶輸入的回合間隙，容易錯過狀態變化。DSH 的插件機制允許開發者擴展客戶端行爲。wenowen/dsh-your-turn 插件通過彈窗和提示音，在回合交接時提醒開發者，並保留未查看的提醒列表。
是什麼¶
該插件由 WenOwen 維護，屬於客戶端插件。它主要解決 Agent 停止運行或等待用戶回答時的狀態同步問題，通過視覺和聽覺雙重提醒，確保開發者不遺漏關鍵回合。
核心功能¶
- 回合結束提醒：Agent 完成任務、出錯或中斷時，彈窗或橫幅提示。彈窗展示會話標題、工作目錄等信息。
- 直接回到會話：在提醒彈窗中點擊「跳到會話」可快速返回。
- 提問時響鈴：Agent 提出新問題等待回答時，僅播放提示音，不彈窗遮擋內容。
- 側欄小喇叭：側邊欄顯示未查看提醒的計數，懸停可查看列表，點擊跳轉。
- 六種合成音色：支持風鈴、輕點、馬林巴、街機、水滴、警示六種由瀏覽器實時合成的音色。
- 同源多標籤協同：在多個標籤頁間協調提醒，一處關閉其他同步關閉，避免重複提醒。
安裝與啓用¶
在已配置 DeepSeek Harness 的環境中運行，將 web 替換爲你實際使用的 profile 名稱（例如 desktop）：
npx @deepseek-ai/dsh plugin --profile web add github:WenOwen/dsh-your-turn
安裝後需要重啓 Harness 並刷新 Web 客戶端。
- 打開 設置 → 輪到你了，選擇提醒形式、音色與音量。
- 點擊 試聽，解鎖當前頁面的聲音播放權限。
- 運行一個 Agent 回合，結束後即可看到交接提醒。
設置說明¶
修改選項和開關後自動應用。
| 設置項 | 默認值 | 說明 |
|---|---|---|
| 提醒形式 | 居中彈窗 | modal 爲彈窗，toast 爲頂部橫幅。 |
| 自動消失 | 5 秒 | 可選擇預設時長或自定義 0–600 秒；0 表示手動關閉。 |
| 播放提示音 | 開啓 | 控制回合交接與提問時的聲音。 |
| 成功響應 | 風鈴 | 正常回合交接使用的音色。 |
| 異常響應 | 警示 | 出錯、中斷或截斷時使用的音色。 |
| 音量 | 70 | 可調整爲 0–100。 |
音色列表：風鈴 (chime)、輕點 (ping)、馬林巴 (marimba)、街機 (arcade)、水滴 (drop)、警示 (alert)。
保存位置：本機頁面保存到 DSH 部署；遠程頁面僅保存到當前瀏覽器。頁面會顯示當前保存位置；只讀或無法提供插件設置的部署可能無法編輯。
適用場景與注意¶
- 環境要求：需要帶 Web 客戶端的 profile，例如
web或desktop。 - 運行狀態：客戶端需要保持打開並連接 Host；關閉頁面後無法繼續觀察回合狀態。
- 聲音播放：聲音受瀏覽器播放權限與系統音量影響。如果沒聲音，請檢查設置中的「播放提示音」是否開啓，並確認音量不爲 0。
- 兼容版本：當前項目對接 DeepSeek Harness
0.2.0-rc.2。
總結¶
該插件通過彈窗和聲音提醒，解決了 Agent 回合交接時的狀態同步問題，適合需要長時間運行 Agent 並在多任務間切換的開發者使用。
