dsh-connect-web

Usage

Automatic Mirroring (Default)

No setup required! Every Feishu conversation automatically gets a Web mirror:

1. Start chatting with the bot in Feishu
2. Open DSH Web GUI at http://127.0.0.1:3080
3. The conversation appears automatically ✨

The mirror is created when:

• A new session is started
• An existing session is resumed

Manual Mirror Control (Optional)

The /mirror command is still available for viewing status:

/mirror

This shows:

• Current mirror session ID
• Lock owner and timeout
• Queued message count

Viewing Mirrors in Web GUI

Once a conversation starts in Feishu:

1. Open DSH Web GUI at http://127.0.0.1:3080
2. The mirrored session appears automatically
3. You can view the full conversation history
4. Send messages (subject to lock ownership)

Session Locking

To prevent conflicts when both Feishu and Web are active:

• Lock Owner: Only the lock owner can send messages that trigger agent execution
• Read-Only Mode: Non-owner can view but messages are queued
• Timeout: Locks auto-release after 5 minutes of inactivity
• Manual Release: Use /unlock in Feishu to release the lock early

Commands

From Feishu:

• /mirror - Create or show Web mirror status
• /unlock - Manually release the session lock

From Web GUI:

• Messages are automatically queued if lock is held by Feishu
• Queue is processed when lock is released

Configuration

Option	Type	Default	Description
pollIntervalMs	number	1000	Polling interval for mirror detection (ms)

High CPU usage

Reduce polling frequency:

plugins:
  connect-web:
    pollIntervalMs: 5000  # Poll every 5 seconds