dsh-qfish

qfish 🐳

让 DeepSeek Harness 直接接管 QQ

一条灵活、自主、有点脾气的大肥鱼

dsh plugin add qfish

📖 [使用手册](docs/USER-GUIDE.md)：机制、配置、行为参数、排障

---

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

>

> - 拟人：人设、记忆、切句、黑话，说话按人来

> - 高集成：机器人、控制台、右下角入口、默认配置，一个包全在里面

> - 直连 DSH：模型、会话、工具都走 DSH，中间没有别的层

> - 服务器可用：Linux 上配好 NapCat 和端口就能常驻

---

目录

• [它是什么](#它是什么)
• [快速开始](#快速开始)
• [功能模块](#功能模块)
• [默认值](#默认值)
• [它记在哪](#它记在哪)
• [使用手册](docs/USER-GUIDE.md)
• [常见问题](#常见问题)

---

🐟 它是什么

| 陪伴 | 说话 | 眼睛 | 手脚 |

|:---:|:---:|:---:|:---:|

| 群聊收敛，私聊放开同一份人设和记忆 | 短句、按人设、有情绪不套客服腔 | 看图、看视频字幕画面弹幕一起过 | 搜图、联网、音乐卡片提醒、群管理、运维 |

💬 聊天与陪伴

群聊里它不抢话，私聊里它话多一点。同一条鱼，两种状态。

🗣️ 尽量像人地说话

短句为主，不写小作文；按人设说话，有情绪和好感度，态度会变。

👂 会学人说话

听多了会学群里人的口头禅和句式，合适的时候用一次，不是每句都套。

群里的黑话它看得懂：骂人的一张表，被骂时用来还回去；普通的另一张，只为了听懂，可以随便用。

✂️ 切句和语气

一条话说完就停，不凑长篇。要分几条发时按语气断，不按字数均分。

短句、语气词、哪里停顿，都按口语来，不写成书面文章。

🎭 判断交给人设

什么该回、该说什么、要不要装作没看见，没有写死的规则表；人设文件决定它的性格和反应方式，模型按场合判断。

同一句话，换个性格就是另一种反应。

🖼️ 图片和视频

发图能看图说话；发 B 站视频会把字幕、画面、弹幕、热评都过一遍，看完再聊。太长会直接说太长，不装看过。看和回都在临时会话里完成，主线只留一条摘要，后面几轮不会一直背着整段视频材料。

🧰 工具

搜图、联网、音乐卡片、提醒、群管理、跨群发消息、跑服务器命令（仅后台权限）。

🖥️ 一个控制台

会话、记忆、社交、观看记录、配置、日志，全在一个网页里。

💰 花费可控

聊久了会自动轮换上下文，旧内容压成摘要，不会越聊越贵；看视频是主要开销，时长、频率、描述长短都能在控制台调。

---

🔀 两种接入方式

QQ 机器人常见两条路：

• 官方开放平台：AppID / AppSecret，接口稳，但要注册、审核、配置回调；
• OneBot / NapCat：用普通 QQ 号，起步快，协议端有被风控的可能。

qfish 走第二条。两种方式没有谁更好，取舍不同：

| | qfish（OneBot / NapCat） | 官方 Bot |

|---|---|---|

| 账号 | 普通 QQ 号 | 开放平台机器人 |

| 上手 | 装 NapCat，填地址 | 注册、审核、配回调 |

| 进群 | 像普通号一样被拉进去 | 邀请链接和权限 |

| 稳定性 | 协议端有风控可能 | 官方接口 |

| 适合 | 自己养、群里像个人 | 面向公众的产品 |

具体到功能，这几块做得比较多：

一、起步简单

装个 NapCat，登个 QQ 小号，插件里填个地址就通了。

二、视频会看完再聊

不光看标题和简介：B 站视频的字幕、逐帧画面、弹幕、热评都会过一遍。太长会直说太长。