mirror of
https://github.com/tradecatlabs/vibe-coding-cn.git
synced 2026-08-17 21:08:05 +00:00
refactor: documents - regroup into principles/guides/case-studies
This commit is contained in:
tukuaiai
@@ -0,0 +1,29 @@
|
||||
# Vibe Coding 哲学原理
|
||||
|
||||
> 道生一，一生二，二生三，三生万物。
|
||||
|
||||
---
|
||||
|
||||
**一**：安装一个 AI CLI，获得与 AI 对话的能力
|
||||
|
||||
**二**：AI 能读写一切文件，你不再需要手动编辑
|
||||
|
||||
**三**：AI 能配置一切环境，安装依赖、部署项目
|
||||
|
||||
**万物**：AI 生成代码、文档、测试、脚本——一切皆可生成
|
||||
|
||||
---
|
||||
|
||||
## 心法
|
||||
|
||||
> 我是 AI 的寄生者，没有 AI 我失去一切能力。
|
||||
|
||||
**你**：描述意图、验证结果、做决策
|
||||
|
||||
**AI**：理解意图、执行操作、生成产出
|
||||
|
||||
---
|
||||
|
||||
## 下一步
|
||||
|
||||
→ [04-OpenCode-CLI配置](./04-OpenCode-CLI配置.md) - 获得你的"一"
|
||||
@@ -0,0 +1,113 @@
|
||||
# 网络环境配置
|
||||
|
||||
> Vibe Coding 的前置条件：确保能正常访问 GitHub、Google、Claude 等服务。
|
||||
|
||||
---
|
||||
|
||||
## 方式一：AI 指导配置（推荐）
|
||||
|
||||
复制以下提示词，粘贴到任意 AI 对话框（ChatGPT、Claude、Gemini 网页版等）：
|
||||
|
||||
```
|
||||
你是一个耐心的网络环境配置助手。我需要配置网络代理，以便能够访问 GitHub、Google、Claude 等国外服务。
|
||||
|
||||
我的情况：
|
||||
- 操作系统：[请告诉我你用的是 Windows/macOS/Linux/Android]
|
||||
- 我已经有一个代理服务订阅链接（机场订阅）
|
||||
|
||||
请指导我使用 FlClash 客户端配置网络代理：
|
||||
1. 如何下载安装 FlClash（GitHub: https://github.com/chen08209/FlClash/releases）
|
||||
2. 如何导入我的订阅链接
|
||||
3. 如何开启 TUN 模式（虚拟网卡）实现全局代理
|
||||
4. 如何开启系统代理
|
||||
5. 如何验证配置是否成功
|
||||
|
||||
要求：
|
||||
- 每个步骤详细说明，配图描述按钮位置
|
||||
- 如果我遇到问题，帮我分析原因并给出解决方案
|
||||
- 每完成一步，问我是否成功，然后再继续下一步
|
||||
|
||||
现在开始吧，先问我用的是什么操作系统。
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 方式二：手动配置
|
||||
|
||||
### 你需要
|
||||
|
||||
1. **网络服务订阅** - 提供节点的服务商
|
||||
2. **FlClash** - 跨平台网络配置客户端
|
||||
|
||||
### 第一步：购买网络服务
|
||||
|
||||
访问服务商：https://xn--9kqz23b19z.com/#/register?code=35BcnKzl
|
||||
|
||||
- 注册账号
|
||||
- 选择套餐（约 6 元/月起）
|
||||
- 付款后在用户面板找到 **订阅链接**，复制备用
|
||||
|
||||
### 第二步：下载 FlClash
|
||||
|
||||
GitHub 下载：https://github.com/chen08209/FlClash/releases
|
||||
|
||||
根据系统选择：
|
||||
- Windows: `FlClash-x.x.x-windows-setup.exe`
|
||||
- macOS: `FlClash-x.x.x-macos.dmg`
|
||||
- Linux: `FlClash-x.x.x-linux-amd64.AppImage`
|
||||
- Android: `FlClash-x.x.x-android.apk`
|
||||
|
||||
### 第三步：导入订阅
|
||||
|
||||
1. 打开 FlClash
|
||||
2. 点击 **配置** → **添加**
|
||||
3. 选择 **URL 导入**
|
||||
4. 粘贴第一步复制的订阅链接
|
||||
5. 点击确认，等待节点加载
|
||||
|
||||
### 第四步：开启代理
|
||||
|
||||
依次设置以下三项：
|
||||
|
||||
| 设置项 | 操作 |
|
||||
|:---|:---|
|
||||
| **虚拟网卡 (TUN)** | 开启 - 实现全局流量代理 |
|
||||
| **系统代理** | 开启 - 让系统应用走代理 |
|
||||
| **代理模式** | 选择 **全局模式** |
|
||||
|
||||
设置完成后，FlClash 主界面显示已连接即可。
|
||||
|
||||
### 验证
|
||||
|
||||
```bash
|
||||
# 测试 Google 连通性
|
||||
curl -I https://www.google.com
|
||||
|
||||
# 测试 GitHub 连通性
|
||||
curl -I https://github.com
|
||||
```
|
||||
|
||||
返回 `HTTP/2 200` 表示配置成功。
|
||||
|
||||
---
|
||||
|
||||
## 常见问题
|
||||
|
||||
**Q: 节点连不上？**
|
||||
A: 切换其他节点试试，或检查订阅是否过期。
|
||||
|
||||
**Q: 部分应用不走代理？**
|
||||
A: 确保 TUN 模式（虚拟网卡）已开启。
|
||||
|
||||
**Q: 想让终端也走代理？**
|
||||
A: TUN 模式开启后终端自动走代理；或手动设置：
|
||||
```bash
|
||||
export https_proxy=http://127.0.0.1:7890
|
||||
export http_proxy=http://127.0.0.1:7890
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 下一步
|
||||
|
||||
网络配置完成后，继续阅读 [02-开发环境搭建](./02-开发环境搭建.md)。
|
||||
@@ -0,0 +1,158 @@
|
||||
# 开发环境搭建提示词
|
||||
|
||||
> 使用方法：复制下方对应你设备的提示词，粘贴到任意 AI 对话框（ChatGPT、Claude、Gemini 网页版等），AI 会一步步指导你完成配置。
|
||||
|
||||
**前置条件**：请先完成 [01-网络环境配置](./01-网络环境配置.md)
|
||||
|
||||
---
|
||||
|
||||
## 🪟 Windows 用户提示词
|
||||
|
||||
### 方案 A：WSL2 + Linux 环境（推荐）
|
||||
|
||||
> 适合：想要完整 Linux 开发体验，兼容性最好
|
||||
|
||||
```
|
||||
你是一个耐心的开发环境配置助手。我是一个完全的新手，使用 Windows 系统，需要你一步一步指导我通过 WSL2 搭建 Linux 开发环境。
|
||||
|
||||
请按以下顺序指导我，每次只给我一个步骤，等我确认完成后再进行下一步：
|
||||
|
||||
1. 安装 WSL2（Windows Subsystem for Linux）
|
||||
2. 在 WSL2 中安装 Ubuntu
|
||||
3. 配置 Ubuntu 基础环境（更新系统）
|
||||
4. 安装 nvm 和 Node.js
|
||||
5. 安装 Gemini CLI 或其他免费 AI CLI 工具
|
||||
6. 安装基础开发工具（git, python, build-essential, tmux）
|
||||
7. 配置 Git 用户信息
|
||||
8. 安装代码编辑器（VS Code 并配置 WSL 插件）
|
||||
9. 验证所有工具是否正常工作
|
||||
|
||||
要求：
|
||||
- 每个步骤给出具体的命令，告诉我在哪里运行（PowerShell 还是 Ubuntu 终端）
|
||||
- 用简单易懂的语言解释每个命令的作用
|
||||
- 如果我遇到错误，帮我分析原因并给出解决方案
|
||||
- 每完成一步，问我是否成功，然后再继续下一步
|
||||
|
||||
现在开始第一步吧。
|
||||
```
|
||||
|
||||
### 方案 B：Windows 原生终端
|
||||
|
||||
> 适合：不想装 WSL，直接在 Windows 上开发
|
||||
|
||||
```
|
||||
你是一个耐心的开发环境配置助手。我是一个完全的新手，使用 Windows 系统，需要你一步一步指导我在 Windows 原生环境下搭建开发环境（不使用 WSL）。
|
||||
|
||||
请按以下顺序指导我，每次只给我一个步骤，等我确认完成后再进行下一步：
|
||||
|
||||
1. 安装 Windows Terminal（如果还没有）
|
||||
2. 安装 Node.js（通过官网安装包或 winget）
|
||||
3. 安装 Git for Windows
|
||||
4. 安装 Python
|
||||
5. 安装 Gemini CLI 或其他免费 AI CLI 工具
|
||||
6. 配置 Git 用户信息
|
||||
7. 安装代码编辑器（VS Code）
|
||||
8. 验证所有工具是否正常工作
|
||||
|
||||
要求：
|
||||
- 每个步骤给出具体的命令或操作步骤
|
||||
- 用简单易懂的语言解释每个步骤的作用
|
||||
- 如果我遇到错误，帮我分析原因并给出解决方案
|
||||
- 每完成一步，问我是否成功，然后再继续下一步
|
||||
|
||||
现在开始第一步吧。
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🍎 macOS 用户提示词
|
||||
|
||||
```
|
||||
你是一个耐心的开发环境配置助手。我是一个完全的新手，使用 macOS 系统，需要你一步一步指导我从零搭建 Vibe Coding 开发环境。
|
||||
|
||||
请按以下顺序指导我，每次只给我一个步骤，等我确认完成后再进行下一步：
|
||||
|
||||
1. 安装 Homebrew 包管理器
|
||||
2. 使用 Homebrew 安装 Node.js
|
||||
3. 安装 Gemini CLI 或其他免费 AI CLI 工具
|
||||
4. 安装基础开发工具（git, python, tmux）
|
||||
5. 配置 Git 用户信息
|
||||
6. 安装代码编辑器（VS Code 或 Neovim）
|
||||
7. 验证所有工具是否正常工作
|
||||
|
||||
要求：
|
||||
- 每个步骤给出具体的命令
|
||||
- 用简单易懂的语言解释每个命令的作用
|
||||
- 如果我遇到错误，帮我分析原因并给出解决方案
|
||||
- 每完成一步，问我是否成功，然后再继续下一步
|
||||
|
||||
现在开始第一步吧。
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🐧 Linux 用户提示词
|
||||
|
||||
```
|
||||
你是一个耐心的开发环境配置助手。我是一个完全的新手，使用 Linux 系统（Ubuntu/Debian），需要你一步一步指导我从零搭建 Vibe Coding 开发环境。
|
||||
|
||||
请按以下顺序指导我，每次只给我一个步骤，等我确认完成后再进行下一步：
|
||||
|
||||
1. 更新系统并安装基础依赖（curl, build-essential）
|
||||
2. 安装 nvm 和 Node.js
|
||||
3. 安装 Gemini CLI 或其他免费 AI CLI 工具
|
||||
4. 安装开发工具（git, python, tmux）
|
||||
5. 配置 Git 用户信息
|
||||
6. 安装代码编辑器（VS Code 或 Neovim）
|
||||
7. 验证所有工具是否正常工作
|
||||
|
||||
要求：
|
||||
- 每个步骤给出具体的命令
|
||||
- 用简单易懂的语言解释每个命令的作用
|
||||
- 如果我遇到错误，帮我分析原因并给出解决方案
|
||||
- 每完成一步，问我是否成功，然后再继续下一步
|
||||
|
||||
现在开始第一步吧。
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 配置完成后
|
||||
|
||||
### CLI 工具配置技巧
|
||||
|
||||
AI CLI 工具默认会询问确认，开启全权限模式可以跳过：
|
||||
|
||||
```bash
|
||||
# Codex - 最强配置
|
||||
codex --enable web_search_request -m gpt-5.3-codex-max -c model_reasoning_effort="high" --dangerously-bypass-approvals-and-sandbox
|
||||
|
||||
# Claude Code - 跳过所有确认
|
||||
claude --dangerously-skip-permissions
|
||||
|
||||
# Gemini CLI - YOLO 模式
|
||||
gemini --yolo
|
||||
```
|
||||
|
||||
### 推荐的 Bash 别名配置
|
||||
|
||||
在 `~/.bashrc` 中添加以下配置，一个字母启动 AI：
|
||||
|
||||
```bash
|
||||
# c - Codex (GPT-5.1 最强模式)
|
||||
alias c='codex --enable web_search_request -m gpt-5.3-codex-max -c model_reasoning_effort="high" --dangerously-bypass-approvals-and-sandbox'
|
||||
|
||||
# cc - Claude Code (全权限)
|
||||
alias cc='claude --dangerously-skip-permissions'
|
||||
|
||||
# g - Gemini CLI (YOLO 模式)
|
||||
alias g='gemini --yolo'
|
||||
```
|
||||
|
||||
配置后执行 `source ~/.bashrc` 生效。
|
||||
|
||||
---
|
||||
|
||||
环境搭建完成后，继续下一步：
|
||||
|
||||
→ [03-IDE配置](./03-IDE配置.md) - 配置 VS Code 开发环境
|
||||
@@ -0,0 +1,172 @@
|
||||
# IDE 配置提示词
|
||||
|
||||
> 使用方法：复制下方对应你 IDE 的提示词，粘贴到任意 AI 对话框，AI 会一步步指导你完成配置。
|
||||
|
||||
**前置条件**：请先完成 [02-开发环境搭建](./02-开发环境搭建.md)
|
||||
|
||||
---
|
||||
|
||||
## 选择你的 IDE
|
||||
|
||||
- [VS Code](#vs-code) - 免费，最通用
|
||||
- [Cursor](#cursor) - AI 原生 IDE，基于 VS Code
|
||||
- [Windsurf](#windsurf) - AI 原生 IDE，新用户有免费额度
|
||||
|
||||
---
|
||||
|
||||
## VS Code
|
||||
|
||||
### 🪟 Windows + WSL 用户
|
||||
|
||||
```
|
||||
你是一个耐心的 VS Code 配置助手。我已经安装好了 WSL2 和 Ubuntu，现在需要你一步一步指导我配置 VS Code 以获得最佳的 WSL 开发体验。
|
||||
|
||||
请按以下顺序指导我，每次只给我一个步骤，等我确认完成后再进行下一步：
|
||||
|
||||
1. 在 Windows 上安装 VS Code（如果还没装）
|
||||
2. 安装 Remote - WSL 扩展
|
||||
3. 通过 WSL 打开项目文件夹
|
||||
4. 安装基础开发扩展（GitLens、Prettier、ESLint、Local History）
|
||||
5. 配置终端默认使用 WSL
|
||||
6. 配置自动保存和格式化
|
||||
7. 验证配置是否正常工作
|
||||
|
||||
要求：
|
||||
- 每个步骤给出具体的操作方法
|
||||
- 如果我遇到问题，帮我分析原因并给出解决方案
|
||||
- 每完成一步，问我是否成功，然后再继续下一步
|
||||
|
||||
现在开始第一步吧。
|
||||
```
|
||||
|
||||
### 🪟 Windows 原生用户
|
||||
|
||||
```
|
||||
你是一个耐心的 VS Code 配置助手。我使用 Windows 系统（不使用 WSL），现在需要你一步一步指导我配置 VS Code。
|
||||
|
||||
请按以下顺序指导我，每次只给我一个步骤，等我确认完成后再进行下一步：
|
||||
|
||||
1. 安装 VS Code（如果还没装）
|
||||
2. 安装基础开发扩展（GitLens、Prettier、ESLint、Local History）
|
||||
3. 配置终端使用 PowerShell 或 Git Bash
|
||||
4. 配置自动保存和格式化
|
||||
5. 配置 Git 集成
|
||||
6. 验证配置是否正常工作
|
||||
|
||||
要求：
|
||||
- 每个步骤给出具体的操作方法
|
||||
- 如果我遇到问题，帮我分析原因并给出解决方案
|
||||
- 每完成一步，问我是否成功，然后再继续下一步
|
||||
|
||||
现在开始第一步吧。
|
||||
```
|
||||
|
||||
### 🍎 macOS 用户
|
||||
|
||||
```
|
||||
你是一个耐心的 VS Code 配置助手。我使用 macOS 系统，现在需要你一步一步指导我配置 VS Code。
|
||||
|
||||
请按以下顺序指导我，每次只给我一个步骤，等我确认完成后再进行下一步：
|
||||
|
||||
1. 安装 VS Code（通过 Homebrew 或官网）
|
||||
2. 配置 code 命令行工具
|
||||
3. 安装基础开发扩展（GitLens、Prettier、ESLint、Local History）
|
||||
4. 配置自动保存和格式化
|
||||
5. 验证配置是否正常工作
|
||||
|
||||
要求：
|
||||
- 每个步骤给出具体的操作方法
|
||||
- 如果我遇到问题，帮我分析原因并给出解决方案
|
||||
- 每完成一步，问我是否成功，然后再继续下一步
|
||||
|
||||
现在开始第一步吧。
|
||||
```
|
||||
|
||||
### 🐧 Linux 用户
|
||||
|
||||
```
|
||||
你是一个耐心的 VS Code 配置助手。我使用 Linux 系统（Ubuntu/Debian），现在需要你一步一步指导我配置 VS Code。
|
||||
|
||||
请按以下顺序指导我，每次只给我一个步骤，等我确认完成后再进行下一步：
|
||||
|
||||
1. 安装 VS Code（通过 apt 或 snap）
|
||||
2. 安装基础开发扩展（GitLens、Prettier、ESLint、Local History）
|
||||
3. 配置自动保存和格式化
|
||||
4. 配置终端集成
|
||||
5. 验证配置是否正常工作
|
||||
|
||||
要求：
|
||||
- 每个步骤给出具体的操作方法
|
||||
- 如果我遇到问题，帮我分析原因并给出解决方案
|
||||
- 每完成一步，问我是否成功，然后再继续下一步
|
||||
|
||||
现在开始第一步吧。
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Cursor
|
||||
|
||||
> AI 原生 IDE，基于 VS Code，内置 AI 编程功能。官网：https://cursor.com
|
||||
|
||||
```
|
||||
你是一个耐心的 Cursor IDE 配置助手。我想使用 Cursor 作为我的主要开发工具，需要你一步一步指导我完成安装和配置。
|
||||
|
||||
我的操作系统是：[请告诉我你用的是 Windows/macOS/Linux]
|
||||
|
||||
请按以下顺序指导我，每次只给我一个步骤，等我确认完成后再进行下一步：
|
||||
|
||||
1. 下载并安装 Cursor（官网：https://cursor.com）
|
||||
2. 首次启动配置（登录、选择主题等）
|
||||
3. 导入 VS Code 设置和扩展（如果之前用过 VS Code）
|
||||
4. 配置 AI 功能（API Key 或订阅）
|
||||
5. 学习 Cursor 的核心快捷键：
|
||||
- Cmd/Ctrl + K：AI 编辑
|
||||
- Cmd/Ctrl + L：AI 聊天
|
||||
- Cmd/Ctrl + I：Composer 模式
|
||||
6. 配置自动保存
|
||||
7. 验证 AI 功能是否正常工作
|
||||
|
||||
要求：
|
||||
- 每个步骤给出具体的操作方法
|
||||
- 解释 Cursor 相比 VS Code 的独特功能
|
||||
- 如果我遇到问题，帮我分析原因并给出解决方案
|
||||
- 每完成一步，问我是否成功，然后再继续下一步
|
||||
|
||||
现在先问我用的是什么操作系统吧。
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Windsurf
|
||||
|
||||
> AI 原生 IDE，新用户有免费额度。官网：https://windsurf.com
|
||||
|
||||
```
|
||||
你是一个耐心的 Windsurf IDE 配置助手。我想使用 Windsurf 作为我的开发工具，需要你一步一步指导我完成安装和配置。
|
||||
|
||||
我的操作系统是：[请告诉我你用的是 Windows/macOS/Linux]
|
||||
|
||||
请按以下顺序指导我，每次只给我一个步骤，等我确认完成后再进行下一步：
|
||||
|
||||
1. 下载并安装 Windsurf（官网：https://windsurf.com）
|
||||
2. 注册账号并登录（新用户有免费额度）
|
||||
3. 首次启动配置
|
||||
4. 了解 Windsurf 的 AI 功能（Cascade 等）
|
||||
5. 配置基础开发环境
|
||||
6. 验证 AI 功能是否正常工作
|
||||
|
||||
要求：
|
||||
- 每个步骤给出具体的操作方法
|
||||
- 解释 Windsurf 的独特功能
|
||||
- 如果我遇到问题，帮我分析原因并给出解决方案
|
||||
- 每完成一步，问我是否成功，然后再继续下一步
|
||||
|
||||
现在先问我用的是什么操作系统吧。
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 配置完成后
|
||||
|
||||
IDE 配置完成后，阅读 [README.md](../../../../README.md) 了解 Vibe Coding 工作流，开始你的第一个项目！
|
||||
@@ -0,0 +1,187 @@
|
||||
# OpenCode CLI 配置
|
||||
|
||||
> 免费 AI 编程助手，支持 75+ 模型，无需信用卡
|
||||
|
||||
OpenCode 是一个开源 AI 编程代理，支持终端、桌面应用和 IDE 扩展。无需账号即可使用免费模型。
|
||||
|
||||
官网：[opencode.ai](https://opencode.ai/)
|
||||
|
||||
---
|
||||
|
||||
## 安装
|
||||
|
||||
```bash
|
||||
# 一键安装（推荐）
|
||||
curl -fsSL https://opencode.ai/install | bash
|
||||
|
||||
# 或使用 npm
|
||||
npm install -g opencode-ai
|
||||
|
||||
# 或使用 Homebrew (macOS/Linux)
|
||||
brew install anomalyco/tap/opencode
|
||||
|
||||
# Windows - Scoop
|
||||
scoop bucket add extras && scoop install extras/opencode
|
||||
|
||||
# Windows - Chocolatey
|
||||
choco install opencode
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 免费模型配置
|
||||
|
||||
OpenCode 支持多个免费模型提供商，无需付费即可使用。
|
||||
|
||||
### 方式一：Z.AI（推荐，GLM-4.7）
|
||||
|
||||
1. 访问 [Z.AI API 控制台](https://z.ai/manage-apikey/apikey-list) 注册并创建 API Key
|
||||
2. 运行 `/connect` 命令，搜索 **Z.AI**
|
||||
3. 输入 API Key
|
||||
4. 运行 `/models` 选择 **GLM-4.7**
|
||||
|
||||
```bash
|
||||
opencode
|
||||
# 进入后输入
|
||||
/connect
|
||||
# 选择 Z.AI，输入 API Key
|
||||
/models
|
||||
# 选择 GLM-4.7
|
||||
```
|
||||
|
||||
### 方式二：MiniMax（M2.1）
|
||||
|
||||
1. 访问 [MiniMax API 控制台](https://platform.minimax.io/login) 注册并创建 API Key
|
||||
2. 运行 `/connect`，搜索 **MiniMax**
|
||||
3. 输入 API Key
|
||||
4. 运行 `/models` 选择 **M2.1**
|
||||
|
||||
### 方式三：Hugging Face（多种免费模型）
|
||||
|
||||
1. 访问 [Hugging Face 设置](https://huggingface.co/settings/tokens/new?ownUserPermissions=inference.serverless.write&tokenType=fineGrained) 创建 Token
|
||||
2. 运行 `/connect`，搜索 **Hugging Face**
|
||||
3. 输入 Token
|
||||
4. 运行 `/models` 选择 **Kimi-K2-Instruct** 或 **GLM-4.6**
|
||||
|
||||
### 方式四：本地模型（Ollama）
|
||||
|
||||
```bash
|
||||
# 安装 Ollama
|
||||
curl -fsSL https://ollama.com/install.sh | sh
|
||||
|
||||
# 拉取模型
|
||||
ollama pull llama2
|
||||
```
|
||||
|
||||
在 `opencode.json` 中配置：
|
||||
|
||||
```json
|
||||
{
|
||||
"$schema": "https://opencode.ai/config.json",
|
||||
"provider": {
|
||||
"ollama": {
|
||||
"npm": "@ai-sdk/openai-compatible",
|
||||
"name": "Ollama (local)",
|
||||
"options": {
|
||||
"baseURL": "http://localhost:11434/v1"
|
||||
},
|
||||
"models": {
|
||||
"llama2": {
|
||||
"name": "Llama 2"
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 核心命令
|
||||
|
||||
| 命令 | 功能 |
|
||||
|:---|:---|
|
||||
| `/models` | 切换模型 |
|
||||
| `/connect` | 添加 API Key |
|
||||
| `/init` | 初始化项目（生成 AGENTS.md） |
|
||||
| `/undo` | 撤销上次修改 |
|
||||
| `/redo` | 重做 |
|
||||
| `/share` | 分享对话链接 |
|
||||
| `Tab` | 切换 Plan 模式（只规划不执行） |
|
||||
|
||||
---
|
||||
|
||||
## 让 AI 执行一切配置任务
|
||||
|
||||
OpenCode 的核心思维：**把所有配置任务交给 AI**。
|
||||
|
||||
### 示例：安装 MCP 服务器
|
||||
|
||||
```
|
||||
帮我安装 filesystem MCP 服务器，配置到 opencode
|
||||
```
|
||||
|
||||
### 示例：部署 GitHub 开源项目
|
||||
|
||||
```
|
||||
克隆 https://github.com/xxx/yyy 项目，阅读 README，帮我完成所有依赖安装和环境配置
|
||||
```
|
||||
|
||||
### 示例：配置 Skills
|
||||
|
||||
```
|
||||
阅读项目结构，为这个项目创建合适的 AGENTS.md 规则文件
|
||||
```
|
||||
|
||||
### 示例：配置环境变量
|
||||
|
||||
```
|
||||
检查项目需要哪些环境变量，帮我创建 .env 文件模板并说明每个变量的用途
|
||||
```
|
||||
|
||||
### 示例：安装依赖
|
||||
|
||||
```
|
||||
分析 package.json / requirements.txt，安装所有依赖，解决版本冲突
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 推荐工作流
|
||||
|
||||
1. **进入项目目录**
|
||||
```bash
|
||||
cd /path/to/project
|
||||
opencode
|
||||
```
|
||||
|
||||
2. **初始化项目**
|
||||
```
|
||||
/init
|
||||
```
|
||||
|
||||
3. **切换免费模型**
|
||||
```
|
||||
/models
|
||||
# 选择 GLM-4.7 或 MiniMax M2.1
|
||||
```
|
||||
|
||||
4. **开始工作**
|
||||
- 先用 `Tab` 切换到 Plan 模式，让 AI 规划
|
||||
- 确认方案后再让 AI 执行
|
||||
|
||||
---
|
||||
|
||||
## 配置文件位置
|
||||
|
||||
- 全局配置：`~/.config/opencode/opencode.json`
|
||||
- 项目配置：`./opencode.json`（项目根目录）
|
||||
- 认证信息：`~/.local/share/opencode/auth.json`
|
||||
|
||||
---
|
||||
|
||||
## 相关资源
|
||||
|
||||
- [OpenCode 官方文档](https://opencode.ai/docs/)
|
||||
- [GitHub 仓库](https://github.com/opencode-ai/opencode)
|
||||
- [Models.dev - 模型目录](https://models.dev)
|
||||
@@ -0,0 +1,15 @@
|
||||
# 🚀 入门指南
|
||||
|
||||
> 从零开始学习 Vibe Coding，配置环境
|
||||
|
||||
## 📚 学习路径
|
||||
|
||||
1. [Vibe Coding 哲学原理](./00-Vibe%20Coding%20哲学原理.md) - 理解核心理念
|
||||
2. [网络环境配置](./01-网络环境配置.md) - 配置网络访问
|
||||
3. [开发环境搭建](./02-开发环境搭建.md) - 搭建开发环境
|
||||
4. [IDE 配置](./03-IDE配置.md) - 配置编辑器
|
||||
|
||||
## 🔗 相关资源
|
||||
- [基础指南](../00-基础指南/) - 核心理念与方法论
|
||||
- [方法论](../02-方法论/) - 工具与经验
|
||||
- [实战](../03-实战/) - 动手实践项目
|
||||
Reference in New Issue
Block a user