Jesse-njx/dsh-chatnode-wechat 预览 preview

Jesse-njx/dsh-chatnode-wechat

通过微信与您的DSH智能体聊天、监控并审批操作——一个适用于DeepSeek Harness的iLink网关与对话节点捆绑包

Project Overview项目介绍

Jesse-njx/dsh-chatnode-wechat is a DeepSeek Harness (DSH) bundle that lets users chat with, monitor, and approve DSH agent runs directly from a personal WeChat account. It connects a DSH profile to WeChat via Tencent’s unofficial iLink bot gateway, the same open protocol used by popular projects like hermes-agent and OpenClaw. It supports bidirectional text and image transfer, session management via chat commands, in-chat approval of DSH permission requests, and digest-style progress updates instead of raw tool call outputs. It ships as two separate Cordis plugins: one handles the low-level iLink gateway connection, the other acts as the bridge between WeChat messages and DSH agent sessions.

To install the bundle, first clone the repository to your local machine, then run pnpm install and pnpm build to compile the source code. Next, use the DSH CLI command dsh plugin --profile <your-profile> add . to add the bundle to your existing DSH profile. After installation, run pnpm login to generate a QR code for WeChat authentication; once you scan the QR code with your WeChat app, your credentials are automatically saved to DSH’s credential service at $DSH_HOME/.credentials.yaml. You must add your WeChat ID to the allowFrom configuration list before starting the bundle, otherwise all incoming messages will be ignored for security.

This project is released under the open-source MIT license, and all dependencies on DSH core packages are pinned to a specific working version to avoid breakage from upstream API changes. There are several important caveats to note before running: iLink only allows one active poller per bot token, so running this bundle alongside other iLink-based tools on the same WeChat account will cause 403 errors and dropped messages. Because this uses an unofficial gateway not documented or supported by Tencent, there is a risk that your WeChat account could be restricted. The project officially recommends using a dedicated WeChat account that you are willing to risk losing.

这是一个专为 DeepSeek Harness (DSH) 开发的原生 bundle,用于将DSH智能体会话连接到微信个人账号,基于腾讯非官方iLink机器人网关实现双向文本和图片通信。它包含两个可分离的Cordis插件:wechat-gateway负责处理iLink服务的QR登录、认证长轮询、断线重连、媒体加解密上传下载等底层能力;wechat-conversation-node负责微信和DSH之间的消息桥接、会话管理、命令处理和权限审批。

安装需要先克隆仓库,使用pnpm安装依赖并构建,然后通过dsh命令添加到目标配置文件。完成后通过pnpm login生成登录二维码,微信扫码后凭证会存储在DSH的凭证服务中,无需手动管理。配置需要指定允许访问的微信ID,还可以调整摘要发送间隔、审批超时、消息字符限制等参数,适合需要远程监控和审批DSH智能体运行的开发者。

本项目采用MIT许可开源,依赖pnpm包管理器和DSH v0.1版本,依赖版本已固定避免上游变更导致的问题。需要注意每个iLink令牌仅允许一个轮询进程,同账号运行其他基于iLink的客户端会导致403错误,建议使用专用微信账号。腾讯可能会对使用非官方网关的账号进行限制,开发者需要自行承担账号风险。

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

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

READMEREADME

dsh-chatnode-wechat

Chat with, monitor, and approve your DSH agents from WeChat.

A DeepSeek Harness bundle that connects a DSH profile to a WeChat personal account over Tencent's unofficial iLink bot gateway (ilinkai.weixin.qq.com) — the same mechanism hermes-agent and OpenClaw use. Text and images go both ways (inbound images are downloaded, decrypted and handed to the agent; /send sends an image back), session targeting works with /sessions /use /new /stop /status, permission requests are answered with /yes / /no right in the chat, and progress is reported as digest-style messages instead of a tool-call firehose.

你 (WeChat)  ⇄  iLink  ⇄  wechat-gateway  ⇄  wechat-conversation-node  ⇄  DSH agent session

The bundle ships two separable Cordis plugins:

Plugin Role
wechat-gateway (WechatGateway) iLink service (ctx.wechat): QR login, authenticated long-poll, reconnect/backoff, send retry + rate-limit circuit, typing indicator, encrypted CDN media download/upload (downloadImage / sendImage).
wechat-conversation-node WeChat ⇄ DSH bridge: allowlist gate, session targeting, commands, digest outbound (chunked + throttled), approvals.

⚠️ Read this first

  • One poller per account. iLink allows exactly ONE authenticated poller per bot token. If you also run hermes-agent or OpenClaw on the same WeChat account, one of them gets HTTP 403s and drops messages. Use a dedicated WeChat account for the agent, and never run two instances of this bundle against the same token.
  • Unofficial gateway. This rides the same unofficial mechanism as hermes/openclaw; Tencent could restrict the account. Again: use a dedicated account you are willing to lose.
  • Unofficial protocol. iLink details are reconstructed from hermes-agent source, not Tencent docs. Recorded transcripts live in test/fixtures/inbound.ndjson so CI never needs a live account.

Install

git clone https://github.com/Jesse-njx/dsh-chatnode-wechat.git
cd dsh-chatnode-wechat
pnpm install && pnpm build
dsh plugin --profile <your-profile> add .

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

← 上一个 Prev better-dsh 下一个 Next dsh-ankh-guard →