Back to directory

dsh-onebot-hub

In a curated listMaintenance: Active

funny1potato/dsh-onebot-hub

OneBot v11 hub for DeepSeek Harness: relays QQ events verbatim to downstream bots while giving the agent a full timeline, action ledger and 30 onebot_* tools.

View on GitHub
$ dsh plugin add dsh-onebot-hub

Install

dsh has no central install command — add this plugin’s entry (documented in its README) to your profile or patch config, then restart.

How installs work

8

stars

1

forks

JavaScript

Language

MIT

License

2026-10-09

Created

2026-11-14

Last push

README

dsh-onebot-hub

把 DeepSeek Harness 接到 QQ(OneBot v11)上,并让它看清整条链路发生了什么。

npm license powered by dsh

中文 | English

已经有一个 NoneBot 机器人,又用不上 DSH? 那这个插件解决不了你的问题——它自己不是聊天机器人,只是把 DSH agent 和一个看得见的 OneBot 枢纽接在一起。想要一个能直接聊天的群友,装 nonebot-plugin-aigf-master 就行:记忆、人设、表情包、什么时候该开口,它都自带。 往下读的前提是这两个之一:你想让 DSH 进群,或者你想看清群里到底发生了什么。

📖 这是什么

一句话:它是一个 OneBot v11 的"枢纽"——上面接真正登录着 QQ 的实现端,下面接你的 NoneBot 插件,中间坐着 DSH 的 agent。

              QQ 客户端(真人在聊天)
                     │
                     ▼
        ┌──────────────────────────┐
        │  QQ 实现端                │   LLOneBot / NapCat / go-cqhttp
        └────────────┬─────────────┘
                     │ OneBot v11 WebSocket
                     ▼
        ┌────────────────────────────────────────┐
        │  dsh-onebot-hub                        │
        │  ① 上游:收全部事件,持有全部 action      │
        │  ② 观测:时间线 / 谁做了什么 / 原始报文   │
        │  ③ agent:记忆、人设、决定要不要说话      │
        │  ④ 下游:把事件原样转发给 N 个下游 bot    │
        └────────────────────────┬───────────────┘
                     │ OneBot v11(四种连法任选,可多条)
                     ▼
            NoneBot / 其它 OneBot bot(可多个)

为什么需要它 → 它能替你做什么

你想要 没有 hub 有 hub
让 DSH 进群聊天 DSH 不认 OneBot 协议,接不上 agent 拿到全部消息与全部 action
机器人到底在干什么 只能翻日志猜 onebot_timeline 看消息、onebot_turns 看"谁引发了什么"、onebot_raw 看原始报文
想换/加一个下游 bot 得把 QQ 实现端重新接一遍 加一条 downstreamTargets,现有插件一行代码都不用改(事件原样转发)
试探下游插件又怕惊动群 真发消息试 探针走另一个账号,真人消息串不进去
一个群一个模型/一个角色 做不到 白名单 + 人设预设 + 分群额度,逐群配

只想让 DSH 在群里说话、不接任何下游 bot?完全可以:downstreamTargets 留空就行。

✅ 前置条件

开始之前,你至少需要:

  1. 一个 QQ 实现端(真正登录着 QQ 号的那一层):LLOneBot、NapCat、go-cqhttp 等,且它支持 OneBot v11 的 WebSocket(反向或正向都行)。
  2. 一个能跑的 DSH(DeepSeek Harness),并且里面配好了可用的模型。
  3. 可选:想路由给下游的 NoneBot 插件(没有也能用)。

插件本身不需要 Python、不需要编译,运行时只依赖 ws,包里自带构建好的 lib/。

💿 安装

插件已发布到 npm:dsh-onebot-hub。

用 DSH 自带的插件管理器装进某个 profile(<你的 profile> 换成 profile 名,比如 desktop):

dsh plugin --profile <你的 profile> add dsh-onebot-hub

这条命令只是把参数转给该 profile 目录下的 pnpm,所以等价写法是:

cd ~/.dsh/profiles/<你的 profile>
pnpm add dsh-onebot-hub
装完要不要手改 cordis.patch.yml?

