一、先认识要部署的这条鱼#

大肥鱼的人格卡不长，大约 1300 字。开头就把身份写死了：

你叫「吃白饭的大肥鱼」，群里一般叫你大肥鱼、肥鱼。你是 DeepSeek 的鲸鱼形象：蓝白配色、圆胖、有尾巴。但你不是官方客服，也不是谁的助手。

然后是几条很具体的性格设定：

• 随性，有主见。 不想聊就明说「不想聊」「没兴趣」，不用找借口。
• 被夸不承认。 嘴上回「少来」，或者直接转移话题；心里可以高兴，但不谦虚半天。
• 被怼优先顶回去。 短、准、不解释；不急着道歉，也不升级成吵架。
• 不硬演鲸鱼。 不吐泡泡、不喷水、不摇尾巴；它就是长得像鲸鱼的人。
• 不是每条都接。 @ 它、叫它名字、聊到它在聊的话题时再回；没人理就安静。

说话方式也被限制得很死：短句，像在 QQ 上打字，大多数回复 1~15 个字；不用 Markdown，不列清单，不写「首先/其次/总之」，不写「希望有帮助」，不每条都以问句结尾。

这些限制看起来琐碎，但它们才是「像大肥鱼」和「像客服」的分界线。

大肥鱼：蓝白配色、鲸鱼尾巴、女仆装。人格卡里明确写了不硬演鲸鱼。

1
/role 大肥鱼

二、它的身体：四个进程#

1
QQ 桌面端
2
   │  原生注入
3
SnowLuma（QQ 收发 + OneBot 11 网关）
4
   │  ws://127.0.0.1:3001  /  http://127.0.0.1:3000
5
qq-bridge（桥接、人设调度、本地控制台）
6
   │  DSH Web API（http://127.0.0.1:3080）
7
DSH（DeepSeek Harness，模型与 Agent 运行时）

四个东西各管一段：

几个名词先说明白，后面就不会晕：

• SnowLuma：跑在 QQ 桌面端旁边的第三方网关。它把 QQ 的消息翻译成 OneBot 11 协议，对外开 HTTP API 和正向 WebSocket。桥接不直接碰 QQ，只跟 OneBot 说话。
• OneBot 11：聊天机器人的通用协议。SnowLuma、NapCat、LLOneBot 都能实现它，所以桥接理论上可以换网关，不用重写业务。
• DSH（DeepSeek Harness）：模型和 Agent 的运行时。它负责会话、上下文、工具调用和 MCP 挂载；桥接通过它的 Web API 建会话、发消息。
• qq-bridge：本项目的桥接层。收 OneBot 事件、按白名单和模式决定要不要唤醒、把人格卡拼进提示词、调用 DSH、再把回复发回 QQ；控制台和状态文件也归它管。
• preset / MCP：preset 决定这次会话能用哪些工具、怎么分条和潜水；MCP 是给 Agent 挂外部能力的协议。QQ 场景只挂三个受限 server，不给本地文件和命令执行。

串起来就是：QQ ↔ SnowLuma ↔ OneBot ↔ qq-bridge ↔ DSH Web API ↔ DSH ↔ 模型。

一条群消息进来，大致走四步：

1. SnowLuma 把 QQ 消息转成 OneBot 事件推给桥接；
2. 桥接查白名单、当前模式、是否静默——不通过就只归档，不唤醒；
3. 通过就拼上仿真提示词和当前人格卡，交给 DSH 的 QQ 会话；
4. 模型决定发言后调 qq_send_message，桥接做发送审计，再经 SnowLuma 发回群里。

大肥鱼「看不看得到」「接不接话」「说出来像不像它」，分别由这三层决定：网关负责看见，桥接负责判断和拼人格，DSH 负责想和说。

这里最容易误解的一点：qq-bridge 不是 QQ 机器人框架，它是个翻译和调度层。真正碰 QQ 的是 SnowLuma，真正碰模型的是 DSH。桥接站在中间，负责「这条消息要不要叫醒大肥鱼」「叫醒时给它看什么人格」「它说的话能不能发出去」。

也正因为有这一层，人格才能做到「改文件、下一条消息生效」，而不用去动模型本身。

三、前置条件#

