【收藏】从“能写“到“写对“：AI Coding知识库建设完全指南

本文探讨AI Coding中知识库建设的关键作用，提出通过Spec知识库（项目级契约）和RAG知识库（外部文档与最佳实践）构建AI的"上下文感知能力"。结合MCP标准化接口，已在猫超导购C端工程中落地应用，有效提升AI生成代码的准确性和可维护性，为AI Coding提供系统化解决方案。

一、引言：AI Coding 提升代码质量的关键——知识库的深度建设

在当前 AI Coding 快速普及的背景下，业界普遍面临一个核心矛盾：模型“能写” ≠ “写得对”。尤其在高频迭代、强业务耦合的场景中，代码的正确性、可维护性和一致性远比“能生成”更重要。

要突破这一瓶颈，关键在于让 AI 不仅“会写”，更要“懂上下文”——即深刻理解特定项目的技术契约、业务语义与工程惯例。为此，我们提出构建一套高质量、结构化的知识体系，作为 AI Coding 的“认知基础设施”。这一体系包含两个互补维度：

• Spec 知识库：基于规范驱动开发（Spec-Driven Development, SDD）沉淀的项目级契约与规则；
• RAG（Retrieval-Augmented Generation）知识库：动态接入外部文档、历史方案、最佳实践等非结构化或半结构化知识。

二者共同构成 AI 的“上下文感知能力”，使其不仅能理解“要做什么”，更能精准把握“怎么做才对”。Spec 提供强约束的“硬规则”，RAG 提供灵活丰富的“软上下文”。本文将系统阐述这一知识体系的构想、落地现状与未来演进。

二、前置知识调研

1.Spec简介：AI Coding 的“宪法”

1.1 什么是Spec？

Spec（Specification，规范） 是对软件系统行为、接口、数据格式或业务规则的精确、无歧义、可验证的描述。在 AI Coding 中，SPEC 扮演着“宪法”的角色——它明确告诉 AI：“代码必须满足哪些条件才算正确”，而不是依赖模型自行猜测、模仿或凭“感觉”生成。

其核心价值体现在两个层面：

• 规范即契约：SPEC 是开发者、AI Agent 与系统之间达成的共识性“契约”，清晰界定“做什么”（What）、“为什么做”（Why）以及“如何做”（How）。
• AI 的指令集：为大语言模型（LLM）提供明确、结构化的上下文，显著减少幻觉（hallucination），提升生成代码的准确性与一致性。

1.2 Spec Coding VS Vibe Coding

随着AI编程普及，开发者分化出两种范式：Vibe Coding 依赖直觉和意图模仿，快但不可靠；Spec Coding 严格遵循规范，可靠且易维护，适合企业级和高要求场景。选择关键在于权衡速度与确定性。对比如下：

2.RAG简介：让 LLM “看得见”你的私有知识

2.1 什么是RAG？

RAG（Retrieval-Augmented Generation） 是一种结合“搜索”与“生成”的技术，使 LLM 在回答问题时能参考外部知识库，生成更准确、可溯源、事实性强的答案。

其工作流程分为三步：

• Retrieve（检索）：根据用户查询，从外部知识库（如文档、数据库）中检索最相关的文本片段；
• Augment（增强）：将检索结果拼接到原始 Prompt 中，形成增强上下文；
• Generate（生成）：LLM 基于增强后的上下文生成最终回答。

2.2 为什么需要 RAG？

尽管 LLM 能力强大，但在实际应用中仍面临诸多局限：知识静态，无法访问私有或实时数据；容易产生幻觉，输出内容可靠性存疑；更新成本高昂，需要重新训练或微调模型。

RAG 提供了一种创新性的解决思路。其核心理念是：不求模型“记住一切”，而让它“懂得查找”。通过按需检索可信知识源，RAG 显著提升了生成内容的准确性、时效性与可溯源性。

下表对比了 LLM 与 RAG 在核心维度上的差异，直观展现 RAG 如何有效弥补 LLM 的实际应用短板。

2.3 RAG工作流程

RAG 系统包含两个核心阶段：离线阶段构建知识库，在线阶段处理实时查询。以下详细介绍高级 RAG 系统在这两个阶段的关键实现流程。

• 离线阶段：知识库构建

