返回目录

dsh-qfish

精选清单收录维护状态: 活跃

hyun20202023-ui/dsh-qfish

DSH-QQ bot 插件(OneBot v11 / NapCat)for DeepSeek Harness:人设、记忆、心情、学习表、联网、看b站,自带网页控制台。

前往 GitHub
$ dsh plugin add qfish

19

星标

2

Fork

JavaScript

语言

NOASSERTION

许可证

2026-11-02

创建于

2026-11-17

最近推送

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`

安装步骤

  1. 01

    `dsh plugin add qfish`(或 `pnpm add git+https://github.com/hyun20202023-ui/dsh-qfish.git`),然后重启 DSH

    $ dsh plugin add qfish

  2. 02

    装 NapCat 并登录 QQ,新建 WebSocket 服务器:端口 3001,消息格式 `array`

  3. 03

    在 DSH → 插件设置 → qfish 里把 `url` 填成 `ws://127.0.0.1:3001`,`consolePort` 保持 `8090`;跑在服务器上时把 `consoleListen` 改成 `0.0.0.0`

  4. 04

    选一种访问方式:白名单(`userAccessMode: allowlist` 配 `userIds`、`groupAccessMode: allowlist` 配 `groupIds`),或全开(两种都设成 `blocklist`、名单留空)

  5. 05

    用 NapCat 界面或控制台「行为参数」里的二维码扫码登录 QQ

  6. 06

    打开控制台 `http://<地址>:8090/?t=<令牌>`——令牌来自配置里的 `consoleToken`,留空时读 `<profile>/onebot-data/console-token.txt`

验证接入成功

  • 控制台状态里 `napcat` 显示为 true
  • 在已启用的群里 @ 它,能收到回复;要测私聊先把 `respondToPrivate` 改成 `true` 并把你的 QQ 号填进 `userIds`
  • DSH 启动日志里有「控制台已启动:http://…」那一行,整行就是带 token 的完整地址

03DSH 适配与能力边界

DSH 适配原生运行时

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 会互相踢。
2026-11-022026-11-14v0.3.31

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。

08数据与来源

  • 作者声明github.comaf03f4cf6981…

    > qfish 是 DeepSeek Harness 的 QQ 插件。用 NapCat / OneBot 接普通 QQ 号,不需要申请官方机器人。

  • 作者声明github.comaf03f4cf6981…

    - **直连 DSH**:模型、会话、工具都走 DSH,中间没有别的层

页面基于项目公开文档、仓库元数据和 DSH Plugins 的结构化解析生成;最后核验于 2026-11-18。发现错误?提交更正。

🏆

最佳 DeepSeek Harness 插件

从全目录挑出的 12 个值得优先安装的插件,覆盖各个分类。

DSH Plugins 是独立的 DeepSeek Harness 插件目录,与 DeepSeek 官方无关,也不代表官方背书。第三方插件未经安全审计,安装前请审查源码。

每周获取最新的 DeepSeek Harness 插件,绝不滥发。