dsh-onebot-hub
In a curated listMaintenance: Activefunny1potato/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.
$ dsh plugin add dsh-onebot-hubInstall
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 work8
stars
1
forks
JavaScript
Language
MIT
License
2026-10-09
Created
2026-11-14
Last push
README
已经有一个 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留空就行。
✅ 前置条件
开始之前,你至少需要:
- 一个 QQ 实现端(真正登录着 QQ 号的那一层):LLOneBot、NapCat、go-cqhttp 等,且它支持 OneBot v11 的 WebSocket(反向或正向都行)。
- 一个能跑的 DSH(DeepSeek Harness),并且里面配好了可用的模型。
- 可选:想路由给下游的 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 也不影响):
-
类型选 OneBot、连接方式选 反向 WS,地址填:
127.0.0.1:8765/onebot/v11/ws这是"监听地址 + 路径",写什么就监听什么,不写路径只接受根路径
/。 -
在 LLOneBot(或 NapCat)里打开 WebSocket 反向(反向 WS),地址填同一个:
ws://127.0.0.1:8765/onebot/v11/ws -
保存 → 重启 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 |
谁能用管理命令。留空 = 命令链整条沉默 |
常改的
More in Integrations & Sharing
dsh-notification
by omdsh-dev
Desktop notifications for DeepSeek Harness turn completions, with per-outcome controls and include/exclude keyword rules.
dsh-lark-bot
by plutokeating
Feishu/Lark bridge for DeepSeek Harness: scan-to-connect PersonalAgent binding, streaming cards, git-worktree project workspaces, parallel per-scope tasks, multi-role agents, cross-session notify, in-chat model/key management, and a safety-net guardian that still answers in Feishu after dsh crashes.
dsh-session-notification
by dingyi222666
Notifications for four session states, with browser alerts and prompts.
dsh-chatgpt-web
by wlv-zedd
DSH ChatGPT Free bridges standard ChatGPT Web directly into DeepSeek Harness
