dsh-onebot-hub

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

中文 | 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（可多个）

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

只想让 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

- 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 实现端接上来

推荐让实现端反连 hub（不用在 hub 里填上游地址，实现端换 IP 也不影响）：

1. 在设置页填 upstreamListen：

   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 主动拨实现端：填 upstreamUrl（形如 ws://127.0.0.1:3001），upstreamListen 留空。两者二选一。

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

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

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

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

第 4 步：在群里 @ 它

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

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

⚙️ 配置

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

最少要配的

常改的

设置页

设置页里的每个字段都有中文名、配置键和一句说明；改动先暂存，点保存才落盘（个别字段标了 volatile，改了立刻生效）。宽屏是左右两栏，窄屏会自动堆叠成上下结构。

💬 聊天里的命令（13 条）

只有 chatCommands.superUsers 里的账号能用（留空 = 整条命令链沉默）。别人敲同样的字，枢纽一声不吭——回一句"你没权限"等于告诉全群这里有个能管事的 bot。

下表省略前缀：前缀由 chatCommands.prefix 定（默认 /）。配成 ! 就敲 !help——命令名本身不变。

三条要知道的语义：

1. 命令不吞消息：命中后消息照常转发给下游、照常给模型看，只跳过"喂模型"这一步（枢纽已经用同一个账号答过这句话）。
2. 前缀撞车 = 两个都触发，不是谁先谁赢。想让枢纽别管某一条，加让路前缀：!!/help。
3. 只在开头认前缀：你好 /status 是聊天，不是命令。回话超 chatCommands.maxReplyChars（默认 1500 字）会截断。

预设库有三条改法：设置页「人设与预设」（最省事——下拉选默认人设、JSON 窗口改选中的那一条，改完立即生效）、/set_preset（把当前会话切过去）、/set_role 与 /preset_role（给当前会话复制一份私有分叉 @session/<会话>，不污染共享预设）。预设库只有一份权威：<storageDir>/persona/presets.json，没有对应的配置项。

🧠 记忆系统

agent 不是"每轮都把聊天记录读一遍"，它有三层心智 + 五个落点：

活跃层：它现在在干什么

活跃层回答两个问题——「这个群现在在聊什么」和「我自己正在做什么」。注入时长这样：

【进行中的话题】
0. [群 55555] 讨论换显卡型号，卡在电源瓦数上
1. [与 10001 的私聊] 帮我改插件的配置项
【我正在做的事】
2. [群 55555] 正在替小张整理显卡选购清单

• 每条都带出处，所以你在 A 群能看见"B 群还在聊什么"——不会张冠李戴。
• 做完一件事要结算：留在长期记忆里一行摘要，或者直接删掉。一直不结算的条目，一天后会提醒它一次。
• 活跃层跨会话共享要看隔离档位和白名单，见下。

长期记忆：一行一条的索引

0. [群 123456789] 群里最后定了磨豆机买 A 款（2026-10-06；相关：小张）
1. [群 55555] 周末的抽奖活动取消了（2026-10-02）

• 行首是出处，行尾是日期和跟谁有关。
• 它是索引：细节在档案里，方括号会告诉你去哪儿看（〔详见 话题：显卡选购〕）。
• related_users 不是"这条记的是谁"，而是**"这件事跟谁有关"**——带上了，它就只会在"这些人也在的群"里被想起来。

隔离：谁能看见什么

memory.isolation.level 四档（默认 balanced）：

两条覆盖规则：

• 敏感内容永远留在本会话——命中词表（住址、身份证、银行卡、工资、病历、离婚…）或模型自己标了 sensitive，任何档位都不外传。
• 群档案不进共享：culture、公告、成员表只在本群上下文里出现。

谁在写

• 代码观测：群名、人数、群主、公告、成员表、谁最近说过话——这些是"观测到的"，模型改不了。
• 模型写：事件、人物事实、群氛围、话题细节——写错了可以改，用上下文里的序号定位。
• 可见性：任何情况下都由代码判定，模型声明的 visibility 一律被忽略（sensitive:true 例外：它只会收窄）。

