br1nosense/dsh-wxauto-plugin

Plugin插件 Native原生 ⭐ 3 MIT Notifications & Remote通知与远程

dsh-wxauto-plugin — DSH 微信汇报与监听插件

Project Overview项目介绍

This is a native plugin built exclusively for DeepSeek Harness (DSH), leveraging the free version of wxauto4 to add WeChat automation capabilities to DSH. It enables three core features: pushing task progress updates as text or files to a specified WeChat chat after DSH tasks complete or run in the background, listening for new messages in a target WeChat chat and logging them to a JSONL file, and allowing reverse control of DSH directly from WeChat. Users can create new conversations, switch existing conversations, and trigger task runs entirely through WeChat messages.

This plugin is designed for users who need to remotely monitor DSH task progress or control DSH from a mobile device via WeChat. After installation, a dedicated "WeChat Automation" tab is added to the DSH settings page, where users can configure target chats, toggle message listening and the reverse bridge on or off. By default, the plugin targets the WeChat File Transfer Assistant, but users can update the configuration to target any friend or group chat, and set a custom default working directory for DSH tasks. If you encounter peer dependency resolution errors after installation, you can fix it by creating junction links to DSH's core packages in your plugin workspace root.

The plugin has specific system requirements to work correctly. It only supports Windows 10 and 11, requires an installed and logged-in WeChat 4.1.x client, and a Python installation between version 3.9 and 3.12. You must install the wxauto4 and websocket-client Python dependencies via pip before running the installation script. The free version of wxauto4 used by this plugin implements message listening via polling, which works reliably but does not have the advanced features of the paid Plus version. It is released under the permissive MIT license, but note that wxauto is for technical study only, and frequent non-compliant operation carries a risk of having your WeChat account banned.

这是一款专门为DeepSeek Harness(DSH)开发的原生插件,基于wxauto4免费版实现微信自动化,为DSH提供微信消息推送、监听和双向控制能力。支持DSH任务进行或完成后,向指定微信聊天窗口推送任务进度、文本或文件,也能监听指定聊天的新消息写入JSONL日志,还支持微信反向控制DSH新建、切换对话和执行任务。

适合需要远程监控DSH任务进度,或是通过微信远程操控DSH的用户。安装完成后可以在DSH设置页新增的「微信自动化」标签页,配置目标聊天窗口、开关监听和双向桥功能。默认配置指向文件传输助手,用户可根据需求修改为指定群聊或好友对话,还能自定义配置DSH的默认工作目录。

本插件仅支持Windows 10/11系统,要求安装已登录的微信4.1.x客户端,以及Python 3.9到3.12版本,需要提前通过pip安装wxauto4和websocket-client依赖。本插件采用MIT许可证,需要注意wxauto仅用于技术交流学习,频繁非合规操作有微信账号封号风险。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 warning1 项注意
  • Only 3 stars - very few users, little community feedback星标只有 3,几乎没人在用,遇到问题缺少社区反馈
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命令行安装

dsh plugin --profile web add github:br1nosense/dsh-wxauto-plugin

把 br1nosense/dsh-wxauto-plugin 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

dsh-wxauto-plugin — DSH 微信汇报与监听插件

基于 wxauto4(Python 免费版,支持微信 4.1.x 客户端)的 DSH 技能插件。

核心功能

  1. 任务进度微信推送:DSH 任务进行/完成后,向指定微信聊天窗口发送任务进度信息(文本或文件)。
  2. 微信消息监听:监听指定聊天的微信消息,新消息写入 JSONL 日志供 agent 读取,并支持关键词自动回复。
  3. 微信⇄DSH 双向桥(反向操作 DSH):在微信里发命令或普通消息即可切换对话、新建对话、驱动 DSH 跑任务, 并收到 DSH 的进度截图(会话状态渲染 PNG)与完成汇报。

安装(从 GitHub)

# 1. 克隆仓库
git clone https://github.com/br1nosense/dsh-wxauto-plugin.git
cd dsh-wxauto-plugin

# 2. 安装 Python 依赖(wxauto4 免费版 + websocket-client:桥把 DSH 提问转发到微信需要它)
py -3 -m pip install wxauto4 websocket-client

# 3. 一键安装为 DSH 插件(注册到默认 web profile)
powershell.exe -NoProfile -ExecutionPolicy Bypass -File .\install.ps1

# 4. 重启 dsh web 使插件生效
  • 要求:Windows 10/11 + 微信 4.1.x 客户端(已登录)+ Python 3.9–3.12。
  • install.ps1 会同时注册技能目录与设置页卡片;若 dsh 装在非默认位置, apiproxy 暴露 wxauto 命名空间一步会打印警告(不影响插件主体功能,可手动补)。
  • 卸载:dsh plugin --profile web rm @dsh-user/dsh-wxauto 后重启 dsh web。

常见问题:安装插件后 dsh 启动失败(peerDependencies 解析)

症状:安装本插件(bundle)后重启 dsh,web 启动报错 / 起不来。

原因:本插件把 @deepseek-ai/schemastery(以及 @deepseek-ai/cordis、@deepseek-ai/dsh-settings) 声明为 peerDependencies,但插件目录(clone 下来的仓库)下没有 node_modules。Node ESM 会从插件 所在目录逐级向上查找 node_modules,却找不到 DSH 自身嵌套目录里的这几个包(dsh 安装目录通常 不在该查找路径上)。

修复(一次性,本地环境级):在插件工作区根目录(即插件目录的父目录,如把插件 clone 到 C:\code\AI\DSH\dsh-wxauto-plugin,则根目录是 C:\code\AI\DSH)的 node_modules\@deepseek-ai\ 下 创建 3 个目录联接(Junction),指向 DSH 自带的同名包:

包 指向
schemastery <dsh 安装目录>\node_modules\@deepseek-ai\schemastery(v3.18.1)
cordis <dsh 安装目录>\node_modules\@deepseek-ai\cordis
dsh-settings <dsh 安装目录>\node_modules\@deepseek-ai\dsh-settings

例如本机 dsh 位于 C:\Users\<你>\AppData\Roaming\nvm\v24.19.0\node_modules\@deepseek-ai\dsh:

$dsh = 'C:\Users\<你>\AppData\Roaming\nvm\v24.19.0\node_modules\@deepseek-ai\dsh\node_modules\@deepseek-ai'
$dst = 'C:\code\AI\DSH\node_modules\@deepseek-ai'
New-Item -ItemType Directory -Force -Path $dst | Out-Null
foreach ($p in 'schemastery','cordis','dsh-settings') {
  New-Item -ItemType Junction -Path (Join-Path $dst $p) -Target (Join-Path $dsh $p)
}

该修复是本机环境级配置,创建在 node_modules 下,不应提交到仓库;dsh 升级或换机后路径变化 需重建(建议把上面脚本存成 fix-peer-deps.ps1,换环境后重跑)。

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-browseruse 下一个 Next dsh-plugin-voice-input →