mario841859784/dsh-onebot
QQ channel plug-in (OneBot 11 / NapCat): reverse/forward WS, dm/group chat access policy and @ gate control, inbound picture/voice/video/file parsing + whisper transliteration, t2i text image card, slash command, loop merge forwarding + withdrawal (99 tests are all green, real QQ link measured)
dsh-onebot adds a QQ channel to DeepSeek Harness using the OneBot 11 protocol. One agent handles each chat; the bridge supports reverse WebSocket (NapCat ws-reverse dials in, default port 8643) or forward WebSocket (plugin dials out). Inbound: CQ segment-array parsing, CQ unescaping, @/reply trigger detection, images resolved from four sources with auto-shrink, files via dual channel, face/card/poke segment types, quoted messages auto-fetched, merged forwards auto-expanded. Voice: ffmpeg to 16kHz WAV plus whisper transcription (non-blocking; voice enters as a [语音] placeholder immediately, transcript follows asynchronously). Outbound: single send or text-to-image card renderer (@napi-rs/canvas: headings, bold, italic, lists, code blocks, tables, CJK punctuation) and [[qq_forward]] image/voice/video/file tools.
Install
dsh plugin --profile web add dsh-onebot-qqThe README states prerequisites: dsh (>=0.1.5-rc.1) on PATH and NapCat or another OneBot 11 implementation running. The npm package dsh-onebot-qq 0.5.1 was re-verified live on 2026-10-01 with its repository field back-linking to mario841859784/dsh-onebot (MIT). After installing, follow the README's workspace.yaml configuration step and configure the bridge settings.
Compatibility
DeepSeek Harness >= 0.1.5-rc.1 on PATH; requires NapCat / Lagrange / LLOneBot / go-cqhttp as the OneBot 11 implementation. Pure TypeScript, a native Cordis plugin, zero Python dependency.
Details
- Repo: mario841859784/dsh-onebot
- Category: Coding & Development
- Stars: 0
- Version: npm dsh-onebot-qq 0.5.1 (registry re-verified 2026-10-01); MIT
- Last push: 2026-08-18
- First seen: 2026-08-14
Recent updates
The README documents the full architecture diagram (Mermaid + interactive HTML), the feature table (connection, inbound, voice, text-to-image, outbound), and a configuration section. The text-to-image renderer matches the Hermes original (800px, 26px, right-margin rules, etc.).
FAQ
- How do I install the QQ bridge?
- dsh plugin --profile web add dsh-onebot-qq (npm 0.5.1 re-verified 2026-10-01); also set up NapCat or another OneBot 11 implementation and follow the README's workspace.yaml configuration.
- Does it require Python?
- No — the README says zero Python, pure TypeScript, a native Cordis plugin.
- How does voice transcription work?
- Non-blocking: the voice message enters the turn immediately as a [语音] placeholder; the transcript follows as a supplement when ffmpeg + whisper finish (default timeout 60s).
Alternatives
LeslieWylie/dsh-fleet-audit · Mombrane/dsh-subagent-monitor · SnowfallC/dsh-mobile-voice-call