From 3d932c1e0a4afec08ed7229820a46d68c6a69d2b Mon Sep 17 00:00:00 2001 From: sanbuphy Date: Fri, 27 Feb 2026 21:58:38 +0800 Subject: [PATCH] refactor(docs): update links and restructure content for clarity - Update internal links to remove extra path segments - Restructure backend architecture documentation for better readability - Reorganize sidebar sections for consistency - Fix broken links and improve navigation flow --- docs/.vitepress/config.mjs | 24 +++++-------------- .../1.1-introduction-to-ai-ide/index.md | 2 +- .../stage-1/1.2-building-prototype/index.md | 2 +- docs/ja-jp/stage-2/index.md | 10 ++++---- docs/zh-cn/guide/introduction.md | 4 ++-- .../1.1-introduction-to-ai-ide/index.md | 2 +- .../stage-1/1.2-building-prototype/index.md | 2 +- .../2.1-dify-knowledge-base/index.md | 2 +- .../frontend/2.4-hogwarts-portraits/index.md | 4 ++-- docs/zh-cn/stage-2/index.md | 12 +++++----- 10 files changed, 26 insertions(+), 38 deletions(-) diff --git a/docs/.vitepress/config.mjs b/docs/.vitepress/config.mjs index d5a051d..dcba34e 100644 --- a/docs/.vitepress/config.mjs +++ b/docs/.vitepress/config.mjs @@ -368,7 +368,7 @@ const stage2SidebarEn = [ const stage3SidebarEn = [ { - text: 'Core Skills', + text: 'Claude Code In-Depth', collapsed: false, items: [ { @@ -400,13 +400,7 @@ const stage3SidebarEn = [ { text: 'Advanced 6: iOS App - SwiftUI', link: '/zh-cn/stage-3/cross-platform/3.6-ios-app/' - } - ] - }, - { - text: 'Personal Brand', - collapsed: false, - items: [ + }, { text: 'Advanced 7: Personal Website & Blog', link: '/zh-cn/stage-3/personal-brand/3.7-personal-website-blog/' @@ -414,7 +408,7 @@ const stage3SidebarEn = [ ] }, { - text: 'AI Advanced Appendix', + text: 'AI Advanced', collapsed: false, items: [ { @@ -1173,7 +1167,7 @@ export default defineConfig({ ], '/zh-cn/stage-3/': [ { - text: '核心技能', + text: 'claudecode 深入浅出', collapsed: false, items: [ { @@ -1229,13 +1223,7 @@ export default defineConfig({ { text: '如何开发工业级 Qt 桌面应用', link: '/zh-cn/stage-3/cross-platform/3.13-qt-industrial-hmi/' - } - ] - }, - { - text: '个人品牌', - collapsed: false, - items: [ + }, { text: '如何构建属于自己的个人网页与学术博客', link: '/zh-cn/stage-3/personal-brand/3.7-personal-website-blog/' @@ -1243,7 +1231,7 @@ export default defineConfig({ ] }, { - text: 'AI 能力附录', + text: 'AI 能力强化', collapsed: false, items: [ { diff --git a/docs/en/stage-1/1.1-introduction-to-ai-ide/index.md b/docs/en/stage-1/1.1-introduction-to-ai-ide/index.md index 54900cc..08685ae 100644 --- a/docs/en/stage-1/1.1-introduction-to-ai-ide/index.md +++ b/docs/en/stage-1/1.1-introduction-to-ai-ide/index.md @@ -16,7 +16,7 @@ We'll first clarify **what the difference is between an IDE and an AI IDE**, and After completing this chapter, you'll have **mastered a development workflow similar to that of professional programmers**. ::: tip 💡 Advanced Tip -If you have some programming experience and want to use more powerful tools early on, you can refer to [Modern CLI Coding Tools](../../stage-2/backend/2.6-modern-cli/extra7/) to develop using the command line. +If you have some programming experience and want to use more powerful tools early on, you can refer to [Modern CLI Coding Tools](../../stage-2/backend/2.6-modern-cli/) to develop using the command line. ::: diff --git a/docs/en/stage-1/1.2-building-prototype/index.md b/docs/en/stage-1/1.2-building-prototype/index.md index ed9c632..72453ff 100644 --- a/docs/en/stage-1/1.2-building-prototype/index.md +++ b/docs/en/stage-1/1.2-building-prototype/index.md @@ -253,7 +253,7 @@ This is what we need to figure out before writing code. Code is just a tool; **u ## 2. Generate Prototype in 10 Minutes: Let AI IDE Implement "Core Gameplay" ::: info Programming Plan Suggestion -If you feel the current IDE isn't smart enough, or you run out of quota quickly, you can buy a **programming Plan**. Preview in advance by referring to [this article](../../stage-2/backend/2.6-modern-cli/extra7/) for programming with Claude. +If you feel the current IDE isn't smart enough, or you run out of quota quickly, you can buy a **programming Plan**. Preview in advance by referring to [this article](../../stage-2/backend/2.6-modern-cli/) for programming with Claude. ::: Thinking is good, but don't overthink. Let's control excessive reflection and try making a prototype starting from a single page. diff --git a/docs/ja-jp/stage-2/index.md b/docs/ja-jp/stage-2/index.md index f5d88da..0d35cfd 100644 --- a/docs/ja-jp/stage-2/index.md +++ b/docs/ja-jp/stage-2/index.md @@ -55,7 +55,7 @@ API設計、データベース管理、アプリケーションデプロイメント戦略を学ぶ： - +
🗄️ @@ -75,7 +75,7 @@ API設計、データベース管理、アプリケーションデプロイメ
- +
🌿 @@ -85,7 +85,7 @@ API設計、データベース管理、アプリケーションデプロイメ
- +
🚀 @@ -95,7 +95,7 @@ API設計、データベース管理、アプリケーションデプロイメ
- +
💻 @@ -135,7 +135,7 @@ API設計、データベース管理、アプリケーションデプロイメ ### AI機能拡張 - +
🎭 diff --git a/docs/zh-cn/guide/introduction.md b/docs/zh-cn/guide/introduction.md index 189d04c..f426e76 100644 --- a/docs/zh-cn/guide/introduction.md +++ b/docs/zh-cn/guide/introduction.md @@ -60,7 +60,7 @@ | 章节 | 关键内容 | 状态 | | :---------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------ | :--- | | 后端一：什么是 API | 理解 HTTP 接口与请求响应模型，为后端集成与联调做准备 | 🚧 | -| [后端二：从数据库到 Supabase](/zh-cn/stage-2/backend/2.2-database-supabase/chapter5/) | 在 Supabase 上落地数据库和 API，打通数据模型与前端页面 | 🚧 | +| [后端二：从数据库到 Supabase](/zh-cn/stage-2/backend/2.2-database-supabase/) | 在 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/) | 用 Dify Workflow 与基础 RAG 搭建工具类产品，为后续应用升级打样 | 🚧 | +| [AI 一：Dify 入门与知识库集成](/zh-cn/stage-2/ai-capabilities/2.1-dify-knowledge-base/) | 用 Dify Workflow 与基础 RAG 搭建工具类产品，为后续应用升级打样 | 🚧 | | AI 二：学会查询 AI 词典与集成多模态 API | 学会查找合适的模型与 API，并把文本、图像等多模态能力接入产品 | 🚧 | ### 三、高级开发工程师 diff --git a/docs/zh-cn/stage-1/1.1-introduction-to-ai-ide/index.md b/docs/zh-cn/stage-1/1.1-introduction-to-ai-ide/index.md index c32b56d..7cd76a2 100644 --- a/docs/zh-cn/stage-1/1.1-introduction-to-ai-ide/index.md +++ b/docs/zh-cn/stage-1/1.1-introduction-to-ai-ide/index.md @@ -16,7 +16,7 @@ const duration = '约 1 天，可分多次完成' 学完这一章，你将会掌握和程序员相似的开发流程。 ::: tip 💡 进阶提示 -如果你有一定的编程基础，想要提前使用更强大的工具，可以结合参考 [现代 CLI Coding 工具](../../stage-2/backend/2.6-modern-cli/extra7/) 使用命令行方式进行开发。 +如果你有一定的编程基础，想要提前使用更强大的工具，可以结合参考 [现代 CLI Coding 工具](../../stage-2/backend/2.6-modern-cli/) 使用命令行方式进行开发。 ::: diff --git a/docs/zh-cn/stage-1/1.2-building-prototype/index.md b/docs/zh-cn/stage-1/1.2-building-prototype/index.md index 81d8757..b89763a 100644 --- a/docs/zh-cn/stage-1/1.2-building-prototype/index.md +++ b/docs/zh-cn/stage-1/1.2-building-prototype/index.md @@ -253,7 +253,7 @@ const duration = '约 8 小时' ## 2. 10分钟产出原型：让 AI IDE 落地"核心玩法" ::: info 💡 编程 Plan 建议 -如果你觉得当前 IDE 不够聪明，或者觉得很快就花完了额度，你可以去买一个**编程 Plan 计划**。提前预习参考[这个文章](../../stage-2/backend/2.6-modern-cli/extra7/)使用 Claude 进行编程。 +如果你觉得当前 IDE 不够聪明，或者觉得很快就花完了额度，你可以去买一个**编程 Plan 计划**。提前预习参考[这个文章](../../stage-2/backend/2.6-modern-cli/)使用 Claude 进行编程。 ::: Thinking 是好事，但不可 over thinking，我们就此控制过度反思，尝试从单个页面开始制作原型。 diff --git a/docs/zh-cn/stage-2/ai-capabilities/2.1-dify-knowledge-base/index.md b/docs/zh-cn/stage-2/ai-capabilities/2.1-dify-knowledge-base/index.md index 4da7da9..c8d9363 100644 --- a/docs/zh-cn/stage-2/ai-capabilities/2.1-dify-knowledge-base/index.md +++ b/docs/zh-cn/stage-2/ai-capabilities/2.1-dify-knowledge-base/index.md @@ -210,7 +210,7 @@ Dify 是一个用于开发 LLM 应用的开源平台。它提供了直观的界 本部分内容原本安排在后续课程中详细介绍，但考虑到当前部分学习者可能因网络限制暂时无法访问 Dify 官方网站或云端服务，我们决定提前提供这一可选的学习路径，帮助你顺利推进课程进度。 -你需要参考该教程入门 web 部署平台的基本使用方式：[如何部署 Web 应用](/zh-cn/stage-2/backend/2.5-zeabur-deployment/extra6/) +你需要参考该教程入门 web 部署平台的基本使用方式：[如何部署 Web 应用](/zh-cn/stage-2/backend/2.5-zeabur-deployment/) ![](images/image13.png) diff --git a/docs/zh-cn/stage-2/frontend/2.4-hogwarts-portraits/index.md b/docs/zh-cn/stage-2/frontend/2.4-hogwarts-portraits/index.md index aef8d72..8f5955d 100644 --- a/docs/zh-cn/stage-2/frontend/2.4-hogwarts-portraits/index.md +++ b/docs/zh-cn/stage-2/frontend/2.4-hogwarts-portraits/index.md @@ -314,9 +314,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/) +你需要参考该教程，对如何使用 Github 进行研究，将自己的项目上传至 Github：[什么是 Github](/zh-cn/stage-2/backend/2.4-git-workflow/) -此外，你还需要学会如何使用 Zeabur，将其连接到 Github，并成功部署你的项目：[什么是 Zeabur](https://datawhalechina.github.io/easy-vibe/stage-2/backend/2.5-zeabur-deployment/extra6/) +此外，你还需要学会如何使用 Zeabur，将其连接到 Github，并成功部署你的项目：[什么是 Zeabur](/zh-cn/stage-2/backend/2.5-zeabur-deployment/) 如果你觉得自己开发一套 Hogwarts Portraits 项目很困难，你可以先从参考别的项目开始进行修改，本节课的官方代码地址为：https://github.com/THU-SIGS-AIID/Project4-Hogwarts-Portraits diff --git a/docs/zh-cn/stage-2/index.md b/docs/zh-cn/stage-2/index.md index 86a6438..d9d5609 100644 --- a/docs/zh-cn/stage-2/index.md +++ b/docs/zh-cn/stage-2/index.md @@ -37,12 +37,12 @@ @@ -52,12 +52,12 @@ description="利用 AI 辅助生成后端接口代码及标准的接口文档，提升开发效率" /> @@ -89,12 +89,12 @@