DSH Plugin HubDSH 插件市场

yuyi2439/dsh-1bot

Plugin插件 Native原生 ⭐ 2 Apache-2.0 Notifications & Remote通知与远程Sessions & Context会话与上下文

Project Overview项目介绍

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

dsh-1bot is a DSH profile bundle that turns OneBot 11 endpoints (NapCat, LLOneBot, Lagrange over QQ) into a first-class UI surface alongside web and tui, layered on dsh-base. Each private or group chat maps to its own agent and session, so inbound messages drive a turn and the final reply is sent back automatically. Use it when you want a QQ front-end for an existing DSH setup with friend and group whitelists plus inline approval for outbound messages to non-whitelisted targets. Caveat: it is single-instance, a second process is rejected by a lock file, and onebot sessions are isolated from the web UI to prevent log corruption.

dsh-1bot 是 dsh 的 OneBot 11 桥接 profile bundle，运行在 dsh-base 之上，把 QQ（NapCat / LLOneBot / Lagrange）作为与 web、tui 平级的 UI 表面。每个私聊或群聊映射为独立的 dsh agent 与 session，消息驱动回合后自动回发。当前聊天的回复会自动发出，模型无需再调 onebot_send；非白名单出站走 QQ 内审批，超时 fail-closed。需注意：单实例启动，二次启动会因锁文件被拒；onebot 会话被隔离，无法被 web UI 打开或恢复。

View on GitHub在 GitHub 查看

Recommended强烈推荐 Send to your DSH发给你的 DSH 安装 
请帮我了解并安装插件：【dsh-1bot】【https://github.com/yuyi2439/dsh-1bot】

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 onebot add dsh-1bot

把 yuyi2439/dsh-1bot 加入你的 DSH 配置（web profile）即可启用。

READMEREADME

5.1 KB · 缓存于 2026-09-06 19:41:40 · 5.1 KB

dsh-1bot

把 OneBot 11（QQ，NapCat / LLOneBot / Lagrange）变成 dsh 的一个 UI 表面 —— 与 web / tui 平级的 profile bundle，骑在 @deepseek-ai/dsh-base 之上。每个 QQ 聊天（私聊/群）对应一个 dsh agent + session：消息进来驱动回合；自动发送已移除——模型要说话必须显式 调用 onebot_send（每次调用立即发送），因为回合末自动投递会与模型主动发送 重复（双重回答）。

逻辑移植自 nota 项目（Rust）的 OneBot 桥接实现，Apache-2.0。

快速开始

dsh plugin --profile onebot add dsh-1bot     # 初始化 profile 并从 npm 安装

编辑 $DSH_HOME/profiles/onebot/cordis.patch.yml（id 定向 patch 整段替换 config，需重述所有字段）：

- id: onebot
  config:
    enabled: true
    mode: ws
    ws_url: 'ws://127.0.0.1:3001'   # NapCat 正向 WS 地址
    access_token: ''
    prefix: ''
    friend_ids: [123456789]          # 白名单：你的 QQ
    group_ids: []                    # 白名单：群
    reply_chunk_size: 4000
    max_pending_turns: 8
    console_log: true

启动（NapCat 需开着正向 WS）：

dsh --profile onebot

配置

字段 默认 说明
enabled false 启动桥接
mode ws 仅支持 ws（正向 WebSocket）
ws_url ws://127.0.0.1:3001 OneBot 实现地址
access_token "" 可选令牌，以 ?access_token= 查询参数附加到 ws_url（OneBot 11 正向 WS 约定）
prefix "" 只回复以它开头的消息，并剥掉前缀。群聊生产环境强烈建议设置：留空时白名单内的每条消息都会触发一次完整 agent 回合（成本），刷屏时还会把队列堆到上限
friend_ids [] 私聊白名单；空 = 无人可入
group_ids [] 群白名单；空 = 无群可入
workspace_root $DSH_HOME/workspaces/onebot 聊天工作区根；每聊天一个 <root>/chats/<sessionId> 子目录（自动创建）。稳定路径，勿用随启动目录变化的路径，否则会话 cwd 冲突
connect_retries 5 启动连接失败后的重试次数（每次间隔 connect_retry_delay_secs）
connect_retry_delay_secs 1 启动连接重试间隔（秒）
reply_chunk_size 4000 出站消息分块上限
reply_chunk_delay_ms 300 同一条回复的分块发送间隔（毫秒），避免多块连发触发 QQ 风控
max_pending_turns 8 每聊天排队回合上限（含正在运行的一个）；超出上限的新消息被丢弃并告警（刷屏防护）
console_log true 把 onebot 日志打到控制台

工具

onebot_send（唯一发送途径，即时发送，可多段：先回复、查资料、再回复）、onebot_get_msg_history（群/私聊历史）、onebot_get_content、onebot_status（含连接状态）、 onebot_voice_text。统一 onebot_ 前缀（send_message 是子 agent 控制的保留名）。 自动发送已移除：所有出站消息都由模型显式调用 onebot_send 发送；prompt/persona 注入不在本插件内（纯 adapter，由独立的 persona 层插件负责）。 非白名单目标的 onebot_send 直接报错——QQ 内审批流已移除，白名单外一律直接拒绝。

行为要点

  • 入站非文本段按类型渲染（默认 [<type> msg id:N k=v …]，带上全部 data 和消息 id），模型用 onebot_get_content / onebot_voice_text 取内容。
  • 每聊天一个 agent/session（onebot-private-<QQ> / onebot-group-<群号>，用 - 分隔避免磁盘转义），JSONL 持久化、可 resume；每聊天一个独立工作区 <workspace_root>/chats/<sessionId>。
  • 白名单为空 = 所有消息被忽略（启动时控制台会警告）。
  • 日志形如 [onebot info] 2026-…；掉线会看到 reconnecting 重试日志——连接断开后按 connect_retries 有界重试，耗尽后停止（重新可用需重启进程）。
  • 首次启动若配置里没有 onebot 配置：自动在 $DSH_HOME/profiles/onebot/cordis.patch.yml 追加带注释的配置模板并提示你编辑，然后退出；编辑好再启动。
  • 启动连不上 OneBot 是致命的：重试 connect_retries 次（默认 5 次 × 1 秒）后报错退出（此路径不写配置文件——唯一写配置的是首次运行的模板门），检查 ws_url/access_token 后重新启动。
  • 单实例：第二个 dsh-1bot 进程会因锁（<workspace_root>/.onebot.lock）拒绝启动 —— 两个实例同时写同一会话会损坏日志。
  • 会话与 web 隔离：onebot 会话持久化在 $DSH_HOME/sessions-hidden（非 sessions/）。web UI 打开它可见的会话会 resume 成第二个写入者导致日志损坏，隔离后 web 看不到也碰不到；监视请用 onebot 进程控制台日志。

开发与贡献

开发者/贡献者请看 CONTRIBUTING.md：仓库结构、构建/测试命令、 发布流程、硬性规范（含改工具/模型后常见的 session … (id collision) 报错与处理）、 事件流与移植来源。

License

Apache-2.0（逻辑移植自 nota 项目）。

渲染基于仓库 yuyi2439/dsh-1bot 的 README.md。 在 GitHub 查看原文 →

Related相关推荐

← 上一个 Prev dsh-skin 下一个 Next dsh-prompt-presets →