dsh-onebot-genji
Manifest validBridges QQ (OneBot 11) into DeepSeek Harness with in-chat tools and rich media, and ships its own speech-to-text bridge so voice messages transcribe without a whisper CLI.
dsh-onebot-genji
把 QQ 接入 DeepSeek Harness 的通道插件(OneBot 11),从 dsh-onebot-qq@0.11.0 分叉而来。
本分叉由 InsaneGenji 维护,在上游基础上加自己需要的东西;想装上游原版请去 https://github.com/mario841859784/dsh-onebot ,上游完整文档见 README.upstream.md。
安装与配置
与原版完全一致,见 README.upstream.md。
和原版(dsh-onebot-qq)的区别
只列本分叉新加的功能;安装、配置、连接 NapCat 的方式跟原版完全一致,见 README.upstream.md。
| 功能 | 说明 |
|---|---|
| 表情包库 | 一套完整的表情包管理:新图自动收进「未审核」,审核时才让模型看图写描述和标签,不点不跑、不占显存;已审核的图可一键「重新识别」重跑识别,描述和标签点一下就能改 |
| 主动搭话 | 内置在插件里(lib/proactive.js),按空闲时长、间隔、每日上限、安静时段自己找话题,聊完还能补一句;开关和阈值全在设置页「行为 → 私聊」,生成走当前会话模型 |
| 回合形式掷骰 | 每个回合按概率决定这一轮用文字、语音条还是表情包;语音/表情的开关与概率都是设置项(默认 10% / 39%) |
| 气泡切分与双发闸 | 正文按换行 / 句末标点自动切成最多 4 条气泡,条与条之间 0.8–1.5 秒随机停顿;qq_send_text 这一轮发过话,回合末正文就不再发(要补内容就再调一次工具,别指望正文兜底) |
| 群聊上下文 | 被 @ 或叫到唤醒词时,自动带上群里最近 N 条消息(「参考上下文条数」,默认 3,0 = 不带),被门控挡下的消息不会丢 |
| 自带语音转写桥 | lib/stt_cli.py 打进包里,sttEngine: auto 探不到 whisper 时自动用它(只要 Python + faster-whisper),不用自己配脚本 |
| 设置页重做 | 中文标签 + 分组分区(连接 / 权限 / 行为 / 表情包 / 会话 / 媒体 / 诊断),数字项统一「≥0 的整数」校验,用不到的项(旁观、强制会话 ID、新会话智能体预设等)已隐藏 |
表情包管理
设置 → 插件 → QQ Bot → 「表情包」页签。库根目录默认在插件自己的 stickers\ 下,只分「已审核」和「未审核」两个子目录——聊天只从「已审核」里挑图。

