Memora Knowledge Base

Polar Sponsor
爱发电 赞助
.NET 9.0

Memora — 个人AI知识库,支持交互式知识图谱可视化。一个自托管系统,用于管理、检索和查询您的个人...

Memora - 个人AI知识库.

功能概述

Memora - 个人AI知识库.是一项面向实际任务的技能,主要用于Memora是一个自办的个人AI知识库系统,提供从知识捕捉到智能QQA的综合经验.;Built on victor.。

核心要点

  • 它将相关步骤、工具调用和结果整理方式集中到统一流程中,帮助使用者更快完成目标并减少重复操作。
  • 使用时应结合输入条件选择合适的执行方式,核对必要参数、依赖环境与输出内容,并按原始要求处理异常情况。
  • 该技能适合需要稳定复用相关能力的场景,可作为自动化工作流的一部分,也便于后续检查、调整和扩展。

使用与执行

从功能定位来看,该技能强调把分散的操作要求整理成清晰、可复用的处理流程,使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数,再依据技能说明逐步执行;

结果检查与注意事项

若输入条件不完整,应先补齐信息或采用保守配置,避免因错误假设导致结果偏离需求。执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期,并对异常提示、缺失字段和边界情况进行处理;涉及批量任务时,还应保存进度,避免中断后重复操作。

Memora — 个人 AI 知识库

Memora 是一款可自托管的个人 AI 知识库系统,提供从知识采集到智能问答的一体化体验。系统基于向量检索、混合搜索与大语言模型(LLM)驱动的智能组织能力,帮助您高效地管理、检索和利用个人知识资产。

版本历史

v2.1.0(当前版本)

  • 🕸️ 知识图谱全量构建:实体抽取现已处理全部文本块(移除原 10 块限制)
  • 🗑️ 文档删除一致性增强:软删除与彻底清除操作现已同步清理 Neo4j 图数据库中的关联数据
  • 🔧 实体 ID 修复:解决因 entity_id 缺失导致图查询中节点丢失的问题
  • ⚡ 性能优化:移除查询过程中的 MySQL 一致性校验,改至删除阶段执行
  • 📦 目录结构调整:将 skill 目录重命名为 memora-knowledge-base,以兼容 ClawHub

v2.0.4

  • 📝 完整产品文档:包含全面产品概览的详细 README
  • 🎨 知识图谱 v2.0:支持预览视图 + 全屏模态窗口架构
  • 🖱️ 交互能力增强:支持缩放、平移、拖拽节点、悬停查看详情
  • 🎯 居中布局:采用受力导向算法,并以坐标原点为中心定位节点
  • 🔄 智能缓存策略:预览数据单独缓存,模态窗口使用更完整的数据集
  • 双视图模式:支持文档关系图 + 实体关系图并行展示

v2.0.0

  • 初始发布,支持知识图谱可视化
  • 受力导向布局,配备交互式控制功能
  • 借鉴 Obsidian 的视觉设计风格

核心功能

🔐 隐私保护与本地部署

  • 完全私有化:所有数据仅存储于本地,不上传任何第三方服务
  • 离线可用:无需互联网连接即可运行
  • 单用户模式:无需身份认证,开箱即用

智能语义检索

  • 混合搜索:稠密向量(Dense Vector)+ BM42 稀疏向量(Sparse Vector)双引擎协同检索
  • 相关性重排序:可选 Rerank 模型进行二次排序
  • 自动降级机制:当主策略失效时自动切换至备用策略
  • 语义理解能力:基于向量相似度匹配,而非关键词匹配

📄 多格式文档处理

  • 支持格式:PDF、Word(.docx/.doc)、纯文本(.txt)、Markdown(.md)
  • 智能分块:基于 LangChain 递归字符切分器,支持中英文混合文本
  • 向量存储:稠密向量与稀疏向量统一存入 Qdrant
  • 元数据管理:支持标签(Tags)及自定义元数据,便于组织与分类

AI 驱动的问答系统

  • 两种交互模式:
    • 知识查询:基于检索结果进行精准问答
    • 知识组织:由 LLM 自动完成知识归纳、总结与结构化
  • 流式输出:实时生成回答内容
  • 会话管理:支持多轮对话与上下文历史维护
  • 来源标注:答案中自动附带原始文档链接

