企业官网建设流程全解析

Project NOMAD知识库全攻略：上传文档让本地AI读懂你的资料

【免费下载链接】project-nomadProject NOMAD is an offline-first knowledge and education server. Wikipedia, thousands of books, courses, maps, and optional local AI, all running on hardware you own with no internet required.项目地址: https://gitcode.com/GitHub_Trending/pr/project-nomad

Project NOMAD 是一款离线优先的本地知识与教育服务器，其中的AI 知识库（Knowledge Base）功能允许你上传 PDF、Word、电子书、图片等资料，由本地 AI（Ollama + Qdrant 的 RAG 架构）完成向量化索引，之后就能在断网状态下直接"问"你自己的文档。本文是一份面向新手的完整指南：从支持哪些格式、如何拖拽上传，到如何确认索引成功、组织你的资料库，全程不写一行代码。

为什么要把资料交给本地 AI？

大多数在线问答工具会把你的文档上传到云端。而 Project NOMAD 的 RAG 流水线完全运行在你自己的硬件上：

• 🔒隐私安全：文档、检索、对话全程不出你的设备，零遥测
• 📡彻底离线：断网、远端工地、野外作业都能查自己的资料
• 🧠语义检索：不是关键词匹配，而是基于 768 维嵌入向量的语义相似度搜索，问"电池保养注意事项"也能命中写着"锂电池维护"的段落

支持哪些文档格式？

知识库的文件处理核心在 rag_service.ts 中定义，通过文件扩展名自动识别类型并走对应的解析器：

💡 小技巧：上传的照片、手写笔记扫描件都会被 OCR，但识别效果取决于图片清晰度——尽量保证文字正对镜头、光线充足。

上传文档 3 步走：最快配置方法

第 1 步：打开知识库管理器

在 AI 聊天页面点击知识库入口，会弹出文件管理窗口（KnowledgeBaseModal.tsx）。顶部是拖拽上传区（基于 Uppy 组件，见 file-uploader/index.tsx）。

第 2 步：拖入文件

把文件直接拖进虚线框，或点击选择。单文件默认上限100 MB，支持一次选多个文件。

第 3 步：等待索引完成

每个文件旁会有状态标签：

• 🟢Indexed（已索引）：向量化完成，可被 AI 检索
• ⚪Not Indexed（未索引）：仅保留浏览，不参与问答
• 🔄索引中：可展开查看实时进度（提取文本 → 分块 → 向量化三步）

索引速度参考：一本 10 万字的 PDF 在普通 CPU 上大约需要 1~3 分钟；首次使用会自动拉起 Qdrant 向量数据库容器，稍慢属正常现象。

用集合（Collection）组织你的资料库

文件多了以后，建议按主题分集合管理——比如应急手册、维修文档、课程讲义。集合的价值：

• 提问时可指定某个集合作为答案来源，减少噪音
• 支持对整个集合执行"重新索引"或删除，互不影响
• 前端按集合分组折叠展示，文件再多也清爽

相关逻辑可参考 CollectionsManager.tsx。

让 AI"读懂"资料后怎么提问

索引完成后，直接在聊天框用自然语言提问即可：

1. 问具体事实："根据《设备维护手册》，更换滤芯的周期是多少？"
2. 问跨文档对比："对比两个版本的应急预案，差异点有哪些？"
3. 系统会先从向量库检索最相关段落（默认召回 5 条，经重排序），再交给本地大模型作答，答案基于你的资料而非模型记忆

典型使用场景

• 🏕️野外生存：上传急救手册、植物图鉴照片，离线随时查
• 🏫 ** homeschool / 教学**：把课程大纲喂给知识库，AI 按你的教材答疑
• 🏗️工地 / 船队：上传设备手册与 SOP，技术问答不依赖信号
• 🔐隐私敏感：合同、医疗资料只进本地库，永不上传云端

更多场景组合见项目内置文档 use-cases.md。

常见问题速查

Q：为什么文件一直显示"未索引"？先确认 AI 助手服务已安装且嵌入模型（nomic-embed-text）已就绪；也可在文件行点击手动触发索引。

Q：能删文档吗？可以，删除后对应的向量与原始文件会一并清理，释放磁盘空间。

Q：上传的东西会被上传到网上吗？不会。Project NOMAD 全部处理在本地容器内完成，断网后功能完全不受影响。

掌握这套"上传 → 索引 → 提问"的流程，你的 NOMAD 就不只是一台离线 Wikipedia，而是一台真正懂你资料的私有知识服务器。

【免费下载链接】project-nomadProject NOMAD is an offline-first knowledge and education server. Wikipedia, thousands of books, courses, maps, and optional local AI, all running on hardware you own with no internet required.项目地址: https://gitcode.com/GitHub_Trending/pr/project-nomad