WeChatAgent README

The project's README from github.com/sourcepro5/WeChatAgent. As one markdown file: README.md.

WeChatAgent 0.3.8

Windows 微信助手与独立桌面控制台。支持白名单好友/群聊、人格预设、独立 DSH 会话、天气查询、网页正文阅读、图片理解、原生文字及表情包发送。内置功能可通过扩展页面管理。

安装使用

普通用户使用 GitHub Releases 附件中的 WeChatAgent-Setup-0.3.8-x64.exe。安装后通过“首次配置”登录自己的微信和 DSH、自动查找账号并连接验证数据库、选择聊天范围,日常操作无需命令行。首次白名单为空。安装器需由维护者上传至 Releases;本源码目录不包含它。

0.3.8 安装器支持选择数据位置:程序位于所选目录的 app,数据默认位于同级 data,也可另选文件夹。旧版 AppData 数据可在首次启动确认后复制、逐文件校验并迁移,保留原副本;微信原始数据库仍在原位置。升级与卸载保留用户数据。详见 数据目录与迁移。维护者的账号、密钥、联系人、聊天和运行日志未包含在源码中。

安装完成后,按“首次配置”依次连接微信账号、验证数据库、登录 DSH 并启用本项目插件、选择聊天范围,再启动助手服务。首次聊天范围为空,添加好友或群后保存并重启服务。

升级到 0.3.8 前,停止助手服务并从托盘完整退出匹配微信、助手和 DSH;安装后重新打开,确保加载新版界面与模型插件。账号、读取凭据、聊天范围、人格编辑及背景设置会保留。

点击窗口“×”仍收起到托盘;点击“退出应用”会先停止本实例后台服务再退出,微信和外部 DSH 保持运行。停止失败时保留窗口供重试。详见 退出与后台服务。

版本与预设

0.3.8 更新

使用内置功能

技能与插件在 DSH 安装和管理,人设卡继续在 WeChatAgent 管理。在“聊天范围”或“会话”打开目标聊天的“会话设置”,独立选择人格、群聊回复方式、功能开关;切换到“技能与工具”读取 DSH 清单并分配能力。点击“保存此会话”只提交当前聊天,保留其他页面的草稿。具体步骤见 DSH 技能与群聊授权。

在“扩展”页管理微信功能开关并查看 DSH 能力概览;自主表情素材搜索在目标会话的“技能与工具”中授权。点击卡片查看详情,修改开关或适用聊天后保存。列表显示已开启、已关闭、部分开启及开启范围;详情逐个显示聊天状态和待保存反馈。扩展页与回复设置共用配置,DSH 未连接时仍能查看已保存的开关,实际功能需在服务连接后按条件运行。

功能 如何使用 默认状态
网页阅读 在允许的聊天中发送“总结这个网页:链接” 开启
联网搜索与天气 开启联网搜索后正常提问,模型结合前文按需检索,无需提供网址,例如“上海天气咋样”“最近这个有新消息吗” 关闭;可为单个聊天覆盖
自主表情素材搜索 在 DSH 授权区域选择 meme-search 技能与 meme-search__search 工具,再发送“找个猫猫无语表情素材” 关闭
dsh-meme 图库接入 在 DSH 自行安装启用 dsh-meme,再在扩展页开启接入并选择聊天;联网补图需额外开启对应开关 关闭
群友记忆 按稳定成员 ID 记录有限互动标签,需要时由模型读取;每个账号和群独立保存 已允许群聊默认开启
原生表情发送 在允许的聊天中收到表情后,由模型按语境选择使用 开启;可为单个聊天覆盖
主动聊天 打开总开关,并逐个选择允许主动发送的聊天 关闭
自动上下文压缩 打开总开关,设置阈值和空闲等待时间 关闭;会话页另支持手动压缩

联网搜索现在由当前模型根据对话按需调用,沿用“扩展 → 联网搜索”的开关与聊天范围;不需要输入网址,也不要求固定搜索句式。模型会从追问中补全公开主题,普通闲聊不必检索。联网搜索直接调用 DSH 网页搜索服务,沿用当前账号和 DSH 搜索配置;天气、热点及普通事实检索使用同一通道。服务未就绪、登录失效、超时或无来源时说明对应原因,不切换其他搜索或天气接口。不必另外填写搜索密钥。本轮查到的来源链接可以交给网页阅读继续核实。仍受每轮 1–3 次检索、结果数、摘要长度和超时限制;仅查询公开关键词,临时说“不要联网”会取消该轮联网。未查到、搜索请求失败和网页正文读取失败会分别说明;已有来源摘要能够回答时,不强制再次读取正文。默认超时 20 秒,可设置 1–60 秒;已有 8 秒等较短配置会保留,可在回复设置调整为 20–30 秒。每次调用只请求 DSH 网页搜索,使用完整的已配置超时,DSH 服务内部检索由其自身设置控制。

