前言¶
在 DeepSeek Harness（DSH）里接 QQ，常见做法是单独装 NapCat、手配 OneBot 正向 HTTP/WebSocket、再写一层桥接把消息送进智能体。端口、access_token、WebUI Token 抄错一次就要对着日志排查。社区插件 dsh-napcat-bot（维护者 9178159）把 NapCat 打进插件包，启用后自动监听 6099，并通过 NapCat 官方 WebUI API 打开 OneBot 正向 HTTP 与正向 WS；WS 断线重连、进程异常会拉起。下面介绍它做什么、怎么装、以及识图、语音、随缘主动发言和联网搜索怎么用。
这是什么¶
dsh-napcat-bot 是 DSH 的客户端类插件（package.json 中 dsh.client.platform 为 web），当前 Release 版本 2.8.0，许可证 MIT。它让 AI 通过 QQ 私聊与群聊和真人对话：内置 NapCat（随 .tgz 分发，仓库不含约 111MB 的 vendor/ 二进制），零外部 npm 依赖，可离线运行；OneBot WebSocket 固定为 ws://127.0.0.1:3001（若历史配置误写成 6099，插件会自动纠正并落盘）。
目录页：SkillHub — dsh-napcat-bot
源码与说明：GitHub — 9178159/dsh-napcat-bot
SkillHub 等社区目录与 DeepSeek / 幻方无官方从属关系；安装前请自行阅读源码与许可证，插件以当前 DSH 进程权限运行。
核心功能¶
NapCat 与 OneBot 接入¶
安装并启用插件后，需完全退出 DSH 再启动（服务端 lib/index.js 仅在启动时加载一次）。接口地址、端口、OneBot access_token、WebUI 管理 Token 由插件自动生成并写入，面板路径为 设置 → 集成 → NapCat QQ 机器人；在「NapCat WebUI」标签页扫码登录 QQ 即可，无需手填连接参数。
识图（主模型原生视觉）¶
自 2.4.0 起，识图复用 DSH 已配置的主模型（deepseek-flash / DeepSeek-V4.1-Flash 的 text + image 多模态），不再单独填识图接口与 Key。QQ 图片下载后经 ctx.attachments.saveImage() 以附件引用进对话。
2.7.0 区分两种模式：接梗模式（默认）——只读意图与情绪，不汇报画面；描述模式——命中「描述一下这张图」等词表（见 lib/vision.js 的 DESCRIBE_KEYWORDS）时客观描述画面。面板「识图提示词（默认模式）」只影响接梗；描述模式使用硬编码 DESCRIBE_PROMPT。
智能语音（TTS）¶
支持四种模式：全部转语音、关键词触发、性格随机「想发就发」、以及强制语音指令（如「发个语音说你好」）——在消息底层预处理中抠出朗读文本，绕过 LLM 直接合成；未填 TTS 接口时可用 Windows 自带 SAPI（可在面板关闭或指定音色）。优先级上：强制语音 > 手动搜索 > 自动搜索 > 识图解读 > 普通闲聊。
随缘主动发言¶
2.6.0 起改为随机心情判定：安静后每隔约 20~45 秒做一次判定，无每日/每轮次数上限，发出后进入冷却（默认 180 秒，面板 60~1800 秒）。收到「晚安 / 先不聊了」等告别语会暂停触发，直到用户再发消息。默认仅私聊；AI 配置 → 主动发言 可开群聊，管理 → 规则 可按会话覆盖。
联网搜索（2.8.0）¶
默认走 DSH 自带的 ctx.web.search()（dsh-base 已挂 DeepSeek 原生搜索），一般无需另填搜索 Key；面板也可填 SearXNG 等自定义接口。
| 类型 | 触发条件 | 示例 |
|---|---|---|
| 手动 | 关键词：帮我搜 / 搜一下 / 查一下 / 上网查 / 搜索 | 搜一下今天金价 |
| 自动 | 规则判时效信息、现实实体、带疑但模型拿不准等（默认「不懂自动搜索」开启） | 今天金价多少？ |
纯闲聊、情绪陪伴、玩梗、过短语气词等不会触发；搜索失败时统一兜底文案；无可用搜索后端时跳过搜索、照常闲聊。超时 20 秒，同类查询 10 分钟内缓存。
其它¶
分段流式回复、会话记忆、黑白名单与限流、按群/私聊的规则面板（识图、语音、主动发言、联网策略等）在 README 版本说明中均有描述；日志前缀如 [VISION]、[TTS]、[SEARCH]、[PROACTIVE] 可在面板「消息收发记录」中查看。
安装与启用¶
README 推荐从 GitHub Releases 下载 dsh-napcat-bot-x.y.z.tgz，在 DSH 插件市场使用 「导入本地包」 选择该文件。资料中未提供 dsh plugin add github:… 一类命令，请勿凭插件名拼接安装命令。
1. 打开 https://github.com/9178159/dsh-napcat-bot/releases
2. 下载对应版本的 dsh-napcat-bot-x.y.z.tgz
3. DSH 插件市场 → 导入本地包 → 选中 tgz
4. 启用插件后完全退出 DSH，再重新启动
5. 设置 → 集成 → NapCat QQ 机器人 → NapCat WebUI 扫码登录
源码仓库可改 lib/，但打包可安装 tgz 需自行将 NapCat 解压到 vendor/napcat/ 再打包；日常使用者以 Release 包为准。
典型用法¶
开箱对话：完成安装与扫码后，在已接入的私聊或群（需按规则允许）中直接发文字；机器人按人设与记忆回复。
强制语音（不经过模型推脱）：
发个语音说你好
手动联网搜索：
搜一下今天金价
识图接梗：只发表情包或「你看这个」，默认接梗互动，不会长篇描述画面。
识图描述：发送图并附带明确描述指令，例如：
描述一下这张图
验收思路（来自 README 2.4.0）：发「发个语音说你好」应直接收到 QQ 语音；发表情包时日志可见 [VISION] 原生多模态 · 图 1 张 与 [MODEL] multimodal；无需单独配置识图地址与 Key。
适用场景与注意¶
适合：已在 Windows 上使用 DSH，希望用 QQ 做私聊/群聊智能体入口，且希望 NapCat、OneBot、Token 尽量自动化；需要识图、可选语音、空闲随缘搭话、以及基于 DSH 搜索能力的联网问答。
注意：
- 插件 badge 标明平台为 Windows；内置 TTS 回退依赖 Windows SAPI。
- 每次升级或首次启用后务必完全重启 DSH。
- 主动发言、群聊开关、联网「只手动搜 / 本会话不联网」等敏感行为请在 管理 → 规则 里按会话收紧。
- 联网与模型调用仍受 DSH 主模型与搜索后端配置约束；自动搜索可在面板关闭或开启「自动搜索前模型二次确认」。
结尾¶
dsh-napcat-bot 把 NapCat 与 OneBot 接进 DSH 的安装和运维成本压到「导入包、重启、扫码」几步，并在同一插件里整合了原生视觉识图、强制语音、随缘主动发言与 2.8.0 的联网搜索。进一步版本说明与变更记录见 GitHub README；在社区目录浏览插件信息见 SkillHub 插件页。
