用本地文件与 AI 对话GPT4All LocalDocs 完整指南【免费下载链接】gpt4allGPT4All: Run Local LLMs on Any Device. Open-source and available for commercial use.项目地址: https://gitcode.com/GitHub_Trending/gp/gpt4all你有一份产品手册、会议纪要或代码文档的文件夹想基于它们提问又不希望文件内容发往任何云端服务。GPT4All 的 LocalDocs 功能做的就是这件事把本地文件拆成文本片段并生成向量存在本地数据库 localdocs_v2.db 中聊天时检索出与问题最相关的片段塞进本地大模型的上下文再作答默认全程不出本机。️ 创建第一个 LocalDocs 集合关联文件夹并开始索引在 GPT4All 桌面客户端左侧导航打开 LocalDocs 页面点右上角 Add Collection给集合起个名字例如产品手册2025选择要索引的本地文件夹点Create Collection确认。几点需要注意集合绑定的是文件夹而不是单个文件之后往文件夹里加文件系统会自动重新索引。哪些文件类型会被真正索引由设置里的 Allowed File Extensions 决定代码注释说明目前只承诺支持纯文本和 PDFOffice 文档、图片、音视频、压缩包等二进制类型会被直接排除。创建后无需任何额外操作这个集合的进度会直接显示在 LocalDocs 页面上。✅ 看懂状态条INDEXING、EMBEDDING、READY 各代表什么每个集合卡片上都有一条进度条加状态标签逻辑定义在 gpt4all-chat/qml/LocalDocsView.qml 中弄清这些状态能避免你干等INDEXING从文档中抽取文本片段进度按文件字节数计算。EMBEDDING把片段转换成向量进度按片段数量计算。READY可用状态卡片上会显示文件数和总词数。REQUIRES UPDATE设置或版本变化后需要重建点Update开始。ERROR红色字样把鼠标悬停在进度条上可以看到具体原因。两个容易忽略的说明不必等全部完成部分文件就绪后即可对它们提问见 localdocs.md 的官方说明。READY 之后文件夹有改动会自动更新索引Rebuild是从零重建官方提示很慢且通常不需要只在索引异常时使用。 聊天时怎么挂上 LocalDocs 并查看引用来源集合建好后聊天分两件事聊天窗口右上角点击LocalDocs按钮角上的数字是当前挂上的集合数打开集合选择面板勾选需要的集合直接提问即可回答会基于文档中的相关片段生成回答下方的Sources可以展开看到具体引用了哪些文件。不想每次看引用可以到设置里关掉 Show Sources默认开启控制每条回答是否显示来源。⚙️ LocalDocs 设置里能改什么文件类型、向量化设备、Nomic API入口在 Settings 的 LocalDocs 页界面实现在 gpt4all-chat/qml/LocalDocsSettings.qml常用项如下设置项作用Allowed File Extensions逗号分隔的扩展名列表只索引这些类型的文件Use Nomic Embed API Nomic API Key改用 Nomic 云端做向量化需填nk-开头的密钥改动后需重启Embeddings Device本地向量化的计算设备默认Application default改动后需重启Document snippet size (characters)每个片段的字符数默认 512越大内容越完整但生成更慢Max document snippets per prompt注入上下文的最佳匹配片段数上限越大准确率越高但更慢最后两项带有官方红色提示仅供高级用户使用两个数值相乘大致就是额外塞进模型上下文窗口的字符量设得过大可能导致 LocalDocs 失败或响应极慢普通用户保持默认即可。️ 数据库无法访问怎么修、什么时候该重建索引页面出现红色 database cannot be accessed 时按这个顺序处理每条修复后都要重启程序才生效确认设置为 Download Path 的文件夹确实存在检查该文件夹以及其中 localdocs_v2.db 文件的读写权限仍不行时备份并删除该目录下所有 localdocs_v*.db 文件重新创建集合——这会丢掉现有索引只作最后手段。想重建索引时集合处于 READY 状态时点卡片上的Rebuild会清掉现有索引并把文件夹里所有文件重新处理一遍。下一步先挑一个真实文件夹建一个集合等状态变 READY 后到聊天里就文档内容提问如果回答总对不上文档先核对文件夹里的文件类型是否在 Allowed File Extensions 列表里。【免费下载链接】gpt4allGPT4All: Run Local LLMs on Any Device. Open-source and available for commercial use.项目地址: https://gitcode.com/GitHub_Trending/gp/gpt4all创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考