Hoshino-Yumetsuki/dsh-onebot

Name: Hoshino-Yumetsuki/dsh-onebot
Author: Hoshino-Yumetsuki

Plugin插件 Native原生 ⭐ 3 MPL-2.0 Vision & Media视觉与多媒体 Data & Analysis数据与分析

DSH 的 OneBot 适配器

Project Overview项目介绍

Edited by Zhiwei Agent (zhiwei)由知微Agent(zhiwei)编辑

dsh-onebot is a OneBot v11 adapter for DSH offering three transports: forward WebSocket, reverse WebSocket, and HTTP. It parses the four standard post_type events but only message events trigger an Agent session. Access control combines private/group toggles, user and group allow/block lists, mention requirements, and an optional command prefix. Replies are taken from the last onebot_reply call per turn and sent as one text or image message after the Agent goes idle. Only public http(s) URLs and typed data: URLs are accepted for inbound images, and non-loopback listeners require valid credentials.

dsh-onebot 是 DSH 的 OneBot v11 适配器，提供正向 WebSocket、反向 WebSocket 与 HTTP 三种传输，统一解析 message、notice、request、meta_event 四类事件，仅 message 触发 Agent 会话。支持私聊/群聊开关、用户与群黑白名单、提及与命令前缀过滤，回复以最后一次 onebot_reply 为准并仅在 idle 后发送一次文本或图片。仅接受公网 http(s) 或带媒体类型 data: 图片，监听非回环地址需提供凭据。

View on GitHub在 GitHub 查看

Send to your DSH发给你的 DSH 安装

请帮我了解并安装插件：【dsh-onebot】【https://github.com/Hoshino-Yumetsuki/dsh-onebot】

Send this message to DSH in your current session. CLI install commands may not be accurate across systems — DSH will figure it out for you.把上面这条消息直接发给当前会话里的 DSH，让它帮你了解并安装。安装命令不一定准确，发给 DSH 更稳。

Or use CLI install (for developers)或使用命令行安装（适合开发者）

CLI Install命令行安装

dsh plugin --profile web add dsh-onebot

把 Hoshino-Yumetsuki/dsh-onebot 加入你的 DSH 配置（web profile）即可启用。

READMEREADME

4.5 KB · 缓存于 2026-08-23 03:42:17 · 4.5 KB

dsh-onebot

DeepSeek Harness（DSH）的 OneBot v11 适配器，支持 HTTP、正向和反向 WebSocket

Transport

forward-ws（默认）：连接 OneBot 正向 WebSocket，事件和 action 共用连接
reverse-ws：监听 WebSocket，等待 OneBot 反向连接
http：以 url 调用标准 HTTP API，同时在配置的监听地址提供 HTTP POST webhook

四种标准 post_type 是 message、notice、request、meta_event；只有 message 创建 Agent 交互。传输层接受并解析四种标准 post_type；只有 message 事件进入 Agent，其余事件不创建会话或回复。

安装

dsh plugin --profile web add dsh-onebot

配置

字段	默认值	说明
`transport`	`forward-ws`	`forward-ws`、`reverse-ws` 或 `http`
`url`	`ws://127.0.0.1:3001`	正向 WS 地址或 HTTP API base URL
`listenHost`	`127.0.0.1`	反向 WS / webhook 监听地址
`listenPort`	`3002`	监听端口
`listenPath`	`/onebot`	监听路径
`accessTokenRef`	`ONEBOT_ACCESS_TOKEN`	访问令牌的 DSH credential ref
`webhookSecretRef`	`ONEBOT_WEBHOOK_SECRET`	webhook secret 的 DSH credential ref
`reconnectInterval`	`5000`	重连间隔（毫秒）
`requestTimeout`	`30000`	action 请求超时（毫秒）
`heartbeatTimeout`	`120000`	心跳超时（毫秒），`0` 禁用
`commandPrefix`	空	非空时要求此前缀，并从 prompt 移除
`respondToPrivate`	`true`	响应私聊
`respondToGroup`	`true`	响应群聊
`groupMentionOnly`	`true`	群聊要求提及机器人
`userAccessMode`	`disabled`	`disabled`、`allowlist`、`blocklist`
`userIds`	`[]`	用户 ID 列表
`groupAccessMode`	`disabled`	`disabled`、`allowlist`、`blocklist`
`groupIds`	`[]`	群 ID 列表

数组在设置 UI 中每行一个 ID，保存时去空白并且去重。token/secret 存入 DSH credentials，配置只保存引用名称。

- id: onebot
  name: dsh-onebot
  config:
    transport: forward-ws
    url: ws://127.0.0.1:3001
    listenHost: 127.0.0.1
    listenPort: 3002
    listenPath: /onebot
    accessTokenRef: ONEBOT_ACCESS_TOKEN
    webhookSecretRef: ONEBOT_WEBHOOK_SECRET
    reconnectInterval: 5000
    requestTimeout: 30000
    heartbeatTimeout: 120000
    commandPrefix: ''
    respondToPrivate: true
    respondToGroup: true
    groupMentionOnly: true
    userAccessMode: disabled
    userIds: []
    groupAccessMode: disabled
    groupIds: []

消息与回复

访问控制顺序为私聊/群聊开关、用户名单、群消息的群名单，最后是提及与前缀。ID 转为字符串后进行匹配；空 allowlist 拒绝全部会话，空 blocklist 允许全部会话
回复由会话作用域内的 onebot_reply 提交候选；同一轮多次调用时以后一次为准，仅在 Agent 本轮进入 idle 后向当前来源发送一次文本和/或图片。插件不暴露任意 OneBot action，也不会转发 agent loop 的中间助手文本
入站图片只接受公网 http(s) URL 或带媒体类型的 data: URL，限制重定向、总下载时间和字节数后经 DSH attachments 保存 durable ref；不读取 OneBot 机器本地路径，单独 base64:// 因缺少可信媒体类型而拒绝
reverse WebSocket / HTTP webhook 绑定非回环地址时，分别必须能解析访问令牌 / webhook 签名密钥，否则监听拒绝启动；WebSocket 与 webhook 入站负载上限均为 1 MiB
有 session persistence 时，先以 list() 精确判断存在再恢复会话，否则创建一个新会话；恢复会话错误时不会回退。OneBot API 无法删除 DSH 会话历史，历史需在 DSH 侧管理。

开发

yarn install
yarn lint
yarn build

许可证：MPL-2.0

渲染基于仓库 Hoshino-Yumetsuki/dsh-onebot 的 README.md。在 GitHub 查看原文 →

CLI Install命令行安装 Copy Install复制安装命令

READMEREADME

dsh-onebot

Transport

安装

配置

消息与回复

开发

Related相关推荐

CLI Install命令行安装