{"owner":"datawhalechina","repo":"easy-vibe","hasSkills":true,"totalSkillsCount":36,"totalTokensCount":34874,"categories":["claude-rule","root-instruction","anthropic-skill","plugin-manifest"],"hasMcp":false,"mcpConfig":null,"found":["CLAUDE.md","AGENTS.md","llms.txt","tools/translation/fixtures/fail-code-block/localized.md","tools/translation/fixtures/fail-frontmatter/source.md","tools/translation/ko-kr/glossary.md","tools/translation/fixtures/fail-frontmatter/localized.md","tools/translation/ko-kr/style-guide.md","tools/translation/README.md","tools/translation/fixtures/fail-code-block/source.md","tools/translation/fixtures/fail-image/localized.md","tools/translation/fixtures/fail-image/source.md","tools/translation/fixtures/fail-inline-code/localized.md","tools/translation/fixtures/fail-inline-code/source.md","tools/translation/fixtures/fail-link/localized.md","tools/translation/fixtures/fail-link/source.md","tools/translation/fixtures/fail-source-text/localized.md","tools/translation/fixtures/fail-source-text/source.md","tools/translation/fixtures/fail-structure/localized.md","tools/translation/fixtures/fail-structure/source.md","tools/translation/fixtures/pass/localized.md","tools/translation/fixtures/pass/source.md","docs/ar-sa/stage-3/core-skills/skills/index.md","docs/de-de/stage-3/core-skills/skills/index.md","docs/en/stage-3/core-skills/skills/index.md","docs/es-es/stage-3/core-skills/skills/index.md","docs/fr-fr/stage-3/core-skills/skills/index.md","docs/ja-jp/stage-3/core-skills/skills/index.md","docs/ko-kr/stage-3/core-skills/skills/index.md","docs/vi-vn/stage-3/core-skills/skills/index.md","docs/zh-cn/stage-3/core-skills/skills/index.md","docs/zh-tw/stage-3/core-skills/skills/index.md","tools/translation/fixtures/fail-source-locale/docs/ko-kr/localized.md","tools/translation/fixtures/fail-source-locale/docs/zh-cn/source.md","tools/translation/fixtures/pass-glossary-annotation/docs/ko-kr/localized.md","tools/translation/fixtures/pass-glossary-annotation/docs/zh-cn/source.md"],"skills":{"CLAUDE.md":"# CLAUDE.md\n\nThis file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.\n\n## Project Overview\n\n**Easy-Vibe** is an educational curriculum for learning AI Vibe Coding from zero to advanced levels. It's a documentation-based project using **VitePress** to serve educational content about AI-assisted software development.\n\nThe curriculum follows a progressive four-stage structure:\n\n- **Stage 0 (幼儿园)**: Introduction to AI programming through games\n- **Stage 1 (AI 产品经理)**: Building AI-powered web application prototypes\n- **Stage 2 (初中级开发工程师)**: Full-stack development with databases and deployment\n- **Stage 3 (高级开发工程师)**: Cross-platform development (WeChat mini-programs, Android apps, MCP)\n\n## Development Commands\n\n### Start Local Documentation Server\n\n```bash\nnpm install      # Install dependencies (first time only)\nnpm run dev      # Start VitePress dev server\n```\n\nThe documentation will be available at `http://localhost:5173` (VitePress default port)\n\n### Build/Run Commands\n\n- `npm run dev` - Start VitePress development server with hot reload\n- `npm run build` - Build static site for production (outputs to `docs/.vitepress/dist`)\n- `npm run preview` - Preview production build locally\n- `npm run format` - Format code using Prettier\n\n### Node Version Requirement\n\n- Node.js >= 18.0.0 required (specified in package.json `engines`)\n\n## Project Architecture\n\n### VitePress Base Path Configuration\n\nThe site automatically configures its base path based on the deployment environment:\n\n- **Vercel**: Uses `/` as base (detected via `VERCEL` environment variable)\n- **GitHub Pages / Local**: Uses `/easy-vibe/` as base\n\nThis logic is in `docs/.vitepress/config.mjs:3-5`. When linking assets or configuring paths, the `${base}` variable is used to ensure compatibility across environments.\n\n### Directory Structure\n\n```\neasy-vibe/\n├── docs/                        # Main documentation content (served by VitePress)\n│   ├── .vitepress/             # VitePress configuration and theme\n│   │   ├── config.mjs          # Site configuration (nav, sidebar, plugins)\n│   │   ├── theme/              # Custom theme extensions\n│   │   │   ├── Layout.vue      # Override default layout with typewriter effect\n│   │   │   ├── index.js        # Theme setup (Viewer.js, TypeIt, image optimization)\n│   │   │   └── style.css       # Custom CSS overrides\n│   │   ├── dist/               # Production build output (generated)\n│   │   └── cache/              # VitePress cache (generated)\n│   ├── index.md                # Homepage\n│   ├── public/                 # Static assets (logo.png, etc.)\n│   ├── assets/                 # Symlink to ../assets\n│   ├── stage-1/                # Stage 1 content (AI 产品经理)\n│   ├── stage-2/                # Stage 2 content (初中级开发工程师)\n│   ├── stage-3/                # Stage 3 content (高级开发工程师)\n│   ├── appendix/               # Reference materials (AI capability dictionary)\n│   ├── examples/               # Practical examples and tutorials (legacy)\n│   ├── extra/                  # Additional knowledge (Git, API, RAG, etc.)\n│   ├── guide/                  # Course guide\n│   └── project/                # Legacy project documentation\n├── assets/                     # Images and static assets\n├── package.json                # Project dependencies and scripts\n├── vercel.json                 # Vercel deployment configuration\n└── README.md                   # Project overview and contribution guide\n```\n\n### Content Organization\n\nEach stage follows a numbered chapter structure:\n\n```\nstage-{N}/\n└── {category or chapter-dir}/\n    └── index.md          # Main content file (or .md file directly)\n```\n\nExamples:\n\n- `stage-1/introduction-to-ai-ide/index.md`\n- `stage-2/backend/what-is-api/extra2/extra2-what-is-api.md`\n\n**Note**: Content files may use either `index.md` or direct `.md` files depending on the chapter structure.\n\n### Documentation System (VitePress)\n\nThe project uses **VitePress 2.0.0-alpha.15** with these key features:\n\n**Configuration** (`docs/.vitepress/config.mjs`):\n\n- **Single Sidebar**: Route-based sidebars configured per path prefix (`/stage-1/`, etc.)\n- **Navigation**: Top nav with links to each stage and appendix\n- **Search**: Local search via `minisearch` (no external API required)\n- **Dark Mode**: Built-in VitePress theme with toggle\n\n**Custom Theme** (`docs/.vitepress/theme/`):\n\n- **Image Viewer**: Viewer.js integration for zoom/rotate/flip on all images\n- **Typewriter Effect**: TypeIt.js for homepage hero tagline animation\n- **Image Optimization**: Automatic image height classes based on aspect ratio\n- **Custom Layout**: Extends default theme with `Layout.vue` override\n- **Reading Settings**: Element Plus popover panel for adjusting font size (12-18px) and line height (1.25-1.8) with localStorage persistence\n\n**Key Theme Behaviors**:\n\n- Images with aspect ratio > 1.2 get height-limited classes (tall/very-tall/ultra-tall)\n- Viewer.js initialized on `.vp-doc` container on each route change\n- Typewriter effect only activates on homepage when `frontmatter.hero.tagline` is an array\n- Font size/line height adjustments use CSS custom properties `--ev-doc-font-size` and `--ev-doc-line-height`\n- Reading settings panel appears in nav bar after the search/home buttons (gear icon)\n\n### Sidebar Management\n\nThe sidebar is defined in `docs/.vitepress/config.mjs`. When adding new chapters:\n\n1. Locate the appropriate route prefix section (`/stage-1/`, etc.)\n2. Add a new object with `text` (display name) and `link` (relative path)\n3. For nested items, use `items` array with `collapsed: true|false`\n4. **Links should not include `.md` extension** - VitePress handles this\n5. Links should not include `index` - use directory path with trailing slash\n\nExample pattern:\n\n```javascript\n{\n  text: 'Chapter Title',\n  link: '/stage-1/chapter-directory/'  // Note: trailing slash, no .md\n}\n```\n\n### Asset Management\n\n- Root-level static assets are in `/assets/` at project root\n- Public files (favicon, logo) go in `docs/public/`\n- Images are referenced with relative paths from markdown file location\n- VitePress serves `docs/assets` as symlink to `../assets`\n- Image optimization is automatic via theme (height-limited classes based on aspect ratio)\n\n### Deployment\n\n**Vercel** (vercel.json):\n\n- Build command: `npm run build`\n- Output directory: `docs/.vitepress/dist`\n- Framework: vitepress\n\n**Preview Production Build**:\n\n```bash\nnpm run build\nnpm run preview  # Preview built site locally\n```\n\n### Legacy Content Structure\n\nThe project maintains three legacy sections for backward compatibility:\n\n1. **Project 文档** (`project/`): Older chapter-based tutorials (migrated to Stage 2)\n2. **Extra 扩展知识** (`extra/`): Supplementary topics - Git, APIs, RAG, deployment (migrated to Stage 2/3)\n3. **Examples 实战案例** (`examples/`): Practical tutorials (migrated to Stage 0/3)\n\nWhen updating content, prefer integrating into the stage structure over adding to legacy sections.\n\n## Content Guidelines\n\n### Writing New Chapters\n\n1. Create directory: `docs/stage-{N}/{chapter-directory}/`\n2. Create `index.md` or direct `.md` file with chapter content\n3. Update `docs/.vitepress/config.mjs` sidebar with the new entry\n4. Follow Chinese language conventions (this is a Chinese curriculum)\n\n### Content Status Markers\n\nIn README.md, use these status indicators:\n\n- ✅ Completed\n- 🚧 In progress/Under construction\n\n### File Naming Conventions\n\n- Use kebab-case for directories: `1.1-introduction-to-ai-ide`, `frontend`, `backend`\n- Content can be either `index.md` in a directory or a direct `.md` file\n- Images use descriptive names; can be in chapter subdirectories or root `/assets/`\n\n### Code Formatting\n\nPrettier configuration (`.prettierrc`):\n\n- No semicolons (`semi: false`)\n- Single quotes (`singleQuote: true`)\n- No trailing commas (`trailingComma: \"none\"`)\n\nRun `npm run format` before committing code changes.\n\n## Interactive Vue Components\n\n### Component Registration\n\nAll interactive Vue components for the documentation are registered in `docs/.vitepress/theme/index.js`. To add a new component:\n\n1. Create the `.vue` file in the appropriate subdirectory of `docs/.vitepress/theme/components/`\n2. Import the component in `docs/.vitepress/theme/index.js`\n3. Register the component using `app.component('ComponentName', ComponentName)` in the `enhanceApp` function\n\n### Component Categories\n\nComponents are organized by topic:\n\n- `appendix/llm-intro/` - Large Language Model interactive demos\n- `appendix/vlm-intro/` - Vision Language Model interactive demos\n- `appendix/git-intro/` - Git workflow visualizations\n- `appendix/terminal-intro/` - Terminal/CLI interactive demos\n- `appendix/web-basics/` - HTML/CSS/JavaScript fundamentals\n- `appendix/auth-design/` - Authentication/authorization demos\n- `appendix/cache-design/` - Caching strategy visualizations\n- `appendix/database-intro/` - Database fundamentals\n- `appendix/queue-design/` - Message queue demos\n- `appendix/operations/` - DevOps/monitoring demos\n- `appendix/deployment/` - Deployment architecture demos\n- `appendix/frontend-performance/` - Frontend performance demos\n- `appendix/frontend-evolution/` - Frontend history/evolution demos\n- `appendix/backend-evolution/` - Backend architecture evolution\n- `appendix/backend-languages/` - Backend language comparisons\n\n### Using Components in Markdown\n\nComponents can be used directly in markdown files:\n\n```markdown\n## LLM Basics\n\n<LLMQuickStartDemo />\n\n### Tokenization\n\n<TokenizationDemo />\n```\n\n### Component Development Best Practices\n\n1. **Props**: Use props for configurable demo parameters\n2. **Styling**: Use scoped CSS or Tailwind-like utility classes\n3. **Responsiveness**: Ensure components work on mobile and desktop\n4. **Accessibility**: Include aria labels where appropriate\n5. **i18n**: Keep text content minimal or use props for text\n\n## Multi-language Support\n\n### Supported Locales\n\nThe project supports 13 languages:\n\n- `zh-cn` - Simplified Chinese (primary)\n- `zh-tw` - Traditional Chinese\n- `en-us` - English (US)\n- `ja-jp` - Japanese\n- `ko-kr` - Korean\n- `es-es` - Spanish\n- `fr-fr` - French\n- `de-de` - German\n- `ar-sa` - Arabic\n- `vi-vn` - Vietnamese\n\n### Adding Multi-language Content\n\n1. Create content in `docs/{locale}/` following the same structure as `docs/zh-cn/`\n2. Add locale configuration in `docs/.vitepress/config.mjs` under `locales`\n3. Copy the sidebar structure from `zh-cn` and translate the text values\n\n### Content Translation Priority\n\n1. **Primary**: `zh-cn` (Simplified Chinese) - always complete this first\n2. **Secondary**: `en-us` (English) - for international reach\n3. **Tertiary**: Other languages based on contributor availability\n\n## Permissions\n\nThe project has configured bash permissions in `.claude/settings.local.json`:\n\n- File operations: `which`, `find`, `mv`, `tree`, `cat`, `curl`, `lsof`, `mkdir`, `cp`, `ls`\n- Process management: `xargs ps`, `kill`\n- Development: `npm run dev`, `npm run build`, `npm run preview`, `npm run format`\n\n## Key Context for Development\n\n- **Educational Focus**: This is curriculum content, not application code\n- **Target Audience**: Beginners to advanced developers learning AI-assisted programming\n- **Language**: Primary content is in Chinese\n- **Build Pipeline**: VitePress requires build step for production (`npm run build`)\n- **Git Workflow**: Content changes should preserve formatting and structure\n- **Asset Paths**: Always use relative paths from markdown file location\n\nWhen making changes:\n\n- Preserve the VitePress configuration in `docs/.vitepress/config.mjs`\n- Maintain sidebar structure consistency in config.mjs\n- Test locally with `npm run dev` before committing\n- Check that image links work correctly\n- Ensure theme customizations in `.vitepress/theme/` are not broken\n- Run `npm run format` before committing code changes (uses Prettier: no semicolons, single quotes)\n","AGENTS.md":"# Repository Guidelines\n\n## Project Structure & Module Organization\n\n- `docs/`: VitePress site source (Markdown content, sidebar/nav, assets referenced by docs).\n- `docs/.vitepress/theme/`: custom theme, global component registration in `index.js`, shared styles in `style.css`, layout in `Layout.vue`.\n- `docs/.vitepress/theme/components/appendix/*/`: interactive Vue demos used inside appendix pages (e.g. `web-basics/`, `deployment/`).\n- `assets/`: repo-level images/media (if referenced, prefer linking/copying into `docs/public/` or a doc-local folder when appropriate).\n- `scripts/`, `tools/`, `update_readmes.cjs`: utility scripts for maintaining docs.\n\n## Build, Test, and Development Commands\n\nThis repo is a VitePress (Vue 3) documentation project. Requires Node.js **>= 18**.\n\n```bash\nnpm install\nnpm run dev      # start local docs server (hot reload)\nnpm run build    # production build (use as CI-style check)\nnpm run preview  # preview the built site locally\nnpm run format   # run Prettier on the whole repo\n```\n\n## Coding Style & Naming Conventions\n\n- Formatting: Prettier (`npm run format`). Keep diffs small and avoid reformatting unrelated files.\n- Vue components: Vue 3 SFCs with `<script setup>`, PascalCase filenames (e.g. `SemanticTagsDemo.vue`).\n- CSS: prefer VitePress theme variables (`var(--vp-c-*)`) and keep components responsive (`@media (max-width: 720px)` when needed).\n- Docs: use clear headings and short paragraphs; components are referenced in Markdown as `<ComponentName />`.\n- Images: prefer WebP for screenshots. Convert existing PNG screenshots losslessly without cropping or resizing, preserving decoded pixels, transparency, and color profiles. For example: `cwebp -lossless -exact -m 6 -metadata all input.png -o input.webp`. Verify decoded pixel equality and browser rendering; keep the original PNG when the browser renders it differently. Inspect representative text-heavy crops at full size before committing.\n- When replacing an image, update references in every locale and remove the obsolete source after checking that nothing still references it. Avoid keeping both PNG and WebP copies of the same screenshot.\n- Measure image savings from the current tracked files; existing clones retain old image blobs in Git history. Run the production build and check rendered image URLs as well as Markdown links.\n\n## Testing Guidelines\n\nThere is no dedicated test framework in this repo. Use `npm run build` as the primary correctness check, and manually verify interactive components in `npm run dev`.\n\n## Commit & Pull Request Guidelines\n\n- Commits follow a Conventional Commits style seen in history: `feat: ...`, `fix: ...`, `docs: ...` (optionally scoped like `feat(docs): ...`).\n- PRs should include: a short description, screenshots/GIFs for UI or component changes, and any relevant paths touched (e.g. `docs/zh-cn/appendix/...`, `docs/.vitepress/theme/...`).\n\n## Configuration & Deployment Notes\n\n- `vercel.json` is present; keep builds reproducible and avoid relying on local-only assets.\n","llms.txt":"# Easy-Vibe 教程 - AI 导航\n\n> 🦞 **如果你是 AI Agent（如 OpenClaw、Claude、Cursor、Trae 内置 AI、GPT-4、Kimi、通义千问、文心一言等）**\n> \n> **请先阅读本文件**，了解本教程结构后再回答用户问题。本文件是你的「导航地图」，告诉你去哪里找答案。\n\n---\n\n## 🎯 高层级架构（先读我！）\n\n本教程采用 **3+1 阶段** 的渐进式学习路径，从完全零基础到高级开发：\n\n```\n┌─────────────────────────────────────────────────────────────┐\n│  Stage 1: 新手入门与产品原型 (stage-0/ + stage-1/)           │\n│  ├── 目标：建立编程思维，掌握 AI IDE，快速构建产品原型        │\n│  ├── 产出：互动小游戏、完整的产品原型                        │\n│  └── 关键词：零基础、入门、学习路线、贪吃蛇、Cursor、Claude、 │\n│             Trae、MVP、产品思维、AI 能力集成                  │\n├─────────────────────────────────────────────────────────────┤\n│  Stage 2: 初中级开发 (stage-2/)                              │\n│  ├── 目标：全栈开发能力，数据库、部署、支付                   │\n│  ├── 产出：可上线的全栈 AI 应用                              │\n│  └── 关键词：Dify、Supabase、Git、部署、Stripe、UI 设计       │\n├─────────────────────────────────────────────────────────────┤\n│  Stage 3: 高级开发 (stage-3/)                                │\n│  ├── 目标：跨平台开发，AI 进阶，Claude Code 深度使用          │\n│  ├── 产出：生产级多平台应用                                  │\n│  └── 关键词：MCP、RAG、微信小程序、Android、iOS、Electron     │\n├─────────────────────────────────────────────────────────────┤\n│  附录：知识体系 (appendix/)                                  │\n│  ├── 目标：计算机基础到工程素养的完整知识库                   │\n│  ├── 内容：9 大领域，80+ 交互式专题                          │\n│  └── 关键词：计算机基础、前端、后端、AI 原理、架构、运维       │\n└─────────────────────────────────────────────────────────────┘\n```\n\n### 快速决策树\n\n当用户提问时，按以下优先级定位：\n\n1. **问\"怎么开始/零基础/入门\"** → Stage 1 (stage-0/ 和 stage-1/)\n2. **问\"数据库/部署/全栈\"** → Stage 2\n3. **问\"MCP/小程序/跨平台/Claude Code 进阶\"** → Stage 3\n4. **问\"计算机基础/原理\"** → 附录\n\n---\n\n## 📂 目录结构速查\n\n```\ndocs/zh-cn/\n├── stage-0/                    # Stage 1 - 新手入门部分\n│   ├── 0.1-learning-map/       # 学习路线图\n│   └── 0.2-ai-capabilities-through-games/  # 贪吃蛇游戏\n├── stage-1/                    # Stage 1 - 产品原型部分\n│   ├── 1.0-finding-great-idea/ # 找到好创意\n│   ├── 1.1-introduction-to-ai-ide/         # AI IDE 入门\n│   ├── 1.2-building-prototype/ # 原型开发\n│   ├── 1.3-integrating-ai-capabilities/    # 接入 AI 能力\n│   ├── 1.4-complete-project-practice/      # 完整项目实战\n│   └── appendix-*/             # 产品思维、常见错误、场景附录\n├── stage-2/                    # 初中级开发\n│   ├── ai-capabilities/        # AI 能力 (Dify、多模态)\n│   ├── backend/                # 后端 (数据库、Git、部署、支付)\n│   ├── frontend/               # 前端 (Figma、UI、组件库)\n│   └── assignments/            # 作业\n├── stage-3/                    # 高级开发\n│   ├── core-skills/            # 核心技能 (Claude、MCP、Agent)\n│   ├── ai-advanced/            # AI 进阶 (RAG、LangGraph)\n│   ├── cross-platform/         # 跨平台 (小程序、App、桌面)\n│   └── personal-brand/         # 个人品牌\n└── appendix/                   # 附录知识体系\n    ├── 1-computer-fundamentals/    # 计算机基础\n    ├── 2-development-tools/        # 开发工具\n    ├── 3-browser-and-frontend/     # 浏览器与前端\n    ├── 4-server-and-backend/       # 服务器与后端\n    ├── 5-data/                     # 数据\n    ├── 6-architecture-and-system-design/  # 架构设计\n    ├── 7-infrastructure-and-operations/   # 运维\n    ├── 8-artificial-intelligence/  # 人工智能\n    └── 9-engineering-excellence/   # 工程卓越\n```\n\n---\n\n## 🔍 详细文章索引\n\n### Stage 1: 新手入门与产品原型（stage-0/ + stage-1/）\n\n#### 1.0 学习路线图\n**文件**: `docs/zh-cn/stage-0/0.1-learning-map/index.md`\n\n**关键词**: 入门、零基础、怎么开始、学习路线、学习路径、成长路径、职业规划、阶段划分、新手引导、教程介绍、课程概览、适合谁学、前置要求、学习顺序、从哪开始、第一步\n\n**内容概要**: 完整学习路线图，介绍学习路径和目标\n\n---\n\n#### 1.0 AI 能力体验 - 贪吃蛇游戏\n**文件**: `docs/zh-cn/stage-0/0.2-ai-capabilities-through-games/index.md`\n\n**关键词**: 贪吃蛇、游戏、第一个项目、零基础项目、入门实战、AI 编程初体验、小游戏开发、网页游戏、Canvas、JavaScript 游戏、游戏逻辑、键盘控制、碰撞检测、得分系统、游戏循环、requestAnimationFrame\n\n**内容概要**: 用 AI 辅助开发第一个贪吃蛇游戏，理解 AI 编程的基本流程\n\n---\n\n#### 1.1 找到好创意\n**文件**: `docs/zh-cn/stage-1/1.0-finding-great-idea/index.md`\n\n**关键词**: 创意、想法、Idea、产品创意、需求挖掘、用户痛点、市场调研、竞品分析、创新思维、 brainstorming、头脑风暴、产品定位、目标用户、价值主张、MVP 定义、最小可行产品\n\n**内容概要**: 如何找到有价值的产品创意，定义 MVP 范围\n\n---\n\n#### 1.2 AI IDE 入门\n**文件**: `docs/zh-cn/stage-1/1.1-introduction-to-ai-ide/index.md`\n\n**关键词**: Cursor、Claude、Trae、AI IDE、安装、配置、环境搭建、本地开发、IDE 选择、代码编辑器、AI 辅助编程、智能补全、代码生成、自然语言编程、Vibe Coding、提示词技巧、AI 对话、代码解释、代码重构\n\n**内容概要**: 主流 AI IDE 工具的安装配置和使用方法\n\n---\n\n#### 1.3 原型开发\n**文件**: `docs/zh-cn/stage-1/1.2-building-prototype/index.md`\n\n**关键词**: 原型、Demo、快速搭建、MVP、最小可行产品、产品原型、快速验证、低保真、高保真、原型工具、交互设计、用户流程、页面跳转、组件复用、响应式布局、移动端适配\n\n**内容概要**: 快速搭建产品原型，验证产品概念\n\n---\n\n#### 1.4 接入 AI 能力\n**文件**: `docs/zh-cn/stage-1/1.3-integrating-ai-capabilities/index.md`\n\n**关键词**: 接入 AI、API、大模型、AI 能力、LLM、OpenAI、Claude API、GPT、文本生成、聊天机器人、API Key、接口调用、HTTP 请求、JSON、异步处理、错误处理、流式输出、SSE、Token 限制、成本控制\n\n**内容概要**: 如何在项目中接入大模型 API，实现 AI 功能\n\n---\n\n#### 1.5 完整项目实战\n**文件**: `docs/zh-cn/stage-1/1.4-complete-project-practice/index.md`\n\n**关键词**: 完整项目、实战、练手、综合案例、项目实战、端到端、从零开始、项目结构、代码组织、最佳实践、常见问题、调试技巧、测试验证、项目复盘\n\n**内容概要**: 一个完整的项目实战，串联前面所学知识\n\n---\n\n#### 附录 A: 产品思维\n**文件**: `docs/zh-cn/stage-1/appendix-a-product-thinking/index.md`\n\n**关键词**: 产品思维、需求分析、用户研究、产品设计、用户体验、UX、功能优先级、产品文档、PRD、用户故事、敏捷开发、迭代思维、数据驱动、A/B 测试、产品方法论\n\n**内容概要**: 产品经理必备的思维模式和方法论\n\n---\n\n#### 附录 B: 常见错误\n**文件**: `docs/zh-cn/stage-1/appendix-b-common-errors/index.md`\n\n**关键词**: 常见错误、错误排查、问题解决、Bug、调试、报错信息、环境错误、依赖问题、网络问题、权限问题、配置错误、语法错误、运行时错误、逻辑错误、调试技巧\n\n**内容概要**: 初学者常犯的错误及解决方法\n\n---\n\n#### 附录: AI 应用场景参考（B 端与 C 端）\n**文件**: `docs/zh-cn/stage-1/appendix-industry-scenarios/index.md`\n\n**关键词**: 行业场景、行业应用、垂直领域、B2B、B2C、行业解决方案、消费场景、C 端产品、社交应用、内容创作、娱乐应用、生活方式、情感陪伴、个人成长\n\n**内容概要**: B 端 19 个行业落地应用与 C 端 16 个消费场景创意灵感，通过 Tab 切换浏览\n\n---\n\n#### 附录文章 0-1: 贪吃蛇游戏教程\n**文件**: `docs/zh-cn/stage-1/appendix-articles/example0-1/vibe-coding-tools-snake-game-tutorial.md`\n\n**关键词**: 贪吃蛇教程、游戏开发、Canvas API、键盘事件、游戏循环、碰撞检测、得分系统、游戏状态、开始界面、结束界面、代码详解\n\n**内容概要**: 详细的贪吃蛇游戏开发教程\n\n---\n\n#### 附录文章 0-2: AI 编程与设计代理\n**文件**: `docs/zh-cn/stage-1/appendix-articles/example0-2/vibe-coding-tools-build-website-with-ai-coding-and-design-agents.md`\n\n**关键词**: AI 设计、设计代理、网站生成、AI 辅助设计、视觉设计、UI 生成、设计系统、设计稿转代码、Design-to-Code\n\n**内容概要**: 使用 AI 设计代理和编程代理协作完成网站\n\n---\n\n### Stage 2: 初中级开发（全栈技能）\n\n#### 2.1 Dify 知识库\n**文件**: `docs/zh-cn/stage-2/ai-capabilities/2.1-dify-knowledge-base/index.md`\n\n**关键词**: Dify、知识库、RAG、智能客服、文档问答、知识管理、向量数据库、Embedding、文本向量化、语义搜索、知识检索、问答系统、Bot、AI 应用平台、工作流、Prompt 工程、知识库搭建\n\n**内容概要**: 使用 Dify 搭建基于知识库的 AI 应用\n\n---\n\n#### 2.2 多模态 API\n**文件**: `docs/zh-cn/stage-2/ai-capabilities/2.2-multimodal-api/extra3/index.md`\n\n**关键词**: 多模态、图片识别、语音、图像理解、视觉模型、VLM、语音识别、语音合成、TTS、ASR、OCR、图像生成、文生图、图生图、GPT-4V、Claude Vision、文件上传、Base64、图像处理\n\n**内容概要**: 多模态 AI 能力的接入和使用\n\n---\n\n#### 2.2 Supabase 数据库\n**文件**: `docs/zh-cn/stage-2/backend/2.2-database-supabase/index.md`\n\n**关键词**: 数据库、Supabase、PostgreSQL、后端、数据存储、表设计、CRUD、增删改查、SQL、NoSQL、数据库连接、ORM、Prisma、数据模型、关系型数据库、主键外键、索引、查询优化、实时数据库、Row Level Security、RLS\n\n**内容概要**: 使用 Supabase 作为后端数据库，实现数据持久化\n\n---\n\n#### 2.3 AI 接口开发\n**文件**: `docs/zh-cn/stage-2/backend/2.3-ai-interface-code/index.md`\n\n**关键词**: AI 接口、后端开发、API 设计、RESTful、接口开发、路由、控制器、服务端、Node.js、Express、Koa、Fastify、中间件、请求处理、响应格式、状态码、错误处理、接口文档、Swagger、OpenAPI\n\n**内容概要**: 开发 AI 相关的后端接口\n\n---\n\n#### 2.4 Git 工作流\n**文件**: `docs/zh-cn/stage-2/backend/2.4-git-workflow/index.md`\n\n**关键词**: Git、版本控制、协作、代码管理、分支、Branch、Merge、Pull Request、PR、Commit、仓库、Repository、GitHub、GitLab、代码冲突、代码回滚、Cherry Pick、Rebase、Git Flow、团队协作\n\n**内容概要**: Git 版本控制和团队协作流程\n\n---\n\n#### 2.5 Web 应用部署与 Dify 官方云\n**文件**: `docs/zh-cn/stage-2/backend/zeabur-deployment/index.md`\n\n**关键词**: 部署、上线、Cloudflare Pages、Vercel、Render、Dify、CloudBase、Netlify、免费额度、云部署、CI/CD、持续集成、持续部署、域名、DNS、HTTPS、SSL、服务器、容器、Docker、环境变量、生产环境、Staging、Preview、自动化部署\n\n**内容概要**: 按场景介绍 Cloudflare Pages、Vercel、Render 与 Dify 官方云的操作步骤、免费限制，补充 CloudBase 和 Netlify 部署方式\n\n---\n\n#### 2.6 现代 CLI 工具\n**文件**: `docs/zh-cn/stage-2/backend/2.6-modern-cli/index.md`\n\n**关键词**: CLI、命令行、终端、Shell、Bash、Zsh、命令行工具、npm、yarn、pnpm、包管理、脚本、自动化、终端美化、Oh My Zsh、Homebrew、包管理器、环境配置\n\n**内容概要**: 现代命令行开发工具的使用\n\n---\n\n#### 2.7 Stripe 支付\n**文件**: `docs/zh-cn/stage-2/backend/2.7-stripe-payment/index.md`\n\n**关键词**: 支付、Stripe、收款、付款、支付网关、支付集成、订阅、Subscription、Checkout、支付表单、Webhook、支付回调、订单、发票、支付安全、PCI、货币、汇率\n\n**内容概要**: 集成 Stripe 支付功能\n\n---\n\n#### 2.0 Lovart 资源\n**文件**: `docs/zh-cn/stage-2/frontend/2.0-lovart-assets/index.md`\n\n**关键词**: Lovart、资源、素材、图片、图标、设计资源、UI 资源、插画、矢量图、免费素材、商用素材、Unsplash、Iconfont、设计系统\n\n**内容概要**: 设计资源和素材的获取与使用\n\n---\n\n#### 2.1 Figma MasterGo\n**文件**: `docs/zh-cn/stage-2/frontend/2.1-figma-mastergo/index.md`\n\n**关键词**: Figma、MasterGo、设计稿、转代码、Design-to-Code、设计工具、UI 设计、原型设计、设计规范、组件库、设计系统、切图、标注、设计交付、设计协作\n\n**内容概要**: 从设计稿到代码的转换\n\n---\n\n#### 2.2 UI 设计\n**文件**: `docs/zh-cn/stage-2/frontend/2.2-ui-design/index.md`\n\n**关键词**: UI 设计、界面、美观、视觉设计、排版、配色、字体、间距、布局、设计原则、设计模式、用户体验、交互设计、动效、微交互、设计趋势\n\n**内容概要**: UI 设计基础和最佳实践\n\n---\n\n#### 2.3 多端产品 UI\n**文件**: `docs/zh-cn/stage-2/frontend/2.3-multi-product-ui/index.md`\n\n**关键词**: 多端、响应式、移动端、PC 端、平板、适配、断点、Media Query、Flexbox、Grid、Viewport、移动端优先、桌面端、跨设备\n\n**内容概要**: 多端产品的 UI 适配\n\n---\n\n#### 2.4 LLM 技能美化\n**文件**: `docs/zh-cn/stage-2/frontend/2.4-llm-skills-beautiful/index.md`\n\n**关键词**: LLM 技能、美化、提示词优化、Prompt 美化、输出格式化、Markdown、代码高亮、流式输出、打字机效果、UI 美化、聊天界面\n\n**内容概要**: 优化 LLM 输出的展示效果\n\n---\n\n#### 2.5 哈利波特画像\n**文件**: `docs/zh-cn/stage-2/frontend/2.5-hogwarts-portraits/index.md`\n\n**关键词**: 哈利波特、画像、AI 绘画、图像生成、文生图、Stable Diffusion、Midjourney、DALL-E、图像处理、Canvas、特效、动画\n\n**内容概要**: AI 图像生成和前端展示\n\n---\n\n#### 2.6 设计转代码\n**文件**: `docs/zh-cn/stage-2/frontend/2.6-design-to-code/index.md`\n\n**关键词**: 设计转代码、Design-to-Code、自动代码生成、Figma 插件、代码导出、像素完美、设计还原、CSS、Tailwind、样式提取\n\n**内容概要**: 自动化设计稿转代码的工具和方法\n\n---\n\n#### 2.7 现代组件库\n**文件**: `docs/zh-cn/stage-2/frontend/2.7-modern-component-library/index.md`\n\n**关键词**: 组件库、Element Plus、Ant Design、Material UI、Chakra UI、组件封装、复用、Props、Event、Slot、表单组件、数据展示、导航组件、反馈组件\n\n**内容概要**: 使用现代组件库加速开发\n\n---\n\n#### 作业 2.1: 全栈应用\n**文件**: `docs/zh-cn/stage-2/assignments/2.1-fullstack-app/index.md`\n\n**关键词**: 作业、全栈应用、综合练习、项目作业、实战练习、考核、项目要求、评分标准\n\n**内容概要**: Stage 2 的综合作业要求\n\n---\n\n#### 作业 2.2: 现代前端 Trae\n**文件**: `docs/zh-cn/stage-2/assignments/2.2-modern-frontend-trae/index.md`\n\n**关键词**: 作业、Trae、现代前端、项目作业、实战练习、考核\n\n**内容概要**: 使用 Trae 完成现代前端开发作业\n\n---\n\n### Stage 3: 高级开发（跨平台 & AI 进阶）\n\n#### 3.0 基础技能\n**文件**: `docs/zh-cn/stage-3/core-skills/basics/index.md`\n\n**关键词**: 高级基础、核心技能、进阶知识、高级工程师、技术深度、编程范式、设计模式、代码质量、重构、性能优化、Claude、Claude Code、Anthropic\n\n**内容概要**: 高级开发必备的基础技能\n\n---\n\n#### 3.0 工作流\n**文件**: `docs/zh-cn/stage-3/core-skills/workflow/index.md`\n\n**关键词**: 工作流、开发流程、工程化、自动化、DevOps、开发规范、代码审查、Code Review、团队协作、项目管理、Claude、Claude Code\n\n**内容概要**: 高级开发的工程化工作流\n\n---\n\n#### 3.0 技能清单\n**文件**: `docs/zh-cn/stage-3/core-skills/skills/index.md`\n\n**关键词**: 技能清单、技能树、能力模型、技术栈、技术选型、技能评估、学习路径、进阶路线、Claude、Claude Code\n\n**内容概要**: 高级开发技能清单和学习路线\n\n---\n\n#### 3.0 超能力\n**文件**: `docs/zh-cn/stage-3/core-skills/superpowers/index.md`\n\n**关键词**: 超能力、高级技巧、黑科技、效率工具、开发神器、生产力、快捷键、插件、工具链、Claude、Claude Code\n\n**内容概要**: 提升开发效率的高级技巧和工具\n\n---\n\n#### 3.0 移动开发\n**文件**: `docs/zh-cn/stage-3/core-skills/mobile-development/index.md`\n\n**关键词**: 移动开发、移动端、React Native、Flutter、混合开发、H5、WebView、原生开发、App 开发、移动端优化、Claude、Claude Code\n\n**内容概要**: 移动应用开发技术概览\n\n---\n\n#### 3.0 规范编程\n**文件**: `docs/zh-cn/stage-3/core-skills/spec-coding/index.md`\n\n**关键词**: 规范编程、代码规范、ESLint、Prettier、TypeScript、类型安全、代码风格、命名规范、注释规范、文档规范、Claude、Claude Code\n\n**内容概要**: 规范化编程实践\n\n---\n\n#### 3.0 Claude Agent SDK\n**文件**: `docs/zh-cn/stage-3/core-skills/claude-agent-sdk/index.md`\n\n**关键词**: Claude、Claude Code、Claude Agent、SDK、Anthropic、Agent 开发、AI Agent、工具调用、Function Calling、Computer Use、核心技能、core-skills\n\n**内容概要**: Claude Agent SDK 的使用\n\n---\n\n#### 3.0 MCP 工具\n**文件**: `docs/zh-cn/stage-3/core-skills/mcp/index.md`\n\n**关键词**: MCP、Model Context Protocol、工具调用、Claude、Claude Code、外部工具、工具定义、Tool Definition、Function Calling、工具生态、MCP Server、MCP Client、上下文协议、AI 工具链、核心技能、core-skills\n\n**内容概要**: MCP 协议的完整使用指南\n\n---\n\n#### 3.0 Agent 团队\n**文件**: `docs/zh-cn/stage-3/core-skills/agent-teams/index.md`\n\n**关键词**: Agent 团队、多 Agent 协作、Multi-Agent、Agent 编排、角色分工、协作模式、工作流编排、LangChain、AutoGen、CrewAI、Claude、Claude Code、核心技能、core-skills\n\n**内容概要**: 多 Agent 协作系统的设计与实现\n\n---\n\n#### 3.0 长任务处理\n**文件**: `docs/zh-cn/stage-3/core-skills/long-running-tasks/index.md`\n\n**关键词**: 长任务、异步、后台任务、任务队列、Job Queue、Celery、Bull、Redis、消息队列、任务调度、定时任务、Cron、重试机制、任务状态、进度追踪、Claude、Claude Code、核心技能、core-skills\n\n**内容概要**: 长时间运行任务的处理方案\n\n---\n\n#### 3.A1 RAG 入门\n**文件**: `docs/zh-cn/stage-3/ai-advanced/3.a1-rag-introduction/index.md`\n\n**关键词**: RAG、检索增强生成、向量检索、Embedding、向量数据库、Pinecone、Weaviate、Milvus、Chroma、文档切分、Chunking、相似度搜索、语义检索、知识增强\n\n**内容概要**: RAG 技术的基础概念和实现\n\n---\n\n#### 3.A2 LangGraph 高级 RAG\n**文件**: `docs/zh-cn/stage-3/ai-advanced/3.a2-langgraph-advanced-rag/index.md`\n\n**关键词**: LangGraph、高级 RAG、知识图谱、GraphRAG、Agentic RAG、多跳推理、查询重写、重排序、ReRank、混合检索、Self-RAG、Corrective RAG、自适应 RAG\n\n**内容概要**: 使用 LangGraph 实现高级 RAG 系统\n\n---\n\n#### 3.3 微信小程序\n**文件**: `docs/zh-cn/stage-3/cross-platform/3.3-wechat-miniprogram/index.md`\n\n**关键词**: 微信小程序、小程序开发、微信开发、WXML、WXSS、小程序框架、云开发、小程序组件、小程序 API、微信支付、小程序发布、审核\n\n**内容概要**: 微信小程序开发完整指南\n\n---\n\n#### 3.4 小程序后端\n**文件**: `docs/zh-cn/stage-3/cross-platform/3.4-wechat-miniprogram-backend/index.md`\n\n**关键词**: 小程序后端、云开发、微信云开发、云函数、云数据库、云存储、Serverless、小程序登录、OpenID、UnionID、鉴权\n\n**内容概要**: 微信小程序后端开发\n\n---\n\n#### 3.5 Android App\n**文件**: `docs/zh-cn/stage-3/cross-platform/3.5-android-app/index.md`\n\n**关键词**: Android、安卓 App、Kotlin、Java、Android Studio、移动端开发、原生应用、APK、Google Play、Android SDK、Jetpack Compose\n\n**内容概要**: Android 应用开发\n\n---\n\n#### 3.6 iOS App\n**文件**: `docs/zh-cn/stage-3/cross-platform/3.6-ios-app/index.md`\n\n**关键词**: iOS、苹果 App、Swift、SwiftUI、Xcode、移动端开发、原生应用、App Store、iOS SDK、UIKit、TestFlight\n\n**内容概要**: iOS 应用开发\n\n---\n\n#### 3.7 个人网站博客\n**文件**: `docs/zh-cn/stage-3/personal-brand/3.7-personal-website-blog/index.md`\n\n**关键词**: 个人网站、博客、Portfolio、个人品牌、个人主页、简历网站、作品集、静态网站、SSG、Next.js、Nuxt、Hexo、Hugo、VitePress、域名、托管\n\n**内容概要**: 搭建个人网站和博客\n\n---\n\n#### 3.8 PWA 本地应用\n**文件**: `docs/zh-cn/stage-3/cross-platform/3.8-pwa-local-app/index.md`\n\n**关键词**: PWA、Progressive Web App、离线应用、Service Worker、Web App Manifest、本地存储、IndexedDB、Cache、添加到桌面、离线访问\n\n**内容概要**: 构建渐进式 Web 应用\n\n---\n\n#### 3.9 浏览器 AI 插件\n**文件**: `docs/zh-cn/stage-3/cross-platform/3.9-browser-ai-extension/index.md`\n\n**关键词**: 浏览器插件、Extension、Chrome Extension、Firefox Addon、插件开发、Content Script、Background Script、Popup、Manifest V3、浏览器扩展、AI 插件\n\n**内容概要**: 开发浏览器 AI 插件\n\n---\n\n#### 3.10 Electron 语音转文字\n**文件**: `docs/zh-cn/stage-3/cross-platform/3.10-electron-voice-to-text/index.md`\n\n**关键词**: Electron、桌面应用、跨平台桌面、语音转文字、ASR、语音识别、Whisper、桌面端、窗口应用、主进程、渲染进程、IPC\n\n**内容概要**: 使用 Electron 开发语音转文字桌面应用\n\n---\n\n#### 3.11 NFT 铸造\n**文件**: `docs/zh-cn/stage-3/cross-platform/3.11-nft-minting/index.md`\n\n**关键词**: NFT、铸造、区块链、Web3、智能合约、Solidity、以太坊、钱包、MetaMask、IPFS、数字藏品、Gas Fee、合约部署\n\n**内容概要**: NFT 铸造和 Web3 开发\n\n---\n\n#### 3.12 VS Code 插件\n**文件**: `docs/zh-cn/stage-3/cross-platform/3.12-vscode-extension/index.md`\n\n**关键词**: VS Code 插件、Extension、编辑器插件、VS Code API、Command、Tree View、Webview、Language Server、代码补全、语法高亮\n\n**内容概要**: 开发 VS Code 插件\n\n---\n\n#### 3.13 Qt 工业 HMI\n**文件**: `docs/zh-cn/stage-3/cross-platform/3.13-qt-industrial-hmi/index.md`\n\n**关键词**: Qt、工业 HMI、人机界面、工控、SCADA、C++、QML、工业自动化、实时监控、数据采集、PLC、Modbus、OPC UA\n\n**内容概要**: 使用 Qt 开发工业人机界面\n\n---\n\n## 附录：知识体系\n\n### 一、计算机基础\n\n#### 1. Vibe Coding 时代全栈开发\n**文件**: `docs/zh-cn/appendix/1-computer-fundamentals/vibe-coding-fullstack.md`\n\n**关键词**: Vibe Coding、全栈开发、AI 编程、前端、后端、编程语言、工程师成长、技术栈、职业发展\n\n---\n\n#### 2. 从晶体管到 CPU\n**文件**: `docs/zh-cn/appendix/1-computer-fundamentals/transistor-to-cpu.md`\n\n**关键词**: 晶体管、CPU、计算机组成、硬件、逻辑门、运算器、控制器、寄存器、指令集、汇编、机器码、冯诺依曼\n\n---\n\n#### 3. 操作系统\n**文件**: `docs/zh-cn/appendix/1-computer-fundamentals/operating-systems.md`\n\n**关键词**: 操作系统、OS、进程、线程、内存管理、文件系统、调度、并发、同步、死锁、虚拟内存、内核、用户态\n\n---\n\n#### 4. 数据编码与存储\n**文件**: `docs/zh-cn/appendix/1-computer-fundamentals/data-encoding-storage.md`\n\n**关键词**: 数据编码、二进制、字符编码、UTF-8、ASCII、Unicode、数据压缩、存储、文件格式、序列化、JSON、XML、Protobuf\n\n---\n\n#### 5. 计算机网络\n**文件**: `docs/zh-cn/appendix/1-computer-fundamentals/computer-networks.md`\n\n**关键词**: 计算机网络、网络协议、TCP/IP、HTTP、HTTPS、DNS、IP、MAC、路由、交换、网络分层、OSI、Socket、WebSocket\n\n---\n\n#### 6. 数据结构\n**文件**: `docs/zh-cn/appendix/1-computer-fundamentals/data-structures.md`\n\n**关键词**: 数据结构、数组、链表、栈、队列、树、二叉树、堆、图、哈希表、集合、字典、时间复杂度、空间复杂度\n\n---\n\n#### 7. 算法思维\n**文件**: `docs/zh-cn/appendix/1-computer-fundamentals/algorithm-thinking.md`\n\n**关键词**: 算法、排序、搜索、递归、动态规划、贪心、分治、回溯、算法复杂度、大 O 表示法、LeetCode\n\n---\n\n#### 8. 编程语言图谱\n**文件**: `docs/zh-cn/appendix/1-computer-fundamentals/programming-languages.md`\n\n**关键词**: 编程语言、语言分类、静态类型、动态类型、编译型、解释型、面向对象、函数式、脚本语言、系统语言\n\n---\n\n#### 9. 编译原理\n**文件**: `docs/zh-cn/appendix/1-computer-fundamentals/compilers.md`\n\n**关键词**: 编译原理、词法分析、语法分析、AST、抽象语法树、语义分析、代码生成、优化、解释器、编译器\n\n---\n\n#### 10. 类型系统\n**文件**: `docs/zh-cn/appendix/1-computer-fundamentals/type-systems.md`\n\n**关键词**: 类型系统、静态类型、动态类型、强类型、弱类型、类型推断、泛型、类型安全、TypeScript、类型检查\n\n---\n\n#### 11. 计算机组成原理\n**文件**: `docs/zh-cn/appendix/1-computer-fundamentals/computer-organization.md`\n\n**关键词**: 计算机组成、体系结构、存储器、缓存、Cache、总线、I/O、中断、DMA、流水线、并行计算\n\n---\n\n#### 12. 从开机到上网\n**文件**: `docs/zh-cn/appendix/1-computer-fundamentals/power-on-to-web.md`\n\n**关键词**: 开机启动、引导、BIOS、UEFI、Bootloader、操作系统启动、内核加载、用户登录、浏览器、网络连接\n\n---\n\n### 二、开发环境与工具\n\n#### 1. IDE 基础\n**文件**: `docs/zh-cn/appendix/2-development-tools/ide-basics.md`\n\n**关键词**: IDE、VS Code、Cursor、Trae、编辑器、开发环境、插件、扩展、快捷键、调试、代码补全\n\n---\n\n#### 2. 命令行与 Shell\n**文件**: `docs/zh-cn/appendix/2-development-tools/command-line-shell.md`\n\n**关键词**: 命令行、Shell、Bash、Zsh、Terminal、终端、命令、脚本、管道、重定向、环境变量、权限\n\n---\n\n#### 3. Git 版本控制\n**文件**: `docs/zh-cn/appendix/2-development-tools/git-version-control.md`\n\n**关键词**: Git、版本控制、分支、合并、提交、仓库、GitHub、GitLab、冲突解决、Rebase、Cherry Pick\n\n---\n\n#### 4. 环境变量与 PATH\n**文件**: `docs/zh-cn/appendix/2-development-tools/environment-path.md`\n\n**关键词**: 环境变量、PATH、系统变量、用户变量、配置、.env、dotenv、环境配置\n\n---\n\n#### 5. 端口与 localhost\n**文件**: `docs/zh-cn/appendix/2-development-tools/ports-localhost.md`\n\n**关键词**: 端口、Port、localhost、127.0.0.1、本地开发、端口冲突、端口占用、网络地址\n\n---\n\n#### 6. 包管理器\n**文件**: `docs/zh-cn/appendix/2-development-tools/package-managers.md`\n\n**关键词**: 包管理器、npm、yarn、pnpm、pip、conda、gem、依赖管理、package.json、requirements.txt\n\n---\n\n#### 7. SSH 与认证\n**文件**: `docs/zh-cn/appendix/2-development-tools/ssh-authentication.md`\n\n**关键词**: SSH、密钥、公钥、私钥、认证、免密登录、SSH Key、GitHub SSH、安全连接\n\n---\n\n#### 8. 调试艺术\n**文件**: `docs/zh-cn/appendix/2-development-tools/debugging-art.md`\n\n**关键词**: 调试、Debug、断点、单步执行、Console、Log、Debugger、Chrome DevTools、性能分析\n\n---\n\n#### 9. 正则表达式\n**文件**: `docs/zh-cn/appendix/2-development-tools/regex.md`\n\n**关键词**: 正则表达式、Regex、Pattern、匹配、替换、验证、RegExp、字符串处理\n\n---\n\n### 三、浏览器与前端\n\n#### 1. HTML CSS 布局\n**文件**: `docs/zh-cn/appendix/3-browser-and-frontend/html-css-layout.md`\n\n**关键词**: HTML、CSS、布局、Flexbox、Grid、响应式、盒模型、选择器、样式、动画、Transition、Animation\n\n---\n\n#### 2. JavaScript 深入\n**文件**: `docs/zh-cn/appendix/3-browser-and-frontend/javascript-deep-dive.md`\n\n**关键词**: JavaScript、JS、ES6、闭包、原型链、作用域、异步、Promise、Async/Await、Event Loop、this、原型、继承\n\n---\n\n#### 3. TypeScript\n**文件**: `docs/zh-cn/appendix/3-browser-and-frontend/typescript.md`\n\n**关键词**: TypeScript、TS、类型、接口、泛型、装饰器、类型推断、编译、配置、tsconfig\n\n---\n\n#### 4. 前端框架\n**文件**: `docs/zh-cn/appendix/3-browser-and-frontend/frontend-frameworks.md`\n\n**关键词**: 前端框架、React、Vue、Angular、Svelte、组件、状态管理、生命周期、Hooks、Composition API\n\n---\n\n#### 5. 前端工程化\n**文件**: `docs/zh-cn/appendix/3-browser-and-frontend/frontend-engineering.md`\n\n**关键词**: 前端工程化、构建工具、Webpack、Vite、Rollup、Parcel、Babel、ESLint、Prettier、代码规范\n\n---\n\n#### 6. 浏览器渲染\n**文件**: `docs/zh-cn/appendix/3-browser-and-frontend/browser-as-os-rendering.md`\n\n**关键词**: 浏览器、渲染引擎、DOM、CSSOM、渲染树、重绘、重排、合成层、GPU 加速、性能优化\n\n---\n\n#### 7. 路由与导航\n**文件**: `docs/zh-cn/appendix/3-browser-and-frontend/routing-navigation.md`\n\n**关键词**: 路由、Router、前端路由、Vue Router、React Router、History API、Hash、SPA、单页应用\n\n---\n\n#### 8. 状态管理\n**文件**: `docs/zh-cn/appendix/3-browser-and-frontend/state-management.md`\n\n**关键词**: 状态管理、Vuex、Pinia、Redux、MobX、Zustand、Jotai、全局状态、状态机、Context\n\n---\n\n#### 9. 前端项目架构\n**文件**: `docs/zh-cn/appendix/3-browser-and-frontend/frontend-project-architecture.md`\n\n**关键词**: 前端架构、项目结构、目录组织、模块化、组件化、分层架构、微前端、Monorepo\n\n---\n\n#### 10. 实时通信\n**文件**: `docs/zh-cn/appendix/3-browser-and-frontend/realtime-communication.md`\n\n**关键词**: 实时通信、WebSocket、Socket.io、SSE、Server-Sent Events、长轮询、WebRTC、实时数据\n\n---\n\n#### 11. 图形与动画\n**文件**: `docs/zh-cn/appendix/3-browser-and-frontend/graphics-animation.md`\n\n**关键词**: 图形、动画、Canvas、SVG、WebGL、Three.js、CSS 动画、帧动画、粒子效果\n\n---\n\n#### 12. Web 性能\n**文件**: `docs/zh-cn/appendix/3-browser-and-frontend/web-performance.md`\n\n**关键词**: Web 性能、性能优化、加载优化、运行时优化、Lighthouse、Core Web Vitals、懒加载、代码分割、缓存\n\n---\n\n#### 13. 无障碍与国际化\n**文件**: `docs/zh-cn/appendix/3-browser-and-frontend/a11n-i18n.md`\n\n**关键词**: 无障碍、A11y、ARIA、国际化、i18n、本地化、l10n、多语言、屏幕阅读器\n\n---\n\n#### 14. JavaScript 运行时\n**文件**: `docs/zh-cn/appendix/3-browser-and-frontend/javascript-runtime.md`\n\n**关键词**: JavaScript 运行时、Node.js、Deno、Bun、运行时环境、事件循环、模块系统\n\n---\n\n#### 15. 前端框架本质\n**文件**: `docs/zh-cn/appendix/3-browser-and-frontend/frontend-framework-nature.md`\n\n**关键词**: 前端框架本质、Virtual DOM、Diff 算法、响应式原理、依赖追踪、编译优化\n\n---\n\n### 四、服务器与后端\n\n#### 1. 后端语言\n**文件**: `docs/zh-cn/appendix/4-server-and-backend/backend-languages.md`\n\n**关键词**: 后端语言、Node.js、Python、Java、Go、Rust、PHP、Ruby、语言选择、技术栈\n\n---\n\n#### 2. 后端分层架构\n**文件**: `docs/zh-cn/appendix/4-server-and-backend/backend-layered-architecture.md`\n\n**关键词**: 后端架构、分层、MVC、三层架构、领域驱动、DDD、Clean Architecture、依赖注入\n\n---\n\n#### 3. 请求旅程\n**文件**: `docs/zh-cn/appendix/4-server-and-backend/request-journey.md`\n\n**关键词**: 请求旅程、HTTP 请求、生命周期、中间件、路由、控制器、服务层、数据层、响应\n\n---\n\n#### 4. API 入门\n**文件**: `docs/zh-cn/appendix/4-server-and-backend/api-intro.md`\n\n**关键词**: API、接口、REST、RESTful、HTTP 方法、状态码、请求头、响应头、Content-Type、认证\n\n---\n\n#### 5. API 设计\n**文件**: `docs/zh-cn/appendix/4-server-and-backend/api-design.md`\n\n**关键词**: API 设计、接口设计、版本控制、URL 设计、资源命名、错误处理、分页、过滤、排序\n\n---\n\n#### 6. Web 框架\n**文件**: `docs/zh-cn/appendix/4-server-and-backend/web-frameworks.md`\n\n**关键词**: Web 框架、Express、Koa、Fastify、NestJS、Django、Flask、Spring Boot、Gin、路由、中间件\n\n---\n\n#### 7. HTTP 协议\n**文件**: `docs/zh-cn/appendix/4-server-and-backend/http-protocol.md`\n\n**关键词**: HTTP、协议、请求、响应、Header、Body、Method、Status Code、Cookie、Session、Keep-Alive、HTTP/2、HTTP/3\n\n---\n\n#### 8. 认证与授权\n**文件**: `docs/zh-cn/appendix/4-server-and-backend/auth-authorization.md`\n\n**关键词**: 认证、授权、Auth、JWT、OAuth、SSO、Session、Cookie、Token、权限、RBAC、鉴权\n\n---\n\n#### 9. 序列化\n**文件**: `docs/zh-cn/appendix/4-server-and-backend/serialization.md`\n\n**关键词**: 序列化、反序列化、JSON、XML、Protobuf、MessagePack、Avro、Thrift、数据格式\n\n---\n\n#### 10. 并发与异步\n**文件**: `docs/zh-cn/appendix/4-server-and-backend/concurrency-async.md`\n\n**关键词**: 并发、异步、多线程、多进程、协程、Promise、Async/Await、事件驱动、回调、非阻塞 IO\n\n---\n\n#### 11. 缓存\n**文件**: `docs/zh-cn/appendix/4-server-and-backend/caching.md`\n\n**关键词**: 缓存、Cache、Redis、Memcached、本地缓存、分布式缓存、缓存策略、缓存穿透、缓存雪崩、缓存更新\n\n---\n\n#### 12. 消息队列\n**文件**: `docs/zh-cn/appendix/4-server-and-backend/message-queues.md`\n\n**关键词**: 消息队列、MQ、RabbitMQ、Kafka、RocketMQ、消息模型、发布订阅、点对点、消息可靠性\n\n---\n\n#### 13. 异步任务队列\n**文件**: `docs/zh-cn/appendix/4-server-and-backend/async-task-queues.md`\n\n**关键词**: 任务队列、Celery、Bull、RQ、Sidekiq、后台任务、定时任务、任务调度、重试机制\n\n---\n\n#### 14. 限流与背压\n**文件**: `docs/zh-cn/appendix/4-server-and-backend/rate-limiting-backpressure.md`\n\n**关键词**: 限流、Rate Limiting、背压、Backpressure、流量控制、熔断、降级、负载保护、令牌桶、漏桶\n\n---\n\n#### 15. 搜索引擎\n**文件**: `docs/zh-cn/appendix/4-server-and-backend/search-engines.md`\n\n**关键词**: 搜索引擎、Elasticsearch、Solr、全文搜索、倒排索引、分词、相关性排序、搜索优化\n\n---\n\n#### 16. 文件存储\n**文件**: `docs/zh-cn/appendix/4-server-and-backend/file-storage.md`\n\n**关键词**: 文件存储、OSS、S3、MinIO、云存储、对象存储、CDN、文件上传、断点续传、分片上传\n\n---\n\n#### 17. 后端项目架构\n**文件**: `docs/zh-cn/appendix/4-server-and-backend/backend-project-architecture.md`\n\n**关键词**: 后端项目架构、项目结构、目录组织、模块化、服务划分、代码组织、最佳实践\n\n---\n\n#### 18. 客户端语言\n**文件**: `docs/zh-cn/appendix/4-server-and-backend/client-languages.md`\n\n**关键词**: 客户端语言、移动端、桌面端、小程序、跨平台、React Native、Flutter、Electron、Tauri\n\n---\n\n#### 19. 领域特定语言\n**文件**: `docs/zh-cn/appendix/4-server-and-backend/domain-specific-languages.md`\n\n**关键词**: DSL、领域特定语言、SQL、正则、GraphQL、配置语言、模板语言、内部 DSL、外部 DSL\n\n---\n\n#### 20. 跨平台\n**文件**: `docs/zh-cn/appendix/4-server-and-backend/cross-platform.md`\n\n**关键词**: 跨平台、多端、统一开发、Write Once Run Anywhere、跨平台框架、适配策略\n\n---\n\n### 五、数据\n\n#### 1. 数据库基础\n**文件**: `docs/zh-cn/appendix/5-data/database-fundamentals.md`\n\n**关键词**: 数据库基础、关系型数据库、SQL、MySQL、PostgreSQL、表、字段、索引、事务、ACID、SQL 语句\n\n---\n\n#### 2. 数据模型\n**文件**: `docs/zh-cn/appendix/5-data/data-models.md`\n\n**关键词**: 数据模型、ER 模型、关系模型、文档模型、图模型、键值模型、数据建模、范式、反范式\n\n---\n\n#### 3. 数据分析\n**文件**: `docs/zh-cn/appendix/5-data/data-analysis.md`\n\n**关键词**: 数据分析、Python、Pandas、NumPy、数据清洗、数据可视化、统计分析、BI、数据挖掘\n\n---\n\n#### 4. 数据可视化\n**文件**: `docs/zh-cn/appendix/5-data/data-visualization.md`\n\n**关键词**: 数据可视化、图表、ECharts、D3.js、AntV、Tableau、可视化设计、交互可视化\n\n---\n\n#### 5. A/B 测试\n**文件**: `docs/zh-cn/appendix/5-data/ab-testing.md`\n\n**关键词**: A/B 测试、实验、对照组、实验组、显著性、假设检验、转化率、实验设计\n\n---\n\n#### 6. 数据埋点\n**文件**: `docs/zh-cn/appendix/5-data/data-tracking.md`\n\n**关键词**: 数据埋点、事件追踪、用户行为、数据分析、漏斗分析、留存分析、归因分析\n\n---\n\n#### 7. 数据治理\n**文件**: `docs/zh-cn/appendix/5-data/data-governance.md`\n\n**关键词**: 数据治理、数据质量、数据安全、数据标准、元数据、数据血缘、合规、隐私\n\n---\n\n### 六、架构与系统设计\n\n#### 1. 系统设计方法论\n**文件**: `docs/zh-cn/appendix/6-architecture-and-system-design/system-design-methodology.md`\n\n**关键词**: 系统设计、架构设计、设计原则、SOLID、设计模式、系统思维、权衡、扩展性、可用性\n\n---\n\n#### 2. 分布式系统\n**文件**: `docs/zh-cn/appendix/6-architecture-and-system-design/distributed-systems.md`\n\n**关键词**: 分布式系统、CAP 定理、一致性、可用性、分区容错、分布式事务、共识算法、Raft、Paxos\n\n---\n\n#### 3. 高可用\n**文件**: `docs/zh-cn/appendix/6-architecture-and-system-design/high-availability.md`\n\n**关键词**: 高可用、HA、容灾、故障转移、主从、集群、多活、SLA、SLO、SLI、可靠性工程\n\n---\n\n#### 4. 单体到微服务\n**文件**: `docs/zh-cn/appendix/6-architecture-and-system-design/monolith-to-microservices.md`\n\n**关键词**: 微服务、单体、服务拆分、服务治理、服务发现、配置中心、链路追踪、分布式追踪\n\n---\n\n### 七、基础设施与运维\n\n#### 1. Linux 基础\n**文件**: `docs/zh-cn/appendix/7-infrastructure-and-operations/linux-basics.md`\n\n**关键词**: Linux、操作系统、命令行、Shell、文件系统、权限、进程管理、网络配置、系统管理\n\n---\n\n#### 2. Docker 容器\n**文件**: `docs/zh-cn/appendix/7-infrastructure-and-operations/docker-containers.md`\n\n**关键词**: Docker、容器、镜像、Container、Dockerfile、Compose、容器化、微服务部署\n\n---\n\n#### 3. Kubernetes\n**文件**: `docs/zh-cn/appendix/7-infrastructure-and-operations/kubernetes.md`\n\n**关键词**: Kubernetes、K8s、容器编排、Pod、Service、Deployment、Ingress、Helm、集群管理\n\n---\n\n#### 4. CI/CD\n**文件**: `docs/zh-cn/appendix/7-infrastructure-and-operations/ci-cd.md`\n\n**关键词**: CI/CD、持续集成、持续部署、Jenkins、GitLab CI、GitHub Actions、自动化构建、自动化测试\n\n---\n\n#### 5. 云平台\n**文件**: `docs/zh-cn/appendix/7-infrastructure-and-operations/cloud-platforms.md`\n\n**关键词**: 云平台、AWS、Azure、GCP、阿里云、腾讯云、华为云、云服务、IaaS、PaaS、SaaS\n\n---\n\n#### 6. 云 IAM\n**文件**: `docs/zh-cn/appendix/7-infrastructure-and-operations/cloud-iam.md`\n\n**关键词**: IAM、身份管理、访问控制、权限管理、角色、策略、RBAC、云安全\n\n---\n\n#### 7. 云存储与 CDN\n**文件**: `docs/zh-cn/appendix/7-infrastructure-and-operations/cloud-storage-cdn.md`\n\n**关键词**: 云存储、CDN、对象存储、内容分发、边缘计算、加速、缓存策略\n\n---\n\n#### 8. DNS 与 HTTPS\n**文件**: `docs/zh-cn/appendix/7-infrastructure-and-operations/dns-https.md`\n\n**关键词**: DNS、域名解析、HTTPS、SSL、TLS、证书、CA、加密、安全传输\n\n---\n\n#### 9. 负载均衡与网关\n**文件**: `docs/zh-cn/appendix/7-infrastructure-and-operations/load-balancing-gateway.md`\n\n**关键词**: 负载均衡、Gateway、Nginx、API Gateway、反向代理、流量分发、健康检查\n\n---\n\n#### 10. 网关代理\n**文件**: `docs/zh-cn/appendix/7-infrastructure-and-operations/gateway-proxy.md`\n\n**关键词**: 网关、代理、Nginx、Traefik、Envoy、服务网格、Istio、流量管理\n\n---\n\n#### 11. 基础设施即代码\n**文件**: `docs/zh-cn/appendix/7-infrastructure-and-operations/infrastructure-as-code.md`\n\n**关键词**: IaC、基础设施即代码、Terraform、Ansible、Pulumi、CloudFormation、自动化运维\n\n---\n\n#### 12. 监控与日志\n**文件**: `docs/zh-cn/appendix/7-infrastructure-and-operations/monitoring-logging.md`\n\n**关键词**: 监控、日志、Prometheus、Grafana、ELK、Loki、告警、可观测性、Observability\n\n---\n\n#### 13. 事故响应\n**文件**: `docs/zh-cn/appendix/7-infrastructure-and-operations/incident-response.md`\n\n**关键词**: 事故响应、故障处理、应急响应、SRE、事后复盘、故障演练、混沌工程\n\n---\n\n### 八、人工智能\n\n#### 1. AI 历史\n**文件**: `docs/zh-cn/appendix/8-artificial-intelligence/ai-history.md`\n\n**关键词**: AI 历史、人工智能发展、机器学习历史、深度学习、神经网络历史、AI 里程碑\n\n---\n\n#### 2. 神经网络\n**文件**: `docs/zh-cn/appendix/8-artificial-intelligence/neural-networks.md`\n\n**关键词**: 神经网络、深度学习、CNN、RNN、LSTM、GRU、激活函数、反向传播、梯度下降\n\n---\n\n#### 3. Transformer 与注意力机制\n**文件**: `docs/zh-cn/appendix/8-artificial-intelligence/transformer-attention.md`\n\n**关键词**: Transformer、注意力机制、Attention、Self-Attention、Multi-Head Attention、BERT、GPT、位置编码\n\n---\n\n#### 4. LLM 原理\n**文件**: `docs/zh-cn/appendix/8-artificial-intelligence/llm-principles.md`\n\n**关键词**: LLM、大语言模型、预训练、微调、Fine-tuning、RLHF、对齐、涌现能力、Scaling Law\n\n---\n\n#### 5. Prompt 工程\n**文件**: `docs/zh-cn/appendix/8-artificial-intelligence/prompt-engineering.md`\n\n**关键词**: Prompt 工程、提示词、Prompt Design、Few-shot、Chain-of-Thought、ReAct、提示词优化\n\n---\n\n#### 6. RAG\n**文件**: `docs/zh-cn/appendix/8-artificial-intelligence/rag.md`\n\n**关键词**: RAG、检索增强生成、向量检索、Embedding、知识库、文档问答、语义搜索\n\n---\n\n#### 7. Embedding 与向量检索\n**文件**: `docs/zh-cn/appendix/8-artificial-intelligence/embedding-vector-retrieval.md`\n\n**关键词**: Embedding、向量、向量检索、向量数据库、相似度、余弦相似度、向量空间\n\n---\n\n#### 8. AI Agent\n**文件**: `docs/zh-cn/appendix/8-artificial-intelligence/ai-agents.md`\n\n**关键词**: AI Agent、智能体、Agent 架构、ReAct、Plan-and-Execute、Tool Use、Multi-Agent\n\n---\n\n#### 9. 多模态模型\n**文件**: `docs/zh-cn/appendix/8-artificial-intelligence/multimodal-models.md`\n\n**关键词**: 多模态、视觉语言模型、VLM、CLIP、GPT-4V、图像理解、跨模态、图文生成\n\n---\n\n#### 10. 图像生成\n**文件**: `docs/zh-cn/appendix/8-artificial-intelligence/image-generation.md`\n\n**关键词**: 图像生成、文生图、Stable Diffusion、Midjourney、DALL-E、GAN、Diffusion、ControlNet\n\n---\n\n#### 11. 语音合成与识别\n**文件**: `docs/zh-cn/appendix/8-artificial-intelligence/speech-synthesis-recognition.md`\n\n**关键词**: 语音合成、语音识别、TTS、ASR、Whisper、语音克隆、声纹识别\n\n---\n\n#### 12. 模型微调与部署\n**文件**: `docs/zh-cn/appendix/8-artificial-intelligence/model-finetuning-deployment.md`\n\n**关键词**: 模型微调、Fine-tuning、LoRA、QLoRA、模型部署、模型量化、推理优化、ONNX、TensorRT\n\n---\n\n#### 13. AI 协议\n**文件**: `docs/zh-cn/appendix/8-artificial-intelligence/ai-protocols.md`\n\n**关键词**: AI 协议、MCP、Function Calling、Tool Use、API 标准、OpenAI API、Anthropic API\n\n---\n\n#### 14. AI 原生应用设计\n**文件**: `docs/zh-cn/appendix/8-artificial-intelligence/ai-native-app-design.md`\n\n**关键词**: AI 原生应用、AI-First、产品设计、用户体验、人机交互、Copilot、Agent 界面\n\n---\n\n#### 15. 上下文工程\n**文件**: `docs/zh-cn/appendix/8-artificial-intelligence/context-engineering.md`\n\n**关键词**: 上下文工程、Context Engineering、上下文管理、长上下文、RAG、记忆、会话管理\n\n---\n\n#### 16. AI 能力词典\n**文件**: `docs/zh-cn/appendix/8-artificial-intelligence/ai-capability-dictionary.md`\n\n**关键词**: AI 能力、AI 功能、能力清单、应用场景、技术选型、AI 解决方案\n\n---\n\n### 九、工程卓越\n\n#### 1. 代码质量与重构\n**文件**: `docs/zh-cn/appendix/9-engineering-excellence/code-quality-refactoring.md`\n\n**关键词**: 代码质量、重构、Clean Code、代码审查、技术债务、代码异味、重构模式\n\n---\n\n#### 2. 测试策略\n**文件**: `docs/zh-cn/appendix/9-engineering-excellence/testing-strategies.md`\n\n**关键词**: 测试、单元测试、集成测试、E2E 测试、TDD、BDD、测试覆盖率、Mock、自动化测试\n\n---\n\n#### 3. 设计模式\n**文件**: `docs/zh-cn/appendix/9-engineering-excellence/design-patterns.md`\n\n**关键词**: 设计模式、单例、工厂、观察者、策略、装饰器、适配器、MVC、MVVM、架构模式\n\n---\n\n#### 4. 技术选型\n**文件**: `docs/zh-cn/appendix/9-engineering-excellence/technology-selection.md`\n\n**关键词**: 技术选型、技术决策、技术栈、框架选择、评估标准、技术雷达、技术债\n\n---\n\n#### 5. 开源协作\n**文件**: `docs/zh-cn/appendix/9-engineering-excellence/open-source-collaboration.md`\n\n**关键词**: 开源、开源协作、GitHub、贡献指南、Code Review、社区、开源协议、LICENSE\n\n---\n\n#### 6. 安全思维\n**文件**: `docs/zh-cn/appendix/9-engineering-excellence/security-thinking.md`\n\n**关键词**: 安全、安全思维、OWASP、漏洞、注入、XSS、CSRF、安全编码、加密、认证\n\n---\n\n#### 7. 技术写作\n**文件**: `docs/zh-cn/appendix/9-engineering-excellence/technical-writing.md`\n\n**关键词**: 技术写作、文档、README、API 文档、技术博客、知识分享、文档规范\n\n---\n\n## ✅ 回答规则（必读）\n\n1. **先读高层架构**：先阅读上面的\"高层级架构\"和\"快速决策树\"，确定用户问题属于哪个阶段\n2. **再查详细索引**：根据阶段定位到详细文章索引，找到具体文件\n3. **引用来源**：回答时注明信息来自哪个文件，例如：\"根据 `stage-1/1.1-introduction-to-ai-ide` 的内容...\"\n4. **代码优先**：优先使用教程中提供的代码示例\n5. **阶段匹配**：根据用户水平推荐合适的内容，不要给新手推荐 Stage 3 的高级内容\n6. **关键词匹配**：根据用户问题中的关键词，快速定位到对应文件\n7. **不确定时**：明确告诉用户\"让我先查看相关教程内容\"，然后读取文件\n8. **附录参考**：当用户问基础概念时，优先引用附录中的知识文章\n\n---\n\n## 📚 教程概览\n\n**Easy-Vibe** 是一个从零开始的 AI 编程教程，核心理念是 **Vibe Coding**（用自然语言编程）。\n\n### 学习路径\n\n```\nStage 0 (新手入门)\n    ↓\nStage 1 (AI 产品经理) - 用 AI IDE 做原型\n    ↓\nStage 2 (初中级开发) - 全栈开发 + 部署\n    ↓\nStage 3 (高级开发) - 跨平台 + AI 进阶\n    ↓\n附录 (知识体系) - 计算机基础到工程素养\n```\n\n### 目标读者\n- **零基础用户**：从 Stage 0 开始，先体验 AI 编程的乐趣\n- **产品经理/设计师**：重点学习 Stage 1，快速做 Demo\n- **初级开发者**：Stage 2 帮你补齐全栈技能\n- **高级开发者**：Stage 3 的 MCP、RAG、跨平台开发\n- **全栈工程师**：附录提供完整的计算机知识体系\n\n### 技术栈\n- **AI IDE**: Cursor, Claude Code, Trae\n- **前端**: Vue 3, React, Element Plus\n- **后端**: Node.js, Supabase, Dify\n- **部署**: Cloudflare Pages, Vercel, Render, Dify Cloud, CloudBase, Netlify\n- **跨平台**: 微信小程序, Android, iOS, Electron\n- **AI 技术**: LLM, RAG, MCP, Agent, 多模态\n\n---\n\n## 🔗 相关文件\n\n- **本文件**: `llms.txt` - AI 导航入口（必读）\n- **Claude Code 专用**: `CLAUDE.md` - 针对 Claude Code 的详细指南\n- **项目说明**: `README.md` - 人类用户入口\n- **配置文件**: `docs/.vitepress/config.mjs` - 网站导航配置\n\n---\n\n## 📝 版本信息\n\n- **版本**: 2.1.0\n- **更新日期**: 2026-03-02\n- **文章总数**: 100+ 篇\n- **语言支持**: 中文(zh-cn), 英文(en), 日文(ja-jp), 韩文(ko-kr), 繁体中文(zh-tw), 西班牙文(es-es), 法文(fr-fr), 德文(de-de), 阿拉伯文(ar-sa), 越南文(vi-vn)\n- **默认语言**: 中文 (`docs/zh-cn/`)\n\n---\n\n> 💡 **提示**: 如果你是多语言 AI，请根据用户使用的语言选择对应的 `docs/{语言}/` 目录下的文件。\n","tools/translation/fixtures/fail-code-block/localized.md":"<!-- Expected failure: the port value inside the fenced code block was changed. -->\n\n# 실행\n\n```js\nconst port = 8080\n```\n","tools/translation/fixtures/fail-frontmatter/source.md":"---\ntitle: 安装指南\ndescription: 安装示例\n---\n\n<!-- Fixture source: the localized file must preserve both frontmatter keys. -->\n\n# 安装\n","tools/translation/ko-kr/glossary.md":"# 번역 용어집 (Translation Glossary)\n\n> stage-1 zh↔ko 정렬로 시드. 새 용어는 번역 PR에서 논의한 뒤 승인 시 편입.\n\n## 원칙\n- 아래 표준 용어를 무조건 사용한다. 같은 개념을 다른 단어로 번역하지 않는다.\n- \"원문유지\"는 번역하지 않는다. \"외래어표기\"는 정해진 한글 표기를 쓴다.\n- 금지어가 떠오르면 표준 용어로 치환한다.\n- **업계 표준어는 웬만하면 영문 유지**: 한국어로 옮겼을 때 어색하거나 의미가 애매해지는 업계 표준 용어(text-to-image, image-to-image 등)는 **영문 그대로** 둔다. 억지 음차·직역(문생도, 텍스트→이미지 등)은 금지.\n\n## 용어 표\n\n| 中文 | 한국어 표준 | 영어 유지 여부 | 금지어 |\n|------|------------|--------------|--------|\n| VS Code / Visual Studio Code | VS Code / Visual Studio Code | 원문유지 | 비주얼 스튜디오 코드 |\n| Trae | Trae | 원문유지 | 트레이 |\n| Cursor | Cursor | 원문유지 | 커서 |\n| z.ai | z.ai | 원문유지 | - |\n| Figma / Figma Make | Figma / Figma Make | 원문유지 | 피그마 |\n| GitHub | GitHub | 원문유지 | 깃허브 |\n| DeepSeek | DeepSeek | 원문유지 | 딥시크 |\n| MiniMax | MiniMax | 원문유지 | 미니맥스 |\n| SiliconFlow / 硅基流动 | SiliconFlow | 원문유지 | 실리콘플로우, 실리콘 베이스드 플로우 |\n| 通义千问 | Tongyi Qianwen | 원문유지 | 퉁이첸원, 통의천문 |\n| 字节跳动 | ByteDance | 원문유지 | 바이트댄스 |\n| 阿里巴巴 / 阿里云 | Alibaba / Alibaba Cloud | 원문유지 | 알리바바, 알리바바 클라우드 |\n| 腾讯云 | Tencent Cloud | 원문유지 | 텐센트 클라우드 |\n| 智谱 / 智谱 AI | Zhipu / Zhipu AI | 원문유지 | 즈푸, 지푸 AI |\n| 火山引擎 | Volcengine | 원문유지 | 볼케이노 엔진, 화산엔진 |\n| 抖音 | Douyin | 원문유지 | 더우인, 틱톡 |\n| 小红书 | 샤오훙슈 | 외래어표기 | 샤오홍슈, 레드 |\n| 美菜网 | Meicai | 원문유지 | 메이차이 |\n| Builder / Chat / SOLO 模式 | Builder / Chat / SOLO 모드 | 원문유지(+모드) | 빌더 모드 |\n| Agent / 智能体 | 에이전트 | 외래어표기 | 상담원, 대리인, 지능체 |\n| 大语言模型 (LLM) | 대형 언어 모델 (LLM) | 번역(약어 유지) | 대규모 언어 모델, 거대 언어 모델 |\n| 视觉语言模型 (VLM) / 多模态 | 비전 언어 모델 (VLM) / 멀티모달 | 번역(약어 유지) | 시각 언어 모델, 비주얼 언어 모델, 다중모달 |\n| 模型 | 모델 | 외래어표기 | 모형 |\n| 提示词 | 프롬프트 | 외래어표기 | 프롬프트어, 지시어, 명령어 |\n| 上下文 / 上下文窗口 | 컨텍스트 / 컨텍스트 창 | 외래어표기 | 문맥, 맥락(UI 한정), 컨텍스트 윈도우 |\n| token | tokens / 토큰 | 외래어표기 | - |\n| API / API Key | API / API Key | 원문유지 | 에이피아이, API 키(혼용 금지) |\n| 接口 | API (통신 맥락) / 인터페이스 (화면 맥락) | 번역 | 접속, 연결부 |\n| Endpoint / 接口路径 | Endpoint (인터페이스 경로) | 원문유지 | 엔드포인트, 종단점 |\n| 密钥 | 비밀키 | 번역 | 시크릿키, 암호키 |\n| OpenAI 兼容接口 | OpenAI 호환 인터페이스 | 원문유지(OpenAI) | 오픈AI 호환 |\n| 多轮对话 | 다중 턴 대화 | 번역 | 멀티턴 대화, 여러 차례 대화 |\n| MCP | MCP | 원문유지 | - |\n| IDE / AI IDE | IDE / AI IDE | 원문유지 | 통합개발환경(단독 사용 금지) |\n| 集成开发环境 | 통합 개발 환경 | 번역 | 통합개발환경(붙여쓰기) |\n| 终端 / 命令行 | 터미널 / 명령줄 | 외래어표기/번역 | 콘솔(터미널 의미 시), 커맨드라인 |\n| 编辑器 | 편집기 | 번역 | 에디터 |\n| 调试 | 디버깅 | 외래어표기 | 디버그(명사형 혼용), 오류수정 |\n| 断点 | 중단점 | 번역 | 브레이크포인트, 정지점 |\n| 部署 | 배포 | 번역 | 디플로이, 전개 |\n| 仓库 / 仓库(Repo) | 저장소 (Repository / Repo) | 번역(+원문) | 리포지토리, 레포 |\n| 提交 (Commit) | 커밋 (Commit) | 외래어표기 | 제출, 커밋하기(명사 혼용) |\n| 分支 | 브랜치 | 외래어표기 | 가지, 분기 |\n| 框架 | 프레임워크 | 외래어표기 | 골격, 틀 |\n| 组件 | 컴포넌트 | 외래어표기 | 구성요소, 부품 |\n| 模块 | 모듈 | 외래어표기 | 단위 |\n| 变量 | 변수 | 번역 | 베리어블 |\n| 函数 | 함수 | 번역 | 펑션 |\n| 状态 (State) | 상태 (State) | 번역 | 스테이트 |\n| 标识符 | 식별자 | 번역 | 아이덴티파이어 |\n| 语法 | 문법 | 번역 | 신택스, 구문 |\n| 前端 / 后端 | 프론트엔드 / 백엔드 | 외래어표기 | 앞단/뒷단, 프런트엔드 |\n| 请求 / 响应 | 요청 / 응답 | 번역 | 리퀘스트/리스폰스 |\n| 服务 / 服务器 | 서비스 / 서버 | 외래어표기 | 섭, 봉사 |\n| 端口 | 포트 | 외래어표기 | 포트번호(불필요 시) |\n| 本地 / localhost | 로컬 / localhost | 외래어표기/원문 | 현지, 본지 |\n| 浏览器 | 브라우저 | 외래어표기 | 웹브라우저(불필요 시) |\n| 开发者工具 (DevTools) | 개발자 도구 (DevTools) | 번역(+원문) | 개발툴, 데브툴 |\n| 刷新 | 새로고침 | 번역 | 리프레시, 갱신 |\n| 插件 | 플러그인 | 외래어표기 | 확장프로그램(extension과 구분), 애드온 |\n| 依赖 | 의존성 | 번역 | 디펜던시 |\n| 开源 | 오픈소스 | 외래어표기 | 공개소스, 오픈 소스(띄어쓰기) |\n| 用户 | 사용자 | 번역 | 유저, 고객, 이용자 |\n| 需求 | 요구 / 요구사항 | 번역 | 니즈, 수요, 디맨드 |\n| 痛点 | 문제점 (痛点, Pain Point) | 번역 | 페인포인트, 아픈점, 고충점 |\n| 爽点 | 만족점 (Delight Point) | 번역 | 쾌감점, 딜라이트 |\n| 痒点 | 가려운 지점 (Itch Point) | 번역 | 가려움점, 잇치포인트 |\n| 留存 / 7日留存 | 유지율 / 7일 유지율 | 번역 | 잔존율, 리텐션 |\n| 护城河 | 해자 | 번역 | 모트, 진입장벽(별개 개념) |\n| 客单价 | 객단가 | 번역 | 고객단가, 1인당 단가 |\n| 复盘 | 되짚어 보기 / 복기 | 번역 | 리뷰, 회고(별개 뉘앙스) |\n| 迭代 | 반복 개선 / 반복 | 번역 | 이터레이션, 순회 |\n| 原型 | 프로토타입 | 외래어표기 | 시제품, 원형 |\n| 产品经理 | 제품 관리자 | 번역 | PM, 프로덕트 매니저, 기획자 |\n| 业务 | 비즈니스 | 외래어표기 | 업무(맥락 구분 필요), 사업 |\n| 公众号 | 공식 계정 | 번역 | 공중하오, 퍼블릭 어카운트 |\n| 网盘 | 클라우드 드라이브 | 번역 | 넷디스크, 웹하드 |\n| 看板 | 칸반 | 외래어표기 | 간판, 보드 |\n| 后台 | 백오피스 | 외래어표기 | 후방, 관리자페이지(혼용 주의) |\n| 上架 | 등록 / 게시 | 번역 | 상가, 진열, 업로드 |\n| 卖点 | 판매 포인트 | 번역 | 셀링포인트, 강점 |\n| 文案 | 문구 | 번역 | 카피, 글귀 |\n| 白底图 | 흰 배경 이미지 | 번역 | 백색배경도, 누끼 |\n| 业务方 | 비즈니스 담당자 | 번역 | 업무측, 비즈니스측 |\n| 运营 | 운영 (담당자) | 번역 | 오퍼레이션, 운용 |\n| 文生图 | text-to-image | 원문유지 | 텍스트-이미지, 텍스트→이미지, 문생도, 텍스트투이미지 |\n| 图生图 | image-to-image | 원문유지 | 이미지-이미지, 이미지→이미지, 도생도 |\n| 环节 | 단계 | 번역 | 환경(环节 의미일 때 오역) |\n| 素材 / 物料 | 소재 | 번역 | 머티리얼, 자재 |\n| 配图 | 삽화 | 번역 | 배치 이미지 |\n| 表情包 | 이모티콘 | 외래어표기 | 짤, 스티커, 밈 |\n| 母版 | 원본 / 참고 원본 | 번역 | 마스터, 모판 |\n\n## 고유명사 병기 (첫 등장 시 설명)\n\n> 한국 독자가 이름만으로는 모를 회사·서비스·플랫폼. **챕터당 첫 등장 시에만** `첫 등장 표기`를 그대로 쓰고, 이후엔 `이후 표기`만. (규칙서 7번)\n> 설명은 웹 검증 완료(2026-05). 중국 기업은 `中` 표기. 비중국은 출처국 명시.\n>\n> **상시 규칙**: 번역 중 이 표에 없는 새 고유명사(중국 회사·서비스·플랫폼 등 한국 독자에게 생소한 것)가 나오면 임의 설명을 만들지 않습니다. 신뢰할 수 있는 출처로 검증한 표기와 설명을 번역 PR에서 함께 제안합니다.\n\n| 원문 | 첫 등장 표기 | 이후 표기 |\n|------|------------|----------|\n| Trae | Trae(中 ByteDance의 AI 코딩 IDE) | Trae |\n| z.ai | z.ai(中 Zhipu AI의 코딩 모델·플랫폼) | z.ai |\n| DeepSeek | DeepSeek(中 AI 모델 개발사) | DeepSeek |\n| MiniMax | MiniMax(中 생성형 AI 회사) | MiniMax |\n| SiliconFlow / 硅基流动 | SiliconFlow(中 AI 모델 추론·호스팅 플랫폼) | SiliconFlow |\n| 通义千问 / Tongyi Qianwen | Tongyi Qianwen(中 Alibaba의 LLM, 현 Qwen) | Tongyi Qianwen |\n| 字节跳动 / ByteDance | ByteDance(中 IT 대기업, 틱톡·더우인 운영사) | ByteDance |\n| 阿里云 / Alibaba Cloud | Alibaba Cloud(中 알리바바의 클라우드) | Alibaba Cloud |\n| 腾讯云 / Tencent Cloud | Tencent Cloud(中 텐센트의 클라우드) | Tencent Cloud |\n| 智谱 / Zhipu AI | Zhipu AI(中 AI 모델 회사, GLM 개발) | Zhipu AI |\n| 火山引擎 / Volcengine | Volcengine(中 ByteDance의 클라우드 플랫폼) | Volcengine |\n| 抖音 / Douyin | Douyin(중국판 틱톡, 숏폼 앱) | Douyin |\n| 美菜网 / Meicai | Meicai(中 식자재 B2B 이커머스) | Meicai |\n| 小红书 | 샤오훙슈(中 라이프스타일 SNS·쇼핑 앱) | 샤오훙슈 |\n| MasterGo | MasterGo(中 웹 기반 UI 디자인 협업 도구) | MasterGo |\n| Lovart | Lovart(美 샌프란시스코의 AI 디자인 에이전트) | Lovart |\n| Nano Banana | Nano Banana(Google의 AI 이미지 생성 모델) | Nano Banana |\n| Dify | Dify(오픈소스 LLM 앱 개발 플랫폼) | Dify |\n| Zeabur | Zeabur(대만의 앱 배포 클라우드 플랫폼) | Zeabur |\n| 豆包 / Doubao | Doubao(中 ByteDance의 AI 챗봇) | Doubao |\n\n## 카테고리 메모\n- **痛点 3종 세트(痛点/爽点/痒点)**: stage-1 finding-great-idea에서 \"문제점 / 만족점 / 가려운 지점\"으로 일관 번역, 괄호로 원어(Pain/Delight/Itch Point) 병기. 일반 문맥의 \"痛点\"도 \"문제점\"으로 통일.\n- **Agent / 智能体**: **\"에이전트\"로 통일 확정**(2026-05). 표준=에이전트, 금지어=상담원·대리인·지능체. stage-2 index·사이드바의 기존 \"에이전트\" 표기 그대로 유지. (stage-1의 \"Agent(지능체)\" 표기는 향후 재방문 시 정합화 대상)\n- **接口의 이중성 (확정)**: 통신/API 맥락 → \"API\", 화면/UI 맥락 → \"인터페이스\"로 구분 적용.\n- **중국 고유명사 표기 혼재**: 대부분 영문 원문 유지(ByteDance 등), \"小红书\"만 음차(샤오훙슈). 인명도 로마자(梁文锋→Liang Wenfeng). 정책 확정은 candidates 참고.\n","tools/translation/fixtures/fail-frontmatter/localized.md":"---\ntitle: 설치 안내\n---\n\n<!-- Expected failure: the localized frontmatter is missing the description key. -->\n\n# 설치\n","tools/translation/ko-kr/style-guide.md":"# 한국어 자연스러움 가이드 (DO / DON'T)\n\n> 사람이 **직접 검수하며 고친 실제 수정**에서 뽑은 직역투→자연스러운 표현 규칙입니다.\n> glossary.md가 **단어** 룰이라면, 이 파일은 **문형·표현** 룰입니다. 한국어 번역 기여자는 번역 전에 읽고 적용합니다.\n\n## 정착 패턴 (필독 · 매 번역에 적용)\n\n| # | 유형 | ❌ DON'T (직역투) | ✅ DO (자연스러운 한국어) | 근거 |\n|---|------|------------------|--------------------------|------|\n| S1 | 접속 구조 `并不是 A 而是 B` | \"~이 아닙니다. 바로 ~것입니다\" (문장 끊김) | \"~이 아니라 ~것입니다\" (한 흐름) | lovart §4 |\n| S2 | 명사 종결 직역 | \"…라는 감각입니다.\" (앞 문장과 끊겨 붕 뜸) | \"…라는 감각 말입니다.\" (앞에 연결) | lovart §4 |\n| S3 | `当 … 时` 직역 | \"입력이 ~가 되면\" (피동·번역체) | \"~를 입력하면\" (능동) | lovart §3 |\n| S4 | 외래어 남발 | 文章 → \"아티클\" | \"글 / 한 편의 글\" | lovart §3 |\n| S5 | `缺乏 … 能力` 직역 | \"~능력이 부족한 결과로 이어집니다\" | \"~을 못 합니다 / 아우르지 못합니다\" | lovart §3 |\n\n## 일반 원칙 (위 패턴의 바탕)\n- **끊지 말 것**: 원문이 한 호흡(`并不是…而是`, `虽然…但是` 등)이면 한국어도 한 문장으로 잇는다. 마침표로 끊어 명사문이 붕 뜨게 두지 않는다.\n- **능동·서술 우선**: \"~가 되면/~되는 것이다\" 같은 번역체보다 \"~하면/~한다\"로.\n- **외래어는 정착된 것만**: 정착 외래어(프롬프트·컨텍스트 등, glossary 참조)는 쓰되, 굳이 음차할 필요 없는 일반어(文章=글)는 한국어로.\n- **직역 명사구 풀기**: \"~능력이 부족한 결과로 이어진다\" → \"~을 못 한다\"처럼 동사로 푼다.\n","tools/translation/README.md":"# Localization checks\n\nThis directory contains tool-agnostic guidance and deterministic checks for\nlocalized documentation. The checker does not translate content and does not\nuse an LLM.\n\n## Usage\n\n```bash\nnode tools/translation/check-localization.mjs \\\n  docs/zh-cn/path/to/index.md \\\n  docs/ko-kr/path/to/index.md\n```\n\nExit codes:\n\n- `0`: all checks passed\n- `1`: the localization failed one or more checks\n- `2`: invalid arguments or a missing input file\n\nThe checker compares:\n\n- frontmatter keys\n- heading levels, list items, and table rows\n- Markdown link and image counts, including local target existence\n- links that still point to the source locale\n- fenced code blocks\n- inline code\n- possible untranslated Chinese text\n\nIt intentionally does not judge meaning, fluency, or translation quality.\nThose require language review. Locale-specific contributor guidance lives in\nthe locale directory, for example `ko-kr/glossary.md` and\n`ko-kr/style-guide.md`.\n\nThe source-text residue check currently targets Chinese source text, which is\nthe source language used by this repository. Chinese text explicitly required\nin the target locale glossary's standard or first-appearance column is allowed.\n\n## Fixtures\n\nThe fixtures include one passing document pair and focused failures for each\ncheck: frontmatter, Markdown structure, links, images, fenced code blocks,\ninline code, source-locale links, and untranslated Chinese text. A separate\npassing fixture covers a source-language annotation required by the glossary.\nRun them with the built-in Node test runner:\n\n```bash\nnode --test tools/translation/check-localization.test.mjs\n```\n","tools/translation/fixtures/fail-code-block/source.md":"<!-- Fixture source: fenced code must be preserved exactly. -->\n\n# 运行\n\n```js\nconst port = 3000\n```\n","tools/translation/fixtures/fail-image/localized.md":"# Fail-image Skill\n\nPath: `tools/translation/fixtures/fail-image/localized.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/datawhalechina/easy-vibe/HEAD/tools/translation/fixtures/fail-image/localized.md)","tools/translation/fixtures/fail-image/source.md":"# Fail-image Skill\n\nPath: `tools/translation/fixtures/fail-image/source.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/datawhalechina/easy-vibe/HEAD/tools/translation/fixtures/fail-image/source.md)","tools/translation/fixtures/fail-inline-code/localized.md":"# Fail-inline-code Skill\n\nPath: `tools/translation/fixtures/fail-inline-code/localized.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/datawhalechina/easy-vibe/HEAD/tools/translation/fixtures/fail-inline-code/localized.md)","tools/translation/fixtures/fail-inline-code/source.md":"# Fail-inline-code Skill\n\nPath: `tools/translation/fixtures/fail-inline-code/source.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/datawhalechina/easy-vibe/HEAD/tools/translation/fixtures/fail-inline-code/source.md)","tools/translation/fixtures/fail-link/localized.md":"# Fail-link Skill\n\nPath: `tools/translation/fixtures/fail-link/localized.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/datawhalechina/easy-vibe/HEAD/tools/translation/fixtures/fail-link/localized.md)","tools/translation/fixtures/fail-link/source.md":"# Fail-link Skill\n\nPath: `tools/translation/fixtures/fail-link/source.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/datawhalechina/easy-vibe/HEAD/tools/translation/fixtures/fail-link/source.md)","tools/translation/fixtures/fail-source-text/localized.md":"# Fail-source-text Skill\n\nPath: `tools/translation/fixtures/fail-source-text/localized.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/datawhalechina/easy-vibe/HEAD/tools/translation/fixtures/fail-source-text/localized.md)","tools/translation/fixtures/fail-source-text/source.md":"# Fail-source-text Skill\n\nPath: `tools/translation/fixtures/fail-source-text/source.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/datawhalechina/easy-vibe/HEAD/tools/translation/fixtures/fail-source-text/source.md)","tools/translation/fixtures/fail-structure/localized.md":"# Fail-structure Skill\n\nPath: `tools/translation/fixtures/fail-structure/localized.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/datawhalechina/easy-vibe/HEAD/tools/translation/fixtures/fail-structure/localized.md)","tools/translation/fixtures/fail-structure/source.md":"# Fail-structure Skill\n\nPath: `tools/translation/fixtures/fail-structure/source.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/datawhalechina/easy-vibe/HEAD/tools/translation/fixtures/fail-structure/source.md)","tools/translation/fixtures/pass/localized.md":"# Pass Skill\n\nPath: `tools/translation/fixtures/pass/localized.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/datawhalechina/easy-vibe/HEAD/tools/translation/fixtures/pass/localized.md)","tools/translation/fixtures/pass/source.md":"# Pass Skill\n\nPath: `tools/translation/fixtures/pass/source.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/datawhalechina/easy-vibe/HEAD/tools/translation/fixtures/pass/source.md)","docs/ar-sa/stage-3/core-skills/skills/index.md":"# Skills Skill\n\nPath: `docs/ar-sa/stage-3/core-skills/skills/index.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/datawhalechina/easy-vibe/HEAD/docs/ar-sa/stage-3/core-skills/skills/index.md)","docs/de-de/stage-3/core-skills/skills/index.md":"# Skills Skill\n\nPath: `docs/de-de/stage-3/core-skills/skills/index.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/datawhalechina/easy-vibe/HEAD/docs/de-de/stage-3/core-skills/skills/index.md)","docs/en/stage-3/core-skills/skills/index.md":"# Skills Skill\n\nPath: `docs/en/stage-3/core-skills/skills/index.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/datawhalechina/easy-vibe/HEAD/docs/en/stage-3/core-skills/skills/index.md)","docs/es-es/stage-3/core-skills/skills/index.md":"# Skills Skill\n\nPath: `docs/es-es/stage-3/core-skills/skills/index.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/datawhalechina/easy-vibe/HEAD/docs/es-es/stage-3/core-skills/skills/index.md)","docs/fr-fr/stage-3/core-skills/skills/index.md":"# Skills Skill\n\nPath: `docs/fr-fr/stage-3/core-skills/skills/index.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/datawhalechina/easy-vibe/HEAD/docs/fr-fr/stage-3/core-skills/skills/index.md)","docs/ja-jp/stage-3/core-skills/skills/index.md":"# Skills Skill\n\nPath: `docs/ja-jp/stage-3/core-skills/skills/index.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/datawhalechina/easy-vibe/HEAD/docs/ja-jp/stage-3/core-skills/skills/index.md)","docs/ko-kr/stage-3/core-skills/skills/index.md":"# Skills Skill\n\nPath: `docs/ko-kr/stage-3/core-skills/skills/index.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/datawhalechina/easy-vibe/HEAD/docs/ko-kr/stage-3/core-skills/skills/index.md)","docs/vi-vn/stage-3/core-skills/skills/index.md":"# Skills Skill\n\nPath: `docs/vi-vn/stage-3/core-skills/skills/index.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/datawhalechina/easy-vibe/HEAD/docs/vi-vn/stage-3/core-skills/skills/index.md)","docs/zh-cn/stage-3/core-skills/skills/index.md":"# Skills Skill\n\nPath: `docs/zh-cn/stage-3/core-skills/skills/index.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/datawhalechina/easy-vibe/HEAD/docs/zh-cn/stage-3/core-skills/skills/index.md)","docs/zh-tw/stage-3/core-skills/skills/index.md":"# Skills Skill\n\nPath: `docs/zh-tw/stage-3/core-skills/skills/index.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/datawhalechina/easy-vibe/HEAD/docs/zh-tw/stage-3/core-skills/skills/index.md)","tools/translation/fixtures/fail-source-locale/docs/ko-kr/localized.md":"# Ko-kr Skill\n\nPath: `tools/translation/fixtures/fail-source-locale/docs/ko-kr/localized.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/datawhalechina/easy-vibe/HEAD/tools/translation/fixtures/fail-source-locale/docs/ko-kr/localized.md)","tools/translation/fixtures/fail-source-locale/docs/zh-cn/source.md":"# Zh-cn Skill\n\nPath: `tools/translation/fixtures/fail-source-locale/docs/zh-cn/source.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/datawhalechina/easy-vibe/HEAD/tools/translation/fixtures/fail-source-locale/docs/zh-cn/source.md)","tools/translation/fixtures/pass-glossary-annotation/docs/ko-kr/localized.md":"# Ko-kr Skill\n\nPath: `tools/translation/fixtures/pass-glossary-annotation/docs/ko-kr/localized.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/datawhalechina/easy-vibe/HEAD/tools/translation/fixtures/pass-glossary-annotation/docs/ko-kr/localized.md)","tools/translation/fixtures/pass-glossary-annotation/docs/zh-cn/source.md":"# Zh-cn Skill\n\nPath: `tools/translation/fixtures/pass-glossary-annotation/docs/zh-cn/source.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/datawhalechina/easy-vibe/HEAD/tools/translation/fixtures/pass-glossary-annotation/docs/zh-cn/source.md)"},"files":{"CLAUDE.md":"# CLAUDE.md\n\nThis file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.\n\n## Project Overview\n\n**Easy-Vibe** is an educational curriculum for learning AI Vibe Coding from zero to advanced levels. It's a documentation-based project using **VitePress** to serve educational content about AI-assisted software development.\n\nThe curriculum follows a progressive four-stage structure:\n\n- **Stage 0 (幼儿园)**: Introduction to AI programming through games\n- **Stage 1 (AI 产品经理)**: Building AI-powered web application prototypes\n- **Stage 2 (初中级开发工程师)**: Full-stack development with databases and deployment\n- **Stage 3 (高级开发工程师)**: Cross-platform development (WeChat mini-programs, Android apps, MCP)\n\n## Development Commands\n\n### Start Local Documentation Server\n\n```bash\nnpm install      # Install dependencies (first time only)\nnpm run dev      # Start VitePress dev server\n```\n\nThe documentation will be available at `http://localhost:5173` (VitePress default port)\n\n### Build/Run Commands\n\n- `npm run dev` - Start VitePress development server with hot reload\n- `npm run build` - Build static site for production (outputs to `docs/.vitepress/dist`)\n- `npm run preview` - Preview production build locally\n- `npm run format` - Format code using Prettier\n\n### Node Version Requirement\n\n- Node.js >= 18.0.0 required (specified in package.json `engines`)\n\n## Project Architecture\n\n### VitePress Base Path Configuration\n\nThe site automatically configures its base path based on the deployment environment:\n\n- **Vercel**: Uses `/` as base (detected via `VERCEL` environment variable)\n- **GitHub Pages / Local**: Uses `/easy-vibe/` as base\n\nThis logic is in `docs/.vitepress/config.mjs:3-5`. When linking assets or configuring paths, the `${base}` variable is used to ensure compatibility across environments.\n\n### Directory Structure\n\n```\neasy-vibe/\n├── docs/                        # Main documentation content (served by VitePress)\n│   ├── .vitepress/             # VitePress configuration and theme\n│   │   ├── config.mjs          # Site configuration (nav, sidebar, plugins)\n│   │   ├── theme/              # Custom theme extensions\n│   │   │   ├── Layout.vue      # Override default layout with typewriter effect\n│   │   │   ├── index.js        # Theme setup (Viewer.js, TypeIt, image optimization)\n│   │   │   └── style.css       # Custom CSS overrides\n│   │   ├── dist/               # Production build output (generated)\n│   │   └── cache/              # VitePress cache (generated)\n│   ├── index.md                # Homepage\n│   ├── public/                 # Static assets (logo.png, etc.)\n│   ├── assets/                 # Symlink to ../assets\n│   ├── stage-1/                # Stage 1 content (AI 产品经理)\n│   ├── stage-2/                # Stage 2 content (初中级开发工程师)\n│   ├── stage-3/                # Stage 3 content (高级开发工程师)\n│   ├── appendix/               # Reference materials (AI capability dictionary)\n│   ├── examples/               # Practical examples and tutorials (legacy)\n│   ├── extra/                  # Additional knowledge (Git, API, RAG, etc.)\n│   ├── guide/                  # Course guide\n│   └── project/                # Legacy project documentation\n├── assets/                     # Images and static assets\n├── package.json                # Project dependencies and scripts\n├── vercel.json                 # Vercel deployment configuration\n└── README.md                   # Project overview and contribution guide\n```\n\n### Content Organization\n\nEach stage follows a numbered chapter structure:\n\n```\nstage-{N}/\n└── {category or chapter-dir}/\n    └── index.md          # Main content file (or .md file directly)\n```\n\nExamples:\n\n- `stage-1/introduction-to-ai-ide/index.md`\n- `stage-2/backend/what-is-api/extra2/extra2-what-is-api.md`\n\n**Note**: Content files may use either `index.md` or direct `.md` files depending on the chapter structure.\n\n### Documentation System (VitePress)\n\nThe project uses **VitePress 2.0.0-alpha.15** with these key features:\n\n**Configuration** (`docs/.vitepress/config.mjs`):\n\n- **Single Sidebar**: Route-based sidebars configured per path prefix (`/stage-1/`, etc.)\n- **Navigation**: Top nav with links to each stage and appendix\n- **Search**: Local search via `minisearch` (no external API required)\n- **Dark Mode**: Built-in VitePress theme with toggle\n\n**Custom Theme** (`docs/.vitepress/theme/`):\n\n- **Image Viewer**: Viewer.js integration for zoom/rotate/flip on all images\n- **Typewriter Effect**: TypeIt.js for homepage hero tagline animation\n- **Image Optimization**: Automatic image height classes based on aspect ratio\n- **Custom Layout**: Extends default theme with `Layout.vue` override\n- **Reading Settings**: Element Plus popover panel for adjusting font size (12-18px) and line height (1.25-1.8) with localStorage persistence\n\n**Key Theme Behaviors**:\n\n- Images with aspect ratio > 1.2 get height-limited classes (tall/very-tall/ultra-tall)\n- Viewer.js initialized on `.vp-doc` container on each route change\n- Typewriter effect only activates on homepage when `frontmatter.hero.tagline` is an array\n- Font size/line height adjustments use CSS custom properties `--ev-doc-font-size` and `--ev-doc-line-height`\n- Reading settings panel appears in nav bar after the search/home buttons (gear icon)\n\n### Sidebar Management\n\nThe sidebar is defined in `docs/.vitepress/config.mjs`. When adding new chapters:\n\n1. Locate the appropriate route prefix section (`/stage-1/`, etc.)\n2. Add a new object with `text` (display name) and `link` (relative path)\n3. For nested items, use `items` array with `collapsed: true|false`\n4. **Links should not include `.md` extension** - VitePress handles this\n5. Links should not include `index` - use directory path with trailing slash\n\nExample pattern:\n\n```javascript\n{\n  text: 'Chapter Title',\n  link: '/stage-1/chapter-directory/'  // Note: trailing slash, no .md\n}\n```\n\n### Asset Management\n\n- Root-level static assets are in `/assets/` at project root\n- Public files (favicon, logo) go in `docs/public/`\n- Images are referenced with relative paths from markdown file location\n- VitePress serves `docs/assets` as symlink to `../assets`\n- Image optimization is automatic via theme (height-limited classes based on aspect ratio)\n\n### Deployment\n\n**Vercel** (vercel.json):\n\n- Build command: `npm run build`\n- Output directory: `docs/.vitepress/dist`\n- Framework: vitepress\n\n**Preview Production Build**:\n\n```bash\nnpm run build\nnpm run preview  # Preview built site locally\n```\n\n### Legacy Content Structure\n\nThe project maintains three legacy sections for backward compatibility:\n\n1. **Project 文档** (`project/`): Older chapter-based tutorials (migrated to Stage 2)\n2. **Extra 扩展知识** (`extra/`): Supplementary topics - Git, APIs, RAG, deployment (migrated to Stage 2/3)\n3. **Examples 实战案例** (`examples/`): Practical tutorials (migrated to Stage 0/3)\n\nWhen updating content, prefer integrating into the stage structure over adding to legacy sections.\n\n## Content Guidelines\n\n### Writing New Chapters\n\n1. Create directory: `docs/stage-{N}/{chapter-directory}/`\n2. Create `index.md` or direct `.md` file with chapter content\n3. Update `docs/.vitepress/config.mjs` sidebar with the new entry\n4. Follow Chinese language conventions (this is a Chinese curriculum)\n\n### Content Status Markers\n\nIn README.md, use these status indicators:\n\n- ✅ Completed\n- 🚧 In progress/Under construction\n\n### File Naming Conventions\n\n- Use kebab-case for directories: `1.1-introduction-to-ai-ide`, `frontend`, `backend`\n- Content can be either `index.md` in a directory or a direct `.md` file\n- Images use descriptive names; can be in chapter subdirectories or root `/assets/`\n\n### Code Formatting\n\nPrettier configuration (`.prettierrc`):\n\n- No semicolons (`semi: false`)\n- Single quotes (`singleQuote: true`)\n- No trailing commas (`trailingComma: \"none\"`)\n\nRun `npm run format` before committing code changes.\n\n## Interactive Vue Components\n\n### Component Registration\n\nAll interactive Vue components for the documentation are registered in `docs/.vitepress/theme/index.js`. To add a new component:\n\n1. Create the `.vue` file in the appropriate subdirectory of `docs/.vitepress/theme/components/`\n2. Import the component in `docs/.vitepress/theme/index.js`\n3. Register the component using `app.component('ComponentName', ComponentName)` in the `enhanceApp` function\n\n### Component Categories\n\nComponents are organized by topic:\n\n- `appendix/llm-intro/` - Large Language Model interactive demos\n- `appendix/vlm-intro/` - Vision Language Model interactive demos\n- `appendix/git-intro/` - Git workflow visualizations\n- `appendix/terminal-intro/` - Terminal/CLI interactive demos\n- `appendix/web-basics/` - HTML/CSS/JavaScript fundamentals\n- `appendix/auth-design/` - Authentication/authorization demos\n- `appendix/cache-design/` - Caching strategy visualizations\n- `appendix/database-intro/` - Database fundamentals\n- `appendix/queue-design/` - Message queue demos\n- `appendix/operations/` - DevOps/monitoring demos\n- `appendix/deployment/` - Deployment architecture demos\n- `appendix/frontend-performance/` - Frontend performance demos\n- `appendix/frontend-evolution/` - Frontend history/evolution demos\n- `appendix/backend-evolution/` - Backend architecture evolution\n- `appendix/backend-languages/` - Backend language comparisons\n\n### Using Components in Markdown\n\nComponents can be used directly in markdown files:\n\n```markdown\n## LLM Basics\n\n<LLMQuickStartDemo />\n\n### Tokenization\n\n<TokenizationDemo />\n```\n\n### Component Development Best Practices\n\n1. **Props**: Use props for configurable demo parameters\n2. **Styling**: Use scoped CSS or Tailwind-like utility classes\n3. **Responsiveness**: Ensure components work on mobile and desktop\n4. **Accessibility**: Include aria labels where appropriate\n5. **i18n**: Keep text content minimal or use props for text\n\n## Multi-language Support\n\n### Supported Locales\n\nThe project supports 13 languages:\n\n- `zh-cn` - Simplified Chinese (primary)\n- `zh-tw` - Traditional Chinese\n- `en-us` - English (US)\n- `ja-jp` - Japanese\n- `ko-kr` - Korean\n- `es-es` - Spanish\n- `fr-fr` - French\n- `de-de` - German\n- `ar-sa` - Arabic\n- `vi-vn` - Vietnamese\n\n### Adding Multi-language Content\n\n1. Create content in `docs/{locale}/` following the same structure as `docs/zh-cn/`\n2. Add locale configuration in `docs/.vitepress/config.mjs` under `locales`\n3. Copy the sidebar structure from `zh-cn` and translate the text values\n\n### Content Translation Priority\n\n1. **Primary**: `zh-cn` (Simplified Chinese) - always complete this first\n2. **Secondary**: `en-us` (English) - for international reach\n3. **Tertiary**: Other languages based on contributor availability\n\n## Permissions\n\nThe project has configured bash permissions in `.claude/settings.local.json`:\n\n- File operations: `which`, `find`, `mv`, `tree`, `cat`, `curl`, `lsof`, `mkdir`, `cp`, `ls`\n- Process management: `xargs ps`, `kill`\n- Development: `npm run dev`, `npm run build`, `npm run preview`, `npm run format`\n\n## Key Context for Development\n\n- **Educational Focus**: This is curriculum content, not application code\n- **Target Audience**: Beginners to advanced developers learning AI-assisted programming\n- **Language**: Primary content is in Chinese\n- **Build Pipeline**: VitePress requires build step for production (`npm run build`)\n- **Git Workflow**: Content changes should preserve formatting and structure\n- **Asset Paths**: Always use relative paths from markdown file location\n\nWhen making changes:\n\n- Preserve the VitePress configuration in `docs/.vitepress/config.mjs`\n- Maintain sidebar structure consistency in config.mjs\n- Test locally with `npm run dev` before committing\n- Check that image links work correctly\n- Ensure theme customizations in `.vitepress/theme/` are not broken\n- Run `npm run format` before committing code changes (uses Prettier: no semicolons, single quotes)\n","AGENTS.md":"# Repository Guidelines\n\n## Project Structure & Module Organization\n\n- `docs/`: VitePress site source (Markdown content, sidebar/nav, assets referenced by docs).\n- `docs/.vitepress/theme/`: custom theme, global component registration in `index.js`, shared styles in `style.css`, layout in `Layout.vue`.\n- `docs/.vitepress/theme/components/appendix/*/`: interactive Vue demos used inside appendix pages (e.g. `web-basics/`, `deployment/`).\n- `assets/`: repo-level images/media (if referenced, prefer linking/copying into `docs/public/` or a doc-local folder when appropriate).\n- `scripts/`, `tools/`, `update_readmes.cjs`: utility scripts for maintaining docs.\n\n## Build, Test, and Development Commands\n\nThis repo is a VitePress (Vue 3) documentation project. Requires Node.js **>= 18**.\n\n```bash\nnpm install\nnpm run dev      # start local docs server (hot reload)\nnpm run build    # production build (use as CI-style check)\nnpm run preview  # preview the built site locally\nnpm run format   # run Prettier on the whole repo\n```\n\n## Coding Style & Naming Conventions\n\n- Formatting: Prettier (`npm run format`). Keep diffs small and avoid reformatting unrelated files.\n- Vue components: Vue 3 SFCs with `<script setup>`, PascalCase filenames (e.g. `SemanticTagsDemo.vue`).\n- CSS: prefer VitePress theme variables (`var(--vp-c-*)`) and keep components responsive (`@media (max-width: 720px)` when needed).\n- Docs: use clear headings and short paragraphs; components are referenced in Markdown as `<ComponentName />`.\n- Images: prefer WebP for screenshots. Convert existing PNG screenshots losslessly without cropping or resizing, preserving decoded pixels, transparency, and color profiles. For example: `cwebp -lossless -exact -m 6 -metadata all input.png -o input.webp`. Verify decoded pixel equality and browser rendering; keep the original PNG when the browser renders it differently. Inspect representative text-heavy crops at full size before committing.\n- When replacing an image, update references in every locale and remove the obsolete source after checking that nothing still references it. Avoid keeping both PNG and WebP copies of the same screenshot.\n- Measure image savings from the current tracked files; existing clones retain old image blobs in Git history. Run the production build and check rendered image URLs as well as Markdown links.\n\n## Testing Guidelines\n\nThere is no dedicated test framework in this repo. Use `npm run build` as the primary correctness check, and manually verify interactive components in `npm run dev`.\n\n## Commit & Pull Request Guidelines\n\n- Commits follow a Conventional Commits style seen in history: `feat: ...`, `fix: ...`, `docs: ...` (optionally scoped like `feat(docs): ...`).\n- PRs should include: a short description, screenshots/GIFs for UI or component changes, and any relevant paths touched (e.g. `docs/zh-cn/appendix/...`, `docs/.vitepress/theme/...`).\n\n## Configuration & Deployment Notes\n\n- `vercel.json` is present; keep builds reproducible and avoid relying on local-only assets.\n","llms.txt":"# Easy-Vibe 教程 - AI 导航\n\n> 🦞 **如果你是 AI Agent（如 OpenClaw、Claude、Cursor、Trae 内置 AI、GPT-4、Kimi、通义千问、文心一言等）**\n> \n> **请先阅读本文件**，了解本教程结构后再回答用户问题。本文件是你的「导航地图」，告诉你去哪里找答案。\n\n---\n\n## 🎯 高层级架构（先读我！）\n\n本教程采用 **3+1 阶段** 的渐进式学习路径，从完全零基础到高级开发：\n\n```\n┌─────────────────────────────────────────────────────────────┐\n│  Stage 1: 新手入门与产品原型 (stage-0/ + stage-1/)           │\n│  ├── 目标：建立编程思维，掌握 AI IDE，快速构建产品原型        │\n│  ├── 产出：互动小游戏、完整的产品原型                        │\n│  └── 关键词：零基础、入门、学习路线、贪吃蛇、Cursor、Claude、 │\n│             Trae、MVP、产品思维、AI 能力集成                  │\n├─────────────────────────────────────────────────────────────┤\n│  Stage 2: 初中级开发 (stage-2/)                              │\n│  ├── 目标：全栈开发能力，数据库、部署、支付                   │\n│  ├── 产出：可上线的全栈 AI 应用                              │\n│  └── 关键词：Dify、Supabase、Git、部署、Stripe、UI 设计       │\n├─────────────────────────────────────────────────────────────┤\n│  Stage 3: 高级开发 (stage-3/)                                │\n│  ├── 目标：跨平台开发，AI 进阶，Claude Code 深度使用          │\n│  ├── 产出：生产级多平台应用                                  │\n│  └── 关键词：MCP、RAG、微信小程序、Android、iOS、Electron     │\n├─────────────────────────────────────────────────────────────┤\n│  附录：知识体系 (appendix/)                                  │\n│  ├── 目标：计算机基础到工程素养的完整知识库                   │\n│  ├── 内容：9 大领域，80+ 交互式专题                          │\n│  └── 关键词：计算机基础、前端、后端、AI 原理、架构、运维       │\n└─────────────────────────────────────────────────────────────┘\n```\n\n### 快速决策树\n\n当用户提问时，按以下优先级定位：\n\n1. **问\"怎么开始/零基础/入门\"** → Stage 1 (stage-0/ 和 stage-1/)\n2. **问\"数据库/部署/全栈\"** → Stage 2\n3. **问\"MCP/小程序/跨平台/Claude Code 进阶\"** → Stage 3\n4. **问\"计算机基础/原理\"** → 附录\n\n---\n\n## 📂 目录结构速查\n\n```\ndocs/zh-cn/\n├── stage-0/                    # Stage 1 - 新手入门部分\n│   ├── 0.1-learning-map/       # 学习路线图\n│   └── 0.2-ai-capabilities-through-games/  # 贪吃蛇游戏\n├── stage-1/                    # Stage 1 - 产品原型部分\n│   ├── 1.0-finding-great-idea/ # 找到好创意\n│   ├── 1.1-introduction-to-ai-ide/         # AI IDE 入门\n│   ├── 1.2-building-prototype/ # 原型开发\n│   ├── 1.3-integrating-ai-capabilities/    # 接入 AI 能力\n│   ├── 1.4-complete-project-practice/      # 完整项目实战\n│   └── appendix-*/             # 产品思维、常见错误、场景附录\n├── stage-2/                    # 初中级开发\n│   ├── ai-capabilities/        # AI 能力 (Dify、多模态)\n│   ├── backend/                # 后端 (数据库、Git、部署、支付)\n│   ├── frontend/               # 前端 (Figma、UI、组件库)\n│   └── assignments/            # 作业\n├── stage-3/                    # 高级开发\n│   ├── core-skills/            # 核心技能 (Claude、MCP、Agent)\n│   ├── ai-advanced/            # AI 进阶 (RAG、LangGraph)\n│   ├── cross-platform/         # 跨平台 (小程序、App、桌面)\n│   └── personal-brand/         # 个人品牌\n└── appendix/                   # 附录知识体系\n    ├── 1-computer-fundamentals/    # 计算机基础\n    ├── 2-development-tools/        # 开发工具\n    ├── 3-browser-and-frontend/     # 浏览器与前端\n    ├── 4-server-and-backend/       # 服务器与后端\n    ├── 5-data/                     # 数据\n    ├── 6-architecture-and-system-design/  # 架构设计\n    ├── 7-infrastructure-and-operations/   # 运维\n    ├── 8-artificial-intelligence/  # 人工智能\n    └── 9-engineering-excellence/   # 工程卓越\n```\n\n---\n\n## 🔍 详细文章索引\n\n### Stage 1: 新手入门与产品原型（stage-0/ + stage-1/）\n\n#### 1.0 学习路线图\n**文件**: `docs/zh-cn/stage-0/0.1-learning-map/index.md`\n\n**关键词**: 入门、零基础、怎么开始、学习路线、学习路径、成长路径、职业规划、阶段划分、新手引导、教程介绍、课程概览、适合谁学、前置要求、学习顺序、从哪开始、第一步\n\n**内容概要**: 完整学习路线图，介绍学习路径和目标\n\n---\n\n#### 1.0 AI 能力体验 - 贪吃蛇游戏\n**文件**: `docs/zh-cn/stage-0/0.2-ai-capabilities-through-games/index.md`\n\n**关键词**: 贪吃蛇、游戏、第一个项目、零基础项目、入门实战、AI 编程初体验、小游戏开发、网页游戏、Canvas、JavaScript 游戏、游戏逻辑、键盘控制、碰撞检测、得分系统、游戏循环、requestAnimationFrame\n\n**内容概要**: 用 AI 辅助开发第一个贪吃蛇游戏，理解 AI 编程的基本流程\n\n---\n\n#### 1.1 找到好创意\n**文件**: `docs/zh-cn/stage-1/1.0-finding-great-idea/index.md`\n\n**关键词**: 创意、想法、Idea、产品创意、需求挖掘、用户痛点、市场调研、竞品分析、创新思维、 brainstorming、头脑风暴、产品定位、目标用户、价值主张、MVP 定义、最小可行产品\n\n**内容概要**: 如何找到有价值的产品创意，定义 MVP 范围\n\n---\n\n#### 1.2 AI IDE 入门\n**文件**: `docs/zh-cn/stage-1/1.1-introduction-to-ai-ide/index.md`\n\n**关键词**: Cursor、Claude、Trae、AI IDE、安装、配置、环境搭建、本地开发、IDE 选择、代码编辑器、AI 辅助编程、智能补全、代码生成、自然语言编程、Vibe Coding、提示词技巧、AI 对话、代码解释、代码重构\n\n**内容概要**: 主流 AI IDE 工具的安装配置和使用方法\n\n---\n\n#### 1.3 原型开发\n**文件**: `docs/zh-cn/stage-1/1.2-building-prototype/index.md`\n\n**关键词**: 原型、Demo、快速搭建、MVP、最小可行产品、产品原型、快速验证、低保真、高保真、原型工具、交互设计、用户流程、页面跳转、组件复用、响应式布局、移动端适配\n\n**内容概要**: 快速搭建产品原型，验证产品概念\n\n---\n\n#### 1.4 接入 AI 能力\n**文件**: `docs/zh-cn/stage-1/1.3-integrating-ai-capabilities/index.md`\n\n**关键词**: 接入 AI、API、大模型、AI 能力、LLM、OpenAI、Claude API、GPT、文本生成、聊天机器人、API Key、接口调用、HTTP 请求、JSON、异步处理、错误处理、流式输出、SSE、Token 限制、成本控制\n\n**内容概要**: 如何在项目中接入大模型 API，实现 AI 功能\n\n---\n\n#### 1.5 完整项目实战\n**文件**: `docs/zh-cn/stage-1/1.4-complete-project-practice/index.md`\n\n**关键词**: 完整项目、实战、练手、综合案例、项目实战、端到端、从零开始、项目结构、代码组织、最佳实践、常见问题、调试技巧、测试验证、项目复盘\n\n**内容概要**: 一个完整的项目实战，串联前面所学知识\n\n---\n\n#### 附录 A: 产品思维\n**文件**: `docs/zh-cn/stage-1/appendix-a-product-thinking/index.md`\n\n**关键词**: 产品思维、需求分析、用户研究、产品设计、用户体验、UX、功能优先级、产品文档、PRD、用户故事、敏捷开发、迭代思维、数据驱动、A/B 测试、产品方法论\n\n**内容概要**: 产品经理必备的思维模式和方法论\n\n---\n\n#### 附录 B: 常见错误\n**文件**: `docs/zh-cn/stage-1/appendix-b-common-errors/index.md`\n\n**关键词**: 常见错误、错误排查、问题解决、Bug、调试、报错信息、环境错误、依赖问题、网络问题、权限问题、配置错误、语法错误、运行时错误、逻辑错误、调试技巧\n\n**内容概要**: 初学者常犯的错误及解决方法\n\n---\n\n#### 附录: AI 应用场景参考（B 端与 C 端）\n**文件**: `docs/zh-cn/stage-1/appendix-industry-scenarios/index.md`\n\n**关键词**: 行业场景、行业应用、垂直领域、B2B、B2C、行业解决方案、消费场景、C 端产品、社交应用、内容创作、娱乐应用、生活方式、情感陪伴、个人成长\n\n**内容概要**: B 端 19 个行业落地应用与 C 端 16 个消费场景创意灵感，通过 Tab 切换浏览\n\n---\n\n#### 附录文章 0-1: 贪吃蛇游戏教程\n**文件**: `docs/zh-cn/stage-1/appendix-articles/example0-1/vibe-coding-tools-snake-game-tutorial.md`\n\n**关键词**: 贪吃蛇教程、游戏开发、Canvas API、键盘事件、游戏循环、碰撞检测、得分系统、游戏状态、开始界面、结束界面、代码详解\n\n**内容概要**: 详细的贪吃蛇游戏开发教程\n\n---\n\n#### 附录文章 0-2: AI 编程与设计代理\n**文件**: `docs/zh-cn/stage-1/appendix-articles/example0-2/vibe-coding-tools-build-website-with-ai-coding-and-design-agents.md`\n\n**关键词**: AI 设计、设计代理、网站生成、AI 辅助设计、视觉设计、UI 生成、设计系统、设计稿转代码、Design-to-Code\n\n**内容概要**: 使用 AI 设计代理和编程代理协作完成网站\n\n---\n\n### Stage 2: 初中级开发（全栈技能）\n\n#### 2.1 Dify 知识库\n**文件**: `docs/zh-cn/stage-2/ai-capabilities/2.1-dify-knowledge-base/index.md`\n\n**关键词**: Dify、知识库、RAG、智能客服、文档问答、知识管理、向量数据库、Embedding、文本向量化、语义搜索、知识检索、问答系统、Bot、AI 应用平台、工作流、Prompt 工程、知识库搭建\n\n**内容概要**: 使用 Dify 搭建基于知识库的 AI 应用\n\n---\n\n#### 2.2 多模态 API\n**文件**: `docs/zh-cn/stage-2/ai-capabilities/2.2-multimodal-api/extra3/index.md`\n\n**关键词**: 多模态、图片识别、语音、图像理解、视觉模型、VLM、语音识别、语音合成、TTS、ASR、OCR、图像生成、文生图、图生图、GPT-4V、Claude Vision、文件上传、Base64、图像处理\n\n**内容概要**: 多模态 AI 能力的接入和使用\n\n---\n\n#### 2.2 Supabase 数据库\n**文件**: `docs/zh-cn/stage-2/backend/2.2-database-supabase/index.md`\n\n**关键词**: 数据库、Supabase、PostgreSQL、后端、数据存储、表设计、CRUD、增删改查、SQL、NoSQL、数据库连接、ORM、Prisma、数据模型、关系型数据库、主键外键、索引、查询优化、实时数据库、Row Level Security、RLS\n\n**内容概要**: 使用 Supabase 作为后端数据库，实现数据持久化\n\n---\n\n#### 2.3 AI 接口开发\n**文件**: `docs/zh-cn/stage-2/backend/2.3-ai-interface-code/index.md`\n\n**关键词**: AI 接口、后端开发、API 设计、RESTful、接口开发、路由、控制器、服务端、Node.js、Express、Koa、Fastify、中间件、请求处理、响应格式、状态码、错误处理、接口文档、Swagger、OpenAPI\n\n**内容概要**: 开发 AI 相关的后端接口\n\n---\n\n#### 2.4 Git 工作流\n**文件**: `docs/zh-cn/stage-2/backend/2.4-git-workflow/index.md`\n\n**关键词**: Git、版本控制、协作、代码管理、分支、Branch、Merge、Pull Request、PR、Commit、仓库、Repository、GitHub、GitLab、代码冲突、代码回滚、Cherry Pick、Rebase、Git Flow、团队协作\n\n**内容概要**: Git 版本控制和团队协作流程\n\n---\n\n#### 2.5 Web 应用部署与 Dify 官方云\n**文件**: `docs/zh-cn/stage-2/backend/zeabur-deployment/index.md`\n\n**关键词**: 部署、上线、Cloudflare Pages、Vercel、Render、Dify、CloudBase、Netlify、免费额度、云部署、CI/CD、持续集成、持续部署、域名、DNS、HTTPS、SSL、服务器、容器、Docker、环境变量、生产环境、Staging、Preview、自动化部署\n\n**内容概要**: 按场景介绍 Cloudflare Pages、Vercel、Render 与 Dify 官方云的操作步骤、免费限制，补充 CloudBase 和 Netlify 部署方式\n\n---\n\n#### 2.6 现代 CLI 工具\n**文件**: `docs/zh-cn/stage-2/backend/2.6-modern-cli/index.md`\n\n**关键词**: CLI、命令行、终端、Shell、Bash、Zsh、命令行工具、npm、yarn、pnpm、包管理、脚本、自动化、终端美化、Oh My Zsh、Homebrew、包管理器、环境配置\n\n**内容概要**: 现代命令行开发工具的使用\n\n---\n\n#### 2.7 Stripe 支付\n**文件**: `docs/zh-cn/stage-2/backend/2.7-stripe-payment/index.md`\n\n**关键词**: 支付、Stripe、收款、付款、支付网关、支付集成、订阅、Subscription、Checkout、支付表单、Webhook、支付回调、订单、发票、支付安全、PCI、货币、汇率\n\n**内容概要**: 集成 Stripe 支付功能\n\n---\n\n#### 2.0 Lovart 资源\n**文件**: `docs/zh-cn/stage-2/frontend/2.0-lovart-assets/index.md`\n\n**关键词**: Lovart、资源、素材、图片、图标、设计资源、UI 资源、插画、矢量图、免费素材、商用素材、Unsplash、Iconfont、设计系统\n\n**内容概要**: 设计资源和素材的获取与使用\n\n---\n\n#### 2.1 Figma MasterGo\n**文件**: `docs/zh-cn/stage-2/frontend/2.1-figma-mastergo/index.md`\n\n**关键词**: Figma、MasterGo、设计稿、转代码、Design-to-Code、设计工具、UI 设计、原型设计、设计规范、组件库、设计系统、切图、标注、设计交付、设计协作\n\n**内容概要**: 从设计稿到代码的转换\n\n---\n\n#### 2.2 UI 设计\n**文件**: `docs/zh-cn/stage-2/frontend/2.2-ui-design/index.md`\n\n**关键词**: UI 设计、界面、美观、视觉设计、排版、配色、字体、间距、布局、设计原则、设计模式、用户体验、交互设计、动效、微交互、设计趋势\n\n**内容概要**: UI 设计基础和最佳实践\n\n---\n\n#### 2.3 多端产品 UI\n**文件**: `docs/zh-cn/stage-2/frontend/2.3-multi-product-ui/index.md`\n\n**关键词**: 多端、响应式、移动端、PC 端、平板、适配、断点、Media Query、Flexbox、Grid、Viewport、移动端优先、桌面端、跨设备\n\n**内容概要**: 多端产品的 UI 适配\n\n---\n\n#### 2.4 LLM 技能美化\n**文件**: `docs/zh-cn/stage-2/frontend/2.4-llm-skills-beautiful/index.md`\n\n**关键词**: LLM 技能、美化、提示词优化、Prompt 美化、输出格式化、Markdown、代码高亮、流式输出、打字机效果、UI 美化、聊天界面\n\n**内容概要**: 优化 LLM 输出的展示效果\n\n---\n\n#### 2.5 哈利波特画像\n**文件**: `docs/zh-cn/stage-2/frontend/2.5-hogwarts-portraits/index.md`\n\n**关键词**: 哈利波特、画像、AI 绘画、图像生成、文生图、Stable Diffusion、Midjourney、DALL-E、图像处理、Canvas、特效、动画\n\n**内容概要**: AI 图像生成和前端展示\n\n---\n\n#### 2.6 设计转代码\n**文件**: `docs/zh-cn/stage-2/frontend/2.6-design-to-code/index.md`\n\n**关键词**: 设计转代码、Design-to-Code、自动代码生成、Figma 插件、代码导出、像素完美、设计还原、CSS、Tailwind、样式提取\n\n**内容概要**: 自动化设计稿转代码的工具和方法\n\n---\n\n#### 2.7 现代组件库\n**文件**: `docs/zh-cn/stage-2/frontend/2.7-modern-component-library/index.md`\n\n**关键词**: 组件库、Element Plus、Ant Design、Material UI、Chakra UI、组件封装、复用、Props、Event、Slot、表单组件、数据展示、导航组件、反馈组件\n\n**内容概要**: 使用现代组件库加速开发\n\n---\n\n#### 作业 2.1: 全栈应用\n**文件**: `docs/zh-cn/stage-2/assignments/2.1-fullstack-app/index.md`\n\n**关键词**: 作业、全栈应用、综合练习、项目作业、实战练习、考核、项目要求、评分标准\n\n**内容概要**: Stage 2 的综合作业要求\n\n---\n\n#### 作业 2.2: 现代前端 Trae\n**文件**: `docs/zh-cn/stage-2/assignments/2.2-modern-frontend-trae/index.md`\n\n**关键词**: 作业、Trae、现代前端、项目作业、实战练习、考核\n\n**内容概要**: 使用 Trae 完成现代前端开发作业\n\n---\n\n### Stage 3: 高级开发（跨平台 & AI 进阶）\n\n#### 3.0 基础技能\n**文件**: `docs/zh-cn/stage-3/core-skills/basics/index.md`\n\n**关键词**: 高级基础、核心技能、进阶知识、高级工程师、技术深度、编程范式、设计模式、代码质量、重构、性能优化、Claude、Claude Code、Anthropic\n\n**内容概要**: 高级开发必备的基础技能\n\n---\n\n#### 3.0 工作流\n**文件**: `docs/zh-cn/stage-3/core-skills/workflow/index.md`\n\n**关键词**: 工作流、开发流程、工程化、自动化、DevOps、开发规范、代码审查、Code Review、团队协作、项目管理、Claude、Claude Code\n\n**内容概要**: 高级开发的工程化工作流\n\n---\n\n#### 3.0 技能清单\n**文件**: `docs/zh-cn/stage-3/core-skills/skills/index.md`\n\n**关键词**: 技能清单、技能树、能力模型、技术栈、技术选型、技能评估、学习路径、进阶路线、Claude、Claude Code\n\n**内容概要**: 高级开发技能清单和学习路线\n\n---\n\n#### 3.0 超能力\n**文件**: `docs/zh-cn/stage-3/core-skills/superpowers/index.md`\n\n**关键词**: 超能力、高级技巧、黑科技、效率工具、开发神器、生产力、快捷键、插件、工具链、Claude、Claude Code\n\n**内容概要**: 提升开发效率的高级技巧和工具\n\n---\n\n#### 3.0 移动开发\n**文件**: `docs/zh-cn/stage-3/core-skills/mobile-development/index.md`\n\n**关键词**: 移动开发、移动端、React Native、Flutter、混合开发、H5、WebView、原生开发、App 开发、移动端优化、Claude、Claude Code\n\n**内容概要**: 移动应用开发技术概览\n\n---\n\n#### 3.0 规范编程\n**文件**: `docs/zh-cn/stage-3/core-skills/spec-coding/index.md`\n\n**关键词**: 规范编程、代码规范、ESLint、Prettier、TypeScript、类型安全、代码风格、命名规范、注释规范、文档规范、Claude、Claude Code\n\n**内容概要**: 规范化编程实践\n\n---\n\n#### 3.0 Claude Agent SDK\n**文件**: `docs/zh-cn/stage-3/core-skills/claude-agent-sdk/index.md`\n\n**关键词**: Claude、Claude Code、Claude Agent、SDK、Anthropic、Agent 开发、AI Agent、工具调用、Function Calling、Computer Use、核心技能、core-skills\n\n**内容概要**: Claude Agent SDK 的使用\n\n---\n\n#### 3.0 MCP 工具\n**文件**: `docs/zh-cn/stage-3/core-skills/mcp/index.md`\n\n**关键词**: MCP、Model Context Protocol、工具调用、Claude、Claude Code、外部工具、工具定义、Tool Definition、Function Calling、工具生态、MCP Server、MCP Client、上下文协议、AI 工具链、核心技能、core-skills\n\n**内容概要**: MCP 协议的完整使用指南\n\n---\n\n#### 3.0 Agent 团队\n**文件**: `docs/zh-cn/stage-3/core-skills/agent-teams/index.md`\n\n**关键词**: Agent 团队、多 Agent 协作、Multi-Agent、Agent 编排、角色分工、协作模式、工作流编排、LangChain、AutoGen、CrewAI、Claude、Claude Code、核心技能、core-skills\n\n**内容概要**: 多 Agent 协作系统的设计与实现\n\n---\n\n#### 3.0 长任务处理\n**文件**: `docs/zh-cn/stage-3/core-skills/long-running-tasks/index.md`\n\n**关键词**: 长任务、异步、后台任务、任务队列、Job Queue、Celery、Bull、Redis、消息队列、任务调度、定时任务、Cron、重试机制、任务状态、进度追踪、Claude、Claude Code、核心技能、core-skills\n\n**内容概要**: 长时间运行任务的处理方案\n\n---\n\n#### 3.A1 RAG 入门\n**文件**: `docs/zh-cn/stage-3/ai-advanced/3.a1-rag-introduction/index.md`\n\n**关键词**: RAG、检索增强生成、向量检索、Embedding、向量数据库、Pinecone、Weaviate、Milvus、Chroma、文档切分、Chunking、相似度搜索、语义检索、知识增强\n\n**内容概要**: RAG 技术的基础概念和实现\n\n---\n\n#### 3.A2 LangGraph 高级 RAG\n**文件**: `docs/zh-cn/stage-3/ai-advanced/3.a2-langgraph-advanced-rag/index.md`\n\n**关键词**: LangGraph、高级 RAG、知识图谱、GraphRAG、Agentic RAG、多跳推理、查询重写、重排序、ReRank、混合检索、Self-RAG、Corrective RAG、自适应 RAG\n\n**内容概要**: 使用 LangGraph 实现高级 RAG 系统\n\n---\n\n#### 3.3 微信小程序\n**文件**: `docs/zh-cn/stage-3/cross-platform/3.3-wechat-miniprogram/index.md`\n\n**关键词**: 微信小程序、小程序开发、微信开发、WXML、WXSS、小程序框架、云开发、小程序组件、小程序 API、微信支付、小程序发布、审核\n\n**内容概要**: 微信小程序开发完整指南\n\n---\n\n#### 3.4 小程序后端\n**文件**: `docs/zh-cn/stage-3/cross-platform/3.4-wechat-miniprogram-backend/index.md`\n\n**关键词**: 小程序后端、云开发、微信云开发、云函数、云数据库、云存储、Serverless、小程序登录、OpenID、UnionID、鉴权\n\n**内容概要**: 微信小程序后端开发\n\n---\n\n#### 3.5 Android App\n**文件**: `docs/zh-cn/stage-3/cross-platform/3.5-android-app/index.md`\n\n**关键词**: Android、安卓 App、Kotlin、Java、Android Studio、移动端开发、原生应用、APK、Google Play、Android SDK、Jetpack Compose\n\n**内容概要**: Android 应用开发\n\n---\n\n#### 3.6 iOS App\n**文件**: `docs/zh-cn/stage-3/cross-platform/3.6-ios-app/index.md`\n\n**关键词**: iOS、苹果 App、Swift、SwiftUI、Xcode、移动端开发、原生应用、App Store、iOS SDK、UIKit、TestFlight\n\n**内容概要**: iOS 应用开发\n\n---\n\n#### 3.7 个人网站博客\n**文件**: `docs/zh-cn/stage-3/personal-brand/3.7-personal-website-blog/index.md`\n\n**关键词**: 个人网站、博客、Portfolio、个人品牌、个人主页、简历网站、作品集、静态网站、SSG、Next.js、Nuxt、Hexo、Hugo、VitePress、域名、托管\n\n**内容概要**: 搭建个人网站和博客\n\n---\n\n#### 3.8 PWA 本地应用\n**文件**: `docs/zh-cn/stage-3/cross-platform/3.8-pwa-local-app/index.md`\n\n**关键词**: PWA、Progressive Web App、离线应用、Service Worker、Web App Manifest、本地存储、IndexedDB、Cache、添加到桌面、离线访问\n\n**内容概要**: 构建渐进式 Web 应用\n\n---\n\n#### 3.9 浏览器 AI 插件\n**文件**: `docs/zh-cn/stage-3/cross-platform/3.9-browser-ai-extension/index.md`\n\n**关键词**: 浏览器插件、Extension、Chrome Extension、Firefox Addon、插件开发、Content Script、Background Script、Popup、Manifest V3、浏览器扩展、AI 插件\n\n**内容概要**: 开发浏览器 AI 插件\n\n---\n\n#### 3.10 Electron 语音转文字\n**文件**: `docs/zh-cn/stage-3/cross-platform/3.10-electron-voice-to-text/index.md`\n\n**关键词**: Electron、桌面应用、跨平台桌面、语音转文字、ASR、语音识别、Whisper、桌面端、窗口应用、主进程、渲染进程、IPC\n\n**内容概要**: 使用 Electron 开发语音转文字桌面应用\n\n---\n\n#### 3.11 NFT 铸造\n**文件**: `docs/zh-cn/stage-3/cross-platform/3.11-nft-minting/index.md`\n\n**关键词**: NFT、铸造、区块链、Web3、智能合约、Solidity、以太坊、钱包、MetaMask、IPFS、数字藏品、Gas Fee、合约部署\n\n**内容概要**: NFT 铸造和 Web3 开发\n\n---\n\n#### 3.12 VS Code 插件\n**文件**: `docs/zh-cn/stage-3/cross-platform/3.12-vscode-extension/index.md`\n\n**关键词**: VS Code 插件、Extension、编辑器插件、VS Code API、Command、Tree View、Webview、Language Server、代码补全、语法高亮\n\n**内容概要**: 开发 VS Code 插件\n\n---\n\n#### 3.13 Qt 工业 HMI\n**文件**: `docs/zh-cn/stage-3/cross-platform/3.13-qt-industrial-hmi/index.md`\n\n**关键词**: Qt、工业 HMI、人机界面、工控、SCADA、C++、QML、工业自动化、实时监控、数据采集、PLC、Modbus、OPC UA\n\n**内容概要**: 使用 Qt 开发工业人机界面\n\n---\n\n## 附录：知识体系\n\n### 一、计算机基础\n\n#### 1. Vibe Coding 时代全栈开发\n**文件**: `docs/zh-cn/appendix/1-computer-fundamentals/vibe-coding-fullstack.md`\n\n**关键词**: Vibe Coding、全栈开发、AI 编程、前端、后端、编程语言、工程师成长、技术栈、职业发展\n\n---\n\n#### 2. 从晶体管到 CPU\n**文件**: `docs/zh-cn/appendix/1-computer-fundamentals/transistor-to-cpu.md`\n\n**关键词**: 晶体管、CPU、计算机组成、硬件、逻辑门、运算器、控制器、寄存器、指令集、汇编、机器码、冯诺依曼\n\n---\n\n#### 3. 操作系统\n**文件**: `docs/zh-cn/appendix/1-computer-fundamentals/operating-systems.md`\n\n**关键词**: 操作系统、OS、进程、线程、内存管理、文件系统、调度、并发、同步、死锁、虚拟内存、内核、用户态\n\n---\n\n#### 4. 数据编码与存储\n**文件**: `docs/zh-cn/appendix/1-computer-fundamentals/data-encoding-storage.md`\n\n**关键词**: 数据编码、二进制、字符编码、UTF-8、ASCII、Unicode、数据压缩、存储、文件格式、序列化、JSON、XML、Protobuf\n\n---\n\n#### 5. 计算机网络\n**文件**: `docs/zh-cn/appendix/1-computer-fundamentals/computer-networks.md`\n\n**关键词**: 计算机网络、网络协议、TCP/IP、HTTP、HTTPS、DNS、IP、MAC、路由、交换、网络分层、OSI、Socket、WebSocket\n\n---\n\n#### 6. 数据结构\n**文件**: `docs/zh-cn/appendix/1-computer-fundamentals/data-structures.md`\n\n**关键词**: 数据结构、数组、链表、栈、队列、树、二叉树、堆、图、哈希表、集合、字典、时间复杂度、空间复杂度\n\n---\n\n#### 7. 算法思维\n**文件**: `docs/zh-cn/appendix/1-computer-fundamentals/algorithm-thinking.md`\n\n**关键词**: 算法、排序、搜索、递归、动态规划、贪心、分治、回溯、算法复杂度、大 O 表示法、LeetCode\n\n---\n\n#### 8. 编程语言图谱\n**文件**: `docs/zh-cn/appendix/1-computer-fundamentals/programming-languages.md`\n\n**关键词**: 编程语言、语言分类、静态类型、动态类型、编译型、解释型、面向对象、函数式、脚本语言、系统语言\n\n---\n\n#### 9. 编译原理\n**文件**: `docs/zh-cn/appendix/1-computer-fundamentals/compilers.md`\n\n**关键词**: 编译原理、词法分析、语法分析、AST、抽象语法树、语义分析、代码生成、优化、解释器、编译器\n\n---\n\n#### 10. 类型系统\n**文件**: `docs/zh-cn/appendix/1-computer-fundamentals/type-systems.md`\n\n**关键词**: 类型系统、静态类型、动态类型、强类型、弱类型、类型推断、泛型、类型安全、TypeScript、类型检查\n\n---\n\n#### 11. 计算机组成原理\n**文件**: `docs/zh-cn/appendix/1-computer-fundamentals/computer-organization.md`\n\n**关键词**: 计算机组成、体系结构、存储器、缓存、Cache、总线、I/O、中断、DMA、流水线、并行计算\n\n---\n\n#### 12. 从开机到上网\n**文件**: `docs/zh-cn/appendix/1-computer-fundamentals/power-on-to-web.md`\n\n**关键词**: 开机启动、引导、BIOS、UEFI、Bootloader、操作系统启动、内核加载、用户登录、浏览器、网络连接\n\n---\n\n### 二、开发环境与工具\n\n#### 1. IDE 基础\n**文件**: `docs/zh-cn/appendix/2-development-tools/ide-basics.md`\n\n**关键词**: IDE、VS Code、Cursor、Trae、编辑器、开发环境、插件、扩展、快捷键、调试、代码补全\n\n---\n\n#### 2. 命令行与 Shell\n**文件**: `docs/zh-cn/appendix/2-development-tools/command-line-shell.md`\n\n**关键词**: 命令行、Shell、Bash、Zsh、Terminal、终端、命令、脚本、管道、重定向、环境变量、权限\n\n---\n\n#### 3. Git 版本控制\n**文件**: `docs/zh-cn/appendix/2-development-tools/git-version-control.md`\n\n**关键词**: Git、版本控制、分支、合并、提交、仓库、GitHub、GitLab、冲突解决、Rebase、Cherry Pick\n\n---\n\n#### 4. 环境变量与 PATH\n**文件**: `docs/zh-cn/appendix/2-development-tools/environment-path.md`\n\n**关键词**: 环境变量、PATH、系统变量、用户变量、配置、.env、dotenv、环境配置\n\n---\n\n#### 5. 端口与 localhost\n**文件**: `docs/zh-cn/appendix/2-development-tools/ports-localhost.md`\n\n**关键词**: 端口、Port、localhost、127.0.0.1、本地开发、端口冲突、端口占用、网络地址\n\n---\n\n#### 6. 包管理器\n**文件**: `docs/zh-cn/appendix/2-development-tools/package-managers.md`\n\n**关键词**: 包管理器、npm、yarn、pnpm、pip、conda、gem、依赖管理、package.json、requirements.txt\n\n---\n\n#### 7. SSH 与认证\n**文件**: `docs/zh-cn/appendix/2-development-tools/ssh-authentication.md`\n\n**关键词**: SSH、密钥、公钥、私钥、认证、免密登录、SSH Key、GitHub SSH、安全连接\n\n---\n\n#### 8. 调试艺术\n**文件**: `docs/zh-cn/appendix/2-development-tools/debugging-art.md`\n\n**关键词**: 调试、Debug、断点、单步执行、Console、Log、Debugger、Chrome DevTools、性能分析\n\n---\n\n#### 9. 正则表达式\n**文件**: `docs/zh-cn/appendix/2-development-tools/regex.md`\n\n**关键词**: 正则表达式、Regex、Pattern、匹配、替换、验证、RegExp、字符串处理\n\n---\n\n### 三、浏览器与前端\n\n#### 1. HTML CSS 布局\n**文件**: `docs/zh-cn/appendix/3-browser-and-frontend/html-css-layout.md`\n\n**关键词**: HTML、CSS、布局、Flexbox、Grid、响应式、盒模型、选择器、样式、动画、Transition、Animation\n\n---\n\n#### 2. JavaScript 深入\n**文件**: `docs/zh-cn/appendix/3-browser-and-frontend/javascript-deep-dive.md`\n\n**关键词**: JavaScript、JS、ES6、闭包、原型链、作用域、异步、Promise、Async/Await、Event Loop、this、原型、继承\n\n---\n\n#### 3. TypeScript\n**文件**: `docs/zh-cn/appendix/3-browser-and-frontend/typescript.md`\n\n**关键词**: TypeScript、TS、类型、接口、泛型、装饰器、类型推断、编译、配置、tsconfig\n\n---\n\n#### 4. 前端框架\n**文件**: `docs/zh-cn/appendix/3-browser-and-frontend/frontend-frameworks.md`\n\n**关键词**: 前端框架、React、Vue、Angular、Svelte、组件、状态管理、生命周期、Hooks、Composition API\n\n---\n\n#### 5. 前端工程化\n**文件**: `docs/zh-cn/appendix/3-browser-and-frontend/frontend-engineering.md`\n\n**关键词**: 前端工程化、构建工具、Webpack、Vite、Rollup、Parcel、Babel、ESLint、Prettier、代码规范\n\n---\n\n#### 6. 浏览器渲染\n**文件**: `docs/zh-cn/appendix/3-browser-and-frontend/browser-as-os-rendering.md`\n\n**关键词**: 浏览器、渲染引擎、DOM、CSSOM、渲染树、重绘、重排、合成层、GPU 加速、性能优化\n\n---\n\n#### 7. 路由与导航\n**文件**: `docs/zh-cn/appendix/3-browser-and-frontend/routing-navigation.md`\n\n**关键词**: 路由、Router、前端路由、Vue Router、React Router、History API、Hash、SPA、单页应用\n\n---\n\n#### 8. 状态管理\n**文件**: `docs/zh-cn/appendix/3-browser-and-frontend/state-management.md`\n\n**关键词**: 状态管理、Vuex、Pinia、Redux、MobX、Zustand、Jotai、全局状态、状态机、Context\n\n---\n\n#### 9. 前端项目架构\n**文件**: `docs/zh-cn/appendix/3-browser-and-frontend/frontend-project-architecture.md`\n\n**关键词**: 前端架构、项目结构、目录组织、模块化、组件化、分层架构、微前端、Monorepo\n\n---\n\n#### 10. 实时通信\n**文件**: `docs/zh-cn/appendix/3-browser-and-frontend/realtime-communication.md`\n\n**关键词**: 实时通信、WebSocket、Socket.io、SSE、Server-Sent Events、长轮询、WebRTC、实时数据\n\n---\n\n#### 11. 图形与动画\n**文件**: `docs/zh-cn/appendix/3-browser-and-frontend/graphics-animation.md`\n\n**关键词**: 图形、动画、Canvas、SVG、WebGL、Three.js、CSS 动画、帧动画、粒子效果\n\n---\n\n#### 12. Web 性能\n**文件**: `docs/zh-cn/appendix/3-browser-and-frontend/web-performance.md`\n\n**关键词**: Web 性能、性能优化、加载优化、运行时优化、Lighthouse、Core Web Vitals、懒加载、代码分割、缓存\n\n---\n\n#### 13. 无障碍与国际化\n**文件**: `docs/zh-cn/appendix/3-browser-and-frontend/a11n-i18n.md`\n\n**关键词**: 无障碍、A11y、ARIA、国际化、i18n、本地化、l10n、多语言、屏幕阅读器\n\n---\n\n#### 14. JavaScript 运行时\n**文件**: `docs/zh-cn/appendix/3-browser-and-frontend/javascript-runtime.md`\n\n**关键词**: JavaScript 运行时、Node.js、Deno、Bun、运行时环境、事件循环、模块系统\n\n---\n\n#### 15. 前端框架本质\n**文件**: `docs/zh-cn/appendix/3-browser-and-frontend/frontend-framework-nature.md`\n\n**关键词**: 前端框架本质、Virtual DOM、Diff 算法、响应式原理、依赖追踪、编译优化\n\n---\n\n### 四、服务器与后端\n\n#### 1. 后端语言\n**文件**: `docs/zh-cn/appendix/4-server-and-backend/backend-languages.md`\n\n**关键词**: 后端语言、Node.js、Python、Java、Go、Rust、PHP、Ruby、语言选择、技术栈\n\n---\n\n#### 2. 后端分层架构\n**文件**: `docs/zh-cn/appendix/4-server-and-backend/backend-layered-architecture.md`\n\n**关键词**: 后端架构、分层、MVC、三层架构、领域驱动、DDD、Clean Architecture、依赖注入\n\n---\n\n#### 3. 请求旅程\n**文件**: `docs/zh-cn/appendix/4-server-and-backend/request-journey.md`\n\n**关键词**: 请求旅程、HTTP 请求、生命周期、中间件、路由、控制器、服务层、数据层、响应\n\n---\n\n#### 4. API 入门\n**文件**: `docs/zh-cn/appendix/4-server-and-backend/api-intro.md`\n\n**关键词**: API、接口、REST、RESTful、HTTP 方法、状态码、请求头、响应头、Content-Type、认证\n\n---\n\n#### 5. API 设计\n**文件**: `docs/zh-cn/appendix/4-server-and-backend/api-design.md`\n\n**关键词**: API 设计、接口设计、版本控制、URL 设计、资源命名、错误处理、分页、过滤、排序\n\n---\n\n#### 6. Web 框架\n**文件**: `docs/zh-cn/appendix/4-server-and-backend/web-frameworks.md`\n\n**关键词**: Web 框架、Express、Koa、Fastify、NestJS、Django、Flask、Spring Boot、Gin、路由、中间件\n\n---\n\n#### 7. HTTP 协议\n**文件**: `docs/zh-cn/appendix/4-server-and-backend/http-protocol.md`\n\n**关键词**: HTTP、协议、请求、响应、Header、Body、Method、Status Code、Cookie、Session、Keep-Alive、HTTP/2、HTTP/3\n\n---\n\n#### 8. 认证与授权\n**文件**: `docs/zh-cn/appendix/4-server-and-backend/auth-authorization.md`\n\n**关键词**: 认证、授权、Auth、JWT、OAuth、SSO、Session、Cookie、Token、权限、RBAC、鉴权\n\n---\n\n#### 9. 序列化\n**文件**: `docs/zh-cn/appendix/4-server-and-backend/serialization.md`\n\n**关键词**: 序列化、反序列化、JSON、XML、Protobuf、MessagePack、Avro、Thrift、数据格式\n\n---\n\n#### 10. 并发与异步\n**文件**: `docs/zh-cn/appendix/4-server-and-backend/concurrency-async.md`\n\n**关键词**: 并发、异步、多线程、多进程、协程、Promise、Async/Await、事件驱动、回调、非阻塞 IO\n\n---\n\n#### 11. 缓存\n**文件**: `docs/zh-cn/appendix/4-server-and-backend/caching.md`\n\n**关键词**: 缓存、Cache、Redis、Memcached、本地缓存、分布式缓存、缓存策略、缓存穿透、缓存雪崩、缓存更新\n\n---\n\n#### 12. 消息队列\n**文件**: `docs/zh-cn/appendix/4-server-and-backend/message-queues.md`\n\n**关键词**: 消息队列、MQ、RabbitMQ、Kafka、RocketMQ、消息模型、发布订阅、点对点、消息可靠性\n\n---\n\n#### 13. 异步任务队列\n**文件**: `docs/zh-cn/appendix/4-server-and-backend/async-task-queues.md`\n\n**关键词**: 任务队列、Celery、Bull、RQ、Sidekiq、后台任务、定时任务、任务调度、重试机制\n\n---\n\n#### 14. 限流与背压\n**文件**: `docs/zh-cn/appendix/4-server-and-backend/rate-limiting-backpressure.md`\n\n**关键词**: 限流、Rate Limiting、背压、Backpressure、流量控制、熔断、降级、负载保护、令牌桶、漏桶\n\n---\n\n#### 15. 搜索引擎\n**文件**: `docs/zh-cn/appendix/4-server-and-backend/search-engines.md`\n\n**关键词**: 搜索引擎、Elasticsearch、Solr、全文搜索、倒排索引、分词、相关性排序、搜索优化\n\n---\n\n#### 16. 文件存储\n**文件**: `docs/zh-cn/appendix/4-server-and-backend/file-storage.md`\n\n**关键词**: 文件存储、OSS、S3、MinIO、云存储、对象存储、CDN、文件上传、断点续传、分片上传\n\n---\n\n#### 17. 后端项目架构\n**文件**: `docs/zh-cn/appendix/4-server-and-backend/backend-project-architecture.md`\n\n**关键词**: 后端项目架构、项目结构、目录组织、模块化、服务划分、代码组织、最佳实践\n\n---\n\n#### 18. 客户端语言\n**文件**: `docs/zh-cn/appendix/4-server-and-backend/client-languages.md`\n\n**关键词**: 客户端语言、移动端、桌面端、小程序、跨平台、React Native、Flutter、Electron、Tauri\n\n---\n\n#### 19. 领域特定语言\n**文件**: `docs/zh-cn/appendix/4-server-and-backend/domain-specific-languages.md`\n\n**关键词**: DSL、领域特定语言、SQL、正则、GraphQL、配置语言、模板语言、内部 DSL、外部 DSL\n\n---\n\n#### 20. 跨平台\n**文件**: `docs/zh-cn/appendix/4-server-and-backend/cross-platform.md`\n\n**关键词**: 跨平台、多端、统一开发、Write Once Run Anywhere、跨平台框架、适配策略\n\n---\n\n### 五、数据\n\n#### 1. 数据库基础\n**文件**: `docs/zh-cn/appendix/5-data/database-fundamentals.md`\n\n**关键词**: 数据库基础、关系型数据库、SQL、MySQL、PostgreSQL、表、字段、索引、事务、ACID、SQL 语句\n\n---\n\n#### 2. 数据模型\n**文件**: `docs/zh-cn/appendix/5-data/data-models.md`\n\n**关键词**: 数据模型、ER 模型、关系模型、文档模型、图模型、键值模型、数据建模、范式、反范式\n\n---\n\n#### 3. 数据分析\n**文件**: `docs/zh-cn/appendix/5-data/data-analysis.md`\n\n**关键词**: 数据分析、Python、Pandas、NumPy、数据清洗、数据可视化、统计分析、BI、数据挖掘\n\n---\n\n#### 4. 数据可视化\n**文件**: `docs/zh-cn/appendix/5-data/data-visualization.md`\n\n**关键词**: 数据可视化、图表、ECharts、D3.js、AntV、Tableau、可视化设计、交互可视化\n\n---\n\n#### 5. A/B 测试\n**文件**: `docs/zh-cn/appendix/5-data/ab-testing.md`\n\n**关键词**: A/B 测试、实验、对照组、实验组、显著性、假设检验、转化率、实验设计\n\n---\n\n#### 6. 数据埋点\n**文件**: `docs/zh-cn/appendix/5-data/data-tracking.md`\n\n**关键词**: 数据埋点、事件追踪、用户行为、数据分析、漏斗分析、留存分析、归因分析\n\n---\n\n#### 7. 数据治理\n**文件**: `docs/zh-cn/appendix/5-data/data-governance.md`\n\n**关键词**: 数据治理、数据质量、数据安全、数据标准、元数据、数据血缘、合规、隐私\n\n---\n\n### 六、架构与系统设计\n\n#### 1. 系统设计方法论\n**文件**: `docs/zh-cn/appendix/6-architecture-and-system-design/system-design-methodology.md`\n\n**关键词**: 系统设计、架构设计、设计原则、SOLID、设计模式、系统思维、权衡、扩展性、可用性\n\n---\n\n#### 2. 分布式系统\n**文件**: `docs/zh-cn/appendix/6-architecture-and-system-design/distributed-systems.md`\n\n**关键词**: 分布式系统、CAP 定理、一致性、可用性、分区容错、分布式事务、共识算法、Raft、Paxos\n\n---\n\n#### 3. 高可用\n**文件**: `docs/zh-cn/appendix/6-architecture-and-system-design/high-availability.md`\n\n**关键词**: 高可用、HA、容灾、故障转移、主从、集群、多活、SLA、SLO、SLI、可靠性工程\n\n---\n\n#### 4. 单体到微服务\n**文件**: `docs/zh-cn/appendix/6-architecture-and-system-design/monolith-to-microservices.md`\n\n**关键词**: 微服务、单体、服务拆分、服务治理、服务发现、配置中心、链路追踪、分布式追踪\n\n---\n\n### 七、基础设施与运维\n\n#### 1. Linux 基础\n**文件**: `docs/zh-cn/appendix/7-infrastructure-and-operations/linux-basics.md`\n\n**关键词**: Linux、操作系统、命令行、Shell、文件系统、权限、进程管理、网络配置、系统管理\n\n---\n\n#### 2. Docker 容器\n**文件**: `docs/zh-cn/appendix/7-infrastructure-and-operations/docker-containers.md`\n\n**关键词**: Docker、容器、镜像、Container、Dockerfile、Compose、容器化、微服务部署\n\n---\n\n#### 3. Kubernetes\n**文件**: `docs/zh-cn/appendix/7-infrastructure-and-operations/kubernetes.md`\n\n**关键词**: Kubernetes、K8s、容器编排、Pod、Service、Deployment、Ingress、Helm、集群管理\n\n---\n\n#### 4. CI/CD\n**文件**: `docs/zh-cn/appendix/7-infrastructure-and-operations/ci-cd.md`\n\n**关键词**: CI/CD、持续集成、持续部署、Jenkins、GitLab CI、GitHub Actions、自动化构建、自动化测试\n\n---\n\n#### 5. 云平台\n**文件**: `docs/zh-cn/appendix/7-infrastructure-and-operations/cloud-platforms.md`\n\n**关键词**: 云平台、AWS、Azure、GCP、阿里云、腾讯云、华为云、云服务、IaaS、PaaS、SaaS\n\n---\n\n#### 6. 云 IAM\n**文件**: `docs/zh-cn/appendix/7-infrastructure-and-operations/cloud-iam.md`\n\n**关键词**: IAM、身份管理、访问控制、权限管理、角色、策略、RBAC、云安全\n\n---\n\n#### 7. 云存储与 CDN\n**文件**: `docs/zh-cn/appendix/7-infrastructure-and-operations/cloud-storage-cdn.md`\n\n**关键词**: 云存储、CDN、对象存储、内容分发、边缘计算、加速、缓存策略\n\n---\n\n#### 8. DNS 与 HTTPS\n**文件**: `docs/zh-cn/appendix/7-infrastructure-and-operations/dns-https.md`\n\n**关键词**: DNS、域名解析、HTTPS、SSL、TLS、证书、CA、加密、安全传输\n\n---\n\n#### 9. 负载均衡与网关\n**文件**: `docs/zh-cn/appendix/7-infrastructure-and-operations/load-balancing-gateway.md`\n\n**关键词**: 负载均衡、Gateway、Nginx、API Gateway、反向代理、流量分发、健康检查\n\n---\n\n#### 10. 网关代理\n**文件**: `docs/zh-cn/appendix/7-infrastructure-and-operations/gateway-proxy.md`\n\n**关键词**: 网关、代理、Nginx、Traefik、Envoy、服务网格、Istio、流量管理\n\n---\n\n#### 11. 基础设施即代码\n**文件**: `docs/zh-cn/appendix/7-infrastructure-and-operations/infrastructure-as-code.md`\n\n**关键词**: IaC、基础设施即代码、Terraform、Ansible、Pulumi、CloudFormation、自动化运维\n\n---\n\n#### 12. 监控与日志\n**文件**: `docs/zh-cn/appendix/7-infrastructure-and-operations/monitoring-logging.md`\n\n**关键词**: 监控、日志、Prometheus、Grafana、ELK、Loki、告警、可观测性、Observability\n\n---\n\n#### 13. 事故响应\n**文件**: `docs/zh-cn/appendix/7-infrastructure-and-operations/incident-response.md`\n\n**关键词**: 事故响应、故障处理、应急响应、SRE、事后复盘、故障演练、混沌工程\n\n---\n\n### 八、人工智能\n\n#### 1. AI 历史\n**文件**: `docs/zh-cn/appendix/8-artificial-intelligence/ai-history.md`\n\n**关键词**: AI 历史、人工智能发展、机器学习历史、深度学习、神经网络历史、AI 里程碑\n\n---\n\n#### 2. 神经网络\n**文件**: `docs/zh-cn/appendix/8-artificial-intelligence/neural-networks.md`\n\n**关键词**: 神经网络、深度学习、CNN、RNN、LSTM、GRU、激活函数、反向传播、梯度下降\n\n---\n\n#### 3. Transformer 与注意力机制\n**文件**: `docs/zh-cn/appendix/8-artificial-intelligence/transformer-attention.md`\n\n**关键词**: Transformer、注意力机制、Attention、Self-Attention、Multi-Head Attention、BERT、GPT、位置编码\n\n---\n\n#### 4. LLM 原理\n**文件**: `docs/zh-cn/appendix/8-artificial-intelligence/llm-principles.md`\n\n**关键词**: LLM、大语言模型、预训练、微调、Fine-tuning、RLHF、对齐、涌现能力、Scaling Law\n\n---\n\n#### 5. Prompt 工程\n**文件**: `docs/zh-cn/appendix/8-artificial-intelligence/prompt-engineering.md`\n\n**关键词**: Prompt 工程、提示词、Prompt Design、Few-shot、Chain-of-Thought、ReAct、提示词优化\n\n---\n\n#### 6. RAG\n**文件**: `docs/zh-cn/appendix/8-artificial-intelligence/rag.md`\n\n**关键词**: RAG、检索增强生成、向量检索、Embedding、知识库、文档问答、语义搜索\n\n---\n\n#### 7. Embedding 与向量检索\n**文件**: `docs/zh-cn/appendix/8-artificial-intelligence/embedding-vector-retrieval.md`\n\n**关键词**: Embedding、向量、向量检索、向量数据库、相似度、余弦相似度、向量空间\n\n---\n\n#### 8. AI Agent\n**文件**: `docs/zh-cn/appendix/8-artificial-intelligence/ai-agents.md`\n\n**关键词**: AI Agent、智能体、Agent 架构、ReAct、Plan-and-Execute、Tool Use、Multi-Agent\n\n---\n\n#### 9. 多模态模型\n**文件**: `docs/zh-cn/appendix/8-artificial-intelligence/multimodal-models.md`\n\n**关键词**: 多模态、视觉语言模型、VLM、CLIP、GPT-4V、图像理解、跨模态、图文生成\n\n---\n\n#### 10. 图像生成\n**文件**: `docs/zh-cn/appendix/8-artificial-intelligence/image-generation.md`\n\n**关键词**: 图像生成、文生图、Stable Diffusion、Midjourney、DALL-E、GAN、Diffusion、ControlNet\n\n---\n\n#### 11. 语音合成与识别\n**文件**: `docs/zh-cn/appendix/8-artificial-intelligence/speech-synthesis-recognition.md`\n\n**关键词**: 语音合成、语音识别、TTS、ASR、Whisper、语音克隆、声纹识别\n\n---\n\n#### 12. 模型微调与部署\n**文件**: `docs/zh-cn/appendix/8-artificial-intelligence/model-finetuning-deployment.md`\n\n**关键词**: 模型微调、Fine-tuning、LoRA、QLoRA、模型部署、模型量化、推理优化、ONNX、TensorRT\n\n---\n\n#### 13. AI 协议\n**文件**: `docs/zh-cn/appendix/8-artificial-intelligence/ai-protocols.md`\n\n**关键词**: AI 协议、MCP、Function Calling、Tool Use、API 标准、OpenAI API、Anthropic API\n\n---\n\n#### 14. AI 原生应用设计\n**文件**: `docs/zh-cn/appendix/8-artificial-intelligence/ai-native-app-design.md`\n\n**关键词**: AI 原生应用、AI-First、产品设计、用户体验、人机交互、Copilot、Agent 界面\n\n---\n\n#### 15. 上下文工程\n**文件**: `docs/zh-cn/appendix/8-artificial-intelligence/context-engineering.md`\n\n**关键词**: 上下文工程、Context Engineering、上下文管理、长上下文、RAG、记忆、会话管理\n\n---\n\n#### 16. AI 能力词典\n**文件**: `docs/zh-cn/appendix/8-artificial-intelligence/ai-capability-dictionary.md`\n\n**关键词**: AI 能力、AI 功能、能力清单、应用场景、技术选型、AI 解决方案\n\n---\n\n### 九、工程卓越\n\n#### 1. 代码质量与重构\n**文件**: `docs/zh-cn/appendix/9-engineering-excellence/code-quality-refactoring.md`\n\n**关键词**: 代码质量、重构、Clean Code、代码审查、技术债务、代码异味、重构模式\n\n---\n\n#### 2. 测试策略\n**文件**: `docs/zh-cn/appendix/9-engineering-excellence/testing-strategies.md`\n\n**关键词**: 测试、单元测试、集成测试、E2E 测试、TDD、BDD、测试覆盖率、Mock、自动化测试\n\n---\n\n#### 3. 设计模式\n**文件**: `docs/zh-cn/appendix/9-engineering-excellence/design-patterns.md`\n\n**关键词**: 设计模式、单例、工厂、观察者、策略、装饰器、适配器、MVC、MVVM、架构模式\n\n---\n\n#### 4. 技术选型\n**文件**: `docs/zh-cn/appendix/9-engineering-excellence/technology-selection.md`\n\n**关键词**: 技术选型、技术决策、技术栈、框架选择、评估标准、技术雷达、技术债\n\n---\n\n#### 5. 开源协作\n**文件**: `docs/zh-cn/appendix/9-engineering-excellence/open-source-collaboration.md`\n\n**关键词**: 开源、开源协作、GitHub、贡献指南、Code Review、社区、开源协议、LICENSE\n\n---\n\n#### 6. 安全思维\n**文件**: `docs/zh-cn/appendix/9-engineering-excellence/security-thinking.md`\n\n**关键词**: 安全、安全思维、OWASP、漏洞、注入、XSS、CSRF、安全编码、加密、认证\n\n---\n\n#### 7. 技术写作\n**文件**: `docs/zh-cn/appendix/9-engineering-excellence/technical-writing.md`\n\n**关键词**: 技术写作、文档、README、API 文档、技术博客、知识分享、文档规范\n\n---\n\n## ✅ 回答规则（必读）\n\n1. **先读高层架构**：先阅读上面的\"高层级架构\"和\"快速决策树\"，确定用户问题属于哪个阶段\n2. **再查详细索引**：根据阶段定位到详细文章索引，找到具体文件\n3. **引用来源**：回答时注明信息来自哪个文件，例如：\"根据 `stage-1/1.1-introduction-to-ai-ide` 的内容...\"\n4. **代码优先**：优先使用教程中提供的代码示例\n5. **阶段匹配**：根据用户水平推荐合适的内容，不要给新手推荐 Stage 3 的高级内容\n6. **关键词匹配**：根据用户问题中的关键词，快速定位到对应文件\n7. **不确定时**：明确告诉用户\"让我先查看相关教程内容\"，然后读取文件\n8. **附录参考**：当用户问基础概念时，优先引用附录中的知识文章\n\n---\n\n## 📚 教程概览\n\n**Easy-Vibe** 是一个从零开始的 AI 编程教程，核心理念是 **Vibe Coding**（用自然语言编程）。\n\n### 学习路径\n\n```\nStage 0 (新手入门)\n    ↓\nStage 1 (AI 产品经理) - 用 AI IDE 做原型\n    ↓\nStage 2 (初中级开发) - 全栈开发 + 部署\n    ↓\nStage 3 (高级开发) - 跨平台 + AI 进阶\n    ↓\n附录 (知识体系) - 计算机基础到工程素养\n```\n\n### 目标读者\n- **零基础用户**：从 Stage 0 开始，先体验 AI 编程的乐趣\n- **产品经理/设计师**：重点学习 Stage 1，快速做 Demo\n- **初级开发者**：Stage 2 帮你补齐全栈技能\n- **高级开发者**：Stage 3 的 MCP、RAG、跨平台开发\n- **全栈工程师**：附录提供完整的计算机知识体系\n\n### 技术栈\n- **AI IDE**: Cursor, Claude Code, Trae\n- **前端**: Vue 3, React, Element Plus\n- **后端**: Node.js, Supabase, Dify\n- **部署**: Cloudflare Pages, Vercel, Render, Dify Cloud, CloudBase, Netlify\n- **跨平台**: 微信小程序, Android, iOS, Electron\n- **AI 技术**: LLM, RAG, MCP, Agent, 多模态\n\n---\n\n## 🔗 相关文件\n\n- **本文件**: `llms.txt` - AI 导航入口（必读）\n- **Claude Code 专用**: `CLAUDE.md` - 针对 Claude Code 的详细指南\n- **项目说明**: `README.md` - 人类用户入口\n- **配置文件**: `docs/.vitepress/config.mjs` - 网站导航配置\n\n---\n\n## 📝 版本信息\n\n- **版本**: 2.1.0\n- **更新日期**: 2026-03-02\n- **文章总数**: 100+ 篇\n- **语言支持**: 中文(zh-cn), 英文(en), 日文(ja-jp), 韩文(ko-kr), 繁体中文(zh-tw), 西班牙文(es-es), 法文(fr-fr), 德文(de-de), 阿拉伯文(ar-sa), 越南文(vi-vn)\n- **默认语言**: 中文 (`docs/zh-cn/`)\n\n---\n\n> 💡 **提示**: 如果你是多语言 AI，请根据用户使用的语言选择对应的 `docs/{语言}/` 目录下的文件。\n","tools/translation/fixtures/fail-code-block/localized.md":"<!-- Expected failure: the port value inside the fenced code block was changed. -->\n\n# 실행\n\n```js\nconst port = 8080\n```\n","tools/translation/fixtures/fail-frontmatter/source.md":"---\ntitle: 安装指南\ndescription: 安装示例\n---\n\n<!-- Fixture source: the localized file must preserve both frontmatter keys. -->\n\n# 安装\n","tools/translation/ko-kr/glossary.md":"# 번역 용어집 (Translation Glossary)\n\n> stage-1 zh↔ko 정렬로 시드. 새 용어는 번역 PR에서 논의한 뒤 승인 시 편입.\n\n## 원칙\n- 아래 표준 용어를 무조건 사용한다. 같은 개념을 다른 단어로 번역하지 않는다.\n- \"원문유지\"는 번역하지 않는다. \"외래어표기\"는 정해진 한글 표기를 쓴다.\n- 금지어가 떠오르면 표준 용어로 치환한다.\n- **업계 표준어는 웬만하면 영문 유지**: 한국어로 옮겼을 때 어색하거나 의미가 애매해지는 업계 표준 용어(text-to-image, image-to-image 등)는 **영문 그대로** 둔다. 억지 음차·직역(문생도, 텍스트→이미지 등)은 금지.\n\n## 용어 표\n\n| 中文 | 한국어 표준 | 영어 유지 여부 | 금지어 |\n|------|------------|--------------|--------|\n| VS Code / Visual Studio Code | VS Code / Visual Studio Code | 원문유지 | 비주얼 스튜디오 코드 |\n| Trae | Trae | 원문유지 | 트레이 |\n| Cursor | Cursor | 원문유지 | 커서 |\n| z.ai | z.ai | 원문유지 | - |\n| Figma / Figma Make | Figma / Figma Make | 원문유지 | 피그마 |\n| GitHub | GitHub | 원문유지 | 깃허브 |\n| DeepSeek | DeepSeek | 원문유지 | 딥시크 |\n| MiniMax | MiniMax | 원문유지 | 미니맥스 |\n| SiliconFlow / 硅基流动 | SiliconFlow | 원문유지 | 실리콘플로우, 실리콘 베이스드 플로우 |\n| 通义千问 | Tongyi Qianwen | 원문유지 | 퉁이첸원, 통의천문 |\n| 字节跳动 | ByteDance | 원문유지 | 바이트댄스 |\n| 阿里巴巴 / 阿里云 | Alibaba / Alibaba Cloud | 원문유지 | 알리바바, 알리바바 클라우드 |\n| 腾讯云 | Tencent Cloud | 원문유지 | 텐센트 클라우드 |\n| 智谱 / 智谱 AI | Zhipu / Zhipu AI | 원문유지 | 즈푸, 지푸 AI |\n| 火山引擎 | Volcengine | 원문유지 | 볼케이노 엔진, 화산엔진 |\n| 抖音 | Douyin | 원문유지 | 더우인, 틱톡 |\n| 小红书 | 샤오훙슈 | 외래어표기 | 샤오홍슈, 레드 |\n| 美菜网 | Meicai | 원문유지 | 메이차이 |\n| Builder / Chat / SOLO 模式 | Builder / Chat / SOLO 모드 | 원문유지(+모드) | 빌더 모드 |\n| Agent / 智能体 | 에이전트 | 외래어표기 | 상담원, 대리인, 지능체 |\n| 大语言模型 (LLM) | 대형 언어 모델 (LLM) | 번역(약어 유지) | 대규모 언어 모델, 거대 언어 모델 |\n| 视觉语言模型 (VLM) / 多模态 | 비전 언어 모델 (VLM) / 멀티모달 | 번역(약어 유지) | 시각 언어 모델, 비주얼 언어 모델, 다중모달 |\n| 模型 | 모델 | 외래어표기 | 모형 |\n| 提示词 | 프롬프트 | 외래어표기 | 프롬프트어, 지시어, 명령어 |\n| 上下文 / 上下文窗口 | 컨텍스트 / 컨텍스트 창 | 외래어표기 | 문맥, 맥락(UI 한정), 컨텍스트 윈도우 |\n| token | tokens / 토큰 | 외래어표기 | - |\n| API / API Key | API / API Key | 원문유지 | 에이피아이, API 키(혼용 금지) |\n| 接口 | API (통신 맥락) / 인터페이스 (화면 맥락) | 번역 | 접속, 연결부 |\n| Endpoint / 接口路径 | Endpoint (인터페이스 경로) | 원문유지 | 엔드포인트, 종단점 |\n| 密钥 | 비밀키 | 번역 | 시크릿키, 암호키 |\n| OpenAI 兼容接口 | OpenAI 호환 인터페이스 | 원문유지(OpenAI) | 오픈AI 호환 |\n| 多轮对话 | 다중 턴 대화 | 번역 | 멀티턴 대화, 여러 차례 대화 |\n| MCP | MCP | 원문유지 | - |\n| IDE / AI IDE | IDE / AI IDE | 원문유지 | 통합개발환경(단독 사용 금지) |\n| 集成开发环境 | 통합 개발 환경 | 번역 | 통합개발환경(붙여쓰기) |\n| 终端 / 命令行 | 터미널 / 명령줄 | 외래어표기/번역 | 콘솔(터미널 의미 시), 커맨드라인 |\n| 编辑器 | 편집기 | 번역 | 에디터 |\n| 调试 | 디버깅 | 외래어표기 | 디버그(명사형 혼용), 오류수정 |\n| 断点 | 중단점 | 번역 | 브레이크포인트, 정지점 |\n| 部署 | 배포 | 번역 | 디플로이, 전개 |\n| 仓库 / 仓库(Repo) | 저장소 (Repository / Repo) | 번역(+원문) | 리포지토리, 레포 |\n| 提交 (Commit) | 커밋 (Commit) | 외래어표기 | 제출, 커밋하기(명사 혼용) |\n| 分支 | 브랜치 | 외래어표기 | 가지, 분기 |\n| 框架 | 프레임워크 | 외래어표기 | 골격, 틀 |\n| 组件 | 컴포넌트 | 외래어표기 | 구성요소, 부품 |\n| 模块 | 모듈 | 외래어표기 | 단위 |\n| 变量 | 변수 | 번역 | 베리어블 |\n| 函数 | 함수 | 번역 | 펑션 |\n| 状态 (State) | 상태 (State) | 번역 | 스테이트 |\n| 标识符 | 식별자 | 번역 | 아이덴티파이어 |\n| 语法 | 문법 | 번역 | 신택스, 구문 |\n| 前端 / 后端 | 프론트엔드 / 백엔드 | 외래어표기 | 앞단/뒷단, 프런트엔드 |\n| 请求 / 响应 | 요청 / 응답 | 번역 | 리퀘스트/리스폰스 |\n| 服务 / 服务器 | 서비스 / 서버 | 외래어표기 | 섭, 봉사 |\n| 端口 | 포트 | 외래어표기 | 포트번호(불필요 시) |\n| 本地 / localhost | 로컬 / localhost | 외래어표기/원문 | 현지, 본지 |\n| 浏览器 | 브라우저 | 외래어표기 | 웹브라우저(불필요 시) |\n| 开发者工具 (DevTools) | 개발자 도구 (DevTools) | 번역(+원문) | 개발툴, 데브툴 |\n| 刷新 | 새로고침 | 번역 | 리프레시, 갱신 |\n| 插件 | 플러그인 | 외래어표기 | 확장프로그램(extension과 구분), 애드온 |\n| 依赖 | 의존성 | 번역 | 디펜던시 |\n| 开源 | 오픈소스 | 외래어표기 | 공개소스, 오픈 소스(띄어쓰기) |\n| 用户 | 사용자 | 번역 | 유저, 고객, 이용자 |\n| 需求 | 요구 / 요구사항 | 번역 | 니즈, 수요, 디맨드 |\n| 痛点 | 문제점 (痛点, Pain Point) | 번역 | 페인포인트, 아픈점, 고충점 |\n| 爽点 | 만족점 (Delight Point) | 번역 | 쾌감점, 딜라이트 |\n| 痒点 | 가려운 지점 (Itch Point) | 번역 | 가려움점, 잇치포인트 |\n| 留存 / 7日留存 | 유지율 / 7일 유지율 | 번역 | 잔존율, 리텐션 |\n| 护城河 | 해자 | 번역 | 모트, 진입장벽(별개 개념) |\n| 客单价 | 객단가 | 번역 | 고객단가, 1인당 단가 |\n| 复盘 | 되짚어 보기 / 복기 | 번역 | 리뷰, 회고(별개 뉘앙스) |\n| 迭代 | 반복 개선 / 반복 | 번역 | 이터레이션, 순회 |\n| 原型 | 프로토타입 | 외래어표기 | 시제품, 원형 |\n| 产品经理 | 제품 관리자 | 번역 | PM, 프로덕트 매니저, 기획자 |\n| 业务 | 비즈니스 | 외래어표기 | 업무(맥락 구분 필요), 사업 |\n| 公众号 | 공식 계정 | 번역 | 공중하오, 퍼블릭 어카운트 |\n| 网盘 | 클라우드 드라이브 | 번역 | 넷디스크, 웹하드 |\n| 看板 | 칸반 | 외래어표기 | 간판, 보드 |\n| 后台 | 백오피스 | 외래어표기 | 후방, 관리자페이지(혼용 주의) |\n| 上架 | 등록 / 게시 | 번역 | 상가, 진열, 업로드 |\n| 卖点 | 판매 포인트 | 번역 | 셀링포인트, 강점 |\n| 文案 | 문구 | 번역 | 카피, 글귀 |\n| 白底图 | 흰 배경 이미지 | 번역 | 백색배경도, 누끼 |\n| 业务方 | 비즈니스 담당자 | 번역 | 업무측, 비즈니스측 |\n| 运营 | 운영 (담당자) | 번역 | 오퍼레이션, 운용 |\n| 文生图 | text-to-image | 원문유지 | 텍스트-이미지, 텍스트→이미지, 문생도, 텍스트투이미지 |\n| 图生图 | image-to-image | 원문유지 | 이미지-이미지, 이미지→이미지, 도생도 |\n| 环节 | 단계 | 번역 | 환경(环节 의미일 때 오역) |\n| 素材 / 物料 | 소재 | 번역 | 머티리얼, 자재 |\n| 配图 | 삽화 | 번역 | 배치 이미지 |\n| 表情包 | 이모티콘 | 외래어표기 | 짤, 스티커, 밈 |\n| 母版 | 원본 / 참고 원본 | 번역 | 마스터, 모판 |\n\n## 고유명사 병기 (첫 등장 시 설명)\n\n> 한국 독자가 이름만으로는 모를 회사·서비스·플랫폼. **챕터당 첫 등장 시에만** `첫 등장 표기`를 그대로 쓰고, 이후엔 `이후 표기`만. (규칙서 7번)\n> 설명은 웹 검증 완료(2026-05). 중국 기업은 `中` 표기. 비중국은 출처국 명시.\n>\n> **상시 규칙**: 번역 중 이 표에 없는 새 고유명사(중국 회사·서비스·플랫폼 등 한국 독자에게 생소한 것)가 나오면 임의 설명을 만들지 않습니다. 신뢰할 수 있는 출처로 검증한 표기와 설명을 번역 PR에서 함께 제안합니다.\n\n| 원문 | 첫 등장 표기 | 이후 표기 |\n|------|------------|----------|\n| Trae | Trae(中 ByteDance의 AI 코딩 IDE) | Trae |\n| z.ai | z.ai(中 Zhipu AI의 코딩 모델·플랫폼) | z.ai |\n| DeepSeek | DeepSeek(中 AI 모델 개발사) | DeepSeek |\n| MiniMax | MiniMax(中 생성형 AI 회사) | MiniMax |\n| SiliconFlow / 硅基流动 | SiliconFlow(中 AI 모델 추론·호스팅 플랫폼) | SiliconFlow |\n| 通义千问 / Tongyi Qianwen | Tongyi Qianwen(中 Alibaba의 LLM, 현 Qwen) | Tongyi Qianwen |\n| 字节跳动 / ByteDance | ByteDance(中 IT 대기업, 틱톡·더우인 운영사) | ByteDance |\n| 阿里云 / Alibaba Cloud | Alibaba Cloud(中 알리바바의 클라우드) | Alibaba Cloud |\n| 腾讯云 / Tencent Cloud | Tencent Cloud(中 텐센트의 클라우드) | Tencent Cloud |\n| 智谱 / Zhipu AI | Zhipu AI(中 AI 모델 회사, GLM 개발) | Zhipu AI |\n| 火山引擎 / Volcengine | Volcengine(中 ByteDance의 클라우드 플랫폼) | Volcengine |\n| 抖音 / Douyin | Douyin(중국판 틱톡, 숏폼 앱) | Douyin |\n| 美菜网 / Meicai | Meicai(中 식자재 B2B 이커머스) | Meicai |\n| 小红书 | 샤오훙슈(中 라이프스타일 SNS·쇼핑 앱) | 샤오훙슈 |\n| MasterGo | MasterGo(中 웹 기반 UI 디자인 협업 도구) | MasterGo |\n| Lovart | Lovart(美 샌프란시스코의 AI 디자인 에이전트) | Lovart |\n| Nano Banana | Nano Banana(Google의 AI 이미지 생성 모델) | Nano Banana |\n| Dify | Dify(오픈소스 LLM 앱 개발 플랫폼) | Dify |\n| Zeabur | Zeabur(대만의 앱 배포 클라우드 플랫폼) | Zeabur |\n| 豆包 / Doubao | Doubao(中 ByteDance의 AI 챗봇) | Doubao |\n\n## 카테고리 메모\n- **痛点 3종 세트(痛点/爽点/痒点)**: stage-1 finding-great-idea에서 \"문제점 / 만족점 / 가려운 지점\"으로 일관 번역, 괄호로 원어(Pain/Delight/Itch Point) 병기. 일반 문맥의 \"痛点\"도 \"문제점\"으로 통일.\n- **Agent / 智能体**: **\"에이전트\"로 통일 확정**(2026-05). 표준=에이전트, 금지어=상담원·대리인·지능체. stage-2 index·사이드바의 기존 \"에이전트\" 표기 그대로 유지. (stage-1의 \"Agent(지능체)\" 표기는 향후 재방문 시 정합화 대상)\n- **接口의 이중성 (확정)**: 통신/API 맥락 → \"API\", 화면/UI 맥락 → \"인터페이스\"로 구분 적용.\n- **중국 고유명사 표기 혼재**: 대부분 영문 원문 유지(ByteDance 등), \"小红书\"만 음차(샤오훙슈). 인명도 로마자(梁文锋→Liang Wenfeng). 정책 확정은 candidates 참고.\n","tools/translation/fixtures/fail-frontmatter/localized.md":"---\ntitle: 설치 안내\n---\n\n<!-- Expected failure: the localized frontmatter is missing the description key. -->\n\n# 설치\n","tools/translation/ko-kr/style-guide.md":"# 한국어 자연스러움 가이드 (DO / DON'T)\n\n> 사람이 **직접 검수하며 고친 실제 수정**에서 뽑은 직역투→자연스러운 표현 규칙입니다.\n> glossary.md가 **단어** 룰이라면, 이 파일은 **문형·표현** 룰입니다. 한국어 번역 기여자는 번역 전에 읽고 적용합니다.\n\n## 정착 패턴 (필독 · 매 번역에 적용)\n\n| # | 유형 | ❌ DON'T (직역투) | ✅ DO (자연스러운 한국어) | 근거 |\n|---|------|------------------|--------------------------|------|\n| S1 | 접속 구조 `并不是 A 而是 B` | \"~이 아닙니다. 바로 ~것입니다\" (문장 끊김) | \"~이 아니라 ~것입니다\" (한 흐름) | lovart §4 |\n| S2 | 명사 종결 직역 | \"…라는 감각입니다.\" (앞 문장과 끊겨 붕 뜸) | \"…라는 감각 말입니다.\" (앞에 연결) | lovart §4 |\n| S3 | `当 … 时` 직역 | \"입력이 ~가 되면\" (피동·번역체) | \"~를 입력하면\" (능동) | lovart §3 |\n| S4 | 외래어 남발 | 文章 → \"아티클\" | \"글 / 한 편의 글\" | lovart §3 |\n| S5 | `缺乏 … 能力` 직역 | \"~능력이 부족한 결과로 이어집니다\" | \"~을 못 합니다 / 아우르지 못합니다\" | lovart §3 |\n\n## 일반 원칙 (위 패턴의 바탕)\n- **끊지 말 것**: 원문이 한 호흡(`并不是…而是`, `虽然…但是` 등)이면 한국어도 한 문장으로 잇는다. 마침표로 끊어 명사문이 붕 뜨게 두지 않는다.\n- **능동·서술 우선**: \"~가 되면/~되는 것이다\" 같은 번역체보다 \"~하면/~한다\"로.\n- **외래어는 정착된 것만**: 정착 외래어(프롬프트·컨텍스트 등, glossary 참조)는 쓰되, 굳이 음차할 필요 없는 일반어(文章=글)는 한국어로.\n- **직역 명사구 풀기**: \"~능력이 부족한 결과로 이어진다\" → \"~을 못 한다\"처럼 동사로 푼다.\n","tools/translation/README.md":"# Localization checks\n\nThis directory contains tool-agnostic guidance and deterministic checks for\nlocalized documentation. The checker does not translate content and does not\nuse an LLM.\n\n## Usage\n\n```bash\nnode tools/translation/check-localization.mjs \\\n  docs/zh-cn/path/to/index.md \\\n  docs/ko-kr/path/to/index.md\n```\n\nExit codes:\n\n- `0`: all checks passed\n- `1`: the localization failed one or more checks\n- `2`: invalid arguments or a missing input file\n\nThe checker compares:\n\n- frontmatter keys\n- heading levels, list items, and table rows\n- Markdown link and image counts, including local target existence\n- links that still point to the source locale\n- fenced code blocks\n- inline code\n- possible untranslated Chinese text\n\nIt intentionally does not judge meaning, fluency, or translation quality.\nThose require language review. Locale-specific contributor guidance lives in\nthe locale directory, for example `ko-kr/glossary.md` and\n`ko-kr/style-guide.md`.\n\nThe source-text residue check currently targets Chinese source text, which is\nthe source language used by this repository. Chinese text explicitly required\nin the target locale glossary's standard or first-appearance column is allowed.\n\n## Fixtures\n\nThe fixtures include one passing document pair and focused failures for each\ncheck: frontmatter, Markdown structure, links, images, fenced code blocks,\ninline code, source-locale links, and untranslated Chinese text. A separate\npassing fixture covers a source-language annotation required by the glossary.\nRun them with the built-in Node test runner:\n\n```bash\nnode --test tools/translation/check-localization.test.mjs\n```\n","tools/translation/fixtures/fail-code-block/source.md":"<!-- Fixture source: fenced code must be preserved exactly. -->\n\n# 运行\n\n```js\nconst port = 3000\n```\n","tools/translation/fixtures/fail-image/localized.md":"# Fail-image Skill\n\nPath: `tools/translation/fixtures/fail-image/localized.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/datawhalechina/easy-vibe/HEAD/tools/translation/fixtures/fail-image/localized.md)","tools/translation/fixtures/fail-image/source.md":"# Fail-image Skill\n\nPath: `tools/translation/fixtures/fail-image/source.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/datawhalechina/easy-vibe/HEAD/tools/translation/fixtures/fail-image/source.md)","tools/translation/fixtures/fail-inline-code/localized.md":"# Fail-inline-code Skill\n\nPath: `tools/translation/fixtures/fail-inline-code/localized.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/datawhalechina/easy-vibe/HEAD/tools/translation/fixtures/fail-inline-code/localized.md)","tools/translation/fixtures/fail-inline-code/source.md":"# Fail-inline-code Skill\n\nPath: `tools/translation/fixtures/fail-inline-code/source.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/datawhalechina/easy-vibe/HEAD/tools/translation/fixtures/fail-inline-code/source.md)","tools/translation/fixtures/fail-link/localized.md":"# Fail-link Skill\n\nPath: `tools/translation/fixtures/fail-link/localized.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/datawhalechina/easy-vibe/HEAD/tools/translation/fixtures/fail-link/localized.md)","tools/translation/fixtures/fail-link/source.md":"# Fail-link Skill\n\nPath: `tools/translation/fixtures/fail-link/source.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/datawhalechina/easy-vibe/HEAD/tools/translation/fixtures/fail-link/source.md)","tools/translation/fixtures/fail-source-text/localized.md":"# Fail-source-text Skill\n\nPath: `tools/translation/fixtures/fail-source-text/localized.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/datawhalechina/easy-vibe/HEAD/tools/translation/fixtures/fail-source-text/localized.md)","tools/translation/fixtures/fail-source-text/source.md":"# Fail-source-text Skill\n\nPath: `tools/translation/fixtures/fail-source-text/source.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/datawhalechina/easy-vibe/HEAD/tools/translation/fixtures/fail-source-text/source.md)","tools/translation/fixtures/fail-structure/localized.md":"# Fail-structure Skill\n\nPath: `tools/translation/fixtures/fail-structure/localized.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/datawhalechina/easy-vibe/HEAD/tools/translation/fixtures/fail-structure/localized.md)","tools/translation/fixtures/fail-structure/source.md":"# Fail-structure Skill\n\nPath: `tools/translation/fixtures/fail-structure/source.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/datawhalechina/easy-vibe/HEAD/tools/translation/fixtures/fail-structure/source.md)","tools/translation/fixtures/pass/localized.md":"# Pass Skill\n\nPath: `tools/translation/fixtures/pass/localized.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/datawhalechina/easy-vibe/HEAD/tools/translation/fixtures/pass/localized.md)","tools/translation/fixtures/pass/source.md":"# Pass Skill\n\nPath: `tools/translation/fixtures/pass/source.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/datawhalechina/easy-vibe/HEAD/tools/translation/fixtures/pass/source.md)","docs/ar-sa/stage-3/core-skills/skills/index.md":"# Skills Skill\n\nPath: `docs/ar-sa/stage-3/core-skills/skills/index.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/datawhalechina/easy-vibe/HEAD/docs/ar-sa/stage-3/core-skills/skills/index.md)","docs/de-de/stage-3/core-skills/skills/index.md":"# Skills Skill\n\nPath: `docs/de-de/stage-3/core-skills/skills/index.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/datawhalechina/easy-vibe/HEAD/docs/de-de/stage-3/core-skills/skills/index.md)","docs/en/stage-3/core-skills/skills/index.md":"# Skills Skill\n\nPath: `docs/en/stage-3/core-skills/skills/index.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/datawhalechina/easy-vibe/HEAD/docs/en/stage-3/core-skills/skills/index.md)","docs/es-es/stage-3/core-skills/skills/index.md":"# Skills Skill\n\nPath: `docs/es-es/stage-3/core-skills/skills/index.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/datawhalechina/easy-vibe/HEAD/docs/es-es/stage-3/core-skills/skills/index.md)","docs/fr-fr/stage-3/core-skills/skills/index.md":"# Skills Skill\n\nPath: `docs/fr-fr/stage-3/core-skills/skills/index.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/datawhalechina/easy-vibe/HEAD/docs/fr-fr/stage-3/core-skills/skills/index.md)","docs/ja-jp/stage-3/core-skills/skills/index.md":"# Skills Skill\n\nPath: `docs/ja-jp/stage-3/core-skills/skills/index.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/datawhalechina/easy-vibe/HEAD/docs/ja-jp/stage-3/core-skills/skills/index.md)","docs/ko-kr/stage-3/core-skills/skills/index.md":"# Skills Skill\n\nPath: `docs/ko-kr/stage-3/core-skills/skills/index.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/datawhalechina/easy-vibe/HEAD/docs/ko-kr/stage-3/core-skills/skills/index.md)","docs/vi-vn/stage-3/core-skills/skills/index.md":"# Skills Skill\n\nPath: `docs/vi-vn/stage-3/core-skills/skills/index.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/datawhalechina/easy-vibe/HEAD/docs/vi-vn/stage-3/core-skills/skills/index.md)","docs/zh-cn/stage-3/core-skills/skills/index.md":"# Skills Skill\n\nPath: `docs/zh-cn/stage-3/core-skills/skills/index.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/datawhalechina/easy-vibe/HEAD/docs/zh-cn/stage-3/core-skills/skills/index.md)","docs/zh-tw/stage-3/core-skills/skills/index.md":"# Skills Skill\n\nPath: `docs/zh-tw/stage-3/core-skills/skills/index.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/datawhalechina/easy-vibe/HEAD/docs/zh-tw/stage-3/core-skills/skills/index.md)","tools/translation/fixtures/fail-source-locale/docs/ko-kr/localized.md":"# Ko-kr Skill\n\nPath: `tools/translation/fixtures/fail-source-locale/docs/ko-kr/localized.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/datawhalechina/easy-vibe/HEAD/tools/translation/fixtures/fail-source-locale/docs/ko-kr/localized.md)","tools/translation/fixtures/fail-source-locale/docs/zh-cn/source.md":"# Zh-cn Skill\n\nPath: `tools/translation/fixtures/fail-source-locale/docs/zh-cn/source.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/datawhalechina/easy-vibe/HEAD/tools/translation/fixtures/fail-source-locale/docs/zh-cn/source.md)","tools/translation/fixtures/pass-glossary-annotation/docs/ko-kr/localized.md":"# Ko-kr Skill\n\nPath: `tools/translation/fixtures/pass-glossary-annotation/docs/ko-kr/localized.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/datawhalechina/easy-vibe/HEAD/tools/translation/fixtures/pass-glossary-annotation/docs/ko-kr/localized.md)","tools/translation/fixtures/pass-glossary-annotation/docs/zh-cn/source.md":"# Zh-cn Skill\n\nPath: `tools/translation/fixtures/pass-glossary-annotation/docs/zh-cn/source.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/datawhalechina/easy-vibe/HEAD/tools/translation/fixtures/pass-glossary-annotation/docs/zh-cn/source.md)"},"items":[{"name":"AGENTS.md","path":"AGENTS.md","rawUrl":"https://raw.githubusercontent.com/datawhalechina/easy-vibe/HEAD/AGENTS.md","title":"AI Agent Protocol & Instructions","category":"root-instruction","format":"markdown","content":"# Repository Guidelines\n\n## Project Structure & Module Organization\n\n- `docs/`: VitePress site source (Markdown content, sidebar/nav, assets referenced by docs).\n- `docs/.vitepress/theme/`: custom theme, global component registration in `index.js`, shared styles in `style.css`, layout in `Layout.vue`.\n- `docs/.vitepress/theme/components/appendix/*/`: interactive Vue demos used inside appendix pages (e.g. `web-basics/`, `deployment/`).\n- `assets/`: repo-level images/media (if referenced, prefer linking/copying into `docs/public/` or a doc-local folder when appropriate).\n- `scripts/`, `tools/`, `update_readmes.cjs`: utility scripts for maintaining docs.\n\n## Build, Test, and Development Commands\n\nThis repo is a VitePress (Vue 3) documentation project. Requires Node.js **>= 18**.\n\n```bash\nnpm install\nnpm run dev      # start local docs server (hot reload)\nnpm run build    # production build (use as CI-style check)\nnpm run preview  # preview the built site locally\nnpm run format   # run Prettier on the whole repo\n```\n\n## Coding Style & Naming Conventions\n\n- Formatting: Prettier (`npm run format`). Keep diffs small and avoid reformatting unrelated files.\n- Vue components: Vue 3 SFCs with `<script setup>`, PascalCase filenames (e.g. `SemanticTagsDemo.vue`).\n- CSS: prefer VitePress theme variables (`var(--vp-c-*)`) and keep components responsive (`@media (max-width: 720px)` when needed).\n- Docs: use clear headings and short paragraphs; components are referenced in Markdown as `<ComponentName />`.\n- Images: prefer WebP for screenshots. Convert existing PNG screenshots losslessly without cropping or resizing, preserving decoded pixels, transparency, and color profiles. For example: `cwebp -lossless -exact -m 6 -metadata all input.png -o input.webp`. Verify decoded pixel equality and browser rendering; keep the original PNG when the browser renders it differently. Inspect representative text-heavy crops at full size before committing.\n- When replacing an image, update references in every locale and remove the obsolete source after checking that nothing still references it. Avoid keeping both PNG and WebP copies of the same screenshot.\n- Measure image savings from the current tracked files; existing clones retain old image blobs in Git history. Run the production build and check rendered image URLs as well as Markdown links.\n\n## Testing Guidelines\n\nThere is no dedicated test framework in this repo. Use `npm run build` as the primary correctness check, and manually verify interactive components in `npm run dev`.\n\n## Commit & Pull Request Guidelines\n\n- Commits follow a Conventional Commits style seen in history: `feat: ...`, `fix: ...`, `docs: ...` (optionally scoped like `feat(docs): ...`).\n- PRs should include: a short description, screenshots/GIFs for UI or component changes, and any relevant paths touched (e.g. `docs/zh-cn/appendix/...`, `docs/.vitepress/theme/...`).\n\n## Configuration & Deployment Notes\n\n- `vercel.json` is present; keep builds reproducible and avoid relying on local-only assets.\n","isInternal":false,"tokens":689,"sizeBytes":3041},{"name":"llms.txt","path":"llms.txt","rawUrl":"https://raw.githubusercontent.com/datawhalechina/easy-vibe/HEAD/llms.txt","title":"LLM Index & Context Digest","category":"root-instruction","format":"text","content":"# Easy-Vibe 教程 - AI 导航\n\n> 🦞 **如果你是 AI Agent（如 OpenClaw、Claude、Cursor、Trae 内置 AI、GPT-4、Kimi、通义千问、文心一言等）**\n> \n> **请先阅读本文件**，了解本教程结构后再回答用户问题。本文件是你的「导航地图」，告诉你去哪里找答案。\n\n---\n\n## 🎯 高层级架构（先读我！）\n\n本教程采用 **3+1 阶段** 的渐进式学习路径，从完全零基础到高级开发：\n\n```\n┌─────────────────────────────────────────────────────────────┐\n│  Stage 1: 新手入门与产品原型 (stage-0/ + stage-1/)           │\n│  ├── 目标：建立编程思维，掌握 AI IDE，快速构建产品原型        │\n│  ├── 产出：互动小游戏、完整的产品原型                        │\n│  └── 关键词：零基础、入门、学习路线、贪吃蛇、Cursor、Claude、 │\n│             Trae、MVP、产品思维、AI 能力集成                  │\n├─────────────────────────────────────────────────────────────┤\n│  Stage 2: 初中级开发 (stage-2/)                              │\n│  ├── 目标：全栈开发能力，数据库、部署、支付                   │\n│  ├── 产出：可上线的全栈 AI 应用                              │\n│  └── 关键词：Dify、Supabase、Git、部署、Stripe、UI 设计       │\n├─────────────────────────────────────────────────────────────┤\n│  Stage 3: 高级开发 (stage-3/)                                │\n│  ├── 目标：跨平台开发，AI 进阶，Claude Code 深度使用          │\n│  ├── 产出：生产级多平台应用                                  │\n│  └── 关键词：MCP、RAG、微信小程序、Android、iOS、Electron     │\n├─────────────────────────────────────────────────────────────┤\n│  附录：知识体系 (appendix/)                                  │\n│  ├── 目标：计算机基础到工程素养的完整知识库                   │\n│  ├── 内容：9 大领域，80+ 交互式专题                          │\n│  └── 关键词：计算机基础、前端、后端、AI 原理、架构、运维       │\n└─────────────────────────────────────────────────────────────┘\n```\n\n### 快速决策树\n\n当用户提问时，按以下优先级定位：\n\n1. **问\"怎么开始/零基础/入门\"** → Stage 1 (stage-0/ 和 stage-1/)\n2. **问\"数据库/部署/全栈\"** → Stage 2\n3. **问\"MCP/小程序/跨平台/Claude Code 进阶\"** → Stage 3\n4. **问\"计算机基础/原理\"** → 附录\n\n---\n\n## 📂 目录结构速查\n\n```\ndocs/zh-cn/\n├── stage-0/                    # Stage 1 - 新手入门部分\n│   ├── 0.1-learning-map/       # 学习路线图\n│   └── 0.2-ai-capabilities-through-games/  # 贪吃蛇游戏\n├── stage-1/                    # Stage 1 - 产品原型部分\n│   ├── 1.0-finding-great-idea/ # 找到好创意\n│   ├── 1.1-introduction-to-ai-ide/         # AI IDE 入门\n│   ├── 1.2-building-prototype/ # 原型开发\n│   ├── 1.3-integrating-ai-capabilities/    # 接入 AI 能力\n│   ├── 1.4-complete-project-practice/      # 完整项目实战\n│   └── appendix-*/             # 产品思维、常见错误、场景附录\n├── stage-2/                    # 初中级开发\n│   ├── ai-capabilities/        # AI 能力 (Dify、多模态)\n│   ├── backend/                # 后端 (数据库、Git、部署、支付)\n│   ├── frontend/               # 前端 (Figma、UI、组件库)\n│   └── assignments/            # 作业\n├── stage-3/                    # 高级开发\n│   ├── core-skills/            # 核心技能 (Claude、MCP、Agent)\n│   ├── ai-advanced/            # AI 进阶 (RAG、LangGraph)\n│   ├── cross-platform/         # 跨平台 (小程序、App、桌面)\n│   └── personal-brand/         # 个人品牌\n└── appendix/                   # 附录知识体系\n    ├── 1-computer-fundamentals/    # 计算机基础\n    ├── 2-development-tools/        # 开发工具\n    ├── 3-browser-and-frontend/     # 浏览器与前端\n    ├── 4-server-and-backend/       # 服务器与后端\n    ├── 5-data/                     # 数据\n    ├── 6-architecture-and-system-design/  # 架构设计\n    ├── 7-infrastructure-and-operations/   # 运维\n    ├── 8-artificial-intelligence/  # 人工智能\n    └── 9-engineering-excellence/   # 工程卓越\n```\n\n---\n\n## 🔍 详细文章索引\n\n### Stage 1: 新手入门与产品原型（stage-0/ + stage-1/）\n\n#### 1.0 学习路线图\n**文件**: `docs/zh-cn/stage-0/0.1-learning-map/index.md`\n\n**关键词**: 入门、零基础、怎么开始、学习路线、学习路径、成长路径、职业规划、阶段划分、新手引导、教程介绍、课程概览、适合谁学、前置要求、学习顺序、从哪开始、第一步\n\n**内容概要**: 完整学习路线图，介绍学习路径和目标\n\n---\n\n#### 1.0 AI 能力体验 - 贪吃蛇游戏\n**文件**: `docs/zh-cn/stage-0/0.2-ai-capabilities-through-games/index.md`\n\n**关键词**: 贪吃蛇、游戏、第一个项目、零基础项目、入门实战、AI 编程初体验、小游戏开发、网页游戏、Canvas、JavaScript 游戏、游戏逻辑、键盘控制、碰撞检测、得分系统、游戏循环、requestAnimationFrame\n\n**内容概要**: 用 AI 辅助开发第一个贪吃蛇游戏，理解 AI 编程的基本流程\n\n---\n\n#### 1.1 找到好创意\n**文件**: `docs/zh-cn/stage-1/1.0-finding-great-idea/index.md`\n\n**关键词**: 创意、想法、Idea、产品创意、需求挖掘、用户痛点、市场调研、竞品分析、创新思维、 brainstorming、头脑风暴、产品定位、目标用户、价值主张、MVP 定义、最小可行产品\n\n**内容概要**: 如何找到有价值的产品创意，定义 MVP 范围\n\n---\n\n#### 1.2 AI IDE 入门\n**文件**: `docs/zh-cn/stage-1/1.1-introduction-to-ai-ide/index.md`\n\n**关键词**: Cursor、Claude、Trae、AI IDE、安装、配置、环境搭建、本地开发、IDE 选择、代码编辑器、AI 辅助编程、智能补全、代码生成、自然语言编程、Vibe Coding、提示词技巧、AI 对话、代码解释、代码重构\n\n**内容概要**: 主流 AI IDE 工具的安装配置和使用方法\n\n---\n\n#### 1.3 原型开发\n**文件**: `docs/zh-cn/stage-1/1.2-building-prototype/index.md`\n\n**关键词**: 原型、Demo、快速搭建、MVP、最小可行产品、产品原型、快速验证、低保真、高保真、原型工具、交互设计、用户流程、页面跳转、组件复用、响应式布局、移动端适配\n\n**内容概要**: 快速搭建产品原型，验证产品概念\n\n---\n\n#### 1.4 接入 AI 能力\n**文件**: `docs/zh-cn/stage-1/1.3-integrating-ai-capabilities/index.md`\n\n**关键词**: 接入 AI、API、大模型、AI 能力、LLM、OpenAI、Claude API、GPT、文本生成、聊天机器人、API Key、接口调用、HTTP 请求、JSON、异步处理、错误处理、流式输出、SSE、Token 限制、成本控制\n\n**内容概要**: 如何在项目中接入大模型 API，实现 AI 功能\n\n---\n\n#### 1.5 完整项目实战\n**文件**: `docs/zh-cn/stage-1/1.4-complete-project-practice/index.md`\n\n**关键词**: 完整项目、实战、练手、综合案例、项目实战、端到端、从零开始、项目结构、代码组织、最佳实践、常见问题、调试技巧、测试验证、项目复盘\n\n**内容概要**: 一个完整的项目实战，串联前面所学知识\n\n---\n\n#### 附录 A: 产品思维\n**文件**: `docs/zh-cn/stage-1/appendix-a-product-thinking/index.md`\n\n**关键词**: 产品思维、需求分析、用户研究、产品设计、用户体验、UX、功能优先级、产品文档、PRD、用户故事、敏捷开发、迭代思维、数据驱动、A/B 测试、产品方法论\n\n**内容概要**: 产品经理必备的思维模式和方法论\n\n---\n\n#### 附录 B: 常见错误\n**文件**: `docs/zh-cn/stage-1/appendix-b-common-errors/index.md`\n\n**关键词**: 常见错误、错误排查、问题解决、Bug、调试、报错信息、环境错误、依赖问题、网络问题、权限问题、配置错误、语法错误、运行时错误、逻辑错误、调试技巧\n\n**内容概要**: 初学者常犯的错误及解决方法\n\n---\n\n#### 附录: AI 应用场景参考（B 端与 C 端）\n**文件**: `docs/zh-cn/stage-1/appendix-industry-scenarios/index.md`\n\n**关键词**: 行业场景、行业应用、垂直领域、B2B、B2C、行业解决方案、消费场景、C 端产品、社交应用、内容创作、娱乐应用、生活方式、情感陪伴、个人成长\n\n**内容概要**: B 端 19 个行业落地应用与 C 端 16 个消费场景创意灵感，通过 Tab 切换浏览\n\n---\n\n#### 附录文章 0-1: 贪吃蛇游戏教程\n**文件**: `docs/zh-cn/stage-1/appendix-articles/example0-1/vibe-coding-tools-snake-game-tutorial.md`\n\n**关键词**: 贪吃蛇教程、游戏开发、Canvas API、键盘事件、游戏循环、碰撞检测、得分系统、游戏状态、开始界面、结束界面、代码详解\n\n**内容概要**: 详细的贪吃蛇游戏开发教程\n\n---\n\n#### 附录文章 0-2: AI 编程与设计代理\n**文件**: `docs/zh-cn/stage-1/appendix-articles/example0-2/vibe-coding-tools-build-website-with-ai-coding-and-design-agents.md`\n\n**关键词**: AI 设计、设计代理、网站生成、AI 辅助设计、视觉设计、UI 生成、设计系统、设计稿转代码、Design-to-Code\n\n**内容概要**: 使用 AI 设计代理和编程代理协作完成网站\n\n---\n\n### Stage 2: 初中级开发（全栈技能）\n\n#### 2.1 Dify 知识库\n**文件**: `docs/zh-cn/stage-2/ai-capabilities/2.1-dify-knowledge-base/index.md`\n\n**关键词**: Dify、知识库、RAG、智能客服、文档问答、知识管理、向量数据库、Embedding、文本向量化、语义搜索、知识检索、问答系统、Bot、AI 应用平台、工作流、Prompt 工程、知识库搭建\n\n**内容概要**: 使用 Dify 搭建基于知识库的 AI 应用\n\n---\n\n#### 2.2 多模态 API\n**文件**: `docs/zh-cn/stage-2/ai-capabilities/2.2-multimodal-api/extra3/index.md`\n\n**关键词**: 多模态、图片识别、语音、图像理解、视觉模型、VLM、语音识别、语音合成、TTS、ASR、OCR、图像生成、文生图、图生图、GPT-4V、Claude Vision、文件上传、Base64、图像处理\n\n**内容概要**: 多模态 AI 能力的接入和使用\n\n---\n\n#### 2.2 Supabase 数据库\n**文件**: `docs/zh-cn/stage-2/backend/2.2-database-supabase/index.md`\n\n**关键词**: 数据库、Supabase、PostgreSQL、后端、数据存储、表设计、CRUD、增删改查、SQL、NoSQL、数据库连接、ORM、Prisma、数据模型、关系型数据库、主键外键、索引、查询优化、实时数据库、Row Level Security、RLS\n\n**内容概要**: 使用 Supabase 作为后端数据库，实现数据持久化\n\n---\n\n#### 2.3 AI 接口开发\n**文件**: `docs/zh-cn/stage-2/backend/2.3-ai-interface-code/index.md`\n\n**关键词**: AI 接口、后端开发、API 设计、RESTful、接口开发、路由、控制器、服务端、Node.js、Express、Koa、Fastify、中间件、请求处理、响应格式、状态码、错误处理、接口文档、Swagger、OpenAPI\n\n**内容概要**: 开发 AI 相关的后端接口\n\n---\n\n#### 2.4 Git 工作流\n**文件**: `docs/zh-cn/stage-2/backend/2.4-git-workflow/index.md`\n\n**关键词**: Git、版本控制、协作、代码管理、分支、Branch、Merge、Pull Request、PR、Commit、仓库、Repository、GitHub、GitLab、代码冲突、代码回滚、Cherry Pick、Rebase、Git Flow、团队协作\n\n**内容概要**: Git 版本控制和团队协作流程\n\n---\n\n#### 2.5 Web 应用部署与 Dify 官方云\n**文件**: `docs/zh-cn/stage-2/backend/zeabur-deployment/index.md`\n\n**关键词**: 部署、上线、Cloudflare Pages、Vercel、Render、Dify、CloudBase、Netlify、免费额度、云部署、CI/CD、持续集成、持续部署、域名、DNS、HTTPS、SSL、服务器、容器、Docker、环境变量、生产环境、Staging、Preview、自动化部署\n\n**内容概要**: 按场景介绍 Cloudflare Pages、Vercel、Render 与 Dify 官方云的操作步骤、免费限制，补充 CloudBase 和 Netlify 部署方式\n\n---\n\n#### 2.6 现代 CLI 工具\n**文件**: `docs/zh-cn/stage-2/backend/2.6-modern-cli/index.md`\n\n**关键词**: CLI、命令行、终端、Shell、Bash、Zsh、命令行工具、npm、yarn、pnpm、包管理、脚本、自动化、终端美化、Oh My Zsh、Homebrew、包管理器、环境配置\n\n**内容概要**: 现代命令行开发工具的使用\n\n---\n\n#### 2.7 Stripe 支付\n**文件**: `docs/zh-cn/stage-2/backend/2.7-stripe-payment/index.md`\n\n**关键词**: 支付、Stripe、收款、付款、支付网关、支付集成、订阅、Subscription、Checkout、支付表单、Webhook、支付回调、订单、发票、支付安全、PCI、货币、汇率\n\n**内容概要**: 集成 Stripe 支付功能\n\n---\n\n#### 2.0 Lovart 资源\n**文件**: `docs/zh-cn/stage-2/frontend/2.0-lovart-assets/index.md`\n\n**关键词**: Lovart、资源、素材、图片、图标、设计资源、UI 资源、插画、矢量图、免费素材、商用素材、Unsplash、Iconfont、设计系统\n\n**内容概要**: 设计资源和素材的获取与使用\n\n---\n\n#### 2.1 Figma MasterGo\n**文件**: `docs/zh-cn/stage-2/frontend/2.1-figma-mastergo/index.md`\n\n**关键词**: Figma、MasterGo、设计稿、转代码、Design-to-Code、设计工具、UI 设计、原型设计、设计规范、组件库、设计系统、切图、标注、设计交付、设计协作\n\n**内容概要**: 从设计稿到代码的转换\n\n---\n\n#### 2.2 UI 设计\n**文件**: `docs/zh-cn/stage-2/frontend/2.2-ui-design/index.md`\n\n**关键词**: UI 设计、界面、美观、视觉设计、排版、配色、字体、间距、布局、设计原则、设计模式、用户体验、交互设计、动效、微交互、设计趋势\n\n**内容概要**: UI 设计基础和最佳实践\n\n---\n\n#### 2.3 多端产品 UI\n**文件**: `docs/zh-cn/stage-2/frontend/2.3-multi-product-ui/index.md`\n\n**关键词**: 多端、响应式、移动端、PC 端、平板、适配、断点、Media Query、Flexbox、Grid、Viewport、移动端优先、桌面端、跨设备\n\n**内容概要**: 多端产品的 UI 适配\n\n---\n\n#### 2.4 LLM 技能美化\n**文件**: `docs/zh-cn/stage-2/frontend/2.4-llm-skills-beautiful/index.md`\n\n**关键词**: LLM 技能、美化、提示词优化、Prompt 美化、输出格式化、Markdown、代码高亮、流式输出、打字机效果、UI 美化、聊天界面\n\n**内容概要**: 优化 LLM 输出的展示效果\n\n---\n\n#### 2.5 哈利波特画像\n**文件**: `docs/zh-cn/stage-2/frontend/2.5-hogwarts-portraits/index.md`\n\n**关键词**: 哈利波特、画像、AI 绘画、图像生成、文生图、Stable Diffusion、Midjourney、DALL-E、图像处理、Canvas、特效、动画\n\n**内容概要**: AI 图像生成和前端展示\n\n---\n\n#### 2.6 设计转代码\n**文件**: `docs/zh-cn/stage-2/frontend/2.6-design-to-code/index.md`\n\n**关键词**: 设计转代码、Design-to-Code、自动代码生成、Figma 插件、代码导出、像素完美、设计还原、CSS、Tailwind、样式提取\n\n**内容概要**: 自动化设计稿转代码的工具和方法\n\n---\n\n#### 2.7 现代组件库\n**文件**: `docs/zh-cn/stage-2/frontend/2.7-modern-component-library/index.md`\n\n**关键词**: 组件库、Element Plus、Ant Design、Material UI、Chakra UI、组件封装、复用、Props、Event、Slot、表单组件、数据展示、导航组件、反馈组件\n\n**内容概要**: 使用现代组件库加速开发\n\n---\n\n#### 作业 2.1: 全栈应用\n**文件**: `docs/zh-cn/stage-2/assignments/2.1-fullstack-app/index.md`\n\n**关键词**: 作业、全栈应用、综合练习、项目作业、实战练习、考核、项目要求、评分标准\n\n**内容概要**: Stage 2 的综合作业要求\n\n---\n\n#### 作业 2.2: 现代前端 Trae\n**文件**: `docs/zh-cn/stage-2/assignments/2.2-modern-frontend-trae/index.md`\n\n**关键词**: 作业、Trae、现代前端、项目作业、实战练习、考核\n\n**内容概要**: 使用 Trae 完成现代前端开发作业\n\n---\n\n### Stage 3: 高级开发（跨平台 & AI 进阶）\n\n#### 3.0 基础技能\n**文件**: `docs/zh-cn/stage-3/core-skills/basics/index.md`\n\n**关键词**: 高级基础、核心技能、进阶知识、高级工程师、技术深度、编程范式、设计模式、代码质量、重构、性能优化、Claude、Claude Code、Anthropic\n\n**内容概要**: 高级开发必备的基础技能\n\n---\n\n#### 3.0 工作流\n**文件**: `docs/zh-cn/stage-3/core-skills/workflow/index.md`\n\n**关键词**: 工作流、开发流程、工程化、自动化、DevOps、开发规范、代码审查、Code Review、团队协作、项目管理、Claude、Claude Code\n\n**内容概要**: 高级开发的工程化工作流\n\n---\n\n#### 3.0 技能清单\n**文件**: `docs/zh-cn/stage-3/core-skills/skills/index.md`\n\n**关键词**: 技能清单、技能树、能力模型、技术栈、技术选型、技能评估、学习路径、进阶路线、Claude、Claude Code\n\n**内容概要**: 高级开发技能清单和学习路线\n\n---\n\n#### 3.0 超能力\n**文件**: `docs/zh-cn/stage-3/core-skills/superpowers/index.md`\n\n**关键词**: 超能力、高级技巧、黑科技、效率工具、开发神器、生产力、快捷键、插件、工具链、Claude、Claude Code\n\n**内容概要**: 提升开发效率的高级技巧和工具\n\n---\n\n#### 3.0 移动开发\n**文件**: `docs/zh-cn/stage-3/core-skills/mobile-development/index.md`\n\n**关键词**: 移动开发、移动端、React Native、Flutter、混合开发、H5、WebView、原生开发、App 开发、移动端优化、Claude、Claude Code\n\n**内容概要**: 移动应用开发技术概览\n\n---\n\n#### 3.0 规范编程\n**文件**: `docs/zh-cn/stage-3/core-skills/spec-coding/index.md`\n\n**关键词**: 规范编程、代码规范、ESLint、Prettier、TypeScript、类型安全、代码风格、命名规范、注释规范、文档规范、Claude、Claude Code\n\n**内容概要**: 规范化编程实践\n\n---\n\n#### 3.0 Claude Agent SDK\n**文件**: `docs/zh-cn/stage-3/core-skills/claude-agent-sdk/index.md`\n\n**关键词**: Claude、Claude Code、Claude Agent、SDK、Anthropic、Agent 开发、AI Agent、工具调用、Function Calling、Computer Use、核心技能、core-skills\n\n**内容概要**: Claude Agent SDK 的使用\n\n---\n\n#### 3.0 MCP 工具\n**文件**: `docs/zh-cn/stage-3/core-skills/mcp/index.md`\n\n**关键词**: MCP、Model Context Protocol、工具调用、Claude、Claude Code、外部工具、工具定义、Tool Definition、Function Calling、工具生态、MCP Server、MCP Client、上下文协议、AI 工具链、核心技能、core-skills\n\n**内容概要**: MCP 协议的完整使用指南\n\n---\n\n#### 3.0 Agent 团队\n**文件**: `docs/zh-cn/stage-3/core-skills/agent-teams/index.md`\n\n**关键词**: Agent 团队、多 Agent 协作、Multi-Agent、Agent 编排、角色分工、协作模式、工作流编排、LangChain、AutoGen、CrewAI、Claude、Claude Code、核心技能、core-skills\n\n**内容概要**: 多 Agent 协作系统的设计与实现\n\n---\n\n#### 3.0 长任务处理\n**文件**: `docs/zh-cn/stage-3/core-skills/long-running-tasks/index.md`\n\n**关键词**: 长任务、异步、后台任务、任务队列、Job Queue、Celery、Bull、Redis、消息队列、任务调度、定时任务、Cron、重试机制、任务状态、进度追踪、Claude、Claude Code、核心技能、core-skills\n\n**内容概要**: 长时间运行任务的处理方案\n\n---\n\n#### 3.A1 RAG 入门\n**文件**: `docs/zh-cn/stage-3/ai-advanced/3.a1-rag-introduction/index.md`\n\n**关键词**: RAG、检索增强生成、向量检索、Embedding、向量数据库、Pinecone、Weaviate、Milvus、Chroma、文档切分、Chunking、相似度搜索、语义检索、知识增强\n\n**内容概要**: RAG 技术的基础概念和实现\n\n---\n\n#### 3.A2 LangGraph 高级 RAG\n**文件**: `docs/zh-cn/stage-3/ai-advanced/3.a2-langgraph-advanced-rag/index.md`\n\n**关键词**: LangGraph、高级 RAG、知识图谱、GraphRAG、Agentic RAG、多跳推理、查询重写、重排序、ReRank、混合检索、Self-RAG、Corrective RAG、自适应 RAG\n\n**内容概要**: 使用 LangGraph 实现高级 RAG 系统\n\n---\n\n#### 3.3 微信小程序\n**文件**: `docs/zh-cn/stage-3/cross-platform/3.3-wechat-miniprogram/index.md`\n\n**关键词**: 微信小程序、小程序开发、微信开发、WXML、WXSS、小程序框架、云开发、小程序组件、小程序 API、微信支付、小程序发布、审核\n\n**内容概要**: 微信小程序开发完整指南\n\n---\n\n#### 3.4 小程序后端\n**文件**: `docs/zh-cn/stage-3/cross-platform/3.4-wechat-miniprogram-backend/index.md`\n\n**关键词**: 小程序后端、云开发、微信云开发、云函数、云数据库、云存储、Serverless、小程序登录、OpenID、UnionID、鉴权\n\n**内容概要**: 微信小程序后端开发\n\n---\n\n#### 3.5 Android App\n**文件**: `docs/zh-cn/stage-3/cross-platform/3.5-android-app/index.md`\n\n**关键词**: Android、安卓 App、Kotlin、Java、Android Studio、移动端开发、原生应用、APK、Google Play、Android SDK、Jetpack Compose\n\n**内容概要**: Android 应用开发\n\n---\n\n#### 3.6 iOS App\n**文件**: `docs/zh-cn/stage-3/cross-platform/3.6-ios-app/index.md`\n\n**关键词**: iOS、苹果 App、Swift、SwiftUI、Xcode、移动端开发、原生应用、App Store、iOS SDK、UIKit、TestFlight\n\n**内容概要**: iOS 应用开发\n\n---\n\n#### 3.7 个人网站博客\n**文件**: `docs/zh-cn/stage-3/personal-brand/3.7-personal-website-blog/index.md`\n\n**关键词**: 个人网站、博客、Portfolio、个人品牌、个人主页、简历网站、作品集、静态网站、SSG、Next.js、Nuxt、Hexo、Hugo、VitePress、域名、托管\n\n**内容概要**: 搭建个人网站和博客\n\n---\n\n#### 3.8 PWA 本地应用\n**文件**: `docs/zh-cn/stage-3/cross-platform/3.8-pwa-local-app/index.md`\n\n**关键词**: PWA、Progressive Web App、离线应用、Service Worker、Web App Manifest、本地存储、IndexedDB、Cache、添加到桌面、离线访问\n\n**内容概要**: 构建渐进式 Web 应用\n\n---\n\n#### 3.9 浏览器 AI 插件\n**文件**: `docs/zh-cn/stage-3/cross-platform/3.9-browser-ai-extension/index.md`\n\n**关键词**: 浏览器插件、Extension、Chrome Extension、Firefox Addon、插件开发、Content Script、Background Script、Popup、Manifest V3、浏览器扩展、AI 插件\n\n**内容概要**: 开发浏览器 AI 插件\n\n---\n\n#### 3.10 Electron 语音转文字\n**文件**: `docs/zh-cn/stage-3/cross-platform/3.10-electron-voice-to-text/index.md`\n\n**关键词**: Electron、桌面应用、跨平台桌面、语音转文字、ASR、语音识别、Whisper、桌面端、窗口应用、主进程、渲染进程、IPC\n\n**内容概要**: 使用 Electron 开发语音转文字桌面应用\n\n---\n\n#### 3.11 NFT 铸造\n**文件**: `docs/zh-cn/stage-3/cross-platform/3.11-nft-minting/index.md`\n\n**关键词**: NFT、铸造、区块链、Web3、智能合约、Solidity、以太坊、钱包、MetaMask、IPFS、数字藏品、Gas Fee、合约部署\n\n**内容概要**: NFT 铸造和 Web3 开发\n\n---\n\n#### 3.12 VS Code 插件\n**文件**: `docs/zh-cn/stage-3/cross-platform/3.12-vscode-extension/index.md`\n\n**关键词**: VS Code 插件、Extension、编辑器插件、VS Code API、Command、Tree View、Webview、Language Server、代码补全、语法高亮\n\n**内容概要**: 开发 VS Code 插件\n\n---\n\n#### 3.13 Qt 工业 HMI\n**文件**: `docs/zh-cn/stage-3/cross-platform/3.13-qt-industrial-hmi/index.md`\n\n**关键词**: Qt、工业 HMI、人机界面、工控、SCADA、C++、QML、工业自动化、实时监控、数据采集、PLC、Modbus、OPC UA\n\n**内容概要**: 使用 Qt 开发工业人机界面\n\n---\n\n## 附录：知识体系\n\n### 一、计算机基础\n\n#### 1. Vibe Coding 时代全栈开发\n**文件**: `docs/zh-cn/appendix/1-computer-fundamentals/vibe-coding-fullstack.md`\n\n**关键词**: Vibe Coding、全栈开发、AI 编程、前端、后端、编程语言、工程师成长、技术栈、职业发展\n\n---\n\n#### 2. 从晶体管到 CPU\n**文件**: `docs/zh-cn/appendix/1-computer-fundamentals/transistor-to-cpu.md`\n\n**关键词**: 晶体管、CPU、计算机组成、硬件、逻辑门、运算器、控制器、寄存器、指令集、汇编、机器码、冯诺依曼\n\n---\n\n#### 3. 操作系统\n**文件**: `docs/zh-cn/appendix/1-computer-fundamentals/operating-systems.md`\n\n**关键词**: 操作系统、OS、进程、线程、内存管理、文件系统、调度、并发、同步、死锁、虚拟内存、内核、用户态\n\n---\n\n#### 4. 数据编码与存储\n**文件**: `docs/zh-cn/appendix/1-computer-fundamentals/data-encoding-storage.md`\n\n**关键词**: 数据编码、二进制、字符编码、UTF-8、ASCII、Unicode、数据压缩、存储、文件格式、序列化、JSON、XML、Protobuf\n\n---\n\n#### 5. 计算机网络\n**文件**: `docs/zh-cn/appendix/1-computer-fundamentals/computer-networks.md`\n\n**关键词**: 计算机网络、网络协议、TCP/IP、HTTP、HTTPS、DNS、IP、MAC、路由、交换、网络分层、OSI、Socket、WebSocket\n\n---\n\n#### 6. 数据结构\n**文件**: `docs/zh-cn/appendix/1-computer-fundamentals/data-structures.md`\n\n**关键词**: 数据结构、数组、链表、栈、队列、树、二叉树、堆、图、哈希表、集合、字典、时间复杂度、空间复杂度\n\n---\n\n#### 7. 算法思维\n**文件**: `docs/zh-cn/appendix/1-computer-fundamentals/algorithm-thinking.md`\n\n**关键词**: 算法、排序、搜索、递归、动态规划、贪心、分治、回溯、算法复杂度、大 O 表示法、LeetCode\n\n---\n\n#### 8. 编程语言图谱\n**文件**: `docs/zh-cn/appendix/1-computer-fundamentals/programming-languages.md`\n\n**关键词**: 编程语言、语言分类、静态类型、动态类型、编译型、解释型、面向对象、函数式、脚本语言、系统语言\n\n---\n\n#### 9. 编译原理\n**文件**: `docs/zh-cn/appendix/1-computer-fundamentals/compilers.md`\n\n**关键词**: 编译原理、词法分析、语法分析、AST、抽象语法树、语义分析、代码生成、优化、解释器、编译器\n\n---\n\n#### 10. 类型系统\n**文件**: `docs/zh-cn/appendix/1-computer-fundamentals/type-systems.md`\n\n**关键词**: 类型系统、静态类型、动态类型、强类型、弱类型、类型推断、泛型、类型安全、TypeScript、类型检查\n\n---\n\n#### 11. 计算机组成原理\n**文件**: `docs/zh-cn/appendix/1-computer-fundamentals/computer-organization.md`\n\n**关键词**: 计算机组成、体系结构、存储器、缓存、Cache、总线、I/O、中断、DMA、流水线、并行计算\n\n---\n\n#### 12. 从开机到上网\n**文件**: `docs/zh-cn/appendix/1-computer-fundamentals/power-on-to-web.md`\n\n**关键词**: 开机启动、引导、BIOS、UEFI、Bootloader、操作系统启动、内核加载、用户登录、浏览器、网络连接\n\n---\n\n### 二、开发环境与工具\n\n#### 1. IDE 基础\n**文件**: `docs/zh-cn/appendix/2-development-tools/ide-basics.md`\n\n**关键词**: IDE、VS Code、Cursor、Trae、编辑器、开发环境、插件、扩展、快捷键、调试、代码补全\n\n---\n\n#### 2. 命令行与 Shell\n**文件**: `docs/zh-cn/appendix/2-development-tools/command-line-shell.md`\n\n**关键词**: 命令行、Shell、Bash、Zsh、Terminal、终端、命令、脚本、管道、重定向、环境变量、权限\n\n---\n\n#### 3. Git 版本控制\n**文件**: `docs/zh-cn/appendix/2-development-tools/git-version-control.md`\n\n**关键词**: Git、版本控制、分支、合并、提交、仓库、GitHub、GitLab、冲突解决、Rebase、Cherry Pick\n\n---\n\n#### 4. 环境变量与 PATH\n**文件**: `docs/zh-cn/appendix/2-development-tools/environment-path.md`\n\n**关键词**: 环境变量、PATH、系统变量、用户变量、配置、.env、dotenv、环境配置\n\n---\n\n#### 5. 端口与 localhost\n**文件**: `docs/zh-cn/appendix/2-development-tools/ports-localhost.md`\n\n**关键词**: 端口、Port、localhost、127.0.0.1、本地开发、端口冲突、端口占用、网络地址\n\n---\n\n#### 6. 包管理器\n**文件**: `docs/zh-cn/appendix/2-development-tools/package-managers.md`\n\n**关键词**: 包管理器、npm、yarn、pnpm、pip、conda、gem、依赖管理、package.json、requirements.txt\n\n---\n\n#### 7. SSH 与认证\n**文件**: `docs/zh-cn/appendix/2-development-tools/ssh-authentication.md`\n\n**关键词**: SSH、密钥、公钥、私钥、认证、免密登录、SSH Key、GitHub SSH、安全连接\n\n---\n\n#### 8. 调试艺术\n**文件**: `docs/zh-cn/appendix/2-development-tools/debugging-art.md`\n\n**关键词**: 调试、Debug、断点、单步执行、Console、Log、Debugger、Chrome DevTools、性能分析\n\n---\n\n#### 9. 正则表达式\n**文件**: `docs/zh-cn/appendix/2-development-tools/regex.md`\n\n**关键词**: 正则表达式、Regex、Pattern、匹配、替换、验证、RegExp、字符串处理\n\n---\n\n### 三、浏览器与前端\n\n#### 1. HTML CSS 布局\n**文件**: `docs/zh-cn/appendix/3-browser-and-frontend/html-css-layout.md`\n\n**关键词**: HTML、CSS、布局、Flexbox、Grid、响应式、盒模型、选择器、样式、动画、Transition、Animation\n\n---\n\n#### 2. JavaScript 深入\n**文件**: `docs/zh-cn/appendix/3-browser-and-frontend/javascript-deep-dive.md`\n\n**关键词**: JavaScript、JS、ES6、闭包、原型链、作用域、异步、Promise、Async/Await、Event Loop、this、原型、继承\n\n---\n\n#### 3. TypeScript\n**文件**: `docs/zh-cn/appendix/3-browser-and-frontend/typescript.md`\n\n**关键词**: TypeScript、TS、类型、接口、泛型、装饰器、类型推断、编译、配置、tsconfig\n\n---\n\n#### 4. 前端框架\n**文件**: `docs/zh-cn/appendix/3-browser-and-frontend/frontend-frameworks.md`\n\n**关键词**: 前端框架、React、Vue、Angular、Svelte、组件、状态管理、生命周期、Hooks、Composition API\n\n---\n\n#### 5. 前端工程化\n**文件**: `docs/zh-cn/appendix/3-browser-and-frontend/frontend-engineering.md`\n\n**关键词**: 前端工程化、构建工具、Webpack、Vite、Rollup、Parcel、Babel、ESLint、Prettier、代码规范\n\n---\n\n#### 6. 浏览器渲染\n**文件**: `docs/zh-cn/appendix/3-browser-and-frontend/browser-as-os-rendering.md`\n\n**关键词**: 浏览器、渲染引擎、DOM、CSSOM、渲染树、重绘、重排、合成层、GPU 加速、性能优化\n\n---\n\n#### 7. 路由与导航\n**文件**: `docs/zh-cn/appendix/3-browser-and-frontend/routing-navigation.md`\n\n**关键词**: 路由、Router、前端路由、Vue Router、React Router、History API、Hash、SPA、单页应用\n\n---\n\n#### 8. 状态管理\n**文件**: `docs/zh-cn/appendix/3-browser-and-frontend/state-management.md`\n\n**关键词**: 状态管理、Vuex、Pinia、Redux、MobX、Zustand、Jotai、全局状态、状态机、Context\n\n---\n\n#### 9. 前端项目架构\n**文件**: `docs/zh-cn/appendix/3-browser-and-frontend/frontend-project-architecture.md`\n\n**关键词**: 前端架构、项目结构、目录组织、模块化、组件化、分层架构、微前端、Monorepo\n\n---\n\n#### 10. 实时通信\n**文件**: `docs/zh-cn/appendix/3-browser-and-frontend/realtime-communication.md`\n\n**关键词**: 实时通信、WebSocket、Socket.io、SSE、Server-Sent Events、长轮询、WebRTC、实时数据\n\n---\n\n#### 11. 图形与动画\n**文件**: `docs/zh-cn/appendix/3-browser-and-frontend/graphics-animation.md`\n\n**关键词**: 图形、动画、Canvas、SVG、WebGL、Three.js、CSS 动画、帧动画、粒子效果\n\n---\n\n#### 12. Web 性能\n**文件**: `docs/zh-cn/appendix/3-browser-and-frontend/web-performance.md`\n\n**关键词**: Web 性能、性能优化、加载优化、运行时优化、Lighthouse、Core Web Vitals、懒加载、代码分割、缓存\n\n---\n\n#### 13. 无障碍与国际化\n**文件**: `docs/zh-cn/appendix/3-browser-and-frontend/a11n-i18n.md`\n\n**关键词**: 无障碍、A11y、ARIA、国际化、i18n、本地化、l10n、多语言、屏幕阅读器\n\n---\n\n#### 14. JavaScript 运行时\n**文件**: `docs/zh-cn/appendix/3-browser-and-frontend/javascript-runtime.md`\n\n**关键词**: JavaScript 运行时、Node.js、Deno、Bun、运行时环境、事件循环、模块系统\n\n---\n\n#### 15. 前端框架本质\n**文件**: `docs/zh-cn/appendix/3-browser-and-frontend/frontend-framework-nature.md`\n\n**关键词**: 前端框架本质、Virtual DOM、Diff 算法、响应式原理、依赖追踪、编译优化\n\n---\n\n### 四、服务器与后端\n\n#### 1. 后端语言\n**文件**: `docs/zh-cn/appendix/4-server-and-backend/backend-languages.md`\n\n**关键词**: 后端语言、Node.js、Python、Java、Go、Rust、PHP、Ruby、语言选择、技术栈\n\n---\n\n#### 2. 后端分层架构\n**文件**: `docs/zh-cn/appendix/4-server-and-backend/backend-layered-architecture.md`\n\n**关键词**: 后端架构、分层、MVC、三层架构、领域驱动、DDD、Clean Architecture、依赖注入\n\n---\n\n#### 3. 请求旅程\n**文件**: `docs/zh-cn/appendix/4-server-and-backend/request-journey.md`\n\n**关键词**: 请求旅程、HTTP 请求、生命周期、中间件、路由、控制器、服务层、数据层、响应\n\n---\n\n#### 4. API 入门\n**文件**: `docs/zh-cn/appendix/4-server-and-backend/api-intro.md`\n\n**关键词**: API、接口、REST、RESTful、HTTP 方法、状态码、请求头、响应头、Content-Type、认证\n\n---\n\n#### 5. API 设计\n**文件**: `docs/zh-cn/appendix/4-server-and-backend/api-design.md`\n\n**关键词**: API 设计、接口设计、版本控制、URL 设计、资源命名、错误处理、分页、过滤、排序\n\n---\n\n#### 6. Web 框架\n**文件**: `docs/zh-cn/appendix/4-server-and-backend/web-frameworks.md`\n\n**关键词**: Web 框架、Express、Koa、Fastify、NestJS、Django、Flask、Spring Boot、Gin、路由、中间件\n\n---\n\n#### 7. HTTP 协议\n**文件**: `docs/zh-cn/appendix/4-server-and-backend/http-protocol.md`\n\n**关键词**: HTTP、协议、请求、响应、Header、Body、Method、Status Code、Cookie、Session、Keep-Alive、HTTP/2、HTTP/3\n\n---\n\n#### 8. 认证与授权\n**文件**: `docs/zh-cn/appendix/4-server-and-backend/auth-authorization.md`\n\n**关键词**: 认证、授权、Auth、JWT、OAuth、SSO、Session、Cookie、Token、权限、RBAC、鉴权\n\n---\n\n#### 9. 序列化\n**文件**: `docs/zh-cn/appendix/4-server-and-backend/serialization.md`\n\n**关键词**: 序列化、反序列化、JSON、XML、Protobuf、MessagePack、Avro、Thrift、数据格式\n\n---\n\n#### 10. 并发与异步\n**文件**: `docs/zh-cn/appendix/4-server-and-backend/concurrency-async.md`\n\n**关键词**: 并发、异步、多线程、多进程、协程、Promise、Async/Await、事件驱动、回调、非阻塞 IO\n\n---\n\n#### 11. 缓存\n**文件**: `docs/zh-cn/appendix/4-server-and-backend/caching.md`\n\n**关键词**: 缓存、Cache、Redis、Memcached、本地缓存、分布式缓存、缓存策略、缓存穿透、缓存雪崩、缓存更新\n\n---\n\n#### 12. 消息队列\n**文件**: `docs/zh-cn/appendix/4-server-and-backend/message-queues.md`\n\n**关键词**: 消息队列、MQ、RabbitMQ、Kafka、RocketMQ、消息模型、发布订阅、点对点、消息可靠性\n\n---\n\n#### 13. 异步任务队列\n**文件**: `docs/zh-cn/appendix/4-server-and-backend/async-task-queues.md`\n\n**关键词**: 任务队列、Celery、Bull、RQ、Sidekiq、后台任务、定时任务、任务调度、重试机制\n\n---\n\n#### 14. 限流与背压\n**文件**: `docs/zh-cn/appendix/4-server-and-backend/rate-limiting-backpressure.md`\n\n**关键词**: 限流、Rate Limiting、背压、Backpressure、流量控制、熔断、降级、负载保护、令牌桶、漏桶\n\n---\n\n#### 15. 搜索引擎\n**文件**: `docs/zh-cn/appendix/4-server-and-backend/search-engines.md`\n\n**关键词**: 搜索引擎、Elasticsearch、Solr、全文搜索、倒排索引、分词、相关性排序、搜索优化\n\n---\n\n#### 16. 文件存储\n**文件**: `docs/zh-cn/appendix/4-server-and-backend/file-storage.md`\n\n**关键词**: 文件存储、OSS、S3、MinIO、云存储、对象存储、CDN、文件上传、断点续传、分片上传\n\n---\n\n#### 17. 后端项目架构\n**文件**: `docs/zh-cn/appendix/4-server-and-backend/backend-project-architecture.md`\n\n**关键词**: 后端项目架构、项目结构、目录组织、模块化、服务划分、代码组织、最佳实践\n\n---\n\n#### 18. 客户端语言\n**文件**: `docs/zh-cn/appendix/4-server-and-backend/client-languages.md`\n\n**关键词**: 客户端语言、移动端、桌面端、小程序、跨平台、React Native、Flutter、Electron、Tauri\n\n---\n\n#### 19. 领域特定语言\n**文件**: `docs/zh-cn/appendix/4-server-and-backend/domain-specific-languages.md`\n\n**关键词**: DSL、领域特定语言、SQL、正则、GraphQL、配置语言、模板语言、内部 DSL、外部 DSL\n\n---\n\n#### 20. 跨平台\n**文件**: `docs/zh-cn/appendix/4-server-and-backend/cross-platform.md`\n\n**关键词**: 跨平台、多端、统一开发、Write Once Run Anywhere、跨平台框架、适配策略\n\n---\n\n### 五、数据\n\n#### 1. 数据库基础\n**文件**: `docs/zh-cn/appendix/5-data/database-fundamentals.md`\n\n**关键词**: 数据库基础、关系型数据库、SQL、MySQL、PostgreSQL、表、字段、索引、事务、ACID、SQL 语句\n\n---\n\n#### 2. 数据模型\n**文件**: `docs/zh-cn/appendix/5-data/data-models.md`\n\n**关键词**: 数据模型、ER 模型、关系模型、文档模型、图模型、键值模型、数据建模、范式、反范式\n\n---\n\n#### 3. 数据分析\n**文件**: `docs/zh-cn/appendix/5-data/data-analysis.md`\n\n**关键词**: 数据分析、Python、Pandas、NumPy、数据清洗、数据可视化、统计分析、BI、数据挖掘\n\n---\n\n#### 4. 数据可视化\n**文件**: `docs/zh-cn/appendix/5-data/data-visualization.md`\n\n**关键词**: 数据可视化、图表、ECharts、D3.js、AntV、Tableau、可视化设计、交互可视化\n\n---\n\n#### 5. A/B 测试\n**文件**: `docs/zh-cn/appendix/5-data/ab-testing.md`\n\n**关键词**: A/B 测试、实验、对照组、实验组、显著性、假设检验、转化率、实验设计\n\n---\n\n#### 6. 数据埋点\n**文件**: `docs/zh-cn/appendix/5-data/data-tracking.md`\n\n**关键词**: 数据埋点、事件追踪、用户行为、数据分析、漏斗分析、留存分析、归因分析\n\n---\n\n#### 7. 数据治理\n**文件**: `docs/zh-cn/appendix/5-data/data-governance.md`\n\n**关键词**: 数据治理、数据质量、数据安全、数据标准、元数据、数据血缘、合规、隐私\n\n---\n\n### 六、架构与系统设计\n\n#### 1. 系统设计方法论\n**文件**: `docs/zh-cn/appendix/6-architecture-and-system-design/system-design-methodology.md`\n\n**关键词**: 系统设计、架构设计、设计原则、SOLID、设计模式、系统思维、权衡、扩展性、可用性\n\n---\n\n#### 2. 分布式系统\n**文件**: `docs/zh-cn/appendix/6-architecture-and-system-design/distributed-systems.md`\n\n**关键词**: 分布式系统、CAP 定理、一致性、可用性、分区容错、分布式事务、共识算法、Raft、Paxos\n\n---\n\n#### 3. 高可用\n**文件**: `docs/zh-cn/appendix/6-architecture-and-system-design/high-availability.md`\n\n**关键词**: 高可用、HA、容灾、故障转移、主从、集群、多活、SLA、SLO、SLI、可靠性工程\n\n---\n\n#### 4. 单体到微服务\n**文件**: `docs/zh-cn/appendix/6-architecture-and-system-design/monolith-to-microservices.md`\n\n**关键词**: 微服务、单体、服务拆分、服务治理、服务发现、配置中心、链路追踪、分布式追踪\n\n---\n\n### 七、基础设施与运维\n\n#### 1. Linux 基础\n**文件**: `docs/zh-cn/appendix/7-infrastructure-and-operations/linux-basics.md`\n\n**关键词**: Linux、操作系统、命令行、Shell、文件系统、权限、进程管理、网络配置、系统管理\n\n---\n\n#### 2. Docker 容器\n**文件**: `docs/zh-cn/appendix/7-infrastructure-and-operations/docker-containers.md`\n\n**关键词**: Docker、容器、镜像、Container、Dockerfile、Compose、容器化、微服务部署\n\n---\n\n#### 3. Kubernetes\n**文件**: `docs/zh-cn/appendix/7-infrastructure-and-operations/kubernetes.md`\n\n**关键词**: Kubernetes、K8s、容器编排、Pod、Service、Deployment、Ingress、Helm、集群管理\n\n---\n\n#### 4. CI/CD\n**文件**: `docs/zh-cn/appendix/7-infrastructure-and-operations/ci-cd.md`\n\n**关键词**: CI/CD、持续集成、持续部署、Jenkins、GitLab CI、GitHub Actions、自动化构建、自动化测试\n\n---\n\n#### 5. 云平台\n**文件**: `docs/zh-cn/appendix/7-infrastructure-and-operations/cloud-platforms.md`\n\n**关键词**: 云平台、AWS、Azure、GCP、阿里云、腾讯云、华为云、云服务、IaaS、PaaS、SaaS\n\n---\n\n#### 6. 云 IAM\n**文件**: `docs/zh-cn/appendix/7-infrastructure-and-operations/cloud-iam.md`\n\n**关键词**: IAM、身份管理、访问控制、权限管理、角色、策略、RBAC、云安全\n\n---\n\n#### 7. 云存储与 CDN\n**文件**: `docs/zh-cn/appendix/7-infrastructure-and-operations/cloud-storage-cdn.md`\n\n**关键词**: 云存储、CDN、对象存储、内容分发、边缘计算、加速、缓存策略\n\n---\n\n#### 8. DNS 与 HTTPS\n**文件**: `docs/zh-cn/appendix/7-infrastructure-and-operations/dns-https.md`\n\n**关键词**: DNS、域名解析、HTTPS、SSL、TLS、证书、CA、加密、安全传输\n\n---\n\n#### 9. 负载均衡与网关\n**文件**: `docs/zh-cn/appendix/7-infrastructure-and-operations/load-balancing-gateway.md`\n\n**关键词**: 负载均衡、Gateway、Nginx、API Gateway、反向代理、流量分发、健康检查\n\n---\n\n#### 10. 网关代理\n**文件**: `docs/zh-cn/appendix/7-infrastructure-and-operations/gateway-proxy.md`\n\n**关键词**: 网关、代理、Nginx、Traefik、Envoy、服务网格、Istio、流量管理\n\n---\n\n#### 11. 基础设施即代码\n**文件**: `docs/zh-cn/appendix/7-infrastructure-and-operations/infrastructure-as-code.md`\n\n**关键词**: IaC、基础设施即代码、Terraform、Ansible、Pulumi、CloudFormation、自动化运维\n\n---\n\n#### 12. 监控与日志\n**文件**: `docs/zh-cn/appendix/7-infrastructure-and-operations/monitoring-logging.md`\n\n**关键词**: 监控、日志、Prometheus、Grafana、ELK、Loki、告警、可观测性、Observability\n\n---\n\n#### 13. 事故响应\n**文件**: `docs/zh-cn/appendix/7-infrastructure-and-operations/incident-response.md`\n\n**关键词**: 事故响应、故障处理、应急响应、SRE、事后复盘、故障演练、混沌工程\n\n---\n\n### 八、人工智能\n\n#### 1. AI 历史\n**文件**: `docs/zh-cn/appendix/8-artificial-intelligence/ai-history.md`\n\n**关键词**: AI 历史、人工智能发展、机器学习历史、深度学习、神经网络历史、AI 里程碑\n\n---\n\n#### 2. 神经网络\n**文件**: `docs/zh-cn/appendix/8-artificial-intelligence/neural-networks.md`\n\n**关键词**: 神经网络、深度学习、CNN、RNN、LSTM、GRU、激活函数、反向传播、梯度下降\n\n---\n\n#### 3. Transformer 与注意力机制\n**文件**: `docs/zh-cn/appendix/8-artificial-intelligence/transformer-attention.md`\n\n**关键词**: Transformer、注意力机制、Attention、Self-Attention、Multi-Head Attention、BERT、GPT、位置编码\n\n---\n\n#### 4. LLM 原理\n**文件**: `docs/zh-cn/appendix/8-artificial-intelligence/llm-principles.md`\n\n**关键词**: LLM、大语言模型、预训练、微调、Fine-tuning、RLHF、对齐、涌现能力、Scaling Law\n\n---\n\n#### 5. Prompt 工程\n**文件**: `docs/zh-cn/appendix/8-artificial-intelligence/prompt-engineering.md`\n\n**关键词**: Prompt 工程、提示词、Prompt Design、Few-shot、Chain-of-Thought、ReAct、提示词优化\n\n---\n\n#### 6. RAG\n**文件**: `docs/zh-cn/appendix/8-artificial-intelligence/rag.md`\n\n**关键词**: RAG、检索增强生成、向量检索、Embedding、知识库、文档问答、语义搜索\n\n---\n\n#### 7. Embedding 与向量检索\n**文件**: `docs/zh-cn/appendix/8-artificial-intelligence/embedding-vector-retrieval.md`\n\n**关键词**: Embedding、向量、向量检索、向量数据库、相似度、余弦相似度、向量空间\n\n---\n\n#### 8. AI Agent\n**文件**: `docs/zh-cn/appendix/8-artificial-intelligence/ai-agents.md`\n\n**关键词**: AI Agent、智能体、Agent 架构、ReAct、Plan-and-Execute、Tool Use、Multi-Agent\n\n---\n\n#### 9. 多模态模型\n**文件**: `docs/zh-cn/appendix/8-artificial-intelligence/multimodal-models.md`\n\n**关键词**: 多模态、视觉语言模型、VLM、CLIP、GPT-4V、图像理解、跨模态、图文生成\n\n---\n\n#### 10. 图像生成\n**文件**: `docs/zh-cn/appendix/8-artificial-intelligence/image-generation.md`\n\n**关键词**: 图像生成、文生图、Stable Diffusion、Midjourney、DALL-E、GAN、Diffusion、ControlNet\n\n---\n\n#### 11. 语音合成与识别\n**文件**: `docs/zh-cn/appendix/8-artificial-intelligence/speech-synthesis-recognition.md`\n\n**关键词**: 语音合成、语音识别、TTS、ASR、Whisper、语音克隆、声纹识别\n\n---\n\n#### 12. 模型微调与部署\n**文件**: `docs/zh-cn/appendix/8-artificial-intelligence/model-finetuning-deployment.md`\n\n**关键词**: 模型微调、Fine-tuning、LoRA、QLoRA、模型部署、模型量化、推理优化、ONNX、TensorRT\n\n---\n\n#### 13. AI 协议\n**文件**: `docs/zh-cn/appendix/8-artificial-intelligence/ai-protocols.md`\n\n**关键词**: AI 协议、MCP、Function Calling、Tool Use、API 标准、OpenAI API、Anthropic API\n\n---\n\n#### 14. AI 原生应用设计\n**文件**: `docs/zh-cn/appendix/8-artificial-intelligence/ai-native-app-design.md`\n\n**关键词**: AI 原生应用、AI-First、产品设计、用户体验、人机交互、Copilot、Agent 界面\n\n---\n\n#### 15. 上下文工程\n**文件**: `docs/zh-cn/appendix/8-artificial-intelligence/context-engineering.md`\n\n**关键词**: 上下文工程、Context Engineering、上下文管理、长上下文、RAG、记忆、会话管理\n\n---\n\n#### 16. AI 能力词典\n**文件**: `docs/zh-cn/appendix/8-artificial-intelligence/ai-capability-dictionary.md`\n\n**关键词**: AI 能力、AI 功能、能力清单、应用场景、技术选型、AI 解决方案\n\n---\n\n### 九、工程卓越\n\n#### 1. 代码质量与重构\n**文件**: `docs/zh-cn/appendix/9-engineering-excellence/code-quality-refactoring.md`\n\n**关键词**: 代码质量、重构、Clean Code、代码审查、技术债务、代码异味、重构模式\n\n---\n\n#### 2. 测试策略\n**文件**: `docs/zh-cn/appendix/9-engineering-excellence/testing-strategies.md`\n\n**关键词**: 测试、单元测试、集成测试、E2E 测试、TDD、BDD、测试覆盖率、Mock、自动化测试\n\n---\n\n#### 3. 设计模式\n**文件**: `docs/zh-cn/appendix/9-engineering-excellence/design-patterns.md`\n\n**关键词**: 设计模式、单例、工厂、观察者、策略、装饰器、适配器、MVC、MVVM、架构模式\n\n---\n\n#### 4. 技术选型\n**文件**: `docs/zh-cn/appendix/9-engineering-excellence/technology-selection.md`\n\n**关键词**: 技术选型、技术决策、技术栈、框架选择、评估标准、技术雷达、技术债\n\n---\n\n#### 5. 开源协作\n**文件**: `docs/zh-cn/appendix/9-engineering-excellence/open-source-collaboration.md`\n\n**关键词**: 开源、开源协作、GitHub、贡献指南、Code Review、社区、开源协议、LICENSE\n\n---\n\n#### 6. 安全思维\n**文件**: `docs/zh-cn/appendix/9-engineering-excellence/security-thinking.md`\n\n**关键词**: 安全、安全思维、OWASP、漏洞、注入、XSS、CSRF、安全编码、加密、认证\n\n---\n\n#### 7. 技术写作\n**文件**: `docs/zh-cn/appendix/9-engineering-excellence/technical-writing.md`\n\n**关键词**: 技术写作、文档、README、API 文档、技术博客、知识分享、文档规范\n\n---\n\n## ✅ 回答规则（必读）\n\n1. **先读高层架构**：先阅读上面的\"高层级架构\"和\"快速决策树\"，确定用户问题属于哪个阶段\n2. **再查详细索引**：根据阶段定位到详细文章索引，找到具体文件\n3. **引用来源**：回答时注明信息来自哪个文件，例如：\"根据 `stage-1/1.1-introduction-to-ai-ide` 的内容...\"\n4. **代码优先**：优先使用教程中提供的代码示例\n5. **阶段匹配**：根据用户水平推荐合适的内容，不要给新手推荐 Stage 3 的高级内容\n6. **关键词匹配**：根据用户问题中的关键词，快速定位到对应文件\n7. **不确定时**：明确告诉用户\"让我先查看相关教程内容\"，然后读取文件\n8. **附录参考**：当用户问基础概念时，优先引用附录中的知识文章\n\n---\n\n## 📚 教程概览\n\n**Easy-Vibe** 是一个从零开始的 AI 编程教程，核心理念是 **Vibe Coding**（用自然语言编程）。\n\n### 学习路径\n\n```\nStage 0 (新手入门)\n    ↓\nStage 1 (AI 产品经理) - 用 AI IDE 做原型\n    ↓\nStage 2 (初中级开发) - 全栈开发 + 部署\n    ↓\nStage 3 (高级开发) - 跨平台 + AI 进阶\n    ↓\n附录 (知识体系) - 计算机基础到工程素养\n```\n\n### 目标读者\n- **零基础用户**：从 Stage 0 开始，先体验 AI 编程的乐趣\n- **产品经理/设计师**：重点学习 Stage 1，快速做 Demo\n- **初级开发者**：Stage 2 帮你补齐全栈技能\n- **高级开发者**：Stage 3 的 MCP、RAG、跨平台开发\n- **全栈工程师**：附录提供完整的计算机知识体系\n\n### 技术栈\n- **AI IDE**: Cursor, Claude Code, Trae\n- **前端**: Vue 3, React, Element Plus\n- **后端**: Node.js, Supabase, Dify\n- **部署**: Cloudflare Pages, Vercel, Render, Dify Cloud, CloudBase, Netlify\n- **跨平台**: 微信小程序, Android, iOS, Electron\n- **AI 技术**: LLM, RAG, MCP, Agent, 多模态\n\n---\n\n## 🔗 相关文件\n\n- **本文件**: `llms.txt` - AI 导航入口（必读）\n- **Claude Code 专用**: `CLAUDE.md` - 针对 Claude Code 的详细指南\n- **项目说明**: `README.md` - 人类用户入口\n- **配置文件**: `docs/.vitepress/config.mjs` - 网站导航配置\n\n---\n\n## 📝 版本信息\n\n- **版本**: 2.1.0\n- **更新日期**: 2026-03-02\n- **文章总数**: 100+ 篇\n- **语言支持**: 中文(zh-cn), 英文(en), 日文(ja-jp), 韩文(ko-kr), 繁体中文(zh-tw), 西班牙文(es-es), 法文(fr-fr), 德文(de-de), 阿拉伯文(ar-sa), 越南文(vi-vn)\n- **默认语言**: 中文 (`docs/zh-cn/`)\n\n---\n\n> 💡 **提示**: 如果你是多语言 AI，请根据用户使用的语言选择对应的 `docs/{语言}/` 目录下的文件。\n","isInternal":false,"tokens":17417,"sizeBytes":51108},{"name":"index.md","path":"docs/ar-sa/stage-3/core-skills/skills/index.md","rawUrl":"https://raw.githubusercontent.com/datawhalechina/easy-vibe/HEAD/docs/ar-sa/stage-3/core-skills/skills/index.md","title":"Skills Skill","category":"anthropic-skill","format":"markdown","content":"# Skills Skill\n\nPath: `docs/ar-sa/stage-3/core-skills/skills/index.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/datawhalechina/easy-vibe/HEAD/docs/ar-sa/stage-3/core-skills/skills/index.md)","tokens":300,"sizeBytes":212},{"name":"index.md","path":"docs/de-de/stage-3/core-skills/skills/index.md","rawUrl":"https://raw.githubusercontent.com/datawhalechina/easy-vibe/HEAD/docs/de-de/stage-3/core-skills/skills/index.md","title":"Skills Skill","category":"anthropic-skill","format":"markdown","content":"# Skills Skill\n\nPath: `docs/de-de/stage-3/core-skills/skills/index.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/datawhalechina/easy-vibe/HEAD/docs/de-de/stage-3/core-skills/skills/index.md)","tokens":300,"sizeBytes":212},{"name":"index.md","path":"docs/en/stage-3/core-skills/skills/index.md","rawUrl":"https://raw.githubusercontent.com/datawhalechina/easy-vibe/HEAD/docs/en/stage-3/core-skills/skills/index.md","title":"Skills Skill","category":"anthropic-skill","format":"markdown","content":"# Skills Skill\n\nPath: `docs/en/stage-3/core-skills/skills/index.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/datawhalechina/easy-vibe/HEAD/docs/en/stage-3/core-skills/skills/index.md)","tokens":300,"sizeBytes":206},{"name":"index.md","path":"docs/es-es/stage-3/core-skills/skills/index.md","rawUrl":"https://raw.githubusercontent.com/datawhalechina/easy-vibe/HEAD/docs/es-es/stage-3/core-skills/skills/index.md","title":"Skills Skill","category":"anthropic-skill","format":"markdown","content":"# Skills Skill\n\nPath: `docs/es-es/stage-3/core-skills/skills/index.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/datawhalechina/easy-vibe/HEAD/docs/es-es/stage-3/core-skills/skills/index.md)","tokens":300,"sizeBytes":212},{"name":"index.md","path":"docs/fr-fr/stage-3/core-skills/skills/index.md","rawUrl":"https://raw.githubusercontent.com/datawhalechina/easy-vibe/HEAD/docs/fr-fr/stage-3/core-skills/skills/index.md","title":"Skills Skill","category":"anthropic-skill","format":"markdown","content":"# Skills Skill\n\nPath: `docs/fr-fr/stage-3/core-skills/skills/index.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/datawhalechina/easy-vibe/HEAD/docs/fr-fr/stage-3/core-skills/skills/index.md)","tokens":300,"sizeBytes":212},{"name":"index.md","path":"docs/ja-jp/stage-3/core-skills/skills/index.md","rawUrl":"https://raw.githubusercontent.com/datawhalechina/easy-vibe/HEAD/docs/ja-jp/stage-3/core-skills/skills/index.md","title":"Skills Skill","category":"anthropic-skill","format":"markdown","content":"# Skills Skill\n\nPath: `docs/ja-jp/stage-3/core-skills/skills/index.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/datawhalechina/easy-vibe/HEAD/docs/ja-jp/stage-3/core-skills/skills/index.md)","tokens":300,"sizeBytes":212},{"name":"index.md","path":"docs/ko-kr/stage-3/core-skills/skills/index.md","rawUrl":"https://raw.githubusercontent.com/datawhalechina/easy-vibe/HEAD/docs/ko-kr/stage-3/core-skills/skills/index.md","title":"Skills Skill","category":"anthropic-skill","format":"markdown","content":"# Skills Skill\n\nPath: `docs/ko-kr/stage-3/core-skills/skills/index.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/datawhalechina/easy-vibe/HEAD/docs/ko-kr/stage-3/core-skills/skills/index.md)","tokens":300,"sizeBytes":212},{"name":"index.md","path":"docs/vi-vn/stage-3/core-skills/skills/index.md","rawUrl":"https://raw.githubusercontent.com/datawhalechina/easy-vibe/HEAD/docs/vi-vn/stage-3/core-skills/skills/index.md","title":"Skills Skill","category":"anthropic-skill","format":"markdown","content":"# Skills Skill\n\nPath: `docs/vi-vn/stage-3/core-skills/skills/index.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/datawhalechina/easy-vibe/HEAD/docs/vi-vn/stage-3/core-skills/skills/index.md)","tokens":300,"sizeBytes":212},{"name":"index.md","path":"docs/zh-cn/stage-3/core-skills/skills/index.md","rawUrl":"https://raw.githubusercontent.com/datawhalechina/easy-vibe/HEAD/docs/zh-cn/stage-3/core-skills/skills/index.md","title":"Skills Skill","category":"anthropic-skill","format":"markdown","content":"# Skills Skill\n\nPath: `docs/zh-cn/stage-3/core-skills/skills/index.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/datawhalechina/easy-vibe/HEAD/docs/zh-cn/stage-3/core-skills/skills/index.md)","tokens":300,"sizeBytes":212},{"name":"index.md","path":"docs/zh-tw/stage-3/core-skills/skills/index.md","rawUrl":"https://raw.githubusercontent.com/datawhalechina/easy-vibe/HEAD/docs/zh-tw/stage-3/core-skills/skills/index.md","title":"Skills Skill","category":"anthropic-skill","format":"markdown","content":"# Skills Skill\n\nPath: `docs/zh-tw/stage-3/core-skills/skills/index.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/datawhalechina/easy-vibe/HEAD/docs/zh-tw/stage-3/core-skills/skills/index.md)","tokens":300,"sizeBytes":212},{"name":"localized.md","path":"tools/translation/fixtures/fail-code-block/localized.md","rawUrl":"https://raw.githubusercontent.com/datawhalechina/easy-vibe/HEAD/tools/translation/fixtures/fail-code-block/localized.md","title":"Fail-code-block Skill","category":"anthropic-skill","format":"markdown","content":"<!-- Expected failure: the port value inside the fenced code block was changed. -->\n\n# 실행\n\n```js\nconst port = 8080\n```\n","isInternal":false,"tokens":31,"sizeBytes":123},{"name":"source.md","path":"tools/translation/fixtures/fail-code-block/source.md","rawUrl":"https://raw.githubusercontent.com/datawhalechina/easy-vibe/HEAD/tools/translation/fixtures/fail-code-block/source.md","title":"Fail-code-block Skill","category":"anthropic-skill","format":"markdown","content":"<!-- Fixture source: fenced code must be preserved exactly. -->\n\n# 运行\n\n```js\nconst port = 3000\n```\n","isInternal":false,"tokens":29,"sizeBytes":103},{"name":"localized.md","path":"tools/translation/fixtures/fail-frontmatter/localized.md","rawUrl":"https://raw.githubusercontent.com/datawhalechina/easy-vibe/HEAD/tools/translation/fixtures/fail-frontmatter/localized.md","title":"Fail-frontmatter Skill","category":"anthropic-skill","format":"markdown","content":"---\ntitle: 설치 안내\n---\n\n<!-- Expected failure: the localized frontmatter is missing the description key. -->\n\n# 설치\n","frontmatter":{"title":"설치 안내"},"isInternal":false,"tokens":28,"sizeBytes":125},{"name":"source.md","path":"tools/translation/fixtures/fail-frontmatter/source.md","rawUrl":"https://raw.githubusercontent.com/datawhalechina/easy-vibe/HEAD/tools/translation/fixtures/fail-frontmatter/source.md","title":"Fail-frontmatter Skill","category":"anthropic-skill","format":"markdown","content":"---\ntitle: 安装指南\ndescription: 安装示例\n---\n\n<!-- Fixture source: the localized file must preserve both frontmatter keys. -->\n\n# 安装\n","frontmatter":{"title":"安装指南","description":"安装示例"},"isInternal":false,"tokens":38,"sizeBytes":146},{"name":"localized.md","path":"tools/translation/fixtures/fail-image/localized.md","rawUrl":"https://raw.githubusercontent.com/datawhalechina/easy-vibe/HEAD/tools/translation/fixtures/fail-image/localized.md","title":"Fail-image Skill","category":"anthropic-skill","format":"markdown","content":"# Fail-image Skill\n\nPath: `tools/translation/fixtures/fail-image/localized.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/datawhalechina/easy-vibe/HEAD/tools/translation/fixtures/fail-image/localized.md)","tokens":300,"sizeBytes":224},{"name":"source.md","path":"tools/translation/fixtures/fail-image/source.md","rawUrl":"https://raw.githubusercontent.com/datawhalechina/easy-vibe/HEAD/tools/translation/fixtures/fail-image/source.md","title":"Fail-image Skill","category":"anthropic-skill","format":"markdown","content":"# Fail-image Skill\n\nPath: `tools/translation/fixtures/fail-image/source.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/datawhalechina/easy-vibe/HEAD/tools/translation/fixtures/fail-image/source.md)","tokens":300,"sizeBytes":218},{"name":"localized.md","path":"tools/translation/fixtures/fail-inline-code/localized.md","rawUrl":"https://raw.githubusercontent.com/datawhalechina/easy-vibe/HEAD/tools/translation/fixtures/fail-inline-code/localized.md","title":"Fail-inline-code Skill","category":"anthropic-skill","format":"markdown","content":"# Fail-inline-code Skill\n\nPath: `tools/translation/fixtures/fail-inline-code/localized.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/datawhalechina/easy-vibe/HEAD/tools/translation/fixtures/fail-inline-code/localized.md)","tokens":300,"sizeBytes":242},{"name":"source.md","path":"tools/translation/fixtures/fail-inline-code/source.md","rawUrl":"https://raw.githubusercontent.com/datawhalechina/easy-vibe/HEAD/tools/translation/fixtures/fail-inline-code/source.md","title":"Fail-inline-code Skill","category":"anthropic-skill","format":"markdown","content":"# Fail-inline-code Skill\n\nPath: `tools/translation/fixtures/fail-inline-code/source.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/datawhalechina/easy-vibe/HEAD/tools/translation/fixtures/fail-inline-code/source.md)","tokens":300,"sizeBytes":236},{"name":"localized.md","path":"tools/translation/fixtures/fail-link/localized.md","rawUrl":"https://raw.githubusercontent.com/datawhalechina/easy-vibe/HEAD/tools/translation/fixtures/fail-link/localized.md","title":"Fail-link Skill","category":"anthropic-skill","format":"markdown","content":"# Fail-link Skill\n\nPath: `tools/translation/fixtures/fail-link/localized.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/datawhalechina/easy-vibe/HEAD/tools/translation/fixtures/fail-link/localized.md)","tokens":300,"sizeBytes":221},{"name":"source.md","path":"tools/translation/fixtures/fail-link/source.md","rawUrl":"https://raw.githubusercontent.com/datawhalechina/easy-vibe/HEAD/tools/translation/fixtures/fail-link/source.md","title":"Fail-link Skill","category":"anthropic-skill","format":"markdown","content":"# Fail-link Skill\n\nPath: `tools/translation/fixtures/fail-link/source.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/datawhalechina/easy-vibe/HEAD/tools/translation/fixtures/fail-link/source.md)","tokens":300,"sizeBytes":215},{"name":"localized.md","path":"tools/translation/fixtures/fail-source-locale/docs/ko-kr/localized.md","rawUrl":"https://raw.githubusercontent.com/datawhalechina/easy-vibe/HEAD/tools/translation/fixtures/fail-source-locale/docs/ko-kr/localized.md","title":"Ko-kr Skill","category":"anthropic-skill","format":"markdown","content":"# Ko-kr Skill\n\nPath: `tools/translation/fixtures/fail-source-locale/docs/ko-kr/localized.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/datawhalechina/easy-vibe/HEAD/tools/translation/fixtures/fail-source-locale/docs/ko-kr/localized.md)","tokens":300,"sizeBytes":257},{"name":"source.md","path":"tools/translation/fixtures/fail-source-locale/docs/zh-cn/source.md","rawUrl":"https://raw.githubusercontent.com/datawhalechina/easy-vibe/HEAD/tools/translation/fixtures/fail-source-locale/docs/zh-cn/source.md","title":"Zh-cn Skill","category":"anthropic-skill","format":"markdown","content":"# Zh-cn Skill\n\nPath: `tools/translation/fixtures/fail-source-locale/docs/zh-cn/source.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/datawhalechina/easy-vibe/HEAD/tools/translation/fixtures/fail-source-locale/docs/zh-cn/source.md)","tokens":300,"sizeBytes":251},{"name":"localized.md","path":"tools/translation/fixtures/fail-source-text/localized.md","rawUrl":"https://raw.githubusercontent.com/datawhalechina/easy-vibe/HEAD/tools/translation/fixtures/fail-source-text/localized.md","title":"Fail-source-text Skill","category":"anthropic-skill","format":"markdown","content":"# Fail-source-text Skill\n\nPath: `tools/translation/fixtures/fail-source-text/localized.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/datawhalechina/easy-vibe/HEAD/tools/translation/fixtures/fail-source-text/localized.md)","tokens":300,"sizeBytes":242},{"name":"source.md","path":"tools/translation/fixtures/fail-source-text/source.md","rawUrl":"https://raw.githubusercontent.com/datawhalechina/easy-vibe/HEAD/tools/translation/fixtures/fail-source-text/source.md","title":"Fail-source-text Skill","category":"anthropic-skill","format":"markdown","content":"# Fail-source-text Skill\n\nPath: `tools/translation/fixtures/fail-source-text/source.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/datawhalechina/easy-vibe/HEAD/tools/translation/fixtures/fail-source-text/source.md)","tokens":300,"sizeBytes":236},{"name":"localized.md","path":"tools/translation/fixtures/fail-structure/localized.md","rawUrl":"https://raw.githubusercontent.com/datawhalechina/easy-vibe/HEAD/tools/translation/fixtures/fail-structure/localized.md","title":"Fail-structure Skill","category":"anthropic-skill","format":"markdown","content":"# Fail-structure Skill\n\nPath: `tools/translation/fixtures/fail-structure/localized.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/datawhalechina/easy-vibe/HEAD/tools/translation/fixtures/fail-structure/localized.md)","tokens":300,"sizeBytes":236},{"name":"source.md","path":"tools/translation/fixtures/fail-structure/source.md","rawUrl":"https://raw.githubusercontent.com/datawhalechina/easy-vibe/HEAD/tools/translation/fixtures/fail-structure/source.md","title":"Fail-structure Skill","category":"anthropic-skill","format":"markdown","content":"# Fail-structure Skill\n\nPath: `tools/translation/fixtures/fail-structure/source.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/datawhalechina/easy-vibe/HEAD/tools/translation/fixtures/fail-structure/source.md)","tokens":300,"sizeBytes":230},{"name":"localized.md","path":"tools/translation/fixtures/pass-glossary-annotation/docs/ko-kr/localized.md","rawUrl":"https://raw.githubusercontent.com/datawhalechina/easy-vibe/HEAD/tools/translation/fixtures/pass-glossary-annotation/docs/ko-kr/localized.md","title":"Ko-kr Skill","category":"anthropic-skill","format":"markdown","content":"# Ko-kr Skill\n\nPath: `tools/translation/fixtures/pass-glossary-annotation/docs/ko-kr/localized.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/datawhalechina/easy-vibe/HEAD/tools/translation/fixtures/pass-glossary-annotation/docs/ko-kr/localized.md)","tokens":300,"sizeBytes":269},{"name":"source.md","path":"tools/translation/fixtures/pass-glossary-annotation/docs/zh-cn/source.md","rawUrl":"https://raw.githubusercontent.com/datawhalechina/easy-vibe/HEAD/tools/translation/fixtures/pass-glossary-annotation/docs/zh-cn/source.md","title":"Zh-cn Skill","category":"anthropic-skill","format":"markdown","content":"# Zh-cn Skill\n\nPath: `tools/translation/fixtures/pass-glossary-annotation/docs/zh-cn/source.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/datawhalechina/easy-vibe/HEAD/tools/translation/fixtures/pass-glossary-annotation/docs/zh-cn/source.md)","tokens":300,"sizeBytes":263},{"name":"localized.md","path":"tools/translation/fixtures/pass/localized.md","rawUrl":"https://raw.githubusercontent.com/datawhalechina/easy-vibe/HEAD/tools/translation/fixtures/pass/localized.md","title":"Pass Skill","category":"anthropic-skill","format":"markdown","content":"# Pass Skill\n\nPath: `tools/translation/fixtures/pass/localized.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/datawhalechina/easy-vibe/HEAD/tools/translation/fixtures/pass/localized.md)","tokens":300,"sizeBytes":206},{"name":"source.md","path":"tools/translation/fixtures/pass/source.md","rawUrl":"https://raw.githubusercontent.com/datawhalechina/easy-vibe/HEAD/tools/translation/fixtures/pass/source.md","title":"Pass Skill","category":"anthropic-skill","format":"markdown","content":"# Pass Skill\n\nPath: `tools/translation/fixtures/pass/source.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/datawhalechina/easy-vibe/HEAD/tools/translation/fixtures/pass/source.md)","tokens":300,"sizeBytes":200},{"name":"glossary.md","path":"tools/translation/ko-kr/glossary.md","rawUrl":"https://raw.githubusercontent.com/datawhalechina/easy-vibe/HEAD/tools/translation/ko-kr/glossary.md","title":"Ko-kr Skill","category":"anthropic-skill","format":"markdown","content":"# 번역 용어집 (Translation Glossary)\n\n> stage-1 zh↔ko 정렬로 시드. 새 용어는 번역 PR에서 논의한 뒤 승인 시 편입.\n\n## 원칙\n- 아래 표준 용어를 무조건 사용한다. 같은 개념을 다른 단어로 번역하지 않는다.\n- \"원문유지\"는 번역하지 않는다. \"외래어표기\"는 정해진 한글 표기를 쓴다.\n- 금지어가 떠오르면 표준 용어로 치환한다.\n- **업계 표준어는 웬만하면 영문 유지**: 한국어로 옮겼을 때 어색하거나 의미가 애매해지는 업계 표준 용어(text-to-image, image-to-image 등)는 **영문 그대로** 둔다. 억지 음차·직역(문생도, 텍스트→이미지 등)은 금지.\n\n## 용어 표\n\n| 中文 | 한국어 표준 | 영어 유지 여부 | 금지어 |\n|------|------------|--------------|--------|\n| VS Code / Visual Studio Code | VS Code / Visual Studio Code | 원문유지 | 비주얼 스튜디오 코드 |\n| Trae | Trae | 원문유지 | 트레이 |\n| Cursor | Cursor | 원문유지 | 커서 |\n| z.ai | z.ai | 원문유지 | - |\n| Figma / Figma Make | Figma / Figma Make | 원문유지 | 피그마 |\n| GitHub | GitHub | 원문유지 | 깃허브 |\n| DeepSeek | DeepSeek | 원문유지 | 딥시크 |\n| MiniMax | MiniMax | 원문유지 | 미니맥스 |\n| SiliconFlow / 硅基流动 | SiliconFlow | 원문유지 | 실리콘플로우, 실리콘 베이스드 플로우 |\n| 通义千问 | Tongyi Qianwen | 원문유지 | 퉁이첸원, 통의천문 |\n| 字节跳动 | ByteDance | 원문유지 | 바이트댄스 |\n| 阿里巴巴 / 阿里云 | Alibaba / Alibaba Cloud | 원문유지 | 알리바바, 알리바바 클라우드 |\n| 腾讯云 | Tencent Cloud | 원문유지 | 텐센트 클라우드 |\n| 智谱 / 智谱 AI | Zhipu / Zhipu AI | 원문유지 | 즈푸, 지푸 AI |\n| 火山引擎 | Volcengine | 원문유지 | 볼케이노 엔진, 화산엔진 |\n| 抖音 | Douyin | 원문유지 | 더우인, 틱톡 |\n| 小红书 | 샤오훙슈 | 외래어표기 | 샤오홍슈, 레드 |\n| 美菜网 | Meicai | 원문유지 | 메이차이 |\n| Builder / Chat / SOLO 模式 | Builder / Chat / SOLO 모드 | 원문유지(+모드) | 빌더 모드 |\n| Agent / 智能体 | 에이전트 | 외래어표기 | 상담원, 대리인, 지능체 |\n| 大语言模型 (LLM) | 대형 언어 모델 (LLM) | 번역(약어 유지) | 대규모 언어 모델, 거대 언어 모델 |\n| 视觉语言模型 (VLM) / 多模态 | 비전 언어 모델 (VLM) / 멀티모달 | 번역(약어 유지) | 시각 언어 모델, 비주얼 언어 모델, 다중모달 |\n| 模型 | 모델 | 외래어표기 | 모형 |\n| 提示词 | 프롬프트 | 외래어표기 | 프롬프트어, 지시어, 명령어 |\n| 上下文 / 上下文窗口 | 컨텍스트 / 컨텍스트 창 | 외래어표기 | 문맥, 맥락(UI 한정), 컨텍스트 윈도우 |\n| token | tokens / 토큰 | 외래어표기 | - |\n| API / API Key | API / API Key | 원문유지 | 에이피아이, API 키(혼용 금지) |\n| 接口 | API (통신 맥락) / 인터페이스 (화면 맥락) | 번역 | 접속, 연결부 |\n| Endpoint / 接口路径 | Endpoint (인터페이스 경로) | 원문유지 | 엔드포인트, 종단점 |\n| 密钥 | 비밀키 | 번역 | 시크릿키, 암호키 |\n| OpenAI 兼容接口 | OpenAI 호환 인터페이스 | 원문유지(OpenAI) | 오픈AI 호환 |\n| 多轮对话 | 다중 턴 대화 | 번역 | 멀티턴 대화, 여러 차례 대화 |\n| MCP | MCP | 원문유지 | - |\n| IDE / AI IDE | IDE / AI IDE | 원문유지 | 통합개발환경(단독 사용 금지) |\n| 集成开发环境 | 통합 개발 환경 | 번역 | 통합개발환경(붙여쓰기) |\n| 终端 / 命令行 | 터미널 / 명령줄 | 외래어표기/번역 | 콘솔(터미널 의미 시), 커맨드라인 |\n| 编辑器 | 편집기 | 번역 | 에디터 |\n| 调试 | 디버깅 | 외래어표기 | 디버그(명사형 혼용), 오류수정 |\n| 断点 | 중단점 | 번역 | 브레이크포인트, 정지점 |\n| 部署 | 배포 | 번역 | 디플로이, 전개 |\n| 仓库 / 仓库(Repo) | 저장소 (Repository / Repo) | 번역(+원문) | 리포지토리, 레포 |\n| 提交 (Commit) | 커밋 (Commit) | 외래어표기 | 제출, 커밋하기(명사 혼용) |\n| 分支 | 브랜치 | 외래어표기 | 가지, 분기 |\n| 框架 | 프레임워크 | 외래어표기 | 골격, 틀 |\n| 组件 | 컴포넌트 | 외래어표기 | 구성요소, 부품 |\n| 模块 | 모듈 | 외래어표기 | 단위 |\n| 变量 | 변수 | 번역 | 베리어블 |\n| 函数 | 함수 | 번역 | 펑션 |\n| 状态 (State) | 상태 (State) | 번역 | 스테이트 |\n| 标识符 | 식별자 | 번역 | 아이덴티파이어 |\n| 语法 | 문법 | 번역 | 신택스, 구문 |\n| 前端 / 后端 | 프론트엔드 / 백엔드 | 외래어표기 | 앞단/뒷단, 프런트엔드 |\n| 请求 / 响应 | 요청 / 응답 | 번역 | 리퀘스트/리스폰스 |\n| 服务 / 服务器 | 서비스 / 서버 | 외래어표기 | 섭, 봉사 |\n| 端口 | 포트 | 외래어표기 | 포트번호(불필요 시) |\n| 本地 / localhost | 로컬 / localhost | 외래어표기/원문 | 현지, 본지 |\n| 浏览器 | 브라우저 | 외래어표기 | 웹브라우저(불필요 시) |\n| 开发者工具 (DevTools) | 개발자 도구 (DevTools) | 번역(+원문) | 개발툴, 데브툴 |\n| 刷新 | 새로고침 | 번역 | 리프레시, 갱신 |\n| 插件 | 플러그인 | 외래어표기 | 확장프로그램(extension과 구분), 애드온 |\n| 依赖 | 의존성 | 번역 | 디펜던시 |\n| 开源 | 오픈소스 | 외래어표기 | 공개소스, 오픈 소스(띄어쓰기) |\n| 用户 | 사용자 | 번역 | 유저, 고객, 이용자 |\n| 需求 | 요구 / 요구사항 | 번역 | 니즈, 수요, 디맨드 |\n| 痛点 | 문제점 (痛点, Pain Point) | 번역 | 페인포인트, 아픈점, 고충점 |\n| 爽点 | 만족점 (Delight Point) | 번역 | 쾌감점, 딜라이트 |\n| 痒点 | 가려운 지점 (Itch Point) | 번역 | 가려움점, 잇치포인트 |\n| 留存 / 7日留存 | 유지율 / 7일 유지율 | 번역 | 잔존율, 리텐션 |\n| 护城河 | 해자 | 번역 | 모트, 진입장벽(별개 개념) |\n| 客单价 | 객단가 | 번역 | 고객단가, 1인당 단가 |\n| 复盘 | 되짚어 보기 / 복기 | 번역 | 리뷰, 회고(별개 뉘앙스) |\n| 迭代 | 반복 개선 / 반복 | 번역 | 이터레이션, 순회 |\n| 原型 | 프로토타입 | 외래어표기 | 시제품, 원형 |\n| 产品经理 | 제품 관리자 | 번역 | PM, 프로덕트 매니저, 기획자 |\n| 业务 | 비즈니스 | 외래어표기 | 업무(맥락 구분 필요), 사업 |\n| 公众号 | 공식 계정 | 번역 | 공중하오, 퍼블릭 어카운트 |\n| 网盘 | 클라우드 드라이브 | 번역 | 넷디스크, 웹하드 |\n| 看板 | 칸반 | 외래어표기 | 간판, 보드 |\n| 后台 | 백오피스 | 외래어표기 | 후방, 관리자페이지(혼용 주의) |\n| 上架 | 등록 / 게시 | 번역 | 상가, 진열, 업로드 |\n| 卖点 | 판매 포인트 | 번역 | 셀링포인트, 강점 |\n| 文案 | 문구 | 번역 | 카피, 글귀 |\n| 白底图 | 흰 배경 이미지 | 번역 | 백색배경도, 누끼 |\n| 业务方 | 비즈니스 담당자 | 번역 | 업무측, 비즈니스측 |\n| 运营 | 운영 (담당자) | 번역 | 오퍼레이션, 운용 |\n| 文生图 | text-to-image | 원문유지 | 텍스트-이미지, 텍스트→이미지, 문생도, 텍스트투이미지 |\n| 图生图 | image-to-image | 원문유지 | 이미지-이미지, 이미지→이미지, 도생도 |\n| 环节 | 단계 | 번역 | 환경(环节 의미일 때 오역) |\n| 素材 / 物料 | 소재 | 번역 | 머티리얼, 자재 |\n| 配图 | 삽화 | 번역 | 배치 이미지 |\n| 表情包 | 이모티콘 | 외래어표기 | 짤, 스티커, 밈 |\n| 母版 | 원본 / 참고 원본 | 번역 | 마스터, 모판 |\n\n## 고유명사 병기 (첫 등장 시 설명)\n\n> 한국 독자가 이름만으로는 모를 회사·서비스·플랫폼. **챕터당 첫 등장 시에만** `첫 등장 표기`를 그대로 쓰고, 이후엔 `이후 표기`만. (규칙서 7번)\n> 설명은 웹 검증 완료(2026-05). 중국 기업은 `中` 표기. 비중국은 출처국 명시.\n>\n> **상시 규칙**: 번역 중 이 표에 없는 새 고유명사(중국 회사·서비스·플랫폼 등 한국 독자에게 생소한 것)가 나오면 임의 설명을 만들지 않습니다. 신뢰할 수 있는 출처로 검증한 표기와 설명을 번역 PR에서 함께 제안합니다.\n\n| 원문 | 첫 등장 표기 | 이후 표기 |\n|------|------------|----------|\n| Trae | Trae(中 ByteDance의 AI 코딩 IDE) | Trae |\n| z.ai | z.ai(中 Zhipu AI의 코딩 모델·플랫폼) | z.ai |\n| DeepSeek | DeepSeek(中 AI 모델 개발사) | DeepSeek |\n| MiniMax | MiniMax(中 생성형 AI 회사) | MiniMax |\n| SiliconFlow / 硅基流动 | SiliconFlow(中 AI 모델 추론·호스팅 플랫폼) | SiliconFlow |\n| 通义千问 / Tongyi Qianwen | Tongyi Qianwen(中 Alibaba의 LLM, 현 Qwen) | Tongyi Qianwen |\n| 字节跳动 / ByteDance | ByteDance(中 IT 대기업, 틱톡·더우인 운영사) | ByteDance |\n| 阿里云 / Alibaba Cloud | Alibaba Cloud(中 알리바바의 클라우드) | Alibaba Cloud |\n| 腾讯云 / Tencent Cloud | Tencent Cloud(中 텐센트의 클라우드) | Tencent Cloud |\n| 智谱 / Zhipu AI | Zhipu AI(中 AI 모델 회사, GLM 개발) | Zhipu AI |\n| 火山引擎 / Volcengine | Volcengine(中 ByteDance의 클라우드 플랫폼) | Volcengine |\n| 抖音 / Douyin | Douyin(중국판 틱톡, 숏폼 앱) | Douyin |\n| 美菜网 / Meicai | Meicai(中 식자재 B2B 이커머스) | Meicai |\n| 小红书 | 샤오훙슈(中 라이프스타일 SNS·쇼핑 앱) | 샤오훙슈 |\n| MasterGo | MasterGo(中 웹 기반 UI 디자인 협업 도구) | MasterGo |\n| Lovart | Lovart(美 샌프란시스코의 AI 디자인 에이전트) | Lovart |\n| Nano Banana | Nano Banana(Google의 AI 이미지 생성 모델) | Nano Banana |\n| Dify | Dify(오픈소스 LLM 앱 개발 플랫폼) | Dify |\n| Zeabur | Zeabur(대만의 앱 배포 클라우드 플랫폼) | Zeabur |\n| 豆包 / Doubao | Doubao(中 ByteDance의 AI 챗봇) | Doubao |\n\n## 카테고리 메모\n- **痛点 3종 세트(痛点/爽点/痒点)**: stage-1 finding-great-idea에서 \"문제점 / 만족점 / 가려운 지점\"으로 일관 번역, 괄호로 원어(Pain/Delight/Itch Point) 병기. 일반 문맥의 \"痛点\"도 \"문제점\"으로 통일.\n- **Agent / 智能体**: **\"에이전트\"로 통일 확정**(2026-05). 표준=에이전트, 금지어=상담원·대리인·지능체. stage-2 index·사이드바의 기존 \"에이전트\" 표기 그대로 유지. (stage-1의 \"Agent(지능체)\" 표기는 향후 재방문 시 정합화 대상)\n- **接口의 이중성 (확정)**: 통신/API 맥락 → \"API\", 화면/UI 맥락 → \"인터페이스\"로 구분 적용.\n- **중국 고유명사 표기 혼재**: 대부분 영문 원문 유지(ByteDance 등), \"小红书\"만 음차(샤오훙슈). 인명도 로마자(梁文锋→Liang Wenfeng). 정책 확정은 candidates 참고.\n","isInternal":false,"tokens":4818,"sizeBytes":10959},{"name":"style-guide.md","path":"tools/translation/ko-kr/style-guide.md","rawUrl":"https://raw.githubusercontent.com/datawhalechina/easy-vibe/HEAD/tools/translation/ko-kr/style-guide.md","title":"Ko-kr Skill","category":"anthropic-skill","format":"markdown","content":"# 한국어 자연스러움 가이드 (DO / DON'T)\n\n> 사람이 **직접 검수하며 고친 실제 수정**에서 뽑은 직역투→자연스러운 표현 규칙입니다.\n> glossary.md가 **단어** 룰이라면, 이 파일은 **문형·표현** 룰입니다. 한국어 번역 기여자는 번역 전에 읽고 적용합니다.\n\n## 정착 패턴 (필독 · 매 번역에 적용)\n\n| # | 유형 | ❌ DON'T (직역투) | ✅ DO (자연스러운 한국어) | 근거 |\n|---|------|------------------|--------------------------|------|\n| S1 | 접속 구조 `并不是 A 而是 B` | \"~이 아닙니다. 바로 ~것입니다\" (문장 끊김) | \"~이 아니라 ~것입니다\" (한 흐름) | lovart §4 |\n| S2 | 명사 종결 직역 | \"…라는 감각입니다.\" (앞 문장과 끊겨 붕 뜸) | \"…라는 감각 말입니다.\" (앞에 연결) | lovart §4 |\n| S3 | `当 … 时` 직역 | \"입력이 ~가 되면\" (피동·번역체) | \"~를 입력하면\" (능동) | lovart §3 |\n| S4 | 외래어 남발 | 文章 → \"아티클\" | \"글 / 한 편의 글\" | lovart §3 |\n| S5 | `缺乏 … 能力` 직역 | \"~능력이 부족한 결과로 이어집니다\" | \"~을 못 합니다 / 아우르지 못합니다\" | lovart §3 |\n\n## 일반 원칙 (위 패턴의 바탕)\n- **끊지 말 것**: 원문이 한 호흡(`并不是…而是`, `虽然…但是` 등)이면 한국어도 한 문장으로 잇는다. 마침표로 끊어 명사문이 붕 뜨게 두지 않는다.\n- **능동·서술 우선**: \"~가 되면/~되는 것이다\" 같은 번역체보다 \"~하면/~한다\"로.\n- **외래어는 정착된 것만**: 정착 외래어(프롬프트·컨텍스트 등, glossary 참조)는 쓰되, 굳이 음차할 필요 없는 일반어(文章=글)는 한국어로.\n- **직역 명사구 풀기**: \"~능력이 부족한 결과로 이어진다\" → \"~을 못 한다\"처럼 동사로 푼다.\n","isInternal":false,"tokens":773,"sizeBytes":1866},{"name":"CLAUDE.md","path":"CLAUDE.md","rawUrl":"https://raw.githubusercontent.com/datawhalechina/easy-vibe/HEAD/CLAUDE.md","title":"Claude Agent Guidelines & System Prompt","category":"claude-rule","format":"markdown","content":"# CLAUDE.md\n\nThis file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.\n\n## Project Overview\n\n**Easy-Vibe** is an educational curriculum for learning AI Vibe Coding from zero to advanced levels. It's a documentation-based project using **VitePress** to serve educational content about AI-assisted software development.\n\nThe curriculum follows a progressive four-stage structure:\n\n- **Stage 0 (幼儿园)**: Introduction to AI programming through games\n- **Stage 1 (AI 产品经理)**: Building AI-powered web application prototypes\n- **Stage 2 (初中级开发工程师)**: Full-stack development with databases and deployment\n- **Stage 3 (高级开发工程师)**: Cross-platform development (WeChat mini-programs, Android apps, MCP)\n\n## Development Commands\n\n### Start Local Documentation Server\n\n```bash\nnpm install      # Install dependencies (first time only)\nnpm run dev      # Start VitePress dev server\n```\n\nThe documentation will be available at `http://localhost:5173` (VitePress default port)\n\n### Build/Run Commands\n\n- `npm run dev` - Start VitePress development server with hot reload\n- `npm run build` - Build static site for production (outputs to `docs/.vitepress/dist`)\n- `npm run preview` - Preview production build locally\n- `npm run format` - Format code using Prettier\n\n### Node Version Requirement\n\n- Node.js >= 18.0.0 required (specified in package.json `engines`)\n\n## Project Architecture\n\n### VitePress Base Path Configuration\n\nThe site automatically configures its base path based on the deployment environment:\n\n- **Vercel**: Uses `/` as base (detected via `VERCEL` environment variable)\n- **GitHub Pages / Local**: Uses `/easy-vibe/` as base\n\nThis logic is in `docs/.vitepress/config.mjs:3-5`. When linking assets or configuring paths, the `${base}` variable is used to ensure compatibility across environments.\n\n### Directory Structure\n\n```\neasy-vibe/\n├── docs/                        # Main documentation content (served by VitePress)\n│   ├── .vitepress/             # VitePress configuration and theme\n│   │   ├── config.mjs          # Site configuration (nav, sidebar, plugins)\n│   │   ├── theme/              # Custom theme extensions\n│   │   │   ├── Layout.vue      # Override default layout with typewriter effect\n│   │   │   ├── index.js        # Theme setup (Viewer.js, TypeIt, image optimization)\n│   │   │   └── style.css       # Custom CSS overrides\n│   │   ├── dist/               # Production build output (generated)\n│   │   └── cache/              # VitePress cache (generated)\n│   ├── index.md                # Homepage\n│   ├── public/                 # Static assets (logo.png, etc.)\n│   ├── assets/                 # Symlink to ../assets\n│   ├── stage-1/                # Stage 1 content (AI 产品经理)\n│   ├── stage-2/                # Stage 2 content (初中级开发工程师)\n│   ├── stage-3/                # Stage 3 content (高级开发工程师)\n│   ├── appendix/               # Reference materials (AI capability dictionary)\n│   ├── examples/               # Practical examples and tutorials (legacy)\n│   ├── extra/                  # Additional knowledge (Git, API, RAG, etc.)\n│   ├── guide/                  # Course guide\n│   └── project/                # Legacy project documentation\n├── assets/                     # Images and static assets\n├── package.json                # Project dependencies and scripts\n├── vercel.json                 # Vercel deployment configuration\n└── README.md                   # Project overview and contribution guide\n```\n\n### Content Organization\n\nEach stage follows a numbered chapter structure:\n\n```\nstage-{N}/\n└── {category or chapter-dir}/\n    └── index.md          # Main content file (or .md file directly)\n```\n\nExamples:\n\n- `stage-1/introduction-to-ai-ide/index.md`\n- `stage-2/backend/what-is-api/extra2/extra2-what-is-api.md`\n\n**Note**: Content files may use either `index.md` or direct `.md` files depending on the chapter structure.\n\n### Documentation System (VitePress)\n\nThe project uses **VitePress 2.0.0-alpha.15** with these key features:\n\n**Configuration** (`docs/.vitepress/config.mjs`):\n\n- **Single Sidebar**: Route-based sidebars configured per path prefix (`/stage-1/`, etc.)\n- **Navigation**: Top nav with links to each stage and appendix\n- **Search**: Local search via `minisearch` (no external API required)\n- **Dark Mode**: Built-in VitePress theme with toggle\n\n**Custom Theme** (`docs/.vitepress/theme/`):\n\n- **Image Viewer**: Viewer.js integration for zoom/rotate/flip on all images\n- **Typewriter Effect**: TypeIt.js for homepage hero tagline animation\n- **Image Optimization**: Automatic image height classes based on aspect ratio\n- **Custom Layout**: Extends default theme with `Layout.vue` override\n- **Reading Settings**: Element Plus popover panel for adjusting font size (12-18px) and line height (1.25-1.8) with localStorage persistence\n\n**Key Theme Behaviors**:\n\n- Images with aspect ratio > 1.2 get height-limited classes (tall/very-tall/ultra-tall)\n- Viewer.js initialized on `.vp-doc` container on each route change\n- Typewriter effect only activates on homepage when `frontmatter.hero.tagline` is an array\n- Font size/line height adjustments use CSS custom properties `--ev-doc-font-size` and `--ev-doc-line-height`\n- Reading settings panel appears in nav bar after the search/home buttons (gear icon)\n\n### Sidebar Management\n\nThe sidebar is defined in `docs/.vitepress/config.mjs`. When adding new chapters:\n\n1. Locate the appropriate route prefix section (`/stage-1/`, etc.)\n2. Add a new object with `text` (display name) and `link` (relative path)\n3. For nested items, use `items` array with `collapsed: true|false`\n4. **Links should not include `.md` extension** - VitePress handles this\n5. Links should not include `index` - use directory path with trailing slash\n\nExample pattern:\n\n```javascript\n{\n  text: 'Chapter Title',\n  link: '/stage-1/chapter-directory/'  // Note: trailing slash, no .md\n}\n```\n\n### Asset Management\n\n- Root-level static assets are in `/assets/` at project root\n- Public files (favicon, logo) go in `docs/public/`\n- Images are referenced with relative paths from markdown file location\n- VitePress serves `docs/assets` as symlink to `../assets`\n- Image optimization is automatic via theme (height-limited classes based on aspect ratio)\n\n### Deployment\n\n**Vercel** (vercel.json):\n\n- Build command: `npm run build`\n- Output directory: `docs/.vitepress/dist`\n- Framework: vitepress\n\n**Preview Production Build**:\n\n```bash\nnpm run build\nnpm run preview  # Preview built site locally\n```\n\n### Legacy Content Structure\n\nThe project maintains three legacy sections for backward compatibility:\n\n1. **Project 文档** (`project/`): Older chapter-based tutorials (migrated to Stage 2)\n2. **Extra 扩展知识** (`extra/`): Supplementary topics - Git, APIs, RAG, deployment (migrated to Stage 2/3)\n3. **Examples 实战案例** (`examples/`): Practical tutorials (migrated to Stage 0/3)\n\nWhen updating content, prefer integrating into the stage structure over adding to legacy sections.\n\n## Content Guidelines\n\n### Writing New Chapters\n\n1. Create directory: `docs/stage-{N}/{chapter-directory}/`\n2. Create `index.md` or direct `.md` file with chapter content\n3. Update `docs/.vitepress/config.mjs` sidebar with the new entry\n4. Follow Chinese language conventions (this is a Chinese curriculum)\n\n### Content Status Markers\n\nIn README.md, use these status indicators:\n\n- ✅ Completed\n- 🚧 In progress/Under construction\n\n### File Naming Conventions\n\n- Use kebab-case for directories: `1.1-introduction-to-ai-ide`, `frontend`, `backend`\n- Content can be either `index.md` in a directory or a direct `.md` file\n- Images use descriptive names; can be in chapter subdirectories or root `/assets/`\n\n### Code Formatting\n\nPrettier configuration (`.prettierrc`):\n\n- No semicolons (`semi: false`)\n- Single quotes (`singleQuote: true`)\n- No trailing commas (`trailingComma: \"none\"`)\n\nRun `npm run format` before committing code changes.\n\n## Interactive Vue Components\n\n### Component Registration\n\nAll interactive Vue components for the documentation are registered in `docs/.vitepress/theme/index.js`. To add a new component:\n\n1. Create the `.vue` file in the appropriate subdirectory of `docs/.vitepress/theme/components/`\n2. Import the component in `docs/.vitepress/theme/index.js`\n3. Register the component using `app.component('ComponentName', ComponentName)` in the `enhanceApp` function\n\n### Component Categories\n\nComponents are organized by topic:\n\n- `appendix/llm-intro/` - Large Language Model interactive demos\n- `appendix/vlm-intro/` - Vision Language Model interactive demos\n- `appendix/git-intro/` - Git workflow visualizations\n- `appendix/terminal-intro/` - Terminal/CLI interactive demos\n- `appendix/web-basics/` - HTML/CSS/JavaScript fundamentals\n- `appendix/auth-design/` - Authentication/authorization demos\n- `appendix/cache-design/` - Caching strategy visualizations\n- `appendix/database-intro/` - Database fundamentals\n- `appendix/queue-design/` - Message queue demos\n- `appendix/operations/` - DevOps/monitoring demos\n- `appendix/deployment/` - Deployment architecture demos\n- `appendix/frontend-performance/` - Frontend performance demos\n- `appendix/frontend-evolution/` - Frontend history/evolution demos\n- `appendix/backend-evolution/` - Backend architecture evolution\n- `appendix/backend-languages/` - Backend language comparisons\n\n### Using Components in Markdown\n\nComponents can be used directly in markdown files:\n\n```markdown\n## LLM Basics\n\n<LLMQuickStartDemo />\n\n### Tokenization\n\n<TokenizationDemo />\n```\n\n### Component Development Best Practices\n\n1. **Props**: Use props for configurable demo parameters\n2. **Styling**: Use scoped CSS or Tailwind-like utility classes\n3. **Responsiveness**: Ensure components work on mobile and desktop\n4. **Accessibility**: Include aria labels where appropriate\n5. **i18n**: Keep text content minimal or use props for text\n\n## Multi-language Support\n\n### Supported Locales\n\nThe project supports 13 languages:\n\n- `zh-cn` - Simplified Chinese (primary)\n- `zh-tw` - Traditional Chinese\n- `en-us` - English (US)\n- `ja-jp` - Japanese\n- `ko-kr` - Korean\n- `es-es` - Spanish\n- `fr-fr` - French\n- `de-de` - German\n- `ar-sa` - Arabic\n- `vi-vn` - Vietnamese\n\n### Adding Multi-language Content\n\n1. Create content in `docs/{locale}/` following the same structure as `docs/zh-cn/`\n2. Add locale configuration in `docs/.vitepress/config.mjs` under `locales`\n3. Copy the sidebar structure from `zh-cn` and translate the text values\n\n### Content Translation Priority\n\n1. **Primary**: `zh-cn` (Simplified Chinese) - always complete this first\n2. **Secondary**: `en-us` (English) - for international reach\n3. **Tertiary**: Other languages based on contributor availability\n\n## Permissions\n\nThe project has configured bash permissions in `.claude/settings.local.json`:\n\n- File operations: `which`, `find`, `mv`, `tree`, `cat`, `curl`, `lsof`, `mkdir`, `cp`, `ls`\n- Process management: `xargs ps`, `kill`\n- Development: `npm run dev`, `npm run build`, `npm run preview`, `npm run format`\n\n## Key Context for Development\n\n- **Educational Focus**: This is curriculum content, not application code\n- **Target Audience**: Beginners to advanced developers learning AI-assisted programming\n- **Language**: Primary content is in Chinese\n- **Build Pipeline**: VitePress requires build step for production (`npm run build`)\n- **Git Workflow**: Content changes should preserve formatting and structure\n- **Asset Paths**: Always use relative paths from markdown file location\n\nWhen making changes:\n\n- Preserve the VitePress configuration in `docs/.vitepress/config.mjs`\n- Maintain sidebar structure consistency in config.mjs\n- Test locally with `npm run dev` before committing\n- Check that image links work correctly\n- Ensure theme customizations in `.vitepress/theme/` are not broken\n- Run `npm run format` before committing code changes (uses Prettier: no semicolons, single quotes)\n","isInternal":false,"tokens":2901,"sizeBytes":12222},{"name":"README.md","path":"tools/translation/README.md","rawUrl":"https://raw.githubusercontent.com/datawhalechina/easy-vibe/HEAD/tools/translation/README.md","title":"translation Documentation","category":"plugin-manifest","format":"markdown","content":"# Localization checks\n\nThis directory contains tool-agnostic guidance and deterministic checks for\nlocalized documentation. The checker does not translate content and does not\nuse an LLM.\n\n## Usage\n\n```bash\nnode tools/translation/check-localization.mjs \\\n  docs/zh-cn/path/to/index.md \\\n  docs/ko-kr/path/to/index.md\n```\n\nExit codes:\n\n- `0`: all checks passed\n- `1`: the localization failed one or more checks\n- `2`: invalid arguments or a missing input file\n\nThe checker compares:\n\n- frontmatter keys\n- heading levels, list items, and table rows\n- Markdown link and image counts, including local target existence\n- links that still point to the source locale\n- fenced code blocks\n- inline code\n- possible untranslated Chinese text\n\nIt intentionally does not judge meaning, fluency, or translation quality.\nThose require language review. Locale-specific contributor guidance lives in\nthe locale directory, for example `ko-kr/glossary.md` and\n`ko-kr/style-guide.md`.\n\nThe source-text residue check currently targets Chinese source text, which is\nthe source language used by this repository. Chinese text explicitly required\nin the target locale glossary's standard or first-appearance column is allowed.\n\n## Fixtures\n\nThe fixtures include one passing document pair and focused failures for each\ncheck: frontmatter, Markdown structure, links, images, fenced code blocks,\ninline code, source-locale links, and untranslated Chinese text. A separate\npassing fixture covers a source-language annotation required by the glossary.\nRun them with the built-in Node test runner:\n\n```bash\nnode --test tools/translation/check-localization.test.mjs\n```\n","isInternal":false,"tokens":350,"sizeBytes":1639}],"systemPromptSnippet":"<yakaai_skills repo=\"datawhalechina/easy-vibe\">\n<!-- File: AGENTS.md (Tokens: ~689 | Category: root-instruction) -->\n# Repository Guidelines\n\n## Project Structure & Module Organization\n\n- `docs/`: VitePress site source (Markdown content, sidebar/nav, assets referenced by docs).\n- `docs/.vitepress/theme/`: custom theme, global component registration in `index.js`, shared styles in `style.css`, layout in `Layout.vue`.\n- `docs/.vitepress/theme/components/appendix/*/`: interactive Vue demos used inside appendix pages (e.g. `web-basics/`, `deployment/`).\n- `assets/`: repo-level images/media (if referenced, prefer linking/copying into `docs/public/` or a doc-local folder when appropriate).\n- `scripts/`, `tools/`, `update_readmes.cjs`: utility scripts for maintaining docs.\n\n## Build, Test, and Development Commands\n\nThis repo is a VitePress (Vue 3) documentation project. Requires Node.js **>= 18**.\n\n```bash\nnpm install\nnpm run dev      # start local docs server (hot reload)\nnpm run build    # production build (use as CI-style check)\nnpm run preview  # preview the built site locally\nnpm run format   # run Prettier on the whole repo\n```\n\n## Coding Style & Naming Conventions\n\n- Formatting: Prettier (`npm run format`). Keep diffs small and avoid reformatting unrelated files.\n- Vue components: Vue 3 SFCs with `<script setup>`, PascalCase filenames (e.g. `SemanticTagsDemo.vue`).\n- CSS: prefer VitePress theme variables (`var(--vp-c-*)`) and keep components responsive (`@media (max-width: 720px)` when needed).\n- Docs: use clear headings and short paragraphs; components are referenced in Markdown as `<ComponentName />`.\n- Images: prefer WebP for screenshots. Convert existing PNG screenshots losslessly without cropping or resizing, preserving decoded pixels, transparency, and color profiles. For example: `cwebp -lossless -exact -m 6 -metadata all input.png -o input.webp`. Verify decoded pixel equality and browser rendering; keep the original PNG when the browser renders it differently. Inspect representative text-heavy crops at full size before committing.\n- When replacing an image, update references in every locale and remove the obsolete source after checking that nothing still references it. Avoid keeping both PNG and WebP copies of the same screenshot.\n- Measure image savings from the current tracked files; existing clones retain old image blobs in Git history. Run the production build and check rendered image URLs as well as Markdown links.\n\n## Testing Guidelines\n\nThere is no dedicated test framework in this repo. Use `npm run build` as the primary correctness check, and manually verify interactive components in `npm run dev`.\n\n## Commit & Pull Request Guidelines\n\n- Commits follow a Conventional Commits style seen in history: `feat: ...`, `fix: ...`, `docs: ...` (optionally scoped like `feat(docs): ...`).\n- PRs should include: a short description, screenshots/GIFs for UI or component changes, and any relevant paths touched (e.g. `docs/zh-cn/appendix/...`, `docs/.vitepress/theme/...`).\n\n## Configuration & Deployment Notes\n\n- `vercel.json` is present; keep builds reproducible and avoid relying on local-only assets.\n\n<!-- File: llms.txt (Tokens: ~17417 | Category: root-instruction) -->\n# Easy-Vibe 教程 - AI 导航\n\n> 🦞 **如果你是 AI Agent（如 OpenClaw、Claude、Cursor、Trae 内置 AI、GPT-4、Kimi、通义千问、文心一言等）**\n> \n> **请先阅读本文件**，了解本教程结构后再回答用户问题。本文件是你的「导航地图」，告诉你去哪里找答案。\n\n---\n\n## 🎯 高层级架构（先读我！）\n\n本教程采用 **3+1 阶段** 的渐进式学习路径，从完全零基础到高级开发：\n\n```\n┌─────────────────────────────────────────────────────────────┐\n│  Stage 1: 新手入门与产品原型 (stage-0/ + stage-1/)           │\n│  ├── 目标：建立编程思维，掌握 AI IDE，快速构建产品原型        │\n│  ├── 产出：互动小游戏、完整的产品原型                        │\n│  └── 关键词：零基础、入门、学习路线、贪吃蛇、Cursor、Claude、 │\n│             Trae、MVP、产品思维、AI 能力集成                  │\n├─────────────────────────────────────────────────────────────┤\n│  Stage 2: 初中级开发 (stage-2/)                              │\n│  ├── 目标：全栈开发能力，数据库、部署、支付                   │\n│  ├── 产出：可上线的全栈 AI 应用                              │\n│  └── 关键词：Dify、Supabase、Git、部署、Stripe、UI 设计       │\n├─────────────────────────────────────────────────────────────┤\n│  Stage 3: 高级开发 (stage-3/)                                │\n│  ├── 目标：跨平台开发，AI 进阶，Claude Code 深度使用          │\n│  ├── 产出：生产级多平台应用                                  │\n│  └── 关键词：MCP、RAG、微信小程序、Android、iOS、Electron     │\n├─────────────────────────────────────────────────────────────┤\n│  附录：知识体系 (appendix/)                                  │\n│  ├── 目标：计算机基础到工程素养的完整知识库                   │\n│  ├── 内容：9 大领域，80+ 交互式专题                          │\n│  └── 关键词：计算机基础、前端、后端、AI 原理、架构、运维       │\n└─────────────────────────────────────────────────────────────┘\n```\n\n### 快速决策树\n\n当用户提问时，按以下优先级定位：\n\n1. **问\"怎么开始/零基础/入门\"** → Stage 1 (stage-0/ 和 stage-1/)\n2. **问\"数据库/部署/全栈\"** → Stage 2\n3. **问\"MCP/小程序/跨平台/Claude Code 进阶\"** → Stage 3\n4. **问\"计算机基础/原理\"** → 附录\n\n---\n\n## 📂 目录结构速查\n\n```\ndocs/zh-cn/\n├── stage-0/                    # Stage 1 - 新手入门部分\n│   ├── 0.1-learning-map/       # 学习路线图\n│   └── 0.2-ai-capabilities-through-games/  # 贪吃蛇游戏\n├── stage-1/                    # Stage 1 - 产品原型部分\n│   ├── 1.0-finding-great-idea/ # 找到好创意\n│   ├── 1.1-introduction-to-ai-ide/         # AI IDE 入门\n│   ├── 1.2-building-prototype/ # 原型开发\n│   ├── 1.3-integrating-ai-capabilities/    # 接入 AI 能力\n│   ├── 1.4-complete-project-practice/      # 完整项目实战\n│   └── appendix-*/             # 产品思维、常见错误、场景附录\n├── stage-2/                    # 初中级开发\n│   ├── ai-capabilities/        # AI 能力 (Dify、多模态)\n│   ├── backend/                # 后端 (数据库、Git、部署、支付)\n│   ├── frontend/               # 前端 (Figma、UI、组件库)\n│   └── assignments/            # 作业\n├── stage-3/                    # 高级开发\n│   ├── core-skills/            # 核心技能 (Claude、MCP、Agent)\n│   ├── ai-advanced/            # AI 进阶 (RAG、LangGraph)\n│   ├── cross-platform/         # 跨平台 (小程序、App、桌面)\n│   └── personal-brand/         # 个人品牌\n└── appendix/                   # 附录知识体系\n    ├── 1-computer-fundamentals/    # 计算机基础\n    ├── 2-development-tools/        # 开发工具\n    ├── 3-browser-and-frontend/     # 浏览器与前端\n    ├── 4-server-and-backend/       # 服务器与后端\n    ├── 5-data/                     # 数据\n    ├── 6-architecture-and-system-design/  # 架构设计\n    ├── 7-infrastructure-and-operations/   # 运维\n    ├── 8-artificial-intelligence/  # 人工智能\n    └── 9-engineering-excellence/   # 工程卓越\n```\n\n---\n\n## 🔍 详细文章索引\n\n### Stage 1: 新手入门与产品原型（stage-0/ + stage-1/）\n\n#### 1.0 学习路线图\n**文件**: `docs/zh-cn/stage-0/0.1-learning-map/index.md`\n\n**关键词**: 入门、零基础、怎么开始、学习路线、学习路径、成长路径、职业规划、阶段划分、新手引导、教程介绍、课程概览、适合谁学、前置要求、学习顺序、从哪开始、第一步\n\n**内容概要**: 完整学习路线图，介绍学习路径和目标\n\n---\n\n#### 1.0 AI 能力体验 - 贪吃蛇游戏\n**文件**: `docs/zh-cn/stage-0/0.2-ai-capabilities-through-games/index.md`\n\n**关键词**: 贪吃蛇、游戏、第一个项目、零基础项目、入门实战、AI 编程初体验、小游戏开发、网页游戏、Canvas、JavaScript 游戏、游戏逻辑、键盘控制、碰撞检测、得分系统、游戏循环、requestAnimationFrame\n\n**内容概要**: 用 AI 辅助开发第一个贪吃蛇游戏，理解 AI 编程的基本流程\n\n---\n\n#### 1.1 找到好创意\n**文件**: `docs/zh-cn/stage-1/1.0-finding-great-idea/index.md`\n\n**关键词**: 创意、想法、Idea、产品创意、需求挖掘、用户痛点、市场调研、竞品分析、创新思维、 brainstorming、头脑风暴、产品定位、目标用户、价值主张、MVP 定义、最小可行产品\n\n**内容概要**: 如何找到有价值的产品创意，定义 MVP 范围\n\n---\n\n#### 1.2 AI IDE 入门\n**文件**: `docs/zh-cn/stage-1/1.1-introduction-to-ai-ide/index.md`\n\n**关键词**: Cursor、Claude、Trae、AI IDE、安装、配置、环境搭建、本地开发、IDE 选择、代码编辑器、AI 辅助编程、智能补全、代码生成、自然语言编程、Vibe Coding、提示词技巧、AI 对话、代码解释、代码重构\n\n**内容概要**: 主流 AI IDE 工具的安装配置和使用方法\n\n---\n\n#### 1.3 原型开发\n**文件**: `docs/zh-cn/stage-1/1.2-building-prototype/index.md`\n\n**关键词**: 原型、Demo、快速搭建、MVP、最小可行产品、产品原型、快速验证、低保真、高保真、原型工具、交互设计、用户流程、页面跳转、组件复用、响应式布局、移动端适配\n\n**内容概要**: 快速搭建产品原型，验证产品概念\n\n---\n\n#### 1.4 接入 AI 能力\n**文件**: `docs/zh-cn/stage-1/1.3-integrating-ai-capabilities/index.md`\n\n**关键词**: 接入 AI、API、大模型、AI 能力、LLM、OpenAI、Claude API、GPT、文本生成、聊天机器人、API Key、接口调用、HTTP 请求、JSON、异步处理、错误处理、流式输出、SSE、Token 限制、成本控制\n\n**内容概要**: 如何在项目中接入大模型 API，实现 AI 功能\n\n---\n\n#### 1.5 完整项目实战\n**文件**: `docs/zh-cn/stage-1/1.4-complete-project-practice/index.md`\n\n**关键词**: 完整项目、实战、练手、综合案例、项目实战、端到端、从零开始、项目结构、代码组织、最佳实践、常见问题、调试技巧、测试验证、项目复盘\n\n**内容概要**: 一个完整的项目实战，串联前面所学知识\n\n---\n\n#### 附录 A: 产品思维\n**文件**: `docs/zh-cn/stage-1/appendix-a-product-thinking/index.md`\n\n**关键词**: 产品思维、需求分析、用户研究、产品设计、用户体验、UX、功能优先级、产品文档、PRD、用户故事、敏捷开发、迭代思维、数据驱动、A/B 测试、产品方法论\n\n**内容概要**: 产品经理必备的思维模式和方法论\n\n---\n\n#### 附录 B: 常见错误\n**文件**: `docs/zh-cn/stage-1/appendix-b-common-errors/index.md`\n\n**关键词**: 常见错误、错误排查、问题解决、Bug、调试、报错信息、环境错误、依赖问题、网络问题、权限问题、配置错误、语法错误、运行时错误、逻辑错误、调试技巧\n\n**内容概要**: 初学者常犯的错误及解决方法\n\n---\n\n#### 附录: AI 应用场景参考（B 端与 C 端）\n**文件**: `docs/zh-cn/stage-1/appendix-industry-scenarios/index.md`\n\n**关键词**: 行业场景、行业应用、垂直领域、B2B、B2C、行业解决方案、消费场景、C 端产品、社交应用、内容创作、娱乐应用、生活方式、情感陪伴、个人成长\n\n**内容概要**: B 端 19 个行业落地应用与 C 端 16 个消费场景创意灵感，通过 Tab 切换浏览\n\n---\n\n#### 附录文章 0-1: 贪吃蛇游戏教程\n**文件**: `docs/zh-cn/stage-1/appendix-articles/example0-1/vibe-coding-tools-snake-game-tutorial.md`\n\n**关键词**: 贪吃蛇教程、游戏开发、Canvas API、键盘事件、游戏循环、碰撞检测、得分系统、游戏状态、开始界面、结束界面、代码详解\n\n**内容概要**: 详细的贪吃蛇游戏开发教程\n\n---\n\n#### 附录文章 0-2: AI 编程与设计代理\n**文件**: `docs/zh-cn/stage-1/appendix-articles/example0-2/vibe-coding-tools-build-website-with-ai-coding-and-design-agents.md`\n\n**关键词**: AI 设计、设计代理、网站生成、AI 辅助设计、视觉设计、UI 生成、设计系统、设计稿转代码、Design-to-Code\n\n**内容概要**: 使用 AI 设计代理和编程代理协作完成网站\n\n---\n\n### Stage 2: 初中级开发（全栈技能）\n\n#### 2.1 Dify 知识库\n**文件**: `docs/zh-cn/stage-2/ai-capabilities/2.1-dify-knowledge-base/index.md`\n\n**关键词**: Dify、知识库、RAG、智能客服、文档问答、知识管理、向量数据库、Embedding、文本向量化、语义搜索、知识检索、问答系统、Bot、AI 应用平台、工作流、Prompt 工程、知识库搭建\n\n**内容概要**: 使用 Dify 搭建基于知识库的 AI 应用\n\n---\n\n#### 2.2 多模态 API\n**文件**: `docs/zh-cn/stage-2/ai-capabilities/2.2-multimodal-api/extra3/index.md`\n\n**关键词**: 多模态、图片识别、语音、图像理解、视觉模型、VLM、语音识别、语音合成、TTS、ASR、OCR、图像生成、文生图、图生图、GPT-4V、Claude Vision、文件上传、Base64、图像处理\n\n**内容概要**: 多模态 AI 能力的接入和使用\n\n---\n\n#### 2.2 Supabase 数据库\n**文件**: `docs/zh-cn/stage-2/backend/2.2-database-supabase/index.md`\n\n**关键词**: 数据库、Supabase、PostgreSQL、后端、数据存储、表设计、CRUD、增删改查、SQL、NoSQL、数据库连接、ORM、Prisma、数据模型、关系型数据库、主键外键、索引、查询优化、实时数据库、Row Level Security、RLS\n\n**内容概要**: 使用 Supabase 作为后端数据库，实现数据持久化\n\n---\n\n#### 2.3 AI 接口开发\n**文件**: `docs/zh-cn/stage-2/backend/2.3-ai-interface-code/index.md`\n\n**关键词**: AI 接口、后端开发、API 设计、RESTful、接口开发、路由、控制器、服务端、Node.js、Express、Koa、Fastify、中间件、请求处理、响应格式、状态码、错误处理、接口文档、Swagger、OpenAPI\n\n**内容概要**: 开发 AI 相关的后端接口\n\n---\n\n#### 2.4 Git 工作流\n**文件**: `docs/zh-cn/stage-2/backend/2.4-git-workflow/index.md`\n\n**关键词**: Git、版本控制、协作、代码管理、分支、Branch、Merge、Pull Request、PR、Commit、仓库、Repository、GitHub、GitLab、代码冲突、代码回滚、Cherry Pick、Rebase、Git Flow、团队协作\n\n**内容概要**: Git 版本控制和团队协作流程\n\n---\n\n#### 2.5 Web 应用部署与 Dify 官方云\n**文件**: `docs/zh-cn/stage-2/backend/zeabur-deployment/index.md`\n\n**关键词**: 部署、上线、Cloudflare Pages、Vercel、Render、Dify、CloudBase、Netlify、免费额度、云部署、CI/CD、持续集成、持续部署、域名、DNS、HTTPS、SSL、服务器、容器、Docker、环境变量、生产环境、Staging、Preview、自动化部署\n\n**内容概要**: 按场景介绍 Cloudflare Pages、Vercel、Render 与 Dify 官方云的操作步骤、免费限制，补充 CloudBase 和 Netlify 部署方式\n\n---\n\n#### 2.6 现代 CLI 工具\n**文件**: `docs/zh-cn/stage-2/backend/2.6-modern-cli/index.md`\n\n**关键词**: CLI、命令行、终端、Shell、Bash、Zsh、命令行工具、npm、yarn、pnpm、包管理、脚本、自动化、终端美化、Oh My Zsh、Homebrew、包管理器、环境配置\n\n**内容概要**: 现代命令行开发工具的使用\n\n---\n\n#### 2.7 Stripe 支付\n**文件**: `docs/zh-cn/stage-2/backend/2.7-stripe-payment/index.md`\n\n**关键词**: 支付、Stripe、收款、付款、支付网关、支付集成、订阅、Subscription、Checkout、支付表单、Webhook、支付回调、订单、发票、支付安全、PCI、货币、汇率\n\n**内容概要**: 集成 Stripe 支付功能\n\n---\n\n#### 2.0 Lovart 资源\n**文件**: `docs/zh-cn/stage-2/frontend/2.0-lovart-assets/index.md`\n\n**关键词**: Lovart、资源、素材、图片、图标、设计资源、UI 资源、插画、矢量图、免费素材、商用素材、Unsplash、Iconfont、设计系统\n\n**内容概要**: 设计资源和素材的获取与使用\n\n---\n\n#### 2.1 Figma MasterGo\n**文件**: `docs/zh-cn/stage-2/frontend/2.1-figma-mastergo/index.md`\n\n**关键词**: Figma、MasterGo、设计稿、转代码、Design-to-Code、设计工具、UI 设计、原型设计、设计规范、组件库、设计系统、切图、标注、设计交付、设计协作\n\n**内容概要**: 从设计稿到代码的转换\n\n---\n\n#### 2.2 UI 设计\n**文件**: `docs/zh-cn/stage-2/frontend/2.2-ui-design/index.md`\n\n**关键词**: UI 设计、界面、美观、视觉设计、排版、配色、字体、间距、布局、设计原则、设计模式、用户体验、交互设计、动效、微交互、设计趋势\n\n**内容概要**: UI 设计基础和最佳实践\n\n---\n\n#### 2.3 多端产品 UI\n**文件**: `docs/zh-cn/stage-2/frontend/2.3-multi-product-ui/index.md`\n\n**关键词**: 多端、响应式、移动端、PC 端、平板、适配、断点、Media Query、Flexbox、Grid、Viewport、移动端优先、桌面端、跨设备\n\n**内容概要**: 多端产品的 UI 适配\n\n---\n\n#### 2.4 LLM 技能美化\n**文件**: `docs/zh-cn/stage-2/frontend/2.4-llm-skills-beautiful/index.md`\n\n**关键词**: LLM 技能、美化、提示词优化、Prompt 美化、输出格式化、Markdown、代码高亮、流式输出、打字机效果、UI 美化、聊天界面\n\n**内容概要**: 优化 LLM 输出的展示效果\n\n---\n\n#### 2.5 哈利波特画像\n**文件**: `docs/zh-cn/stage-2/frontend/2.5-hogwarts-portraits/index.md`\n\n**关键词**: 哈利波特、画像、AI 绘画、图像生成、文生图、Stable Diffusion、Midjourney、DALL-E、图像处理、Canvas、特效、动画\n\n**内容概要**: AI 图像生成和前端展示\n\n---\n\n#### 2.6 设计转代码\n**文件**: `docs/zh-cn/stage-2/frontend/2.6-design-to-code/index.md`\n\n**关键词**: 设计转代码、Design-to-Code、自动代码生成、Figma 插件、代码导出、像素完美、设计还原、CSS、Tailwind、样式提取\n\n**内容概要**: 自动化设计稿转代码的工具和方法\n\n---\n\n#### 2.7 现代组件库\n**文件**: `docs/zh-cn/stage-2/frontend/2.7-modern-component-library/index.md`\n\n**关键词**: 组件库、Element Plus、Ant Design、Material UI、Chakra UI、组件封装、复用、Props、Event、Slot、表单组件、数据展示、导航组件、反馈组件\n\n**内容概要**: 使用现代组件库加速开发\n\n---\n\n#### 作业 2.1: 全栈应用\n**文件**: `docs/zh-cn/stage-2/assignments/2.1-fullstack-app/index.md`\n\n**关键词**: 作业、全栈应用、综合练习、项目作业、实战练习、考核、项目要求、评分标准\n\n**内容概要**: Stage 2 的综合作业要求\n\n---\n\n#### 作业 2.2: 现代前端 Trae\n**文件**: `docs/zh-cn/stage-2/assignments/2.2-modern-frontend-trae/index.md`\n\n**关键词**: 作业、Trae、现代前端、项目作业、实战练习、考核\n\n**内容概要**: 使用 Trae 完成现代前端开发作业\n\n---\n\n### Stage 3: 高级开发（跨平台 & AI 进阶）\n\n#### 3.0 基础技能\n**文件**: `docs/zh-cn/stage-3/core-skills/basics/index.md`\n\n**关键词**: 高级基础、核心技能、进阶知识、高级工程师、技术深度、编程范式、设计模式、代码质量、重构、性能优化、Claude、Claude Code、Anthropic\n\n**内容概要**: 高级开发必备的基础技能\n\n---\n\n#### 3.0 工作流\n**文件**: `docs/zh-cn/stage-3/core-skills/workflow/index.md`\n\n**关键词**: 工作流、开发流程、工程化、自动化、DevOps、开发规范、代码审查、Code Review、团队协作、项目管理、Claude、Claude Code\n\n**内容概要**: 高级开发的工程化工作流\n\n---\n\n#### 3.0 技能清单\n**文件**: `docs/zh-cn/stage-3/core-skills/skills/index.md`\n\n**关键词**: 技能清单、技能树、能力模型、技术栈、技术选型、技能评估、学习路径、进阶路线、Claude、Claude Code\n\n**内容概要**: 高级开发技能清单和学习路线\n\n---\n\n#### 3.0 超能力\n**文件**: `docs/zh-cn/stage-3/core-skills/superpowers/index.md`\n\n**关键词**: 超能力、高级技巧、黑科技、效率工具、开发神器、生产力、快捷键、插件、工具链、Claude、Claude Code\n\n**内容概要**: 提升开发效率的高级技巧和工具\n\n---\n\n#### 3.0 移动开发\n**文件**: `docs/zh-cn/stage-3/core-skills/mobile-development/index.md`\n\n**关键词**: 移动开发、移动端、React Native、Flutter、混合开发、H5、WebView、原生开发、App 开发、移动端优化、Claude、Claude Code\n\n**内容概要**: 移动应用开发技术概览\n\n---\n\n#### 3.0 规范编程\n**文件**: `docs/zh-cn/stage-3/core-skills/spec-coding/index.md`\n\n**关键词**: 规范编程、代码规范、ESLint、Prettier、TypeScript、类型安全、代码风格、命名规范、注释规范、文档规范、Claude、Claude Code\n\n**内容概要**: 规范化编程实践\n\n---\n\n#### 3.0 Claude Agent SDK\n**文件**: `docs/zh-cn/stage-3/core-skills/claude-agent-sdk/index.md`\n\n**关键词**: Claude、Claude Code、Claude Agent、SDK、Anthropic、Agent 开发、AI Agent、工具调用、Function Calling、Computer Use、核心技能、core-skills\n\n**内容概要**: Claude Agent SDK 的使用\n\n---\n\n#### 3.0 MCP 工具\n**文件**: `docs/zh-cn/stage-3/core-skills/mcp/index.md`\n\n**关键词**: MCP、Model Context Protocol、工具调用、Claude、Claude Code、外部工具、工具定义、Tool Definition、Function Calling、工具生态、MCP Server、MCP Client、上下文协议、AI 工具链、核心技能、core-skills\n\n**内容概要**: MCP 协议的完整使用指南\n\n---\n\n#### 3.0 Agent 团队\n**文件**: `docs/zh-cn/stage-3/core-skills/agent-teams/index.md`\n\n**关键词**: Agent 团队、多 Agent 协作、Multi-Agent、Agent 编排、角色分工、协作模式、工作流编排、LangChain、AutoGen、CrewAI、Claude、Claude Code、核心技能、core-skills\n\n**内容概要**: 多 Agent 协作系统的设计与实现\n\n---\n\n#### 3.0 长任务处理\n**文件**: `docs/zh-cn/stage-3/core-skills/long-running-tasks/index.md`\n\n**关键词**: 长任务、异步、后台任务、任务队列、Job Queue、Celery、Bull、Redis、消息队列、任务调度、定时任务、Cron、重试机制、任务状态、进度追踪、Claude、Claude Code、核心技能、core-skills\n\n**内容概要**: 长时间运行任务的处理方案\n\n---\n\n#### 3.A1 RAG 入门\n**文件**: `docs/zh-cn/stage-3/ai-advanced/3.a1-rag-introduction/index.md`\n\n**关键词**: RAG、检索增强生成、向量检索、Embedding、向量数据库、Pinecone、Weaviate、Milvus、Chroma、文档切分、Chunking、相似度搜索、语义检索、知识增强\n\n**内容概要**: RAG 技术的基础概念和实现\n\n---\n\n#### 3.A2 LangGraph 高级 RAG\n**文件**: `docs/zh-cn/stage-3/ai-advanced/3.a2-langgraph-advanced-rag/index.md`\n\n**关键词**: LangGraph、高级 RAG、知识图谱、GraphRAG、Agentic RAG、多跳推理、查询重写、重排序、ReRank、混合检索、Self-RAG、Corrective RAG、自适应 RAG\n\n**内容概要**: 使用 LangGraph 实现高级 RAG 系统\n\n---\n\n#### 3.3 微信小程序\n**文件**: `docs/zh-cn/stage-3/cross-platform/3.3-wechat-miniprogram/index.md`\n\n**关键词**: 微信小程序、小程序开发、微信开发、WXML、WXSS、小程序框架、云开发、小程序组件、小程序 API、微信支付、小程序发布、审核\n\n**内容概要**: 微信小程序开发完整指南\n\n---\n\n#### 3.4 小程序后端\n**文件**: `docs/zh-cn/stage-3/cross-platform/3.4-wechat-miniprogram-backend/index.md`\n\n**关键词**: 小程序后端、云开发、微信云开发、云函数、云数据库、云存储、Serverless、小程序登录、OpenID、UnionID、鉴权\n\n**内容概要**: 微信小程序后端开发\n\n---\n\n#### 3.5 Android App\n**文件**: `docs/zh-cn/stage-3/cross-platform/3.5-android-app/index.md`\n\n**关键词**: Android、安卓 App、Kotlin、Java、Android Studio、移动端开发、原生应用、APK、Google Play、Android SDK、Jetpack Compose\n\n**内容概要**: Android 应用开发\n\n---\n\n#### 3.6 iOS App\n**文件**: `docs/zh-cn/stage-3/cross-platform/3.6-ios-app/index.md`\n\n**关键词**: iOS、苹果 App、Swift、SwiftUI、Xcode、移动端开发、原生应用、App Store、iOS SDK、UIKit、TestFlight\n\n**内容概要**: iOS 应用开发\n\n---\n\n#### 3.7 个人网站博客\n**文件**: `docs/zh-cn/stage-3/personal-brand/3.7-personal-website-blog/index.md`\n\n**关键词**: 个人网站、博客、Portfolio、个人品牌、个人主页、简历网站、作品集、静态网站、SSG、Next.js、Nuxt、Hexo、Hugo、VitePress、域名、托管\n\n**内容概要**: 搭建个人网站和博客\n\n---\n\n#### 3.8 PWA 本地应用\n**文件**: `docs/zh-cn/stage-3/cross-platform/3.8-pwa-local-app/index.md`\n\n**关键词**: PWA、Progressive Web App、离线应用、Service Worker、Web App Manifest、本地存储、IndexedDB、Cache、添加到桌面、离线访问\n\n**内容概要**: 构建渐进式 Web 应用\n\n---\n\n#### 3.9 浏览器 AI 插件\n**文件**: `docs/zh-cn/stage-3/cross-platform/3.9-browser-ai-extension/index.md`\n\n**关键词**: 浏览器插件、Extension、Chrome Extension、Firefox Addon、插件开发、Content Script、Background Script、Popup、Manifest V3、浏览器扩展、AI 插件\n\n**内容概要**: 开发浏览器 AI 插件\n\n---\n\n#### 3.10 Electron 语音转文字\n**文件**: `docs/zh-cn/stage-3/cross-platform/3.10-electron-voice-to-text/index.md`\n\n**关键词**: Electron、桌面应用、跨平台桌面、语音转文字、ASR、语音识别、Whisper、桌面端、窗口应用、主进程、渲染进程、IPC\n\n**内容概要**: 使用 Electron 开发语音转文字桌面应用\n\n---\n\n#### 3.11 NFT 铸造\n**文件**: `docs/zh-cn/stage-3/cross-platform/3.11-nft-minting/index.md`\n\n**关键词**: NFT、铸造、区块链、Web3、智能合约、Solidity、以太坊、钱包、MetaMask、IPFS、数字藏品、Gas Fee、合约部署\n\n**内容概要**: NFT 铸造和 Web3 开发\n\n---\n\n#### 3.12 VS Code 插件\n**文件**: `docs/zh-cn/stage-3/cross-platform/3.12-vscode-extension/index.md`\n\n**关键词**: VS Code 插件、Extension、编辑器插件、VS Code API、Command、Tree View、Webview、Language Server、代码补全、语法高亮\n\n**内容概要**: 开发 VS Code 插件\n\n---\n\n#### 3.13 Qt 工业 HMI\n**文件**: `docs/zh-cn/stage-3/cross-platform/3.13-qt-industrial-hmi/index.md`\n\n**关键词**: Qt、工业 HMI、人机界面、工控、SCADA、C++、QML、工业自动化、实时监控、数据采集、PLC、Modbus、OPC UA\n\n**内容概要**: 使用 Qt 开发工业人机界面\n\n---\n\n## 附录：知识体系\n\n### 一、计算机基础\n\n#### 1. Vibe Coding 时代全栈开发\n**文件**: `docs/zh-cn/appendix/1-computer-fundamentals/vibe-coding-fullstack.md`\n\n**关键词**: Vibe Coding、全栈开发、AI 编程、前端、后端、编程语言、工程师成长、技术栈、职业发展\n\n---\n\n#### 2. 从晶体管到 CPU\n**文件**: `docs/zh-cn/appendix/1-computer-fundamentals/transistor-to-cpu.md`\n\n**关键词**: 晶体管、CPU、计算机组成、硬件、逻辑门、运算器、控制器、寄存器、指令集、汇编、机器码、冯诺依曼\n\n---\n\n#### 3. 操作系统\n**文件**: `docs/zh-cn/appendix/1-computer-fundamentals/operating-systems.md`\n\n**关键词**: 操作系统、OS、进程、线程、内存管理、文件系统、调度、并发、同步、死锁、虚拟内存、内核、用户态\n\n---\n\n#### 4. 数据编码与存储\n**文件**: `docs/zh-cn/appendix/1-computer-fundamentals/data-encoding-storage.md`\n\n**关键词**: 数据编码、二进制、字符编码、UTF-8、ASCII、Unicode、数据压缩、存储、文件格式、序列化、JSON、XML、Protobuf\n\n---\n\n#### 5. 计算机网络\n**文件**: `docs/zh-cn/appendix/1-computer-fundamentals/computer-networks.md`\n\n**关键词**: 计算机网络、网络协议、TCP/IP、HTTP、HTTPS、DNS、IP、MAC、路由、交换、网络分层、OSI、Socket、WebSocket\n\n---\n\n#### 6. 数据结构\n**文件**: `docs/zh-cn/appendix/1-computer-fundamentals/data-structures.md`\n\n**关键词**: 数据结构、数组、链表、栈、队列、树、二叉树、堆、图、哈希表、集合、字典、时间复杂度、空间复杂度\n\n---\n\n#### 7. 算法思维\n**文件**: `docs/zh-cn/appendix/1-computer-fundamentals/algorithm-thinking.md`\n\n**关键词**: 算法、排序、搜索、递归、动态规划、贪心、分治、回溯、算法复杂度、大 O 表示法、LeetCode\n\n---\n\n#### 8. 编程语言图谱\n**文件**: `docs/zh-cn/appendix/1-computer-fundamentals/programming-languages.md`\n\n**关键词**: 编程语言、语言分类、静态类型、动态类型、编译型、解释型、面向对象、函数式、脚本语言、系统语言\n\n---\n\n#### 9. 编译原理\n**文件**: `docs/zh-cn/appendix/1-computer-fundamentals/compilers.md`\n\n**关键词**: 编译原理、词法分析、语法分析、AST、抽象语法树、语义分析、代码生成、优化、解释器、编译器\n\n---\n\n#### 10. 类型系统\n**文件**: `docs/zh-cn/appendix/1-computer-fundamentals/type-systems.md`\n\n**关键词**: 类型系统、静态类型、动态类型、强类型、弱类型、类型推断、泛型、类型安全、TypeScript、类型检查\n\n---\n\n#### 11. 计算机组成原理\n**文件**: `docs/zh-cn/appendix/1-computer-fundamentals/computer-organization.md`\n\n**关键词**: 计算机组成、体系结构、存储器、缓存、Cache、总线、I/O、中断、DMA、流水线、并行计算\n\n---\n\n#### 12. 从开机到上网\n**文件**: `docs/zh-cn/appendix/1-computer-fundamentals/power-on-to-web.md`\n\n**关键词**: 开机启动、引导、BIOS、UEFI、Bootloader、操作系统启动、内核加载、用户登录、浏览器、网络连接\n\n---\n\n### 二、开发环境与工具\n\n#### 1. IDE 基础\n**文件**: `docs/zh-cn/appendix/2-development-tools/ide-basics.md`\n\n**关键词**: IDE、VS Code、Cursor、Trae、编辑器、开发环境、插件、扩展、快捷键、调试、代码补全\n\n---\n\n#### 2. 命令行与 Shell\n**文件**: `docs/zh-cn/appendix/2-development-tools/command-line-shell.md`\n\n**关键词**: 命令行、Shell、Bash、Zsh、Terminal、终端、命令、脚本、管道、重定向、环境变量、权限\n\n---\n\n#### 3. Git 版本控制\n**文件**: `docs/zh-cn/appendix/2-development-tools/git-version-control.md`\n\n**关键词**: Git、版本控制、分支、合并、提交、仓库、GitHub、GitLab、冲突解决、Rebase、Cherry Pick\n\n---\n\n#### 4. 环境变量与 PATH\n**文件**: `docs/zh-cn/appendix/2-development-tools/environment-path.md`\n\n**关键词**: 环境变量、PATH、系统变量、用户变量、配置、.env、dotenv、环境配置\n\n---\n\n#### 5. 端口与 localhost\n**文件**: `docs/zh-cn/appendix/2-development-tools/ports-localhost.md`\n\n**关键词**: 端口、Port、localhost、127.0.0.1、本地开发、端口冲突、端口占用、网络地址\n\n---\n\n#### 6. 包管理器\n**文件**: `docs/zh-cn/appendix/2-development-tools/package-managers.md`\n\n**关键词**: 包管理器、npm、yarn、pnpm、pip、conda、gem、依赖管理、package.json、requirements.txt\n\n---\n\n#### 7. SSH 与认证\n**文件**: `docs/zh-cn/appendix/2-development-tools/ssh-authentication.md`\n\n**关键词**: SSH、密钥、公钥、私钥、认证、免密登录、SSH Key、GitHub SSH、安全连接\n\n---\n\n#### 8. 调试艺术\n**文件**: `docs/zh-cn/appendix/2-development-tools/debugging-art.md`\n\n**关键词**: 调试、Debug、断点、单步执行、Console、Log、Debugger、Chrome DevTools、性能分析\n\n---\n\n#### 9. 正则表达式\n**文件**: `docs/zh-cn/appendix/2-development-tools/regex.md`\n\n**关键词**: 正则表达式、Regex、Pattern、匹配、替换、验证、RegExp、字符串处理\n\n---\n\n### 三、浏览器与前端\n\n#### 1. HTML CSS 布局\n**文件**: `docs/zh-cn/appendix/3-browser-and-frontend/html-css-layout.md`\n\n**关键词**: HTML、CSS、布局、Flexbox、Grid、响应式、盒模型、选择器、样式、动画、Transition、Animation\n\n---\n\n#### 2. JavaScript 深入\n**文件**: `docs/zh-cn/appendix/3-browser-and-frontend/javascript-deep-dive.md`\n\n**关键词**: JavaScript、JS、ES6、闭包、原型链、作用域、异步、Promise、Async/Await、Event Loop、this、原型、继承\n\n---\n\n#### 3. TypeScript\n**文件**: `docs/zh-cn/appendix/3-browser-and-frontend/typescript.md`\n\n**关键词**: TypeScript、TS、类型、接口、泛型、装饰器、类型推断、编译、配置、tsconfig\n\n---\n\n#### 4. 前端框架\n**文件**: `docs/zh-cn/appendix/3-browser-and-frontend/frontend-frameworks.md`\n\n**关键词**: 前端框架、React、Vue、Angular、Svelte、组件、状态管理、生命周期、Hooks、Composition API\n\n---\n\n#### 5. 前端工程化\n**文件**: `docs/zh-cn/appendix/3-browser-and-frontend/frontend-engineering.md`\n\n**关键词**: 前端工程化、构建工具、Webpack、Vite、Rollup、Parcel、Babel、ESLint、Prettier、代码规范\n\n---\n\n#### 6. 浏览器渲染\n**文件**: `docs/zh-cn/appendix/3-browser-and-frontend/browser-as-os-rendering.md`\n\n**关键词**: 浏览器、渲染引擎、DOM、CSSOM、渲染树、重绘、重排、合成层、GPU 加速、性能优化\n\n---\n\n#### 7. 路由与导航\n**文件**: `docs/zh-cn/appendix/3-browser-and-frontend/routing-navigation.md`\n\n**关键词**: 路由、Router、前端路由、Vue Router、React Router、History API、Hash、SPA、单页应用\n\n---\n\n#### 8. 状态管理\n**文件**: `docs/zh-cn/appendix/3-browser-and-frontend/state-management.md`\n\n**关键词**: 状态管理、Vuex、Pinia、Redux、MobX、Zustand、Jotai、全局状态、状态机、Context\n\n---\n\n#### 9. 前端项目架构\n**文件**: `docs/zh-cn/appendix/3-browser-and-frontend/frontend-project-architecture.md`\n\n**关键词**: 前端架构、项目结构、目录组织、模块化、组件化、分层架构、微前端、Monorepo\n\n---\n\n#### 10. 实时通信\n**文件**: `docs/zh-cn/appendix/3-browser-and-frontend/realtime-communication.md`\n\n**关键词**: 实时通信、WebSocket、Socket.io、SSE、Server-Sent Events、长轮询、WebRTC、实时数据\n\n---\n\n#### 11. 图形与动画\n**文件**: `docs/zh-cn/appendix/3-browser-and-frontend/graphics-animation.md`\n\n**关键词**: 图形、动画、Canvas、SVG、WebGL、Three.js、CSS 动画、帧动画、粒子效果\n\n---\n\n#### 12. Web 性能\n**文件**: `docs/zh-cn/appendix/3-browser-and-frontend/web-performance.md`\n\n**关键词**: Web 性能、性能优化、加载优化、运行时优化、Lighthouse、Core Web Vitals、懒加载、代码分割、缓存\n\n---\n\n#### 13. 无障碍与国际化\n**文件**: `docs/zh-cn/appendix/3-browser-and-frontend/a11n-i18n.md`\n\n**关键词**: 无障碍、A11y、ARIA、国际化、i18n、本地化、l10n、多语言、屏幕阅读器\n\n---\n\n#### 14. JavaScript 运行时\n**文件**: `docs/zh-cn/appendix/3-browser-and-frontend/javascript-runtime.md`\n\n**关键词**: JavaScript 运行时、Node.js、Deno、Bun、运行时环境、事件循环、模块系统\n\n---\n\n#### 15. 前端框架本质\n**文件**: `docs/zh-cn/appendix/3-browser-and-frontend/frontend-framework-nature.md`\n\n**关键词**: 前端框架本质、Virtual DOM、Diff 算法、响应式原理、依赖追踪、编译优化\n\n---\n\n### 四、服务器与后端\n\n#### 1. 后端语言\n**文件**: `docs/zh-cn/appendix/4-server-and-backend/backend-languages.md`\n\n**关键词**: 后端语言、Node.js、Python、Java、Go、Rust、PHP、Ruby、语言选择、技术栈\n\n---\n\n#### 2. 后端分层架构\n**文件**: `docs/zh-cn/appendix/4-server-and-backend/backend-layered-architecture.md`\n\n**关键词**: 后端架构、分层、MVC、三层架构、领域驱动、DDD、Clean Architecture、依赖注入\n\n---\n\n#### 3. 请求旅程\n**文件**: `docs/zh-cn/appendix/4-server-and-backend/request-journey.md`\n\n**关键词**: 请求旅程、HTTP 请求、生命周期、中间件、路由、控制器、服务层、数据层、响应\n\n---\n\n#### 4. API 入门\n**文件**: `docs/zh-cn/appendix/4-server-and-backend/api-intro.md`\n\n**关键词**: API、接口、REST、RESTful、HTTP 方法、状态码、请求头、响应头、Content-Type、认证\n\n---\n\n#### 5. API 设计\n**文件**: `docs/zh-cn/appendix/4-server-and-backend/api-design.md`\n\n**关键词**: API 设计、接口设计、版本控制、URL 设计、资源命名、错误处理、分页、过滤、排序\n\n---\n\n#### 6. Web 框架\n**文件**: `docs/zh-cn/appendix/4-server-and-backend/web-frameworks.md`\n\n**关键词**: Web 框架、Express、Koa、Fastify、NestJS、Django、Flask、Spring Boot、Gin、路由、中间件\n\n---\n\n#### 7. HTTP 协议\n**文件**: `docs/zh-cn/appendix/4-server-and-backend/http-protocol.md`\n\n**关键词**: HTTP、协议、请求、响应、Header、Body、Method、Status Code、Cookie、Session、Keep-Alive、HTTP/2、HTTP/3\n\n---\n\n#### 8. 认证与授权\n**文件**: `docs/zh-cn/appendix/4-server-and-backend/auth-authorization.md`\n\n**关键词**: 认证、授权、Auth、JWT、OAuth、SSO、Session、Cookie、Token、权限、RBAC、鉴权\n\n---\n\n#### 9. 序列化\n**文件**: `docs/zh-cn/appendix/4-server-and-backend/serialization.md`\n\n**关键词**: 序列化、反序列化、JSON、XML、Protobuf、MessagePack、Avro、Thrift、数据格式\n\n---\n\n#### 10. 并发与异步\n**文件**: `docs/zh-cn/appendix/4-server-and-backend/concurrency-async.md`\n\n**关键词**: 并发、异步、多线程、多进程、协程、Promise、Async/Await、事件驱动、回调、非阻塞 IO\n\n---\n\n#### 11. 缓存\n**文件**: `docs/zh-cn/appendix/4-server-and-backend/caching.md`\n\n**关键词**: 缓存、Cache、Redis、Memcached、本地缓存、分布式缓存、缓存策略、缓存穿透、缓存雪崩、缓存更新\n\n---\n\n#### 12. 消息队列\n**文件**: `docs/zh-cn/appendix/4-server-and-backend/message-queues.md`\n\n**关键词**: 消息队列、MQ、RabbitMQ、Kafka、RocketMQ、消息模型、发布订阅、点对点、消息可靠性\n\n---\n\n#### 13. 异步任务队列\n**文件**: `docs/zh-cn/appendix/4-server-and-backend/async-task-queues.md`\n\n**关键词**: 任务队列、Celery、Bull、RQ、Sidekiq、后台任务、定时任务、任务调度、重试机制\n\n---\n\n#### 14. 限流与背压\n**文件**: `docs/zh-cn/appendix/4-server-and-backend/rate-limiting-backpressure.md`\n\n**关键词**: 限流、Rate Limiting、背压、Backpressure、流量控制、熔断、降级、负载保护、令牌桶、漏桶\n\n---\n\n#### 15. 搜索引擎\n**文件**: `docs/zh-cn/appendix/4-server-and-backend/search-engines.md`\n\n**关键词**: 搜索引擎、Elasticsearch、Solr、全文搜索、倒排索引、分词、相关性排序、搜索优化\n\n---\n\n#### 16. 文件存储\n**文件**: `docs/zh-cn/appendix/4-server-and-backend/file-storage.md`\n\n**关键词**: 文件存储、OSS、S3、MinIO、云存储、对象存储、CDN、文件上传、断点续传、分片上传\n\n---\n\n#### 17. 后端项目架构\n**文件**: `docs/zh-cn/appendix/4-server-and-backend/backend-project-architecture.md`\n\n**关键词**: 后端项目架构、项目结构、目录组织、模块化、服务划分、代码组织、最佳实践\n\n---\n\n#### 18. 客户端语言\n**文件**: `docs/zh-cn/appendix/4-server-and-backend/client-languages.md`\n\n**关键词**: 客户端语言、移动端、桌面端、小程序、跨平台、React Native、Flutter、Electron、Tauri\n\n---\n\n#### 19. 领域特定语言\n**文件**: `docs/zh-cn/appendix/4-server-and-backend/domain-specific-languages.md`\n\n**关键词**: DSL、领域特定语言、SQL、正则、GraphQL、配置语言、模板语言、内部 DSL、外部 DSL\n\n---\n\n#### 20. 跨平台\n**文件**: `docs/zh-cn/appendix/4-server-and-backend/cross-platform.md`\n\n**关键词**: 跨平台、多端、统一开发、Write Once Run Anywhere、跨平台框架、适配策略\n\n---\n\n### 五、数据\n\n#### 1. 数据库基础\n**文件**: `docs/zh-cn/appendix/5-data/database-fundamentals.md`\n\n**关键词**: 数据库基础、关系型数据库、SQL、MySQL、PostgreSQL、表、字段、索引、事务、ACID、SQL 语句\n\n---\n\n#### 2. 数据模型\n**文件**: `docs/zh-cn/appendix/5-data/data-models.md`\n\n**关键词**: 数据模型、ER 模型、关系模型、文档模型、图模型、键值模型、数据建模、范式、反范式\n\n---\n\n#### 3. 数据分析\n**文件**: `docs/zh-cn/appendix/5-data/data-analysis.md`\n\n**关键词**: 数据分析、Python、Pandas、NumPy、数据清洗、数据可视化、统计分析、BI、数据挖掘\n\n---\n\n#### 4. 数据可视化\n**文件**: `docs/zh-cn/appendix/5-data/data-visualization.md`\n\n**关键词**: 数据可视化、图表、ECharts、D3.js、AntV、Tableau、可视化设计、交互可视化\n\n---\n\n#### 5. A/B 测试\n**文件**: `docs/zh-cn/appendix/5-data/ab-testing.md`\n\n**关键词**: A/B 测试、实验、对照组、实验组、显著性、假设检验、转化率、实验设计\n\n---\n\n#### 6. 数据埋点\n**文件**: `docs/zh-cn/appendix/5-data/data-tracking.md`\n\n**关键词**: 数据埋点、事件追踪、用户行为、数据分析、漏斗分析、留存分析、归因分析\n\n---\n\n#### 7. 数据治理\n**文件**: `docs/zh-cn/appendix/5-data/data-governance.md`\n\n**关键词**: 数据治理、数据质量、数据安全、数据标准、元数据、数据血缘、合规、隐私\n\n---\n\n### 六、架构与系统设计\n\n#### 1. 系统设计方法论\n**文件**: `docs/zh-cn/appendix/6-architecture-and-system-design/system-design-methodology.md`\n\n**关键词**: 系统设计、架构设计、设计原则、SOLID、设计模式、系统思维、权衡、扩展性、可用性\n\n---\n\n#### 2. 分布式系统\n**文件**: `docs/zh-cn/appendix/6-architecture-and-system-design/distributed-systems.md`\n\n**关键词**: 分布式系统、CAP 定理、一致性、可用性、分区容错、分布式事务、共识算法、Raft、Paxos\n\n---\n\n#### 3. 高可用\n**文件**: `docs/zh-cn/appendix/6-architecture-and-system-design/high-availability.md`\n\n**关键词**: 高可用、HA、容灾、故障转移、主从、集群、多活、SLA、SLO、SLI、可靠性工程\n\n---\n\n#### 4. 单体到微服务\n**文件**: `docs/zh-cn/appendix/6-architecture-and-system-design/monolith-to-microservices.md`\n\n**关键词**: 微服务、单体、服务拆分、服务治理、服务发现、配置中心、链路追踪、分布式追踪\n\n---\n\n### 七、基础设施与运维\n\n#### 1. Linux 基础\n**文件**: `docs/zh-cn/appendix/7-infrastructure-and-operations/linux-basics.md`\n\n**关键词**: Linux、操作系统、命令行、Shell、文件系统、权限、进程管理、网络配置、系统管理\n\n---\n\n#### 2. Docker 容器\n**文件**: `docs/zh-cn/appendix/7-infrastructure-and-operations/docker-containers.md`\n\n**关键词**: Docker、容器、镜像、Container、Dockerfile、Compose、容器化、微服务部署\n\n---\n\n#### 3. Kubernetes\n**文件**: `docs/zh-cn/appendix/7-infrastructure-and-operations/kubernetes.md`\n\n**关键词**: Kubernetes、K8s、容器编排、Pod、Service、Deployment、Ingress、Helm、集群管理\n\n---\n\n#### 4. CI/CD\n**文件**: `docs/zh-cn/appendix/7-infrastructure-and-operations/ci-cd.md`\n\n**关键词**: CI/CD、持续集成、持续部署、Jenkins、GitLab CI、GitHub Actions、自动化构建、自动化测试\n\n---\n\n#### 5. 云平台\n**文件**: `docs/zh-cn/appendix/7-infrastructure-and-operations/cloud-platforms.md`\n\n**关键词**: 云平台、AWS、Azure、GCP、阿里云、腾讯云、华为云、云服务、IaaS、PaaS、SaaS\n\n---\n\n#### 6. 云 IAM\n**文件**: `docs/zh-cn/appendix/7-infrastructure-and-operations/cloud-iam.md`\n\n**关键词**: IAM、身份管理、访问控制、权限管理、角色、策略、RBAC、云安全\n\n---\n\n#### 7. 云存储与 CDN\n**文件**: `docs/zh-cn/appendix/7-infrastructure-and-operations/cloud-storage-cdn.md`\n\n**关键词**: 云存储、CDN、对象存储、内容分发、边缘计算、加速、缓存策略\n\n---\n\n#### 8. DNS 与 HTTPS\n**文件**: `docs/zh-cn/appendix/7-infrastructure-and-operations/dns-https.md`\n\n**关键词**: DNS、域名解析、HTTPS、SSL、TLS、证书、CA、加密、安全传输\n\n---\n\n#### 9. 负载均衡与网关\n**文件**: `docs/zh-cn/appendix/7-infrastructure-and-operations/load-balancing-gateway.md`\n\n**关键词**: 负载均衡、Gateway、Nginx、API Gateway、反向代理、流量分发、健康检查\n\n---\n\n#### 10. 网关代理\n**文件**: `docs/zh-cn/appendix/7-infrastructure-and-operations/gateway-proxy.md`\n\n**关键词**: 网关、代理、Nginx、Traefik、Envoy、服务网格、Istio、流量管理\n\n---\n\n#### 11. 基础设施即代码\n**文件**: `docs/zh-cn/appendix/7-infrastructure-and-operations/infrastructure-as-code.md`\n\n**关键词**: IaC、基础设施即代码、Terraform、Ansible、Pulumi、CloudFormation、自动化运维\n\n---\n\n#### 12. 监控与日志\n**文件**: `docs/zh-cn/appendix/7-infrastructure-and-operations/monitoring-logging.md`\n\n**关键词**: 监控、日志、Prometheus、Grafana、ELK、Loki、告警、可观测性、Observability\n\n---\n\n#### 13. 事故响应\n**文件**: `docs/zh-cn/appendix/7-infrastructure-and-operations/incident-response.md`\n\n**关键词**: 事故响应、故障处理、应急响应、SRE、事后复盘、故障演练、混沌工程\n\n---\n\n### 八、人工智能\n\n#### 1. AI 历史\n**文件**: `docs/zh-cn/appendix/8-artificial-intelligence/ai-history.md`\n\n**关键词**: AI 历史、人工智能发展、机器学习历史、深度学习、神经网络历史、AI 里程碑\n\n---\n\n#### 2. 神经网络\n**文件**: `docs/zh-cn/appendix/8-artificial-intelligence/neural-networks.md`\n\n**关键词**: 神经网络、深度学习、CNN、RNN、LSTM、GRU、激活函数、反向传播、梯度下降\n\n---\n\n#### 3. Transformer 与注意力机制\n**文件**: `docs/zh-cn/appendix/8-artificial-intelligence/transformer-attention.md`\n\n**关键词**: Transformer、注意力机制、Attention、Self-Attention、Multi-Head Attention、BERT、GPT、位置编码\n\n---\n\n#### 4. LLM 原理\n**文件**: `docs/zh-cn/appendix/8-artificial-intelligence/llm-principles.md`\n\n**关键词**: LLM、大语言模型、预训练、微调、Fine-tuning、RLHF、对齐、涌现能力、Scaling Law\n\n---\n\n#### 5. Prompt 工程\n**文件**: `docs/zh-cn/appendix/8-artificial-intelligence/prompt-engineering.md`\n\n**关键词**: Prompt 工程、提示词、Prompt Design、Few-shot、Chain-of-Thought、ReAct、提示词优化\n\n---\n\n#### 6. RAG\n**文件**: `docs/zh-cn/appendix/8-artificial-intelligence/rag.md`\n\n**关键词**: RAG、检索增强生成、向量检索、Embedding、知识库、文档问答、语义搜索\n\n---\n\n#### 7. Embedding 与向量检索\n**文件**: `docs/zh-cn/appendix/8-artificial-intelligence/embedding-vector-retrieval.md`\n\n**关键词**: Embedding、向量、向量检索、向量数据库、相似度、余弦相似度、向量空间\n\n---\n\n#### 8. AI Agent\n**文件**: `docs/zh-cn/appendix/8-artificial-intelligence/ai-agents.md`\n\n**关键词**: AI Agent、智能体、Agent 架构、ReAct、Plan-and-Execute、Tool Use、Multi-Agent\n\n---\n\n#### 9. 多模态模型\n**文件**: `docs/zh-cn/appendix/8-artificial-intelligence/multimodal-models.md`\n\n**关键词**: 多模态、视觉语言模型、VLM、CLIP、GPT-4V、图像理解、跨模态、图文生成\n\n---\n\n#### 10. 图像生成\n**文件**: `docs/zh-cn/appendix/8-artificial-intelligence/image-generation.md`\n\n**关键词**: 图像生成、文生图、Stable Diffusion、Midjourney、DALL-E、GAN、Diffusion、ControlNet\n\n---\n\n#### 11. 语音合成与识别\n**文件**: `docs/zh-cn/appendix/8-artificial-intelligence/speech-synthesis-recognition.md`\n\n**关键词**: 语音合成、语音识别、TTS、ASR、Whisper、语音克隆、声纹识别\n\n---\n\n#### 12. 模型微调与部署\n**文件**: `docs/zh-cn/appendix/8-artificial-intelligence/model-finetuning-deployment.md`\n\n**关键词**: 模型微调、Fine-tuning、LoRA、QLoRA、模型部署、模型量化、推理优化、ONNX、TensorRT\n\n---\n\n#### 13. AI 协议\n**文件**: `docs/zh-cn/appendix/8-artificial-intelligence/ai-protocols.md`\n\n**关键词**: AI 协议、MCP、Function Calling、Tool Use、API 标准、OpenAI API、Anthropic API\n\n---\n\n#### 14. AI 原生应用设计\n**文件**: `docs/zh-cn/appendix/8-artificial-intelligence/ai-native-app-design.md`\n\n**关键词**: AI 原生应用、AI-First、产品设计、用户体验、人机交互、Copilot、Agent 界面\n\n---\n\n#### 15. 上下文工程\n**文件**: `docs/zh-cn/appendix/8-artificial-intelligence/context-engineering.md`\n\n**关键词**: 上下文工程、Context Engineering、上下文管理、长上下文、RAG、记忆、会话管理\n\n---\n\n#### 16. AI 能力词典\n**文件**: `docs/zh-cn/appendix/8-artificial-intelligence/ai-capability-dictionary.md`\n\n**关键词**: AI 能力、AI 功能、能力清单、应用场景、技术选型、AI 解决方案\n\n---\n\n### 九、工程卓越\n\n#### 1. 代码质量与重构\n**文件**: `docs/zh-cn/appendix/9-engineering-excellence/code-quality-refactoring.md`\n\n**关键词**: 代码质量、重构、Clean Code、代码审查、技术债务、代码异味、重构模式\n\n---\n\n#### 2. 测试策略\n**文件**: `docs/zh-cn/appendix/9-engineering-excellence/testing-strategies.md`\n\n**关键词**: 测试、单元测试、集成测试、E2E 测试、TDD、BDD、测试覆盖率、Mock、自动化测试\n\n---\n\n#### 3. 设计模式\n**文件**: `docs/zh-cn/appendix/9-engineering-excellence/design-patterns.md`\n\n**关键词**: 设计模式、单例、工厂、观察者、策略、装饰器、适配器、MVC、MVVM、架构模式\n\n---\n\n#### 4. 技术选型\n**文件**: `docs/zh-cn/appendix/9-engineering-excellence/technology-selection.md`\n\n**关键词**: 技术选型、技术决策、技术栈、框架选择、评估标准、技术雷达、技术债\n\n---\n\n#### 5. 开源协作\n**文件**: `docs/zh-cn/appendix/9-engineering-excellence/open-source-collaboration.md`\n\n**关键词**: 开源、开源协作、GitHub、贡献指南、Code Review、社区、开源协议、LICENSE\n\n---\n\n#### 6. 安全思维\n**文件**: `docs/zh-cn/appendix/9-engineering-excellence/security-thinking.md`\n\n**关键词**: 安全、安全思维、OWASP、漏洞、注入、XSS、CSRF、安全编码、加密、认证\n\n---\n\n#### 7. 技术写作\n**文件**: `docs/zh-cn/appendix/9-engineering-excellence/technical-writing.md`\n\n**关键词**: 技术写作、文档、README、API 文档、技术博客、知识分享、文档规范\n\n---\n\n## ✅ 回答规则（必读）\n\n1. **先读高层架构**：先阅读上面的\"高层级架构\"和\"快速决策树\"，确定用户问题属于哪个阶段\n2. **再查详细索引**：根据阶段定位到详细文章索引，找到具体文件\n3. **引用来源**：回答时注明信息来自哪个文件，例如：\"根据 `stage-1/1.1-introduction-to-ai-ide` 的内容...\"\n4. **代码优先**：优先使用教程中提供的代码示例\n5. **阶段匹配**：根据用户水平推荐合适的内容，不要给新手推荐 Stage 3 的高级内容\n6. **关键词匹配**：根据用户问题中的关键词，快速定位到对应文件\n7. **不确定时**：明确告诉用户\"让我先查看相关教程内容\"，然后读取文件\n8. **附录参考**：当用户问基础概念时，优先引用附录中的知识文章\n\n---\n\n## 📚 教程概览\n\n**Easy-Vibe** 是一个从零开始的 AI 编程教程，核心理念是 **Vibe Coding**（用自然语言编程）。\n\n### 学习路径\n\n```\nStage 0 (新手入门)\n    ↓\nStage 1 (AI 产品经理) - 用 AI IDE 做原型\n    ↓\nStage 2 (初中级开发) - 全栈开发 + 部署\n    ↓\nStage 3 (高级开发) - 跨平台 + AI 进阶\n    ↓\n附录 (知识体系) - 计算机基础到工程素养\n```\n\n### 目标读者\n- **零基础用户**：从 Stage 0 开始，先体验 AI 编程的乐趣\n- **产品经理/设计师**：重点学习 Stage 1，快速做 Demo\n- **初级开发者**：Stage 2 帮你补齐全栈技能\n- **高级开发者**：Stage 3 的 MCP、RAG、跨平台开发\n- **全栈工程师**：附录提供完整的计算机知识体系\n\n### 技术栈\n- **AI IDE**: Cursor, Claude Code, Trae\n- **前端**: Vue 3, React, Element Plus\n- **后端**: Node.js, Supabase, Dify\n- **部署**: Cloudflare Pages, Vercel, Render, Dify Cloud, CloudBase, Netlify\n- **跨平台**: 微信小程序, Android, iOS, Electron\n- **AI 技术**: LLM, RAG, MCP, Agent, 多模态\n\n---\n\n## 🔗 相关文件\n\n- **本文件**: `llms.txt` - AI 导航入口（必读）\n- **Claude Code 专用**: `CLAUDE.md` - 针对 Claude Code 的详细指南\n- **项目说明**: `README.md` - 人类用户入口\n- **配置文件**: `docs/.vitepress/config.mjs` - 网站导航配置\n\n---\n\n## 📝 版本信息\n\n- **版本**: 2.1.0\n- **更新日期**: 2026-03-02\n- **文章总数**: 100+ 篇\n- **语言支持**: 中文(zh-cn), 英文(en), 日文(ja-jp), 韩文(ko-kr), 繁体中文(zh-tw), 西班牙文(es-es), 法文(fr-fr), 德文(de-de), 阿拉伯文(ar-sa), 越南文(vi-vn)\n- **默认语言**: 中文 (`docs/zh-cn/`)\n\n---\n\n> 💡 **提示**: 如果你是多语言 AI，请根据用户使用的语言选择对应的 `docs/{语言}/` 目录下的文件。\n\n<!-- File: docs/ar-sa/stage-3/core-skills/skills/index.md (Tokens: ~300 | Category: anthropic-skill) -->\n# Skills Skill\n\nPath: `docs/ar-sa/stage-3/core-skills/skills/index.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/datawhalechina/easy-vibe/HEAD/docs/ar-sa/stage-3/core-skills/skills/index.md)\n\n<!-- File: docs/de-de/stage-3/core-skills/skills/index.md (Tokens: ~300 | Category: anthropic-skill) -->\n# Skills Skill\n\nPath: `docs/de-de/stage-3/core-skills/skills/index.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/datawhalechina/easy-vibe/HEAD/docs/de-de/stage-3/core-skills/skills/index.md)\n\n<!-- File: docs/en/stage-3/core-skills/skills/index.md (Tokens: ~300 | Category: anthropic-skill) -->\n# Skills Skill\n\nPath: `docs/en/stage-3/core-skills/skills/index.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/datawhalechina/easy-vibe/HEAD/docs/en/stage-3/core-skills/skills/index.md)\n\n<!-- File: docs/es-es/stage-3/core-skills/skills/index.md (Tokens: ~300 | Category: anthropic-skill) -->\n# Skills Skill\n\nPath: `docs/es-es/stage-3/core-skills/skills/index.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/datawhalechina/easy-vibe/HEAD/docs/es-es/stage-3/core-skills/skills/index.md)\n\n<!-- File: docs/fr-fr/stage-3/core-skills/skills/index.md (Tokens: ~300 | Category: anthropic-skill) -->\n# Skills Skill\n\nPath: `docs/fr-fr/stage-3/core-skills/skills/index.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/datawhalechina/easy-vibe/HEAD/docs/fr-fr/stage-3/core-skills/skills/index.md)\n\n<!-- File: docs/ja-jp/stage-3/core-skills/skills/index.md (Tokens: ~300 | Category: anthropic-skill) -->\n# Skills Skill\n\nPath: `docs/ja-jp/stage-3/core-skills/skills/index.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/datawhalechina/easy-vibe/HEAD/docs/ja-jp/stage-3/core-skills/skills/index.md)\n\n<!-- File: docs/ko-kr/stage-3/core-skills/skills/index.md (Tokens: ~300 | Category: anthropic-skill) -->\n# Skills Skill\n\nPath: `docs/ko-kr/stage-3/core-skills/skills/index.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/datawhalechina/easy-vibe/HEAD/docs/ko-kr/stage-3/core-skills/skills/index.md)\n\n<!-- File: docs/vi-vn/stage-3/core-skills/skills/index.md (Tokens: ~300 | Category: anthropic-skill) -->\n# Skills Skill\n\nPath: `docs/vi-vn/stage-3/core-skills/skills/index.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/datawhalechina/easy-vibe/HEAD/docs/vi-vn/stage-3/core-skills/skills/index.md)\n\n<!-- File: docs/zh-cn/stage-3/core-skills/skills/index.md (Tokens: ~300 | Category: anthropic-skill) -->\n# Skills Skill\n\nPath: `docs/zh-cn/stage-3/core-skills/skills/index.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/datawhalechina/easy-vibe/HEAD/docs/zh-cn/stage-3/core-skills/skills/index.md)\n\n<!-- File: docs/zh-tw/stage-3/core-skills/skills/index.md (Tokens: ~300 | Category: anthropic-skill) -->\n# Skills Skill\n\nPath: `docs/zh-tw/stage-3/core-skills/skills/index.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/datawhalechina/easy-vibe/HEAD/docs/zh-tw/stage-3/core-skills/skills/index.md)\n\n<!-- File: tools/translation/fixtures/fail-code-block/localized.md (Tokens: ~31 | Category: anthropic-skill) -->\n<!-- Expected failure: the port value inside the fenced code block was changed. -->\n\n# 실행\n\n```js\nconst port = 8080\n```\n\n<!-- File: tools/translation/fixtures/fail-code-block/source.md (Tokens: ~29 | Category: anthropic-skill) -->\n<!-- Fixture source: fenced code must be preserved exactly. -->\n\n# 运行\n\n```js\nconst port = 3000\n```\n\n<!-- File: tools/translation/fixtures/fail-frontmatter/localized.md (Tokens: ~28 | Category: anthropic-skill) -->\n---\ntitle: 설치 안내\n---\n\n<!-- Expected failure: the localized frontmatter is missing the description key. -->\n\n# 설치\n\n<!-- File: tools/translation/fixtures/fail-frontmatter/source.md (Tokens: ~38 | Category: anthropic-skill) -->\n---\ntitle: 安装指南\ndescription: 安装示例\n---\n\n<!-- Fixture source: the localized file must preserve both frontmatter keys. -->\n\n# 安装\n\n<!-- File: tools/translation/fixtures/fail-image/localized.md (Tokens: ~300 | Category: anthropic-skill) -->\n# Fail-image Skill\n\nPath: `tools/translation/fixtures/fail-image/localized.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/datawhalechina/easy-vibe/HEAD/tools/translation/fixtures/fail-image/localized.md)\n\n<!-- File: tools/translation/fixtures/fail-image/source.md (Tokens: ~300 | Category: anthropic-skill) -->\n# Fail-image Skill\n\nPath: `tools/translation/fixtures/fail-image/source.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/datawhalechina/easy-vibe/HEAD/tools/translation/fixtures/fail-image/source.md)\n\n<!-- File: tools/translation/fixtures/fail-inline-code/localized.md (Tokens: ~300 | Category: anthropic-skill) -->\n# Fail-inline-code Skill\n\nPath: `tools/translation/fixtures/fail-inline-code/localized.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/datawhalechina/easy-vibe/HEAD/tools/translation/fixtures/fail-inline-code/localized.md)\n\n<!-- File: tools/translation/fixtures/fail-inline-code/source.md (Tokens: ~300 | Category: anthropic-skill) -->\n# Fail-inline-code Skill\n\nPath: `tools/translation/fixtures/fail-inline-code/source.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/datawhalechina/easy-vibe/HEAD/tools/translation/fixtures/fail-inline-code/source.md)\n\n<!-- File: tools/translation/fixtures/fail-link/localized.md (Tokens: ~300 | Category: anthropic-skill) -->\n# Fail-link Skill\n\nPath: `tools/translation/fixtures/fail-link/localized.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/datawhalechina/easy-vibe/HEAD/tools/translation/fixtures/fail-link/localized.md)\n\n<!-- File: tools/translation/fixtures/fail-link/source.md (Tokens: ~300 | Category: anthropic-skill) -->\n# Fail-link Skill\n\nPath: `tools/translation/fixtures/fail-link/source.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/datawhalechina/easy-vibe/HEAD/tools/translation/fixtures/fail-link/source.md)\n\n<!-- File: tools/translation/fixtures/fail-source-locale/docs/ko-kr/localized.md (Tokens: ~300 | Category: anthropic-skill) -->\n# Ko-kr Skill\n\nPath: `tools/translation/fixtures/fail-source-locale/docs/ko-kr/localized.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/datawhalechina/easy-vibe/HEAD/tools/translation/fixtures/fail-source-locale/docs/ko-kr/localized.md)\n\n<!-- File: tools/translation/fixtures/fail-source-locale/docs/zh-cn/source.md (Tokens: ~300 | Category: anthropic-skill) -->\n# Zh-cn Skill\n\nPath: `tools/translation/fixtures/fail-source-locale/docs/zh-cn/source.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/datawhalechina/easy-vibe/HEAD/tools/translation/fixtures/fail-source-locale/docs/zh-cn/source.md)\n\n<!-- File: tools/translation/fixtures/fail-source-text/localized.md (Tokens: ~300 | Category: anthropic-skill) -->\n# Fail-source-text Skill\n\nPath: `tools/translation/fixtures/fail-source-text/localized.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/datawhalechina/easy-vibe/HEAD/tools/translation/fixtures/fail-source-text/localized.md)\n\n<!-- File: tools/translation/fixtures/fail-source-text/source.md (Tokens: ~300 | Category: anthropic-skill) -->\n# Fail-source-text Skill\n\nPath: `tools/translation/fixtures/fail-source-text/source.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/datawhalechina/easy-vibe/HEAD/tools/translation/fixtures/fail-source-text/source.md)\n\n<!-- File: tools/translation/fixtures/fail-structure/localized.md (Tokens: ~300 | Category: anthropic-skill) -->\n# Fail-structure Skill\n\nPath: `tools/translation/fixtures/fail-structure/localized.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/datawhalechina/easy-vibe/HEAD/tools/translation/fixtures/fail-structure/localized.md)\n\n<!-- File: tools/translation/fixtures/fail-structure/source.md (Tokens: ~300 | Category: anthropic-skill) -->\n# Fail-structure Skill\n\nPath: `tools/translation/fixtures/fail-structure/source.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/datawhalechina/easy-vibe/HEAD/tools/translation/fixtures/fail-structure/source.md)\n\n<!-- File: tools/translation/fixtures/pass-glossary-annotation/docs/ko-kr/localized.md (Tokens: ~300 | Category: anthropic-skill) -->\n# Ko-kr Skill\n\nPath: `tools/translation/fixtures/pass-glossary-annotation/docs/ko-kr/localized.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/datawhalechina/easy-vibe/HEAD/tools/translation/fixtures/pass-glossary-annotation/docs/ko-kr/localized.md)\n\n<!-- File: tools/translation/fixtures/pass-glossary-annotation/docs/zh-cn/source.md (Tokens: ~300 | Category: anthropic-skill) -->\n# Zh-cn Skill\n\nPath: `tools/translation/fixtures/pass-glossary-annotation/docs/zh-cn/source.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/datawhalechina/easy-vibe/HEAD/tools/translation/fixtures/pass-glossary-annotation/docs/zh-cn/source.md)\n\n<!-- ... +6 more modular skills available via /api/skills/datawhalechina/easy-vibe?path={path} -->\n</yakaai_skills>"}