网页阅读支持本轮用户提供的公开 HTTP(S) HTML 或纯文本页面,支持 gzip、deflate 和 Brotli 压缩响应。可以发送“总结这个网页:www.bilibili.com”,也可以直接发送网址;`www.bilibili.com`、`bilibili.com`、`b23.tv/…` 等省略协议的网址会自动补全 HTTPS。每轮最多三页、每页最多 12,000 字符。不登录、不执行页面 JavaScript,也不会自动访问正文中的其他链接。取得的页面文字会交给当前模型处理;Bilibili 首页可读取实际返回的推荐条目,视频链接只读取页面文字,不代表观看视频或读取未显示的字幕。登录页、验证码、浏览器提示页、纯动态页面、PDF 等无法读取时会说明原因。

如果提示代理 DNS 返回 Fake-IP,请在代理客户端将 DNS 模式改为 redir-host,或在其 fake-ip-filter 中加入目标域名(Bilibili 可加入 +.bilibili.com、b23.tv),再重启代理和助手服务。这是代理客户端的配置,助手不会自动修改系统网络设置;内网地址保护仍然有效。

0.3.8 安装包的网页阅读支持诛仙世界工具站行情页:通过该站固定公开报价接口读取女娲石和银两,按用户指定区服返回挂单、单位和更新时间;没有区服时先询问。网址后紧接“帮我看看”等中文请求也可识别。本版安装包已包含该修复。

给机器人补充表情

也可直接打开左侧“表情包”,批量选择本地图片添加、编辑描述和标签、预览动图或删除。详见 表情包管理。

  1. 在“扩展 → 原生表情发送”或“聊天范围”中开启目标聊天的表情发送。
  2. 在“回复设置”开启“学习并复用表情标签”;本机资源缺失时,可开启“允许从腾讯下载缺失的表情包”。
  3. 助手运行后,由好友或群成员在这个允许的聊天中发送微信原生表情包。资源准备完成后,模型可在后续回复中选择使用。

0.3.8 安装包支持同一账号已允许好友与群聊共享统一表情池:后台准备、按内容去重、重启保留,按对话优先匹配标签。池容量最多 50 张,满池新候选由当前 DS 模型查看预览、标签和使用情况后决定替换或拒绝;模型不可用时保持原池。收集与共享开关和计数在“回复设置 → 原生表情发送”,发送仍按聊天控制;普通图片不自动入池,动态 GIF 保留动画。原有 meme-search 技能返回素材来源链接;另行启用 dsh-meme 接入后,可在当前聊天授权范围内核验、入库并发送图片。详见 表情收集与搜索。本版安装包已包含表情池、DSH 按会话授权及配套技能模块。

自主表情素材搜索

项目提供的表情素材能力由 DSH 项目插件注册。在目标聊天的“会话设置 → 技能与工具”中选择 meme-search 技能和 meme-search__search 工具。同时开启该聊天的“联网搜索”,然后发送“找个猫猫无语表情素材”,模型也可按聊天语境使用;唤醒回复模式的群需先 @ 或使用唤醒词。

默认来源为 auto,保留候选缓存和查询间隔。工具返回未查看的素材链接,不会自动下载、入库或原生发送。配置在 DSH 项目插件中管理;微信原生表情发送继续在 WeChatAgent 管理。旧版已授权的聊天会在准备配置时迁移,详见 DSH 技能与群聊授权。

更新提示

安装本次 0.3.8 后,助手启动时通过 GitHub Releases 检查后续更新,也可点击侧栏“检查更新”。发现新版本或同版本的新构建时显示下载入口和发布说明;下载后停止服务、完整退出助手与 DSH,再运行安装包。网络失败时不会打断聊天。此前未内置更新检查的版本,需要先手动安装本次更新。

源码与构建

运行要求:Windows 10/11 x64、Node.js 22.13+(建议 24)、Python 3.10+ 及读取依赖。桌面构建依赖在根 package.json 固定版本。

npm ci
npm ci --prefix packages/dsh-social-bridge-plugin
python -m pip install -r scripts/reader-requirements.txt
npm run desktop:build

构建完成后双击根目录 WeChatAgent.exe 或 WeChatAgent-Console.vbs。源码副本不包含微信、DSH、第三方 Hook、已编译原生库或任何运行环境,完整收发需独立准备相应组件。外部组件说明见 发送后端。源码模式的自动连接需另行准备已授权的 wx_key.dll,放到 components/weflow-cli/resources/key/win32/x64/;安装器会内置该组件,普通用户无需手动准备。

安装器构建需要已获授权的微信客户端、Hook 编译产物及 DSH 程序。准备到本机私有 state/hook 目录,设置 DSH 程序目录后构建;每次均校验 DSH 与 SDK 版本匹配,并按根 package.json 中的版本号生成安装器。

$env:WECHATAGENT_DSH_SOURCE = '<DSH program directory>'
npm run desktop:build
npm run installer:runtime
npm run installer:build

检查

npm run privacy:check

公开副本不附带开发回归测试、合成数据生成器或独立模型验证脚本。开发探针测试入口也已移除;应用内的环境检查、数据库读取检查和实际发送后端检查仍保留。部署、启动与日常收发不依赖测试源码。

