dsh-1bot
把 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-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
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 | 聊天工作区根；每聊天一个 <root>/chats/<sessionId> 子目录（自动创建）。稳定路径，勿用随启动目录变化的路径，否则会话 cwd 冲突 |
connect_retries | 5 | 启动连接失败后的重试次数（每次间隔 connect_retry_delay_secs） |
connect_retry_delay_secs | 1 | 启动连接重试间隔（秒） |
reply_chunk_size | 4000 | 出站消息分块上限 |
approval_timeout_secs | 300 | QQ 内审批超时（秒） |
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 层）。 非白名单出站走 QQ 内审批：聊天里回复「同意」/「拒绝」（可带序号）裁决，超时/断连 fail-closed。
行为要点
- 入站非文本段渲染为
[image msg id:N]占位符，模型用onebot_get_content/onebot_voice_text取内容。 - 每聊天一个 agent/session（
onebot-private-<QQ>/onebot-group-<群号>，用-分隔避免磁盘转义），JSONL 持久化、可 resume；每聊天一个独立工作区<workspace_root>/chats/<sessionId>。 - 白名单为空 = 所有消息被忽略（启动时控制台会警告）。
- 日志形如
[onebot info] 2026-…；连不上 NapCat 会看到reconnecting重连循环。 - 启动连不上 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 进程控制台日志。
开发
pnpm install # 依赖（typescript / @types/node / @types/ws）
pnpm build # src/*.ts → lib/*.js（profile 加载编译产物，改源码后必跑）
pnpm typecheck # src + test 类型检查
pnpm test # 23 个单测（Node ≥23.6 原生跑 .ts）License
Apache-2.0（移植自 nota）。