refactor(i18n): 重构中文文档结构并同步更新链接

主要变更:

1.  **目录重命名**:
    *   将  下的 , ,  重命名为中文的 , , 。
2.  **新增新手入门**:
    *   创建  目录,为新用户提供入门指南。
3.  **文件迁移与清理**:
    *   将原有文档迁移到新的中文目录结构下。
    *   删除了部分过时或重复的中文文档。
4.  **链接与脚本同步**:
    *   更新了根 ,  以及  中所有指向旧路径的链接。
    *   修改了  下的英文文档,以反映中文文档的结构变化。
    *   更新了  翻译脚本,使其能够处理新的中文路径。

此次重构统一了中文文档的目录命名,使其更符合中文用户的习惯,并优化了整体文档的组织结构,提升了可维护性。
This commit is contained in:
tukuaiai
2025-12-17 12:07:54 +08:00
parent 9b42dd10dd
commit e239f9e4b8
33 changed files with 753 additions and 738 deletions
+17 -6
View File
@@ -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 用户提示词
### 方案 AWSL2 + Linux 环境(推荐)
> 适合:想要完整 Linux 开发体验,兼容性最好
```
你是一个耐心的开发环境配置助手。我是一个完全的新手,使用 Windows 系统,需要你一步一步指导我通过 WSL2 搭建 Linux 开发环境。
请按以下顺序指导我,每次只给我一个步骤,等我确认完成后再进行下一步:
1. 安装 WSL2Windows 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 终端)
- 用简单易懂的语言解释每个命令的作用
- 如果我遇到错误,帮我分析原因并给出解决方案
- 每完成一步,问我是否成功,然后再继续下一步
现在开始第一步吧。
```
### 方案 BWindows 原生终端
> 适合:不想装 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. 安装基础开发扩展:
- GitLensGit 增强)
- Prettier(代码格式化)
- ESLint(代码检查)
- Local History(本地历史记录)
5. 配置终端默认使用 WSL
6. 配置自动保存和格式化
7. 验证配置是否正常工作
要求:
- 每个步骤给出具体的操作方法
- 用简单易懂的语言解释每个配置的作用
- 如果我遇到问题,帮我分析原因并给出解决方案
- 每完成一步,问我是否成功,然后再继续下一步
现在开始第一步吧。
```
---
## 🪟 Windows 原生用户提示词
```
你是一个耐心的 VS Code 配置助手。我使用 Windows 系统(不使用 WSL),现在需要你一步一步指导我配置 VS Code。
请按以下顺序指导我,每次只给我一个步骤,等我确认完成后再进行下一步:
1. 安装 VS Code(如果还没装)
2. 安装基础开发扩展:
- GitLensGit 增强)
- 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. 安装基础开发扩展:
- GitLensGit 增强)
- Prettier(代码格式化)
- ESLint(代码检查)
- Local History(本地历史记录)
4. 配置自动保存和格式化
5. 配置快捷键(可选:Vim 模式)
6. 验证配置是否正常工作
要求:
- 每个步骤给出具体的操作方法
- 用简单易懂的语言解释每个配置的作用
- 如果我遇到问题,帮我分析原因并给出解决方案
- 每完成一步,问我是否成功,然后再继续下一步
现在开始第一步吧。
```
---
## 🐧 Linux 用户提示词
```
你是一个耐心的 VS Code 配置助手。我使用 Linux 系统(Ubuntu/Debian),现在需要你一步一步指导我配置 VS Code。
请按以下顺序指导我,每次只给我一个步骤,等我确认完成后再进行下一步:
1. 安装 VS Code(通过 apt 或 snap
2. 安装基础开发扩展:
- GitLensGit 增强)
- 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 工作流。