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 协议,接口可能随时变更。
请帮我安装这个 DSH 插件。安装前先完成【兼容性检查 + 安全性检查】,检查通过再动手。
插件:dsh-wechat-status(alk233/dsh-wechat-status)
仓库:https://github.com/alk233/dsh-wechat-status
本站详情页:https://www.yhbd.top/plugins/alk233-dsh-wechat-status/
本站登记:类型 plugin · 归类 原生 DSH 插件 · 许可证 MIT · ⭐ 2 · 最近提交 2026-09-12 · 主语言 JavaScript
按下面顺序执行,每步先把结论告诉我,再进入下一步:
【1 兼容性检查】
① 我这边:DSH 版本、Node 版本、操作系统、当前 profile(web / desktop)。
② 读它的 README、package.json、插件 manifest,列出它要求的 DSH 版本 / Node 版本 / 操作系统 / 外部依赖 / 需要另外先装的运行时。
③ 逐条比对,结论只写「满足 / 不满足 / 未知」三种;不满足的给出可行替代方案。
④ 检查是否和我已装的插件冲突:命令名重复、skill / tool 重名、端口占用、重复注册的 MCP server。
【2 安全性检查】
① 仓库可信度:和上面「本站登记」是否一致;star / fork 数、创建时间、最近提交,是否归档或长期停更。
② 安装脚本:逐行看 package.json 的 preinstall / install / postinstall,以及 install.sh、setup.ps1 之类脚本。出现 curl|bash、下载后直接执行、混淆代码、访问与插件功能无关的域名,立刻停下来告诉我,不要继续装。
③ 依赖:列出新增依赖,标出无人维护、或与知名包拼写近似的可疑包(typosquatting)。
④ 权限与副作用:它会读写哪些目录、访问哪些域名、需要哪些 DSH 权限(filesystem / network / shell / clipboard 等),以及怎么卸载和回滚。
⑤ 如果它要求 sudo / 管理员权限,或权限明显超出功能所需,先停下来问我。
【3 安装】
上面两步没有「不满足」和「高危项」时才执行;用官方推荐方式安装,不要自行提权。
【4 汇报】
用表格输出:检查项 / 结论 / 依据 / 是否需要我决策。拿不准的一律写「未知」并说明要我怎么确认——不要猜,也不要替我决定。
Send this message to DSH in your current session: it verifies compatibility and security first (answering met / not met / unknown item by item) and only installs once everything checks out — it will stop and ask you if it finds a high-risk item. The box scrolls; the copy is the full prompt. CLI install commands may not be accurate across systems, so DSH is the safer route.把上面这条消息直接发给当前会话里的 DSH:它会先核对兼容性与安全性(逐条给「满足 / 不满足 / 未知」),确认没问题再安装,有高危项会停下来问你。框内可滚动,复制到的是完整提示词;安装命令不一定准确,发给 DSH 更稳。
- 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
为 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 →
whiteguo233/dsh-openbiliclaw
hanshanyike/dsh-yolo
AX1202/ax-feishu-bridge
amlyczz/dsh-lark-link
MichengAI/dsh-im-connect
caoyiwei850/dsh-ssh-ops
jiezeng2004-design/dsh-chatgpt-bridge