mirror of
https://github.com/tradecatlabs/vibe-coding-cn.git
synced 2026-08-18 13:28:11 +00:00
refactor(i18n): 重构中文文档结构并同步更新链接
主要变更:
1. **目录重命名**:
* 将 下的 , , 重命名为中文的 , , 。
2. **新增新手入门**:
* 创建 目录,为新用户提供入门指南。
3. **文件迁移与清理**:
* 将原有文档迁移到新的中文目录结构下。
* 删除了部分过时或重复的中文文档。
4. **链接与脚本同步**:
* 更新了根 , 以及 中所有指向旧路径的链接。
* 修改了 下的英文文档,以反映中文文档的结构变化。
* 更新了 翻译脚本,使其能够处理新的中文路径。
此次重构统一了中文文档的目录命名,使其更符合中文用户的习惯,并优化了整体文档的组织结构,提升了可维护性。
This commit is contained in:
@@ -8,7 +8,11 @@
|
||||
i18n/zh/documents/
|
||||
├── README.md
|
||||
│
|
||||
├── Methodology and Principles/
|
||||
├── 从零开始vibecoding/ # 🚀 新手入门必读
|
||||
│ ├── 01-网络环境配置.md
|
||||
│ └── 02-开发环境搭建.md
|
||||
│
|
||||
├── 方法论与原则/
|
||||
│ ├── A Formalization of Recursive Self-Optimizing Generative Systems.md
|
||||
│ ├── gluecoding.md
|
||||
│ ├── vibe-coding-经验收集.md
|
||||
@@ -18,14 +22,14 @@ i18n/zh/documents/
|
||||
│ ├── 胶水编程.md
|
||||
│ └── 系统提示词构建原则.md
|
||||
│
|
||||
├── Tutorials and Guides/
|
||||
├── 教程与指南/
|
||||
│ ├── auggie-mcp配置文档.md
|
||||
│ ├── LazyVim快捷键大全.md
|
||||
│ ├── tmux快捷键大全.md
|
||||
│ ├── 关于手机ssh任意位置链接本地计算机,基于frp实现的方法.md
|
||||
│ └── telegram-dev/
|
||||
│
|
||||
└── Templates and Resources/
|
||||
└── 模板与资源/
|
||||
├── 代码组织.md
|
||||
├── 工具集.md
|
||||
├── 编程书籍推荐.md
|
||||
@@ -34,7 +38,14 @@ i18n/zh/documents/
|
||||
|
||||
## 文档分类
|
||||
|
||||
### Methodology and Principles
|
||||
### 🚀 从零开始vibecoding(新手入门)
|
||||
|
||||
完全零基础?从这里开始!
|
||||
|
||||
* [01-网络环境配置](./从零开始vibecoding/01-网络环境配置.md) - 配置网络访问
|
||||
* [02-开发环境搭建](./从零开始vibecoding/02-开发环境搭建.md) - 搭建开发环境(提示词版)
|
||||
|
||||
### 方法论与原则
|
||||
|
||||
此类别存放关于编程思想、开发哲学和项目核心原则的文档。
|
||||
|
||||
@@ -47,7 +58,7 @@ i18n/zh/documents/
|
||||
* `胶水编程.md`
|
||||
* `系统提示词构建原则.md`
|
||||
|
||||
### Tutorials and Guides
|
||||
### 教程与指南
|
||||
|
||||
此类别存放具体工具的配置、使用指南和操作教程。
|
||||
|
||||
@@ -57,7 +68,7 @@ i18n/zh/documents/
|
||||
* `关于手机ssh任意位置链接本地计算机,基于frp实现的方法.md`
|
||||
* `telegram-dev/`
|
||||
|
||||
### Templates and Resources
|
||||
### 模板与资源
|
||||
|
||||
此类别存放可复用的项目模板、代码结构规范和资源列表。
|
||||
|
||||
|
||||
@@ -0,0 +1,93 @@
|
||||
# 网络环境配置指南
|
||||
|
||||
> Vibe Coding 的前置条件:确保能正常访问 GitHub、Google、Claude 等服务。
|
||||
|
||||
---
|
||||
|
||||
## 你需要
|
||||
|
||||
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,124 @@
|
||||
# 开发环境搭建提示词
|
||||
|
||||
> 使用方法:复制下方对应你设备的提示词,粘贴到任意 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. 验证所有工具是否正常工作
|
||||
|
||||
要求:
|
||||
- 每个步骤给出具体的命令
|
||||
- 用简单易懂的语言解释每个命令的作用
|
||||
- 如果我遇到错误,帮我分析原因并给出解决方案
|
||||
- 每完成一步,问我是否成功,然后再继续下一步
|
||||
|
||||
现在开始第一步吧。
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 配置完成后
|
||||
|
||||
环境搭建完成后,继续下一步:
|
||||
|
||||
→ [03-IDE配置](./03-IDE配置.md) - 配置 VS Code 开发环境
|
||||
@@ -0,0 +1,132 @@
|
||||
# IDE 配置提示词
|
||||
|
||||
> 使用方法:复制下方对应你设备的提示词,粘贴到任意 AI 对话框,AI 会一步步指导你完成 VS Code 配置。
|
||||
|
||||
**前置条件**:请先完成 [02-开发环境搭建](./02-开发环境搭建.md)
|
||||
|
||||
---
|
||||
|
||||
## 🪟 Windows + WSL 用户提示词
|
||||
|
||||
```
|
||||
你是一个耐心的 VS Code 配置助手。我已经安装好了 WSL2 和 Ubuntu,现在需要你一步一步指导我配置 VS Code 以获得最佳的 WSL 开发体验。
|
||||
|
||||
请按以下顺序指导我,每次只给我一个步骤,等我确认完成后再进行下一步:
|
||||
|
||||
1. 在 Windows 上安装 VS Code(如果还没装)
|
||||
2. 安装 Remote - WSL 扩展
|
||||
3. 通过 WSL 打开项目文件夹
|
||||
4. 安装基础开发扩展:
|
||||
- GitLens(Git 增强)
|
||||
- Prettier(代码格式化)
|
||||
- ESLint(代码检查)
|
||||
- Local History(本地历史记录)
|
||||
5. 配置终端默认使用 WSL
|
||||
6. 配置自动保存和格式化
|
||||
7. 验证配置是否正常工作
|
||||
|
||||
要求:
|
||||
- 每个步骤给出具体的操作方法
|
||||
- 用简单易懂的语言解释每个配置的作用
|
||||
- 如果我遇到问题,帮我分析原因并给出解决方案
|
||||
- 每完成一步,问我是否成功,然后再继续下一步
|
||||
|
||||
现在开始第一步吧。
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🪟 Windows 原生用户提示词
|
||||
|
||||
```
|
||||
你是一个耐心的 VS Code 配置助手。我使用 Windows 系统(不使用 WSL),现在需要你一步一步指导我配置 VS Code。
|
||||
|
||||
请按以下顺序指导我,每次只给我一个步骤,等我确认完成后再进行下一步:
|
||||
|
||||
1. 安装 VS Code(如果还没装)
|
||||
2. 安装基础开发扩展:
|
||||
- GitLens(Git 增强)
|
||||
- Prettier(代码格式化)
|
||||
- ESLint(代码检查)
|
||||
- Local History(本地历史记录)
|
||||
- Python(如果写 Python)
|
||||
3. 配置终端使用 PowerShell 或 Git Bash
|
||||
4. 配置自动保存和格式化
|
||||
5. 配置 Git 集成
|
||||
6. 验证配置是否正常工作
|
||||
|
||||
要求:
|
||||
- 每个步骤给出具体的操作方法
|
||||
- 用简单易懂的语言解释每个配置的作用
|
||||
- 如果我遇到问题,帮我分析原因并给出解决方案
|
||||
- 每完成一步,问我是否成功,然后再继续下一步
|
||||
|
||||
现在开始第一步吧。
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🍎 macOS 用户提示词
|
||||
|
||||
```
|
||||
你是一个耐心的 VS Code 配置助手。我使用 macOS 系统,现在需要你一步一步指导我配置 VS Code。
|
||||
|
||||
请按以下顺序指导我,每次只给我一个步骤,等我确认完成后再进行下一步:
|
||||
|
||||
1. 安装 VS Code(通过 Homebrew 或官网)
|
||||
2. 配置 code 命令行工具(在终端中用 code 打开文件)
|
||||
3. 安装基础开发扩展:
|
||||
- GitLens(Git 增强)
|
||||
- Prettier(代码格式化)
|
||||
- ESLint(代码检查)
|
||||
- Local History(本地历史记录)
|
||||
4. 配置自动保存和格式化
|
||||
5. 配置快捷键(可选:Vim 模式)
|
||||
6. 验证配置是否正常工作
|
||||
|
||||
要求:
|
||||
- 每个步骤给出具体的操作方法
|
||||
- 用简单易懂的语言解释每个配置的作用
|
||||
- 如果我遇到问题,帮我分析原因并给出解决方案
|
||||
- 每完成一步,问我是否成功,然后再继续下一步
|
||||
|
||||
现在开始第一步吧。
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🐧 Linux 用户提示词
|
||||
|
||||
```
|
||||
你是一个耐心的 VS Code 配置助手。我使用 Linux 系统(Ubuntu/Debian),现在需要你一步一步指导我配置 VS Code。
|
||||
|
||||
请按以下顺序指导我,每次只给我一个步骤,等我确认完成后再进行下一步:
|
||||
|
||||
1. 安装 VS Code(通过 apt 或 snap)
|
||||
2. 安装基础开发扩展:
|
||||
- GitLens(Git 增强)
|
||||
- Prettier(代码格式化)
|
||||
- ESLint(代码检查)
|
||||
- Local History(本地历史记录)
|
||||
3. 配置自动保存和格式化
|
||||
4. 配置终端集成
|
||||
5. 配置快捷键(可选:Vim 模式)
|
||||
6. 验证配置是否正常工作
|
||||
|
||||
要求:
|
||||
- 每个步骤给出具体的操作方法
|
||||
- 用简单易懂的语言解释每个配置的作用
|
||||
- 如果我遇到问题,帮我分析原因并给出解决方案
|
||||
- 每完成一步,问我是否成功,然后再继续下一步
|
||||
|
||||
现在开始第一步吧。
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 配置完成后
|
||||
|
||||
VS Code 配置完成后,你可以:
|
||||
|
||||
1. 继续阅读 [04-AI编程工具](./04-AI编程工具.md) 安装 AI CLI 工具
|
||||
2. 或直接阅读 [README.md](../../../../README.md) 了解 Vibe Coding 工作流
|
||||
@@ -0,0 +1,28 @@
|
||||
# 🚀 从零开始 Vibe Coding
|
||||
|
||||
> 完全零基础?按顺序完成以下步骤,即可开始 AI 编程之旅。
|
||||
|
||||
---
|
||||
|
||||
## 学习路径
|
||||
|
||||
| 序号 | 文档 | 说明 |
|
||||
|:---:|:---|:---|
|
||||
| 01 | [网络环境配置](./01-网络环境配置.md) | 配置网络,确保能访问 GitHub、Google 等服务 |
|
||||
| 02 | [开发环境搭建](./02-开发环境搭建.md) | 复制提示词给 AI,让 AI 指导你安装开发工具 |
|
||||
| 03 | [IDE配置](./03-IDE配置.md) | 配置 VS Code 编辑器 |
|
||||
|
||||
---
|
||||
|
||||
## 使用方法
|
||||
|
||||
1. 按顺序阅读每个文档
|
||||
2. 文档中的提示词可以直接复制到 AI 对话框(ChatGPT、Claude、Gemini 网页版)
|
||||
3. AI 会一步步指导你完成配置
|
||||
4. 遇到问题直接问 AI
|
||||
|
||||
---
|
||||
|
||||
## 完成后
|
||||
|
||||
全部配置完成后,阅读 [主文档](../../../../README.md) 了解 Vibe Coding 工作流。
|
||||
Reference in New Issue
Block a user