前言¶

使用 DeepSeek Harness（DSH）做開發時，AI 的思考、權限請求和完成狀態主要出現在 Web UI 中。切到其它應用時，容易錯過狀態變化。

dsh-thinking-notifier 是一個 DSH 插件。它在屏幕右下角顯示一個小型常駐頂部桌面彈窗，即時鏡像 AI 思考狀態，並在請求權限或完成思考時提醒。

這是什麼¶

• 由 6-debug-6 維護的 DSH 插件。
• 許可證：MIT。
• 不需要瀏覽器擴展，彈窗是原生桌面窗口。
• Windows 使用 PowerShell + WPF；macOS/Linux 使用 Python 3 + tkinter。
• 插件會在 DSH 運行期間加載，並啓動本地桌面彈窗進程。

核心功能¶

下面介紹它覆蓋的四種狀態：

1、AI 思考中

• 顯示 DeepSeek 藍色脈衝點、AI 正在思考… 和已耗時。
• 5 秒後自動收起爲右側 25 px 窄邊標籤。
• 可懸停或點擊標籤展開。

2、AI 請求權限

• 顯示琥珀色脈衝點、AI 請求權限 和會話/工具名。
• 播放 system Exclamation 聲音。

3、AI 完成思考

• 顯示綠點、AI 已完成思考。
• 12 秒後自動隱藏。
• 播放 system Asterisk 聲音。

4、空閒

• 隱藏彈窗。

另外，它還有以下行爲：

• 使用 DeepSeek 風格深色調卡片：#1E2235 / #4D6BFE。
• 無邊框、常駐頂部，位於右下角，可在任意應用上方顯示。
• 自動彙總多個會話。
• DSH 運行期間彈窗進程保持存活；狀態端點不可達約 15 秒後退出。

工作方式¶

插件在本地提供狀態端點：

http://127.0.0.1:7389/status

桌面彈窗每秒輪詢 /status，根據狀態渲染卡片、收起爲窄邊標籤，並在權限請求或完成思考時播放系統聲音。

本地狀態服務端口默認是 7389。若端口忙碌，資料說明會嘗試後續 10 個端口。

安裝與啓用¶

資料中給出兩種安裝路徑：本地 checkout 和 npm。npm 命令在 README 中標註爲 once published，發佈狀態未確認。若從本地源碼安裝，先做本地安裝，再啓動 Web UI：

cd dsh-thinking-notifier
dsh plugin --profile web add .
dsh web

如果後續以 npm 包形式提供，資料中給出的命令是：

dsh plugin --profile web add dsh-thinking-notifier
dsh web

卸載：

dsh plugin --profile web remove dsh-thinking-notifier

經過上面的步驟，DSH Web UI 啓動後會加載插件，彈窗進程由插件啓動。

典型用法¶

安裝並啓用後，可以先檢查狀態端點是否可用：

http://127.0.0.1:7389/status

如果需要調整本地狀態服務端口，可以設置環境變量：

DSH_THINKING_NOTIFIER_PORT

默認值爲 7389。

調試日誌寫入以下路徑：

• ~/.dsh/tn-plugin.log
• ~/.dsh/tn-launcher.log
• ~/.dsh/tn-popup-debug.log

如果重啓 dsh web 後彈窗沒有出現，先查這些日誌。

適用場景與注意¶

適合在運行 DSH 時，需要離開當前窗口但仍然關注 AI 狀態的人。它解決的是“狀態只在 Web UI 中可見”的問題。

使用前需要注意：

• 需要 DeepSeek Harness Web UI（dsh web）。
• 需要 Node.js ^22.19.0 || >=24.0.0。
• Windows 需要 Windows 10/11 與 PowerShell 5.1+。
• macOS/Linux 需要 Python 3 與 tkinter。
• 插件會在當前 DSH 進程的權限環境中運行，並啓動本地彈窗進程；安裝前應檢查源碼與許可證。
• 資料中 npm 安裝命令標註 once published，發佈狀態未確認。
• package.json 中 repository、bugs、homepage 使用 YOUR_GITHUB_USERNAME 佔位符，與提供的 GitHub 地址不一致；本文鏈接以資料中給出的地址爲準。

鏈接¶

• 目錄頁：https://www.skillhub.cn/plugins/6-debug-6/dsh-thinking-notifier
• GitHub：https://github.com/6-debug-6/dsh-thinking-notifier

dsh-thinking-notifier 的作用是，把 DSH 的思考、權限請求和完成狀態放到桌面右下角，便於在其它應用上方查看。