🕸️ 知识图谱可视化

  • 受力导向布局:自动计算节点位置,形成自然网络结构
  • 双视图展示:同时呈现文档关系图与实体关系图
  • 交互操作:
    • 鼠标滚轮缩放(以光标位置为中心)
    • 拖拽空白区域平移画布
    • 拖拽节点调整其位置
    • 悬停节点显示详情信息
  • Obsidian 风格设计:黑色节点、白色背景、线条连接轻量柔和

🌐 网络爬虫与集成能力

  • 内置爬虫:基于 httpx + BeautifulSoup 实现,无外部依赖
  • OpenClaw 集成:作为 AI Agent Skill 提供,客户端零依赖
  • RESTful API:便于与其他系统快速集成

快速开始

通过 clawhub 安装

openclaw skills install memora-knowledge-graph@2.0.4

手动安装

# 克隆仓库
git clone https://github.com/zzlzzlzzl15/Memora.git
cd Memora/personal_knowledge_base

# 运行安装脚本
./install.sh

Docker Compose 部署(推荐)

# 克隆仓库
git clone https://github.com/zzlzzlzzl15/Memora.git
cd Memora/personal_knowledge_base

# 配置环境变量
cp .env.example .env
# 编辑 .env 文件,填入您的 API 密钥

# 启动服务
docker-compose up -d

# 访问应用
# 在浏览器中打开 http://localhost:8080

配置说明

请设置环境变量 KB_API_BASE,使其指向您的 Memora 后端地址:

export KB_API_BASE=http://127.0.0.1:8080

或创建 .env 文件:

KB_API_BASE=http://127.0.0.1:8080

必需环境变量

变量名 说明 示例值
KB_API_BASE Memora 后端服务地址 http://127.0.0.1:8080
DEEPSEEK_API_KEY DeepSeek API Key(用于 LLM 推理) sk-xxx
DASHSCOPE_API_KEY DashScope API Key(用于嵌入向量生成) sk-xxx

可选环境变量

变量名 说明 默认值
USE_RERANK 是否启用重排序功能 false
RERANK_API_KEY Qwen3-Rerank API Key -
RETRIEVAL_TOP_K 初始检索返回的候选数量 20
QDRANT_DENSE_DEFAULT_THRESHOLD 稠密向量相似度阈值 0.7

使用示例

上传文档

  1. 点击左侧边栏中的 “上传文档” 按钮
  2. 选择文件(支持 PDF、DOCX、TXT、MD 格式)
  3. 填写标题与标签(可选)
  4. 点击 “上传” —— 系统将自动完成解析、分块与向量化

提出问题

  1. 在右侧聊天界面中输入问题
  2. 选择交互模式:
    • 知识查询:基于检索结果获取精准答案
    • 知识组织:交由 AI 对相关知识进行归纳整理与摘要生成
  3. 查看答案,并确认引用的源文档链接

浏览知识图谱

  1. 点击顶部导航栏中的 “知识图谱” 按钮
  2. 查看两个预览卡片:
    • 文档关系图:展示各文档之间的关联关系
    • 实体关系图:展示抽取的实体及其相互关系
  3. 点击任一卡片进入全屏模态窗口进行交互式探索:
    • 滚动鼠标滚轮缩放
    • 拖拽空白区域平移视图
    • 拖拽节点调整位置
    • 悬停节点查看详细信息

文档管理

  • 查看列表:在左侧边栏中查看全部已上传文档
  • 搜索:使用快捷搜索功能
  • 回收站:查看与管理已删除文档(30 天内可恢复)
  • 永久删除:彻底移除文档及其对应向量数据

技术架构

┌─────────────────────────────────────────┐
│           Web 浏览器                    │
│     (前端 UI — HTML/CSS/JS)          │
└──────────────┬──────────────────────────┘
               │ HTTP / WebSocket
┌──────────────▼──────────────────────────┐
│         Memora 后端                      │
│       (FastAPI / Python)               │
──────────┬──────────────┬───────────────┤
│ 文档处理 │  检索引擎    │ AI 服务        │
│          │              │               │
├──────────┼──────────────┼───────────────┤
│• PDF     │• 稠密向量检索 │• 嵌入向量生成   │
│  解析器   │              │  (DashScope/  │
│• DOCX    │• 稀疏向量检索 │  本地 ST)     │
│  解析器   │  (BM42)    │• LLM 聊天      │
│• 文本分块 │• 混合检索     │  (DeepSeek/   │
│• 元数据   │• 降级逻辑     │  OpenAI 兼容) │
│• 上传 API │              │• 重排序         │
│          │              │  (Qwen3)      │
│          │              │• 流式响应       │
└────┬─────┴──────┬───────┴───────┬───────┘
     │            │               │
