alk233/dsh-wechat-status

WeChat login watchdog for DSH: surfaces dsh-wechat session loss as a Web UI banner instead of silently dropping queued messages. AI-generated, educational use only.

Project Overview项目介绍

dsh-wechat-status is a native DeepSeek Harness (DSH) plugin that adds missing session expiration notifications for the dsh-wechat WeChat bridge plugin. When the WeChat bridge session becomes invalid and requires a user to re-scan the QR code to log in again, it displays a prominent banner on the DSH web interface instead of only recording the event in the server logs. The plugin is delivered as a static Cordis plugin with separate host and client components, and it requires no additional @deepseek-ai/* runtime dependencies to run.

On the host side, the plugin polls the status API provided by dsh-wechat every 15 seconds. It normalizes the raw status data into standardized parameters and returns it to the client side for rendering. On the client side, the plugin renders different banners based on the current WeChat connection status. If WeChat is logged in and working normally, the plugin renders nothing at all to avoid cluttering the interface. If the session is waiting for a QR scan, it shows an amber banner, and if the session has expired, it shows a red banner with a button that opens the QR scan page directly.

To use this plugin, you first need to install and log in to the dsh-wechat plugin on your DSH instance. You can install it directly from GitHub using DSH's official CLI tool with the command npx @deepseek-ai/dsh plugin --profile <profile> add github:alk233/dsh-wechat-status, then restart DSH to activate it. All code in this project is generated by AI, it is licensed under MIT, and it is intended only for personal learning and technical research purposes. Commercial use or violation of WeChat's terms of service is prohibited, and all usage risks are borne by the user.

这是一个专为 DeepSeek Harness(DSH)开发的原生插件,用来给 dsh-wechat 微信桥接插件补充掉线提醒功能。当微信桥接会话失效、需要用户重新扫码登录时,它会在 DSH Web 界面弹出醒目的状态横幅,提醒用户及时处理,不用用户自己去翻设置页查看状态。它以静态 Cordis 插件交付,分为 Host 和 Client 两个部分,没有额外的 @deepseek-ai/* 运行时依赖。

插件核心逻辑分为两部分,Host 侧每 15 秒读取 dsh-wechat 提供的状态接口,将状态归约为标准化参数返回给前端。Client 侧根据返回的状态渲染不同样式的横幅:微信正常在线时完全不渲染,不占用任何视觉空间;等待扫码时显示琥珀色横幅,掉线需要重扫时显示红色横幅,点击横幅按钮可直接打开扫码页面。

使用本插件需要先安装并登录 dsh-wechat 插件,可以通过 DSH 的官方 CLI 工具从 GitHub 直接安装,重启 DSH 后即可生效。本项目全部代码由 AI 生成,采用 MIT 许可证,仅供个人学习和技术研究使用,禁止商业用途或违规使用,使用风险由用户自行承担,底层依赖腾讯 iLink 协议,接口可能随时变更。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 warning1 项注意
  • Only 2 stars - very few users, little community feedback星标只有 2,几乎没人在用,遇到问题缺少社区反馈
DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

  • DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
  • External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时(Electron / Python / Docker 等)是否齐备
  • Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突:命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

  • Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致,是否归档或长期停更
  • Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
  • curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
  • Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
  • Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需(filesystem / network / shell / clipboard)
  • Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限,以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照,不能替代安全审计。

Or use CLI install (for developers)或使用命令行安装(适合开发者)

CLI Install命令行安装

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

把 alk233/dsh-wechat-status 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

dsh-wechat-status

License DSH platform

为 dsh-wechat 补上缺失的掉线提醒:微信桥接 会话失效、需要重新扫码时,在 DSH Web 界面弹出醒目横幅——而不是让你自己翻设置页, 或者发现消息石沉大海才知道。

以静态 Cordis 插件交付,Host + Client 双半,零 @deepseek-ai/* 运行时依赖。


⚠️ 重要声明

请在使用前完整阅读本节。

全程由 AI 编写

本项目的全部代码、文档与测试均由 AI 生成,未经专业软件工程师人工审查。 AI 生成内容可能包含逻辑缺陷、安全漏洞、平台兼容性问题或与事实不符的描述, 即使作者已尽力验证,仍可能存在未被发现的错误。

按「现状」提供,不承担任何责任

本项目按 "AS IS" 提供,不作任何明示或暗示的担保,包括但不限于对 适销性、特定用途适用性、无侵权的担保。

在适用法律允许的最大范围内,作者及任何贡献者不对因使用或无法使用本项目 而产生的任何直接、间接、偶然、特殊、惩罚性或后果性损害承担责任,包括但不限于:

  • 数据丢失、账号异常、消息发送失败或丢失
  • 服务中断、设备损坏、业务损失
  • 因使用本项目而违反任何第三方(含腾讯)服务条款所导致的后果

使用风险由你自行承担。

仅供学习与研究

本项目仅供个人学习、技术研究与交流,不得用于:

  • 任何商业用途
  • 群发消息、营销推广、骚扰他人
  • 任何违反《微信个人账号使用规范》《微信 ClawBot 功能使用条款》或 相关法律法规的用途

底层依赖腾讯官方 iLink(微信 ClawBot)协议,接口可能随时变更或终止。 请遵守腾讯的相关服务条款,因违规使用导致的一切后果由使用者自负。

与上游项目无关联

本项目为非官方第三方插件,与 DeepSeek Harness、dsh-wechat、腾讯及微信 均无任何隶属或背书关系。


为什么需要它

dsh-wechat 的会话有效期是 24 小时(腾讯 iLink 服务端限制)。正常情况下它会自动调 notifyStart 重建服务端会话,你无需干预。但当自动恢复连续失败后,它只做三件事:

markTokenGiveUp() {
  this.tokenGiveUp = true;
  this.log("-14 recovery failed; re-scan required — discarding parked outbound");
  this.discardQueuedOutbound("session-timeout-give-up");
}

置标志、写一行日志、把队列里待发的消息全部丢弃。 没有任何推送。你只能靠主动打开 DSH 设置 → WeChat 看状态,或者发现发出去的消息没有回应。

这个插件补上的就是这个缺口。

功能

  • 状态轮询 — Host 侧每 15 秒读取 dsh-wechat 的状态接口,归约为 level / text / hint / qrUrl 四个标量
  • 掉线横幅 — Client 侧注册在 shell.overlay,状态异常时在界面底部居中弹出
  • 零干扰 — 一切正常时完全不渲染(返回 null),不占任何视觉空间
  • 一键扫码 — 横幅上的「打开二维码」直接打开扫码页,不用再翻设置
  • 降级容错 — dsh-wechat 未加载(404)、上游报错、响应非法 JSON、连接超时, 全部退化为可见状态而非抛异常

行为表

桥接状态 界面表现
logged-in 微信在线 不显示(正常态零干扰)
waiting-qr 等待扫码 🟡 琥珀色横幅「等待扫码登录」+「打开二维码」
failed 掉线需重扫 🔴 红色横幅「微信已掉线,需要重新扫码」+「打开二维码」
插件未加载(HTTP 404) 🔴 红色横幅「微信插件未加载」
状态不可读 不显示(避免误报)

Showing the opening section of the README — the full document lives in the repository以上为 README 开头摘要,完整文档在仓库内 · View the full README on GitHub →在 GitHub 查看完整 README →

← 上一个 Prev dsh-session-toc 下一个 Next dsh-sticker-board →