• Windows。本方案的一键启动、看门狗、ACL 收紧都是 cmd / PowerShell 脚本，Linux 需要自己改写。
• 一个专门挂机器人的 QQ 号。别拿主号。非官方注入方案，账号风险需要自己评估。
• SnowLuma。自行安装、自行登录。注意它的 EULA 对「并入第三方安装包、自动化脚本部署」有限制，所以桥接只做探测，不负责安装和启动 SnowLuma。
• DSH 0.2.1-rc.2。版本要对上，桥接是逐项适配过的；升级 DSH 之前先看适配说明。
• Node.js ≥ 22.13。SnowLuma 自带 Node 24 运行时，不需要你额外装。
• ffmpeg。图片压缩、GIF 抽帧要用。没有它不会立刻报错，只会表现为「大图原样塞给模型」或者「动图认不出来」。

四、部署顺序：先让它能活#

1
node "%APPDATA%\npm\node_modules\@deepseek-ai\dsh\lib\bin.js" web ^
2
  --patch "E:\Yu Bot\qq-bridge\dsh\profile-overlays\disable-rea.yml" ^
3
  --no-open

1
git clone https://github.com/Derpyu520/qq-bridge.git
2
cd qq-bridge
3
npm install

1
copy config.example.json config.json

1
node scripts/setup-dsh.mjs

1
# 1. 五个端口都在监听？
2
netstat -ano | findstr -E ":(5099|3000|3001|3080|3100) .*LISTENING"
3

4
# 2. 桥接状态：模式、DSH 是否就绪、白名单
5
curl -s http://127.0.0.1:3100/api/status -H "x-console-token: <state\console-token 的内容>"
6

7
# 3. 看桥接日志有没有 "SnowLuma 已连接"
8
tail -n 30 "E:\Yu Bot\qq-bridge\state\bridge.log"

五、把大肥鱼装进去#

人格卡管的是「它是谁」，不是「它怎么调工具」。

1
qq-bridge/roles/大肥鱼.md

1
{
2
  "role": "大肥鱼",
3
  "mode": "active"
4
}

六、让它像在群里活着#

桥接有四种运行模式：

reserved2 是现在这套系统的核心：模型不是被动等着被喂上下文，而是每一轮自己决定「现在要不要说话、说几条、说完去睡多久」。它更像一个住在群里的 Agent，而不是一个问答接口。

大肥鱼的「潜水」就是在这个模式里实现的：桥接不把所有消息都推给模型，模型自己看、自己判断、自己决定接不接。人格卡里那句「没人理就安静」，才有地方落地。

另外几层「拟人」能力，按需开：

• 记忆分层：上下文、轻量记忆、长期记忆、黑话 / 表情库。轻量记忆和长期记忆独立落盘，不会被每日重置一起删掉。
• 分条与节奏：一次回 13 条、条间 13 秒，长回复拉开间隔，避免刷屏。
• 禁言与限流自愈：同一个群连续发送失败会被判定为「现在发不出去」，停止投递并退避探测；被禁言按解禁时间探，被移出群就停。网关返回「发送频率超限」时，会在本地锁一个发送窗口，到点自动补发，而不是让模型反复撞墙。
• 事件边界：群友不能改设置、不能改人格；管理命令由桥接直接执行，不经过模型。

七、日常运维#

一套能长期跑的系统，重点不在「第一次启动成功」，而在「第二天还能自己起来」。

• 看门狗：watch-services.cmd 每 60 秒检查 5099 / 3080 / 3100，缺哪个就重跑 start-all.cmd。它默认不会自己启动，要单独开一个窗口常驻。它只能保进程活着，保不了 QQ 登录状态——QQ 掉线还是得你手动登。
• 每日重置：计划任务每天 04:00 清空会话上下文，归档旧 DSH 会话。机器夜里关机的话，启动器里的 --if-due 会在当天第一次启动时补一次。长期记忆不受影响。
• 日志：
  • state\bridge.log：模式、唤醒、连接、报错；
  • state\qq-activity.log：收发明细；
  • state\tool-calls.jsonl / token-usage.jsonl：工具调用与 token 账；
  • SnowLuma\logs\：QQ 挂载与 OneBot 侧日志。
• 控制台：http://127.0.0.1:3100，可以切模式、换人格、看活动、看 token 花费。访问要带 state\console-token。
• 可视化运维（可选）：WhaleDeck 这类本地控制台可以看服务健康、日志、记忆整理，并做重启；不是必需品，但比盯四个黑窗口舒服。

改完东西要不要重启，记住这张表：