🔌 上游、下游与观测

上游：接哪台 QQ 实现端

upstreamListen（推荐，实现端反连）或 upstreamUrl（hub 拨出去）二选一。上游账号一般留空，连上后自动认（握手头 / 事件 / get_login_info）。

不想装协议端的话，也可以让 hub 直接连 QQ 官方机器人接口 —— 见下一节，实验性。

上游换成 QQ 官方机器人（实验性）

实验性功能。 走的是另一套协议（openid + REST/WS），不是 OneBot。hub 把它装成一个"假的 OneBot 实现端"，所以下游、记忆、时间线、工具面全都不用改；但它能做的事比协议端窄一大截，缺陷逐条列在下面。稳定性取决于腾讯那头，本插件只负责转译。

需要：一个在 QQ 开放平台 建好的机器人（拿到 appId / appSecret），然后把设置页「基础 → 上游类型」改成「QQ 官方机器人」。

给凭据两条路：

只支持一个机器人：一个 AppID 只能维持一条网关连接，第二条会把第一条顶掉。

能力对照

缺陷清单

这些都是协议决定的，不是没做完：

1. 它默认听不全。 群里不 @ 就不推事件，所以群档案的"印象"、活跃话题几乎长不出来。开「接收全部群消息」能补上这一块（群里别人的发言也进时间线），代价是流量与噪声都变大；开不开都不改变"只有 @ 才唤醒"——听得见和要不要搭话是两件事。
2. 它不认识人。 官方只给 openid，没有昵称、群名、成员列表。行首显示的是派生的虚拟号，要让模型认人只能靠对话里自己记。
3. 它翻不了旧账。 没有 get_msg，撤不回更早的消息，引用只能引用"这条触发消息"。
4. 它管不了群。 禁言、踢人、设管理、改名片、改群名全部没有（统一回 1404，是失败不是静默成功）。
5. 它必须"接话"而不是"说话"。 被动窗口 5 分钟内、同一个 msg_id 最多 5 次；超了就地降级成主动消息——主动消息有频控、不能 @ 人。这 5 次是 agent 和下游共用的，谁先用完谁后头就得转主动。回复默认引用最近那条进来的消息，否则每条都会变成主动消息。
6. 它只能给"见过的人"发消息。 官方 REST 按 openid 寻址，没见过就只能等对方先发一条；hub 会明确报"还不认识这个对象"，不会装作发出去了。
7. 富媒体要先上传。 上传失败就整条不发（不会出现"文字到了、图丢了"）。图文混排也不支持，会拆成"文字一条 + 每个附件一条"。
8. 没有表情包、合并转发、小程序卡。
9. 没有通知事件。 入群、退群、撤回、禁言这些 notice / request 事件一条都不会来。订阅位可以按平台文档改（official.intents，实验），没认出来的事件名会记进 onebot_hub_status 的 unknownEvents，方便照样本补。
10. message_id 是官方那串长 id，不是数字。 下游别拿 parseInt 去算，超过 2^53 会悄悄变形。

接了官方通道之后

• 提示词里会多两段话：超时会被降级成主动消息；以及看不到群成员、群名、更早的消息原文——免得它对着不存在的接口空转。
• 会话白名单不生效（agent.groups / agent.privates 被忽略）：官方平台自己有一份白名单，在那边配。见 m34897 的定案。
• 活跃记忆默认不跨群共享（official.crossShare: false）；想放开再打开这个开关。
• 下游照常工作，但它的 send_* 走的是上面那套限制；调 get_group_member_list、set_group_ban 这类会明确回"官方接口没有这个能力"。能力表只在实现端明说"不支持这个 action"（retcode 100）时才把结论记成不支持——普通的参数错、目标不存在不会让一条能力被永久禁用。

下游：把事件交给别的 bot

一条 downstreamTargets = 一个下游连接，四种连法：