• 文档预处理：对原始文档进行清洗，去除噪声和无关信息；

• 智能分块：将长文档切分成语义完整、大小适中的文本片段；

• 索引增强：为文本片段添加元数据（如来源、时间、分类）和关键词标签；

• 向量化编码：使用嵌入模型将文本转换为向量表示；

• 数据入库：将向量与原文一同存储到向量数据库中，构建完整的检索索引；

• 在线阶段：实时查询

• 查询优化：对用户问题进行改写、扩展和消歧，提升查询表达的准确性；

• 向量化检索：将优化后的查询转换为向量表示；

• 混合召回：在向量数据库中执行语义检索与关键词匹配的混合检索策略，召回候选文档集；

• 重排序：使用精排模型对候选文档进行相关性打分与重新排序；

• 结果返回：将最相关的文档片段提供给大模型用于答案生成；

2.4 RAG关键技术

2.4.1 分块（Chunking）

分块是连接原始知识库与 LLM 有限上下文窗口的关键环节。其核心目标是将大型文档切分为语义完整、长度适中的文本块，既满足嵌入模型对输入长度的限制，又确保每个片段保留足够的上下文信息以支持精准检索。这一过程不仅直接影响嵌入质量和向量检索的准确性，还从根本上决定了最终生成回答的相关性与可靠性。

以下是五种用于RAG的分块策略：

2.4.1.1 固定大小分块（Fixed-size chunking）

固定大小分块是一种将文本按预设长度（如字符、单词或 token 数量）均匀切分为等长片段的策略。

优点：

• 实现简单，易于自动化；
• 所有块大小一致，便于批量处理和向量化；
• 可通过设置重叠区域（overlap）部分缓解上下文断裂问题。

缺点：

• 容易在句子或语义单元中间切断，破坏语义完整性；
• 关键信息可能被拆分到多个块中，降低检索相关性和生成质量；

2.4.1.2 语义分块（Semantic Chunking）

语义分块是一种基于文本内在语义结构的智能分块方法。它首先将文档按自然语言单元（如句子或段落）切分，然后逐段计算嵌入向量，并通过余弦相似度衡量相邻段落的语义关联性。若相似度高，则合并为一个块；一旦相似度显著下降，即视为语义边界，开启新块。

优点：

• 保留完整的语义单元和语言逻辑，避免信息割裂；
• 每个块包含更连贯、更丰富的上下文信息，显著提升检索准确性和生成质量；

缺点：

• 依赖相似度阈值来判断语义边界，而该阈值难以统一，需针对不同文档调整；

2.4.1.3 递归分块（Recursive Chunking）

递归分块是一种层次化、自上而下的分块策略。它首先利用文本中天然的分隔符（如句号、换行、标题等）进行粗粒度切分，然后对超出预设长度限制的块递归地进一步拆分，直到所有子块都满足大小要求；若某一块已符合长度限制，则保留原样，不再切割。

优点：

• 相比固定大小分块，能更好地保留完整句子和上下文逻辑，助于保持语义完整性；

缺点：

• 计算开销略高，尤其在深层递归时；

2.4.1.4 基于文档结构分块（Document structure-based chunking）

基于文档结构的分块（Document Structure-based Chunking） 是一种利用文档自身层级结构（如标题、章节、段落等）来划定分块边界的策略。它将每个逻辑单元（例如一个章节或带标题的小节）作为一个独立的文本块，从而在最大程度上保留原文的组织结构和语义完整性。

优点：

• 紧密贴合文档的原始逻辑结构，块内信息高度相关；
• 对结构化文档（如技术文档、论文、说明书）效果尤佳。

缺点：

• 依赖文档具备清晰、规范的结构，对格式混乱或无结构的文本（如纯文本日志、网页抓取内容）效果有限；
• 生成的块长度可能差异很大，部分块可能超出嵌入模型或LLM的token限制；

2.4.1.5 基于LLM分块（LLM-based Chunking）

基于大语言模型的分块（LLM-based Chunking） 是一种利用大语言模型（LLM）自身理解能力来生成语义连贯、独立文本块的方法。通过精心设计的提示（prompt），可以引导 LLM 将原始文档重构成多个语义完整、边界清晰的片段。

优点：

