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）協議，該接口可能隨時變更或終止。
