dsh-qq-notify —— QQ 通知插件
通过本机 NapCat 机器人向主号 QQ 发送私聊通知。8 个 DSH 工具全流程覆盖：部署、启动、配置、状态检查、消息发送。无需任何网页/外部界面，全部在 DSH 对话内完成。
功能（全部在 DSH 对话中完成）
| 你说 | 工具 | 效果 |
|---|---|---|
帮我装好QQ通知 | qq_deploy | 全自动部署：下载→解压→修复→引导登录 |
启动QQ通知 / 重启NapCat | qq_napcat | 后台启停 NapCat |
查一下QQ通道状态 | qq_status | NapCat 是否在线、登录账号 |
用QQ发：xxx | qq_send | 向主号发送私聊消息 |
查看当前QQ配置 | qq_config_show | 显示所有配置项 |
我的QQ主号改成 xxx | qq_config_set | 修改配置并保存到磁盘 |
检测某目录是不是NapCat | qq_detect | 检查指定目录是否合法 NapCat |
扫描全机NapCat | qq_find | 自动发现所有安装实例 |
全新机器一步到位
在 DSH 里说 帮我装好QQ通知，模型调用内置部署引擎自动完成：
- 从 GitHub 下载最新版 NapCat Shell（Windows Node 版）
- 自动解压安装到自动发现/指定的目录
- 修复已知 bug（--no-sandbox、预置 crypto.dll/ssl.dll）
- 提示扫码登录 WebUI（唯一需要人工的步骤）
登录后即可使用。之后 NapCat 自动快速登录，无需重复扫码。
安装
dsh plugin --profile web add file:<本目录>如果你是从 DSH 应用市场直接下载安装的，插件已完成注册，无需执行上面这条命令，重启 DSH 后即可使用；此命令仅适用于手动拿到源码包/目录、需要本地注册的场景。
重启 DSH 后生效。要求：
- Windows 10/11 x64
- 一个已登录的机器人小号（napcat 扫码使用）
- 机器人已加主号为好友
配置项
| 键 | 默认值 | 说明 |
|---|---|---|
mainQq | 空 | 接收通知的主号 QQ（用 qq_config_set mainQq 设置） |
apiPort | 3002 | NapCat HTTP API 端口 |
napcatDir | 自动发现 | NapCat 部署目录（也可用 qq_find 自动定位） |
botQq | 空 | 机器人小号 QQ（可选） |
配置文件持久化在 <插件根目录>/napcat/qq-notify.config.json。
故障排查
| 现象 | 处理 |
|---|---|
qq_status 显示未运行 | 先 qq_napcat action=start，再用手机 QQ 扫码登录 WebUI（http://127.0.0.1:6099/webui） |
qq_send 报 API unreachable | 确认 NapCat 已启动且 apiPort（默认 3002）未被占用 |
| 发送成功但收不到 | 检查主号是否已配置（qq_config_set mainQq），并确认机器人与主号互为好友 |
| 找不到 NapCat | 用 qq_find 自动扫描，或 qq_config_set napcatDir 手动指定目录 |