• LLM 能深入理解上下文和逻辑关系，生成的文本块语义完整、边界合理；

缺点：

• 计算成本最高，需对全文调用 LLM，推理开销大；
• 受限于 LLM 自身的上下文窗口长度，处理超长文档时需额外分段策略；

2.4.2 向量编码（Embedding）

Embedding 是 RAG系统实现语义级检索的核心技术，主要应用于检索阶段。其核心思想是将人类可读的非结构化信息（如自然语言文本）转化为机器可理解、可计算的高维向量表示，从而在向量空间中高效、精准地捕捉和匹配语义信息。

其关键作用体现在以下两个方面：

• 向量空间映射：将用户查询与知识库中的文档统一映射到同一个连续的向量空间中，使语义相近的内容在该空间中彼此靠近；
• 语义相似度计算：基于向量之间的相似度度量（如余弦相似度），快速检索出与用户查询在语义上最相关的文档片段。

目前主要的 Embedding 类型主要包括：

• 文本 Embedding：专门用于处理纯文本数据，通过模型（如 Sentence-BERT、DPR、BGE 等）将句子或段落编码为固定维度的句向量。这是当前 RAG 系统中最广泛采用的嵌入形式；

• 多模态Enmedding：能够联合编码多种模态的信息（如文本、图像、音频等），将不同模态的内容映射到一个共享的语义向量空间，适用于图文检索、跨模态问答等更复杂的应用场景。

2.4.3 查询转换（Query Transformation）

查询转换是在用户输入原始问题后、正式发起检索前，对查询语句进行语义澄清、结构优化或意图补全的过程。它的核心作用是弥合用户自然语言表达与知识库专业术语/结构之间的语义鸿沟——通过生成更精准、更完整、更适合检索系统理解的查询形式，显著提升召回结果的相关性与覆盖率。主要方法包括：

2.4.3.1 查询重写（Query Rewriting）

核心思想：将用户模糊或笼统的问题转化为更具体、细节更丰富的表述，明确关键意图（如受众、目标、范围等），从而引导检索系统返回更精准、实用的信息，避免因问题过于宽泛而得到泛泛而谈的结果。

示例：

• 用户原问题：“怎么学Python？”

• 重写后的问题：“零基础初学者如何系统学习Python编程语言？推荐的学习路径和资源有哪些？”

2.4.3.2 子查询拆解（Sub-query Decomposition）

核心思想：将包含多个意图或维度的复合型问题拆解为若干个单一、明确的子问题，分别进行检索后再综合答案，确保每个关键方面都被充分覆盖，防止因整体匹配失败或注意力分散而导致重要信息遗漏。

示例：

• 用户原问题：“购买新能源汽车时需要考虑哪些因素？补贴政策和充电设施是否完善？”

• 拆解为：

• “选购新能源汽车时应重点关注哪些参数和配置？”

• “当前国家和地方对新能源汽车有哪些购车补贴政策？”

• “家用充电桩安装条件和流程是什么？”

2.4.3.3 回退提问（Step-back Prompting）

核心思想：当原始问题聚焦于具体现象或应用时，先“后退一步”，提出一个更高层次、更通用的背景性问题，以获取支撑性原理或上下文知识，从而为理解或解答原始问题提供更扎实的基础，避免因过度聚焦细节而忽略关键背景信息。

示例：

• 用户原问题：“为什么我的手机电池掉电特别快？”
• 回退问题：“影响智能手机电池续航的主要因素有哪些？”

2.4.4 检索（Retrieval）

检索是RAG系统中连接用户查询与外部知识库的核心机制，其目标是从海量文档中高效、准确地召回与问题最相关的信息片段，为后续大模型生成提供高质量上下文支撑。不同检索范式在语义理解能力、关键词敏感性、计算效率和适用场景上各有侧重，合理选择或融合多种策略对系统整体性能至关重要。

在实际应用中，单一检索方法往往难以兼顾精确匹配、语义理解与关系推理等多维需求。因此，现代RAG系统普遍摒弃“单打独斗”的检索模式，转而采用混合检索（Hybrid Search）——这已成为当前业界的标准实践。

混合检索的核心思想是：并行调用多种互补的检索路径，再通过智能融合策略整合结果，从而在召回广度与排序精度之间取得更优平衡。目前，主流系统通常同时集成以下四类检索方式：

