Agent 2 原始产出：开源项目深度对比
调研日期：2026-04-10 执行者：Explore subagent（read-only，故原始内容以此文件保存） 时间盒：25 分钟
一、项目卡片详情
1. Wechaty (wechaty/wechaty)
基础信息
- GitHub: https://github.com/wechaty/wechaty
- Stars: 22.7k | 最后更新: 2026 年（持续活跃）
- Open Issues: 177 | Open PRs: 17 | 未 archived
核心原理 抽象层框架 + Puppet 插件体系，支持多协议接入（iPad Pad、Web、Mac 等）
官方支持的 Puppet（2026 年现状）
- WorkPro（新）— iPad 协议升级版，官方推荐替代品
- PadLocal（付费）— Pad 协议，需 token，可通过 pad-local.com 购买长期 token 或获取 7 天免费试用；Wechaty 贡献者可获 1 年免费 token
- Paimon（开源）— 开源协议实现
- Donut（开源）— 开源协议实现
- WXWork（弃用）— 已 deprecated，用户应迁移到 WorkPro
- XP（未官方支持）— 社区存在但不在官方列表中
支持的微信版本 所有版本（通过不同 Puppet 适配，如 PadLocal 支持最新版本如 4.1.8.101）
开发语言与调用方式
- TypeScript/JavaScript（主力）、Python、Go、Java
- HTTP API / RPC 调用方式
能力清单
- 文本✓ 图片✓ 文件✓ 语音✓ 视频✓ 朋友圈✓ 群管理✓ 拉人✓ @✓ 引用回复✓
社区活跃度
- 177 个开放 issue，17 个 open PR
- Discord 社区活跃
- 多语言文档完善
- 最近 6 个月有持续 commit
公开风险反馈
- PadLocal 的稳定性依赖 token 状态，付费方案存在商业集中风险
- 新旧 Puppet 协议更新频繁，版本迁移成本高
商业化情况
- 开源框架本身免费
- PadLocal Puppet 采用 token 付费制（价格未公开，需咨询官方）
2. WeChatFerry (lich0821/WeChatFerry)
基础信息
- GitHub: https://github.com/lich0821/WeChatFerry
- Stars: 6.5k | 最后更新: 2026-03-28 (v39.5.2)
- Open Issues: 2 | Open PRs: 0 | 未 archived
- 1080+ commits
核心原理 Windows PC Hook（DLL 注入）+ C++ 核心 + NanoRPC 通信
支持的微信版本 严格匹配版本绑定（如 v3.9.12.17、4.0.x、4.1.x），需版本号精确对应
开发语言与调用方式
- 后端：C++（核心）
- 客户端：Python、Go、Java、Node.js、C#、Rust
- 调用：HTTP API / gRPC
能力清单
- 文本✓ 图片✓ 文件✓ 语音✓ 视频✓ 群管理✓ 拉人✓ @✓ 引用回复✓ 朋友圈✓
社区活跃度
- 仅 2 个 open issue（维护快速）
- 0 个 open PR
- 社区使用者众多（知乎、CSDN 有大量教程）
- 最近 6 个月有定期更新
公开风险反馈
- 极高封号风险（>80%）— Hook 技术直接内存侵入，易被检测
- 2025-2026 年报告：Web 协议已大规模封号，Hook 相对更安全但仍高风险
- 风险缓解策略：小号测试、消息间隔 ≥5 秒、日消息数 ≤200/3 条/分钟
商业化情况
- 完全开源免费
- 有传言”WCF PRO”付费版本，但未在官方仓库确认
3. ntchat (smallevilbeast/ntchat)
基础信息
- GitHub: https://github.com/smallevilbeast/ntchat（404 或已移除）
- 备用源: https://github.com/billyplus/ntchat（Fork）
- Stars: 574（历史数据）
- 最后更新: 2022-10-09（已停止维护）
核心原理 Windows PC Hook + Python WebApi 接口
支持的微信版本 3.6.0.18 及相近版本（停止维护后无新版本支持）
开发语言与调用方式
- Python SDK (pip install ntchat)
- HTTP WebApi
能力清单
- 文本✓ 图片✓ 文件✓ 语音✓ 群管理部分✓
社区活跃度
- 0 — 项目已停止维护
- 仅有社区 fork 在维护
商业化情况
- 开源免费（但已无法使用）
4. ComWeChatRobot (ljc545w/ComWeChatRobot)
基础信息
- GitHub: https://github.com/ljc545w/ComWeChatRobot
- Stars: 1.8k
- 最后更新: 2022-10-22 (v3.7.0.30-0.0.9)
- Open Issues: 53
核心原理 Windows PC Hook + COM 接口封装
支持的微信版本
- 3.5.0.46、3.6.0.18、3.7.0.26、3.7.0.30（主分支）
- 严重滞后 — 最新微信 4.1.8.101 完全不支持
开发语言与调用方式
- C++ DLL
- COM 接口（供 Python、C# 调用）
能力清单
- 文本✓ 图片✓ 文件✓ 通讯录✓ 群管理✓
社区活跃度
- 53 个 open issues（多数未解决）
- 几乎无 PR 和更新
- 实际上已停止维护
商业化情况
- 开源免费
衍生项目: ComWeChatBotClient (JustUndertaker/ComWeChatBotClient)
- Stars: 298 | 最后更新: 2023-06-05 (v0.0.8)
- OneBot 12 协议适配
- 2024-04-21 已 archived
5. wxhelper (ttttupup/wxhelper)
基础信息
- GitHub: https://github.com/ttttupup/wxhelper
- Stars: 3k
- 最后更新: 2023-12-26 (v3.9.8.25-v2)
核心原理 DLL 注入 + HTTP API 接口 + 逆向 Hook
支持的微信版本 3.8.0.41、3.8.1.26、3.9.0.28、3.9.2.23、3.9.2.26、3.9.5.81 （不支持 4.0+）
开发语言与调用方式
- DLL (C++)
- HTTP API（Python/其他语言通过 HTTP 调用）
- 需注入工具（Injector）
能力清单
- 文本✓ 图片✓ 文件✓ 语音✓ 视频✓ 群管理✓ 数据库查询✓
公开风险反馈
- 同样存在 Hook 高封号风险
- 明确声明”仅用于学习研究”，避免法律风险
商业化情况
- 开源免费
6. PyWxDump (xaoyaoo/PyWxDump) — 特殊情况
基础信息
- 原 GitHub: https://github.com/xaoyaoo/PyWxDump（已删库）
- 删库原因：收到律师函，作者主动删除全部代码和文档
- Fork 仍存: wo1261931780/fork-PyWxDump、alanhzw/PyWxDump 等
核心原理 微信 PC 数据库解密 + 聊天记录读取（不是接入方案，是取证工具）
用途差异
- ❌ 非接入方案（不支持实时消息收发）
- ✓ 可用于辅助：解密数据库密钥、本地数据迁移、训练数据集提取
- 风险：涉及隐私数据解密，容易触发法律问题
二、对比矩阵
| 维度 | Wechaty | WeChatFerry | ntchat | ComWeChatRobot | wxhelper |
|---|---|---|---|---|---|
| 语言 | TS/JS + 多语言 SDK | C++ + 多语言客户端 | Python | C++ (COM) | C++ (HTTP) |
| 核心原理 | Puppet 框架 | Hook 注入 | Hook | Hook + COM | DLL 注入 |
| 最新更新 | 2026 年活跃 | 2026-03-28 | 2022-10-09 ❌ | 2022-10-22 ❌ | 2023-12-26 ❌ |
| Stars | 22.7k | 6.5k | 574 | 1.8k | 3k |
| 支持微信版本 | 4.1.8.101 ✓ | 4.1.x（需版本匹配） | 3.6.0.18 ❌ | 3.7.0.30 ❌ | 3.9.5.81 ❌ |
| 封号风险 | 低-中（取决 Puppet） | 极高（>80%） | 高 | 高 | 高 |
| 文档质量 | ⭐⭐⭐⭐⭐ | ⭐⭐⭐ | ❌ | ⭐⭐ | ⭐⭐ |
| 社区活跃 | 高（177 issues） | 中（2 issues） | ❌ | 低（53 issues 堆积） | 低 |
| 商业化 | PadLocal 付费 token | 开源免费 | N/A | 开源免费 | 开源免费 |
| 生产就绪 | ✓ 可用 | ⚠️ 高风险 | ❌ | ❌ | ⚠️ 过时 |
三、2026 年选型建议
一句话结论
| 场景 | 推荐 | 理由 |
|---|---|---|
| 新项目 + 正式运营 | Wechaty（WorkPro/PadLocal） | 唯一活跃、官方支持新版微信、框架稳定、文档完善 |
| 高风险容忍 + 快速原型 | WeChatFerry | 功能最全、更新快，但需接受 >80% 封号风险 |
| 企业级方案 | 企业微信 OpenAPI（不在本对比范围） | 个人号方案都有法律风险 |
| 数据取证/迁移 | fork 的 PyWxDump | 原作者已放弃，法律风险高 |
四、原始引用清单
Wechaty 官方
- https://github.com/wechaty/wechaty (22.7k ⭐)
- https://wechaty.js.org/docs/specs/puppet
- https://github.com/wechaty/puppet-padlocal
- https://wechaty.js.org/docs/puppet-services/compatibility/
WeChatFerry 官方
- https://github.com/lich0821/WeChatFerry (6.5k ⭐，2026-03-28 更新)
- https://github.com/lich0821/WeChatFerry/releases
wxhelper
- https://github.com/ttttupup/wxhelper (3k ⭐，2023-12 最后更新)
- https://cloud.tencent.com/developer/article/2417203
ComWeChatRobot
- https://github.com/ljc545w/ComWeChatRobot (1.8k ⭐，2022-10 停止)
- https://github.com/JustUndertaker/ComWeChatBotClient
PyWxDump
技术对比文章
- https://zhuanlan.zhihu.com/p/1891472259190862807
- https://blog.csdn.net/weixin_38861218/article/details/146997227
- https://juejin.cn/post/7179140844073680954
风险评估