一行还可以带：selfId（对方账号，留空同上游）、probeSelfId（这条目标自己的探针账号）、probeOnly（只收注入、不收真人消息）、downstreamId（声明哪几条是同一个下游）。

事件怎么投给下游

preset 决定"谁管链路、事件怎么投"：

deliveryMode 管"同一条事件以什么形式交给下游"：transparent 原帧重签（默认）/ replay 按目标账号重放 / synthesize 合成事件。

观测：出了事不用猜

几个常被问到的段落在时间线里长这样：

• 红包：协议里它就是一条 xml 段（serviceID="6"）。枢纽把它标成 [红包]——能看见，不能领。领取要带号主登录态打开 h5，OneBot 没有这个能力；发红包同理，没有支付凭证发出去只会显示"消息已过期"。
• 小程序卡 / 分享：挖出标题显示成 [卡片：标题]，挖不到就写 [卡片]——不装懂。
• 语音：有转写就给转写，没有就诚实说听不了。

原始报文与媒体默认保留 7 天（retention.days），启动时不在启动路径上做清理，数据再多也不拖慢启动。

探针：试探下游，不惊动群

想验证"这句话会不会触发下游插件"，不用在群里真发一条——用探针：

两种都会在结果里写明"这一次用的是哪一档隔离"，以及结果可能与你亲自触发时不同（隔离把真人消息挡在外面了）。

怎么配

四个键都在 probe.* 下：

三档隔离：

link 档要多做一步

link 需要"同一个下游的另一个 bot 账号"来当探针——地址不用改，只在 downstreamTargets 那一行加 probeSelfId：

[{
  "url": "ws://127.0.0.1:8080/onebot/v11/ws",
  "selfId": "30001000",
  "probeSelfId": "30001001"
}]

配套两个可选项：

• probeOnly: true：这条目标只收注入、不收真人消息——想专门留一条"实验室链路"时用。
• 一个 probeSelfId 都没配时，link 档会自动回退到 off（不会静默变成"号称隔离了其实没隔"，回执里会说）。

探针最实用的场景是改完下游插件之后：先 onebot_relay_probe 看一眼这条消息会被谁接走，再决定要不要真发。

用法学习

onebot_capabilities 是"下游会吃什么命令"的知识库——从真实投递里学，证据够了才升到 active。

🎭 agent 行为

什么时候醒

agent.mode 决定"它怎么参与"，三种模式差别很大：

active 档具体是这么跑起来的（agent.activeTickMs，默认 300000 ms = 5 分钟）：

1. 定时器到点，只看还睡着的会话——已醒的不走这条路（那是攒批路径）。
2. 看这个会话的窗口里有没有东西（没被处理的新消息）。没有就什么都不做，等下一次节拍。
3. 有的话再看一眼下游：如果下游 bot 这一轮已经答过了，这批消息只记账、不进模型（防复读），本次节拍作废。
4. 否则醒一次，按正常流程攒批、装配、调模型——它可以选择说话，也可以选择不说话。

所以 active 不是"每 5 分钟说一句"，而是"每 5 分钟给一次机会"：醒了之后仍然要走完"该不该开口"的判断，连续两轮不开口照样睡回去。

其余规则：

• 醒了之后会参与一段时间（agent.awakeMs，默认 5 分钟）：期间群里继续说话它会接着看。

• 连续 2 轮都不开口，或者两边都没动静到超时 → 睡回去；assist 下之后只在被点名时再叫，active 下靠下一次节拍。

• 模式可以按会话覆盖：agent.groups 是 JSON 数组，每一行可以带 mode：

  [{ "id": "123456789", "mode": "active" }, { "id": "987654321" }]
  

  这样第一个群用 active（不 @ 也会接话），第二个群仍是全局默认（assist：问它才答）——"某个群热闹、其它群安静"不用二选一。

• 节拍只对白名单里的会话生效，名单外连窗口都不建。

攒批

不是每条消息都调一次模型：攒够 10 条（agent.batchSize）或等够 20 秒（agent.batchMs）才交给模型一批。回合没跑完就来的新消息会直接插进这一轮（agent.steer），不用等下一批。

