refactor(docs): reorganize file structure and update content

fix(docs): correct links and paths in multiple files
style(docs): adjust formatting and alignment in README files
docs: update content in multiple markdown files
This commit is contained in:
sanbuphy
2026-02-10 17:23:27 +08:00
parent d166dc5b12
commit 8a7eda8014
28 changed files with 1137 additions and 637 deletions
File diff suppressed because it is too large Load Diff
+3 -3
View File
@@ -53,14 +53,14 @@
| 前端一:Figma 与 MasterGo 入门 | 用设计工具梳理信息架构和页面结构,为前端实现打基础 | 🚧 |
| 前端二:构建第一个现代应用程序-UI 设计 | 基于设计稿完成组件化界面,实现从设计到代码的第一条链路 | 🚧 |
| 前端三:参考 UI 设计规范与多产品 UI 设计 | 围绕统一主视觉扩展多产品界面,练习系统化设计能力 | 🚧 |
| [前端四:一起做霍格沃茨画像](/zh-cn/stage-2/frontend/2.4-hogwarts-portraits/chapter4-lets-build-hogwarts-portraits) | 从 0 到 1 做出接入 AI 能力的前端应用,串联设计与开发 | 🚧 |
| [前端四:一起做霍格沃茨画像](/zh-cn/stage-2/frontend/2.4-hogwarts-portraits/) | 从 0 到 1 做出接入 AI 能力的前端应用,串联设计与开发 | 🚧 |
#### 后端与全栈部分
| 章节 | 关键内容 | 状态 |
| :---------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------ | :--- |
| 后端一:什么是 API | 理解 HTTP 接口与请求响应模型,为后端集成与联调做准备 | 🚧 |
| [后端二:从数据库到 Supabase](/zh-cn/stage-2/backend/2.2-database-supabase/chapter5/chapter5-from-database-to-supabase) | 在 Supabase 上落地数据库和 API,打通数据模型与前端页面 | 🚧 |
| [后端二:从数据库到 Supabase](/zh-cn/stage-2/backend/2.2-database-supabase/chapter5/) | 在 Supabase 上落地数据库和 API,打通数据模型与前端页面 | 🚧 |
| 后端三:大模型辅助编写接口代码与接口文档 | 用大模型协助生成接口与数据库文档及代码,实现可读可测的后端 | 🚧 |
| 后端四:Git 工作流与 Zeabur 部署 | 在 Git 工作流中管理代码,并将应用部署到 Zeabur 上线 | 🚧 |
| 后端五:现代 CLI 开发工具 | 使用 CLI 类 AI 编程工具加速开发与调试,形成个人工程化工作流 | 🚧 |
@@ -72,7 +72,7 @@
| 章节 | 关键内容 | 状态 |
| :-------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------- | :--- |
| [AI 一:Dify 入门与知识库集成](/zh-cn/stage-2/ai-capabilities/2.1-dify-knowledge-base/chapter3/chapter3-getting-started-with-dify-and-its-knowledge-base-integration) | 用 Dify Workflow 与基础 RAG 搭建工具类产品,为后续应用升级打样 | 🚧 |
| [AI 一:Dify 入门与知识库集成](/zh-cn/stage-2/ai-capabilities/2.1-dify-knowledge-base/chapter3/) | 用 Dify Workflow 与基础 RAG 搭建工具类产品,为后续应用升级打样 | 🚧 |
| AI 二:学会查询 AI 词典与集成多模态 API | 学会查找合适的模型与 API,并把文本、图像等多模态能力接入产品 | 🚧 |
### 三、高级开发工程师
+6 -6
View File
@@ -29,14 +29,14 @@
<NavGrid>
<NavCard
href="/easy-vibe/zh-cn/stage-1/1.0-finding-great-idea/"
title="1. 找到好点子"
description="学会寻找和验证产品想法,找到值得做的项目。"
href="/easy-vibe/zh-cn/stage-1/1.1-introduction-to-ai-ide/"
title="1. 学会 AI 编程工具"
description="了解当前主流的 AI 编程工具,选择最适合你的开发搭档。"
/>
<NavCard
href="/easy-vibe/zh-cn/stage-1/1.1-introduction-to-ai-ide/"
title="2. 学会 AI 编程工具"
description="了解当前主流的 AI 编程工具,选择最适合你的开发搭档。"
href="/easy-vibe/zh-cn/stage-1/1.0-finding-great-idea/"
title="2. 找到好点子"
description="学会寻找和验证产品想法,找到值得做的项目。"
/>
<NavCard
href="/easy-vibe/zh-cn/stage-1/1.2-building-prototype/"
@@ -484,7 +484,69 @@ const duration = '约 <strong>3 小时</strong>'
这一节,我们将学习如何从普通想法中发现真实痛点。
### 2.1 案例:从"卡路里测量"中发现痛点
### 2.1 从爱好出发——找到你真正热爱的领域
在寻找创业点子时,有一个被严重低估的方法:<strong>从你自己的爱好出发</strong>。
::: tip 为什么爱好是最好的起点?
**1. 你天然理解这个群体**
- 你自己就是用户,你知道这个群体的真实痛点
- 你了解他们的语言、习惯、情感诉求
- 你不需要做大量的用户调研,因为你就在其中
**2. 热情是最好的驱动力**
- 创业是漫长而艰难的旅程,热爱让你能坚持更久
- 你会愿意花时间去深入了解,不断打磨产品
- 即使遇到困难,热情也会推动你找到解决方案
**3. 天然的用户共情能力**
- 你能感同身受地理解用户的 frustrations
- 你知道什么功能真正重要,什么是锦上添花
- 你的产品决策会更贴近真实需求
:::
::: info 案例:从爱好中诞生的成功产品
**案例一:Strava(运动社交平台)**
- 创始人是狂热的自行车爱好者
- 他发现骑行者渴望记录和分享自己的路线、成绩
- 因为自己就是用户,所以产品功能非常贴合需求
- 现在成为全球最大的运动社交平台之一
**案例二:Notion(笔记工具)**
- 创始人是效率工具的重度用户
- 他自己就是目标用户,深知知识管理的痛点
- 从个人需求出发,逐步扩展到团队协作
- 现在估值超过 100 亿美元
**案例三:B站(哔哩哔哩)**
- 创始人徐逸本身就是二次元文化的爱好者
- 他深刻理解 ACG 群体的需求和社区文化
- 从个人兴趣出发,打造了独特的弹幕文化
- 现在成为中国最大的年轻人文化社区
:::
::: warning 关键洞察:你的爱好 + 群体痛点 = 最好的种子用户
当你从自己的爱好出发时:
- <strong>你天然可以共情</strong>——你知道用户的喜怒哀乐
- <strong>你拥有最好的种子用户</strong>——你的朋友、同好就是这个群体
- <strong>你能做出最好的应用</strong>——因为你真正理解需求
**问问自己:**
1. 你平时最喜欢做什么?(游戏、运动、阅读、音乐、手工……)
2. 在这个爱好中,你有什么 frustrations
3. 你的同好们经常抱怨什么?
4. 如果有一个产品能解决这些问题,你会用吗?会付费吗?
**记住:** 最好的产品往往诞生于创始人解决自己问题的过程中。
:::
### 2.2 案例:从"卡路里测量"中发现痛点
让我们从一个最简单的 idea 开始,看看如何从中发现真实痛点。
@@ -253,7 +253,7 @@ const duration = '约 <strong>8 小时</strong>'
## 2. 10分钟产出原型:让 AI IDE 落地"核心玩法"
::: info 💡 编程 Plan 建议
如果你觉得当前 IDE 不够聪明,或者觉得很快就花完了额度,你可以去买一个**编程 Plan 计划**。提前预习参考[这个文章](../../stage-2/backend/2.6-modern-cli/extra7/extra7-cli-ai-coding-tools-and-the-principles-of-test-driven-development.md)使用 Claude 进行编程。
如果你觉得当前 IDE 不够聪明,或者觉得很快就花完了额度,你可以去买一个**编程 Plan 计划**。提前预习参考[这个文章](../../stage-2/backend/2.6-modern-cli/extra7/)使用 Claude 进行编程。
:::
Thinking 是好事,但不可 over thinking,我们就此控制过度反思,尝试从单个页面开始制作原型。
@@ -1,4 +1,4 @@
# Project 3: Dify 入门与知识库集成
# Dify 入门与知识库集成
# 回顾上节课
@@ -210,7 +210,7 @@ Dify 是一个用于开发 LLM 应用的开源平台。它提供了直观的界
本部分内容原本安排在后续课程中详细介绍,但考虑到当前部分学习者可能因网络限制暂时无法访问 Dify 官方网站或云端服务,我们决定提前提供这一可选的学习路径,帮助你顺利推进课程进度。
你需要参考该教程入门 Zeabur 部署平台的基本使用方式:[Extra Knowledge 6 - Zeabur: What Is It and How to Deploy Web Applications](https://github.com/datawhalechina/easy-vibe/blob/main/docs/extra/extra6/extra6-zeabur-what-is-it-and-how-to-deploy-web-applications.md)
你需要参考该教程入门 web 部署平台的基本使用方式:[如何部署 Web 应用](/zh-cn/stage-2/backend/2.5-zeabur-deployment/extra6/)
![](images/image13.png)
@@ -1,4 +1,4 @@
# 扩展知识 2 - API 开发手册:从核心逻辑到 AI 场景集成
# API 开发手册:从核心逻辑到 AI 场景集成
随着数字化进程的加速,我们每天都在与成百上千个软件系统打交道。但对于初学者来说,一个始终绕不开的困惑是:**这些看起来互不相干的应用,到底是怎么“对话”的?** 为什么我在这个 App 里点一下,另一个 App 就能立刻做出反应?
@@ -1,4 +1,4 @@
# Project 5: 从数据库到 Supabase
# 从数据库到 Supabase
在上节课中,我们学会了 UI 设计程序 Mastergo 和 Figma 的基本用法,能够使用 github 进行代码的获取与版本管理,并通过 Zeabur 部署网站将自己的应用 / 网站传达给更多人使用。
@@ -1,4 +1,4 @@
# 扩展知识 1 - 什么是 Git 和 GitHub
# 什么是 Git 和 GitHub
在之前的课程中,我们学习了如何使用基于 Web 的 vibe coding 工具编写代码。每次对话都会创建一个新版本的代码。但是,让我们思考一个问题:如果我们想恢复到之前的修改,有没有方便的方法?有没有一种工具可以记录我们在不同阶段的代码,使我们能够随时在不同版本之间切换和修改?
@@ -1,4 +1,4 @@
# 扩展知识 6 - 如何部署 Web 应用
# 如何部署 Web 应用
在本教程中,我们将介绍如何将你的 Web 应用部署到互联网上,让其他人可以访问。我们会介绍三个常用的部署平台:**腾讯云 CloudBase**、**Vercel** 和 **Zeabur**,帮助你快速完成从"写好代码"到"让别人可以在互联网上访问你的网站"的完整流程。
@@ -1,4 +1,4 @@
# 扩展知识 7 - CLI AI 编程工具与测试驱动开发原则
# CLI AI 编程工具与测试驱动开发原则
在本教程中,我们将介绍直接在命令行中运行的 AI 编程 Agent。它们和之前学过的 Trae、Cursor 中的 Agent 不同,CLI AI 编程工具只能在终端中使用。与集成在 AI IDE 里的 Agent 相比,它们通常具有更长的上下文窗口、更快的工具调用速度,并且可以兼容更多种类的大模型。在最新的 AI Vibe Coding 实战中,我们往往会优先使用 CLI AI 编程工具,而不是 IDE 内置的编码 Agent。
@@ -1,3 +1,3 @@
# 后端六:如何集成 Stripe 等收费系统
# 如何集成 Stripe 等收费系统
> 本章节正在编写中,敬请期待...
@@ -533,9 +533,9 @@ curl -X POST 'http://xxxxxxxx/v1/chat-messages' \
终于,恭喜你顺利完成了 Hogwarts Portraits 页面的开发实现!接下来我们需要将它上传到 GitHub 平台,并将其部署到公共环境让所有人都能访问。
你需要参考该教程,对如何使用 Github 进行研究,将自己的项目上传至 Github:[什么是 Github](https://datawhalechina.github.io/easy-vibe/stage-2/backend/2.4-git-workflow/extra1/extra1-what-is-git-and-what-is-github.html)
你需要参考该教程,对如何使用 Github 进行研究,将自己的项目上传至 Github:[什么是 Github](https://datawhalechina.github.io/easy-vibe/stage-2/backend/2.4-git-workflow/extra1/)
此外,你还需要学会如何使用 Zeabur,将其连接到 Github,并成功部署你的项目:[什么是 Zeabur](https://datawhalechina.github.io/easy-vibe/stage-2/backend/2.5-zeabur-deployment/extra6/extra6-zeabur-what-is-it-and-how-to-deploy-web-applications.html)
此外,你还需要学会如何使用 Zeabur,将其连接到 Github,并成功部署你的项目:[什么是 Zeabur](https://datawhalechina.github.io/easy-vibe/stage-2/backend/2.5-zeabur-deployment/extra6/)
如果你觉得自己开发一套 Hogwarts Portraits 项目很困难,你可以先从参考别的项目开始进行修改,本节课的官方代码地址为:https://github.com/THU-SIGS-AIID/Project4-Hogwarts-Portraits
+9 -9
View File
@@ -30,7 +30,7 @@
description="学习主流 UI 设计规范,提升产品设计的一致性与美感"
/>
<NavCard
href="/easy-vibe/zh-cn/stage-2/frontend/2.4-hogwarts-portraits/chapter4-lets-build-hogwarts-portraits"
href="/easy-vibe/zh-cn/stage-2/frontend/2.4-hogwarts-portraits/"
title="前端四:一起做霍格沃茨画像"
description="实战项目:结合 AI 生成的图像,构建一个交互式的霍格沃茨画像应用"
/>
@@ -42,12 +42,12 @@
<NavGrid>
<NavCard
href="/easy-vibe/zh-cn/stage-2/backend/2.1-what-is-api/extra2/extra2-what-is-api"
href="/easy-vibe/zh-cn/stage-2/backend/2.1-what-is-api/extra2/"
title="后端一:什么是 API"
description="理解 API 的核心概念,它是前后端交互的桥梁"
/>
<NavCard
href="/easy-vibe/zh-cn/stage-2/backend/2.2-database-supabase/chapter5/chapter5-from-database-to-supabase"
href="/easy-vibe/zh-cn/stage-2/backend/2.2-database-supabase/chapter5/"
title="后端二:从数据库到 Supabase"
description="掌握关系型数据库基础,并学习使用 Supabase 这一现代 BaaS 平台"
/>
@@ -57,17 +57,17 @@
description="利用 AI 辅助生成后端接口代码及标准的接口文档,提升开发效率"
/>
<NavCard
href="/easy-vibe/zh-cn/stage-2/backend/2.4-git-workflow/extra1/extra1-what-is-git-and-what-is-github"
href="/easy-vibe/zh-cn/stage-2/backend/2.4-git-workflow/extra1/"
title="后端四:Git 工作流"
description="掌握 Git 版本控制系统的核心操作与协作流程"
/>
<NavCard
href="/easy-vibe/zh-cn/stage-2/backend/2.5-zeabur-deployment/extra6/extra6-zeabur-what-is-it-and-how-to-deploy-web-applications"
title="后端五:Zeabur 部署"
href="/easy-vibe/zh-cn/stage-2/backend/2.5-zeabur-deployment/extra6/"
title="后端五:如何部署 Web 应用"
description="学习使用 Zeabur 快速部署你的全栈应用到云端"
/>
<NavCard
href="/easy-vibe/zh-cn/stage-2/backend/2.6-modern-cli/extra7/extra7-cli-ai-coding-tools-and-the-principles-of-test-driven-development"
href="/easy-vibe/zh-cn/stage-2/backend/2.6-modern-cli/extra7/"
title="后端六:现代 CLI 开发工具"
description="探索现代 CLI 工具,提升命令行环境下的开发体验"
/>
@@ -99,12 +99,12 @@
<NavGrid>
<NavCard
href="/easy-vibe/zh-cn/stage-2/ai-capabilities/2.1-dify-knowledge-base/chapter3/chapter3-getting-started-with-dify-and-its-knowledge-base-integration"
href="/easy-vibe/zh-cn/stage-2/ai-capabilities/2.1-dify-knowledge-base/chapter3/"
title="AI 一:Dify 入门与知识库集成"
description="学习使用 Dify 构建 AI 应用,并集成私有知识库"
/>
<NavCard
href="/easy-vibe/zh-cn/stage-2/ai-capabilities/2.2-multimodal-api/extra3/extra3-ai-capability-starter-handbook"
href="/easy-vibe/zh-cn/stage-2/ai-capabilities/2.2-multimodal-api/extra3/"
title="AI 二:学会查询 AI 词典与集成多模态 API"
description="探索更多 AI 能力,集成视觉、语音等多模态 API"
/>
+1 -1
View File
@@ -66,7 +66,7 @@
<NavGrid>
<NavCard
href="/easy-vibe/zh-cn/stage-3/ai-advanced/3.a1-rag-introduction/extra5-what-is-rag-and-how-does-it-work-and-future"
href="/easy-vibe/zh-cn/stage-3/ai-advanced/3.a1-rag-introduction/"
title="高级 AI 一:什么是 RAG 以及它如何工作"
description="深入理解检索增强生成 (RAG) 的原理及其在 AI 应用中的价值"
/>