┌────▼────┐ ┌────▼──────┐ ┌──────▼──────┐
│ MySQL   │ │  Qdrant   │ │ 外部 API     │
│(元数据) │ │(向量数据库)│ │              │
│         │ │           │ │• DashScope   │
│• 文档   │ │• 稠密向量   │ │• DeepSeek    │
│• 用户   │ │• 稀疏向量   │ │• OpenAI 兼容 │
│• 会话   │ │  (BM42)   │ │              │
│• 历史   │ │           │ │              │
└─────────┘ └───────────┘ └─────────────┘

技术栈

组件 技术选型 说明
后端框架 FastAPI(Python 3.11+) 高性能异步 Web 框架
向量数据库 Qdrant 支持稠密向量 + 稀疏向量的混合检索
关系型数据库 MySQL 8.0 存储文档元数据、用户信息、会话记录等
嵌入模型 DashScope text-embedding-v4 / Sentence-Transformers 支持云 API 或本地模型
LLM 服务 DeepSeek / OpenAI 兼容接口 支持流式输出与多轮对话
重排序模型 Qwen3-Rerank(可选) 提升检索结果的相关性
文档解析 PyPDF2、docx2txt、LangChain 多格式文档解析与处理
网页爬取 httpx + BeautifulSoup 内置爬虫,无额外依赖
容器化 Docker + Docker Compose 一键式部署方案

故障排查

问题:预览卡片未显示

解决方案:检查浏览器控制台是否有报错;确保 initKnowledgeGraph() 在 DOM 加载完成后调用。

问题:节点未居中显示

解决方案:强制刷新页面(Cmd+Shift+R);必要时清除浏览器缓存。

问题:模态窗口中无法拖拽/缩放

解决方案:确认全屏可视化器已调用 setInteractive(true);检查控制台日志。

问题:服务无法启动

解决方案:

# 查看日志
docker-compose logs -f app

# 清理并重启
docker-compose down -v
docker-compose up -d

问题:文档上传失败

解决方案:

  • 检查文件格式(仅支持 PDF、DOCX、TXT、MD)
  • 检查文件大小(默认限制为 10MB)
  • 查看应用日志:docker-compose logs -f app

问题:无检索结果返回

解决方案:

  • 确认文档已成功上传且已完成向量化
  • 尝试更换不同表述的查询词
  • 适当降低 QDRANT_DENSE_DEFAULT_THRESHOLD 数值

问题:LLM 调用失败

解决方案:

# 检查 API 密钥配置
cat .env | grep API_KEY

# 测试 API 连通性
curl -H "Authorization: Bearer $DEEPSEEK_API_KEY" 
  https://api.deepseek.com/v1/chat/completions 
  -d '{"model":"deepseek-chat","messages":[{"role":"user","content":"test"}]}'

性能优化建议

  1. 限制节点数量:预览场景建议控制在 50–80 个节点以内
  2. 启用数据缓存:复用已获取的数据,避免重复加载
  3. 防抖窗口重设:为 window resize 事件处理器添加防抖逻辑
  4. 减少迭代次数:在 initForceLayout() 中降低 iterations 参数(默认为 150),加快初始化速度
  5. 优化渲染性能:在鼠标快速移动期间跳过渲染,防止卡顿

浏览器兼容性

  • ✅ Chrome 90+
  • ✅ Firefox 88+
  • ✅ Safari 14+
  • ✅ Edge 90+

要求支持以下特性:

  • Canvas 2D API
  • CSS backdrop-filter
  • ES6+ JavaScript 特性

参与贡献

欢迎提交贡献!请按以下步骤操作:

  1. Fork 本仓库
  2. 新建功能分支(git checkout -b feature/amazing-feature)
  3. 完成代码修改
  4. 提交更改(git commit -m 'Add amazing feature')
  5. 推送至远程分支(git push origin feature/amazing-feature)
  6. 提交 Pull Request

