📌 项目地址：WhiskeySockets/Baileys | ⭐ 10,387 颗星 | 🔧 JavaScript | 📜 未标注
先说清楚这是个什么东西
Baileys 是一个基于 WebSocket 的 TypeScript 库，用来和 WhatsApp Web API 交互。GitHub 上 10387 颗星。
它和 Puppeteer 类方案的区别一句话能说完：不需要 Selenium，不需要 Chromium，不需要任何浏览器，直接用 WebSocket 跟 WhatsApp Web 的服务端通信。README 给了个数字——省下大约半 GB 内存。对 1GB 内存的 VPS 来说，这不是优化，是能不能部署的区别。
它同时支持 WhatsApp 的多设备模式和 Web 版。
需要知道的一点：这套能力建立在社区逆向研究之上。README 明确致谢了三个来源——@pokearaujo 的多设备协议观察记录、@Sigalor 的 WhatsApp Web 逆向工程文档、@Rhymen 的 Go 语言实现。没有官方 SDK，协议是私有的，Baileys 是逆出来的。
三个信号，动手前先看
第一，7.0.0 有破坏性变更。 README 开头就是一条 CAUTION 警告，迁移说明在 https://whiskey.so/migrate-latest。这在逆向协议库里是常态：WhatsApp 改服务端，维护者只能跟着改。今天能跑的代码，下一个版本可能接口全变。
第二，README 本身就是个临时文件。 当前文件自己说了是 temporary README，新文档在 https://baileys.wiki，还在开发中，将来会替换成 .github/README.md。更扎眼的是结尾——原文写到 “The original repository had to be removed b” 就断了。能确认的事实只有一条：原仓库被下架过，原因没写。万星项目经历过仓库移除，这个历史值得掂量。
第三，核心维护者是个人。 当前维护者 Rajeh 每周投入几十个小时。支持分两条路：免费走 issue；付费是一小时视频咨询，通过 Discord 联系或在 https://purpshell.dev/book 预订，README 提醒时间槽经常约满。商业用户被明确呼吁通过订会议或赞助（https://purpshell.dev/sponsor）分担开发成本。业务押在这个库上，付费咨询该进预算。
免责声明里有硬信息
README 的 Disclaimer 不是模板套话，有几条实打实的：
- 项目与 WhatsApp 及其子公司没有任何关联、授权或背书，商标归各自所有者。
- 维护者明确反对违反 WhatsApp 服务条款的用法，反对垃圾消息、批量自动化群发和 stalkerware（跟踪软件）。
- 原话：”Use at your own discretion”。
还有一句值得注意的原文：”This is not condoning or endorsing businesses to use the library.”——维护者连“鼓励商用”的姿态都没有摆。封不封号由 WhatsApp 风控决定，和库无关。别拿主号或客户账号直接接入，这是底线。
我的判断
四个问题，答案都是“是”再动手：
- 有 Node.js/TypeScript 技术栈，出问题能读懂源码。
- 用途是正常集成——客服、内部通知这类，不是批量群发。
- 接受 API 随上游协议变化而中断。
- 有人持续盯上游变更和迁移文档。
对比 Puppeteer 方案，它省半吉内存；对比 Go/Python 的库，不用换语言。但依赖单人维护的逆向库，本质是技术债。要用就按债务管理的方式用：锁死版本，升级前把迁移文档当正式文档读，准备好退出方案。
有一个答不上来，就别上。