DeepSeek Harness (DSH) adopts a plugin-based architecture. When using the dsh-wechat component for message sending, the WeChat login session can occasionally become invalid due to Tencent iLink protocol restrictions. After expiration, the system usually only records the issue in logs without proactively notifying the user, causing queued messages to be silently dropped. The dsh-wechat-status plugin is designed to address this issue.

Feature Description

This is a WeChat login status monitoring plugin designed for DSH. By coordinating the Host side and Client side, it converts previously invisible session exceptions into visual cues in the Web interface.

Core Capabilities

  • Host-side polling: The Host side reads the status endpoint of dsh-wechat every 15 seconds and reduces the status to four scalar values.
  • Client-side display: The Client side renders a banner at the bottom center of the interface to indicate the current status.
  • Zero-interference mode: When the login status is normal, the plugin performs no rendering and does not occupy interface space.
  • One-click reconnection: The banner provides an “Open QR code” link, eliminating the need to manually locate the settings page.
  • Graceful degradation: For situations such as HTTP 404, API errors, invalid JSON responses, or connection timeouts, the plugin falls back to a visible state instead of throwing exceptions, ensuring the interface remains usable.

Status and Behavior

The plugin changes the Web interface display based on the status of dsh-wechat:

WeChat Status Interface Behavior
logged-in Online Not displayed (zero-interference in the normal state)
waiting-qr Waiting for QR scan Amber banner “Waiting for QR code login” + “Open QR code”
failed Disconnected, rescan required Red banner “WeChat is disconnected and requires rescanning” + “Open QR code”
Plugin not loaded (404) Red banner “WeChat plugin not loaded”
Status unreadable Not displayed (to avoid false positives)

Installation and Enablement

Prerequisites

Before installing this plugin, you must first install and log in to the dsh-wechat component. This plugin only reads status and does not modify its behavior.

# 安装 dsh-wechat
npx @deepseek-ai/dsh plugin --profile <profile> add dsh-wechat
# 重启后访问 http://127.0.0.1:3080/wechat/qr 扫码登录

Install the Plugin

Install the plugin from the official npm registry:

npx @deepseek-ai/dsh plugin --profile <profile> add github:alk233/dsh-wechat-status

Verify Configuration

After installation, restart DSH and use the command to verify whether the configuration has taken effect:

npx @deepseek-ai/dsh --profile <profile> --dump-config

Check whether the output contains the - id: dsh-wechat-status field.

Notes

  • Code Source: The code for this plugin was generated by AI and has not been manually reviewed by a professional software engineer; it may contain logic defects or security vulnerabilities.
  • Official Relationships: This plugin has no affiliation or endorsement relationship with DeepSeek, Tencent, or WeChat.
  • Usage Risk: This project is provided “AS IS” and is intended solely for personal learning, technical research, and discussion. Users are responsible for all consequences arising from improper use (such as violating Tencent’s terms of service) or the use of this plugin.
  • Protocol Dependency: It depends on the underlying Tencent iLink (WeChat ClawBot) protocol, which may change or terminate at any time.

Ecosystem Position