前言¶
在使用 DeepSeek Harness (DSH) 進行智能體開發或調試時，經常需要將系統的運行狀態、錯誤日誌或處理結果通過即時通訊工具通知給用戶。直接調用第三方 IM 的 API 開發成本高且存在安全隱患。本插件提供了一套原生工具，允許 DSH 通過本地運行的 NapCat 機器人向 QQ 主號發送私聊消息，同時提供 NapCat 的部署、啓停和狀態檢查能力。
插件簡介¶
該插件由 wodongx123 維護，屬於“聯網工具”類別。它利用本機安裝的 NapCat（QQ 機器人協議端）作爲中轉，實現 DSH 與 QQ 生態的互通。插件內置了 8 個工具，覆蓋了從環境準備到消息發送的全流程。
核心功能¶
插件提供以下功能：
* 全自動部署：下載並引導安裝 NapCat Shell（Windows Node 版）。
* 後臺啓停 NapCat：控制本地 NapCat 進程的運行狀態。
* 檢查 NapCat 在線狀態：確認服務是否可用及當前登錄賬號。
* 向主號發送私聊消息：通過 QQ 發送通知。
* 查看與修改 QQ 配置：讀取和更新配置文件。
* 檢測目錄是否爲 NapCat：驗證指定路徑是否爲合法的 NapCat 安裝目錄。
* 掃描全機 NapCat：自動發現本機所有 NapCat 實例。
安裝與啓用¶
在 DSH 插件目錄下執行以下命令進行本地註冊：
dsh plugin --profile web add file:<本目錄>
插件安裝後需重啓 DSH 才能生效。
前置要求：
* 操作系統：Windows 10/11 x64。
* 賬號準備：需準備一個已登錄的機器人小號（用於掃碼登錄 NapCat），並將該小號添加主號爲好友。
典型用法¶
插件提供的工具可通過自然語言指令調用：
-
部署與啓動
幫我裝好QQ通知：調用qq_deploy，自動下載 NapCat Shell（Windows Node 版）、解壓、修復 Bug（如--no-sandbox、預置 crypto.dll/ssl.dll）並引導登錄。啓動QQ通知/重啓NapCat：調用qq_napcat，在後臺啓停 NapCat。
-
狀態與配置
查一下QQ通道狀態：調用qq_status，返回 NapCat 是否在線及當前登錄賬號。查看當前QQ配置：調用qq_config_show，顯示所有配置項。我的QQ主號改成 xxx：調用qq_config_set，修改mainQq等配置並保存。
-
消息與檢測
用QQ發：xxx：調用qq_send，向主號發送私聊消息。檢測某目錄是不是NapCat：調用qq_detect，檢查指定目錄。掃描全機NapCat：調用qq_find，自動發現所有安裝實例。
配置文件¶
配置文件存儲於插件根目錄的 napcat 文件夾下，文件名爲 qq-notify.config.json。主要配置項包括：
* mainQq：接收通知的主號 QQ（默認爲空，需設置）。
* apiPort：NapCat HTTP API 端口（默認爲 3002）。
* napcatDir：NapCat 部署目錄（默認自動發現）。
* botQq：機器人小號 QQ（可選）。
注意事項¶
- 掃碼登錄：初次部署或狀態未運行時，需通過瀏覽器訪問 NapCat 的 WebUI（如
http://127.0.0.1:6099/webui）進行掃碼登錄。 - API 可達性：如果
qq_send報錯API unreachable，需檢查 NapCat 是否已啓動以及apiPort端口是否被佔用。 - 好友關係：發送消息成功的前提是主號與機器人小號互爲好友。
