Bun（实验性）

目标：用 Bun 运行本仓库（可选，不推荐用于 WhatsApp/Telegram），同时不偏离 pnpm 工作流。
⚠️ 不推荐用于 Gateway 运行时（WhatsApp/Telegram 存在已知问题）。生产环境请使用 Node。

状态

• Bun 可作为可选的本地运行时，直接运行 TypeScript（bun run …、bun --watch …）。
• pnpm 为默认构建工具且完全支持（部分文档工具也在使用）。
• Bun 无法使用 pnpm-lock.yaml，会忽略该文件。

安装

默认：

bun install

说明：bun.lock / bun.lockb 已加入 gitignore，不会产生仓库变更。若希望不写入 lockfile：

bun install --no-save

构建 / 测试（Bun）

bun run build
bun run vitest run

Bun 生命周期脚本（默认被阻止）

Bun 可能会阻止依赖的生命周期脚本，除非显式信任（bun pm untrusted / bun pm trust）。
本仓库中常被阻止的脚本并非必需：

• @whiskeysockets/baileys 的 preinstall：检查 Node 主版本 >= 20（我们使用 Node 22+）。
• protobufjs 的 postinstall：会输出版本方案不兼容的警告（无构建产物）。

若遇到必须启用这些脚本才能解决的运行时问题，可显式信任：

bun pm trust @whiskeysockets/baileys protobufjs

注意事项

• 部分脚本仍写死使用 pnpm（如 docs:build、ui:*、protocol:check）。目前请用 pnpm 执行这些命令。