agent-">知识库直读与技能化蒸馏：两种Agent知识供给方案的对比与选型

一、对比背景：为什么需要比较这两种方案

随着Agent类应用在开发流程中普及，一个现实问题浮出水面：如何让Agent稳定、准确、低成本地使用一本技术书、一套内部规范或一批研究资料？

常见做法大致分为两类。一类是把原始资料直接交给模型，通过长上下文窗口或检索增强的方式让模型“读原文”；另一类是先把资料加工成结构化的技能库，再让Agent按需加载。原始标题提到的“book-to-skill”类工具，正是后一类方案的代表——它把专业资料蒸馏成统一的Agent Skill结构，需要时自动索取信息，并要求严格基于真实内容回答。

两种方案目标一致，但技术路径、成本结构和风险边界差异明显。本文围绕“原始资料直读”与“结构化技能库蒸馏”展开对比，帮助读者理解区别并做出选型判断。

二、对象定义：两种方案分别是什么

方案A：原始资料直读。 将PDF、EPUB、DOCX、Markdown等文件直接放入模型上下文，或通过向量检索召回相关片段。模型在回答时自行理解原文。优点是链路短、无需预处理；缺点是上下文占用大、章节边界模糊、容易产生幻觉。

方案B：结构化技能库蒸馏。 先对资料做一次加工，提取框架、决策规则、反模式，按章节拆分文件，生成核心心智模型、术语表、模式库和速查表，形成统一的Skill目录结构。Agent在使用时只加载与当前问题相关的章节文件，从而控制Token消耗并提升回答的可追溯性。

三、相同点分析

两者在以下方面存在共同目标：

• 都服务于“让Agent基于真实资料回答问题”这一目标；
• 都需要对资料格式做一定处理，尤其是扫描版PDF需要先做OCR；
• 都面临幻觉控制问题，都需要通过提示约束或结构约束让回答锚定原文；
• 都适用于技术书籍、内部文档、规范标准等专业资料场景；
• 都需要考虑资料的更新与版本管理。

四、核心差异分析

4.1 技术架构与资源管理

方案A的架构更轻，依赖上下文窗口或检索服务，系统边界小，但资源管理粗放——整本书或大段片段一次性进入上下文，Token占用随资料规模线性增长。方案B引入了预处理阶段，需要一次性完成格式解析、章节拆分和结构提取，架构上多了一个“加工层”，但运行时的资源管理更精细：章节文件按需加载，单章约千级Token，核心索引文件约数千Token，整体占用可控。

4.2 功能能力与使用限制

方案A的能力上限取决于模型上下文长度和检索质量，对“跨章节综合推理”较友好，但对“精确引用某一章决策规则”不够稳定。方案B通过显式结构（框架、决策规则、反模式、术语表、速查表）把知识组织成可检索单元，回答时更容易定位到具体章节，幻觉风险相对更低。其限制在于预处理质量依赖解析工具，技术书中代码、表格、公式较多的部分需要更强的解析能力，扫描版PDF必须先做OCR。

4.3 接入方式与改造成本

方案A接入简单，指定文件路径或建立索引即可使用，开发改造量小。方案B需要执行一次转换流程：指定文件路径、自动提炼结构、按需加载使用。安装方式通常有两种，一种是通过通用技能管理命令行添加，另一种是手动克隆到本地技能目录。前者适合快速试用，后者适合需要固定版本或内网部署的团队。整体改造成本集中在预处理环节和技能目录规范上。

4.4 性能表现与成本结构

方案A的运行时延迟取决于上下文长度和检索链路，资料越大，首Token延迟和单次调用成本越高。方案B把成本前移到预处理阶段，运行时按需加载，Token消耗显著降低。原文特别强调“章节文件按需加载，可以极有效地节省Token”，这正是方案B在长期高频使用场景下的核心优势。需要注意的是，两者都不应编造具体性能数据，实际表现需结合资料规模、解析工具和调用频率实测。

