安装指南

了解将现有书籍知识包接入 Agent 的准备要求与安装流程。

已接入 Book Agent 0.1.0 的发行材料。选择阅读模式、下载组件并复制安装提示词。具体平台与问答验收范围以本版指南为准。

安装流程

选择阅读模式
原文阅读为默认；本地离线语义需要额外运行组件和一份共享模型；在线语义需要你在本机明确授权兼容查询服务。
登录并核对文件
普通登录顾客免费获取工具，不要求购买书籍。核对当前发行清单、文件大小与完整 SHA-256，保留原始包和原书。
交给有本机权限的 Agent
下载和解压后，复制对应发行版的安装提示词，提供本机工具包与知识包位置。先审查说明，再执行安装；不要把 Key 或私有书包发送到本站。
确认实际接入
宿主按需要完成导入、刷新和启用连接。再验证 MCP 工具调用、原文引用与实际检索方式；图片交付与视觉理解分别确认。

知识包应包含原始 PDF 或 EPUB、全书 Markdown、书籍 Skill，以及 vector_db 目录中的 vectors.sqlite3、manifest.json、search.py 和 README.md，并保留 archive_manifest.json。

安装服务接入已有的 SQLite 向量库。无需准备 chunks 目录，也无需重新切分或生成书籍正文向量。实际格式和查询依赖需要由安装程序检查。

保留原包和数据库。配置、缓存、日志及补充索引应写入独立运行目录；不要直接执行尚未审查的包内脚本。

检查知识包校验结果、查询运行时和 MCP 连接，再用一个有原文依据的问题验证检索。生成配置、工具调用成功和 Agent 实际完成问答是不同的验证步骤。

查询运行时继承原向量库的要求；凭据或模型依赖缺失时，应明确提示全文检索降级。重排是可选配置，默认不启用。关闭重排不代表整个检索过程可以离线。

图片、图表或公式需要回到原始 PDF／EPUB 核对。找到页面或生成图片，不等于 Agent 已成功读取其中的视觉信息。