2.4.5 重排序（ReRanking）

重排序是在初步检索之后，对候选文档按与用户问题的语义相关性重新打分和排序的过程。它的核心作用是提升最终送入大模型的上下文质量——通过更精准地判断“哪些段落真正有用”，过滤掉表面相关但语义不匹配的内容。无论是在多路召回结果融合后，还是单一检索路径下，重排序都能显著改善生成效果。

以目前广泛使用的 Cross-Encoder 重排模型（如 Cohere Rerank、bge-reranker 系列等）为例，其在 RAG 系统中的典型重排流程如下：

• 获取初筛候选：从前期检索阶段（例如 BM25、稠密向量或稀疏向量召回）的结果中合并并选取 Top-K 个候选文档。
• 构造查询-文档对：将用户的问题与每个候选文档拼接成一个完整的输入文本，便于模型整体理解两者关系。
• 计算相关性得分：把每个拼接后的文本对输入 Cross-Encoder 模型。模型会通读整个句子，综合判断问题和文档在语义上是否匹配，并输出一个 0 到 1 之间的相关性分数——比如 0.9 表示高度相关，0.2 表示基本无关。
• 重排序并筛选：根据得分对所有候选文档从高到低重新排序，最终只保留 Top-N 个最相关的段落（如 N = 5～10），作为上下文送入大语言模型生成答案。

3.MCP简介：AI 时代的“Type-C 接口”

3.1 什么是MCP？

模型上下文协议（Model Context Protocol，简称MCP） 是一种专为 LLM 和 AI 应用设计的标准化通信协议，旨在解决当前 AI 系统在连接外部工具、数据源和业务逻辑时面临的碎片化、耦合度高、维护困难等问题。

简言之，MCP 提供了一种通用、动态且自描述的集成机制，使 AI 应用（如 Claude、Cursor 等）能够安全、灵活地发现并调用各类后端服务的能力，而无需在代码中硬编码具体的接口细节。

类比理解：如果把传统 API 比作“专用充电线”（每台设备需要特定接口），那么 MCP 就是“Type-C”——一个统一、即插即用、支持热插拔和能力协商的智能接口标准。

3.2 核心架构

MCP 基于 Client-Server 架构，包含三个角色：

• 主机(Host)：运行 MCP 客户端的 AI 应用（如 Claude Desktop、Cursor）；

• 客户端(Client)：在主机内运行，使其能与 MCP 服务器通信；

• 服务器(Server)：暴露特定功能并提供数据访问；

• 工具(Tools)：使 LLM 能够执行具体操作的可调用函数。比如天气查询工具 get_weather可以获取指定地点天气；

• 资源(Resources)：向 LLM 公开服务器中的数据和内容。比如知识库文档、数据库记录、配置文件等；

• 提示 (Prompts)：提供可复用的提示词模板。比如翻译提示词模版、数据分析提示词模版等；

3.3 通信流程

MCP 的运行过程可分为两个关键阶段：能力交换与运行时调用。前者实现服务发现与接口的动态协商，后者负责用户请求的安全执行与响应生成，二者协同构建了一个动态、安全且对大语言模型（LLM）友好的工具集成闭环。

3.3.1 阶段一：能力交换

这是 MCP 会话的初始化阶段，通常在 Host 启动或首次连接某个 MCP 服务时触发，用于建立通信并动态发现服务器提供的功能。

• Host 启动 MCP Client 并连接 MCP Server；

• 用户在 AI 应用（如 Claude Desktop）中启用了某个插件（例如“天气助手”）；

• Host 启动内置的 MCP Client，并通过预配置的方式（如本地进程、WebSocket URL）连接到对应的 MCP Server（例如一个运行在localhost:8080/weather-mcp的服务）。

• Client 发送初始化请求；

• MCP Client 向 Server 发送initialize请求；

{ "method": "initialize", "params": { "clientInfo": { "name": "Claude Desktop", "version": "1.5" }, "capabilities": { "supportsPrompts": true } } }

• Server 返回自身能力清单；

• MCP Server 响应，声明它能提供哪些 Tools（工具）、Resources（资源） 和 Prompts（提示模板），每个都附带结构化元数据（如参数 schema、描述、权限等级）：

