🎁 福利专区全网大模型免费应用 + 新用户福利 + 注册活动入口,低成本玩转 AI
广告☁️ 云服务器特惠阿里云首购 8 折 · 腾讯云合作特惠
DeepSeek Harness Hub
← 返回列表

Hoshino-Yumetsuki/dsh-onebot

DeepSeek Harnessspec-screened扫描:未发现敏感能力在 GitHub 查看 ↗
✓ 可直接安装

DeepSeek HarnessDSH的 OneBot v11 适配器,支持 HTTP、正向和反向 WebSocket

自动检查通过:npm 包已发布且 engines 声明满足基线;该结论来自程序自动检查,未经人工实机验证。 · 最近上游提交 2026/8/29 · 已提供中文文档

DSH 的 OneBot 适配器

综合分
29.9
GitHub 分
29.9
用户评分
—
★ Stars
3
周下载量
—
安装插件(需先安装 dsh CLI 引擎:npm install -g @deepseek-ai/dsh)
dsh plugin --profile web add dsh-onebot
npm 包 dsh-onebot 已校验归属本仓库,走 npm 安装最省事
信任档位:已验证本站已于 1 天前真实安装成功(L4 · 真实安装)
是什么
dsh 原生插件 · chat
装得上吗
本站已真实安装成功(L4 · 真实安装,非静态推断)
安全吗
本站尚未对该插件做风险分级(暂未覆盖,不等同于无风险)
还在维护吗
活跃:最近一次提交在 27 天前

档位由下列信号合成:本站实装验证(真实安装,当前最高到 L4)· 验证所用 dsh 版本 · 静态安装检查 · 风险分级 · 仓库维护状态。下方各区块是它的证据明细。 验证判据与等级说明 →

🟢实装验证通过· 2026/9/24
由本站实装验证器在真实 dsh 环境安装成功,非静态推断。
数据截至 2026/9/20(元数据每日更新 · 实装验证按队列轮转,单条结论的验证时间见上方)
安装兼容性检查✓ 自动检查通过

以下结论由程序自动检查 npm 包、engines 声明与入口文件得出,未做人工实机验证——能装不等于用着没问题。

✓npm 包dsh-onebot @ 1.3.0
✓Node 引擎未声明 engines.node
✓dsh CLI 依赖未声明 dsh 版本约束
✓入口文件main/exports/bin 已声明

验证方式:npm registry 存在性 + package.json 静态校验 · 最后验证 2026/9/21 23:45:31

依赖的 DSH / Cordis 模块
@deepseek-ai/schemastery@deepseek-ai/cordis@deepseek-ai/dsh-agent@deepseek-ai/dsh-agent-default-model@deepseek-ai/dsh-attachment@deepseek-ai/dsh-brand@deepseek-ai/dsh-code-runtime@deepseek-ai/dsh-credentials@deepseek-ai/dsh-invariants@deepseek-ai/dsh-llm@deepseek-ai/dsh-scope@deepseek-ai/dsh-session
用户评分
还没有人投票,来当第一个
订阅周报,不错过优质插件更新
每周一封 · 高评分插件 + 新用户活动

README

由 DeepSeek 最新模型翻译生成
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)的其他插件

💬 加入社群

插件用法、部署报错、新插件第一时间同步——群里问,比一个人翻文档快。

DPharness QQ 群二维码,QQ 扫码进群
QQ 扫码进群
DPharness 飞书群二维码,飞书扫码进群
飞书扫码进群