一个基于 Next.js + Fumadocs 的个人技术知识库，面向前端、服务端、算法、Agent 应用开发和个人开发常用资料整理。
安装依赖：
npm install启动开发服务：
npm run dev生产构建：
npm run build本地预览构建产物：
npm run start内容统一放在 content/docs/ 下：
content/docs/
frontend/
tutorial/ # 前端教程
bagu/ # 前端八股
interview/ # 前端面经
backend/
tutorial/ # 服务端教程
bagu/ # 服务端八股
interview/ # 服务端面经
agent/
tutorial/ # Agent 教程
bagu/ # Agent 与 LLM 八股
agent/ # Agent 应用开发、RAG、工具调用和协议
llm/ # LLM 原理、模型机制和微调
interview/ # Agent 应用开发面经
algorithm/
basics/ # 算法基础、STL 和 C++ 常用知识
leetcode/ # LeetCode 专题与刷题复盘
resources/ # 按方向和类型筛选的资源推荐
dev/
conventions/ # 开发规范
linux/ # Linux 常用命令
git/ # Git 基础
tools/ # 工具配置
notes/ # 杂记与读书
站点信息架构由 site.config.ts 统一维护。新增一级方向或调整栏目时，先更新 site.config.ts，再新增对应目录和 Fumadocs meta.json。
- 首页：
/，源码在app/page.tsx。 - 文档总览：
/docs，内容在content/docs/index.mdx。 - 文档页面：
/docs/<section>/<path>，由app/docs/[[...slug]]/page.tsx渲染。
- 选择合适目录，例如
content/docs/frontend/tutorial/React/、content/docs/agent/bagu/agent/或content/docs/algorithm/leetcode/。 - 新增 Markdown 或 MDX 文件，文件名使用清晰标题，可带数字前缀控制排序，例如
01-核心概念.md。 - 文章内图片放在当前专题附近的
img/目录并使用相对路径引用；截图优先使用 WebP，图示优先使用 SVG。 - 如需调整侧边栏展示顺序或目录中文名，编辑对应目录下的
meta.json。 - 提交前运行
npm run build。
首次参与项目请阅读 CONTRIBUTING.md；更完整的写作约束见 docs/writing-style.md，PR 流程见 docs/pull-request.md。
npm run check:content
npm run check:images
npm run check:vue:tags
npm run test:unit
npm run typecheck
npm run build
npm run validate当前项目的本地 hooks 会在 commit 前运行内容结构、图片引用和 Vue 标签闭合检查，在 commit message 阶段运行 commitlint。npm run validate 还会执行单元测试、类型检查和生产构建，作为 CI 与 Vercel 的统一门禁。
文章、书籍、课程、项目、工具、官方文档和论文等推荐统一维护在
lib/resource-directory.ts，并声明所属技术方向与资源类型。
推荐条目结构：
{
title: '推荐标题',
href: 'https://example.com',
description: '资源简介。',
recommendation: '说明适合谁、解决什么问题，以及为什么值得收录。',
sections: ['frontend'],
kind: 'article',
tags: ['React', '工程化'],
}请避免提交：
- 没有推荐理由的链接堆叠。
- 明显重复或质量较低的内容。
- 与当前目录结构无关的文件。
- 未经说明的大规模目录调整。
- 首页：
app/page.tsx - 首页内容统计：
lib/content.ts - 文档路由：
app/docs/[[...slug]]/page.tsx - 文档布局：
app/docs/layout.tsx - 内容源：
lib/source.ts - 站点信息架构：
site.config.ts - 基础样式：
app/global.css - 文档树顺序与目录标题：
content/docs/**/meta.json
本项目使用 MIT License。