前言¶
用 dsh 的 Web 界面跑 agent 任務，常見的工作流是「發完指令切去幹別的，過一會兒切回來看看跑完沒有」。切早了乾等，切晚了任務已經停在那裏等你輸入。dsh-chime 針對的就是這個場景：當前會話的任務一結束，瀏覽器裏播放一聲叮咚，你不需要盯着頁面等。
DSH 的理念是「一切皆插件」，這類界面上的小增強正適合用插件補齊。下面介紹 dsh-chime 的定位、功能與用法。
這是什麼¶
dsh-chime（GitHub 倉庫 mystery-god/dsh-chime）是面向 DeepSeek Harness Web GUI 的任務完成提示音插件，由 Mystery-God 維護，以 MIT 許可證開源。它在當前會話的 agent 任務結束時播放提示音，並支持音量調節、靜音、內置音效切換和自定義音頻上傳。所有配置集中在 Web 界面的「設置 → 插件 → 任務完成提示音」頁面裏。
它是一個 dsh web 平臺插件（package.json 中 dsh.client.platform 爲 "web"），依賴 dsh-web-ui 的插件生態。
核心功能¶
只在任務真正結束時響鈴¶
插件監聽當前會話的 running → idle 跳變，任務結束瞬間響鈴。切換會話或頁面加載不會誤響。
音量、靜音與內置音效¶
設置頁提供 0–100% 音量滑塊與靜音開關，改動即時持久化。內置四種音效——經典叮咚 / 柔和門鈴 / 清脆提示 / 三連音——全部由 Web Audio 即時合成，不依賴任何音頻文件。此外，package.json 的描述還提到懸浮音量控制（floating volume control）。
自定義音頻¶
內置音效之外，可以上傳本地音頻文件：支持 mp3 / wav / ogg / m4a / aac / flac / webm 格式，單個文件不超過 16MB，保存在 ~/.dsh/chime/audio/，在設置頁可以試聽和刪除。
圖形化設置頁¶
插件在「設置 → 插件」下注冊「任務完成提示音」頁籤，音量、靜音、音效選擇、上傳管理全部圖形化操作。設置頁與完成監聽共享一份內存 store，任何一邊改動另一邊即時同步。
安裝與啓用¶
先安裝插件到 web profile：
dsh plugin --profile web add github:Mystery-God/dsh-chime
也可以不走 CLI，直接修改 profile 的 package.json 依賴與 bundles，再執行 pnpm install。
安裝後重啓 dsh web，打開「設置 → 插件 → 任務完成提示音」：挑一個內置音效，調好音量，需要的話上傳自己的音頻。經過上面的步驟，之後每次當前會話的任務結束，瀏覽器都會響一聲。
工作原理與安全¶
插件分爲兩個半體，沒有構建步驟，lib/ 即發佈產物。README 給出的結構如下：
lib/index.js — host 半體：~/.dsh/chime/settings.json 存儲 + /api/dsh-chime/* 路由（設置讀寫、音頻上傳/播放/刪除）+ agent 公告
lib/client.js — 瀏覽器半體：設置頁（settings.plugins.tab）+ 完成監聽（shell.overlay + useSessions 標準 props）
cordis.patch.yml — bundle patch：把插件行注入 profile 組合
三點值得留意：
1、API 路由帶 loopback + same-origin 圍欄（與 dsh-ssh 一致）。把 dsh web 暴露在局域網時，這些接口不會對外提供服務。
2、host 半體只用 Node 內置模塊，瀏覽器半體只用 React，零運行時依賴。
3、音量、靜音、音效選擇的每次改動都會即時 PUT 到 host，寫入 ~/.dsh/chime/settings.json 持久化。
開發者視角¶
倉庫沒有 TypeScript、沒有打包器：src/ 是手寫源碼，lib/ 是發佈產物，需要提交——dsh 插件市場校驗安裝包時要求入口文件存在。開發時會用到兩個腳本：
node scripts/build.mjs # 把 src/ 複製爲 lib/（無編譯步驟）
node scripts/test.mjs # host 路由冒煙測試（臨時 DSH_HOME）
環境要求來自 package.json：Node ^22.19.0 || >=24.0.0，peerDependencies 爲 react ^18.2.0。
適用場景與注意¶
適合的人羣很明確：在 dsh web GUI 裏跑 agent、同時還要處理別的事情的開發者。任務在後臺執行時，一聲提示音比反覆切窗口確認省事得多。
安裝前建議做兩件事：
1、插件以當前 dsh 進程的權限運行，能訪問 host 的文件系統與 API。安裝前先到 GitHub 過一遍源碼，確認行爲符合預期。
2、確認許可證與你的使用場景兼容。dsh-chime 使用 MIT 許可證，README 的 License 章節有明確說明。
另外提醒：上傳的音頻文件存放在 ~/.dsh/chime/audio/，單個不超過 16MB，不需要的可以在設置頁隨時刪除。
小結¶
dsh-chime 功能很小，但解決的問題每天都會遇到：任務結束的那一刻，你不用再切回頁面確認。項目與目錄條目如下：
- GitHub 倉庫：https://github.com/Mystery-God/dsh-chime
- 社區插件目錄：https://www.skillhub.cn/plugins/Mystery-God/dsh-chime
需要說明的是，skillhub.cn 是獨立的社區目錄，與 DeepSeek、幻方沒有官方從屬關係；插件本身以 MIT 許可證開源在 GitHub 上。
