Carl-5535/dsh-wechat-gateway 预览 preview

Carl-5535/dsh-wechat-gateway

微信 × DeepSeek Harness (DSH):进程内插件,扫码即用,双向消息/文件,wechat_notify 主动推送

Project Overview项目介绍

dsh-wechat-gateway is a native plugin built exclusively for DeepSeek Harness (DSH) that turns your personal WeChat account into a remote entry point for local DSH agents. To install it, you first need to have the DSH CLI installed globally, then run dsh plugin --profile web add "github:Carl-5535/dsh-wechat-gateway#main" to add it to your DSH web profile. After installation finishes, start DSH with the dsh web command, then find the WeChat entry at the bottom of the DSH sidebar and scan the QR code with your WeChat to log in. Once you complete the login step, any message you send from WeChat will be forwarded to your local DSH agent, and the agent's response will be sent back to your WeChat automatically.

Each WeChat chat maps to a separate persistent DSH session that automatically resumes after DSH restarts, and you can start a new session at any time with the /new command. The plugin supports two-way file transfer: WeChat attachments are automatically saved to your DSH workspace and passed to the agent, and the agent can send files back to you via WeChat too. It also includes useful features like visual workspace switching, permission approval for out-of-bounds operations, and an active notification tool that lets any DSH session send messages to your WeChat. This plugin is ideal for users who want to access their local DSH agent remotely when they are away from their home or work computer, or want quick mobile access to agent capabilities.

This plugin requires Node.js version 20 or higher to run, and it is released under the open source MIT license. By default, it only responds to messages from the logged-in WeChat account, and it validates all output file paths to prevent out-of-workspace access, which keeps your system secure. WeChat credentials are valid for about 24 hours per Tencent's policy, but they are automatically renewed whenever you receive a new message, and you will get a WeChat alert before credentials expire. There are some important restrictions to note: WeChat's terms of service prohibit using this plugin for marketing, customer service, or high-frequency bulk messaging, and Tencent may adjust their API endpoints at any time.

这是一个专为 DeepSeek Harness (DSH) 开发的原生插件,作用是将用户的个人微信转为 DSH Agent 的远程入口,允许用户通过手机微信发送指令给本地 Agent,执行后结果会回传到微信。它以 Cordis 插件形式运行在 DSH Host 进程内,每个微信聊天对应一个独立的持久会话,可在 DSH 的 Web UI 中查看和接管,支持通过 DSH 官方 CLI 一键安装。

安装完成后启动 DSH Web,即可在侧边栏底部找到微信入口,扫码登录后就可以开始使用。用户发送的消息会被转为 DSH Agent 的输入,支持文件双向传输,微信附件会自动存入工作区并交给模型处理,Agent 也可以回发文件给微信。它还支持切换工作目录、权限审批、会话管理等多种功能,适合需要随时随地远程操控本地 DSH Agent 的用户。

本插件要求 Node.js 版本不低于 20,使用 MIT 许可开源,默认安全策略为仅响应登录账号本人的消息,出站文件会做路径校验锁定在工作区内。凭据有效期约 24 小时,收到消息会自动续期,过期前会通过微信发送提醒。需要注意微信条款禁止将其用于营销、客服或高频群发场景,腾讯可能随时调整协议端点。

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

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

READMEREADME

dsh-wechat-gateway

CI License: MIT Node

把个人微信变成 DeepSeek Harness (DSH) Agent 的远程入口——手机微信发消息,本机 Agent 干活,回复送回微信。

插件以 Cordis 插件形式运行在 DSH Host 进程内,每个微信聊天对应一个持久会话,可在 Web UI 同时查看和接管。

在 DSH 侧边栏扫码连接微信

特性

  • 扫码即用 — 侧边栏内直接扫码,全程不离开主页
  • 持久会话 — 每个聊天对应一个 DSH 会话,重启自动 resume,/new 随时重开
  • 文件双向 — 微信附件落盘到工作区并喂给模型;Agent 用 [[send-file:路径]] 回发,正文提及的工作区文件自动回发(realpath 防越界,单条最多 5 个)
  • 工作目录 — 侧边栏弹窗内置目录选择器,可视化浏览并切换 Agent 工作目录,运行时立即生效并持久化
  • 微信审批 — 越权操作审批直达微信,回复「同意/拒绝」即可,回复「网页」转交 Web UI 面板
  • 权限模式 — /permission 切换预设(workspace-write ↔ danger-full-access),立即生效
  • 主动推送 — wechat_notify 工具让任何 DSH 会话都能主动推送消息到你的微信
  • 可靠投递 — 回复经持久化发件箱分块发送,超长切分、失败重试、重启续发
  • 到期预警 — 凭据 24 小时有效期随收信自动续期;静置不足 4 小时(可配)过期时微信主动提醒,侧边栏可开关并显示剩余有效期
  • 安全默认 — 默认拒绝一切来源,未配置白名单时仅响应登录账号本人

快速开始

# 1. 安装
npm i -g @deepseek-ai/dsh
dsh plugin --profile web add "github:Carl-5535/dsh-wechat-gateway#main"

# 2. 启动(默认 http://127.0.0.1:3080)
dsh web

# 3. 侧边栏底部「微信」入口 → 手机微信扫码
# 4. 用你自己的微信给机器人账号发消息即可

pnpm ≥ 10 需要显式允许 git 插件构建脚本。安装报 ERR_PNPM_GIT_DEPARE_NOT_ALLOWED 时,在 profile 目录(默认 ~/.dsh/profiles/web/)的 pnpm-workspace.yaml 添加 onlyBuiltDependencies: [dsh-wechat-gateway] 后重试。

Windows 本地开发用反斜杠绝对路径(D:\path\to\dsh-wechat-gateway),不要写 file:D:/...。macOS / Linux 用 file:/绝对路径。

也支持不装全局 CLI:把 dsh 换成 npx @deepseek-ai/dsh。

微信命令

命令 作用
/help /帮助 查看说明
/status /状态 查看会话状态
/stop /停止 中止当前任务
/new /新会话 丢弃上下文,开启新会话
/model /模型 查看/切换模型(序号、模型 id 或 provider/model,仅当前聊天生效)
/permission /权限 查看/切换权限模式(序号、名称或中文别名,立即生效)

其余消息作为用户输入交给 Agent 处理。凭据有效期约 24 小时(腾讯策略),收信自动续期;过期不影响登录和收消息,只是无法主动推送通知,用户发一条消息即可保活续期。

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-browser-scope 下一个 Next onlyMemory-plugin →