技术支持

如遇问题或疑问,请联系:

致谢

  • 灵感源自 Obsidian 的图谱视图
  • 专为 Memora 个人知识库构建
  • 采用与 D3.js 力导向模拟算法类似的技术实现
  • 参考 RAG-Anything 的多模态 RAG 架构设计

由 zzlzzlzzl15 ❤️ 倾力打造

Memora — 您的个人 AI 知识库

相关专题

更多
如何解决Edge打开但没有标题的问题
如何解决Edge打开但没有标题的问题

若 Microsoft Edge 浏览器打开后无标题(窗口空白或标题栏缺失),可尝试以下方法解决: 重启 Edge:关闭所有窗口,重新启动浏览器。 重置窗口布局:右击任务栏 Edge 图标 → 选择「最大化」或「还原」。 禁用扩展:进入 edge://extensions 临时关闭插件测试。 重置浏览器设置:前往 edge://settings/reset 恢复默认配置。 更新或重装 Edge:检查最新版本,或通过控制面板修复

2025.04.24

2292

6

IE浏览器自动跳转EDGE如何恢复
IE浏览器自动跳转EDGE如何恢复

ie浏览器自动跳转edge的解决办法:1、更改默认浏览器设置;2、阻止edge浏览器的自动跳转;3、更改超链接的默认打开方式;4、禁用“快速网页查看器”;5、卸载edge浏览器;6、检查第三方插件或应用程序等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.03.05

1794

4

edge是什么浏览器
edge是什么浏览器

Edge是一款由Microsoft开发的网页浏览器,是Windows 10操作系统中默认的浏览器,其目标是提供更快、更安全、更现代化的浏览器体验。本专题为大家提供edge浏览器相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.21

2542

5

Navicat创建数据库教程
Navicat创建数据库教程

本专题整理Navicat创建数据库相关教程,介绍新建前的准备、基础设置和创建后的检查方法。内容兼顾入门学习及实际使用需求,帮助用户了解不同数据库类型下的操作差异,为后续建表、保存数据和日常管理提供参考。

2026.11.20

0

7

Navicat入门教程大全
Navicat入门教程大全

本专题整理Navicat入门教程,从认识软件界面到开展数据库操作,介绍初次使用需要了解的知识和方法。内容兼顾连接配置、数据管理及日常使用中的疑问,方便用户按学习进度查阅,为后续实践和独立操作打好基础。

2026.11.20

0

17

Navicat数据库连接配置指南
Navicat数据库连接配置指南

从确认数据库信息到建立可用连接,本专题串联Navicat连接数据库的相关知识和操作方法。既有初次配置时需要了解的基础内容,也有连接后的检查思路,方便用户按实际需求查阅教程,逐步熟悉数据库连接的设置流程。

2026.11.20

0

10

PHP8.6数组与数据处理教程
PHP8.6数组与数据处理教程

本专题汇总PHP8.6数组与数据处理教程,涵盖CSV读取和导出、引用遍历删除、array_filter回调模式、配置键名冲突、pathinfo文件名校验、GMP大整数进制转换及UTF-8正则筛选,说明升级兼容变化、输入范围和失败处理方法。

2026.11.20

0

8

PHP8.6升级迁移教程
PHP8.6升级迁移教程

本专题汇总PHP8.6升级迁移与弃用接口改造教程,涵盖反射调用、对象属性赋值、标识符更名、构造函数与__debugInfo调整,以及插件类名检查、常量导出、ArrayIterator排序、SPL和DTO查询参数转换,帮助梳理弃用提示并完成代码兼容改造。

2026.11.20

0

10

PHP8.6安装配置与FPM运维教程
PHP8.6安装配置与FPM运维教程

本专题汇总PHP8.6正式版安装部署与FPM运维教程,涵盖Linux并存安装、独立ini配置、扩展重新编译、Nginx切换与回滚、FPM状态监控和慢日志排查,以及环境变量、请求超时、OPcache刷新和预加载配置。

2026.11.20

0

10

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
热门推荐
/
最新课程
phpStudy极速入门视频教程
phpStudy极速入门视频教程

共6课时 | 54.7万人学习

独孤九贱(4)_PHP视频教程
独孤九贱(4)_PHP视频教程

共89课时 | 134.3万人学习