前言¶

在 DSH 桌面端裏跑智能體，常見情況是窗口在後臺：一輪迴答結束你看不見，助手在等你回話也聽不見。切到別的應用或最小化窗口時，只能偶爾瞥一眼任務欄才知道狀態變了。下面介紹的工作流插件用系統聲音和 Windows 氣泡，在「說完」「在等你」「有問句等你答」三種情形下給出可區分的反饋，且僅在 Windows 上依賴系統自帶的 WPF 與 NotifyIcon，零 npm 依賴。

這是什麼¶

dsh-chloe-ding（社區目錄：alphaaaaa001/dsh-chloe-ding-pop）是 DSH 桌面端插件，維護者關聯 alphaaaaa001（貢獻者何林霜），作者爲克洛伊（Chloe）。插件定位是：助手說完一輪 → 輕叮；在等你回話 → 更亮的叮；ask_user_question 等你回答 → 再叮並可彈自定義問句氣泡。非 Windows 平臺裝上不會響、也不會報錯。

包版本 1.1.0，許可證 MIT。

核心行爲¶

插件根據 DSH 事件、前臺窗口判定和可選信號文件決定聲音與氣泡，行爲可概括爲下表（資料原文）：

「在等你」不靠猜：默認查看 ~/.dsh/chloe-call.json 是否存在且未超過 signalTtlMs。「是否在看 DSH」通過前臺窗口進程與 DSH 自身比對；比不出來時當作不在前臺（寧可多彈一次，也不漏叫）。

聲音文件隨包分發（assets/done.wav、assets/alert.wav），播放走 PowerShell + WPF MediaPlayer，通知走 NotifyIcon。

安裝與啓用¶

官方方式在 DSH 桌面端內完成，包名爲 dsh-chloe-ding（不要用目錄 slug 或其它名稱代替）：

1. 打開 插件 → 添加插件
2. 填寫包名 dsh-chloe-ding
3. 重啓客戶端

重啓後 bundle 會應用包內 cordis.patch.yml（insert 一行），客戶端設置頁需通過上述標準安裝纔會被掃描到。

開發期若要從本地目錄加載，可把下列片段追加到 profile 的 cordis.patch.yml，並將 name 改爲 file:///…/index.mjs（Windows 上須寫 file:/// 前綴）：

- insert:
    - id: dsh-chloe-ding
      name: 'dsh-chloe-ding'

配置¶

設置頁¶

路徑：設置 → 克洛伊的叮。可改重複間隔（秒）、音量、問句是否也叮、問句氣泡文字、是否彈氣泡、前臺是否仍彈氣泡。寫入 DSH 設置層。

用戶配置文件¶

~/.dsh/chloe-ding.json，修改後約 2 秒內生效，無需重啓。示例：

{ "repeatMs": 60000, "volume": 0.7, "nick": "克洛伊" }

優先級：設置頁 > 用戶配置文件 > patch 裏的 config > 內置默認。

常用鍵包括：doneSound / alertSound / questionSound（可寫絕對路徑如 C:/Users/you/Downloads/ding.mp3）、volume（0~1）、signalFile、signalTtlMs、repeatMs、maxRepeats、notify、quietWhenFocused、nick、dingOnAuto、dingOnQuestion。完整表格見倉庫 README。

「在等你回話」信號文件（可選）¶

Agent 需要你回答時，可寫入 ~/.dsh/chloe-call.json（內容隨意，插件只看存在性與 mtime）；你回覆後刪除該文件。不用此協議時插件仍可工作，只是不會觸發 alert 檔聲音。

寫入與刪除示例：

node -e "require('node:fs').writeFileSync(require('node:os').homedir()+'/.dsh/chloe-call.json','{}')"
node -e "require('node:fs').rmSync(require('node:os').homedir()+'/.dsh/chloe-call.json',{force:true})"

也可在對話裏讓 agent 約定：需要回答時先創建該文件。

典型用法與自測¶

端到端自測三步（README）：

1. 盯着 DSH → 說完：只有輕叮，無氣泡
2. 切到別的窗口，並讓助手依賴信號文件開口：亮叮 + 氣泡
3. 超過 repeatMs 會再響；切回 DSH 後重復停止

本地冒煙與診斷（Windows）：

node test.mjs
node index.mjs --focus
node index.mjs --toast 標題 正文
node index.mjs --ding <聲音文件> [音量]

診斷日誌：%TEMP%\dsh-chloe-ding-debug.log。

適用場景與注意¶

適合：在 Windows 上使用 DSH 桌面端、希望後臺也能聽到/看到助手狀態變化的開發者或日常用戶。

注意：

• 平臺：僅 Windows 有聲音與氣泡；其它系統無效果。
• 權限：插件以當前 DSH 進程權限運行；安裝前請閱讀 GitHub 源碼 與 MIT 許可證。
• 生態：DSH 理念是「一切皆插件」；SkillHub 目錄頁 爲社區站點，與 DeepSeek / 幻方無官方從屬關係。

結尾¶

克洛伊的叮把「說完 / 等你 / 問句」三種狀態拆成可配置的聲音與通知，適合長時間掛着 DSH、窗口不在前臺時使用。目錄與源碼：

• 目錄：https://www.skillhub.cn/plugins/alphaaaaa001/dsh-chloe-ding-pop
• GitHub：https://github.com/alphaaaaa001/dsh-chloe-ding-pop