🔐 项目智能问答助手

一、这是什么

「项目智能问答助手」是一个本地部署的 文档问答 AI（RAG）系统。它把每个项目各自的文档建成可检索的知识库，然后用大模型对它提问：系统先检索到最相关片段、再据片段生成答案，并给出引用来源。它帮助实施人员及相关人员快速上手项目，并在后续项目实施与日常工作中随时问答检索。

二、启动

1. 双击项目根目录的 start_rag.bat，会自动起服务并打开浏览器。
2. 浏览器访问 http://127.0.0.1:8000（端口见 app/config.json 的 server.port）。
3. 停止：在"RAG-Server"窗口按 Ctrl+C。

三、建立知识库

三种方式，任选其一（全程前端点几下，不用碰后台/命令）：

1. 直接拖：把文件或整个文件夹拖到页面中间空白处，松手即自动建库。最简单。
2. 点选：新建知识库处点「选择文件 / 文件夹」，在弹出的窗口里勾选要入库的资料。
3. 指定文件夹：填绝对路径，或用「目录浏览…」在本地选择已有文件夹（后续文件改动走「重建索引」即可增量更新）。

建库会自动建立索引（文件越多越久，首建可能几分钟到十几分钟，页面中部有进度提示）。

四、提问

1. 左侧点击选中目标知识库（蓝色高亮为当前库）。
2. 底部输入问题回车即可。答案逐字流式出现，下方可展开 📎 引用 查看依据片段。

五、多知识库与历史切换

• 每个文件夹 = 一个独立知识库，互不影响。
• 知识库持久保存在 app/data/，重启服务后仍在，点击即可切换，无需重建。

六、补充文档 / 增量更新

• 随时补料：直接拖新的文件/文件夹进页面，或点右上 「添加文件」，选好后自动批量加入并建立索引。
• 文件夹改动：若是按"指定文件夹"建的库，往该文件夹放入新文档后点 「重建索引」：只处理新增/修改/删除的文件，未变的秒级跳过，不用全量重来。

七、配置大模型（换 key / 换模型）

• 点右上 「大模型设置」，填协议、接口地址、模型名、key，保存即生效。
• 也可直接改 app/config.json 的 llm 段，或设环境变量 RAG_LLM_API_KEY 等。
• 未配置 key 时仍可用，只是返回检索到的原文片段（不带模型总结）。

八、常见问题