Send QQ private-message notifications via a local NapCat bot: qq_send / qq_status / qq_napcat / qq_deploy native tools plus one-click deployment scripts.
Install
# from GitHub (first run asks for allowBuilds approval — follow the hint, retry)
dsh plugin --profile web add github:wodongx123/dsh-qq-notify
Any plugin you install runs third-party code with your own permissions — it can read your files, use your credentials, and reach the network, and tool approvals don’t sandbox it. GitHub-sourced plugins also run build scripts at install time — pnpm blocks those until you allow them, so an install can stop with ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED or ERR_PNPM_IGNORED_BUILDS; dsh prints the exact key to add under allowBuilds in your profile’s pnpm-workspace.yaml, and the install works on the next run. Allowing a build is a trust decision: only install sources you trust, and pin a commit (github:owner/repo#sha).
README
This plugin publishes its README in Chinese only.
通过本机 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 手动指定目录 |
Links
More in this category
xmanrui/dsh-im★ 1779
Connect IM bots to DeepSeek Harness via QR codes or bot credentials (9 channels: Feishu, WeChat, DingTalk, WeCom, QQ, Slack, Telegram, Discord, and WhatsApp).
shaobeichen/dsh-pocket★ 1645
Remote phone access to the DSH Web UI: scan a QR code for LAN or public (cloudflared tunnel) access with real-time sync, a mobile-adaptive layout, and a settings tab.
inclusionAI/Avernet#deepseek-harness-channel-bcn★ 670
Connects DeepSeek Harness to Avernet's Bot Collaboration Network over WebSocket V2, with automatic onboarding, isolated agent sessions, tool-call events, and multi-bot routing tools.
omdsh-dev/dsh-notification★ 88
Desktop notifications for turn completions, with per-outcome controls and keyword rules.
Oscar-Williams/dsh-deepcanary★ 74
Evidence-first attention supervision for DeepSeek Harness with C0–C3 policy, deduplicated Inbox alerts, quiet hours, and redacted outcome records.
omdsh-dev/dsh-lark★ 57
Lark/Feishu bot channel for DeepSeek Harness: each chat drives its own agent, and tool approvals, model questions, and plan reviews return as cards answered by a button or a reply. Switch workspace and model from the chat (`/cd`, `/model`, `/new`), and run several bots that keep separate sessions and can hand turns to each other in one group.
Community comments
Comments are public GitHub Discussions. Loading them connects to GitHub and Giscus; a GitHub account is required to post.