mirror of
https://github.com/robcholz/vibebox.git
synced 2026-04-08 01:12:02 +02:00
5.1 KiB
5.1 KiB
超高速、开源的 AI 沙盒。
安装
# YOLO：一键安装（推荐）
curl -fsSL https://raw.githubusercontent.com/robcholz/vibebox/main/install | bash
# Cargo
cargo install vibebox
# 或者手动安装（不推荐）
curl -LO https://github.com/robcholz/vibebox/releases/download/latest/vibebox-macos-arm64.zip
unzip vibebox-macos-arm64.zip
mkdir -p ~/.local/bin
mv vibe ~/.local/bin
export PATH="$HOME/.local/bin:$PATH"
Tip
强烈建议直接用
YOLO方式安装，省事且更不容易踩坑。
系统要求
- Apple Silicon 的 macOS（VibeBox 使用了 Apple 的虚拟化 API）。
首次运行
第一次执行 vibebox 会下载 Debian 基础镜像并完成初始化。之后每个项目的实例会复用缓存的基础镜像，
启动会快很多。
文档
快速开始
cd /path/to/your/project
vibebox
第一次运行时，如果项目目录里缺少配置，VibeBox 会自动创建 vibebox.toml（放在项目根目录），并创建
.vibebox/ 用来保存实例数据。
配置（vibebox.toml）
默认情况下，vibebox.toml 位于项目根目录。你可以用 vibebox -c path/to/vibebox.toml 或设置
VIBEBOX_CONFIG_PATH 环境变量来覆盖路径，但配置文件必须仍然位于项目目录内部。
默认配置（缺失时会自动生成）：
[box]
cpu_count = 2
ram_mb = 2048
disk_gb = 5
mounts = [
"~/.codex:~/.codex:read-write",
"~/.claude:~/.claude:read-write",
]
[supervisor]
auto_shutdown_ms = 20000
注意：disk_gb 只在「首次创建实例磁盘」时生效。之后如果你改了它，需要运行 vibebox reset 重新创建磁盘。
挂载（Mounts）
- 你的项目会以读写方式挂载到
~/<project-name>，并且 shell 会默认从那里启动。 - 如果项目里存在
.git目录，VM 内会用 tmpfs 把它遮住，避免你在 guest 里误操作改到 Git 元数据。 - 额外挂载通过
box.mounts配置，格式为host:guest[:read-only|read-write]。 - Host 路径支持
~展开；guest 的相对路径会被视为/root/<path>。 - guest 路径如果用了
~，会为了方便被链接到/home/<ssh-user>下。你可以运行vibebox explain查看最终解析后的 host/guest 映射关系。
CLI 命令
vibebox # 启动或连接当前项目的 VM
vibebox list # 列出已知的项目会话
vibebox reset # 删除当前项目的 .vibebox，下一次运行会重新创建
vibebox purge-cache # 删除全局缓存（~/.cache/vibebox）
vibebox explain # 显示挂载与网络信息
在 VM 内部
- 默认 SSH 用户：
vibecoder - 主机名：
vibebox - 基础镜像初始化会安装：构建工具、
git、curl、ripgrep、openssh-server、sudo - 首次登录时，VibeBox 会安装
mise，并尽力配置uv、node、@openai/codex、@anthropic-ai/claude-code等工具（best-effort，视网络和环境而定） - Shell 里有两个别名：
:help和:exit
状态与缓存
- 项目级状态在
.vibebox/（实例磁盘、SSH key、日志、manager socket/pid）。vibebox reset会移除它。 - 全局缓存在
~/.cache/vibebox（基础镜像 + 共享 guest 缓存）。vibebox purge-cache会清空它。 - 会话索引在
~/.vibebox/sessions，可以通过vibebox list查看。
参与贡献
如果你想参与贡献 VibeBox，请先阅读 贡献指南，再提交 Pull Request。
使用 VibeBox
欢迎使用，也别忘了顺手帮 VibeBox 做点宣传！
FAQ
它和其它 Sandboxes 有什么不同？
Vibebox 追求的是：本地、可复现、启动快、流程简单。主要差异点：
- 在我的 M3 上，热启动通常 6 秒以内，可以非常快地回到工作状态。
- 一个命令——
vibebox——直接把你带进沙盒（从你的项目目录启动）。 - 配置集中在
vibebox.toml，CPU / 内存 / 磁盘大小 / 挂载都能一眼看懂、随手改。
特别鸣谢
vibe by lynaghk。
以及 Rust 社区。没有你们丰富的 crates 生态和优秀的工具链（比如 crates.io）， 这个项目不可能这么顺利！Rust教。
在 X 上关注我 X.com