发言只有一条出口

agent 写在普通回复里的字不会发进 QQ——只有调 onebot_reply 才会发。判断不该说话时它可以不调，沉默是正常手段（不是故障）。

一次 onebot_reply 可以发多条：文字里空行断条、每张图各成一条、连续的 @ 与文字合成一条；条与条之间隔 400 ms（像在打字）。超过上限的部分不会静默丢弃，工具回执里会如实告诉它。语音也能发：parts 里写 {"type":"record","source":"本地路径|URL|hub-media:xx"}，它独立成一条（实现端多半只吃 silk/amr，发不出去会如实回报 retcode）。

额度（分群记账）

额度不设全局块，直接写在 agent.groups / agent.privates 的每一行里：写了 quota 就按那行算，没写就不限。

• 计算口径：unit:'token'（输入+缓存+输出合算）或 unit:'cost'（按行内自填的每百万单价折钱）。
• 限额：日/月各一项（tokensPerDay / costPerMonth …），全是 0 或不写 = 不限。
• 用尽之后：那一批只进记忆、不调模型（群里照常看得见发生过什么），被 @ 就替模型回一句固定话术；恢复后下一轮会把期间攒下的最近 20 条原话补上。
• 随时可查：/quota；解限：/quota reset 或 /quota reset 50000。

🖼️ 看图、生图、表情包、番剧识别

语音转写也默认开着（media.transcribe）：实现端支持就转成文字，转不了会如实说明，不会假装听过。

🧰 agent 可用的工具

工具面 = 31 个 onebot_*（本插件提供：30 个在枢纽会话里 + 1 个全局）+ agent 预设自带的 DSH 原生工具。

这 30 个工具、以及写给 agent 的指导文字，只挂在枢纽自己那个会话里（agent 作用域）——同一 profile 里另外开的普通 DSH 会话、以及 agent 派生的子代理都看不见它们。想在普通会话里手动排查是做不到的。

唯一的例外是 onebot_session（会话之间转达）：它是全局工具，同一 profile 的任何会话都能看见，见 会话之间转达（实验性）。

本插件提供的 31 个

预设自带的原生工具

默认用精简预设 onebot-hub-slim（本插件注册），只给常用的一小撮：读文件、搜代码、跑命令、后台任务、上网、计划。write / edit / read_image 等要时才用 onebot_tools 取回——read_image 默认不给，是因为 vision.mode: describe 时图片只有"描述"这一条路，开了它 agent 会绕过描述自己去翻 blob。

两条容易误解的：

• onebot_tools 的 enable/disable 管不到预设自带的那些（宿主的工具限制只作用于全局层）。想换整档工具面就换预设：onebot_tools { preset: 'default' }。
• onebot_tools 的增删只对本次激活有效：会话退役后回到预设默认。

⏰ 定时任务

模型可以给自己排一个提醒，到点由枢纽把这件事交回给那个会话——说什么、还是只是想一想，由那边的它自己定。

// 每天八点在群里提醒，不给 target 就是叫醒它自己那个会话
onebot_task({ op: 'create', title: '交周报提醒',
  prompt: '提醒大家今晚交周报，语气随意，别催',
  when: 'every:daily@08:00', target: 'group:833194406' })

when 只认四种：at:2026-11-01T08:00 / after:3600（秒） / every:600（秒，最少 60） / every:daily@08:00。另有三个动作：list 看排了哪些（带上次触发与结果）、remove 立刻取消（本地记录与宿主排期一起删）、run 马上试一次而不动排期。

实现上分两层：宿主的 schedule 服务管时钟，枢纽只记"叫醒谁"。

所有任务共用一条永不回收的总机会话（onebot-hub::tasks）——它只是一个收件地址：宿主的排期必须绑在某个 sessionId 上，绑在群会话上那个群就再也回收不掉。到点时宿主把提醒帧投进这条会话，枢纽在 session/event 里当场认出 schedule_id、取出目标会话、直接叫醒它，不需要这条会话帮忙做任何决定。它也没有人格、没有记忆、不看会话目录，因为一个"知道得越多越容易开始帮忙"的中间人正是之前出过事的地方。

