OC
OpenClaw 中文解释版

给五岁小朋友也能看懂的说明书

简要总结

Bun (Experimental)

这页说明书在讲一个叫 Bun 的新玩具(还在试验阶段)。它有点像另一个“小帮手”,可以帮你更快地运行一些程序。但是,如果你要用它来玩 WhatsApp 或者 Telegram 游戏,我们不推荐哦,可能会有小 bug。平时搭建积木(build)或者用其他工具时,还是用原来的 pnpm 更稳当。

这页适合你想试试新玩具 Bun 的时候看,会告诉你怎么安装、怎么用它来运行和测试,还有哪些地方要小心。

五岁小孩版解释

Bun 是一个还在试验中的新工具,你可以把它想成一个跑得很快的“小帮手”,能直接运行 TypeScript 代码。但是,它现在还不能很好地和 WhatsApp 或 Telegram 一起工作,可能会有奇怪的 bug。所以,如果你要玩这两个应用,最好还是用原来的 Node 小帮手。

安装 Bun 要开始用 Bun 小帮手,你需要先让它认识这个项目里的所有积木块(依赖包)。

  1. 打开你的终端(就像对电脑下命令的小窗口)。
  2. 输入 bun install 然后按回车。Bun 就会去把需要的积木块都搬过来。
    • 小心哦:Bun 会自己生成一个叫 bun.lock 的小本本来记录它搬了哪些积木,但我们故意不让这个小本本保存到你的项目里,所以不用担心弄乱。
    • 如果你连这个小本本都不想让它写,可以输入 bun install --no-save

用 Bun 来搭建和测试 安装好积木块后,你就可以让 Bun 小帮手帮你干活了。

  1. 搭建项目:输入 bun run build。这就像对 Bun 说:“请按照图纸,把所有的积木块搭建成一个完整的大城堡!”
  2. 测试项目:输入 bun run vitest run。这就像对 Bun 说:“请检查一下,我们搭好的城堡每个房间都牢固吗?有没有哪里松动了?”

关于“生命周期脚本”的小麻烦 有些积木块(依赖包)自己带了安装前或安装后要执行的小指令(叫“生命周期脚本”)。Bun 小帮手比较谨慎,默认会拦住这些指令,除非你明确告诉它“我相信这个积木块”。

  • 在我们这个项目里,被拦住的两个指令其实不重要,不会影响你玩。
    • 一个是检查 Node 版本的,我们用的版本已经够新了。
    • 另一个只是会发出一些无关紧要的警告。
  • 但如果以后你真的遇到了问题,需要允许这些指令,你可以用这个命令告诉 Bun 去信任它们:bun pm trust @whiskeysockets/baileys protobufjs

需要注意的事情 Bun 小帮手现在还不是很完美,有些地方要记住:

  • 它不认识 pnpm 用的那个记录积木块清单的小本本(pnpm-lock.yaml),会直接忽略它。
  • 项目里有一些脚本(比如 docs:build, ui:*, protocol:check)还是写死了要用 pnpm 来运行。如果你要运行这些脚本,记得暂时切换回 pnpm 命令哦。