DeepSeek Harness (DSH) 采用插件化架构。在使用 dsh-wechat 组件进行消息发送时，微信登录会话有时会因腾讯 iLink 协议限制而失效。失效后，系统通常只会在日志中记录，不会主动通知用户，导致已排队的消息被静默丢弃。dsh-wechat-status 插件用于解决这个问题。
功能说明¶
这是一个为 DSH 设计的微信登录状态监控插件。它通过 Host 侧和 Client 侧的配合，将原本不可见的会话异常转化为 Web 界面的视觉提示。
核心能力¶
- Host 侧轮询：Host 侧每 15 秒读取
dsh-wechat的状态接口，将状态归约为四个标量。 - Client 侧展示：Client 侧在界面底部居中渲染横幅，提示当前状态。
- 零干扰模式：当登录状态正常时，插件不进行任何渲染，不占用界面空间。
- 一键重连：横幅提供「打开二维码」链接，无需手动查找设置页。
- 优雅降级：针对 HTTP 404、接口报错、响应非法 JSON 或连接超时等情况，插件会退化为可见状态而非抛出异常，保证界面可用。
状态与表现¶
插件根据 dsh-wechat 的状态改变 Web 界面的显示内容：
| 微信状态 | 界面表现 |
|---|---|
logged-in 在线 |
不显示（正常态零干扰） |
waiting-qr 待扫码 |
琥珀色横幅「等待扫码登录」＋「打开二维码」 |
failed 掉线需重扫 |
红色横幅「微信已掉线，需要重新扫码」＋「打开二维码」 |
| 插件未加载 (404) | 红色横幅「微信插件未加载」 |
| 状态不可读 | 不显示（避免误报） |
安装与启用¶
前置依赖¶
在安装本插件前，必须先安装并登录 dsh-wechat 组件。本插件仅读取状态，不修改其行为。
# 安装 dsh-wechat
npx @deepseek-ai/dsh plugin --profile <profile> add dsh-wechat
# 重启后访问 http://127.0.0.1:3080/wechat/qr 扫码登录
安装插件¶
通过 npm 官方仓库安装插件：
npx @deepseek-ai/dsh plugin --profile <profile> add github:alk233/dsh-wechat-status
验证配置¶
安装完成后，重启 DSH，并通过命令验证配置是否生效：
npx @deepseek-ai/dsh --profile <profile> --dump-config
检查输出中是否包含 - id: dsh-wechat-status 字段。
注意事项¶
- 代码来源：本插件代码由 AI 生成，未经专业软件工程师人工审查，可能存在逻辑缺陷或安全漏洞。
- 官方关系：本插件与 DeepSeek、腾讯及微信无任何隶属或背书关系。
- 使用风险：本项目按 “AS IS” 提供，仅供个人学习、技术研究与交流。使用者需自行承担因违规使用（如违反腾讯服务条款）或使用本插件导致的一切后果。
- 协议依赖：底层依赖腾讯 iLink（微信 ClawBot）协议，该接口可能随时变更或终止。
