前言¶

使用 DSH / DeepSeek Harness 做智能體工作時，agent 回合和後臺任務可能持續較久。切換標籤頁或離開頁面後，缺少明確的結束提示，容易錯過完成、失敗或被終止的任務。dsh-task-notify 是一個面向 DSH Web 的輕量插件，用於在 agent 回合結束或後臺任務結束時提供聲音和標籤標題提醒。

這是什麼¶

• 包名：@yangzhe1991/dsh-task-notify
• 維護者：yangzhe1991
• 許可證：MIT
• 定位：DSH Web 插件，在 agent 回合或後臺任務結束時給出提醒

它不替代 DSH 的任務執行邏輯，只在 Web 端補充完成提醒。

核心功能¶

Agent 回合結束提醒¶

噹噹前會話中的 agent 回合結束時，插件會播放合成兩音提示音。成功爲 do -> mi，失敗或終止爲 mi -> do。提示音爲合成聲音，不依賴音頻文件。

後臺任務結束提醒¶

後臺任務進入 completed、failed 或 killed 狀態時，也會觸發提示音。

標籤標題提醒¶

當頁面不是活動標籤時，完成提醒會體現在標籤標題中。切回該標籤頁後，標題會恢復原標題。

避免舊回合誤報¶

切換會話、加載歷史或刷新頁面時，不會因爲舊回合再次提醒。只有在你當前會話中實際完成的回合會觸發提醒。

安裝形態¶

插件作爲 DSH profile bundle 安裝，包含 cordis.patch.yml 配置層和 lib/client.js 瀏覽器端文件。通過 npm registry 安裝時提供預構建產物，安裝時不編譯，也不需要 allowlist。

兼容版本¶

README 聲明兼容 dsh ≥ 0.1.2-alpha.4，並仍通過 legacy 路徑支持 dsh 0.1.0-rc.x。

安裝與啓用¶

先確認已有 DSH 或 DeepSeek Harness 的 dsh CLI。

通過 npm registry 安裝：

dsh plugin --profile web add @yangzhe1991/dsh-task-notify

安裝後重啓 Web GUI，並刷新瀏覽器標籤頁。

如果之前安裝過舊版本，可以更新：

dsh plugin --profile web update @yangzhe1991/dsh-task-notify

如需移除：

dsh plugin --profile web remove @yangzhe1991/dsh-task-notify

首次使用¶

瀏覽器自動播放策略會阻止音頻，直到用戶與頁面交互。首次使用時，在頁面中點擊一次或按一次鍵，即可解鎖後續提示音。標籤標題提醒不受該策略影響。

觸發邊界¶

只有以下情況會觸發提醒：

• agent 在當前會話中完成一個回合
• 後臺任務結束，狀態爲 completed、failed 或 killed

普通 foreground tool call 不觸發提醒。

自定義¶

插件支持調整以下常量：

• SOUND_ENABLED
• TITLE_ENABLED
• ALERT_PREFIX

如需自定義開關、聲音或標題前綴，需要編輯 src/client/index.tsx 並重新構建。

適用場景與注意¶

適合在 DSH Web 中使用 agent 回合、後臺任務，並希望離開頁面後仍能知道任務結束狀態的開發者。

注意：

• 插件會以當前 dsh 進程權限運行，安裝前應檢查源碼和 MIT 許可證
• 瀏覽器未交互前，提示音可能被自動播放策略阻止
• 若通過 git 方式安裝，會觸發構建，並且需要 pnpm-workspace.yaml 中的一次性 allowBuilds；npm registry 安裝不需要

鏈接¶

• 社區目錄：https://www.skillhub.cn/plugins/yangzhe1991/dsh-task-notify
• GitHub：https://github.com/yangzhe1991/dsh-task-notify