- Автор
- sourcepro5
- Размер
- 4.6 MB
- Звёзды
- 2.3K
- Обновлён
- КоммитNov 15Релизv0.4.5Nov 15
- Возраст
- 1 мес
- Коммиты · 90 дней
README проекта с github.com/sourcepro5/WeChatAgent. Одним файлом markdown: README.md.
让微信成为你的 AI 聊天伙伴与远程任务入口
WeChatAgent 支持好友和群聊的人格对话与独立上下文。连接 DeepSeek Harness(DSH),还能通过微信交办已授权的任务。 有问题可以添加Q群:550582874
下载 Windows 安装器 · 快速开始 · 语音设置 · 插件下载 · 使用教程 · 发布说明
安装版包含所需的 Node.js、Python 和读取依赖, 普通用户无需安装开发工具。
当前兼容版本和安装范围见 安装说明。
0.4.5 全新安装使用微信 4.2.0.12 x64。 升级保留已有客户端选择、账号和数据,可在连接设置中切换微信。
完成以下步骤,让 AI 回复第一个好友。
从 0.4.5 Release 下载 WeChatAgent-Setup-0.4.5-x64.exe。同页可下载源码包、插件 ZIP 和 SHA-256 校验清单。
运行安装器,选择安装根目录:
app/:程序文件。data/:WeChatAgent 配置、缓存和运行数据。打开 WeChatAgent,进入首次配置:
完成标志: 账号与数据库验证通过。
详细步骤见 连接 DSH。
请对方发送:
你好,介绍一下自己。
完成标志: 微信收到回复,聊天历史中出现对应记录。
如果没有回复,先检查允许范围、连接状态和运行日志, 再查看下方的常见问题。
| 模式 | 适合什么场景 |
|---|---|
| 聊天模式 | 人格对话、群聊参与、看图、表情、搜索与主动聊天 |
| 助手模式 | 从微信交办任务,使用已授权的 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:
安装后默认关闭。更新与卸载的数据保留规则, 以插件说明和界面提示为准。
WeChatAgent 插件与 DSH 插件分别管理,安装包不通用。
插件宿主校验使用 npm run plugin:check。源码与安装器构建会检查权限、能力声明和第一方 ZIP 与源码的一致性。
自建 Search API 或响应较慢的搜索后端,可在“能力 → 联网与阅读 → 搜索次数、缓存与超时”将搜索超时调为 30–60 秒;配置 wechat.search.timeoutMs 的单位为毫秒,例如 45000。默认仍为 20 秒,已有设置不变。若报 native_timeout,还需检查 DSH 与后端自身的时限;外层等待不会延长内部超时。详见 联网搜索说明。
检查服务是否启动、好友是否加入允许范围, 以及微信和 DSH 是否连接正常。
检查本群的唤醒方式和回复频率设置。 自然参与模式下,模型也可能选择沉默。
确认添加的是当前安装位置提供的插件, 并从托盘完整退出、重新打开 DSH。 进一步检查“设置 → 维护 → 诊断”中的连接结果。
DSH 0.2.2 调整了工具附加流程,WeChatAgent 0.4.2 及更早版本可能在对话开始时报 turn_error。升级到 0.4.5 后,准备连接配置,从托盘完整退出并重开 DSH,再启动 WeChatAgent 服务。
在“设置 → 微信与 DSH”中重新选择已准备好的 Weixin.exe,程序会自动读取精确版本并核验签名与发送组件,路径和版本一起保存。只接受当前发行版已适配、组件已就绪的版本;详见 微信程序与版本选择。
窗口“×”会收起到托盘。 需要停止后台并关闭程序时,请使用“退出应用”。
同位置升级沿用已有数据位置。 更换位置时,需要核对迁移来源与目标。 详细说明见 数据迁移。
先确认电脑微信是否已有该表情的完整副本。本机缺失且下载开关关闭时,日志会显示 STICKER_CDN_DISABLED。如允许从腾讯补充下载,在“表情包 → 来源和搜索 → 缺失资源下载与版本兼容”开启“允许从腾讯下载缺失的表情包”,保存后重试;已有本机副本仍可直接读取。
升级前:
安装新版后,按发布说明准备连接配置并重新打开 DSH。
开发前请了解目录职责、外部组件和构建前置条件。
WeChatAgent 的配置、缓存和运行数据保存在本机。 DSH 独立管理自己的会话与附件。
启用模型后,相关聊天内容和附件会交给所选模型服务处理。 分享日志、截图或配置前,请移除账号、凭据和聊天隐私信息。
本项目包含不同来源和许可的组件, 具体范围见 LICENSES.md。
感谢相关上游项目及贡献者。
欢迎通过 Issues 反馈问题。提交时请附上版本、复现步骤和脱敏日志。