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 |
使用示例
上传文档
- 点击左侧边栏中的 “上传文档” 按钮
- 选择文件(支持 PDF、DOCX、TXT、MD 格式)
- 填写标题与标签(可选)
- 点击 “上传” —— 系统将自动完成解析、分块与向量化
提出问题
- 在右侧聊天界面中输入问题
- 选择交互模式:
- 知识查询:基于检索结果获取精准答案
- 知识组织:交由 AI 对相关知识进行归纳整理与摘要生成
- 查看答案,并确认引用的源文档链接
浏览知识图谱
- 点击顶部导航栏中的 “知识图谱” 按钮
- 查看两个预览卡片:
- 文档关系图:展示各文档之间的关联关系
- 实体关系图:展示抽取的实体及其相互关系
- 点击任一卡片进入全屏模态窗口进行交互式探索:
- 滚动鼠标滚轮缩放
- 拖拽空白区域平移视图
- 拖拽节点调整位置
- 悬停节点查看详细信息
文档管理
- 查看列表:在左侧边栏中查看全部已上传文档
- 搜索:使用快捷搜索功能
- 回收站:查看与管理已删除文档(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"}]}'
性能优化建议
- 限制节点数量:预览场景建议控制在 50–80 个节点以内
- 启用数据缓存:复用已获取的数据,避免重复加载
- 防抖窗口重设:为 window resize 事件处理器添加防抖逻辑
- 减少迭代次数:在
initForceLayout()中降低iterations参数(默认为 150),加快初始化速度 - 优化渲染性能:在鼠标快速移动期间跳过渲染,防止卡顿
浏览器兼容性
- ✅ Chrome 90+
- ✅ Firefox 88+
- ✅ Safari 14+
- ✅ Edge 90+
要求支持以下特性:
- Canvas 2D API
- CSS backdrop-filter
- ES6+ JavaScript 特性
参与贡献
欢迎提交贡献!请按以下步骤操作:
- Fork 本仓库
- 新建功能分支(
git checkout -b feature/amazing-feature) - 完成代码修改
- 提交更改(
git commit -m 'Add amazing feature') - 推送至远程分支(
git push origin feature/amazing-feature) - 提交 Pull Request
技术支持
如遇问题或疑问,请联系:
- GitHub Issues:https://github.com/zzlzzlzzl15/Memora/issues
- 邮箱:support@memora.dev
- 文档:https://github.com/zzlzzlzzl15/Memora/blob/main/personal_knowledge_base/README.md
致谢
- 灵感源自 Obsidian 的图谱视图
- 专为 Memora 个人知识库构建
- 采用与 D3.js 力导向模拟算法类似的技术实现
- 参考 RAG-Anything 的多模态 RAG 架构设计
由 zzlzzlzzl15 ❤️ 倾力打造
Memora — 您的个人 AI 知识库
热门AI工具
相关专题
若 Microsoft Edge 浏览器打开后无标题(窗口空白或标题栏缺失),可尝试以下方法解决: 重启 Edge:关闭所有窗口,重新启动浏览器。 重置窗口布局:右击任务栏 Edge 图标 → 选择「最大化」或「还原」。 禁用扩展:进入 edge://extensions 临时关闭插件测试。 重置浏览器设置:前往 edge://settings/reset 恢复默认配置。 更新或重装 Edge:检查最新版本,或通过控制面板修复
2292
2025.04.24
ie浏览器自动跳转edge的解决办法:1、更改默认浏览器设置;2、阻止edge浏览器的自动跳转;3、更改超链接的默认打开方式;4、禁用“快速网页查看器”;5、卸载edge浏览器;6、检查第三方插件或应用程序等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。
1794
2024.03.05
Edge是一款由Microsoft开发的网页浏览器,是Windows 10操作系统中默认的浏览器,其目标是提供更快、更安全、更现代化的浏览器体验。本专题为大家提供edge浏览器相关的文章、下载、课程内容,供大家免费下载体验。
2542
2023.08.21
本专题整理Navicat创建数据库相关教程,介绍新建前的准备、基础设置和创建后的检查方法。内容兼顾入门学习及实际使用需求,帮助用户了解不同数据库类型下的操作差异,为后续建表、保存数据和日常管理提供参考。
0
2026.11.20
本专题整理Navicat入门教程,从认识软件界面到开展数据库操作,介绍初次使用需要了解的知识和方法。内容兼顾连接配置、数据管理及日常使用中的疑问,方便用户按学习进度查阅,为后续实践和独立操作打好基础。
0
2026.11.20
从确认数据库信息到建立可用连接,本专题串联Navicat连接数据库的相关知识和操作方法。既有初次配置时需要了解的基础内容,也有连接后的检查思路,方便用户按实际需求查阅教程,逐步熟悉数据库连接的设置流程。
0
2026.11.20
本专题汇总PHP8.6数组与数据处理教程,涵盖CSV读取和导出、引用遍历删除、array_filter回调模式、配置键名冲突、pathinfo文件名校验、GMP大整数进制转换及UTF-8正则筛选,说明升级兼容变化、输入范围和失败处理方法。
0
2026.11.20
本专题汇总PHP8.6升级迁移与弃用接口改造教程,涵盖反射调用、对象属性赋值、标识符更名、构造函数与__debugInfo调整,以及插件类名检查、常量导出、ArrayIterator排序、SPL和DTO查询参数转换,帮助梳理弃用提示并完成代码兼容改造。
0
2026.11.20
本专题汇总PHP8.6正式版安装部署与FPM运维教程,涵盖Linux并存安装、独立ini配置、扩展重新编译、Nginx切换与回滚、FPM状态监控和慢日志排查,以及环境变量、请求超时、OPcache刷新和预加载配置。
0
2026.11.20
热门下载
相关下载
精品课程
共6课时 | 12.1万人学习
共79课时 | 162万人学习
共6课时 | 54.8万人学习