{ "result": { "serverInfo": { "name": "Weather MCP Server", "version": "2.1" }, "capabilities": { "tools": [ { "name": "get_weather", "description": "获取指定城市和日期的天气预报", "parameters": { "type": "object", "properties": { "location": { "type": "string", "description": "城市名称" }, "date": { "type": "string", "format": "date", "description": "查询日期，格式 YYYY-MM-DD" } }, "required": ["location"] }, "requiresUserConsent": false // 可配置是否需要用户确认 } ], "resources": [], "prompts": [] } } }

• Client 注册能力并完成握手

• MCP Client 解析响应，将get_weather工具注册到当前会话的“可用工具集”中。

• 后续 LLM 在生成回复时，即可“知道”自己可以调用这个工具。

3.3.2 阶段二：运行时调用

当用户发起具体查询时，系统进入运行时阶段，执行工具调用并生成最终回答。以用户提问 “明天北京天气怎么样？” 为例：

• LLM 分析问题并选择工具；

• Host 将用户输入传递给 LLM。

• LLM 根据上下文和已注册的工具列表，决定调用get_weather，并生成工具调用指令：

{ "tool_name": "get_weather", "arguments": { "location": "北京", "date": "2025-06-15" } }

• MCP Client 检查并请求用户授权（可选）；

• MCP Client 查看该工具的元数据：

• 若requiresUserConsent: true→ 弹出确认框：“AI 想查询北京天气，是否允许？”

• 若为false（如本例），或用户已设置“自动同意”，则跳过确认。

• Client 向 Server 发起工具调用；

• MCP Client 通过协议通道发送call请求：

{ "method": "call", "params": { "name": "get_weather", "arguments": { "location": "北京", "date": "2025-06-15" } } }

• Server 执行工具并返回结果；

{ "result": { "temperature": 28, "unit": "°C", "condition": "Sunny", "summary": "北京明天晴，气温 28°C" } }

• Client 将结果注入 LLM 上下文；

• MCP Client 收到结果后，将其与原始用户问题一起提交给 LLM；

• 工具返回：“北京明天晴，气温 28°C”；

• LLM 生成自然语言回答；

• LLM 综合信息，输出流畅回答；

• LLM返回：“明天北京天气晴朗，最高气温 28 摄氏度，适合外出！”。

三、落地实践

1. 总体架构

为提升 AI Coding 在高频、高复杂度业务场景中的采纳率，我们构建了“SPEC（硬规则） + RAG（软上下文） + MCP（标准化接口）”三位一体的知识增强体系。该体系通过分层协同，兼顾准确性、灵活性与可维护性。

• 本地 SPEC 知识库

• 优势：提供强约束、机器可读的契约规范，确保生成代码在接口、数据格式、异常处理等方面严格符合业务要求；支持自动化验证，行为可预期、可审计。

• 适用场景：接口定义、代码流程描述、扩展点契约、编码规范、兜底策略等必须遵守的确定性规则。

• 集成方式：直接嵌入 IDE 上下文（如 Aone Copilot），无需 MCP 检索，作为 LLM 的基础约束条件实时生效。

• RAG 知识库

• 优势：动态检索非结构化/半结构化私有知识（如业务领域知识、术语、历史经验），提供语境感知的“软上下文”；按需召回，避免上下文过载；支持低成本持续更新。

• 适用场景：需求背景解释、最佳实践参考、隐性规则说明、跨域联调上下文等辅助信息。

• 集成方式：通过 MCP 协议封装为标准工具服务，按需调用，避免上下文膨胀。

2. Spec知识库

本地 SPEC 知识库已在猫超导购 C 端工程中全面落地，形成稳定的工作流：

• 所有 Solution 与通用组件均配套.spec/目录，明确定义输入输出、实验开关、兜底逻辑等关键要素；
• 团队沉淀的通用 Rules（如日志规范 GuideLog、参数校验模板、稳定性兜底策略）已嵌入 Prompt Rules工程，作为系统级约束；
• Aone Copilot 在代码生成前自动加载相关 SPEC 文件，将其转化为内部约束条件，确保产出符合业务语义与系统架构。

SPEC知识库结构目录分层如下：

天猫超市应用/ ├── .spec/ # 主流程与模块规范 │ ├── mainflow/ # 主流程模块 │ │ │ ├── solution/ # Solution 模块（按业务子场景分类） │ │ ├── category/ # 分类相关 │ │ ├── superfiery/ # 超级爆款 │ │ ├── publicentrance/ # 公域入口 │ │ ├── scenecard/ # 场景卡 │ │ ├── cartfeeds/ # 购物车与下单页 Feeds │ │ └── intentioncard/ # 动线插卡 │ │ │ ├── commoncomponents/ # 通用组件模块（按能力维度分组） │ │ ├── experiment/ # 实验平台能力（ABTest、ADP、IGraph 等） │ │ ├── user/ # 用户相关服务（用户画像、分桶等） │ │ ├── item/ # 商品与类目（类目服务、ID 映射、缓存等） │ │ ├── coupon/ # 红包召回能力（通用红包、超级爆款红包、公域红包等） │ │ └── utility/ # 工具类通用能力（定坑工具等） │ │ │ └── descriptive/ # 描述性规范 │ ├── .lifecycle/ # 需求全生命周期目录 │ └── super_fiery_iteration/ # 示例：超级爆款迭代需求 │ ├── breakdown/ # 需求拆解文档 │ └── tech/ # 技术方案文档 │ └── .aone_copilot/ # Aone Copilot 规则根目录 └── rules/ # 项目级别rules（包括编码规范、项目目录）

• 将猫超闪购系统文档体系划分为三大类

• 功能规范：整体划分为主流程、解决方案、通用组件和描述性规范四类。主流程聚焦应用框架的核心执行链路；解决方案按业务场景组织，涵盖分类导购、超级爆款、公域入口、场景卡、换购、动线插卡等多样化导购形态；通用组件按能力属性归类为实验、用户、商品、红包、工具等模块，支撑多场景复用；描述性规范则专门用于统一管理推荐模型策略、前端商品结构等非代码但关键的协作文档。

• 需求生命周期管理：围绕具体需求，集中管理从需求拆解到技术方案的全过程文档，确保需求实现可追溯。

• 项目级规则：统一定义编码规范、目录结构及导购架构等项目级工程标准。

3. RAG知识库

针对SPEC无法覆盖的非结构化与半结构化知识（如业务领域术语、历史技术方案、跨团队协作上下文等），同时，也为解决因文档激增导致模型上下文长度不堪重负这一瓶颈，我们启动 RAG 知识库建设，目前处于初步落地与验证阶段。

本阶段的核心目标是：通过统一托管与智能检索，将分散在各业务线的静态知识转化为 AI 可按需调用的动态上下文，从而在不增加模型输入负担的前提下，显著提升生成结果的准确性与业务贴合度。

具体进展如下：

• 统一托管与知识整合：已将部分核心业务文档导入 AI Studio 知识库；
• 智能检索能力建设：基于 AI Studio 提供的向量检索与重排序能力，实现关键词+语义混合召回；该机制能在用户提问时自动理解意图，从海量文档中精准召回最相关的片段；
• 轻量集成与 MCP 封装：通过 MCP 协议将 RAG 检索能力封装为标准化工具，以“即插即用”的方式嵌入 Aone Copilot 工作流；
• 试点场景验证：在“需求澄清”“错误诊断”“方案参考”等场景中初步验证，能有效补充 SPEC 未覆盖的上下文。

3.1 AI Studio知识库构建

3.1.1 创建知识库

在AI Studio平台创建新的知识库实例，作为后续文档管理和检索的基础容器。

3.1.2 知识库配置

根据实际需求配置知识库参数：

• 向量模型选择：选择适合业务场景的向量化模型；
• 文档更新策略：设置文档的自动更新和同步机制；

3.1.3 添加文档

支持多种文档格式上传至知识库：

3.2 MCP服务器构建

3.2.1 获取知识库凭证信息

• 获取知识库ID：在知识库详情页面复制知识库唯一标识ID；

• 知识库AK绑定

• 申请知识库AK（免费体验）：

• AK绑定：在知识库设置中完成AK绑定配置；

3.2.2 知识库检索API构建

以下是关键词检索的API调用示例（使用上文获取的AK和知识库ID）：

关键词检索API

curl --location '检索地址' \ --header 'X-AK: AK' \ --header 'Request-Origion: SwaggerBootstrapUi' \ --header 'accept: */*' \ --header 'Content-Type: application/json' \ --data '{ "question": 需要提出的问题, "searchComponent": { "inDomainTags": [], "keywordComponent": { "maxMatchingThreshold": 1.0, "retrievalCounts": 3, "retrievalType": "ORIGIN_CHUNK" }, "repositoryId": "知识库ID" }, "source": "API" }'

3.2.3 MCP服务器快速部署（渐进式策略）

采用 “本地试点 → 云端迁移” 策略，确保稳定性与可维护性。

• 通过“一句话生成MCP服务”prompt，快速构建本地MCP服务；

• Aone Copilot集成验证

3.3 Aone Copilot实战应用

3.3.1 实际提问

3.3.2 检索质量验证

对比检索过程中返回的RAG知识库片段：

3.3.3 代码生成

基于MCP检索召回的知识库内容，能够准确生成符合业务逻辑和技术规范的代码。

四、后续规划

目前，AI Coding 的知识支撑体系已初步落地：SPEC 知识库在规范驱动开发中持续发挥作用，RAG 知识库也初步验证了其在补充非结构化上下文方面的可行性。在此基础上，我们设想下一阶段可围绕以下方向逐步探索优化，尝试构建一个更高质量、更具扩展性的智能知识底座：

• SPEC 知识库将持续完善：进一步优化spec目录的分层结构，提升规范的可发现性与复用性；探索建立自动保鲜机制，通过代码变更感知等方式，确保 SPEC 与实现同步演进，避免“规范滞后于代码”。进一步夯实 AI Coding 的“硬规则”基础。

• RAG 知识库将重点优化以下方向，以提升动态上下文的质量与覆盖：

• 向量模型调优：评估并引入更契合技术文档语义的嵌入模型，提升语义匹配精度与跨文档关联能力；

• 检索效果增强：支持关键词与向量混合检索，引入重排序（re-ranking）等机制，提高召回结果的相关性与实用性；

• 业务知识库持续建设：在现有基础上，逐步丰富各业务域的核心文档（如导购、推荐、渲染等领域的规范、流程），朝着覆盖全面、结构清晰、易于维护的领域知识体系演进。

• MCP 服务云端化：若本地验证顺利，将把当前基于本地部署的 MCP 检索服务迁移至云端平台。

如何学习大模型 AI ？

由于新岗位的生产效率，要优于被取代岗位的生产效率，所以实际上整个社会的生产效率是提升的。

但是具体到个人，只能说是：

“最先掌握AI的人，将会比较晚掌握AI的人有竞争优势”。

这句话，放在计算机、互联网、移动互联网的开局时期，都是一样的道理。

我在一线互联网企业工作十余年里，指导过不少同行后辈。帮助很多人得到了学习和成长。

我意识到有很多经验和知识值得分享给大家，也可以通过我们的能力和经验解答大家在人工智能学习中的很多困惑，所以在工作繁忙的情况下还是坚持各种整理和分享。但苦于知识传播途径有限，很多互联网行业朋友无法获得正确的资料得到学习提升，故此将并将重要的AI大模型资料包括AI大模型入门学习思维导图、精品AI大模型学习书籍手册、视频教程、实战学习等录播视频免费分享出来。

这份完整版的大模型 AI 学习资料已经上传CSDN，朋友们如果需要可以微信扫描下方CSDN官方认证二维码免费领取【保证100%免费】

为什么要学习大模型？

我国在A大模型领域面临人才短缺,数量与质量均落后于发达国家。2023年，人才缺口已超百万，凸显培养不足。随着AI技术飞速发展，预计到2025年,这一缺口将急剧扩大至400万,严重制约我国AI产业的创新步伐。加强人才培养,优化教育体系,国际合作并进是破解困局、推动AI发展的关键。

大模型入门到实战全套学习大礼包

1、大模型系统化学习路线

作为学习AI大模型技术的新手，方向至关重要。 正确的学习路线可以为你节省时间，少走弯路；方向不对，努力白费。这里我给大家准备了一份最科学最系统的学习成长路线图和学习规划，带你从零基础入门到精通！

2、大模型学习书籍&文档

学习AI大模型离不开书籍文档，我精选了一系列大模型技术的书籍和学习文档（电子版），它们由领域内的顶尖专家撰写，内容全面、深入、详尽，为你学习大模型提供坚实的理论基础。

3、AI大模型最新行业报告

2025最新行业报告，针对不同行业的现状、趋势、问题、机会等进行系统地调研和评估，以了解哪些行业更适合引入大模型的技术和应用，以及在哪些方面可以发挥大模型的优势。

4、大模型项目实战&配套源码

学以致用，在项目实战中检验和巩固你所学到的知识，同时为你找工作就业和职业发展打下坚实的基础。

5、大模型大厂面试真题

面试不仅是技术的较量，更需要充分的准备。在你已经掌握了大模型技术之后，就需要开始准备面试，我精心整理了一份大模型面试题库，涵盖当前面试中可能遇到的各种技术问题，让你在面试中游刃有余。

适用人群

第一阶段（10天）：初阶应用

该阶段让大家对大模型 AI有一个最前沿的认识，对大模型 AI 的理解超过 95% 的人，可以在相关讨论时发表高级、不跟风、又接地气的见解，别人只会和 AI 聊天，而你能调教 AI，并能用代码将大模型和业务衔接。

• 大模型 AI 能干什么？
• 大模型是怎样获得「智能」的？
• 用好 AI 的核心心法
• 大模型应用业务架构
• 大模型应用技术架构
• 代码示例：向 GPT-3.5 灌入新知识
• 提示工程的意义和核心思想
• Prompt 典型构成
• 指令调优方法论
• 思维链和思维树
• Prompt 攻击和防范
• …

第二阶段（30天）：高阶应用

该阶段我们正式进入大模型 AI 进阶实战学习，学会构造私有知识库，扩展 AI 的能力。快速开发一个完整的基于 agent 对话机器人。掌握功能最强的大模型开发框架，抓住最新的技术进展，适合 Python 和 JavaScript 程序员。

• 为什么要做 RAG
• 搭建一个简单的 ChatPDF
• 检索的基础概念
• 什么是向量表示（Embeddings）
• 向量数据库与向量检索
• 基于向量检索的 RAG
• 搭建 RAG 系统的扩展知识
• 混合检索与 RAG-Fusion 简介
• 向量模型本地部署
• …

第三阶段（30天）：模型训练

恭喜你，如果学到这里，你基本可以找到一份大模型 AI相关的工作，自己也能训练 GPT 了！通过微调，训练自己的垂直大模型，能独立训练开源多模态大模型，掌握更多技术方案。

到此为止，大概2个月的时间。你已经成为了一名“AI小子”。那么你还想往下探索吗？

• 为什么要做 RAG
• 什么是模型
• 什么是模型训练
• 求解器 & 损失函数简介
• 小实验2：手写一个简单的神经网络并训练它
• 什么是训练/预训练/微调/轻量化微调
• Transformer结构简介
• 轻量化微调
• 实验数据集的构建
• …

第四阶段（20天）：商业闭环

对全球大模型从性能、吞吐量、成本等方面有一定的认知，可以在云端和本地等多种环境下部署大模型，找到适合自己的项目/创业方向，做一名被 AI 武装的产品经理。

• 硬件选型
• 带你了解全球大模型
• 使用国产大模型服务
• 搭建 OpenAI 代理
• 热身：基于阿里云 PAI 部署 Stable Diffusion
• 在本地计算机运行大模型
• 大模型的私有化部署
• 基于 vLLM 部署大模型
• 案例：如何优雅地在阿里云私有部署开源大模型
• 部署一套开源 LLM 项目
• 内容安全
• 互联网信息服务算法备案
• …

学习是一个过程，只要学习就会有挑战。天道酬勤，你越努力，就会成为越优秀的自己。

如果你能在15天内完成所有的任务，那你堪称天才。然而，如果你能完成 60-70% 的内容，你就已经开始具备成为一名大模型 AI 的正确特征了。

这份完整版的大模型 AI 学习资料已经上传CSDN，朋友们如果需要可以微信扫描下方CSDN官方认证二维码免费领取【保证100%免费】