← 返回列表
✓ 可直接安装
把 OneBot 11QQ,NapCat / LLOneBot / Lagrange变成 dsh 的一个 UI 表面…
自动检查通过:npm 包已发布且 engines 声明满足基线(声明 Node >=20);该结论来自程序自动检查,未经人工实机验证。 · 最近上游提交 2026/9/17 · 已提供中文文档
综合分
31.2
GitHub 分
31.2
用户评分
—
★ Stars
2
周下载量
—
安装插件(需先安装 dsh CLI 引擎:npm install -g @deepseek-ai/dsh)
dsh plugin --profile web add dsh-1botnpm 包 dsh-1bot 已校验归属本仓库,走 npm 安装最省事
信任档位:已验证本站已于 3 天前真实安装成功(L4 · 真实安装)
- 是什么
- dsh 原生插件 · chat
- 装得上吗
- 本站已真实安装成功(L4 · 真实安装,非静态推断)
- 安全吗
- 本站尚未对该插件做风险分级(暂未覆盖,不等同于无风险)
- 还在维护吗
- 活跃:最近一次提交在 8 天前
档位由下列信号合成:本站实装验证(真实安装,当前最高到 L4)· 验证所用 dsh 版本 · 静态安装检查 · 风险分级 · 仓库维护状态。下方各区块是它的证据明细。 验证判据与等级说明 →
🟢实装验证通过· 2026/9/23
由本站实装验证器在真实 dsh 环境安装成功,非静态推断。
数据截至 2026/9/21(元数据每日更新 · 实装验证按队列轮转,单条结论的验证时间见上方)
安装兼容性检查✓ 自动检查通过
以下结论由程序自动检查 npm 包、engines 声明与入口文件得出,未做人工实机验证——能装不等于用着没问题。
✓npm 包dsh-1bot @ 0.1.1
✓Node 引擎要求 >=20 · 基线 Node 22.19 满足
✓dsh CLI 依赖未声明 dsh 版本约束
✓入口文件main/exports/bin 已声明
验证方式:npm registry 存在性 + package.json 静态校验 · 最后验证 2026/9/21 09:00:38
依赖的 DSH / Cordis 模块
@deepseek-ai/schemastery@deepseek-ai/cordis@deepseek-ai/dsh-agent@deepseek-ai/dsh-agent-default-model@deepseek-ai/dsh-llm@deepseek-ai/dsh-session@deepseek-ai/dsh-tools@deepseek-ai/dsh-user-approval用户评分
还没有人投票,来当第一个
订阅周报,不错过优质插件更新
每周一封 · 高评分插件 + 新用户活动
README
由 DeepSeek 最新模型翻译生成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 | 聊天工作区根;每聊天一个 /chats/ 子目录(自动创建)。稳定路径,勿用随启动目录变化的路径,否则会话 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 内审批流已移除,白名单外一律直接拒绝。 行为要点 - 入站非文本段按类型渲染(默认 [ msg id:N k=v …],带上全部 data 和消息 id),模型用 onebot_get_content / onebot_voice_text 取内容。 - 每聊天一个 agent/session(onebot-private- / onebot-group-,用 - 分隔避免磁盘转义),JSONL 持久化、可 resume;每聊天一个独立工作区 /chats/。 - 白名单为空 = 所有消息被忽略(启动时控制台会警告)。 - 日志形如 [onebot info] 2026-…;掉线会看到 reconnecting 重试日志——连接断开后按 connect_retries 有界重试,耗尽后停止(重新可用需重启进程)。 - 首次启动若配置里没有 onebot 配置:自动在 $DSH_HOME/profiles/onebot/cordis.patch.yml 追加带注释的配置模板并提示你编辑,然后退出;编辑好再启动。 - 启动连不上 OneBot 是致命的:重试 connect_retries 次(默认 5 次 × 1 秒)后报错退出,并打印一条自足诊断:失败原因、实际尝试的 ws_url、access_token 是否设置、解析后的配置文件路径、重试预算,以及实测 TCP 可达性给出的下一步(端口没人监听 → 启动实现端;端口通却被拒 → 核对令牌/路径)。此路径不写配置文件(唯一写配置的是首次运行的模板门);改完运行 dsh --profile onebot。 - 单实例:第二个 dsh-1bot 进程会因锁(/.onebot.lock)拒绝启动 —— 两个实例同时写同一会话会损坏日志。 - 会话与 web 隔离:onebot 会话持久化在 $DSH_HOME/sessions-hidden(非 sessions/)。web UI 打开它可见的会话会 resume 成第二个写入者导致日志损坏,隔离后 web 看不到也碰不到;监视请用 onebot 进程控制台日志。 开发与贡献 开发者/贡献者请看 CONTRIBUTING.md:仓库结构、构建/测试命令、 发布流程、硬性规范(含改工具/模型后常见的 session … (id collision) 报错与处理)、 事件流与移植来源。 License Apache-2.0(逻辑移植自 nota 项目)。