默认不需要。包里声明了 dsh.bundle,装好会被自动并入 profile 的插件层。

万一个别版本的 DSH 没有自动并入,就在该 profile 的 cordis.patch.yml 里追加下面三行(别动已有条目)再重启:

- insert:
  - id: onebot-hub
    name: 'dsh-onebot-hub'
想装开发版 / 自己改过的版本?
pnpm add github:Funny1Potato/dsh-onebot-hub     # Git 源:拉源码,需要 prepare 脚本并放行构建
pnpm add file:D:/path/to/dsh-onebot-hub         # 本地目录:改完重启即生效

装好后重启 DSH,设置页里会多出一个「OneBot 枢纽」分节。

🚀 五分钟上手

第 1 步:装好并重启

打开 DSH 设置页 →「OneBot 枢纽」,能看到一堆配置项就说明插件加载成功了。

第 2 步:把你的 QQ 实现端接上来

设置页里上游只有三格:类型(OneBot / QQ 官方机器人)、连接方式(反向 WS / 正向 WS)、地址。

推荐让实现端反连 hub(不用在 hub 里填上游地址,实现端换 IP 也不影响):

  1. 类型选 OneBot、连接方式选 反向 WS,地址填:

    127.0.0.1:8765/onebot/v11/ws
    

    这是"监听地址 + 路径",写什么就监听什么,不写路径只接受根路径 /。

  2. 在 LLOneBot(或 NapCat)里打开 WebSocket 反向(反向 WS),地址填同一个:

    ws://127.0.0.1:8765/onebot/v11/ws
    
  3. 保存 → 重启 DSH(或直接在设置页保存,效果一样)。

怎么确认接上了:在 hub 自己的会话里问它一句,让它调 onebot_hub_status;或者看设置页顶部状态。日志在 <storageDir>/startup.log(默认 ~/.dsh/onebot-hub/startup.log)。

也可以反过来——hub 主动拨实现端:连接方式选 正向 WS,地址填 ws://127.0.0.1:3001。两种方式二选一。

老配置不用改:upstreamListen / upstreamUrl 照旧读,hub 会从它们推出「连接方式 + 地址」并记一行日志。想让上游换成 QQ 官方机器人,类型选那个即可(实验性)。

第 3 步:告诉它"哪些群可以说话"

默认它是全静音的:不写白名单,任何群、任何人 @ 它都不响。

  • agent.groups:允许调模型的群号,JSON 数组,如 ["123456789"]
  • agent.privates:允许调模型的 QQ 号,JSON 数组,如 ["10001"]
  • chatCommands.superUsers:谁能用聊天里的管理命令,如 ["10001"](留空 = 整条命令链沉默)

怎么确认:在群里敲 /status,超管应该能收到一条状态回执。

第 4 步:在群里 @ 它

被 @、被引用、或者私聊发消息,它才会醒——醒了会参与一会儿,之后没人理它就自己睡回去。

至此最小可用配置就完成了,剩下的都是按需打开。

⚙️ 配置

全部配置项与默认值见 docs/config.md(设置页里每个字段的中文名和说明也来自那里,二者由测试对账,不会各说各话)。

最少要配的

键 说明
upstreamType / upstreamMode / upstreamAddress 接哪台 QQ 实现端:先选类型('' OneBot / official 官方),再选连接方式(反向 WS 让实现端反连,推荐;正向 WS 让 hub 拨过去),最后填地址。老键 upstreamListen / upstreamUrl 仍可用,hub 会自己推出这三格
downstreamTargets 下游列表,JSON 数组,可多条。不接下游就留空
agent.groups / agent.privates 白名单:写了的群/QQ 才调模型。两张都空 = 全部静音
chatCommands.superUsers 谁能用管理命令。留空 = 命令链整条沉默

常改的

Read the full README on GitHub →

DSH Plugins is an independent community directory of DeepSeek Harness plugins. Not affiliated with or endorsed by DeepSeek. Third-party plugins are not security-audited — review the source before installing.

New DeepSeek Harness plugins, weekly. No spam.