内容结构化改造(阶段 1):新增 topics/scenarios 目录、内容规范、frontmatter schema、校验与目录生成脚本、31 个技术栈首页骨架,周文件加 frontmatter

This commit is contained in:
Shikui Wang committed 2026-10-23 15:05:36 +08:00
1 parent 32b111606f
commit 0bae9916a9
58 files changed
+2995 -5

No files matched your search

+18 -3
View File
@@ -1,3 +1,11 @@
---
id: plan.index
title: 转岗计划总纲
type: index
domain: plan
stack: []
---
# 转岗计划总纲:Python AI 应用 / Agent 开发为主,Go 全栈为辅(16 周)
这是整个计划的入口文件。换了电脑或者隔一段时间回来,先看第 13 节“进度记录”,再打开当前所在周的计划文件继续做。
@@ -314,15 +322,20 @@
```text
zhuangang/
├── .gitignore # 至少包含 notes/private/、.env、*.db、data/、node_modules/、.venv/
├── README.md
├── plan/ # 本计划(见下面的文件清单)
├── README.md # 仓库入口
├── CONTRIBUTING.md # 内容规范(目录、frontmatter、各类型写法)
├── catalog.json # 内容目录(tools/build_catalog.py 生成)
├── schema/ # frontmatter 的 JSON Schema
├── tools/ # build_catalog.py、run_examples.py、check_sensitive.py
├── plan/ # 本计划:总纲 + 16 个周文件(见下面的文件清单)
├── topics/ # 专项学习:<领域>/<技术栈>/ 课程、场景、面试题、示例
├── scenarios/ # 跨技术栈的企业服务场景
├── go-learning/ # 第 1 周:Go 语法练习
├── todo-api/ # 第 1~2 周:Gin 接口 + PostgreSQL + JWT
├── task-board/ # 第 3 周:项目一后端
├── py-learning/ # 第 4 周:Python 练习 + FastAPI
├── rag-qa/ # 第 5~6 周:项目二
├── web/ # 第 7 周:pnpm monorepo(shared、board-vue、rag-react)
├── tools/ # 第 8 周:check_sensitive.py(提交前脱敏检查)
├── notes/ # 第 8~9 周:盘点、架构图、案例卡(脱敏);低代码体验笔记
│ ├── cards/
│ └── private/ # 不进仓库
@@ -333,6 +346,8 @@ zhuangang/
└── career/ # 第 15~16 周:简历、口述稿、面试笔记
```
**周计划和专题的关系**:周文件是“日程”——每天做什么、建哪些文件、怎么验收;概念讲解、企业场景和面试题在 `topics/` 和 `scenarios/` 里,周文件开头的“本周相关专题”列出了链接。单独补某个技术栈时直接从 [topics/index.md](../topics/index.md) 进入。
### 计划文件清单(`plan/`)
| 文件 | 内容 |
+11
View File
@@ -1,3 +1,14 @@
---
id: plan.week01
title: "第 1 周:Go 基础 + Gin 写 REST 接口"
type: week
domain: plan
stack: [go, gin, git]
week: [1]
est_hours: 12
order: 1
---
# 第 1 周:Go 基础 + Gin 写 REST 接口
> 第一段“Go 全栈基础”(第 1~3 周)的第 1 周。总纲见 `README.md`,下周 `week02-db-auth.md`。
+11
View File
@@ -1,3 +1,14 @@
---
id: plan.week02
title: "第 2 周:数据库(PostgreSQL 为主,兼顾 MySQL)+ 注册登录与 JWT"
type: week
domain: plan
stack: [go, gin, postgresql, mysql]
week: [2]
est_hours: 12
order: 2
---
# 第 2 周:数据库(PostgreSQL 为主,兼顾 MySQL)+ 注册登录与 JWT
> 第一段“Go 全栈基础”的第 2 周。上周 `week01-go-gin.md`,下周 `week03-project1.md`。
+11
View File
@@ -1,3 +1,14 @@
---
id: plan.week03
title: "第 3 周:项目一“团队任务看板”:权限 + Redis + 消息队列 + Docker 部署"
type: week
domain: plan
stack: [go, gin, postgresql, redis, mq, docker, nginx, cicd]
week: [3]
est_hours: 12
order: 3
---
# 第 3 周:项目一“团队任务看板”:权限 + Redis + 消息队列 + Docker 部署
> 第一段“Go 全栈基础”的最后一周。上周 `week02-db-auth.md`,下周 `week04-python.md`。
+11
View File
@@ -1,3 +1,14 @@
---
id: plan.week04
title: "第 4 周:Python 速成(给 JS 开发者)+ FastAPI 基础"
type: week
domain: plan
stack: [python, asyncio, fastapi]
week: [4]
est_hours: 12
order: 4
---
# 第 4 周:Python 速成(给 JS 开发者)+ FastAPI 基础
> 第二段“Python 与 AI 应用”的第 1 周。从这周起 **Python 是求职主语言**。上周 `week03-project1.md`,下周 `week05-rag-1.md`。
+11
View File
@@ -1,3 +1,14 @@
---
id: plan.week05
title: "第 5 周:RAG 知识库问答(上)——手写主流程"
type: week
domain: plan
stack: [asyncio, fastapi, rag, vector-db, prompt-engineering]
week: [5]
est_hours: 12
order: 5
---
# 第 5 周:RAG 知识库问答(上)——手写主流程
> 第二段“Python 与 AI 应用”的第 2 周,也是**项目二 `rag-qa`** 的第 1 周。上周 `week04-python.md`,下周 `week06-rag-2.md`(评测、混合检索、重排、缓存、LangChain 对照、部署)。前端界面放到第 7 周统一做。
+11
View File
@@ -1,3 +1,14 @@
---
id: plan.week06
title: "第 6 周:RAG 知识库问答(下)——评测、混合检索、重排、记忆、缓存、LangChain、部署"
type: week
domain: plan
stack: [postgresql, redis, docker, rag, vector-db, langchain]
week: [6]
est_hours: 12
order: 6
---
# 第 6 周:RAG 知识库问答(下)——评测、混合检索、重排、记忆、缓存、LangChain、部署
> 项目二 `rag-qa` 的第 2 周。上周 `week05-rag-1.md` 完成了手写主流程;下周 `week07-frontend.md` 做前端界面。
+11
View File
@@ -1,3 +1,14 @@
---
id: plan.week07
title: "第 7 周:前端工程化查漏补缺 + 两个项目的界面"
type: week
domain: plan
stack: [nginx, cicd, vue, react, typescript, vite, webpack, ssr, fe-testing-perf]
week: [7]
est_hours: 12
order: 7
---
# 第 7 周:前端工程化查漏补缺 + 两个项目的界面
> 第二段的第 4 周。上周 `week06-rag-2.md`,下周 `week08-inventory-architecture.md`。
+11
View File
@@ -1,3 +1,14 @@
---
id: plan.week08
title: "第 8 周:阶段 0 盘点 + 阶段 1 读通与画图"
type: week
domain: plan
stack: [git]
week: [8]
est_hours: 12
order: 8
---
# 第 8 周:阶段 0 盘点 + 阶段 1 读通与画图
> 第三段“Agent 主线”的第 1 周。上周 `week07-frontend.md`,下周 `week09-case-cards.md`。
+11
View File
@@ -1,3 +1,14 @@
---
id: plan.week09
title: "第 9 周:阶段 2——五个重点 A~E 深挖 + 案例卡"
type: week
domain: plan
stack: []
week: [9]
est_hours: 12
order: 9
---
# 第 9 周:阶段 2——五个重点 A~E 深挖 + 案例卡
> 第三段的第 2 周。上周 `week08-inventory-architecture.md`,下周 `week10-agent-m1-tools-mcp.md`。
+11
View File
@@ -1,3 +1,14 @@
---
id: plan.week10
title: "第 10 周:项目三 M1——手写工具调用循环 + 手写多 Agent 循环 + MCP 服务"
type: week
domain: plan
stack: [mcp, function-calling]
week: [10]
est_hours: 12
order: 10
---
# 第 10 周:项目三 M1——手写工具调用循环 + 手写多 Agent 循环 + MCP 服务
> 第三段的第 3 周,**项目三 `agent-mini`(阶段 3 主交付)** 的第 1 周。上周 `week09-case-cards.md`,下周 `week11-agent-m2-langgraph.md`。
+11
View File
@@ -1,3 +1,14 @@
---
id: plan.week11
title: "第 11 周:项目三 M2——用 LangGraph 实现多 Agent 编排"
type: week
domain: plan
stack: [langchain, langgraph, mcp, prompt-engineering]
week: [11]
est_hours: 12
order: 11
---
# 第 11 周:项目三 M2——用 LangGraph 实现多 Agent 编排
> 项目三的第 2 周。上周 `week10-agent-m1-tools-mcp.md`(手写版 + MCP),下周 `week12-agent-m3-persistence.md`(续跑、中断、后台作业、SSE、记忆)。
+11
View File
@@ -1,3 +1,14 @@
---
id: plan.week12
title: "第 12 周:项目三 M3——检查点续跑、人机协作、后台作业、SSE、长期记忆"
type: week
domain: plan
stack: [asyncio, fastapi, langgraph, agent-ops]
week: [12]
est_hours: 12
order: 12
---
# 第 12 周:项目三 M3——检查点续跑、人机协作、后台作业、SSE、长期记忆
> 项目三的第 3 周,**整个计划最核心的一周**:第 9 周案例卡里“若重做的设计”在这里落地。上周 `week11-agent-m2-langgraph.md`,下周 `week13-agent-m4-eval-lowcode.md`。
+11
View File
@@ -1,3 +1,14 @@
---
id: plan.week13
title: "第 13 周:项目三 M4——评测集、可观测性、文档、Docker + Dify / Coze 体验"
type: week
domain: plan
stack: [docker, prompt-engineering, agent-ops, lowcode]
week: [13]
est_hours: 12
order: 13
---
# 第 13 周:项目三 M4——评测集、可观测性、文档、Docker + Dify / Coze 体验
> 项目三的最后一周(阶段 3 出门)。上周 `week12-agent-m3-persistence.md`,下周 `week14-backend-extend-deploy.md`。
+11
View File
@@ -1,3 +1,14 @@
---
id: plan.week14
title: "第 14 周:后端补强——消息队列、gRPC、Redis / MySQL 专题、全部项目部署、CI/CD"
type: week
domain: plan
stack: [go, mysql, redis, mq, grpc-microservices, docker, nginx, linux, cicd]
week: [14]
est_hours: 12
order: 14
---
# 第 14 周:后端补强——消息队列、gRPC、Redis / MySQL 专题、全部项目部署、CI/CD
> 第四段的第 1 周。上周 `week13-agent-m4-eval-lowcode.md`,下周 `week15-package-resume.md`。
+11
View File
@@ -1,3 +1,14 @@
---
id: plan.week15
title: "第 15 周:阶段 4(上)——作品集、简历、STAR 经历、口述稿"
type: week
domain: plan
stack: [git]
week: [15]
est_hours: 12
order: 15
---
# 第 15 周:阶段 4(上)——作品集、简历、STAR 经历、口述稿
> 第四段的第 2 周。上周 `week14-backend-extend-deploy.md`,下周 `week16-interview.md`。
+11
View File
@@ -1,3 +1,14 @@
---
id: plan.week16
title: "第 16 周:阶段 4(下)——面试准备、终点验收、投递"
type: week
domain: plan
stack: []
week: [16]
est_hours: 12
order: 16
---
# 第 16 周:阶段 4(下)——面试准备、终点验收、投递
> 整个计划的最后一周。上周 `week15-package-resume.md`。总纲见 `README.md` 第 14 节“终点验收清单”。