DSH（DeepSeek Harness）的架构基于「一切皆插件」。要在 QQ 等平台跑智能体，需要专门的通道插件。dsh-onebot 提供了一个 OneBot 11 标准的客户端，直接连接现有的 QQ 机器人实现（如 go-cqhttp、NapCat 等），把消息转给 DSH 的 agent 处理。
是什么¶
这是一个给 DeepSeek Harness 的 QQ 通道插件。它遵循 OneBot 11 标准，作为客户端接入正向 WebSocket 服务，接收事件并通过 HTTP API 发送消息。每个会话对应一个 dsh agent。
- 维护者: JackZo400
- License: MIT
- Stars: 1
- 核心: 零依赖，仅使用 Node.js 内置模块（
fetch/WebSocket/node:crypto）。
核心功能¶
- 消息收发：支持群聊和私聊消息。
- 消息段支持：支持
text/at/image/record/reply/face段。 - 格式解析：同时支持 CQ 码字符串和 segment 数组解析。
- 会话管理：支持会话隔离（群号/私聊号作为 key），一条消息一条回复串行处理。
- 上下文与细节：支持引用展开（本地缓存 + API 兜底）、回声过滤、群成员名册、断线指数退避重连。
- 接口支持：支持
get_login_info、send_group_msg、send_private_msg、get_msg等接口。
安装与启用¶
在 DSH 的命令行中执行以下命令安装：
dsh plugin --profile web add github:JackZo400/dsh-onebot
安装完成后，需要在 cordis.patch.yml 中配置连接参数。配置项通常包括 WebSocket 地址、accessToken、群组白名单、私聊开关等。
典型用法¶
接入流程分为三步：
- 运行 OneBot 实现：在本地运行 OneBot 客户端（如 go-cqhttp、NapCat），并开启正向 WebSocket 服务。
- 配置连接：在配置文件中设置 WebSocket 地址、鉴权 Token 以及消息过滤规则（如仅处理被 @ 的消息）。
- 验证连接：重启 profile，检查日志中是否出现
[dsh-onebot] 已连上 OneBot 服务的字样。
已知局限¶
- 不支持反向连接：不支持反向 WebSocket 或 HTTP 事件上报。
- 媒体内容限制：图片/语音/视频内容在当前版本只显示占位符（如「（图）」），需配置
imageLinks: true开启直链功能。 - 不支持：合并转发聊天记录、流式/分段回复。
- 界面：无 UI，所有配置均在文件中完成。