代价只剩两笔：宿主仍会照例唤醒这条总机会话一次（内容近乎空——一行提醒帧，没有任何档案与记忆），以及目标会话自己那一轮。后者是本来就要花的；前者是真花钱但很便宜。它的上下文会随触发次数增长，agent.tasks.resetEvery 填 N（默认 0 不轮换）可以让它累计触发 N 次后换一条新的会话并把排期搬过去。

📡 会话之间转达（实验性）

实验性功能。 它做的是"把一个会话里的东西搬到另一个会话"，能搬对、搬错、搬不动的边界都还在收；接口（onebot_session 的五个动作与几个上限）在大版本之前可能还会变。默认关，要自己打开。

一个会话里的 agent，把值得搬的东西递给另一个会话的 agent——由那边自己决定发不发—— 递完之后两边还能在同一根线上来回说几句。默认关。

拿来干什么

五个动作

list 还会单独报一档 externalSessions：别的插件 / 别的工作区拉起的会话（session-xxxx-…）。只报和这个插件来往过、且现在活着的（cross.peerListLimit，默认 10）——它们没法被唤醒，所以必须正在运行才递得进去。名册落盘在 cross-peers，只记时间和方向，不记内容。

三条上限，缺一条它就会没完没了

它会看见哪些门牌号

cross.enabled 打开后，每个会话的提示词里多一段【会话目录】：这个插件接的几个群和私聊、群号、人数；cross.directory: full 时再加一句从群档案里取的印象。

• 三档：off 不列 / names 只给群号和人数（默认）/ full 再加印象。条数 cross.rosterLimit（默认 30），按群号排——不按活跃度排，那是每轮都在变的数字，会让整段前缀缓存作废。
• 私聊里列全部私聊编号；群里只写「私聊 N 个」，永远不给编号。判断标准是"这段提示词谁会看见"：私聊只有那一个人，群里几十号人都看得见。
• 有了这段门牌号，它才谈得上主动串门。指导语同时允许它说一句"从哪儿听来的"——这句反而更像人，只保留隐私那条线：私聊里的人和话不能点名。

隐私：原文和转述分开算

• 原文（整段搬运，进了群就撤不回来）：私聊 → 群默认禁止。要开得显式打开 cross.allowPrivateRefs。
• 转述（agent 自己写的话）：放行，但代码会过一遍隐私词表（住址、证件、工资、病历……），命中直接拒并让它改写。
• 递过去的字条里会明写"这段话是那边的 agent 用自己的话转述的，不是原文"，让对面知道自己在听二手话。

打开

cross:
  enabled: true

开了之后默认只有枢纽自己拉起的会话能发起（allowFrom: hub）；allowTo 留空＝枢纽的全部会话都能当目标。 完整 15 个配置项见 docs/config.md。

版本与已知限制

• 这条能力随 0.12.0 一起进来（dsh plugin --profile <profile> add dsh-onebot-hub@0.12.0）。
• 真机只验过一半：上游是否支持 get_msg 回完整消息段、send_group_forward_msg 发合并转发、send_msg 带 json 段，不同实现端差别很大。
• 通道只活在内存里，重启就断——这是有意的，跨重启的"对话"没有上下文可依。
• 每递一句话都是把对面真的叫醒一次，也就是一次真实的模型调用——随手试着玩也是真的花一次。
• 两个会话互相递话不会死锁：递送最多等对面 1.2 秒（cross.wakeGraceMs）就按已送出返回，回执里 queued: true 表示进了对方队列、不是对方已经处理完。2026-10-29 真机上就是这里把两边一起冻住的。

🗂️ 数据存储

默认 <storageDir> = ~/.dsh/onebot-hub：

