enoch
635d113b4f
- 添加 kilocode devcontainer 配置 - 新增 Fedora 和 Ubuntu Dockerfile - 添加构建自动化 (Makefile, compose.yml) - 配置环境变量管理 (.env, .env.example)
3.0 KiB
3.0 KiB
🛸 Vibe Coding 环境使用指南
这是一个深度集成了 Rust、Bun 和 AI 助手 的全自动化开发环境，专为追求“极速、丝滑、AI 优先”的开发者设计。
🛠️ 第一步：初始化与启动
在宿主机（你的个人电脑）上执行以下操作：
- 准备配置文件：
将提供的
Dockerfile、docker-compose.yml、entrypoint.sh和.env.example放入项目根目录。 - 配置密钥：
cp .env.example .env
# 修改 .env，填入你的 Anthropic/OpenAI/OpenCode API Keys
- 一键构建并启动：
docker compose up -d --build
🎨 第二步：配置 Zed 远程连接
Zed 是 Vibe Coding 的绝佳拍档，其极低的响应延迟能让你感受到 AI 实时生成的快感。
- 修改宿主机 SSH 配置：
在你的本地终端编辑
~/.ssh/config，添加以下内容：
Host vibe
HostName localhost
User root
Port 2222
IdentityFile ~/.ssh/id_rsa # 指向你的私钥
- 在 Zed 中打开：
- 启动 Zed。
- 唤起命令面板 (
Cmd/Ctrl + Shift + P)。 - 输入
Remote Projects: Open Remote Project并选择vibe。 - 路径选择
/workspace。
🤖 第三步：开启 Vibe Coding 工作流
环境启动后，所有的 AI 交互都在 Zed 的内置终端 中进行。
使用 OpenCode (快速指令与辅助)
如果想通过简单的指令快速调整代码：
# 登录 (仅需首次)
opencode auth login
# 执行任务
opencode "优化当前目录下 main.rs 的错误处理逻辑"
🚀 性能说明
该环境通过 Named Volumes (命名卷) 实现了四重加速，即使运行 docker compose down 后再重启，以下内容也不会丢失：
- Rust 编译加速：
cargo-cache卷保留了所有已下载的第三方库。 - Bun 依赖加速：
bun-cache避免了重复下载 node_modules 依赖。 - Zed 启动加速：
zed-server卷缓存了远程后端二进制文件。 - 工具持久化：通过
bun -g安装的工具在容器重建后依然可用。
🧹 常用维护命令
| 任务 | 命令 |
|---|---|
| 彻底重启环境 | docker compose restart |
| 更新 AI 工具 (Aider) | pip install --upgrade aider-chat (容器内运行) |
| 更换基础镜像 (OS) | 修改 docker-compose.yml 中的 dockerfile 后运行 docker compose up --build |
| 清理所有构建缓存 | docker compose down -v (警告：这将清空 Cargo/Bun 缓存) |
❓ 常见问题排查
- SSH 连接被拒绝：请检查
docker ps确保容器正在运行，且端口2222已映射。 - Zed 连接极慢：由于我们配置了
zed-server卷，只有第一次连接会下载，后续应该是秒开。如果一直慢，请检查宿主机的网络能否访问 Zed 的下载服务器。 - 权限问题：如果在宿主机手动删除了某些文件导致容器内报错，尝试运行
chown -R root:root .。