How sj244/dsh-qq-bridge works
dsh-qq-bridge connects one existing DSH session to QQ through a OneBot WebSocket client. Its main workflow receives and normalizes QQ events, applies whitelist and wake rules, then delivers eligible messages to the explicitly selected session; responses can pass a QQ-specific outbound gate and return to the originating destination. Separate capabilities include image caching and description, live settings, a browser settings card, and explicitly invoked NapCat setup. The README documents several behaviors whose internal call paths were not sampled, so those links cite the README rather than implying source inspection.
Main entry points: index.js Target DSH session · onebot.js WebSocket transport · napcat.js OneBot configuration · client.js Settings card
Components 19
Message bridge
- Event normalization
index.js - Wake policy
index.js - Recent chat buffer
index.js - Image cache and vision
index.js - WebSocket transport
onebot.js
Session interaction
- Target DSH session
index.js - Follow-up window tool
index.js - Outbound source gate
index.js - Reply formatting
index.js
Settings interface
- Settings API and storage
index.js - Settings card
client/client.js
NapCat management
- NapCat actions
index.js - Release download and verify
napcat.js - Safe ZIP extraction
napcat.js - OneBot configuration
napcat.js
Other components
- QQ participants
- OneBot server
- NapCat process
- Vision model
Connections 23
- QQ participants → OneBot server: sends events
README.md - OneBot server → WebSocket transport: delivers events
README.md - WebSocket transport → Event normalization: dispatches events
README.md - Event normalization → Wake policy: normalizes for
README.md - Wake policy → Target DSH session: delivers eligible messages
README.md - Wake policy → Recent chat buffer: records unwoken chat
README.md - Recent chat buffer → Target DSH session: adds recent context
README.md - Event normalization → Image cache and vision: caches images
README.md - Image cache and vision → Vision model: requests descriptions
README.md - Image cache and vision → Target DSH session: adds image descriptions
README.md - Target DSH session → Follow-up window tool: invokes listening tool
README.md - Target DSH session → Outbound source gate: emits session events
README.md - Outbound source gate → Reply formatting: permits QQ replies
README.md - Reply formatting → WebSocket transport: sends formatted replies
README.md - WebSocket transport → OneBot server: calls actions
README.md - Settings card → Settings API and storage: reads and saves
client/client.js - Settings API and storage → WebSocket transport: reconfigures connection
index.js - Target DSH session → NapCat actions: invokes management tool
README.md - NapCat actions → Release download and verify: downloads and verifies
index.js - NapCat actions → Safe ZIP extraction: extracts release
index.js - NapCat actions → OneBot configuration: writes connection config
index.js - NapCat actions → NapCat process: launches process
README.md - OneBot configuration → NapCat process: configures service
README.md