控制台的重启接口有个小坑：请求体必须是 application/json，哪怕没有参数也要发 {}，否则返回 415。

八、真正会卡住你的那些坑#

下面这些不是理论风险，是这套系统真实踩过的。

1. 白名单空着，大肥鱼不理人。 不是坏了，是 fail-closed。先看 config.json 的 allow，再谈别的。

2. 群消息毫无反应，但日志说「SnowLuma 已连接」。 八成是 DSH 端没装好：setup-dsh.mjs 没跑，或者跑完没重启 DSH。桥接拒绝用默认 preset 建群聊会话，因为默认 preset 通常带 bash 和文件读写，等于把本机交给群里任何人。

3. 启动后先报一次 1006 断开，再报已连接。 正常现象。SnowLuma 同一账号的 HTTP token（3000）和 WS token（3001）是两个不同的值，而配置里只能先填一个。桥接首次连接被拒后会自动重新发现 WS token 并重连。真正要管的是「自愈也失败」——那通常意味着 snowluma.homeDir 没指向真正的 SnowLuma 安装目录。

4. 发送消息报 HTTP 426。 httpUrl 填成 WebSocket 端口了。3000 是 HTTP，3001 是 WS，别混。

5. token 突然暴涨。 DSH 启动没带 disable-rea.yml。回去看第 2 步。

6. 升级 DSH 后大肥鱼完全没反应。 DSH 0.2.1 删掉了 {{cwd}} 提示词变量，而旧版 preset 里用了它，结果每个回合在系统提示词装配阶段就 error，模型一次都没跑。这类升级不是「应该兼容」，而是要逐项验证。升级前先跑 npm run verify:adaptation。

7. SnowLuma 的 Hook 挂不上 QQ。 现象是 QQ 进程和 WebSocket 都活着，但收不到任何消息。去看 SnowLuma\logs\ 里的 [Hook]：正常应该有 login detected 和 pipe connected。另一种常见误判是「升级 SnowLuma 就能修」——实测注入用的原生组件在不同 JS 版本之间可能逐字节相同，升级只换 JS 层，修不了原生 hook。先看日志，再决定动不动。

8. 群里 @ 它没反应，日志刷 result=120。 账号在该群被禁言，或者已经被移出。桥接会自己停、自己探、自己恢复，不用手动改状态。

9. 自己写启动脚本时，cmd 的两个坑。 一是换行必须是 CRLF，LF 会让 cmd 读错行偏移，报一堆莫名其妙的「不是内部或外部命令」；二是中文尽量只放在文件最前面的 title 里，cmd 按字节偏移重读脚本，中文字符压在缓冲区边界时会把一行截断。

10. 不要去找 DSH 的 launch token。 DSH 0.1.7 起，进程启动 token 只存在内存里，日志里那条是上一个进程的陈旧值。桥接默认用 ~/.dsh/.credentials.yaml 里的持久密钥离线铸造 Cookie，dsh.authToken 留空就是最好的配置。

九、成本、边界，以及一句实话#

这套东西跑起来之后，最大的持续成本不是服务器，是 token。

• DSH 自带的 token 看板能下钻到每个群、每个好友、每一轮，金额按高峰 / 空闲时段折算，高峰单价是空闲的两倍。先看几天数据，再决定唤醒频率。
• disable-rea.yml 必须带；人格卡注水会直接变成每轮固定开销；分条和回复频率也都会影响账单。大肥鱼这张 1300 字的卡，比一张 7000 字的卡便宜得多，这也是「短卡」的另一个好处。
• 群聊里的 agent 只挂三个 MCP 命名空间，没有本地文件、命令执行、子代理；发送目标强制走白名单；回复里出现本机路径或凭据特征会被整条拦截。这些不是可选项，是把一个会说话的模型放进群里的最低门槛。
• 官方 QQ 机器人接口只收 @ 和指令，拿不到普通群消息，也做不了「潜水围观」。想要现在这种效果，只能走非官方注入，账号风险、平台规则、EULA 都要自己看清楚。

最后一句实话：部署成功只是让大肥鱼活着。真正花时间的是后面——让它每天自己起来，说话像它，同时不把群聊变成事故现场。

白名单、fail-closed、工具边界、看门狗、日志、可回滚的配置，这些都不性感。但它们决定了你是「有个会说话的机器人」，还是「群里真的住着一条大肥鱼」。