Memora — 个人AI知识库,支持交互式知识图谱可视化。一个自托管系统,用于管理、检索和查询您的个人...
Memora - 个人AI知识库.是一项面向实际任务的技能,主要用于Memora是一个自办的个人AI知识库系统,提供从知识捕捉到智能QQA的综合经验.;Built on victor.。
从功能定位来看,该技能强调把分散的操作要求整理成清晰、可复用的处理流程,使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数,再依据技能说明逐步执行;
若输入条件不完整,应先补齐信息或采用保守配置,避免因错误假设导致结果偏离需求。执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期,并对异常提示、缺失字段和边界情况进行处理;涉及批量任务时,还应保存进度,避免中断后重复操作。
Memora 是一款可自托管的个人 AI 知识库系统,提供从知识采集到智能问答的一体化体验。系统基于向量检索、混合搜索与大语言模型(LLM)驱动的智能组织能力,帮助您高效地管理、检索和利用个人知识资产。
openclaw skills install memora-knowledge-graph@2.0.4
# 克隆仓库 git clone https://github.com/zzlzzlzzl15/Memora.git cd Memora/personal_knowledge_base # 运行安装脚本 ./install.sh
# 克隆仓库 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 |
┌─────────────────────────────────────────┐
│ 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
解决方案:
docker-compose logs -f app解决方案:
QDRANT_DENSE_DEFAULT_THRESHOLD 数值解决方案:
# 检查 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"}]}'
initForceLayout() 中降低 iterations 参数(默认为 150),加快初始化速度要求支持以下特性:
欢迎提交贡献!请按以下步骤操作:
git checkout -b feature/amazing-feature)git commit -m 'Add amazing feature')git push origin feature/amazing-feature)如遇问题或疑问,请联系:
由 zzlzzlzzl15 ❤️ 倾力打造
Memora — 您的个人 AI 知识库
相关专题
热门下载
相关下载
精品课程
共6课时 | 54.7万人学习
共89课时 | 134.3万人学习
共49课时 | 82.7万人学习