vectorpeak-blogs 是 VectorPeak 的个人技术博客与知识站点。它不是一个只负责展示页面的文档模板，而是一个持续生长的 knowledge garden：把 Agent、RAG、算法、深度学习和阶段性思考，整理成可检索、可复盘、可迭代的公开知识资产。
项目的核心目标是：让零散学习笔记从“临时记录”升级为“可长期复用的知识系统”。如果把普通博客比作一排文章橱窗，那么这个仓库更像一座技术温室：不同主题分区生长，但都服务于同一件事——沉淀清晰的问题、路径、概念和实践证据。
当前仓库已经具备一个可运行的 Mintlify 知识站点骨架，并围绕 Agent、RAG、LeetCode、DeepLearning 等方向形成内容分区。README 的定位是帮助读者快速理解：这个站点写什么、如何组织、如何本地预览，以及未来如何持续维护。
当前内容边界如下：
- Guides：站点说明、写作入口、阶段性反思与通用笔记。
- Agent：Agent 理论、框架生态、LangChain、LangGraph、MCP、多智能体与现代 Coding Agent 观察。
- RAG：从检索基础、切分、Embedding、Milvus、重排，到生产化、评估和 Agentic RAG 的系统化笔记。
- LeetCode：算法路线图、题目整理、解题方法与长期训练记录。
- DeepLearning：深度学习相关学习记录、实验实践和接口示例。
- mint-skills / tools / src：用于站点内容生产、自动化检查或辅助构建的本地工程化支持。
仓库当前已经具备：
docs.json驱动的 Mintlify 站点配置。index.mdx作为站点首页入口。- 多主题内容目录：
Agent/、RAG/、LeetCode/、DeepLearning/、Guides/。 - 图片与静态资源目录：
images/、public/。 - 站点辅助脚本与工具目录：
tools/、src/、beian-footer.js。 - 面向协作与内容生成的
AGENTS.md约束。 - MIT License。
站点内容遵循 Concept → Practice → Reflection → Reuse 的组织思路：先解释概念，再沉淀实践路径，最后通过复盘和交叉链接把知识变成可复用资产。
flowchart LR
A["学习输入<br/>论文 / 文档 / 项目 / 实验"] --> B["概念拆解<br/>术语、边界、对偶概念"]
B --> C["实践记录<br/>代码、配置、实验、问题"]
C --> D["结构化页面<br/>Mintlify MDX 文档"]
D --> E["站点导航<br/>docs.json 分组索引"]
E --> F["复盘复用<br/>路线图、专题页、知识链接"]
F --> B
从上到下看，这个站点不是按“今天写了什么”来组织，而是按“以后如何重新找到、重新理解、重新使用”来组织。
安装 Mintlify CLI：
npm i -g mint在项目根目录启动本地预览：
cd E:\Github\vectorpeak-blogs
mint dev检查站内坏链：
mint broken-links常用维护动作：
# 查看当前 Git 状态
git status --short
# 搜索某个主题关键词
rg "Agent" Agent RAG Guides LeetCode DeepLearning
# 查看站点导航配置
cat docs.json内容生产遵循“先框架、再细节、再证据”的原则：
- 先定义问题：每篇笔记尽量回答“它解决什么问题，而不是只罗列资料”。
- 先搭骨架：重要主题优先写概念边界、术语关系和学习路线，再补充细节。
- 保留上下文：实验、踩坑、配置和结论应尽量写清触发条件，避免脱离环境后失真。
- 避免孤岛化：新页面应尽量放入
docs.json导航，必要时补充与相关主题的链接。 - 区分事实与观点：外部文档、项目行为、个人判断和阶段性猜想应分层表达。
这里的“知识花园”不是随意堆材料，而是把材料种到正确位置。一个概念如果没有边界，就像没有标签的种子；一个实践如果没有复盘，就像只开一次花的枝条。
核心文件与目录如下：
vectorpeak-blogs/
├── AGENTS.md # 内容协作与 Agent 写作约束
├── README.md # 项目入口：定位、结构、流程、本地开发
├── LICENSE # MIT License
├── docs.json # Mintlify 主配置：主题、导航、Logo、上下文工具
├── index.mdx # 站点首页
├── beian-footer.js # 备案页脚等站点辅助脚本
│
├── Guides/ # 通用说明、写作入口、阶段性反思
├── Agent/ # Agent 理论、框架、现代 Agent 观察
├── RAG/ # RAG 基础、检索工程、生产化、评估与高级主题
├── LeetCode/ # 算法路线图、题解整理与训练路径
├── DeepLearning/ # 深度学习笔记、实验与实践内容
│
├── images/ # 图片、Logo 与文档插图资源
├── public/ # Mintlify 静态资源
├── mint-skills/ # 站点相关技能与内容生产辅助材料
├── src/ # 本地辅助源码
└── tools/ # 内容维护、检查或生成脚本
新增或调整内容时，建议按下面顺序检查：
- 页面是否放在正确主题目录下。
- 页面是否已经加入
docs.json导航。 - 标题、文件名和导航名是否保持一致。
- 图片或静态资源是否使用稳定路径。
- 外部概念是否补充来源、边界和反例。
- 本地是否通过
mint dev预览和mint broken-links检查。
这个仓库更接近一个持续演化的个人知识库，而不是一次性完成的教程合集。阅读和维护时建议注意：
- 内容仍在生长：部分页面可能是阶段性笔记、学习草稿或后续专题的入口，不一定代表最终结论。
- 以主题目录为主线：新增内容优先放入
Agent/、RAG/、LeetCode/、DeepLearning/或Guides/，避免在根目录堆叠零散页面。 - 导航需要同步维护：新增页面后，应同步检查
docs.json，否则页面可能存在于仓库中，但不会出现在站点导航里。 - 实践内容要保留环境：涉及代码、实验、工具链或模型调用时，应尽量写清版本、依赖、输入条件和失败边界。
- 个人判断不等于通用结论：反思类内容会包含个人经验和阶段性判断，适合作为参考，而不是直接照搬为工程规范。
- 图片与静态资源要稳定：文档中的图片、Logo 和附件应放在
images/或public/下，并使用可长期维护的路径。
普通博客通常按发布时间组织，更像时间线；vectorpeak-blogs 更偏知识库，按主题和问题组织。它关注的不是“某天写了什么”，而是“某个概念、实践或路线以后能不能被重新找到、理解和复用”。
Mintlify 适合把 Markdown / MDX 内容组织成结构化文档站点：导航清晰、搜索友好、页面风格统一，也便于把学习笔记逐步沉淀成更像产品文档的知识系统。
大概率是页面还没有加入 docs.json 的导航配置。仓库中的文件只是内容实体，docs.json 才决定它是否出现在站点导航中。
它们对应不同层次的技术能力：LeetCode 偏基础算法训练，DeepLearning 偏模型与学习方法，RAG 偏知识系统工程，Agent 偏工具调用、任务规划和自动化执行。四者不是孤立目录，而是从基础能力到 AI 工程系统的连续学习路径。
适合想系统学习 AI 工程、RAG、Agent、算法训练和深度学习实践的人阅读。对于只想复制一份博客模板的人，它也可以作为 Mintlify 站点结构参考，但重点仍然是内容组织方法，而不是页面样式本身。
最常见的问题有三个：新增页面但忘记更新 docs.json；图片路径在本地可用但线上不可用；学习笔记只记录结论，却没有记录问题背景、实验条件和失败边界。
先确认已经安装 Mintlify CLI，并在仓库根目录运行：
npm i -g mint
mint dev如果页面能打开但导航异常，优先检查 docs.json；如果图片或链接异常，运行：
mint broken-links