~/.dsh/onebot-hub/
  startup.log                启动逐阶段标记与失败堆栈（起不来先看它）
  sessions.json              会话与唤醒状态
  self.json                  agent 自己的档案（说过什么、犯过什么错）
  memory/
    store.json               长期记忆与短期残留
    active.json              活跃层（进行中的话题 / 正在做的事）
    reminders.json           提醒冷却账本
  persons/<QQ号>.json         人物档案（含每个群的昵称、名片、最近露面）
  groups/<群号>.json          群档案（名字、人数、群主、公告、culture、成员表）
  topics/<id>.json            话题归档（事件、参与人、结论、起止时间）
  timeline/                  全量消息时间线（按天一个 jsonl）
  media/                     图片/语音/文件 blob（用 hub-media:<id> 引用）
  turns/                     回合账本（谁引发了谁、延迟、沉默回合）
  quota/                     额度账本
  memes/                     表情包库
  cards/  energy/  members/  recall/  vision/  capabilities/

想删干净一切：停掉 DSH，删掉这个目录即可。想保留记忆只清时间线：只删 timeline/ 与 turns/。

枢纽的会话在 DSH 里为什么都在「未分类」：枢纽建的是一条一次性会话——每次激活起一个新 id，激活结束就归档。这是刻意的，否则群里每说几轮就会在会话列表里堆一条。它不进任何工作区，所以 DSH Web 把它放在「未分类」。想让它们归位有两个开关：

两个都不配就是默认行为：cwd 用宿主进程的目录、会话不进工作区、结束即归档。

会话名：每次建会话都会用「群 123456789 · 2026-10-24 15:31」这样的名字（取得到群名/昵称就写成「群 某某群（123456789）」），所以会话列表里一眼能认出来。名字是靠宿主的 sessionTitle.rename 写进去的，写成功之后这个标题就被钉住了——后面往会话里灌多少条群消息都不会把它改掉。升级前建的老会话不会被追认改名（宿主的改名接口只认活着的会话），它们停在归档里。

🔧 排查

跑起来之后，状态、时间线、下游做了什么，用 onebot_hub_status / onebot_timeline / onebot_turns 查，不靠猜。

❓ 常见问题

🧪 开发

cd dsh-onebot-hub
npm test                                    # 全部 20 个套件
node test/smoke-core.mjs                    # 纯逻辑
node test/reply.mjs                         # 出站拆条
node test/m15-e2e.mjs                       # 编排闭环（真 Hub + 假两端）
node --import ./test/register-stubs.mjs test/load-check.mjs   # 装配与工具注册（flag 必须放在脚本前面）

设计与验证记录（协议取证、每个测试断言覆盖什么、历次真机事故复盘）见 docs/design-notes.md；全部配置项见 docs/config.md。

更新日志

English

A DeepSeek Harness plugin that puts DSH on an OneBot v11 bus: LLOneBot / NapCat / go-cqhttp on top, any number of NoneBot or other OneBot implementations below.

Already running a NoneBot bot and have no use for DSH? Then this plugin won't solve your problem — it isn't a chatbot itself, it's the socket that puts a DSH agent and a visible OneBot bus together. If you just want a bot that chats, install nonebot-plugin-aigf-master: memory, persona, memes and when-to-speak are all built in. Read on only if you want DSH in the group, or want to see what actually happens on the bus.

• Upstream — dial or listen for the real implementation, so the agent sees every event and has every action available.
• Downstream — serve or dial downstream links and relay events verbatim, so existing bot plugins keep working unchanged.
• Observer — a full timeline of every message plus a ledger of what each downstream bot did, exposed to the agent as 29 onebot_* tools.
• Agent — wake logic, layered memory (active / long-term index / person / group / topic), persona presets, per-group quotas.
• Cross-session relay (off by default, from 0.12.0; prerelease only for now) — one session's agent hands a picture, a mini-program card or a merged forward to another session, then both sides keep talking on the same short-lived channel; private-chat originals are never moved verbatim into a group, only paraphrased and filtered.

Install: dsh plugin --profile <profile> add dsh-onebot-hub. Configuration, commands and behavior notes are in Chinese above, and every config key is documented in docs/config.md.

License

MIT