4.5 安全与合规

两者都需要关注资料权限、数据隔离和审计。方案A在每次调用时把原文片段送入模型，敏感内容暴露面更大；方案B的章节文件可做访问控制，术语表和速查表可脱敏后单独使用，审计粒度更细。对于内部决策记录、运行手册、合规文档等资料，方案B的结构化拆分更利于分级授权。

4.6 运维复杂度

方案A运维简单，但资料更新后需重建索引或重新加载。方案B需要维护技能目录结构、章节文件与索引文件的一致性，资料更新时需重新执行转换流程。好在结构化文件便于版本对比，长期维护成本在资料频繁更新的场景下反而可能更低。

五、对比表格

对比维度	方案A：原始资料直读	方案B：结构化技能库蒸馏
技术架构	轻量，依赖上下文或检索	多一层预处理，运行时按需加载
功能能力	跨章节综合较灵活，精确引用较弱	结构清晰，定位章节更稳定
接入方式	指定文件或建索引，改造小	需执行转换流程，维护技能目录
Token成本	随资料规模线性增长	按章节加载，整体占用可控
幻觉控制	依赖提示约束，风险较高	结构约束加章节锚定，风险较低
安全合规	原文片段暴露面较大	可分级授权，审计粒度更细
运维复杂度	简单，但更新需重建	需维护结构一致性，更新需重跑
适用场景	临时查询、小规模资料	高频使用、重要工作、团队共享

六、典型场景选择

• 临时查阅一本小册子或单篇论文：方案A更合适，链路短、上手快。
• 需要基于技术书做重要决策支持：方案B更合适，章节锚定和决策规则提取能降低幻觉风险。
• 内部运行手册、入职指南、合规文档的长期共享：方案B的结构化目录更利于团队复用和权限管理。
• 资料更新频繁、版本迭代快：需评估方案B的重复转换成本，若更新频率过高，可考虑混合方式——核心稳定部分做技能化，变动部分保留直读。
• 扫描版PDF为主的资料集：两种方案都需先做OCR，方案B还需额外关注解析质量对结构提取的影响。

七、选型建议

选型不应做绝对化判断，而应结合条件：

1. 若资料规模小、使用频率低、团队希望快速验证，可优先采用方案A；
2. 若资料用于重要工作、需要稳定引用和低幻觉，且使用频率较高，方案B的Token节省和结构约束更具优势；
3. 若团队运维能力有限，可优先选择托管化程度更高、预处理流程更自动化的实现方式；
4. 若涉及敏感内部文档，应优先评估方案B的分级授权与审计能力；
5. 无论选择哪种方案，都应保留“基于真实内容回答”的提示约束，并建立资料更新后的回归验证机制。

八、迁移与使用注意事项

从方案A迁移到方案B时，需重点关注：

• 数据一致性：转换后的章节文件与原文需可追溯，建议保留原始文件与转换产物的映射关系；
• 接口适配：技能目录结构需与现有Agent调用方式对齐，避免加载路径冲突；
• 权限与隔离：章节文件、术语表、速查表可能包含不同敏感级别，需分别设置访问控制；
• 稳定性风险：预处理阶段的解析失败会导致章节缺失，需建立转换质量校验；
• 兼容性：不同格式（PDF、EPUB、DOCX、HTML、RTF、MOBI等）的解析工具选择不同，技术书与文字类书籍应区别对待；
• 运维风险：资料更新后需重新执行转换并验证索引，建议纳入版本管理流程。

九、总结

原始资料直读与结构化技能库蒸馏并非替代关系，而是面向不同使用强度与风险要求的两种知识供给方式。方案A胜在链路短、接入快，适合临时查询与小规模资料；方案B胜在Token可控、结构清晰、幻觉风险较低，适合重要工作与团队长期共享。理解两者在架构、成本、安全与运维上的差异，结合资料规模、使用频率和团队能力做条件化选择，才是合理的选型思路。