refactor(en): restructure en/documents to match zh structure

- Reorganize from 7 flat directories to 5 aggregated directories
- 00-fundamentals: core concepts, glue coding, methodology
- 01-getting-started: environment setup guides
- 02-methodology: tools, tutorials, development guides
- 03-practice: project examples (polymarket, telegram, fate-engine, etc.)
- 04-resources: templates, tools, external resources
- Remove duplicate files with underscore naming
- Add README.md for 00-fundamentals and 02-methodology
This commit is contained in:
tukuaiai
2025-12-19 02:02:06 +08:00
parent 055c426c42
commit b264229f18
64 changed files with 98 additions and 2320 deletions
@@ -0,0 +1,45 @@
# Code Organization
## Modular Programming
- Divide code into small, reusable modules or functions, with each module responsible for doing only one thing.
- Use clear modular structures and directory structures to organize code, making it easier to navigate.
## Naming Conventions
- Use meaningful and consistent naming conventions so that the purpose of variables, functions, and classes can be understood from their names.
- Follow naming conventions, such as CamelCase for class names and snake_case for function and variable names.
## Code Comments
- Add comments to complex code segments to explain the code's functionality and logic.
- Use block comments (/*...*/) and line comments (//) to distinguish between different types of comments.
## Code Formatting
- Use consistent code style and formatting rules, and use tools like Prettier or Black to automatically format code.
- Use blank lines, indentation, and spaces to increase code readability.
# Documentation
## Docstrings
- Use docstrings at the beginning of each module, class, and function to explain its purpose, parameters, and return values.
- Choose a consistent docstring format, such as Google Style, NumPy/SciPy Style, or Sphinx Style.
## Automated Document Generation
- Use tools like Sphinx, Doxygen, or JSDoc to automatically generate documentation from code.
- Keep documentation and code synchronized to ensure documentation is always up-to-date.
## README File
- Include a detailed README file in the root directory of each project, explaining the project's purpose, installation steps, usage, and examples.
- Write README files using Markdown syntax to make them easy to read and maintain.
# Tools
## IDE
- Use powerful IDEs such as Visual Studio Code, PyCharm, or IntelliJ, leveraging their code auto-completion, error checking, and debugging features.
- Configure IDE plugins, such as linters (e.g., ESLint, Pylint) and code formatters.
@@ -0,0 +1,695 @@
# General Project Architecture Template
## 1️⃣ Standard Structure for Python Web/API Projects
```
project_name/
├── README.md # Project README
├── LICENSE # Open-source license
├── requirements.txt # Dependency management (pip)
├── pyproject.toml # Modern Python project configuration (recommended)
├── setup.py # Package installation script (if packaged as a library)
├── .gitignore # Git ignore file
├── .env # Environment variables (not committed to Git)
├── .env.example # Example environment variables
├── CLAUDE.md # Claude persistent context
├── AGENTS.md # Codex persistent context
├── Sublime-Text.txt # For requirements and notes, for self-reference, and CLI session recovery commands ^_^
├── docs/ # Documentation directory
│ ├── api.md # API documentation
│ ├── development.md # Development guide
│ └── architecture.md # Architecture description
├── scripts/ # Script tools
│ ├── deploy.sh # Deployment script
│ ├── backup.sh # Backup script
│ └── init_db.sh # Database initialization
├── tests/ # Test code
│ ├── __init__.py
│ ├── conftest.py # pytest configuration
│ ├── unit/ # Unit tests
│ ├── integration/ # Integration tests
│ └── test_config.py # Configuration tests
├── src/ # Source code (recommended)
│ ├── __init__.py
│ ├── main.py # Program entry point
│ ├── app.py # Flask/FastAPI application
│ ├── config.py # Configuration management
│ │
│ ├── core/ # Core business logic
│ │ ├── __init__.py
│ │ ├── models/ # Data models
│ │ ├── services/ # Business services
│ │ └── utils/ # Utility functions
│ │
│ ├── api/ # API interface layer
│ │ ├── __init__.py
│ │ ├── v1/ # Version 1
│ │ └── dependencies.py
│ │
│ ├── data/ # Data processing
│ │ ├── __init__.py
│ │ ├── repository/ # Data access layer
│ │ └── migrations/ # Database migrations
│ │
│ └── external/ # External services
│ ├── __init__.py
│ ├── clients/ # API clients
│ └── integrations/ # Integration services
├── logs/ # Log directory (not committed to Git)
│ ├── app.log
│ └── error.log
└── data/ # Data directory (not committed to Git)
├── raw/ # Raw data
├── processed/ # Processed data
└── cache/ # Cache
```
**Use Cases**: Flask/FastAPI Web applications, RESTful API services, Web backends
---
## 2️⃣ Standard Structure for Data Science/Quant Projects
```
project_name/
├── README.md
├── LICENSE
├── requirements.txt
├── .gitignore
├── .env
├── .env.example
├── CLAUDE.md # Claude persistent context
├── AGENTS.md # Codex persistent context
├── Sublime-Text.txt # For requirements and notes, for self-reference, and CLI session recovery commands ^_^
├── docs/ # Documentation directory
│ ├── notebooks/ # Jupyter documentation
│ └── reports/ # Analysis reports
├── notebooks/ # Jupyter Notebook
│ ├── 01_data_exploration.ipynb
│ ├── 02_feature_engineering.ipynb
│ └── 03_model_training.ipynb
├── scripts/ # Script tools
│ ├── train_model.py # Training script
│ ├── backtest.py # Backtest script
│ ├── collect_data.py # Data collection
│ └── deploy_model.py # Model deployment
├── tests/ # Tests
│ ├── test_data/
│ └── test_models/
├── configs/ # Configuration files
│ ├── model.yaml
│ ├── database.yaml
│ └── trading.yaml
├── src/ # Source code
│ ├── __init__.py
│ │
│ ├── data/ # Data processing module
│ │ ├── __init__.py
│ │ ├── collectors/ # Data collectors
│ │ ├── processors/ # Data cleaning
│ │ ├── features/ # Feature engineering
│ │ └── loaders.py # Data loaders
│ │
│ ├── models/ # Model module
│ │ ├── __init__.py
│ │ ├── strategies/ # Trading strategies
│ │ ├── backtest/ # Backtest engine
│ │ └── risk/ # Risk management
│ │
│ ├── utils/ # Utility module
│ │ ├── __init__.py
│ │ ├── logging.py # Log configuration
│ │ ├── database.py # Database tools
│ │ └── api_client.py # API client
│ │
│ └── core/ # Core module
│ ├── __init__.py
│ ├── config.py # Configuration management
│ ├── signals.py # Signal generation
│ └── portfolio.py # Portfolio
├── data/ # Data directory (Git ignored)
│ ├── raw/ # Raw data
│ ├── processed/ # Processed data
│ ├── external/ # External data
│ └── cache/ # Cache
├── models/ # Model files (Git ignored)
│ ├── checkpoints/ # Checkpoints
│ └── exports/ # Exported models
└── logs/ # Logs (Git ignored)
├── trading.log
└── errors.log
```
**Use Cases**: Quantitative trading, machine learning, data analysis, AI research
---
## 3️⃣ Monorepo (Multi-Project Repository) Standard Structure
```
project_name-monorepo/
├── README.md
├── LICENSE
├── .gitignore
├── .gitmodules # Git submodules
├── docker-compose.yml # Docker orchestration
├── CLAUDE.md # Claude persistent context
├── AGENTS.md # Codex persistent context
├── Sublime-Text.txt # This is a file, for requirements and notes, for self-reference, and CLI session recovery commands ^_^
├── docs/ # Global documentation
│ ├── architecture.md
│ └── deployment.md
├── scripts/ # Global scripts
│ ├── build_all.sh
│ ├── test_all.sh
│ └── deploy.sh
├── backups/ # Backup files
│ ├── archive/ # Old backup files
│ └── gz/ # Gzip backup files
├── services/ # Microservice directory
│ │
│ ├── user-service/ # User service
│ │ ├── Dockerfile
│ │ ├── requirements.txt
│ │ ├── src/
│ │ └── tests/
│ │
│ ├── trading-service/ # Trading service
│ │ ├── Dockerfile
│ │ ├── requirements.txt
│ │ ├── src/
│ │ └── tests/
│ ...
│ └── data-service/ # Data service
│ ├── Dockerfile
│ ├── requirements.txt
│ ├── src/
│ └── tests/
├── libs/ # Shared libraries
│ ├── common/ # Common modules
│ │ ├── utils/
│ │ └── models/
│ ├── external/ # Third-party libraries (immutable, call only)
│ └── database/ # Database access library
├── infrastructure/ # Infrastructure
│ ├── terraform/ # Cloud resource definition
│ ├── kubernetes/ # K8s configuration
│ └── nginx/ # Reverse proxy configuration
└── monitoring/ # Monitoring system
├── prometheus/ # Metrics collection
├── grafana/ # Visualization
└── alertmanager/ # Alerts
```
**Use Cases**: Microservice architecture, large projects, team collaboration
---
## 4️⃣ Standard Structure for Full-Stack Web Applications
```
project_name/
├── README.md
├── LICENSE
├── .gitignore
├── docker-compose.yml # Frontend and backend orchestration
├── CLAUDE.md # Claude persistent context
├── AGENTS.md # Codex persistent context
├── Sublime-Text.txt # This is a file, for requirements and notes, for self-reference, and CLI session recovery commands ^_^
├── frontend/ # Frontend directory
│ ├── public/ # Static assets
│ ├── src/ # Source code
│ │ ├── components/ # React/Vue components
│ │ ├── pages/ # Pages
│ │ ├── store/ # State management
│ │ └── utils/ # Utilities
│ ├── package.json # NPM dependencies
│ └── vite.config.js # Build configuration
└── backend/ # Backend directory
├── requirements.txt
├── Dockerfile
├── src/
│ ├── api/ # API interfaces
│ ├── core/ # Business logic
│ │ └── models/ # Data models
└── tests/
```
**Use Cases**: Full-stack applications, SPA single-page applications, frontend/backend separated projects
---
## 📌 Core Design Principles
### 1. Separation of Concerns
```
API → Service → Data Access → Database
Clear at a glance, clear hierarchy
```
### 2. Testability
```
Each module is independently testable
Dependencies can be mocked
```
### 3. Configurability
```
Configuration separated from code
Environment variables > Configuration files > Default values
```
### 4. Maintainability
```
Self-documenting code
Reasonable file naming
Clear directory structure
```
### 5. Version Control Friendly (Git-Friendly)
```
data/, logs/, models/ added to .gitignore
Only commit source code and configuration examples
```
---
## 🎯 Best Practice Recommendations
1. **Use `src/` directory**: Place source code in a dedicated `src` directory to avoid top-level clutter.
2. **Relative imports**: Consistently use `from src.module import thing` for imports.
3. **Test coverage**: Ensure core business logic has unit and integration tests.
4. **Document first**: Write `README.md` for important modules.
5. **Environment isolation**: Use virtualenv or conda to create isolated environments.
6. **Explicit dependencies**: All dependencies written to `requirements.txt` and versions locked.
7. **Configuration management**: Use a combination of environment variables + configuration files.
8. **Logging levels**: DEBUG, INFO, WARNING, ERROR, FATAL.
9. **Error handling**: Do not swallow exceptions; have a complete error chain.
10. **Code style**: Use black for formatting, flake8 for checking.
---
## 🔥 .gitignore Recommended Template
```gitignore
# Python
__pycache__/
*.py[cod]
*$py.class
*.so
.Python
*.egg-info/
dist/
build/
# Environment
.env
.venv/
env/
venv/
ENV/
# IDE
.vscode/
.idea/
*.swp
*.swo
*~
# Data
data/
*.csv
*.json
*.db
*.sqlite
*.duckdb
# Logs
logs/
*.log
# Models
models/
*.h5
*.pkl
# Temporary files
tmp/
temp/
*.tmp
.DS_Store
```
---
## 📚 Technology Selection Reference
| Scenario | Recommended Tech Stack |
| :------- | :--------------------- |
| Web API | FastAPI + Pydantic + SQLAlchemy |
| Data Processing | Pandas + NumPy + Polars |
| Machine Learning | Scikit-learn + XGBoost + LightGBM |
| Deep Learning | PyTorch + TensorFlow |
| Databases | PostgreSQL + Redis |
| Message Queue | RabbitMQ / Kafka |
| Task Queue | Celery |
| Monitoring | Prometheus + Grafana |
| Deployment | Docker + Docker Compose |
| CI/CD | GitHub Actions / GitLab CI |
---
## 📝 File Template Examples
### requirements.txt
```txt
# Core dependencies
fastapi==0.104.1
uvicorn[standard]==0.24.0
pydantic==2.5.0
# Database
sqlalchemy==2.0.23
alembic==1.12.1
psycopg2-binary==2.9.9
# Testing
pytest==7.4.3
pytest-cov==4.1.0
pytest-asyncio==0.21.1
# Utilities
python-dotenv==1.0.0
loguru==0.7.2
# Development (optional)
black==23.11.0
flake8==6.1.0
mypy==1.7.1
```
### pyproject.toml (Recommended for modern Python projects)
```toml
[project]
name = "Project Name"
version = "0.1.0"
description = "Project Description"
authors = [{name = "Author", email = "email@example.com"}]
dependencies = [
"fastapi>=0.104.0",
"uvicorn[standard]>=0.24.0",
"sqlalchemy>=2.0.0",
]
[project.optional-dependencies]
dev = ["pytest", "black", "flake8", "mypy"]
[build-system]
requires = ["setuptools", "wheel"]
build-backend = "setuptools.build_meta"
```
---
## ✅ New Project Checklist
When starting a new project, ensure the following are completed:
- [ ] Create README.md, including project overview and usage instructions.
- [ ] Create LICENSE file, clarifying the open-source license.
- [ ] Set up Python virtual environment (venv/conda).
- [ ] Create requirements.txt and lock dependency versions.
- [ ] Create .gitignore, excluding sensitive and unnecessary files.
- [ ] Create .env.example, explaining required environment variables.
- [ ] Design directory structure, adhering to the principle of separation of concerns.
- [ ] Create basic configuration files.
- [ ] Set up code formatter (black).
- [ ] Set up code checker (flake8/ruff).
- [ ] Write the first test case.
- [ ] Set up Git repository and commit initial code.
- [ ] Create CHANGELOG.md, recording version changes.
---
In **programming / software development**, **Project Architecture / Software Architecture** refers to:
> **The design solution for how a project is broken down, organized, communicated, and evolved at the "overall level"**
> —it determines how code is layered, how modules are divided, how data flows, and how the system expands and is maintained.
---
## One-Sentence Understanding
**Project Architecture = Deciding "where the code goes, how modules connect, and how responsibilities are divided" before writing any specific business code.**
---
## I. What Problems Does Project Architecture Primarily Solve?
Project architecture is not about "coding skills," but about solving these **higher-level problems**:
* 📦 How to organize code to avoid chaos?
* 🔁 How do modules communicate?
* 🧱 Which parts can be modified independently without affecting the whole?
* 🚀 How will the project be extended in the future?
* 🧪 How to facilitate testing, debugging, and deployment?
* 👥 How to collaborate without stepping on each other's code?
---
## II. What Does Project Architecture Generally Include?
### 1️⃣ Directory Structure (Most Intuitive)
```text
project/
├── src/
│ ├── main/
│ ├── services/
│ ├── models/
│ ├── utils/
│ └── config/
├── tests/
├── docs/
└── README.md
```
👉 Determines **"where different types of code are placed"**.
---
### 2️⃣ Layered Design (Core)
The most common is **Layered Architecture**:
```text
Presentation Layer (UI / API)
Business Logic Layer (Service)
Data Access Layer (DAO / Repository)
Database / External Systems
```
**Rules:**
* Upper layers can call lower layers.
* Lower layers cannot depend on upper layers.
---
### 3️⃣ Module Partitioning (Responsibility Boundaries)
For example, a trading system:
```text
- market_data # Market data
- strategy # Strategy
- risk # Risk control
- order # Order placement
- account # Account
```
👉 Each module:
* Does only one type of thing.
* Aims for low coupling, high cohesion.
---
### 4️⃣ Data and Control Flow
* Where does the data come from?
* Who is responsible for processing?
* Who is responsible for storage?
* Who is responsible for external output?
For example:
```text
WebSocket → Data Cleaning → Indicator Calculation → AI Scoring → SQLite → API → Frontend
```
---
### 5️⃣ Technology Selection (Part of Architecture)
* Programming languages (Python / Java / Go)
* Frameworks (FastAPI / Spring / Django)
* Communication methods (HTTP / WebSocket / MQ)
* Storage (SQLite / Redis / PostgreSQL)
* Deployment (Local / Docker / Cloud)
---
## III. Common Project Architecture Types (Essential for Beginners)
### 1️⃣ Monolithic Architecture
```text
One project, one process
```
**Suitable for:**
* Personal projects
* Prototypes
* Small systems
**Advantages:**
* Simple
* Easy to debug
**Disadvantages:**
* Difficult to scale later
---
### 2️⃣ Layered Architecture (Most Common)
```text
Controller → Service → Repository
```
**Suitable for:**
* Web backends
* Business systems
---
### 3️⃣ Modular Architecture
```text
core + plugins
```
**Suitable for:**
* Pluggable systems
* Strategy / indicator systems
👉 **Very suitable for quant, AI analysis you are doing.**
---
### 4️⃣ Microservice Architecture (Advanced)
```text
Each service is an independent process + API communication
```
**Suitable for:**
* Large teams
* High concurrency
* Long-term evolution
**Not recommended for beginners to start with.**
---
## IV. Understanding with a "Real Example" (Close to what you are doing now)
Suppose you are building a **Binance Futures AI Analysis System**:
```text
backend/
├── data/
│ └── binance_ws.py # Market data subscription
├── indicators/
│ └── vpvr.py
├── strategy/
│ └── signal_score.py
├── storage/
│ └── sqlite_writer.py
├── api/
│ └── http_server.py
└── main.py
```
This is **project architecture design**:
* Each folder is responsible for one thing.
* Replaceable, testable.
* Later, if you want to connect a Telegram Bot / Web frontend, you don't need to rewrite the core.
---
## V. Common Misconceptions for Beginners ⚠️
❌ Starting with microservices
❌ All code in one file
❌ Architecture pursuing "seniority" rather than "maintainability"
❌ Starting to write code without clearly thinking about data flow
---
## VI. Suggested Learning Path (Very Important)
If you are learning CS now, this order is highly recommended:
1. **First write runnable projects (imperfect).**
2. **Code becomes messy → then learn architecture.**
3. Learn:
* Module decomposition
* Layering
* Dependency direction
4. Then learn:
* Design patterns
* Microservices / message queues
---
**Version**: 1.0
**Update Date**: 2025-11-24
**Maintained by**: CLAUDE, CODEX, KIMI
+322
View File
@@ -0,0 +1,322 @@
# 🔗 External Resource Aggregation
> A collection of high-quality external resources related to Vibe Coding
---
<details open>
<summary><strong>🎙️ Quality Bloggers/Influencers</strong></summary>
### 𝕏 (Twitter) Influencers
| Influencer | Link | Description |
|:---|:---|:---|
| @shao__meng | [x.com/shao__meng](https://x.com/shao__meng) | |
| @0XBard_thomas | [x.com/0XBard_thomas](https://x.com/0XBard_thomas) | |
| @Pluvio9yte | [x.com/Pluvio9yte](https://x.com/Pluvio9yte) | |
| @xDinoDeer | [x.com/xDinoDeer](https://x.com/xDinoDeer) | |
| @geekbb | [x.com/geekbb](https://x.com/geekbb) | |
| @GitHub_Daily | [x.com/GitHub_Daily](https://x.com/GitHub_Daily) | |
| @BiteyeCN | [x.com/BiteyeCN](https://x.com/BiteyeCN) | |
| @CryptoJHK | [x.com/CryptoJHK](https://x.com/CryptoJHK) | |
| @rohanpaul_ai | [x.com/rohanpaul_ai](https://x.com/rohanpaul_ai) | |
| @DataChaz | [x.com/DataChaz](https://x.com/DataChaz) | |
### 📺 YouTube Influencers
| Influencer | Link | Description |
|:---|:---|:---|
| Best Partners | [youtube.com/@bestpartners](https://www.youtube.com/@bestpartners) | |
| 王路飞 | [youtube.com/@王路飞](https://www.youtube.com/@%E7%8E%8B%E8%B7%AF%E9%A3%9E) | |
| 即刻风 | [youtube.com/@jidifeng](https://www.youtube.com/@jidifeng) | |
| 3Blue1Brown | [youtube.com/@3blue1brown](https://www.youtube.com/@3blue1brown) | Math visualization |
| Andrej Karpathy | [youtube.com/andrejkarpathy](https://www.youtube.com/andrejkarpathy) | AI/Deep Learning |
### 📱 WeChat Video Accounts
| Influencer | Description |
|:---|:---|
| 美国的牛粪博士 | |
### 🎵 Douyin (TikTok)
| Influencer | Description |
|:---|:---|
</details>
---
<details open>
<summary><strong>🤖 AI Tools and Platforms</strong></summary>
### 💬 AI Chat Platforms
#### Tier 1 (Recommended)
| Platform | Model | Features |
|:---|:---|:---|
| [Claude](https://claude.ai/) | Claude Opus 4.5 | Strong code capabilities, supports Artifacts |
| [ChatGPT](https://chatgpt.com/) | GPT-5.1 | Strong overall capabilities, supports Codex |
| [Gemini](https://gemini.google.com/) | Gemini 3.0 Pro | Large free tier, supports long context |
#### Domestic Platforms
| Platform | Model | Features |
|:---|:---|:---|
| [Kimi](https://kimi.moonshot.cn/) | Kimi K2 | Strong long-text processing |
| [Tongyi Qianwen](https://tongyi.aliyun.com/) | Qwen | From Alibaba, free |
| [Zhipu Qingyan](https://chatglm.cn/) | GLM-4 | From Zhipu AI |
| [Doubao](https://www.doubao.com/) | Doubao | From ByteDance |
### 🖥️ AI Programming IDEs
| Tool | Link | Description |
|:---|:---|:---|
| Cursor | [cursor.com](https://cursor.com/) | AI-native editor, based on VS Code |
| Windsurf | [windsurf.com](https://windsurf.com/) | From Codeium |
| Kiro | [kiro.dev](https://kiro.dev/) | From AWS, free Claude Opus |
| Zed | [zed.dev](https://zed.dev/) | High-performance editor, supports AI |
### ⌨️ AI CLI Tools
| Tool | Command | Description |
|:---|:---|:---|
| Claude Code | `claude` | Anthropic official CLI |
| Codex CLI | `codex` | OpenAI official CLI |
| Gemini CLI | `gemini` | Google official CLI, free |
| Aider | `aider` | Open-source AI pair programming |
### 🆓 Free Resources
#### Completely Free
| Resource | Link | Description |
|:---|:---|:---|
| AI Studio | [aistudio.google.com](https://aistudio.google.com/) | Google free Gemini |
| Gemini CLI | [geminicli.com](https://geminicli.com/) | Free command-line access |
| antigravity | [antigravity.google](https://antigravity.google/) | Google free AI service |
| Qwen CLI | [qwenlm.github.io](https://qwenlm.github.io/qwen-code-docs/zh/cli/) | Alibaba free CLI |
#### With Free Tier
| Resource | Link | Description |
|:---|:---|:---|
| Kiro | [kiro.dev](https://kiro.dev/) | Free Claude Opus 4.5 |
| Windsurf | [windsurf.com](https://windsurf.com/) | Free tier for new users |
| GitHub Copilot | [github.com/copilot](https://github.com/copilot) | Free for students/open source |
### 🎨 AI Generation Tools
| Type | Tool | Link |
|:---|:---|:---|
| Image | Midjourney | [midjourney.com](https://midjourney.com/) |
| Image | DALL-E 3 | [ChatGPT](https://chatgpt.com/) |
| Music | Suno | [suno.ai](https://suno.ai/) |
| Sound | ElevenLabs | [elevenlabs.io](https://elevenlabs.io/) |
| Video | Sora | [sora.com](https://sora.com/) |
</details>
---
<details>
<summary><strong>👥 Communities and Forums</strong></summary>
### Telegram
| Community | Link | Description |
|:---|:---|:---|
| Vibe Coding Discussion Group | [t.me/glue_coding](https://t.me/glue_coding) | |
| Vibe Coding Channel | [t.me/tradecat_ai_channel](https://t.me/tradecat_ai_channel) | |
### Discord
| Community | Link | Description |
|:---|:---|:---|
| Cursor Discord | [discord.gg/cursor](https://discord.gg/cursor) | |
| Anthropic Discord | [discord.gg/anthropic](https://discord.gg/anthropic) | |
### X (Twitter)
| Community | Link | Description |
|:---|:---|:---|
| Vibe Coding Community | [x.com/communities](https://x.com/i/communities/1993849457210011871) | |
| Community Content Aggregation | [x.com/vibeverything](https://x.com/vibeverything/status/1999796188053438687) | |
</details>
---
<details>
<summary><strong>📝 Prompt Resources</strong></summary>
### Prompt Libraries
| Resource | Link | Description |
|:---|:---|:---|
| Online Prompt Table | [Google Sheets](https://docs.google.com/spreadsheets/d/1ngoQOhJqdguwNAilCl1joNwTje7FWWN9WiI2bo5VhpU/edit?gid=2093180351#gid=2093180351&range=A1) | Recommended |
| Meta Prompt Library | [Google Sheets](https://docs.google.com/spreadsheets/d/1ngoQOhJqdguwNAilCl1joNwTje7FWWN9WiI2bo5VhpU/edit?gid=1770874220#gid=1770874220) | |
| System Prompts Repository | [GitHub](https://github.com/x1xhlol/system-prompts-and-models-of-ai-tools) | |
| Awesome ChatGPT Prompts | [GitHub](https://github.com/f/awesome-chatgpt-prompts) | |
### Prompt Tools
| Tool | Link | Description |
|:---|:---|:---|
| Skills Maker | [GitHub](https://github.com/yusufkaraaslan/Skill_Seekers) | Generates customized Skills |
| LangGPT | [GitHub](https://github.com/langgptai/LangGPT) | Structured prompt framework |
### Prompt Tutorials
| Tutorial | Link | Description |
|:---|:---|:---|
| Prompt Engineering Guide | [promptingguide.ai](https://www.promptingguide.ai/zh) | Chinese version |
| Learn Prompting | [learnprompting.org](https://learnprompting.org/zh-Hans/) | Chinese version |
| OpenAI Prompt Engineering | [platform.openai.com](https://platform.openai.com/docs/guides/prompt-engineering) | Official |
| Anthropic Prompt Engineering | [docs.anthropic.com](https://docs.anthropic.com/claude/docs/prompt-engineering) | Official |
| State-Of-The-Art Prompting | [Google Docs](https://docs.google.com/document/d/11tBoylc5Pvy8wDp9_i2UaAfDi8x02iMNg9mhCNv65cU/) | YC Top Tips |
| Vibe Coding 101 | [Google Drive](https://drive.google.com/file/d/1OMiqUviji4aI56E14PLaGVJsbjhOP1L1/view) | Beginner's Guide |
</details>
---
<details>
<summary><strong>🐙 GitHub Featured Repositories</strong></summary>
### CLI Tools
| Repository | Link | Description |
|:---|:---|:---|
| claude-code | [GitHub](https://github.com/anthropics/claude-code) | Anthropic official CLI |
| aider | [GitHub](https://github.com/paul-gauthier/aider) | AI pair programming tool |
| gpt-engineer | [GitHub](https://github.com/gpt-engineer-org/gpt-engineer) | Natural language code generation |
| open-interpreter | [GitHub](https://github.com/OpenInterpreter/open-interpreter) | Local code interpreter |
| continue | [GitHub](https://github.com/continuedev/continue) | Open-source AI code assistant |
| spec-kit | [GitHub](https://github.com/github/spec-kit) | GitHub official Spec-Driven development toolkit |
### IDE Plugins
| Repository | Link | Description |
|:---|:---|:---|
| copilot.vim | [GitHub](https://github.com/github/copilot.vim) | GitHub Copilot Vim plugin |
| codeium | [GitHub](https://github.com/Exafunction/codeium.vim) | Free AI code completion |
### Prompt Engineering
| Repository | Link | Description |
|:---|:---|:---|
| awesome-chatgpt-prompts | [GitHub](https://github.com/f/awesome-chatgpt-prompts) | ChatGPT prompt collection |
| awesome-chatgpt-prompts-zh | [GitHub](https://github.com/PlexPt/awesome-chatgpt-prompts-zh) | Chinese prompts |
| system-prompts-and-models-of-ai-tools | [GitHub](https://github.com/x1xhlol/system-prompts-and-models-of-ai-tools) | AI tool system prompts |
| LangGPT | [GitHub](https://github.com/langgptai/LangGPT) | Structured prompt framework |
### Agent Frameworks
| Repository | Link | Description |
|:---|:---|:---|
| langchain | [GitHub](https://github.com/langchain-ai/langchain) | LLM application development framework |
| autogen | [GitHub](https://github.com/microsoft/autogen) | Multi-Agent conversation framework |
| crewai | [GitHub](https://github.com/joaomdmoura/crewAI) | AI Agent collaboration framework |
| dspy | [GitHub](https://github.com/stanfordnlp/dspy) | Programmatic LLM framework |
| MCAF | [mcaf.managed-code.com](https://mcaf.managed-code.com/) | AI programming framework, defines AGENTS.md specification |
### MCP Related
| Repository | Link | Description |
|:---|:---|:---|
| mcp-servers | [GitHub](https://github.com/modelcontextprotocol/servers) | MCP server collection |
| awesome-mcp-servers | [GitHub](https://github.com/punkpeye/awesome-mcp-servers) | MCP resource aggregation |
### Learning Resources
| Repository | Link | Description |
|:---|:---|:---|
| prompt-engineering-guide | [GitHub](https://github.com/dair-ai/Prompt-Engineering-Guide) | Prompt engineering guide |
| generative-ai-for-beginners | [GitHub](https://github.com/microsoft/generative-ai-for-beginners) | Microsoft Generative AI tutorial |
| llm-course | [GitHub](https://github.com/mlabonne/llm-course) | LLM learning roadmap |
### Utilities
| Repository | Link | Description |
|:---|:---|:---|
| ollama | [GitHub](https://github.com/ollama/ollama) | Local large model runner |
| localai | [GitHub](https://github.com/mudler/LocalAI) | Local AI API |
| text-generation-webui | [GitHub](https://github.com/oobabooga/text-generation-webui) | Text generation WebUI |
</details>
---
<details>
<summary><strong>🔧 Development Tools</strong></summary>
### IDEs & Editors
| Tool | Link | Description |
|:---|:---|:---|
| VS Code | [code.visualstudio.com](https://code.visualstudio.com/) | Mainstream editor |
| Cursor | [cursor.com](https://cursor.com/) | AI-native editor |
| Neovim | [neovim.io](https://neovim.io/) | Keyboard-centric choice |
| LazyVim | [lazyvim.org](https://www.lazyvim.org/) | Neovim configuration framework |
| Zed | [zed.dev](https://zed.dev/) | High-performance editor |
### Terminal Tools
| Tool | Link | Description |
|:---|:---|:---|
| Warp | [warp.dev](https://www.warp.dev/) | AI Terminal |
| tmux | [GitHub](https://github.com/tmux/tmux) | Terminal multiplexer |
| zsh | [ohmyz.sh](https://ohmyz.sh/) | Shell enhancement |
### Web Frameworks
| Tool | Link | Description |
|:---|:---|:---|
| Django | [djangoproject.com](https://www.djangoproject.com/) | Python full-stack Web framework |
### Database Tools
| Tool | Link | Description |
|:---|:---|:---|
| DBeaver | [dbeaver.io](https://dbeaver.io/) | Universal database client |
| TablePlus | [tableplus.com](https://tableplus.com/) | Modern database GUI |
### Visualization Tools
| Tool | Link | Description |
|:---|:---|:---|
| Mermaid | [mermaid.js.org](https://mermaid.js.org/) | Text to diagram |
| Excalidraw | [excalidraw.com](https://excalidraw.com/) | Hand-drawn style diagrams |
| NotebookLM | [notebooklm.google.com](https://notebooklm.google.com/) | AI note-taking tool |
</details>
---
<details>
<summary><strong>📖 Tutorials and Courses</strong></summary>
### Official Documentation
| Document | Link | Description |
|:---|:---|:---|
| Claude Documentation | [docs.anthropic.com](https://docs.anthropic.com/) | Anthropic official |
| OpenAI Documentation | [platform.openai.com](https://platform.openai.com/docs/) | OpenAI official |
| Gemini Documentation | [ai.google.dev](https://ai.google.dev/docs) | Google official |
### Community Tutorials
| Tutorial | Link | Description |
|:---|:---|:---|
| Erge's Java Advanced Path | [javabetter.cn](https://javabetter.cn/) | Development tool configuration tutorials |
| Super Individual Resource List | [x.com/BiteyeCN](https://x.com/BiteyeCN/status/2000856243645157387) | |
</details>
---
## 📝 Contribution
Found good resources? Welcome PRs to supplement!
@@ -0,0 +1,149 @@
# All available for free download in z-lib
From Zero to Large Model Development and Fine-tuning: Based on PyTorch and ChatGLM - Wang Xiaohua
The Principles of Programming: 101 Ways to Improve Code Quality - Isao Ueda
Generative AI Design Patterns - Valliappa Lakshmanan & Hannes Hapke
The Mythical Man-Month - Frederick Brooks
Peopleware (3rd Edition) - Tom DeMarco & Timothy Lister
The 45 Habits of an Effective Programmer: Agile Development Practices - Andy Hunt & Venkat Subramaniam
The Art of Project Management - Rothman
Programming Pearls (Second Edition) - Jon Bentley
Programming Pearls (2nd Edition) - Jon Bentley
Programming Principles: Advice from Master Coder Max Kanat-Alexander (Bringing the idea of minimalist design back to computer programming, suitable for software developers, development team managers, and students of software-related majors) (Huazhang Programmer's Library) - Max Kanat-Alexande
The Art of Readable Code - Dustin Boswell & Trevor Foucher
Statistical Thinking: Probability and Statistics for Programmers (2nd Edition) - Allen B. Downey
Mastering Rust (2nd Edition) - Rahul Sharma & Vesa Kaihlavirta
The Programmer's Superbrain (Turing Programming Library · Programmer Cultivation Series) - Feliane Hermans
Software Architecture for Programmers - Simon Brown
The Pragmatic Programmer: Your Journey to Mastery (20th Anniversary Edition) - David Thomas & Andrew Hunt
Comic Python: Fun, Informative, Interesting, and Practical - Guan Dongsheng
Chaos Engineering: Building Resilient Systems with Controlled Failure - Mikolaj Pawlikowski_1
Deep Dive into Python Features - Dann Bader
Microservices in Action (Technical practical book covering all stages from microservice design to deployment) (Asynchronous Books) - Morgan Bruce & Paul A. Pereira
Building Big Data Systems: Principles and Best Practices for Scalable Real-time Data Systems - Nathan Marz & James Warren
Illustrated Performance Optimization (Turing Programming Library) - Keiji Oda & Tanito Kurematsu & Takeshi Hirayama & Kenji Okada
Turing Programming Series: Introduction to Large-scale Data Processing and Practice (Set of 10 volumes) [Turing出品!A set covering SQL, Python, Spark, Hadoop, Neha Narkhede & Gwen Shapira & Todd Palino & Benjamin Banford & Jenny Kim & Ellen Friedman & Kostas Tzoumas
Clean Code - Robert C. Martin
The Essence of Code: Core Concepts of Programming Languages (Turing Programming Library) - Taikazu Nishio
Design Patterns for Everyone: Understanding Design Patterns from Life - Luo Weifu
The Rust Programming Language (2nd Edition) - Steve Klabnik & Carol Nichols
Python for Finance (2nd Edition) - Yves Hilpisch
Python Scientific Computing Basic Tutorial - Hemant Kumar Mehta_1
Python Data Mining: Beginner to Practice - Robert Layton
Python Data Analysis and Algorithm Guide (Set of 8 volumes) - Jiang Xuesong & Zou Jing & Deng Liguo & Zhai Kun & Hu Feng & Zhou Xiaoran & Wang Guoping & Bai Ningchao & Tang Dan & Wen Jun & Zhang Ruoyu & Hong Jinkui
Python Performance Analysis and Optimization - Fernando Doglio
Functional Python Programming (2nd Edition) (Turing Books) - Steven Lott_1
Quantitative Trading in the GPT Era: Underlying Logic and Technical Practice - Luo Yong & Lu Hongbo_1
ChatGPT Data Analysis Practice - Shi Haoran & Zhao Xin & Wu Zhicheng
AI Era Python Financial Big Data Analysis Practice: ChatGPT Makes Financial Big Data Analysis Soar - Guan Dongsheng
Cross-Market Trading Strategies - John J. Murphy
Asset Pricing and Machine Learning - Wu Ke
Engineering Thinking - Mark N. Horenstein
The Programmer's Brain: What Every Programmer Needs to Know About Cognitive Science - Felienne Hermans
The Pragmatic Programmer: Your Journey To Mastery, 20th Anniversary Edition [This book revolutionized countless software careers! And propelled the entire IT industry to where it is today! The 20-year anniversary edition is here!] - David Thomas & Andrew Hunt
Thinking, Fast and Slow - Daniel Kahneman (This is the closest match, original is "不确定状况下的判断:启发式和偏差 - 丹尼尔·卡尼曼" which translates to "Judgment under uncertainty: Heuristics and biases - Daniel Kahneman" which is a key work in the field covered by Thinking, Fast and Slow)
The Beauty of Simplicity: The Art of Software Design - Max Kanant-Alexander
The Programmer's Underlying Thinking - Zhang Jianfei
The Programmer's Three Courses: Technical Advancement, Architecture Cultivation, Management Exploration - Yu Junze
Designing Machine Learning Systems (Turing Programming Library) - Willi Richert & Luis Pedro Coelho
Introduction to Thought Engineering - Qian Xiaoyi
Algorithmic Essentials: Python Implementations of Classic Computer Science Problems - David Kopec
Functional Thinking (Turing Programming Library) - Neal Ford
Effective Python: 90 Specific Ways to Write Better Python (2nd Edition) (Effective Series) - Brett Slatkin
High-Frequency Trading (2nd Edition) - Irene Aldridge
Flash Boys: A Wall Street Revolt - Michael Lewis
Principles of Financial Economics (6th Edition) - Peng Xingyun
The Smart Investor's First Book of Financial Common Sense - Xiao Yuhong
Visualizing Quantitative Finance - Michael Lovelady
Quantitative Trading in the GPT Era: Underlying Logic and Technical Practice - Luo Yong & Lu Hongbo
Turing Classic Computer Science Series (Set of 4 volumes) - Hisao Yazawa & Tsutomu Togane & Akira Hirasawa
201 Principles of Software Development - Alan M. Davis
The Programmer's AI Book: Starting from Code - Zhang Like & Pan Hui
The Nature of Computation: Exploring the Depths of Programs and Computers - Tom Stuart
The Programmer's Investment Guide - Stefan Papp
Mastering Regular Expressions (3rd Edition) - Jeffrey E.F. Friedl
Leveraging ChatGPT for Data Analysis and Mining - Xie Jiabiao
Industrial Artificial Intelligence Trilogy (Set of Three Volumes) (Collection of works by world-class intelligent manufacturing experts) (Named "Top 30 Most Visionary Smart Manufacturing Figures in the US" by SME in 2016) - Li Jie
Building Large Models from Scratch: Algorithms, Training, and Fine-tuning - Liang Nan
Vibe Coding_ Building Production-Grade Software With GenAI, Chat, Agents, and Beyond - Gene Kim & Steve Yegge
Vibe Coding AI Programming Complete Manual - Tan Xingxing
Computer Science: An Overview (13th Edition) - J. Glenn Brookshear & Dennis Brylow
Pro Git (Chinese Edition) - Scott Chacon & Ben Straub
Think Like a Programmer - V. Anton Spraul
Core Python Programming (3rd Edition) - Wesley Chun_1
AI Engineering: Building Applications from Foundation Models - Chip Huyen
AI-Assisted Programming in Action - Tom Taulli
Code: The Hidden Language of Computer Hardware and Software - Charles Petzold
@@ -0,0 +1,5 @@
IDE and plugins; VSCode, Windsurf (free use), Shandiashuo (for output), Continue - open-source AI code agent, Local History, Partial Diff
Models; Codex, Gemini, KimiK2, Grok
Websites; https://aistudio.google.com/; https://zread.ai/; https://chatgpt.com/; https://github.com; https://www.bilibili.com; https://www.mermaidchart.com/app/dashboard; https://notebooklm.google.com/; https://z-lib.fm/; https://docs.google.com/spreadsheets/u/0/; https://script.google.com/home?pli=1