WeChatAgent README

项目的 README,来自 github.com/sourcepro5/WeChatAgent。合并为一个 markdown 文件:README.md。

WeChatAgent

让微信成为你的 AI 聊天伙伴与远程任务入口

GitHub Stars GitHub Forks GitHub Issues

WeChatAgent 支持好友和群聊的人格对话与独立上下文。连接 DeepSeek Harness(DSH),还能通过微信交办已授权的任务。 有问题可以添加Q群:550582874

下载 Windows 安装器 · 快速开始 · 语音设置 · 插件下载 · 使用教程 · 发布说明

能做什么

开始之前

安装版包含所需的 Node.js、Python 和读取依赖, 普通用户无需安装开发工具。

当前兼容版本和安装范围见 安装说明。

0.4.5 全新安装使用微信 4.2.0.12 x64。 升级保留已有客户端选择、账号和数据,可在连接设置中切换微信。

快速开始

完成以下步骤,让 AI 回复第一个好友。

1. 下载并安装

从 0.4.5 Release 下载 WeChatAgent-Setup-0.4.5-x64.exe。同页可下载源码包、插件 ZIP 和 SHA-256 校验清单。

运行安装器,选择安装根目录:

2. 连接微信

打开 WeChatAgent,进入首次配置:

  1. 打开匹配微信并登录。
  2. 自动查找账号,选择当前使用的账号。
  3. 连接并验证数据库。

完成标志: 账号与数据库验证通过。

3. 连接 DSH

  1. 按引导单独安装或选择已有的 DSH。
  2. 登录自己的模型账号。
  3. 复制引导提供的插件路径,在 DSH 中添加并启用插件。
  4. 从托盘完整退出 DSH,再重新打开。

详细步骤见 连接 DSH。

4. 添加第一个聊天

  1. 进入“聊天”,添加一个用于测试的好友。
  2. 点击“设置此聊天”。
  3. 选择聊天模式和人格,保存设置。
  4. 按界面提示应用配置,然后启动服务。

5. 验证回复

请对方发送:

你好,介绍一下自己。

完成标志: 微信收到回复,聊天历史中出现对应记录。

如果没有回复,先检查允许范围、连接状态和运行日志, 再查看下方的常见问题。

聊天模式与助手模式

模式 适合什么场景
聊天模式 人格对话、群聊参与、看图、表情、搜索与主动聊天
助手模式 从微信交办任务,使用已授权的 DSH 工具与技能

助手模式需要配置管理员身份,并为目标聊天明确授权。 两种模式分别保留设置与上下文。

配置步骤和使用示例见 远程助手教程。

使用教程

我想做什么 教程
熟悉界面、为聊天选择人格与模式 界面与聊天设置
切换主题预设与主看板布局 主题预设
更换或切换匹配微信程序 微信程序与版本选择
通过微信交办任务 远程助手
为指定聊天分配工具与技能 能力授权
接收附件、回传任务成果 文件收发
配置转写、语音合成和音色 语音对话
使用前台模式发送文字和普通文件 前台模拟输入
添加和管理表情 表情管理
接入 dsh-meme 图库 图库接入
安装鱼的记事本 记事本插件
了解群友记忆 群友记忆
更换安装位置、迁移数据 数据位置与迁移

语音设置

Windows 安装器预置语音识别 API 1.6.0 和语音对话 API 1.7.0,两者默认关闭。在“能力 → 能力目录”打开插件配置。

插件安装

语音识别 API 1.6.0 和语音对话 API 1.7.0 随 0.4.5 安装器预置,可在「能力 → 能力目录」直接配置,默认关闭。

下载插件包

插件压缩包位于仓库的 optional-extensions/packages/ 目录。 下载源码后可在该目录找到,也可以点击下表直接下载。

插件 下载 ZIP 使用说明
语音对话 API speech-synthesis-1.7.0.zip 语音合成、实时和单条转写
语音识别 API speech-recognition-1.6.0.zip API 配置与语音转写
鱼的记事本 fish-notebook-1.1.1.zip 记事本插件说明

每个 ZIP 都附有同名的 .sha256 校验文件,位于同一目录。安装时直接导入 ZIP,无需解压。

这些插件的当前版本自带页面。语音对话 API 1.7.0 需要 0.4.5 的语音宿主,独立语音识别 API 与鱼的记事本支持 0.4.3 及以上版本。旧版宿主缺少所需能力时会拒绝导入,请先升级主程序。

安装步骤

在“能力 → 能力目录”拖入 WeChatAgent API v2 插件 ZIP:

  1. 核对插件名称、版本与权限。
  2. 安装插件。
  3. 配置参数,并选择允许使用的聊天。
  4. 启用插件。
  5. 带页面的插件在卡片上点击“打开”进入。页面在隔离环境中运行,只能读写本插件设置并调用本插件动作。

安装后默认关闭。更新与卸载的数据保留规则, 以插件说明和界面提示为准。

WeChatAgent 插件与 DSH 插件分别管理,安装包不通用。

插件宿主校验使用 npm run plugin:check。源码与安装器构建会检查权限、能力声明和第一方 ZIP 与源码的一致性。

插件开发规范 · 聊天小便签示例 · 鱼的记事本

常见问题

自建搜索后端总是超时怎么办?

