dsh-onebot
OneBot 11 as a dsh UI surface: forward WebSocket protocol client, chat ⇄ agent bridge, and OneBot tools (a profile bundle over dsh-base)
安装
npx -p @deepseek-ai/dsh dsh plugin --profile web add github:yuyi2439/dsh-onebot说明文档
阅读完整 README ↗dsh-onebot
把 OneBot 11(QQ,NapCat / LLOneBot / Lagrange)变成 dsh 的一个 UI 表面 —— 与 web / tui
平级的 profile bundle,骑在 @deepseek-ai/dsh-base 之上。每个 QQ 聊天(私聊/群)对应一个
dsh agent + session:消息进来驱动回合,最终回复自动发回 QQ。
逻辑移植自本地 nota 项目的 nota-onebot crate(Apache-2.0)。
快速开始
dsh plugin --profile onebot add dsh-onebot # 初始化 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
approval_timeout_secs: 300
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 | "" | 可选令牌(Authorization: Bearer) |
prefix | "" | 只回复以它开头的消息,并剥掉前缀 |
friend_ids | [] | 私聊白名单;空 = 无人可入 |
group_ids | [] | 群白名单;空 = 无群可入 |
workspace_root | $DSH_HOME/workspaces/onebot | 聊天工作区根;每聊天一个 /chats/ 子目录(自动创建)。稳定路径,勿用随启动目录变化的路径,否则会话 cwd 冲突 |
reply_chunk_size | 4000 | 出站消息分块上限 |
approval_timeout_secs | 300 | QQ 内审批超时(秒) |
console_log | true | 把 onebot 日志打到控制台 |