目录

目录 用途
apps/console-desktop、public/console 桌面程序与界面
scripts 生命周期、读取 API、构建与原生覆盖层
packages/dsh-social-bridge-plugin DSH 0.2 插件及依赖锁
components/qq-bridge MIT 微信社交运行源码子集
components/weflow-cli MIT 数据库读取源码子集
roles 五份预设与说明
config/wechatagent.example.json 空白聊天范围的示例配置

数据与许可

启用云端模型后,选中的聊天消息、人格、图片,以及按请求取得的网页正文会交给配置的模型服务;本机读取不代表模型推理发生在本机。聊天不能修改人格、白名单、规则或模型工具权限,配置仅由本机所有者管理。

原作者署名和各组件许可保留,见 LICENSES.md 与 components.json。维护者已确认当前使用组件的再分发授权;这不将第三方程序、代码或角色素材重新许可为 MIT,也不表示微信或 DeepSeek 的官方背书。

源码与安装器分开发布:仓库提交本目录源码,Releases 附加安装器、SHA256SUMS.txt 和验证记录。推送与发布命令见 GitHub 发布步骤。安装、启动、升级及卸载验收使用维护者 Windows 11 的隔离目录,不替代其他电脑或账号的实际登录与收发验证。

免责声明

本项目仅供学习、技术交流与个人实验使用。请在合法授权的前提下使用,并遵守适用法律法规、平台规则及第三方组件的许可要求。请勿用于骚扰、诈骗、未经授权的数据访问,或其他侵害他人权益的行为。

本项目为第三方技术整合,不代表微信、腾讯或 DeepSeek 官方,也不构成任何官方合作或背书。项目按现状提供,不保证所有客户端版本、账号和运行环境均可正常使用。使用前请做好必要的数据备份,并自行评估账号、隐私及模型服务使用等风险。“仅供学习”的说明不替代相关许可或授权。

自定义背景

点击右上角“换肤”,选择自己的 PNG 或 JPG 图片(最大 20 MB),可实时调整背景显示强度或恢复默认。浅色、深色主题均保留阅读遮罩。图片保存在本机 state/desktop 下,重启后继续生效,不上传至模型,也不作为公开源码或安装包预设分发。

交流与反馈

使用过程中遇到问题,欢迎添加 QQ群 交流反馈。没有问题也欢迎扩列,聊聊技术或日常。

扩展页采用搜索、分类和状态筛选的卡片布局。dsh-meme 原版插件的安装教程、按聊天授权及联网补图到微信发送的流程见 dsh-meme 接入说明。

群友记忆按稳定成员 ID 记录互动倾向,按微信账号和群聊隔离,模型按需读取 JSON。使用说明见 群友记忆。

tips

默认人格的攻击力为3250,特别会怼人

WeChatAgent (sourcepro5/WeChatAgent)

customization
Searching Database…

What is this?WeChatAgent is a Windows desktop assistant and console that connects to your real WeChat account and lets an AI (via DSH) chat in whitelisted private and group chats, with configurable personas, weather lookups, web-page summarization, image understanding, and native sticker replies.
Is this a browser extension or a standalone app?It is a standalone Windows desktop application with its own console UI that hooks into your actual WeChat client via a native DLL so the agent can read and send messages, rather than running inside a browser.
How do I get it running?Download WeChatAgent-Setup-0.3.8-x64.exe from the project's GitHub Releases, run it, then use 'First-time Setup' to log into your WeChat account, verify the credential database, sign into DSH and enable its plugin, pick which chats to handle, and start the assistant service.
Do I need a specific WeChat version or DSH already set up?Yes: it is matched to WeChat Windows x64 build 4.1.10.27 and needs the DSH desktop app plus plugin SDK (verified against 0.2.0-rc.2) already installed and logged in; building from source additionally needs Node.js 22.13+ and Python 3.10+.
What can't it do yet?There is no proactive screenshot capture, file sending, or voice/video understanding, and it does not support a generic 'any WeChat version' mode — it only works with the specific matched WeChat build.
What built-in personas come with it?Five presets ship out of the box: Tsundere Assistant (傲娇助手), Texas (德克萨斯), Roxy (洛奇希), Sample Assistant (示例助手), and Little Whale (小鲸鱼); Sample Assistant is selected by default and can be switched in the desktop app.
Can the bot message people on its own without being asked?Yes, there's a per-chat proactive-chat toggle, but it is off by default, same as web search and automatic context compression.
How does it learn and send WeChat stickers?It builds a shared sticker pool per account (up to 50 images) from native WeChat stickers sent in allowed chats, can optionally download missing ones from Tencent, and lets the current model pick a sticker contextually when replying.
Can it search the web or just read pages I link?Both: send 'summarize this page: ' to fetch up to 3 pages per turn (12,000 characters each, no JS execution), and separately enable 'web search' per chat so the model can query DSH's web search service for things like weather or news without a URL.
Creator
sourcepro5
Size
3.3 MB
Stars
225
Age
18d
Commits · 90 Days