dsh-onebot-hub
适用于 DeepSeek Harness 的 OneBot v11 hub：连接上游 OneBot v11 实现（正向 WebSocket 客户端），并以相同协议为下游机器人实现提供服务或发起连接，原样转发事件和操作，使 DSH 能观察每条消息并了解每个下游机器人的使用方式。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:Funny1Potato/dsh-onebot-hub#718087d29a120ab62a78af74750e93b039af4410Onebot Hub 以 dsh-onebot-hub 发布，当前版本为 0.1.6。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
English | 中文
把 DeepSeek Harness 接到 OneBot v11（QQ）上：DSH 既是下游 bot 的协议上游，也是群里的一个 bot。
A DeepSeek Harness plugin that puts DSH on an OneBot v11 bus (QQ: NapCat / LLOneBot / Lagrange up top, any number of NoneBot or other OneBot implementations below).
onebot_* tools.Install, configure and behavior notes are in Chinese below.
插件是纯 ESM、无构建步骤，运行时只依赖 ws。DSH 用 pnpm add 把它装进 profile，Git 源直接可用：
cd ~/.dsh/profiles/<你的 profile>
pnpm add github:Funny1Potato/dsh-onebot-hub
再往该 profile 的 cordis.patch.yml 追加（不要动已有条目）：
- insert:
- id: onebot-hub
name: 'dsh-onebot-hub'
然后重启 DSH（或直接在设置页 →「OneBot 枢纽」里配置并保存，效果与手改配置后重挂一致）。
| 键 | 说明 |
|---|---|
upstreamListen | 推荐。让实现端反连 hub（例 127.0.0.1:8765/onebot/v11/ws），不用在 hub 上填上游地址。与 upstreamUrl 二选一 |
downstreamTargets | 下游列表，JSON 数组。支持四种连接方式（ws-dial / ws-listen / http-api / http-post），可多条，设置页有行编辑器 |
只想自己用、不接下游 bot：downstreamTargets 留空即可。
完整配置项（137 项，每一项的作用与默认值）见 docs/config.md——设置页里每个字段的中文名与说明也在那里，二者由测试对账、不会各说各话。下面是真正需要你手动改的那些：
| 键 | 什么时候改 |
|---|---|
agent.groups / agent.privates | 白名单。写了的群/QQ 才调模型，没写的连 @ 都不理；两张都不写 = 不过滤。条目可带 mode（observer 只看不答） |
agent.mode | 平时是 assist（被叫到才醒、参与完自己睡回去），active 更活跃。名单里的某一类会话可在条目上单独覆盖 |
chatCommands.superUsers | 谁能用那 12 条管理命令（help status memes perm…，前缀见 chatCommands.prefix）。留空 = 整条命令链沉默（不猜谁是管理员） |
probe.isolation | 测试用命令时注入给下游的账号：link（默认，另开一个探针账号，真人消息进不去）或 time |
vision.mode | 看图方式：describe（把图交给视觉模型写成人话，默认）/ segment（把图本身给模型）/ off |
persona.presets | 群里的角色设定（名字、性格、说话风格），可按群名套用 |
memes.enabled | 表情包库；收哪张由 agent 自己决定，memes.maxSend 限一次最多发几张 |
imageGen.enabled | 让 agent 自己生图（默认关，填 model/baseUrl/apiKey 才开） |
code.scopes | 下游 bot 的源码目录。地址不写进 prompt，agent 需要时调 onebot_code_scopes 取位置，读文件用它自带的 read/grep |
memory.isolation.level | 记忆隔离：strict（跨会话一律不可见）/ scoped / balanced（默认） |
memory.peopleRoster | 上下文里【本群认识的人】最多列几个（默认 20，按最近露面排序；0＝整段不注入，细节仍可用 onebot_person 现查） |
agent.speakAssistantText | 默认 false：普通回复文本只是内部草稿，只有 onebot_reply 会真的发进聊天 |
retention.days | 原始报文与媒体保留天数（默认 7） |
agent.replyGapMs / agent.replyMaxText / agent.replyMaxImages | 一次回复发多条时的间隔（默认 400ms）、文字条数上限（默认 3，图另算）、图片上限（默认 9） |
只有 chatCommands.superUsers 里的账号能用（留空 = 整条命令链沉默）。别人敲同样的字，枢纽一声不吭——回一句"你没权限"等于告诉全群这里有个能管事的 bot。
下表省略前缀：前缀由 chatCommands.prefix 定（默认 /）。配成 ! 就敲 !help，配成 。 就敲 。help——命令名本身不变，前缀换成什么都能用。
| 命令 | 别名 | 作用 |
|---|---|---|
help | 帮助 ? | 列出这 12 条 |
status | 状态 | 链路、模式、时间线、运行时长、人设、表情包一屏概览 |
presets | preset 预设 | 列出可用人设预设（→ 表示本会话在用） |
set_preset <预设名> | set_presets 设置预设 | 把本会话切到某个预设 |
set_role <名字> <设定> | 设置角色 | 临时给本会话换个角色名和设定 |
preset_role <设定> | 设置设定 | 只改设定，不改角色名 |
memes ｜ memes del <id> | 表情包 meme | 看最近 10 个；del 删掉某个 |
reload_meme | 重载表情包 | 从磁盘重读一遍表情包索引 |
perm [预设名] | permission 权限 | 看 / 换本会话 agent 的权限预设（只管本次激活） |
model [provider/model｜编号｜default] | 模型 聊天模型 | 看 / 换本会话的聊天模型 |
vmodel [provider/model｜编号｜default] | 视觉模型 识图模型 | 看 / 换本会话的识图模型 |
reset | 重置 | 本会话的人设绑定与模型选择回初始（不动长期记忆） |
三条要知道的语义：
chatCommands.bypassPrefix（默认 !!），比如默认配置下敲 !!/help。你好 /status 是聊天，不是命令（默认前缀下）。回话超 chatCommands.maxReplyChars（默认 800 字）会截断。perm 改的是本次唤醒那个 agent 会话的权限，下一次唤醒自动回部署默认——一次授权一次用。
@、被引用、或者私聊发消息时才会醒；激活一会儿没人理就自己睡回去。onebot_reply 才会发。判断不该说话时它可以不调（沉默是正常手段）。onebot_reply 的文字里空行断条、每张图各成一条、连续的 @ 与文字合成一条；超过上限的部分会被如实告知。balanced：同群可见，私聊内容不进群上下文）。perm（前缀见上面那节）改的是本次激活那个 agent 会话的权限；下一次唤醒是全新会话、自动回到部署默认——一次授权一次用。权限不够时它会在群里说清缺什么、要它干什么，请超管敲一条命令授权，而不是绕路或假装能做。| 用途 | 工具 |
|---|---|
| 发言 | onebot_reply（发消息，支持多条 / 图片 / 表情 / 引用） |
| 看链路与消息 | onebot_hub_status onebot_timeline onebot_turns onebot_raw onebot_capture onebot_context |
| 人与群 | onebot_profile onebot_group onebot_members onebot_avatar onebot_sessions onebot_recall |
| 记忆 | onebot_memory onebot_person onebot_topic onebot_memory_audit |
| 控制下游 | onebot_invoke onebot_relay_probe onebot_capabilities onebot_code_scopes |
| 协议与能力 | onebot_call onebot_caps onebot_admin onebot_media onebot_imagegen onebot_memes |
| 其它 | onebot_tools（按需取回 DSH 的其它工具） |
插件起不来（设置页一直转圈、链路不连）先看 <storageDir>/startup.log，里面有逐阶段标记与失败堆栈；默认 <storageDir> 是 ~/.dsh/onebot-hub。
跑起来之后，状态、时间线、下游做了什么，用 onebot_hub_status / onebot_timeline / onebot_turns 查；原始报文与图片用 onebot_raw 取。
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；CI 与发布流程、示例值约定记在 design-notes 里。