快速开始

如果你想用最短路径从零到第一个可工作的 bundle，就从这里开始。本指南说明 VibeBasket 做什么、如何安全地 apply 一个 bundle，以及在自托管场景下首次运行时应期待什么。

核心方法

VibeBasket 是一个面向 AI IDE 的 bundle-and-apply 工作流，用于分发 MCP servers、Skills 和 Rules。你在目录中选择条目，生成 bundle，然后用一条命令在本地 apply。安装器以幂等方式写入，在修改受支持的配置前会先做备份，并在 adapter 支持 readback 时验证写入结果。

Bundle 生命周期

未登录用户创建的匿名 bundle 会在 48 小时后过期。已注册用户的 bundle 会保留 365 天。过期 bundle 会由平台的定期清理任务自动删除。使用 GitHub、Google、Apple 或 Microsoft Entra ID 登录即可长期保留 bundle。

安装

拿到 bundle URL 后，请在你真正希望落盘配置的机器或项目目录中运行生成的命令：

终端

bash

npx vibebasket apply https://vibebasket.dev/api/bundle/cj2k9x

全局 CLI 用法

npx 命令无需全局安装即可运行 CLI。高级用户也可以通过 npm i -g vibebasket 全局安装，然后直接运行 vibebasket 而不经过 npx。如果你在自托管环境中使用，首次目录同步通常会是全新安装里最慢的一步。