添加 kilocode 容器支持和通用 Docker 配置

- 添加 kilocode devcontainer 配置
- 新增 Fedora 和 Ubuntu Dockerfile
- 添加构建自动化 (Makefile, compose.yml)
- 配置环境变量管理 (.env, .env.example)
This commit is contained in:
2025-12-25 00:28:15 +08:00
parent aca5f52bc2
commit 635d113b4f
14 changed files with 605 additions and 1 deletions

103
vibe-dev/README.md Normal file
View File

@@ -0,0 +1,103 @@
# 🛸 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 .`