自建 Search API 或响应较慢的搜索后端,可在“能力 → 联网与阅读 → 搜索次数、缓存与超时”将搜索超时调为 30–60 秒;配置 wechat.search.timeoutMs 的单位为毫秒,例如 45000。默认仍为 20 秒,已有设置不变。若报 native_timeout,还需检查 DSH 与后端自身的时限;外层等待不会延长内部超时。详见 联网搜索说明。

添加好友后为什么没有回复?

检查服务是否启动、好友是否加入允许范围, 以及微信和 DSH 是否连接正常。

群聊为什么有时不回复?

检查本群的唤醒方式和回复频率设置。 自然参与模式下,模型也可能选择沉默。

DSH 插件启用后为什么仍连接不上?

确认添加的是当前安装位置提供的插件, 并从托盘完整退出、重新打开 DSH。 进一步检查“设置 → 维护 → 诊断”中的连接结果。

更新 DSH 后为什么不回复了?

DSH 0.2.2 调整了工具附加流程,WeChatAgent 0.4.2 及更早版本可能在对话开始时报 turn_error。升级到 0.4.5 后,准备连接配置,从托盘完整退出并重开 DSH,再启动 WeChatAgent 服务。

切换微信程序时提示版本不匹配?

在“设置 → 微信与 DSH”中重新选择已准备好的 Weixin.exe,程序会自动读取精确版本并核验签名与发送组件,路径和版本一起保存。只接受当前发行版已适配、组件已就绪的版本;详见 微信程序与版本选择。

关闭窗口后为什么还在运行?

窗口“×”会收起到托盘。 需要停止后台并关闭程序时,请使用“退出应用”。

升级会丢失数据吗?

同位置升级沿用已有数据位置。 更换位置时,需要核对迁移来源与目标。 详细说明见 数据迁移。

为什么看不到表情包

先确认电脑微信是否已有该表情的完整副本。本机缺失且下载开关关闭时,日志会显示 STICKER_CDN_DISABLED。如允许从腾讯补充下载,在“表情包 → 来源和搜索 → 缺失资源下载与版本兼容”开启“允许从腾讯下载缺失的表情包”,保存后重试;已有本机副本仍可直接读取。

升级与更新

升级前:

  1. 停止助手服务。
  2. 完整退出 WeChatAgent、DSH 和匹配微信。
  3. 核对当前数据位置。

安装新版后,按发布说明准备连接配置并重新打开 DSH。

查看发布说明 · 下载新版

开发与构建

开发前请了解目录职责、外部组件和构建前置条件。

数据与隐私

WeChatAgent 的配置、缓存和运行数据保存在本机。 DSH 独立管理自己的会话与附件。

启用模型后,相关聊天内容和附件会交给所选模型服务处理。 分享日志、截图或配置前,请移除账号、凭据和聊天隐私信息。

许可证与致谢

本项目包含不同来源和许可的组件, 具体范围见 LICENSES.md。

感谢相关上游项目及贡献者。

欢迎通过 Issues 反馈问题。提交时请附上版本、复现步骤和脱敏日志。

WeChatAgent (sourcepro5/WeChatAgent)

正在搜索数据库…

这是什么?WeChatAgent 是一款 Windows 桌面助手和控制台,它连接你的真实微信账号,让 AI(通过 DSH)在白名单内的私聊和群聊中聊天。它支持可配置的人设、天气查询、网页摘要、图片理解,以及原生表情回复。
这是浏览器扩展还是独立应用?这是一个独立的 Windows 桌面应用,带有自己的控制台界面。它通过原生 DLL 挂接到你实际使用的微信客户端,让助手能够读取和发送消息,而不是在浏览器中运行。
我该怎么把它运行起来?从 GitHub Releases 下载 WeChatAgent-Setup-0.3.8-x64.exe 并运行,然后按照“First-time Setup”操作:登录你的微信账号,检查凭据数据库,登录 DSH 并启用其插件,选择要处理的聊天,最后启动助手服务。
我需要特定版本的微信,或者先装好 DSH 吗?需要。它与微信 Windows x64 版 4.1.10.27 版本相匹配,并且需要事先安装并登录 DSH 桌面应用以及插件 SDK(已用 0.2.0-rc.2 验证);如果从源码构建,还需要 Node.js 22.13+ 和 Python 3.10+。
它目前还不能做什么?目前不支持主动截图、发送文件,以及语音或视频理解,也不支持“任意微信版本”模式,它只能配合指定的匹配微信版本使用。
它自带哪些人设?开箱即用五个预设:傲娇助手、德克萨斯、洛奇希、示例助手和小鲸鱼。默认选中示例助手,可以在桌面应用中切换。
机器人能不经提问就主动发消息吗?可以。每个聊天都有一个主动聊天开关,但与网页搜索和自动上下文压缩一样,默认是关闭的。
它是怎么学习和发送微信表情的?它会为每个账号建立一个共享表情池(最多 50 张图片),来源是允许的聊天中发送的微信原生表情。它可以选择从腾讯下载缺失的表情,并让当前模型在回复时根据上下文挑选表情。
它能搜索网页,还是只能读我发的链接?两种都可以。发送 'summarize this page: ' 即可每轮抓取最多 3 个页面(每个 12,000 个字符,不执行 JS)。另外,也可以为每个聊天单独启用 'web search',让模型无需链接,就能向 DSH 的网页搜索服务查询天气或新闻等信息。
大小
4.6 MB
星标
2.3K
时长
1个月
提交 · 90 天