- 自动收集:开着时每 5 分钟扫一遍
~/.dsh/media/onebot,按内容去重后把新图收进「未审核」,不会直接进聊天;删过的图不会被自动收回来(除非你手动新增)。 - 新增:点「新增」挑图,或者直接把图片拖进面板——选择器弹不出来时拖拽照走同一条路。
- 审核:点「审核」由宿主模型(当前会话模型)看图写一句描述 + 3~6 个中文标签,然后把文件搬进「已审核」。「审核全部」一次处理整批。识别失败的原因会写进
~/.dsh/onebot-stickers.log的sticker warn行,面板报no-result时去那里看。 - 重新识别:已审核的图每张下面有「重新识别」,重跑一遍识别并覆盖原有描述和标签,用来纠正老条目或者换了模型之后统一刷新。
- 改描述 / 标签:把鼠标移到描述或标签那一行,右端出现铅笔,点开变输入框,回车保存。两行高度固定,长的自动省略。未审核的图不给改——审核时会自己识别一遍。
- 看图 / 删除:点缩略图看原图(走 DSH 自己的大图查看器);「删除」会在索引里留一条墓碑,之后这张图不会再被自动收集。
- 索引自愈:打开面板时会先对一遍索引和磁盘,文件没了的条目直接摘掉(显示「文件丢失」而不是一直转圈)。一次发现一半以上都读不到时按「库目录整体不可用」处理、索引原样保留——免得盘符没挂上就把 188 条清空。
语音转写(插件自带的桥)
入站语音(QQ 的 SILK,或普通音频)先转成 16 kHz 单声道 WAV,再交给转写引擎。引擎按设置里的 sttEngine 选:
auto(默认):先找 PATH 上的whisper-cli/whisper/mlx_whisper;一个都没有就用插件自带的桥——lib/stt_cli.py+ PATH 上的python/python3/py。装完插件不需要另外准备脚本。custom:用sttCommand+sttArgs自己指定;这两项留空同样回落到自带的lib/stt_cli.py(内置参数模板是{file} {out} --model <模型>)。openai/whisper-cpp:调用同名 CLI,需要自己装。
自带桥只依赖一个 Python 包:
pip install faster-whisper # 首次运行会自动下载模型(small 约 480 MB)
PATH 上既没有 whisper 可执行文件、也没有可用的 Python 时,语音消息降级成 [语音] 占位,其它功能不受影响。
自带桥认这几个环境变量:DS_STT_SERVER(常驻转写服务地址,默认 http://127.0.0.1:9891/transcribe,设成空串则禁用)、DS_STT_MODEL(默认 small)、DS_STT_CACHE(模型缓存目录)、DS_STT_LANG(默认 zh)。
开发
源码在 src/,lib/ 是编译产物(tsc 的 outDir)。改完 src 要重新编译,lib 不手改。
pnpm build # ./scripts/build.sh
pnpm test # vitest
改到设置面板(src/client.ts)时另外跑一遍 startup\settings-*.mjs 那组校验脚本。
许可证
BSD-3-Clause,版权归原作者所有,见 LICENSE。
Versions
| Latest version | Published | Size |
|---|---|---|
| 0.12.0 | — | — |
| 0.15.2 | — | — |
Comments
Loading…
Similar plugins
by cheems135
QQ (NapCat / OneBot 11) bridge for DeepSeek Harness - chat with your harness from QQ, with a full management panel
★ 9
↓ 140/wk
MIT
JavaScript
Nov 20, 2026
dsh plugin --profile web add dsh-im-bridgeby Yuuyuko-uu
通到 QQ:DSH 里的 AI 伙伴和 QQ 双向互通 —— 它说完话自动发到 QQ,你在 QQ 说的话自动转进 DSH(走 OneBot 11 HTTP,NapCat / SnowLuma 都行)
★ 149
↓ 347/wk
MIT
JavaScript
Oct 31, 2026
dsh plugin --profile web add dsh-qq-bridgeby Yuuyuko-uu
通到 QQ:DSH 里的 AI 伙伴和 QQ 双向互通 —— 它说完话自动发到 QQ,你在 QQ 说的话自动转进 DSH(走 OneBot 11 HTTP,NapCat / SnowLuma 都行)
★ 184
↓ 3.4k/wk
NOASSERTION
JavaScript
Nov 20, 2026
dsh plugin --profile web add dsh-qq-linkby mario841859784
QQ channel for dsh via OneBot 11 (NapCat and friends): reverse or forward WebSocket, DM and group chats, image and voice transcription, t2i text-image cards, merged forwards, and a settings page.
★ 23
BSD-3-Clause
TypeScript
Nov 16, 2026
dsh plugin --profile web add @dsh-external/dsh-onebotConnects QQ private chats and groups to DSH over OneBot 11, adding qq_send and other tools so the agent can reply, send stickers and wait for follow-ups.
★ 0
dsh plugin --profile web add dsh-onebot-channelby Funny1Potato
OneBot v11 hub for DeepSeek Harness: relays QQ events verbatim to downstream bots while giving the agent a full timeline, action ledger and 28 onebot_* tools.
★ 3
MIT
JavaScript
Oct 28, 2026
dsh plugin --profile web add dsh-onebot-hub