dsh-onebot-genji
insanegenji/dsh-onebot-genji
把 QQ(OneBot 11)接进 DeepSeek Harness,带群聊工具与富媒体发送,并自带语音转写桥——没装 whisper CLI 也能把收进来的语音转成文字。
安装
dsh plugin --profile web add github:insanegenji/dsh-onebot-genjiREADME
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。