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

yuyi2439/dsh-1bot

DeepSeek Harnessspec-screened扫描:中风险在 GitHub 查看 ↗
✓ 可直接安装

把 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-1bot
npm 包 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 项目)。

上游仓库有新提交时邮件通知你(每天最多一封,无更新不打扰),随时一键退订。

💬 加入社群

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

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