enoch
635d113b4f
- 添加 kilocode devcontainer 配置 - 新增 Fedora 和 Ubuntu Dockerfile - 添加构建自动化 (Makefile, compose.yml) - 配置环境变量管理 (.env, .env.example)
104 lines
3.0 KiB
Markdown
104 lines
3.0 KiB
Markdown
# 🛸 Vibe Coding 环境使用指南
|
||
|
||
这是一个深度集成了 **Rust**、**Bun** 和 **AI 助手** 的全自动化开发环境，专为追求“极速、丝滑、AI 优先”的开发者设计。
|
||
|
||
---
|
||
|
||
## 🛠️ 第一步：初始化与启动
|
||
|
||
在宿主机（你的个人电脑）上执行以下操作：
|
||
|
||
1. **准备配置文件**：
|
||
将提供的 `Dockerfile`、`docker-compose.yml`、`entrypoint.sh` 和 `.env.example` 放入项目根目录。
|
||
2. **配置密钥**：
|
||
```bash
|
||
cp .env.example .env
|
||
# 修改 .env，填入你的 Anthropic/OpenAI/OpenCode API Keys
|
||
|
||
```
|
||
|
||
|
||
3. **一键构建并启动**：
|
||
```bash
|
||
docker compose up -d --build
|
||
|
||
```
|
||
|
||
|
||
|
||
---
|
||
|
||
## 🎨 第二步：配置 Zed 远程连接
|
||
|
||
Zed 是 Vibe Coding 的绝佳拍档，其极低的响应延迟能让你感受到 AI 实时生成的快感。
|
||
|
||
1. **修改宿主机 SSH 配置**：
|
||
在你的本地终端编辑 `~/.ssh/config`，添加以下内容：
|
||
```text
|
||
Host vibe
|
||
HostName localhost
|
||
User root
|
||
Port 2222
|
||
IdentityFile ~/.ssh/id_rsa # 指向你的私钥
|
||
|
||
```
|
||
|
||
|
||
2. **在 Zed 中打开**：
|
||
* 启动 Zed。
|
||
* 唤起命令面板 (`Cmd/Ctrl + Shift + P`)。
|
||
* 输入 `Remote Projects: Open Remote Project` 并选择 `vibe`。
|
||
* 路径选择 `/workspace`。
|
||
|
||
|
||
|
||
---
|
||
|
||
## 🤖 第三步：开启 Vibe Coding 工作流
|
||
|
||
环境启动后，所有的 AI 交互都在 **Zed 的内置终端** 中进行。
|
||
|
||
|
||
### 使用 OpenCode (快速指令与辅助)
|
||
|
||
如果想通过简单的指令快速调整代码：
|
||
|
||
```bash
|
||
# 登录 (仅需首次)
|
||
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 .`。
|
||
|
||
|