DSH 插件,用 NapCat / OneBot v11 驱动普通 QQ 号:人设、心情、按人记忆、看图与看 B 站视频、群管理,外加一个需 token 的网页控制台——默认全拒,填了白名单才回消息。
DSH 适配
原生运行时
作者声明
安全审计
未审计
最后核验
2026-11-18
许可证
NOASSERTION
01它能帮你完成什么?
让一个普通 QQ 号带着人设与记忆在群里和私聊里说话
按人设切句的短回复、六种心情,加上按人存的长期记忆与会话摘要,轮换后继续带着走
想让自己的 QQ 号在群里像个人、又不想去申请官方机器人的用户
看懂图片和 B 站视频之后再回话
基于图片内容的回复,或先过一遍视频的字幕、画面、弹幕与热评再聊;看的过程在临时会话里完成,主线只留一条摘要
群里经常丢截图和视频链接、期待真反应而不是「打不开」的成员
守群,并用一个网页看清机器人的状态
词表命中自动撤回并禁言、群管理、提醒,以及一个覆盖会话、记忆、社交、观看记录、配置与日志的控制台
在服务器上常驻机器人、需要管理手段又不想 SSH 翻日志的群主
02如何接入 DeepSeek Harness?
前置条件
- 已经能正常对话的 DeepSeek Harness(配了默认模型)——README 把它列在第一条
- 一个 QQ 小号
- NapCat 或其它 OneBot v11 实现,且开着 WebSocket 服务
- 要做视频逐帧画面,本机 PATH 上需要有 `ffmpeg`
安装步骤
- 01
`dsh plugin add qfish`(或 `pnpm add git+https://github.com/hyun20202023-ui/dsh-qfish.git`),然后重启 DSH
$ dsh plugin add qfish
- 02
装 NapCat 并登录 QQ,新建 WebSocket 服务器:端口 3001,消息格式 `array`
- 03
在 DSH → 插件设置 → qfish 里把 `url` 填成 `ws://127.0.0.1:3001`,`consolePort` 保持 `8090`;跑在服务器上时把 `consoleListen` 改成 `0.0.0.0`
- 04
选一种访问方式:白名单(`userAccessMode: allowlist` 配 `userIds`、`groupAccessMode: allowlist` 配 `groupIds`),或全开(两种都设成 `blocklist`、名单留空)
- 05
用 NapCat 界面或控制台「行为参数」里的二维码扫码登录 QQ
- 06
打开控制台 `http://<地址>:8090/?t=<令牌>`——令牌来自配置里的 `consoleToken`,留空时读 `<profile>/onebot-data/console-token.txt`
验证接入成功
- 控制台状态里 `napcat` 显示为 true
- 在已启用的群里 @ 它,能收到回复;要测私聊先把 `respondToPrivate` 改成 `true` 并把你的 QQ 号填进 `userIds`
- DSH 启动日志里有「控制台已启动:http://…」那一行,整行就是带 token 的完整地址
03DSH 适配与能力边界
DSH 插件包:通过 OneBot v11 WebSocket 连 NapCat,模型、会话与工具全部走 DSH 本身;同一个包还带一个需 token 才能进的网页控制台,以及 DSH 页面右下角的入口按钮。
人设、情绪与语言模仿
一个 markdown 人设文件、群里最近的消息,以及黑话 / 禁词 / 梗表→按语气而不是字数断句的短回复,心情与好感度会影响长短、表情和记忆语气
把心情与好感度状态写进 `mood.json`,黑话表写进 `slang.json` / `slang-normal.json`记忆与会话轮换
每个人在群聊与私聊里的聊天记录→按人存的记忆(满了自动压缩)、轮换后带进新会话的摘要,以及让机器人接得上话的群聊缓存
在 profile 数据目录里写 `memories.json`、`summaries.json` 与 `state.json`私聊轮换时还会压一条记忆,群聊轮换不写群管理
五类词表,外加一个总开关→命中后自动撤回并禁言,另有不禁言档可选
在连着的 QQ 群里撤回消息、禁言成员看图与看 B 站视频
聊天里发来的图片,或 B 站视频链接→基于图片的回复,或基于字幕、画面、弹幕与热评的回复;太长会直说太长
逐帧画面需要 `ffmpeg`,九宫格帧缓存在 `frames/`把观看记录写进 `bili-memory.json` 与 `video-notes.json`网页控制台
带控制台 token 的浏览器请求→一个页面里看会话、记忆、社交、观看记录、配置与日志,并调整回复条数、视频时长等行为参数
在 `consolePort`(默认 8090)上提供 HTTP 服务,绑定到 `consoleListen`DSH 页面右下角的悬浮按钮打开同一个控制台内容工具与运维
模型在对话中发起的请求→搜图、联网搜索与抓正文、B 站卡片、网易云 / QQ 音乐卡片、提醒、跨群发消息,以及 `/dsh` 服务器命令
会往其它群或私聊发消息`/dsh` 会跑运维命令,仅限后台权限
04适合谁?何时不该用?
适合
- 想让自己的 QQ 号在群里像个人、又不想去申请官方机器人的用户
- 群里经常丢截图和视频链接、期待真反应而不是「打不开」的成员
- 在服务器上常驻机器人、需要管理手段又不想 SSH 翻日志的群主
不适合
- 默认全拒:装完不会回复任何人。必须先在配置里填 QQ 用户 / 群白名单,空名单等于全拒;要全开就把两种访问方式都改成 `blocklist` 并留空名单。
- 不能与 `dsh-onebot` 同时安装:两者都会注册 `/onebot/api`,还会争用同一个 NapCat 连接。项目由 `dsh-onebot@1.4.0`(MPL-2.0)二次开发而来,相关代码继续适用 MPL-2.0。
- 控制台需要一个能访问的端口和 token。在服务器上必须把 `consoleListen` 从 `127.0.0.1` 改成 `0.0.0.0`,并放行 8090(NapCat 网页还要 6099);3001 只给本机插件用,不要暴露到公网。
- 协议端可能被风控:qfish 走 OneBot / NapCat 加普通 QQ 号,README 自己的对比表就写了「协议端有风控可能」。同一个 QQ 号也不能两台机器同时登,两个 NapCat 会互相踢。
05兼容性、维护与安全提示
- 默认全拒:装完不会回复任何人。必须先在配置里填 QQ 用户 / 群白名单,空名单等于全拒;要全开就把两种访问方式都改成 `blocklist` 并留空名单。
- 不能与 `dsh-onebot` 同时安装:两者都会注册 `/onebot/api`,还会争用同一个 NapCat 连接。项目由 `dsh-onebot@1.4.0`(MPL-2.0)二次开发而来,相关代码继续适用 MPL-2.0。
- 控制台需要一个能访问的端口和 token。在服务器上必须把 `consoleListen` 从 `127.0.0.1` 改成 `0.0.0.0`,并放行 8090(NapCat 网页还要 6099);3001 只给本机插件用,不要暴露到公网。
- 协议端可能被风控:qfish 走 OneBot / NapCat 加普通 QQ 号,README 自己的对比表就写了「协议端有风控可能」。同一个 QQ 号也不能两台机器同时登,两个 NapCat 会互相踢。
NOASSERTION(README 注明由 dsh-onebot@1.4.0 二次开发,相关代码继续适用 MPL-2.0) · README 分支 main · 最新 release v0.3.31 (2026-11-13)
06常见问题
为什么刚装好它一条消息都不回?
这就是默认状态。qfish 默认全拒,空名单等于谁都不回。把 `userAccessMode` 设成 `allowlist`、`userIds` 填你的 QQ 号,`groupAccessMode` 设成 `allowlist`、`groupIds` 填群号;或者两种都改成 `blocklist` 并留空名单全部放开。私聊还需要把 `respondToPrivate` 改成 `true`。
DSH 之外还要跑什么?
NapCat(或其它 OneBot v11 实现)并开着 WebSocket 服务。本地新建一个端口 3001、消息格式 `array` 的 WebSocket 服务器;服务器上可以用 `mlikiowa/napcat-docker` 镜像,放行 3001 与 6099,再用浏览器打开 `http://<服务器IP>:6099` 扫码登录 QQ。只有要做视频逐帧画面时,才需要 PATH 上有 `ffmpeg`。
QQ 明明在线,但每轮都被判 blocked,怎么办?
DSH 可能把 qfish 的会话标成了「已归档」,归档的会话会被直接拒绝执行,模型一次都不会跑。退出 DSH,编辑 `~/.dsh/storages/workspace.json`,删掉 `archivedSessionIds` 里所有以 `onebot:` 开头的条目,再启动 DSH。如果表现为控制台聊天框不动,多半是 profile 没配默认模型,需要在 `cordis.patch.yml` 里补一个 `agent-default-model` 段。
怎么进网页控制台?
控制台是一个必须带 token 的网页:`http://<地址>:8090/?t=<令牌>`。令牌来自配置里的 `consoleToken`,留空时读 `<profile>/onebot-data/console-token.txt` 里自动生成的值,或者直接用 DSH 启动日志里「控制台已启动:http://…」那一行给出的完整地址。跑在服务器上时要先把 `consoleListen` 改成 `0.0.0.0` 并放行 8090。
能和 dsh-onebot 一起装吗?
不能。qfish 由 `dsh-onebot@1.4.0` 二次开发而来,两者都会注册 `/onebot/api` 并争用同一个 NapCat 连接,一起装会连不上。相关代码继续适用 MPL-2.0。
07相关的 DSH 工作流
dsh-im
作者 xmanrui
通过扫码或机器人凭据把IM机器人接入DeepSeek Harness(支持飞书、微信、钉钉、企业微信、QQ、Slack、Telegram、Discord和WhatsApp)。 Connect IM bots to DeepSeek Harness via QR code or credentials (9 channels).
dsh-aurabot-qq
作者 aureth-labs
让 DeepSeek Harness 里的 AI 以「大肥鱼」住进 QQ:会聊天、发表情、发语音、记事、发空间、刷 B 站、唱歌。功能都是模块,能开关、能自己写,还能从模块市场装更多(SnowLuma / OneBot v11)。
dsh-qqbot
作者 tencent-connect
让 QQ Bot 接入 DeepSeek Harness(dsh)的官方插件
dsh-wechat
作者 xcisxc29
DeepSeek Harness 微信频道
08数据与来源
> qfish 是 DeepSeek Harness 的 QQ 插件。用 NapCat / OneBot 接普通 QQ 号,不需要申请官方机器人。
- **直连 DSH**:模型、会话、工具都走 DSH,中间没有别的层
页面基于项目公开文档、仓库元数据和 DSH Plugins 的结构化解析生成;最后核验于 2026-11-18。发现错误?提交更正。
最佳 DeepSeek Harness 插件
从全目录挑出的 12 个值得优先安装的插件,覆盖各个分类。
