docs: update en/ documents with latest zh/ translations

- Update 00-fundamentals: Language Layer Elements, Glue Coding, Common Pitfalls, The Way of Programming, General Project Architecture Template
- Update 01-getting-started: all 4 guides
- Update 04-resources: Tool Collection, External Resource Aggregation
- Add fate-engine-dev practice examples
- Update all README.md files

Translated using Gemini CLI headless mode
This commit is contained in:
tukuaiai
2025-12-19 17:36:38 +08:00
parent 7ed780fc74
commit 2fba88ab60
23 changed files with 1621 additions and 1216 deletions
@@ -1,16 +1,18 @@
# IDE Configuration Prompt
Here is the English translation of the provided text:
> How to use: Copy the prompt corresponding to your IDE below and paste it into any AI chat box. The AI will guide you step by step to complete the configuration.
# IDE Configuration Prompts
**Prerequisite**: Please complete [02-Development Environment Setup](./02-Development%20Environment%20Setup.md) first.
> How to use: Copy the prompt corresponding to your IDE below, paste it into any AI chat box, and the AI will guide you step-by-step to complete the configuration.
**Precondition**: Please complete [02-Setting up the Development Environment](./02-开发环境搭建.md) first.
---
## Choose Your IDE
## Choose your IDE
- [VS Code](#vs-code) - Free, most common
- [Cursor](#cursor) - AI-native IDE, based on VS Code
- [Windsurf](#windsurf) - AI-native IDE, free tier for new users
- [Windsurf](#windsurf) - AI-native IDE, new users get free credits
---
@@ -19,44 +21,44 @@
### 🪟 Windows + WSL Users
```
You are a patient VS Code configuration assistant. I have already installed WSL2 and Ubuntu, and now I need you to guide me step by step to configure VS Code for the best WSL development experience.
You are a patient VS Code configuration assistant. I have already installed WSL2 and Ubuntu, and now I need you to guide me step-by-step to configure VS Code for the best WSL development experience.
Please guide me in the following order, giving me one step at a time, and wait for my confirmation before proceeding to the next step:
Please guide me in the following order, giving me only one step at a time, and waiting for my confirmation before proceeding to the next:
1. Install VS Code on Windows (if not already installed)
2. Install the Remote - WSL extension
3. Open a project folder via WSL
4. Install basic development extensions (GitLens, Prettier, ESLint, Local History)
5. Configure the terminal to use WSL by default
4. Install essential development extensions (GitLens, Prettier, ESLint, Local History)
5. Configure the terminal to default to WSL
6. Configure auto-save and formatting
7. Verify that the configuration is working correctly
Requirements:
- Provide specific operation methods for each step
- If I encounter an error, help me analyze the cause and provide a solution
- After completing each step, ask me if it was successful, and then proceed to the next step
- Provide specific instructions for each step
- If I encounter problems, help me analyze the cause and provide solutions
- After completing each step, ask me if it was successful before continuing to the next step
Now, let's start with the first step.
```
### 🪟 Windows Native Users
### 🪟 Native Windows Users
```
You are a patient VS Code configuration assistant. I am using a Windows system (without WSL), and now I need you to guide me step by step to configure VS Code.
You are a patient VS Code configuration assistant. I am using a Windows system (without WSL), and now I need you to guide me step-by-step to configure VS Code.
Please guide me in the following order, giving me one step at a time, and wait for my confirmation before proceeding to the next step:
Please guide me in the following order, giving me only one step at a time, and waiting for my confirmation before proceeding to the next:
1. Install VS Code (if not already installed)
2. Install basic development extensions (GitLens, Prettier, ESLint, Local History)
2. Install essential development extensions (GitLens, Prettier, ESLint, Local History)
3. Configure the terminal to use PowerShell or Git Bash
4. Configure auto-save and formatting
5. Configure Git integration
6. Verify that the configuration is working correctly
Requirements:
- Provide specific operation methods for each step
- If I encounter an error, help me analyze the cause and provide a solution
- After completing each step, ask me if it was successful, and then proceed to the next step
- Provide specific instructions for each step
- If I encounter problems, help me analyze the cause and provide solutions
- After completing each step, ask me if it was successful before continuing to the next step
Now, let's start with the first step.
```
@@ -64,20 +66,20 @@ Now, let's start with the first step.
### 🍎 macOS Users
```
You are a patient VS Code configuration assistant. I am using a macOS system, and now I need you to guide me step by step to configure VS Code.
You are a patient VS Code configuration assistant. I am using a macOS system, and now I need you to guide me step-by-step to configure VS Code.
Please guide me in the following order, giving me one step at a time, and wait for my confirmation before proceeding to the next step:
Please guide me in the following order, giving me only one step at a time, and waiting for my confirmation before proceeding to the next:
1. Install VS Code (via Homebrew or official website)
2. Configure the 'code' command-line tool
3. Install basic development extensions (GitLens, Prettier, ESLint, Local History)
2. Configure the `code` command-line tool
3. Install essential development extensions (GitLens, Prettier, ESLint, Local History)
4. Configure auto-save and formatting
5. Verify that the configuration is working correctly
Requirements:
- Provide specific operation methods for each step
- If I encounter an error, help me analyze the cause and provide a solution
- After completing each step, ask me if it was successful, and then proceed to the next step
- Provide specific instructions for each step
- If I encounter problems, help me analyze the cause and provide solutions
- After completing each step, ask me if it was successful before continuing to the next step
Now, let's start with the first step.
```
@@ -85,20 +87,20 @@ Now, let's start with the first step.
### 🐧 Linux Users
```
You are a patient VS Code configuration assistant. I am using a Linux system (Ubuntu/Debian), and now I need you to guide me step by step to configure VS Code.
You are a patient VS Code configuration assistant. I am using a Linux system (Ubuntu/Debian), and now I need you to guide me step-by-step to configure VS Code.
Please guide me in the following order, giving me one step at a time, and wait for my confirmation before proceeding to the next step:
Please guide me in the following order, giving me only one step at a time, and waiting for my confirmation before proceeding to the next:
1. Install VS Code (via apt or snap)
2. Install basic development extensions (GitLens, Prettier, ESLint, Local History)
2. Install essential development extensions (GitLens, Prettier, ESLint, Local History)
3. Configure auto-save and formatting
4. Configure terminal integration
5. Verify that the configuration is working correctly
Requirements:
- Provide specific operation methods for each step
- If I encounter an error, help me analyze the cause and provide a solution
- After completing each step, ask me if it was successful, and then proceed to the next step
- Provide specific instructions for each step
- If I encounter problems, help me analyze the cause and provide solutions
- After completing each step, ask me if it was successful before continuing to the next step
Now, let's start with the first step.
```
@@ -110,28 +112,28 @@ Now, let's start with the first step.
> AI-native IDE, based on VS Code, with built-in AI programming features. Official website: https://cursor.com
```
You are a patient Cursor IDE configuration assistant. I want to use Cursor as my main development tool, and I need you to guide me step by step through the installation and configuration.
You are a patient Cursor IDE configuration assistant. I want to use Cursor as my primary development tool, and I need you to guide me step-by-step through the installation and configuration.
My operating system is: [Please tell me if you are using Windows/macOS/Linux]
Please guide me in the following order, giving me one step at a time, and wait for my confirmation before proceeding to the next step:
Please guide me in the following order, giving me only one step at a time, and waiting for my confirmation before proceeding to the next:
1. Download and install Cursor (official website: https://cursor.com)
2. First-time startup configuration (login, theme selection, etc.)
1. Download and install Cursor (Official website: https://cursor.com)
2. Initial startup configuration (login, select theme, etc.)
3. Import VS Code settings and extensions (if you have used VS Code before)
4. Configure AI features (API Key or subscription)
5. Learn Cursor's core shortcuts:
- Cmd/Ctrl + K: AI Edit
- Cmd/Ctrl + L: AI Chat
- Cmd/Ctrl + I: Composer mode
- Cmd/Ctrl + I: Composer Mode
6. Configure auto-save
7. Verify that AI features are working correctly
Requirements:
- Provide specific operation methods for each step
- Provide specific instructions for each step
- Explain Cursor's unique features compared to VS Code
- If I encounter an error, help me analyze the cause and provide a solution
- After completing each step, ask me if it was successful, and then proceed to the next step
- If I encounter problems, help me analyze the cause and provide solutions
- After completing each step, ask me if it was successful before continuing to the next step
Now, first ask me what operating system I am using.
```
@@ -140,27 +142,27 @@ Now, first ask me what operating system I am using.
## Windsurf
> AI-native IDE, free tier for new users. Official website: https://windsurf.com
> AI-native IDE, new users get free credits. Official website: https://windsurf.com
```
You are a patient Windsurf IDE configuration assistant. I want to use Windsurf as my development tool, and I need you to guide me step by step through the installation and configuration.
You are a patient Windsurf IDE configuration assistant. I want to use Windsurf as my development tool, and I need you to guide me step-by-step through the installation and configuration.
My operating system is: [Please tell me if you are using Windows/macOS/Linux]
Please guide me in the following order, giving me one step at a time, and wait for my confirmation before proceeding to the next step:
Please guide me in the following order, giving me only one step at a time, and waiting for my confirmation before proceeding to the next:
1. Download and install Windsurf (official website: https://windsurf.com)
2. Register an account and log in (new users get a free tier)
3. First-time startup configuration
1. Download and install Windsurf (Official website: https://windsurf.com)
2. Register an account and log in (new users get free credits)
3. Initial startup configuration
4. Understand Windsurf's AI features (Cascade, etc.)
5. Configure the basic development environment
6. Verify that AI features are working correctly
Requirements:
- Provide specific operation methods for each step
- Provide specific instructions for each step
- Explain Windsurf's unique features
- If I encounter an error, help me analyze the cause and provide a solution
- After completing each step, ask me if it was successful, and then proceed to the next step
- If I encounter problems, help me analyze the cause and provide solutions
- After completing each step, ask me if it was successful before continuing to the next step
Now, first ask me what operating system I am using.
```
@@ -169,4 +171,4 @@ Now, first ask me what operating system I am using.
## After Configuration
After IDE configuration is complete, read [README.md](../../../../README.md) to understand the Vibe Coding workflow and start your first project!
Once your IDE is configured, read [README.md](../../../../README.md) to understand the Vibe Coding workflow and start your first project!