# morelogic_rag_free

**Repository Path**: waterruby_admin/morelogic_rag_free

## Basic Information

- **Project Name**: morelogic_rag_free
- **Description**: MoreLogic RAG 个人免费版

> 装在你自己电脑上的本地知识助手——不联网、不泄露、中英双语随意问。

MoreLogic RAG 个人免费版是一套**完全私有化、纯 CPU 可运行**的本地知识助手。它能读取你自己的 PDF、Markdown、TXT、HTML 文档，用自然语言提问，基于文档内容给出带来源的回答。所有数据、所有运算，都在你自己的电脑上完成，不依赖任何外部云服务。



- **Primary Language**: Python
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-25
- **Last Updated**: 2026-09-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README


# MoreLogic RAG 个人免费版 · 产品宣传手册

**版本**：1.0.0
**日期**：2026 年 9 月
**许可证**：Apache License 2.0
---
仓库：

[https://gitcode.com/sakura_sea/morelogic_rag_free](https://gitcode.com/sakura_sea/morelogic_rag_free)

---
[https://gitee.com/waterruby_admin/morelogic_rag_free](https://gitee.com/waterruby_admin/morelogic_rag_free)

----

## 一句话

**装在你自己电脑上的本地知识助手——不联网、不泄露、中英双语随意问。**


---

### ⚠️  免责声明 / Disclaimer
  1.   本工具为中立技术产品，不审查用户索引的文档内容。
    用户须自行确保所索引文档的合法性。
    因索引无版权或非法内容引发的责任，因用户索引、处理、传播无版权或非法内容所引发的任何法律责任、纠纷或损失，由用户自行承担。
   开发者、贡献者及分发者不承担由此产生的任何直接或间接责任。
This tool is content-neutral. Users are solely responsible for ensuring they have the legal right to index and process any documents. The developers assume no liability for any illegal or unauthorized use of this software.

 2. 使用本产品生成的内容，请自行核实，不作为任何专业建议，仅供参考。
The result produced by MoreLogic RAG is AI-generated, for reference only.

---

## 它解决什么问题

| 痛点 | MoreLogic 个人免费版 |
|------|-------------|
| 文档堆积，查不到、用不上 | 自然语言提问，秒级定位 |
| 不敢用公有云 AI，怕泄密 | **100% 本地运行**，数据不出内网 |
| 中英文档混在一起，检索困难 | **中英跨语言匹配**，中文问英文答 |
| 部署复杂、要买 GPU | **纯 CPU 可跑**，8GB 内存起步 |
| 商用软件授权不清 | **Apache 2.0**，可安全商用 |

---

## 核心能力

### 完全本地，数据不出门

所有数据留在你自己的电脑上，不联网、不上传、不调用任何外部 API。

- 文档解析在本地
- 向量编码在本地
- 检索在本地
- 生成在本地

**断网也能用。**

### 中英双语，跨语言问答

- 中文问 → 命中英文文档 → 中文回答
- English question → 命中中文资料 → English answer
- 回答语言自动跟随提问语言

### 流式输出，逐字显示

回答像打字一样逐字出现，不用等整段生成完。首 token 2-8 秒，体验流畅。

### 来源可追溯

每条回答附带参考片段，列出源文件名和内容摘要，可验证、可追溯。

### 纯 CPU 可跑，无需显卡

| 配置 | 最低 | 推荐 |
|------|------|------|
| CPU | 4 核 | 8 核 |
| 内存 | 8 GB | 16 GB |
| 磁盘 | 15 GB | 25 GB |
| GPU | 不需要 | 不需要 |

---

## 技术亮点

- **多语言嵌入**：BGE-M3 ONNX INT8，中英文效果优秀
- **混合检索**：向量检索 + BM25 稀疏检索，简单加权融合
- **本地生成**：Ollama + Qwen2.5-1.5B-Instruct
- **流式输出**：SSE 流式协议，逐字显示
- **内存缓存**：进程内字典，重复问题秒回

---

## 与公有云 AI 对比

| 维度 | MoreLogic 个人免费版 | 公有云 AI |
|------|--------------|-----------|
| **数据安全** | ✅ 完全私有 | ❌ 需上云 |
| **离线运行** | ✅ 支持 | ❌ 依赖网络 |
| **按量付费** | ❌ 完全免费 | ✅ 按 token |
| **合规性** | ✅ Apache 2.0 | ❌ 风险高 |
| **多语言** | ✅ 中英双语 | ✅ 支持 |
| **响应速度** | ⚡ 2-8 秒（首次） | ⚡ 1-3 秒 |
| **部署难度** | ⚡ 4 条命令 | ⚡ 注册即用 |

---

## 适用场景

- **个人知识库**：技术文档、学习资料、研究笔记
- **中英资料检索**：中文团队查英文资料，英文团队查中文文档
- **隐私敏感场景**：合同、病历、财务等不愿上云的文件
- **离线环境**：内网、无网络环境下的知识问答
- **学习研究**：RAG 技术学习、二次开发的基础

---
## 使用范围

MoreLogic RAG 个人免费版按 Apache 2.0 协议开源，面向**个人本地使用**。

- ✅ 个人电脑上单用户使用
- ✅ 学习、研究、个人知识管理
- ✅ 二次开发、二次分发（遵守 Apache 2.0）

**我们不建议**将个人免费版直接部署到服务器供多用户访问。如需多用户并发、API 鉴权、商业支持，请升级至轻量版或标准版。

**升级咨询**：ownwealth@163.com
## 部署形态

| 步骤 | 命令 |
|------|------|
| 1. 安装依赖 | `pip install -r requirements.txt` |
| 2. 拉取模型 | `ollama pull qwen2.5:1.5b-instruct` |
| 3. 构建索引 | `python build_index.py --data_dir ./docs ...` |
| 4. 启动服务 | `python run.py --host 0.0.0.0 --port 8000` |

**4 条命令，10 分钟跑起来。**

---

## 价值

- **省时间**：秒级定位文档，不用翻找
- **省风险**：数据不出门，合规无忧
- **破语言壁垒**：中英文档无障碍检索
- **零成本**：Apache 2.0 协议，永久免费
- **可扩展**：后续可升级到轻量版 / 标准版

---

## 开源协议

MoreLogic RAG 个人免费版采用 **Apache License 2.0** 发布。

**你可以自由**：
- ✅ 商业使用
- ✅ 修改源码
- ✅ 分发副本
- ✅ 申请专利授权

**唯一要求**：
- 保留版权声明和许可证声明

**不承担**：
- 任何明示或暗示的担保责任

---
## 风险提示

1. **使用本产品生成的内容，请自行核实，不作为任何专业建议，仅供参考。**

**This result produced by MoreLogic RAG is AI-generated, for reference only.**

2. **内容合法性免责**：本产品为中立工具，用户须自行确保所索引文档的合法性。因索引无版权或非法内容引发的责任，由用户自行承担。

**Content Liability Disclaimer**: This is a neutral tool. Users are solely responsible for the legality of indexed content. The developers assume no liability for unauthorized or illegal use.

## 结语

**MoreLogic RAG 个人免费版——让每个人都有自己的知识助手。**

**数据不出门，语言不是墙。**

---

*MoreLogic 项目组 · 2026 年 9 月*

*升级咨询：ownwealth@163.com*



---

# MoreLogic RAG 个人免费版 · 产品白皮书

**版本**：1.0.0
**日期**：2026 年 9 月
**许可证**：Apache License 2.0

---

## 一、产品概述

MoreLogic RAG 个人免费版是一套**完全私有化、纯 CPU 可运行**的本地知识助手。

它能读取你自己的 PDF、Markdown、TXT、HTML 文档，用自然语言提问，基于文档内容给出带来源的回答。

**所有数据、所有运算，都在你自己的电脑上完成，不依赖任何外部云服务。**

### 核心能力

| 能力 | 说明 |
|------|------|
| **文本问答** | 基于本地文档的精准问答，答案有据可查 |
| **中英双语** | 中文问英文答、英文问中文答 |
| **流式输出** | 回答逐字显示，交互流畅 |
| **来源引用** | 每条回答附参考片段 |

---

## 二、解决什么问题

| 痛点 | MoreLogic 个人免费版 |
|------|--------------|
| 文档堆积如山，找不到、用不上 | 语义理解，问什么答什么 |
| 不敢用公有云 AI，怕数据泄露 | 100% 私有化，数据不出本机 |
| 中英文档混合，检索困难 | 跨语言语义匹配 |
| 部署要买 GPU，成本高 | 纯 CPU 可运行 |
| 商用软件授权不清 | Apache 2.0，可安全商用 |

---

## 三、系统架构

### 3.1 整体流程

```text
文档入库：
  解析 → 切分 → 向量化 → 存索引

查询：
  查询理解 → 检索 → 融合 → 生成

输出：
  拼上下文 → LLM 回答 → 附来源
```

### 3.2 核心模块

| 模块 | 职责 |
|------|------|
| **文档解析** | PDF / Markdown / TXT / HTML 提取纯文本 |
| **嵌入编码** | BGE-M3 ONNX INT8 编码句子 |
| **向量索引** | FAISS 本地索引，支持快速相似检索 |
| **稀疏检索** | BM25 关键词匹配 |
| **融合排序** | 向量 + BM25 简单加权融合 |
| **生成** | Ollama + Qwen2.5-1.5B-Instruct |

### 3.3 检索策略

**双路检索 + 简单融合**：

1. **向量检索**：BGE-M3 编码查询，在 FAISS 索引中检索 Top-K 相似句
2. **稀疏检索**：BM25 对查询分词，计算词频相似度
3. **加权融合**：向量 0.5 + BM25 0.5，取 Top-K 送生成

---

## 四、核心能力详解

### 4.1 多语言能力

**嵌入模型**：BGE-M3

- 支持中英文混合编码
- 语义空间统一，跨语言可直接匹配
- ONNX INT8 量化版仅 558MB

**语言检测**：规则版

- 中文占比 > 20% → `zh`
- 否则 → `en`

**回答语言跟随**：System prompt 强制指定，中英各一套

### 4.2 检索能力

| 检索方式 | 实现 | 特点 |
|---------|------|------|
| 向量检索 | FAISS + BGE-M3 | 语义相似 |
| 稀疏检索 | BM25 | 关键词精确匹配 |
| 融合 | 加权平均 | 兼顾语义和词频 |

### 4.3 生成能力

**模型**：Qwen2.5-1.5B-Instruct

- 参数量：1.5B
- 量化：Q4_K_M
- 磁盘：约 1 GB
- 内存：约 1.2 GB
- CPU 生成速度：10-30 token/s

**上下文窗口**：8192 token

**语言控制**：System prompt 里明确指定回答语言

### 4.4 缓存能力

**进程内字典缓存**：

- 缓存键：查询的 SHA256
- 缓存值：完整回答
- TTL：600 秒
- 容量：500 条
- 命中率：重复问题秒回

---

## 五、技术规格

| 项目 | 说明 |
|------|------|
| 文本格式 | PDF、Markdown、TXT、HTML |
| 语言支持 | 中文、英文 |
| 语言检测 | 规则检测 |
| 向量模型 | BGE-M3 ONNX INT8 |
| 向量维度 | 1024 |
| 向量索引 | FAISS IndexFlatIP |
| 稀疏检索 | BM25（rank-bm25） |
| 生成模型 | Qwen2.5-1.5B-Instruct |
| 输出方式 | 流式（SSE）/ 非流式 |
| 部署方式 | 本地服务器，完全私有化 |
| 许可协议 | Apache License 2.0 |

---

## 六、性能指标

### 6.1 硬件要求

| 组件 | 最低 | 推荐 |
|------|------|------|
| CPU | 4 核 | 8 核 |
| 内存 | 8 GB | 16 GB |
| 磁盘 | 15 GB | 25 GB |
| GPU | 不需要 | 不需要 |

### 6.2 性能基线

| 指标 | 数值 |
|------|------|
| 索引构建速度 | 3-5 句/秒（纯 CPU） |
| 首 token 延迟 | 2-8 秒 |
| 生成速度 | 10-30 token/s |
| 缓存命中 | < 1 秒 |
| 内存占用 | 约 2.5 GB |

### 6.3 容量参考

| 文档规模 | 索引大小 | 编码耗时 |
|---------|---------|---------|
| 100 个文件 | 约 5 MB | 约 15 分钟 |
| 500 个文件 | 约 25 MB | 约 1 小时 |
| 1000 个文件 | 约 50 MB | 约 2 小时 |

---

## 七、部署与运维

### 7.1 部署要求

- Python 3.11 或 3.12
- Ollama（本地 LLM 运行时）
- 约 5 GB 磁盘空间（含模型）

### 7.2 部署步骤

1. 安装 Python 和 Ollama
2. 拉取 LLM 模型
3. 下载 BGE-M3 ONNX 模型
4. 构建文档索引
5. 启动 API 服务
6. （可选）接入 Open WebUI

### 7.3 日常维护

| 任务 | 频率 |
|------|------|
| 健康检查 | 每天 |
| 日志清理 | 每周 |
| 文档更新后重建索引 | 按需 |
| 备份文档和配置 | 每天 |

---

## 八、安全与合规

### 8.1 数据安全

- **不联网**：所有运算在本地
- **不上传**：文档不离开本机
- **不调用外部 API**：完全自包含

### 8.2 开源协议

本项目采用 **Apache License 2.0** 发布。

**允许**：
- 商业使用
- 修改源码
- 分发副本
- 专利授权

**要求**：
- 保留版权和许可声明

**免责**：
- 不提供任何明示或暗示的担保

### 8.3 第三方组件

所有第三方组件均采用商业友好协议：

| 协议 | 组件 |
|------|------|
| MIT | FastAPI、Pydantic、FAISS、jieba、BeautifulSoup4、tqdm、onnxruntime、BGE-M3 模型 |
| Apache 2.0 | Requests、rank-bm25、Optimum、Transformers、huggingface-hub、sentencepiece、Qwen2.5 模型 |
| BSD 3-Clause | Uvicorn、NumPy、pypdf |

**无 GPL / AGPL 等强 copyleft 组件，可安全商用。**

---

## 九、与商业版对比

| 能力 | 个人免费版 | 轻量版 | 标准版 |
|------|----------|--------|--------|
| 文本问答 | ✅ | ✅ | ✅ |
| 中英双语 | ✅ | ✅ | ✅ |
| 11+ 语言 | ❌ | ✅ | ✅ |
| 混合检索 | ❌ | ✅ | ✅ |
| 精排 | ❌ | ✅ | ✅ |
| 查询扩展 | ❌ | ✅ | ✅ |
| 联网搜索 | ❌ | ❌ | ✅ |
| 图片检索 | ❌ | ❌ | ✅ |
| 图片理解 | ❌ | ❌ | ✅ |
| 多用户并发 | ❌ | ✅ | ✅ |
| API 鉴权 | ❌ | ✅ | ✅ |
| 商业授权 | Apache 2.0 | 商业 | 商业 |

**升级咨询**：ownwealth@163.com

---

## 十、适用场景

### 个人知识库
- 技术文档、学习资料、研究笔记
- 中英混合资料检索
- 离线环境下的知识问答

### 隐私敏感场景
- 合同、病历、财务文件
- 不愿上云的内部资料
- 合规要求高的场景

### 学习研究
- RAG 技术学习
- 二次开发基础
- 本地 AI 实验

---

## 十一、限制与说明
### 使用范围限制

个人免费版按 Apache 2.0 协议发布，**定位为个人本地单用户使用**。

- 允许：个人电脑安装、单用户问答、二次开发
- 不建议：部署到服务器供多用户访问

如需多用户并发、API 鉴权、商业授权，请升级至轻量版或标准版。

**升级咨询**：ownwealth@163.com
### 当前限制

| 限制 | 说明 |
|------|------|
| 仅中英双语 | 其他语言需升级轻量版 |
| 无 Reranker | 检索精度有提升空间 |
| 单用户 | 不支持多用户并发 |
| 无 API 鉴权 | 不适合直接暴露公网 |
| 全量重建索引 | 文档变更需重建 |

### 性能说明

- 纯 CPU 推理，速度受限于硬件
- 1.5B 模型，复杂问题回答深度有限
- 首次查询较慢（Ollama 加载模型）

---

## 十二、结语

**MoreLogic RAG 个人免费版的使命很简单：**

让每个人，都能拥有一个**属于自己的 AI 知识助手**。

它不追求最炫的技术，只追求最实在的价值——

- 让文档**活起来**
- 让知识**用得上**
- 让数据**守得住**

这就是 MoreLogic。



## 十三、风险提示

### 13.1 AI 生成结果的局限性

MoreLogic RAG 个人免费版的所有回答均由本地大语言模型（Qwen2.5-1.5B-Instruct）生成。**AI 生成的内容存在不确定性，可能不准确、不完整或存在偏差**，具体包括但不限于：

| 风险类型 | 说明 |
|---|---|
| **幻觉** | 模型可能生成文档中并不存在的内容 |
| **遗漏** | 可能遗漏文档中的关键信息 |
| **偏差** | 受训练数据影响，可能存在倾向性表述 |
| **时效** | 模型知识存在截止日期，可能不包含最新信息 |
| **语言** | 1.5B 小模型在复杂问题上语言控制能力有限 |

### 13.2 回答不构成任何专业建议

MoreLogic RAG 生成的回答**不构成法律、医疗、金融、投资等任何专业领域的建议**。

如需专业意见，请咨询具备相应资质的专业人士。

### 13.3 用户应自行核实

**使用本产品生成的所有内容，请务必自行核实。**

- 回答仅供参考，不作为决策的唯一依据
- 建议对照参考片段中的原文进行验证
- 对关键信息，建议交叉验证多个来源

### 13.4 责任限制

在适用法律允许的最大范围内：

- 本项目作者和贡献者**不对使用本产品产生的任何直接或间接损失承担责任**
- 包括但不限于：数据丢失、业务中断、利润损失、法律纠纷
- 用户使用本产品即表示**已知悉并接受上述风险**

### 13.5 免责声明

**MoreLogic RAG生成的结果由 AI 生成，仅供参考。**

**This result is AI-generated, for reference only.**

---

### 13.6 附：Apache 2.0 免责条款原文

> Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

**中文释义**：

> 除非适用法律要求或书面同意，本软件按“原样”分发，不附带任何明示或暗示的担保或条件。具体授权和限制条款请参见 Apache License 2.0。

---

*MoreLogic 项目组 · 2026 年 9 月*

*升级咨询：ownwealth@163.com*

---



**Apache License 2.0**

Copyright 2026 MoreLogic Project Contributors

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.